webpack/lib/css/CssParser.js

2617 lines
69 KiB
JavaScript
Raw Permalink Normal View History

2021-11-30 19:55:51 +08:00
/*
MIT License http://www.opensource.org/licenses/mit-license.php
Author Tobias Koppers @sokra
*/
"use strict";
2024-10-16 22:42:26 +08:00
const vm = require("vm");
const CommentCompilationWarning = require("../CommentCompilationWarning");
const CssModule = require("../CssModule");
2023-05-02 18:12:41 +08:00
const ModuleDependencyWarning = require("../ModuleDependencyWarning");
2022-12-16 20:56:14 +08:00
const { CSS_MODULE_TYPE_AUTO } = require("../ModuleTypeConstants");
2021-11-30 19:55:51 +08:00
const Parser = require("../Parser");
2024-10-16 22:42:26 +08:00
const UnsupportedFeatureWarning = require("../UnsupportedFeatureWarning");
2023-05-02 18:12:41 +08:00
const WebpackError = require("../WebpackError");
2021-12-14 23:02:26 +08:00
const ConstDependency = require("../dependencies/ConstDependency");
2024-11-07 00:11:54 +08:00
const CssIcssExportDependency = require("../dependencies/CssIcssExportDependency");
const CssIcssImportDependency = require("../dependencies/CssIcssImportDependency");
2024-11-08 00:32:00 +08:00
const CssIcssSymbolDependency = require("../dependencies/CssIcssSymbolDependency");
2021-12-01 20:27:00 +08:00
const CssImportDependency = require("../dependencies/CssImportDependency");
2021-12-01 21:15:19 +08:00
const CssUrlDependency = require("../dependencies/CssUrlDependency");
2025-11-06 04:13:12 +08:00
const StaticExportsDependency = require("../dependencies/StaticExportsDependency");
2024-10-16 22:42:26 +08:00
const binarySearchBounds = require("../util/binarySearchBounds");
2023-06-11 21:33:10 +08:00
const { parseResource } = require("../util/identifier");
2024-10-16 22:42:26 +08:00
const {
2025-07-03 17:06:45 +08:00
createMagicCommentContext,
webpackCommentRegExp
2024-10-16 22:42:26 +08:00
} = require("../util/magicComment");
2021-11-30 19:55:51 +08:00
const walkCssTokens = require("./walkCssTokens");
2024-10-01 03:05:27 +08:00
/** @typedef {import("../Module").BuildInfo} BuildInfo */
/** @typedef {import("../Module").BuildMeta} BuildMeta */
2021-11-30 19:55:51 +08:00
/** @typedef {import("../Parser").ParserState} ParserState */
/** @typedef {import("../Parser").PreparsedAst} PreparsedAst */
2024-11-07 00:11:54 +08:00
/** @typedef {import("./walkCssTokens").CssTokenCallbacks} CssTokenCallbacks */
/** @typedef {import("../../declarations/WebpackOptions").CssModuleParserOptions} CssModuleParserOptions */
2024-10-01 03:05:27 +08:00
2023-05-22 04:31:30 +08:00
/** @typedef {[number, number]} Range */
2024-10-16 22:42:26 +08:00
/** @typedef {{ line: number, column: number }} Position */
/** @typedef {{ value: string, range: Range, loc: { start: Position, end: Position } }} Comment */
2023-05-22 04:31:30 +08:00
2021-12-14 23:02:26 +08:00
const CC_COLON = ":".charCodeAt(0);
2025-11-05 22:08:26 +08:00
const CC_SEMICOLON = ";".charCodeAt(0);
const CC_COMMA = ",".charCodeAt(0);
2024-10-09 17:09:36 +08:00
const CC_LEFT_PARENTHESIS = "(".charCodeAt(0);
2024-11-07 00:11:54 +08:00
const CC_RIGHT_PARENTHESIS = ")".charCodeAt(0);
2024-11-12 08:21:00 +08:00
const CC_LOWER_F = "f".charCodeAt(0);
const CC_UPPER_F = "F".charCodeAt(0);
2025-11-12 14:03:39 +08:00
const CC_RIGHT_CURLY = "}".charCodeAt(0);
2025-12-12 17:04:58 +08:00
const CC_HYPHEN_MINUS = "-".charCodeAt(0);
const CC_TILDE = "~".charCodeAt(0);
const CC_EQUAL = "=".charCodeAt(0);
2021-12-14 23:02:26 +08:00
2023-04-15 00:19:27 +08:00
// https://www.w3.org/TR/css-syntax-3/#newline
// We don't have `preprocessing` stage, so we need specify all of them
const STRING_MULTILINE = /\\[\n\r\f]/g;
// https://www.w3.org/TR/css-syntax-3/#whitespace
const TRIM_WHITE_SPACES = /(^[ \t\n\r\f]*|[ \t\n\r\f]*$)/g;
2025-12-19 21:17:52 +08:00
const UNESCAPE = /\\([0-9a-f]{1,6}[ \t\n\r\f]?|[\s\S])/gi;
const IMAGE_SET_FUNCTION = /^(?:-\w+-)?image-set$/i;
const OPTIONALLY_VENDOR_PREFIXED_KEYFRAMES_AT_RULE = /^@(?:-\w+-)?keyframes$/;
const COMPOSES_PROPERTY = /^(?:composes|compose-with)$/i;
const IS_MODULES = /\.modules?\.[^.]+$/i;
2024-11-08 21:14:31 +08:00
const CSS_COMMENT = /\/\*((?!\*\/).*?)\*\//g;
2023-04-13 07:27:04 +08:00
/**
* @param {RegExp} regexp a regexp
* @param {string} str a string
* @returns {RegExpExecArray[]} matches
*/
const matchAll = (regexp, str) => {
/** @type {RegExpExecArray[]} */
const result = [];
let match;
// Use a while loop with exec() to find all matches
while ((match = regexp.exec(str)) !== null) {
result.push(match);
}
// Return an array to be easily iterable (note: a true spec-compliant polyfill
// returns an iterator object, but an array spread often suffices for basic use)
return result;
};
2023-04-29 02:50:41 +08:00
/**
* @param {string} str url string
* @param {boolean} isString is url wrapped in quotes
* @returns {string} normalized url
*/
2023-04-13 07:27:04 +08:00
const normalizeUrl = (str, isString) => {
2023-04-13 07:36:01 +08:00
// Remove extra spaces and newlines:
2023-04-13 07:27:04 +08:00
// `url("im\
// g.png")`
if (isString) {
str = str.replace(STRING_MULTILINE, "");
}
2023-04-13 07:36:01 +08:00
str = str
// Remove unnecessary spaces from `url(" img.png ")`
.replace(TRIM_WHITE_SPACES, "")
// Unescape
.replace(UNESCAPE, (match) => {
2023-04-13 07:36:01 +08:00
if (match.length > 2) {
2024-08-02 02:36:27 +08:00
return String.fromCharCode(Number.parseInt(match.slice(1).trim(), 16));
2023-04-13 07:36:01 +08:00
}
2024-07-31 04:21:27 +08:00
return match[1];
2023-04-13 07:36:01 +08:00
});
if (/^data:/i.test(str)) {
return str;
}
if (str.includes("%")) {
2023-04-13 09:08:07 +08:00
// Convert `url('%2E/img.png')` -> `url('./img.png')`
2023-04-13 07:36:01 +08:00
try {
str = decodeURIComponent(str);
2024-07-31 15:37:05 +08:00
} catch (_err) {
2023-04-13 07:36:01 +08:00
// Ignore
}
}
return str;
2021-11-30 19:55:51 +08:00
};
2025-12-19 21:17:52 +08:00
const regexSingleEscape = /[ -,./:-@[\]^`{-~]/;
const regexExcessiveSpaces =
/(^|\\+)?(\\[A-F0-9]{1,6})\u0020(?![a-fA-F0-9\u0020])/g;
/**
* @param {string} str string
* @returns {string} escaped identifier
*/
const escapeIdentifier = (str) => {
let output = "";
let counter = 0;
while (counter < str.length) {
const character = str.charAt(counter++);
let value;
2025-12-19 21:17:52 +08:00
if (/[\t\n\f\r\v]/.test(character)) {
const codePoint = character.charCodeAt(0);
value = `\\${codePoint.toString(16).toUpperCase()} `;
} else if (character === "\\" || regexSingleEscape.test(character)) {
value = `\\${character}`;
} else {
value = character;
}
output += value;
}
const firstChar = str.charAt(0);
if (/^-[-\d]/.test(output)) {
output = `\\-${output.slice(1)}`;
} else if (/\d/.test(firstChar)) {
output = `\\3${firstChar} ${output.slice(1)}`;
}
// Remove spaces after `\HEX` escapes that are not followed by a hex digit,
// since theyre redundant. Note that this is only possible if the escape
// sequence isnt preceded by an odd number of backslashes.
output = output.replace(regexExcessiveSpaces, ($0, $1, $2) => {
if ($1 && $1.length % 2) {
// Its not safe to remove the space, so dont.
return $0;
}
// Strip the space.
return ($1 || "") + $2;
});
return output;
};
const CONTAINS_ESCAPE = /\\/;
/**
* @param {string} str string
* @returns {[string, number] | undefined} hex
*/
const gobbleHex = (str) => {
const lower = str.toLowerCase();
let hex = "";
let spaceTerminated = false;
for (let i = 0; i < 6 && lower[i] !== undefined; i++) {
const code = lower.charCodeAt(i);
// check to see if we are dealing with a valid hex char [a-f|0-9]
const valid = (code >= 97 && code <= 102) || (code >= 48 && code <= 57);
// https://drafts.csswg.org/css-syntax/#consume-escaped-code-point
spaceTerminated = code === 32;
if (!valid) break;
hex += lower[i];
}
if (hex.length === 0) return undefined;
const codePoint = Number.parseInt(hex, 16);
const isSurrogate = codePoint >= 0xd800 && codePoint <= 0xdfff;
// Add special case for
// "If this number is zero, or is for a surrogate, or is greater than the maximum allowed code point"
// https://drafts.csswg.org/css-syntax/#maximum-allowed-code-point
if (isSurrogate || codePoint === 0x0000 || codePoint > 0x10ffff) {
return ["\uFFFD", hex.length + (spaceTerminated ? 1 : 0)];
}
return [
String.fromCodePoint(codePoint),
hex.length + (spaceTerminated ? 1 : 0)
];
};
/**
* @param {string} str string
* @returns {string} unescaped string
*/
const unescapeIdentifier = (str) => {
const needToProcess = CONTAINS_ESCAPE.test(str);
if (!needToProcess) return str;
let ret = "";
for (let i = 0; i < str.length; i++) {
if (str[i] === "\\") {
const gobbled = gobbleHex(str.slice(i + 1, i + 7));
if (gobbled !== undefined) {
ret += gobbled[0];
i += gobbled[1];
continue;
}
// Retain a pair of \\ if double escaped `\\\\`
// https://github.com/postcss/postcss-selector-parser/commit/268c9a7656fb53f543dc620aa5b73a30ec3ff20e
if (str[i + 1] === "\\") {
ret += "\\";
i += 1;
continue;
}
// if \\ is at the end of the string retain it
// https://github.com/postcss/postcss-selector-parser/commit/01a6b346e3612ce1ab20219acc26abdc259ccefb
if (str.length === i + 1) {
ret += str[i];
}
continue;
}
ret += str[i];
}
return ret;
};
/**
* A custom property is any property whose name starts with two dashes (U+002D HYPHEN-MINUS), like --foo.
* The <custom-property-name> production corresponds to this:
* its defined as any <dashed-ident> (a valid identifier that starts with two dashes),
* except -- itself, which is reserved for future use by CSS.
* @param {string} identifier identifier
* @returns {boolean} true when identifier is dashed, otherwise false
*/
const isDashedIdentifier = (identifier) =>
identifier.startsWith("--") && identifier.length >= 3;
/** @type {Record<string, number>} */
const PREDEFINED_COUNTER_STYLES = {
decimal: 1,
"decimal-leading-zero": 1,
"arabic-indic": 1,
armenian: 1,
"upper-armenian": 1,
"lower-armenian": 1,
bengali: 1,
cambodian: 1,
khmer: 1,
"cjk-decimal": 1,
devanagari: 1,
georgian: 1,
gujarati: 1,
/* cspell:disable-next-line */
gurmukhi: 1,
hebrew: 1,
kannada: 1,
lao: 1,
malayalam: 1,
mongolian: 1,
myanmar: 1,
oriya: 1,
persian: 1,
"lower-roman": 1,
"upper-roman": 1,
tamil: 1,
telugu: 1,
thai: 1,
tibetan: 1,
"lower-alpha": 1,
"lower-latin": 1,
"upper-alpha": 1,
"upper-latin": 1,
"lower-greek": 1,
hiragana: 1,
/* cspell:disable-next-line */
"hiragana-iroha": 1,
katakana: 1,
/* cspell:disable-next-line */
"katakana-iroha": 1,
disc: 1,
circle: 1,
square: 1,
"disclosure-open": 1,
"disclosure-closed": 1,
"cjk-earthly-branch": 1,
"cjk-heavenly-stem": 1,
"japanese-informal": 1,
"japanese-formal": 1,
"korean-hangul-formal": 1,
/* cspell:disable-next-line */
"korean-hanja-informal": 1,
/* cspell:disable-next-line */
"korean-hanja-formal": 1,
"simp-chinese-informal": 1,
"simp-chinese-formal": 1,
"trad-chinese-informal": 1,
"trad-chinese-formal": 1,
"cjk-ideographic": 1,
"ethiopic-numeric": 1
};
/** @type {Record<string, number>} */
const GLOBAL_VALUES = {
// Global values
initial: Infinity,
inherit: Infinity,
unset: Infinity,
revert: Infinity,
"revert-layer": Infinity
};
/** @type {Record<string, number>} */
const GRID_AREA_OR_COLUMN_OR_ROW = {
auto: Infinity,
span: Infinity,
...GLOBAL_VALUES
};
/** @type {Record<string, number>} */
const GRID_AUTO_COLUMNS_OR_ROW = {
"min-content": Infinity,
"max-content": Infinity,
auto: Infinity,
...GLOBAL_VALUES
};
/** @type {Record<string, number>} */
const GRID_AUTO_FLOW = {
row: 1,
column: 1,
dense: 1,
...GLOBAL_VALUES
};
/** @type {Record<string, number>} */
const GRID_TEMPLATE_ARES = {
// Special
none: 1,
...GLOBAL_VALUES
};
/** @type {Record<string, number>} */
const GRID_TEMPLATE_COLUMNS_OR_ROWS = {
none: 1,
subgrid: 1,
masonry: 1,
"max-content": Infinity,
"min-content": Infinity,
auto: Infinity,
...GLOBAL_VALUES
};
/** @type {Record<string, number>} */
const GRID_TEMPLATE = {
...GRID_TEMPLATE_ARES,
...GRID_TEMPLATE_COLUMNS_OR_ROWS
};
/** @type {Record<string, number>} */
const GRID = {
"auto-flow": 1,
dense: 1,
...GRID_AUTO_COLUMNS_OR_ROW,
...GRID_AUTO_FLOW,
...GRID_TEMPLATE_ARES,
...GRID_TEMPLATE_COLUMNS_OR_ROWS
};
/**
* @param {{ animation?: boolean, container?: boolean, customIdents?: boolean, grid?: boolean }=} options options
* @returns {Map<string, Record<string, number>>} list of known properties
*/
const getKnownProperties = (options = {}) => {
/** @type {Map<string, Record<string, number>>} */
const knownProperties = new Map();
if (options.animation) {
knownProperties.set("animation", {
// animation-direction
normal: 1,
reverse: 1,
alternate: 1,
"alternate-reverse": 1,
// animation-fill-mode
forwards: 1,
backwards: 1,
both: 1,
// animation-iteration-count
infinite: 1,
// animation-play-state
paused: 1,
running: 1,
// animation-timing-function
ease: 1,
"ease-in": 1,
"ease-out": 1,
"ease-in-out": 1,
linear: 1,
"step-end": 1,
"step-start": 1,
// Special
none: Infinity, // No matter how many times you write none, it will never be an animation name
...GLOBAL_VALUES
});
knownProperties.set("animation-name", {
// Special
none: Infinity, // No matter how many times you write none, it will never be an animation name
...GLOBAL_VALUES
});
}
if (options.container) {
knownProperties.set("container", {
// container-type
normal: 1,
size: 1,
"inline-size": 1,
"scroll-state": 1,
// Special
none: Infinity,
...GLOBAL_VALUES
});
knownProperties.set("container-name", {
// Special
none: Infinity,
...GLOBAL_VALUES
});
}
if (options.customIdents) {
knownProperties.set("list-style", {
// list-style-position
inside: 1,
outside: 1,
// list-style-type
...PREDEFINED_COUNTER_STYLES,
// Special
none: Infinity,
...GLOBAL_VALUES
});
knownProperties.set("list-style-type", {
// list-style-type
...PREDEFINED_COUNTER_STYLES,
// Special
none: Infinity,
...GLOBAL_VALUES
});
knownProperties.set("system", {
cyclic: 1,
numeric: 1,
alphabetic: 1,
symbolic: 1,
additive: 1,
fixed: 1,
extends: 1,
...PREDEFINED_COUNTER_STYLES
});
knownProperties.set("fallback", {
...PREDEFINED_COUNTER_STYLES
});
knownProperties.set("speak-as", {
auto: 1,
bullets: 1,
numbers: 1,
words: 1,
"spell-out": 1,
...PREDEFINED_COUNTER_STYLES
});
}
if (options.grid) {
knownProperties.set("grid", GRID);
knownProperties.set("grid-area", GRID_AREA_OR_COLUMN_OR_ROW);
knownProperties.set("grid-column", GRID_AREA_OR_COLUMN_OR_ROW);
knownProperties.set("grid-column-end", GRID_AREA_OR_COLUMN_OR_ROW);
knownProperties.set("grid-column-start", GRID_AREA_OR_COLUMN_OR_ROW);
knownProperties.set("grid-column-start", GRID_AREA_OR_COLUMN_OR_ROW);
knownProperties.set("grid-row", GRID_AREA_OR_COLUMN_OR_ROW);
knownProperties.set("grid-row-end", GRID_AREA_OR_COLUMN_OR_ROW);
knownProperties.set("grid-row-start", GRID_AREA_OR_COLUMN_OR_ROW);
knownProperties.set("grid-template", GRID_TEMPLATE);
knownProperties.set("grid-template-areas", GRID_TEMPLATE_ARES);
knownProperties.set("grid-template-columns", GRID_TEMPLATE_COLUMNS_OR_ROWS);
knownProperties.set("grid-template-rows", GRID_TEMPLATE_COLUMNS_OR_ROWS);
2025-12-12 17:04:58 +08:00
}
return knownProperties;
};
2021-12-01 21:15:19 +08:00
class LocConverter {
2023-04-29 02:50:41 +08:00
/**
* @param {string} input input
*/
2021-12-01 21:15:19 +08:00
constructor(input) {
this._input = input;
this.line = 1;
this.column = 0;
this.pos = 0;
}
2023-04-29 02:50:41 +08:00
/**
* @param {number} pos position
* @returns {LocConverter} location converter
*/
2021-12-01 21:15:19 +08:00
get(pos) {
if (this.pos !== pos) {
if (this.pos < pos) {
const str = this._input.slice(this.pos, pos);
let i = str.lastIndexOf("\n");
if (i === -1) {
this.column += str.length;
} else {
this.column = str.length - i - 1;
this.line++;
while (i > 0 && (i = str.lastIndexOf("\n", i - 1)) !== -1) {
2021-12-03 02:29:55 +08:00
this.line++;
}
2021-12-01 21:15:19 +08:00
}
} else {
let i = this._input.lastIndexOf("\n", this.pos);
while (i >= pos) {
this.line--;
2021-12-03 02:29:55 +08:00
i = i > 0 ? this._input.lastIndexOf("\n", i - 1) : -1;
2021-12-01 21:15:19 +08:00
}
this.column = pos - i;
}
this.pos = pos;
}
return this;
}
}
2024-10-16 22:42:26 +08:00
const EMPTY_COMMENT_OPTIONS = {
options: null,
errors: null
};
2021-12-01 20:27:00 +08:00
const CSS_MODE_TOP_LEVEL = 0;
2023-05-05 07:49:09 +08:00
const CSS_MODE_IN_BLOCK = 1;
2021-12-01 20:27:00 +08:00
2025-12-12 17:04:58 +08:00
const LOCAL_MODE = 0;
const GLOBAL_MODE = 1;
2024-11-07 00:11:54 +08:00
const eatUntilSemi = walkCssTokens.eatUntil(";");
const eatUntilLeftCurly = walkCssTokens.eatUntil("{");
/**
* @typedef {object} CssParserOwnOptions
* @property {("pure" | "global" | "local" | "auto")=} defaultMode default mode
*/
/** @typedef {CssModuleParserOptions & CssParserOwnOptions} CssParserOptions */
2021-11-30 19:55:51 +08:00
class CssParser extends Parser {
/**
2025-04-16 22:04:11 +08:00
* @param {CssParserOptions=} options options
*/
constructor(options = {}) {
2021-11-30 19:55:51 +08:00
super();
this.defaultMode =
typeof options.defaultMode !== "undefined" ? options.defaultMode : "pure";
this.options = {
url: true,
import: true,
namedExports: true,
animation: true,
container: true,
customIdents: true,
dashedIdents: true,
function: true,
grid: true,
...options
};
2024-10-16 22:42:26 +08:00
/** @type {Comment[] | undefined} */
this.comments = undefined;
this.magicCommentContext = createMagicCommentContext();
2021-11-30 19:55:51 +08:00
}
2023-05-02 08:24:36 +08:00
/**
* @param {ParserState} state parser state
* @param {string} message warning message
* @param {LocConverter} locConverter location converter
* @param {number} start start offset
* @param {number} end end offset
*/
_emitWarning(state, message, locConverter, start, end) {
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
state.current.addWarning(
new ModuleDependencyWarning(state.module, new WebpackError(message), {
start: { line: sl, column: sc },
end: { line: el, column: ec }
})
);
}
2021-11-30 19:55:51 +08:00
/**
* @param {string | Buffer | PreparsedAst} source the source to parse
* @param {ParserState} state the parser state
* @returns {ParserState} the parser state
*/
parse(source, state) {
if (Buffer.isBuffer(source)) {
source = source.toString("utf8");
2021-11-30 19:55:51 +08:00
} else if (typeof source === "object") {
throw new Error("webpackAst is unexpected for the CssParser");
}
2024-08-02 02:36:27 +08:00
if (source[0] === "\uFEFF") {
2021-11-30 19:55:51 +08:00
source = source.slice(1);
}
let mode = this.defaultMode;
2023-06-21 04:40:47 +08:00
const module = state.module;
2023-06-21 04:40:47 +08:00
2022-12-16 20:56:14 +08:00
if (
mode === "auto" &&
2022-12-16 20:56:14 +08:00
module.type === CSS_MODULE_TYPE_AUTO &&
2023-06-11 21:33:10 +08:00
IS_MODULES.test(
2025-12-12 17:04:58 +08:00
// TODO matchResource
2025-08-30 01:28:44 +08:00
parseResource(/** @type {string} */ (module.getResource())).path
2023-06-11 21:33:10 +08:00
)
2022-12-16 20:56:14 +08:00
) {
mode = "local";
2022-12-16 20:56:14 +08:00
}
const isModules = mode === "global" || mode === "local";
const knownProperties = getKnownProperties({
animation: this.options.animation,
container: this.options.container,
customIdents: this.options.customIdents,
grid: this.options.grid
});
/** @type {BuildMeta} */
(module.buildMeta).isCSSModule = isModules;
2021-12-01 21:15:19 +08:00
const locConverter = new LocConverter(source);
2024-10-16 00:04:49 +08:00
2023-04-29 02:50:41 +08:00
/** @type {number} */
2023-05-05 07:53:57 +08:00
let scope = CSS_MODE_TOP_LEVEL;
2023-05-02 08:24:36 +08:00
/** @type {boolean} */
let allowImportAtRule = true;
2025-12-12 17:04:58 +08:00
/** @type {[string, number, number, boolean?][]} */
2024-07-31 04:09:42 +08:00
const balanced = [];
2024-10-17 00:24:48 +08:00
let lastTokenEndForComments = 0;
2024-10-16 00:04:49 +08:00
2023-05-05 04:59:30 +08:00
/** @type {boolean} */
2024-10-16 00:04:49 +08:00
let isNextRulePrelude = isModules;
/** @type {number} */
let blockNestingLevel = 0;
2025-12-12 17:04:58 +08:00
/** @type {0 | 1 | undefined} */
2024-10-16 00:04:49 +08:00
let modeData;
2025-11-05 22:08:26 +08:00
/** @type {string[]} */
let lastLocalIdentifiers = [];
/** @typedef {{ value: string, isReference?: boolean }} IcssDefinition */
2025-03-07 21:12:22 +08:00
/** @type {Map<string, IcssDefinition>} */
2024-11-08 00:32:00 +08:00
const icssDefinitions = new Map();
2023-04-14 04:25:46 +08:00
2023-05-05 09:04:20 +08:00
/**
* @param {string} input input
* @param {number} pos position
* @returns {boolean} true, when next is nested syntax
*/
const isNextNestedSyntax = (input, pos) => {
2025-12-12 17:04:58 +08:00
pos = walkCssTokens.eatWhitespaceAndComments(input, pos)[0];
2023-05-05 09:04:20 +08:00
if (
2025-12-12 17:04:58 +08:00
input.charCodeAt(pos) === CC_RIGHT_CURLY ||
(input.charCodeAt(pos) === CC_HYPHEN_MINUS &&
input.charCodeAt(pos + 1) === CC_HYPHEN_MINUS)
) {
2023-05-05 09:04:20 +08:00
return false;
}
2025-12-12 17:04:58 +08:00
const identifier = walkCssTokens.eatIdentSequence(input, pos);
if (!identifier) {
return true;
}
const leftCurly = eatUntilLeftCurly(input, pos);
const content = input.slice(identifier[0], leftCurly);
if (content.includes(";") || content.includes("}")) {
return false;
}
2023-05-05 09:04:20 +08:00
2025-12-12 17:04:58 +08:00
return true;
2023-05-05 09:04:20 +08:00
};
2023-05-05 02:28:09 +08:00
/**
2023-05-05 07:53:57 +08:00
* @returns {boolean} true, when in local scope
2023-05-05 02:28:09 +08:00
*/
const isLocalMode = () =>
2025-12-12 17:04:58 +08:00
modeData === LOCAL_MODE || (mode === "local" && modeData === undefined);
/**
* @param {string} input input
* @param {number} start start
* @param {number} end end
* @returns {number} end
*/
const comment = (input, start, end) => {
if (!this.comments) this.comments = [];
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
/** @type {Comment} */
const comment = {
value: input.slice(start + 2, end - 2),
range: [start, end],
loc: {
start: { line: sl, column: sc },
end: { line: el, column: ec }
}
};
this.comments.push(comment);
return end;
};
// Vanilla CSS stuff
/**
* @param {string} input input
* @param {number} start name start position
* @param {number} end name end position
* @returns {number} position after handling
*/
const processAtImport = (input, start, end) => {
const tokens = walkCssTokens.eatImportTokens(input, end, {
comment
});
if (!tokens[3]) return end;
const semi = tokens[3][1];
if (!tokens[0]) {
this._emitWarning(
state,
`Expected URL in '${input.slice(start, semi)}'`,
locConverter,
start,
semi
);
return end;
}
const urlToken = tokens[0];
const url = normalizeUrl(input.slice(urlToken[2], urlToken[3]), true);
const newline = walkCssTokens.eatWhiteLine(input, semi);
const { options, errors: commentErrors } = this.parseCommentOptions([
end,
urlToken[1]
]);
if (commentErrors) {
for (const e of commentErrors) {
const { comment } = e;
state.module.addWarning(
new CommentCompilationWarning(
`Compilation error while processing magic comment(-s): /*${comment.value}*/: ${e.message}`,
comment.loc
)
);
}
}
if (options && options.webpackIgnore !== undefined) {
if (typeof options.webpackIgnore !== "boolean") {
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(newline);
state.module.addWarning(
new UnsupportedFeatureWarning(
`\`webpackIgnore\` expected a boolean, but received: ${options.webpackIgnore}.`,
{
start: { line: sl, column: sc },
end: { line: el, column: ec }
}
)
);
} else if (options.webpackIgnore) {
return newline;
}
}
if (url.length === 0) {
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(newline);
const dep = new ConstDependency("", [start, newline]);
module.addPresentationalDependency(dep);
dep.setLoc(sl, sc, el, ec);
return newline;
}
let layer;
if (tokens[1]) {
layer = input.slice(tokens[1][0] + 6, tokens[1][1] - 1).trim();
}
let supports;
if (tokens[2]) {
supports = input.slice(tokens[2][0] + 9, tokens[2][1] - 1).trim();
}
const last = tokens[2] || tokens[1] || tokens[0];
2025-12-12 17:04:58 +08:00
const mediaStart = walkCssTokens.eatWhitespaceAndComments(
input,
last[1]
)[0];
let media;
if (mediaStart !== semi - 1) {
media = input.slice(mediaStart, semi - 1).trim();
}
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(newline);
const dep = new CssImportDependency(
url,
[start, newline],
mode === "local" || mode === "global" ? mode : undefined,
layer,
supports && supports.length > 0 ? supports : undefined,
media && media.length > 0 ? media : undefined
);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
return newline;
};
/**
* @param {string} input input
* @param {number} end end position
* @param {string} name the name of function
* @returns {number} position after handling
*/
const processURLFunction = (input, end, name) => {
const string = walkCssTokens.eatString(input, end);
if (!string) return end;
const { options, errors: commentErrors } = this.parseCommentOptions([
lastTokenEndForComments,
end
]);
if (commentErrors) {
for (const e of commentErrors) {
const { comment } = e;
state.module.addWarning(
new CommentCompilationWarning(
`Compilation error while processing magic comment(-s): /*${comment.value}*/: ${e.message}`,
comment.loc
)
);
}
}
if (options && options.webpackIgnore !== undefined) {
if (typeof options.webpackIgnore !== "boolean") {
const { line: sl, column: sc } = locConverter.get(string[0]);
const { line: el, column: ec } = locConverter.get(string[1]);
state.module.addWarning(
new UnsupportedFeatureWarning(
`\`webpackIgnore\` expected a boolean, but received: ${options.webpackIgnore}.`,
{
start: { line: sl, column: sc },
end: { line: el, column: ec }
}
)
);
} else if (options.webpackIgnore) {
return end;
}
}
const value = normalizeUrl(
input.slice(string[0] + 1, string[1] - 1),
true
);
// Ignore `url()`, `url('')` and `url("")`, they are valid by spec
if (value.length === 0) return end;
const isUrl = name === "url" || name === "src";
const dep = new CssUrlDependency(
value,
[string[0], string[1]],
isUrl ? "string" : "url"
);
const { line: sl, column: sc } = locConverter.get(string[0]);
const { line: el, column: ec } = locConverter.get(string[1]);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
module.addCodeGenerationDependency(dep);
return string[1];
};
/**
* @param {string} input input
* @param {number} start start position
* @param {number} end end position
* @param {number} contentStart start position
* @param {number} contentEnd end position
* @returns {number} position after handling
*/
const processOldURLFunction = (
input,
start,
end,
contentStart,
contentEnd
) => {
const { options, errors: commentErrors } = this.parseCommentOptions([
lastTokenEndForComments,
end
]);
if (commentErrors) {
for (const e of commentErrors) {
const { comment } = e;
state.module.addWarning(
new CommentCompilationWarning(
`Compilation error while processing magic comment(-s): /*${comment.value}*/: ${e.message}`,
comment.loc
)
);
}
}
if (options && options.webpackIgnore !== undefined) {
if (typeof options.webpackIgnore !== "boolean") {
const { line: sl, column: sc } = locConverter.get(
lastTokenEndForComments
);
const { line: el, column: ec } = locConverter.get(end);
state.module.addWarning(
new UnsupportedFeatureWarning(
`\`webpackIgnore\` expected a boolean, but received: ${options.webpackIgnore}.`,
{
start: { line: sl, column: sc },
end: { line: el, column: ec }
}
)
);
} else if (options.webpackIgnore) {
return end;
}
}
const value = normalizeUrl(input.slice(contentStart, contentEnd), false);
// Ignore `url()`, `url('')` and `url("")`, they are valid by spec
if (value.length === 0) return end;
const dep = new CssUrlDependency(value, [start, end], "url");
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
module.addCodeGenerationDependency(dep);
return end;
};
/**
* @param {string} input input
* @param {number} start start position
* @param {number} end end position
* @returns {number} position after handling
*/
const processImageSetFunction = (input, start, end) => {
lastTokenEndForComments = end;
const values = walkCssTokens.eatImageSetStrings(input, end, {
comment
});
if (values.length === 0) return end;
for (const [index, string] of values.entries()) {
const value = normalizeUrl(
input.slice(string[0] + 1, string[1] - 1),
true
);
if (value.length === 0) return end;
const { options, errors: commentErrors } = this.parseCommentOptions([
index === 0 ? start : values[index - 1][1],
string[1]
]);
if (commentErrors) {
for (const e of commentErrors) {
const { comment } = e;
state.module.addWarning(
new CommentCompilationWarning(
`Compilation error while processing magic comment(-s): /*${comment.value}*/: ${e.message}`,
comment.loc
)
);
}
}
if (options && options.webpackIgnore !== undefined) {
if (typeof options.webpackIgnore !== "boolean") {
const { line: sl, column: sc } = locConverter.get(string[0]);
const { line: el, column: ec } = locConverter.get(string[1]);
state.module.addWarning(
new UnsupportedFeatureWarning(
`\`webpackIgnore\` expected a boolean, but received: ${options.webpackIgnore}.`,
{
start: { line: sl, column: sc },
end: { line: el, column: ec }
}
)
);
} else if (options.webpackIgnore) {
continue;
}
}
const dep = new CssUrlDependency(value, [string[0], string[1]], "url");
const { line: sl, column: sc } = locConverter.get(string[0]);
const { line: el, column: ec } = locConverter.get(string[1]);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
module.addCodeGenerationDependency(dep);
}
// Can contain `url()` inside, so let's return end to allow parse them
return end;
};
// CSS modules stuff
2025-12-12 17:04:58 +08:00
/**
* @param {string} value value to resolve
* @returns {string | [string, string, boolean]} resolved reexport
*/
const getReexport = (value) => {
const reexport = icssDefinitions.get(value);
if (reexport) {
if (reexport.isReference) {
return [value, reexport.value, true];
}
return [value, reexport.value, false];
}
return value;
};
2023-05-05 05:38:41 +08:00
/**
2024-11-07 00:11:54 +08:00
* @param {0 | 1} type import or export
2023-05-05 05:38:41 +08:00
* @param {string} input input
* @param {number} pos start position
* @returns {number} position after parse
*/
2025-11-12 14:03:39 +08:00
const processImportOrExport = (type, input, pos) => {
2025-12-12 17:04:58 +08:00
pos = walkCssTokens.eatWhitespaceAndComments(input, pos)[0];
2025-03-07 21:12:22 +08:00
/** @type {string | undefined} */
let request;
2024-11-07 00:11:54 +08:00
if (type === 0) {
let cc = input.charCodeAt(pos);
if (cc !== CC_LEFT_PARENTHESIS) {
2023-05-02 17:15:52 +08:00
this._emitWarning(
state,
2024-11-07 00:11:54 +08:00
`Unexpected '${input[pos]}' at ${pos} during parsing of ':import' (expected '(')`,
2023-05-02 17:15:52 +08:00
locConverter,
2024-11-07 00:11:54 +08:00
pos,
2023-05-02 17:15:52 +08:00
pos
2021-12-14 23:02:26 +08:00
);
2023-05-02 17:15:52 +08:00
return pos;
2021-12-14 23:02:26 +08:00
}
pos++;
2024-11-07 00:11:54 +08:00
const stringStart = pos;
const str = walkCssTokens.eatString(input, pos);
if (!str) {
this._emitWarning(
state,
`Unexpected '${input[pos]}' at ${pos} during parsing of '${type ? ":import" : ":export"}' (expected string)`,
2024-11-07 00:11:54 +08:00
locConverter,
stringStart,
pos
);
return pos;
}
request = input.slice(str[0] + 1, str[1] - 1);
2024-11-07 00:11:54 +08:00
pos = str[1];
2025-12-12 17:04:58 +08:00
pos = walkCssTokens.eatWhitespaceAndComments(input, pos)[0];
2024-11-07 00:11:54 +08:00
cc = input.charCodeAt(pos);
if (cc !== CC_RIGHT_PARENTHESIS) {
2023-05-02 17:15:52 +08:00
this._emitWarning(
state,
2024-11-07 00:11:54 +08:00
`Unexpected '${input[pos]}' at ${pos} during parsing of ':import' (expected ')')`,
2023-05-02 17:15:52 +08:00
locConverter,
2024-11-07 00:11:54 +08:00
pos,
2023-05-02 17:15:52 +08:00
pos
2021-12-14 23:02:26 +08:00
);
2023-05-02 17:15:52 +08:00
return pos;
2021-12-14 23:02:26 +08:00
}
2024-11-07 00:11:54 +08:00
pos++;
2025-12-12 17:04:58 +08:00
pos = walkCssTokens.eatWhitespaceAndComments(input, pos)[0];
2021-12-14 23:02:26 +08:00
}
2024-11-07 00:11:54 +08:00
/**
* @param {string} name name
* @param {string} value value
* @param {number} start start of position
* @param {number} end end of position
*/
const createDep = (name, value, start, end) => {
if (type === 0) {
const dep = new CssIcssImportDependency(
/** @type {string} */
(request),
[0, 0],
/** @type {"local" | "global"} */
(mode),
2024-11-08 00:32:00 +08:00
value
);
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
icssDefinitions.set(name, { value, isReference: true });
2024-11-07 00:11:54 +08:00
} else if (type === 1) {
2025-12-12 17:04:58 +08:00
const dep = new CssIcssExportDependency(name, getReexport(value));
2024-11-07 00:11:54 +08:00
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
}
};
let needTerminate = false;
let balanced = 0;
/** @type {undefined | 0 | 1 | 2} */
let scope;
2025-03-07 21:12:22 +08:00
/** @typedef {[number, number]} Name */
/** @type {Name | undefined} */
2024-11-07 00:11:54 +08:00
let name;
/** @type {number | undefined} */
let value;
/** @type {CssTokenCallbacks} */
const callbacks = {
leftCurlyBracket: (_input, _start, end) => {
balanced++;
if (scope === undefined) {
scope = 0;
}
return end;
},
rightCurlyBracket: (_input, _start, end) => {
balanced--;
if (scope === 2) {
2025-03-07 21:12:22 +08:00
const [nameStart, nameEnd] = /** @type {Name} */ (name);
2024-11-07 00:11:54 +08:00
createDep(
2025-03-07 21:12:22 +08:00
input.slice(nameStart, nameEnd),
2024-11-07 00:11:54 +08:00
input.slice(value, end - 1).trim(),
2025-03-07 21:12:22 +08:00
nameEnd,
2024-11-07 00:11:54 +08:00
end - 1
);
scope = 0;
}
if (balanced === 0 && scope === 0) {
needTerminate = true;
}
return end;
},
identifier: (_input, start, end) => {
if (scope === 0) {
name = [start, end];
scope = 1;
}
return end;
},
colon: (_input, _start, end) => {
if (scope === 1) {
scope = 2;
value = walkCssTokens.eatWhitespace(input, end);
return value;
}
return end;
},
semicolon: (input, _start, end) => {
if (scope === 2) {
2025-03-07 21:12:22 +08:00
const [nameStart, nameEnd] = /** @type {Name} */ (name);
2024-11-07 00:11:54 +08:00
createDep(
2025-03-07 21:12:22 +08:00
input.slice(nameStart, nameEnd),
2024-11-07 00:11:54 +08:00
input.slice(value, end - 1),
2025-03-07 21:12:22 +08:00
nameEnd,
2024-11-07 00:11:54 +08:00
end - 1
);
scope = 0;
}
return end;
},
needTerminate: () => needTerminate
};
pos = walkCssTokens(input, pos, callbacks);
2023-05-01 22:46:47 +08:00
pos = walkCssTokens.eatWhiteLine(input, pos);
2024-11-07 00:11:54 +08:00
2021-12-14 23:02:26 +08:00
return pos;
};
2025-11-12 14:03:39 +08:00
/**
* @param {string} input input
* @param {number} start name start position
* @param {number} end name end position
* @returns {number} position after handling
*/
const processAtValue = (input, start, end) => {
const semi = eatUntilSemi(input, end);
const atRuleEnd = semi + 1;
const params = input.slice(end, semi);
let [alias, request] = params.split(/\s*from\s*/);
2025-11-12 14:03:39 +08:00
if (request) {
2025-11-12 14:03:39 +08:00
const aliases = alias
.replace(CSS_COMMENT, " ")
.trim()
.replace(/^\(\s*|\s*\)$/g, "")
2025-11-12 14:03:39 +08:00
.split(/\s*,\s*/);
request = request.replace(CSS_COMMENT, "").trim();
2025-11-12 14:03:39 +08:00
const isExplicitImport = request[0] === "'" || request[0] === '"';
2025-11-12 14:03:39 +08:00
if (isExplicitImport) {
request = request.slice(1, -1);
2025-11-12 14:03:39 +08:00
}
for (const alias of aliases) {
const [name, aliasName] = alias.split(/\s+as\s+/);
{
const reexport = icssDefinitions.get(request);
if (reexport) {
request = reexport.value.slice(1, -1);
}
const dep = new CssIcssImportDependency(
request,
[0, 0],
/** @type {"local" | "global"} */
(mode),
name
);
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
icssDefinitions.set(aliasName || name, {
value: name,
isReference: true
});
}
{
const dep = new CssIcssExportDependency(
2025-12-12 17:04:58 +08:00
aliasName || name,
getReexport(aliasName || name),
undefined,
false,
CssIcssExportDependency.EXPORT_MODE.REPLACE
);
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
}
2025-11-12 14:03:39 +08:00
}
} else {
const ident = walkCssTokens.eatIdentSequence(alias, 0);
if (!ident) {
this._emitWarning(
state,
`Broken '@value' at-rule: ${input.slice(start, atRuleEnd)}'`,
locConverter,
start,
atRuleEnd
);
const dep = new ConstDependency("", [start, atRuleEnd]);
module.addPresentationalDependency(dep);
return atRuleEnd;
}
2025-12-12 17:04:58 +08:00
const pos = walkCssTokens.eatWhitespaceAndComments(alias, ident[1])[0];
2025-11-12 14:03:39 +08:00
const name = alias.slice(ident[0], ident[1]);
let value =
alias.charCodeAt(pos) === CC_COLON
? alias.slice(pos + 1)
: alias.slice(ident[1]);
if (value && !/^\s+$/.test(value.replace(CSS_COMMENT, ""))) {
2025-11-12 14:03:39 +08:00
value = value.trim();
}
if (icssDefinitions.has(value)) {
const def =
/** @type {IcssDefinition} */
(icssDefinitions.get(value));
value = def.value;
}
icssDefinitions.set(name, { value });
const dep = new CssIcssExportDependency(name, value);
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
}
const dep = new ConstDependency("", [start, atRuleEnd]);
module.addPresentationalDependency(dep);
return atRuleEnd;
};
/**
* @param {string} name ICSS symbol name
* @param {number} start start position
* @param {number} end end position
2025-11-12 14:03:39 +08:00
* @returns {number} position after handling
*/
const processICSSSymbol = (name, start, end) => {
const { value, isReference } =
/** @type {IcssDefinition} */
(icssDefinitions.get(name));
2025-11-12 14:03:39 +08:00
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
const dep = new CssIcssSymbolDependency(
name,
value,
[start, end],
isReference
2025-11-12 14:03:39 +08:00
);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
return end;
2025-11-12 14:03:39 +08:00
};
2025-11-12 14:03:39 +08:00
/**
* @param {string} input input
* @param {1 | 2} type type of function
* @param {number} start start position
* @param {number} end end position
2025-11-12 14:03:39 +08:00
* @returns {number} position after handling
*/
2025-12-12 17:04:58 +08:00
const processLocalOrGlobalFunction = (input, type, start, end) => {
// Replace `local(`/` or `global(` (handle legacy `:local(` or `:global(` too)
{
const isColon = input.charCodeAt(start - 1) === CC_COLON;
const dep = new ConstDependency("", [isColon ? start - 1 : start, end]);
module.addPresentationalDependency(dep);
}
end = walkCssTokens.consumeUntil(
input,
start,
{
identifier(input, start, end) {
if (type === 1) {
2025-12-12 17:04:58 +08:00
let identifier = unescapeIdentifier(input.slice(start, end));
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
const isDashedIdent = isDashedIdentifier(identifier);
2025-12-12 17:04:58 +08:00
if (isDashedIdent) {
identifier = identifier.slice(2);
}
const dep = new CssIcssExportDependency(
identifier,
getReexport(identifier),
[start, end],
true,
CssIcssExportDependency.EXPORT_MODE.ONCE,
isDashedIdent
? CssIcssExportDependency.EXPORT_TYPE.CUSTOM_VARIABLE
: CssIcssExportDependency.EXPORT_TYPE.NORMAL
);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
}
return end;
}
},
{},
{ onlyTopLevel: true, functionValue: true }
2025-11-12 14:03:39 +08:00
);
{
// Replace the last `)`
const dep = new ConstDependency("", [end, end + 1]);
module.addPresentationalDependency(dep);
}
return end;
2025-11-12 14:03:39 +08:00
};
2025-11-12 14:03:39 +08:00
/**
* @param {string} input input
* @param {number} end name end position
* @param {{ string?: boolean, identifier?: boolean | RegExp }} options types which allowed to handle
2025-11-12 14:03:39 +08:00
* @returns {number} position after handling
*/
const processLocalAtRule = (input, end, options) => {
let found = false;
return walkCssTokens.consumeUntil(
input,
end,
{
string(_input, start, end) {
if (!found && options.string) {
2025-12-12 17:04:58 +08:00
const value = unescapeIdentifier(input.slice(start + 1, end - 1));
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
2025-12-12 17:04:58 +08:00
const dep = new CssIcssExportDependency(
value,
value,
[start, end],
true,
CssIcssExportDependency.EXPORT_MODE.ONCE
);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
found = true;
}
return end;
},
identifier(input, start, end) {
if (!found) {
2025-12-12 17:04:58 +08:00
const value = input.slice(start, end);
if (options.identifier) {
const identifier = unescapeIdentifier(value);
if (
options.identifier instanceof RegExp &&
options.identifier.test(identifier)
) {
return end;
}
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
2025-12-12 17:04:58 +08:00
const dep = new CssIcssExportDependency(
identifier,
getReexport(identifier),
[start, end],
2025-12-12 17:04:58 +08:00
true,
CssIcssExportDependency.EXPORT_MODE.ONCE,
CssIcssExportDependency.EXPORT_TYPE.NORMAL
);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
found = true;
}
}
return end;
}
},
{
function: (input, start, end) => {
// No need to handle `:` (COLON), because it's always a function
const name = input
.slice(start, end - 1)
.replace(/\\/g, "")
.toLowerCase();
const type =
name === "local" ? 1 : name === "global" ? 2 : undefined;
if (!found && type) {
found = true;
2025-12-12 17:04:58 +08:00
return processLocalOrGlobalFunction(input, type, start, end);
}
if (
this.options.dashedIdents &&
isLocalMode() &&
(name === "var" || name === "style")
) {
return processDashedIdent(input, end, end);
}
return end;
}
},
{ onlyTopLevel: true, atRulePrelude: true }
);
2025-11-12 14:03:39 +08:00
};
/**
* @param {string} input input
* @param {number} start start position
2025-11-12 14:03:39 +08:00
* @param {number} end end position
* @returns {number} position after handling
*/
const processDashedIdent = (input, start, end) => {
const customIdent = walkCssTokens.eatIdentSequence(input, start);
2025-11-12 14:03:39 +08:00
if (!customIdent) return end;
const identifier = unescapeIdentifier(
2025-11-12 14:03:39 +08:00
input.slice(customIdent[0] + 2, customIdent[1])
);
const afterCustomIdent = walkCssTokens.eatWhitespaceAndComments(
input,
customIdent[1]
2025-12-12 17:04:58 +08:00
)[0];
2025-11-12 14:03:39 +08:00
if (
input.charCodeAt(afterCustomIdent) === CC_LOWER_F ||
input.charCodeAt(afterCustomIdent) === CC_UPPER_F
) {
const fromWord = walkCssTokens.eatIdentSequence(
input,
afterCustomIdent
);
if (
!fromWord ||
input.slice(fromWord[0], fromWord[1]).toLowerCase() !== "from"
) {
return end;
}
const from = walkCssTokens.eatIdentSequenceOrString(
input,
2025-12-12 17:04:58 +08:00
walkCssTokens.eatWhitespaceAndComments(input, fromWord[1])[0]
2025-11-12 14:03:39 +08:00
);
if (!from) {
return end;
}
const path = input.slice(from[0], from[1]);
if (from[2] === true && path === "global") {
const dep = new ConstDependency("", [customIdent[1], from[1]]);
module.addPresentationalDependency(dep);
return end;
} else if (from[2] === false) {
const { line: sl, column: sc } = locConverter.get(customIdent[0]);
const { line: el, column: ec } = locConverter.get(from[1] - 1);
2025-12-12 17:04:58 +08:00
const dep = new CssIcssImportDependency(
2025-11-12 14:03:39 +08:00
path.slice(1, -1),
2025-12-12 17:04:58 +08:00
[customIdent[0], from[1] - 1],
2025-11-12 14:03:39 +08:00
/** @type {"local" | "global"} */
(mode),
identifier,
identifier,
2025-12-12 17:04:58 +08:00
CssIcssExportDependency.EXPORT_MODE.NONE,
CssIcssExportDependency.EXPORT_TYPE.CUSTOM_VARIABLE
2025-11-12 14:03:39 +08:00
);
2025-11-12 14:03:39 +08:00
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
{
const dep = new ConstDependency("", [fromWord[0], from[1]]);
module.addPresentationalDependency(dep);
return end;
}
2025-11-12 14:03:39 +08:00
}
} else {
const { line: sl, column: sc } = locConverter.get(customIdent[0]);
const { line: el, column: ec } = locConverter.get(customIdent[1]);
2025-12-12 17:04:58 +08:00
const dep = new CssIcssExportDependency(
identifier,
2025-12-12 17:04:58 +08:00
getReexport(identifier),
2025-11-12 14:03:39 +08:00
[customIdent[0], customIdent[1]],
2025-12-12 17:04:58 +08:00
true,
CssIcssExportDependency.EXPORT_MODE.ONCE,
CssIcssExportDependency.EXPORT_TYPE.CUSTOM_VARIABLE
2025-11-12 14:03:39 +08:00
);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
return end;
}
return end;
};
2023-05-05 05:27:59 +08:00
/**
* @param {string} input input
* @param {number} pos name start position
* @param {number} end name end position
* @returns {number} position after handling
*/
2023-05-05 03:40:00 +08:00
const processLocalDeclaration = (input, pos, end) => {
2025-12-12 17:04:58 +08:00
pos = walkCssTokens.eatWhitespaceAndComments(input, pos)[0];
const identifier = walkCssTokens.eatIdentSequence(input, pos);
if (!identifier) {
return end;
}
const propertyNameStart = identifier[0];
pos = walkCssTokens.eatWhitespaceAndComments(input, identifier[1])[0];
if (input.charCodeAt(pos) !== CC_COLON) {
return end;
}
pos += 1;
// Remove prefix and lowercase
const propertyName = input
.slice(identifier[0], identifier[1])
.replace(/^(-\w+-)/, "")
.toLowerCase();
if (isLocalMode() && knownProperties.has(propertyName)) {
/** @type {[number, number, boolean?][]} */
2025-12-12 17:04:58 +08:00
const values = [];
2025-11-12 14:03:39 +08:00
/** @type {Record<string, number>} */
let parsedKeywords = Object.create(null);
2025-11-12 14:03:39 +08:00
const isGridProperty = Boolean(propertyName.startsWith("grid"));
const isGridTemplate = isGridProperty
? Boolean(
propertyName === "grid" ||
propertyName === "grid-template" ||
propertyName === "grid-template-columns" ||
propertyName === "grid-template-rows"
)
: false;
2025-11-12 14:03:39 +08:00
const end = walkCssTokens.consumeUntil(
input,
pos,
{
leftSquareBracket(input, start, end) {
let i = end;
while (true) {
i = walkCssTokens.eatWhitespaceAndComments(input, i)[0];
const name = walkCssTokens.eatIdentSequence(input, i);
if (!name) {
break;
}
values.push(name);
i = name[1];
}
return end;
},
2025-11-12 14:03:39 +08:00
string(_input, start, end) {
2025-12-12 17:04:58 +08:00
if (
propertyName === "animation" ||
propertyName === "animation-name"
) {
values.push([start, end, true]);
}
2025-11-12 14:03:39 +08:00
if (
propertyName === "grid" ||
propertyName === "grid-template" ||
propertyName === "grid-template-areas"
) {
const areas = unescapeIdentifier(
input.slice(start + 1, end - 1)
);
const matches = matchAll(/\b\w+\b/g, areas);
for (const match of matches) {
const areaStart = start + 1 + match.index;
values.push([areaStart, areaStart + match[0].length, false]);
}
}
2025-11-12 14:03:39 +08:00
return end;
},
identifier(input, start, end) {
if (isGridTemplate) {
return end;
}
const identifier = input.slice(start, end);
const keyword = identifier.toLowerCase();
2025-11-12 14:03:39 +08:00
parsedKeywords[keyword] =
typeof parsedKeywords[keyword] !== "undefined"
? parsedKeywords[keyword] + 1
2025-11-12 14:03:39 +08:00
: 0;
const keywords =
/** @type {Record<string, number>} */
(knownProperties.get(propertyName));
2025-11-12 14:03:39 +08:00
if (
2025-12-12 17:04:58 +08:00
keywords[keyword] &&
parsedKeywords[keyword] < keywords[keyword]
2025-11-12 14:03:39 +08:00
) {
return end;
}
values.push([start, end]);
2025-11-12 14:03:39 +08:00
return end;
},
comma(_input, _start, end) {
parsedKeywords = {};
2025-11-12 14:03:39 +08:00
return end;
}
},
{
function: (input, start, end) => {
2025-11-12 14:03:39 +08:00
const name = input
.slice(start, end - 1)
.replace(/\\/g, "")
.toLowerCase();
const type =
name === "local" ? 1 : name === "global" ? 2 : undefined;
if (type) {
2025-12-12 17:04:58 +08:00
return processLocalOrGlobalFunction(input, type, start, end);
}
if (
this.options.dashedIdents &&
isLocalMode() &&
name === "var"
) {
return processDashedIdent(input, end, end);
2025-11-12 14:03:39 +08:00
}
if (this.options.url) {
if (name === "src" || name === "url") {
return processURLFunction(input, end, name);
} else if (IMAGE_SET_FUNCTION.test(name)) {
return processImageSetFunction(input, start, end);
}
}
2025-11-12 14:03:39 +08:00
return end;
}
},
{
onlyTopLevel: !isGridTemplate,
declarationValue: true
}
2025-11-12 14:03:39 +08:00
);
2025-12-12 17:04:58 +08:00
if (values.length > 0) {
for (const value of values) {
const { line: sl, column: sc } = locConverter.get(value[0]);
const { line: el, column: ec } = locConverter.get(value[1]);
const [start, end, isString] = value;
2025-11-12 14:03:39 +08:00
const name = unescapeIdentifier(
isString
? input.slice(start + 1, end - 1)
: input.slice(start, end)
);
2025-12-12 17:04:58 +08:00
const dep = new CssIcssExportDependency(
name,
2025-12-12 17:04:58 +08:00
getReexport(name),
[start, end],
true,
CssIcssExportDependency.EXPORT_MODE.ONCE,
isGridProperty
? CssIcssExportDependency.EXPORT_TYPE.GRID_CUSTOM_IDENTIFIER
: CssIcssExportDependency.EXPORT_TYPE.NORMAL
);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
}
}
2025-11-12 14:03:39 +08:00
return end;
2025-11-05 22:08:26 +08:00
} else if (COMPOSES_PROPERTY.test(propertyName)) {
if (lastLocalIdentifiers.length > 1) {
const end = eatUntilSemi(input, pos);
this._emitWarning(
state,
`Composition is only allowed when selector is single local class name not in "${lastLocalIdentifiers.join('", "')}"`,
locConverter,
pos,
end
);
return end;
}
if (lastLocalIdentifiers.length !== 1) return pos;
2025-11-05 22:08:26 +08:00
const lastLocalIdentifier = lastLocalIdentifiers[0];
2025-11-12 14:03:39 +08:00
let end = pos;
2025-11-05 22:08:26 +08:00
/** @type {Set<[number, number]>} */
const classNames = new Set();
while (true) {
2025-12-12 17:04:58 +08:00
pos = walkCssTokens.eatWhitespaceAndComments(input, pos)[0];
2025-11-05 22:08:26 +08:00
let className = walkCssTokens.eatIdentSequence(input, pos);
2025-11-05 22:08:26 +08:00
const ifFunction =
className && input.charCodeAt(className[1]) === CC_LEFT_PARENTHESIS;
let isGlobalFunction = false;
if (className && ifFunction) {
const name = input
.slice(className[0], className[1])
.replace(/\\/g, "")
.toLowerCase();
isGlobalFunction = name === "global";
pos = walkCssTokens.eatWhitespaceAndComments(
input,
className[1] + 1
2025-12-12 17:04:58 +08:00
)[0];
className = walkCssTokens.eatIdentSequence(input, pos);
if (className) {
2025-12-12 17:04:58 +08:00
pos = walkCssTokens.eatWhitespaceAndComments(
input,
className[1]
)[0];
pos += 1;
}
} else if (className) {
2025-12-12 17:04:58 +08:00
pos = walkCssTokens.eatWhitespaceAndComments(
input,
className[1]
)[0];
pos = className[1];
2025-11-05 22:08:26 +08:00
}
// True when we have multiple values
const isComma = input.charCodeAt(pos) === CC_COMMA;
const isSemicolon = input.charCodeAt(pos) === CC_SEMICOLON;
2025-11-12 14:03:39 +08:00
const isRightCurly = input.charCodeAt(pos) === CC_RIGHT_CURLY;
2025-11-05 22:08:26 +08:00
2025-11-12 14:03:39 +08:00
if (isComma || isSemicolon || isRightCurly) {
2025-11-05 22:08:26 +08:00
if (className) {
classNames.add(className);
}
for (const className of classNames) {
const [start, end] = className;
2025-11-12 14:03:39 +08:00
const identifier = unescapeIdentifier(input.slice(start, end));
2025-12-12 17:04:58 +08:00
const resolvedClassName = getReexport(identifier);
const dep = new CssIcssExportDependency(
lastLocalIdentifier,
resolvedClassName,
[start, end],
isGlobalFunction ? false : !Array.isArray(resolvedClassName),
isGlobalFunction
? CssIcssExportDependency.EXPORT_MODE.APPEND
: CssIcssExportDependency.EXPORT_MODE.SELF_REFERENCE
);
2025-11-05 22:08:26 +08:00
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
}
classNames.clear();
2025-11-12 14:03:39 +08:00
if (isSemicolon || isRightCurly) {
end = isSemicolon
? walkCssTokens.eatWhitespace(input, pos + 1)
: pos;
2025-11-05 22:08:26 +08:00
break;
}
2025-11-12 14:03:39 +08:00
pos += 1;
2025-11-05 22:08:26 +08:00
} else if (
classNames.size > 0 &&
className &&
input.slice(className[0], className[1]).toLowerCase() === "from"
) {
let from = walkCssTokens.eatString(input, pos);
if (from) {
const request = input.slice(from[0] + 1, from[1] - 1);
for (const className of classNames) {
const [start, end] = className;
const identifier = unescapeIdentifier(input.slice(start, end));
2025-12-12 17:04:58 +08:00
const dep = new CssIcssImportDependency(
2025-11-05 22:08:26 +08:00
request,
2025-12-12 17:04:58 +08:00
[start, end],
/** @type {"local" | "global"} */
(mode),
identifier,
2025-11-05 22:08:26 +08:00
/** @type {string} */
2025-12-12 17:04:58 +08:00
(lastLocalIdentifier),
CssIcssExportDependency.EXPORT_MODE.APPEND
2025-11-05 22:08:26 +08:00
);
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
}
classNames.clear();
pos = from[1];
} else {
from = walkCssTokens.eatIdentSequence(input, pos);
if (from && input.slice(from[0], from[1]) === "global") {
for (const className of classNames) {
const [start, end] = className;
const identifier = unescapeIdentifier(
input.slice(start, end)
);
2025-12-12 17:04:58 +08:00
const dep = new CssIcssExportDependency(
2025-11-05 22:08:26 +08:00
/** @type {string} */
(lastLocalIdentifier),
2025-12-12 17:04:58 +08:00
getReexport(identifier),
[start, end],
false,
CssIcssExportDependency.EXPORT_MODE.APPEND
2025-11-05 22:08:26 +08:00
);
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
}
classNames.clear();
pos = from[1];
} else {
const end = eatUntilSemi(input, pos);
this._emitWarning(
state,
"Incorrect composition, expected global keyword or string value",
locConverter,
pos,
end
);
return end;
}
}
} else if (className) {
classNames.add(className);
} else {
const end = eatUntilSemi(input, pos);
this._emitWarning(
state,
"Incorrect composition, expected class named",
locConverter,
pos,
end
);
return end;
}
}
// Remove `composes` from source code
2025-11-12 14:03:39 +08:00
const dep = new ConstDependency("", [propertyNameStart, end]);
2025-11-05 22:08:26 +08:00
module.addPresentationalDependency(dep);
}
2025-12-12 17:04:58 +08:00
return pos;
};
2025-11-12 14:03:39 +08:00
/**
* @param {string} input input
* @param {number} start start position
* @param {number} end end position
* @returns {number} position after handling
*/
2025-12-12 17:04:58 +08:00
const processIdSelector = (input, start, end) => {
2025-11-12 14:03:39 +08:00
const valueStart = start + 1;
const name = unescapeIdentifier(input.slice(valueStart, end));
2025-12-12 17:04:58 +08:00
const dep = new CssIcssExportDependency(
name,
getReexport(name),
[valueStart, end],
true,
CssIcssExportDependency.EXPORT_MODE.ONCE
);
2025-11-12 14:03:39 +08:00
const { line: sl, column: sc } = locConverter.get(start);
const { line: el, column: ec } = locConverter.get(end);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
return end;
};
2024-10-16 03:32:17 +08:00
2025-12-12 17:04:58 +08:00
/**
* @param {string} input input
* @param {number} start start position
* @param {number} end end position
* @returns {number} position after handling
*/
const processClassSelector = (input, start, end) => {
const ident = walkCssTokens.skipCommentsAndEatIdentSequence(input, end);
if (!ident) return end;
const name = unescapeIdentifier(input.slice(ident[0], ident[1]));
lastLocalIdentifiers.push(name);
const dep = new CssIcssExportDependency(
name,
getReexport(name),
[ident[0], ident[1]],
true,
CssIcssExportDependency.EXPORT_MODE.ONCE
);
const { line: sl, column: sc } = locConverter.get(ident[0]);
const { line: el, column: ec } = locConverter.get(ident[1]);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
return ident[1];
};
/**
* @param {string} input input
* @param {number} start start position
* @param {number} end end position
* @returns {number} position after handling
*/
const processAttributeSelector = (input, start, end) => {
end = walkCssTokens.eatWhitespaceAndComments(input, end)[0];
const identifier = walkCssTokens.eatIdentSequence(input, end);
if (!identifier) return end;
const name = unescapeIdentifier(
input.slice(identifier[0], identifier[1])
);
if (name.toLowerCase() !== "class") {
return end;
}
end = walkCssTokens.eatWhitespaceAndComments(input, identifier[1])[0];
const isTilde = input.charCodeAt(end) === CC_TILDE;
if (
input.charCodeAt(end) !== CC_EQUAL &&
input.charCodeAt(end) !== CC_TILDE
) {
return end;
}
end += 1;
if (isTilde) {
if (input.charCodeAt(end) !== CC_EQUAL) {
return end;
}
end += 1;
}
end = walkCssTokens.eatWhitespaceAndComments(input, end)[0];
const value = walkCssTokens.eatIdentSequenceOrString(input, end);
if (!value) {
return end;
}
const classNameStart = value[2] ? value[0] : value[0] + 1;
const classNameEnd = value[2] ? value[1] : value[1] - 1;
const className = unescapeIdentifier(
input.slice(classNameStart, classNameEnd)
);
const dep = new CssIcssExportDependency(
className,
getReexport(className),
[classNameStart, classNameEnd],
true,
CssIcssExportDependency.EXPORT_MODE.NONE
);
const { line: sl, column: sc } = locConverter.get(classNameStart);
const { line: el, column: ec } = locConverter.get(classNameEnd);
dep.setLoc(sl, sc, el, ec);
module.addDependency(dep);
return value[2] ? classNameEnd : classNameEnd + 1;
};
2024-11-07 00:11:54 +08:00
walkCssTokens(source, 0, {
2024-10-16 22:57:45 +08:00
comment,
2024-10-09 14:21:00 +08:00
leftCurlyBracket: (input, start, end) => {
switch (scope) {
case CSS_MODE_TOP_LEVEL: {
allowImportAtRule = false;
scope = CSS_MODE_IN_BLOCK;
2024-10-16 00:04:49 +08:00
if (isModules) {
blockNestingLevel = 1;
isNextRulePrelude = isNextNestedSyntax(input, end);
}
2024-10-09 14:21:00 +08:00
break;
}
case CSS_MODE_IN_BLOCK: {
2024-10-16 00:04:49 +08:00
if (isModules) {
blockNestingLevel++;
isNextRulePrelude = isNextNestedSyntax(input, end);
}
2024-10-09 14:21:00 +08:00
break;
}
}
return end;
},
rightCurlyBracket: (input, start, end) => {
switch (scope) {
case CSS_MODE_IN_BLOCK: {
if (--blockNestingLevel === 0) {
scope = CSS_MODE_TOP_LEVEL;
if (isModules) {
2024-10-16 00:04:49 +08:00
isNextRulePrelude = true;
2024-10-09 14:21:00 +08:00
modeData = undefined;
2025-11-05 22:08:26 +08:00
lastLocalIdentifiers = [];
2024-10-09 14:21:00 +08:00
}
2024-10-16 00:04:49 +08:00
} else if (isModules) {
2024-10-09 14:21:00 +08:00
isNextRulePrelude = isNextNestedSyntax(input, end);
}
break;
}
}
return end;
},
2023-05-02 08:24:36 +08:00
url: (input, start, end, contentStart, contentEnd) => {
if (!this.options.url) {
return end;
}
2025-11-12 14:03:39 +08:00
return processOldURLFunction(
input,
start,
end,
contentStart,
contentEnd
2024-07-31 04:09:42 +08:00
);
2021-12-01 20:27:00 +08:00
},
atKeyword: (input, start, end) => {
2023-04-06 04:06:29 +08:00
const name = input.slice(start, end).toLowerCase();
2024-10-16 03:32:17 +08:00
switch (name) {
case "@namespace": {
2023-05-04 19:50:11 +08:00
this._emitWarning(
state,
2024-10-16 03:32:17 +08:00
"'@namespace' is not supported in bundled CSS",
2023-05-04 19:50:11 +08:00
locConverter,
start,
end
);
2024-10-16 03:32:17 +08:00
return eatUntilSemi(input, start);
2023-05-04 19:50:11 +08:00
}
2024-10-16 03:32:17 +08:00
case "@import": {
if (!this.options.import) {
2025-12-12 17:04:58 +08:00
return eatUntilSemi(input, end);
}
2024-10-16 03:32:17 +08:00
if (!allowImportAtRule) {
2023-05-02 17:15:52 +08:00
this._emitWarning(
state,
2024-10-16 03:32:17 +08:00
"Any '@import' rules must precede all other rules",
2023-05-02 17:15:52 +08:00
locConverter,
2023-05-20 00:05:14 +08:00
start,
2023-05-19 22:37:38 +08:00
end
2023-04-26 04:31:35 +08:00
);
2023-05-19 22:37:38 +08:00
return end;
}
2024-10-16 03:32:17 +08:00
2025-11-12 14:03:39 +08:00
return processAtImport(input, start, end);
2021-12-01 20:27:00 +08:00
}
2024-10-16 03:32:17 +08:00
default: {
if (isModules) {
2024-11-08 00:32:00 +08:00
if (name === "@value") {
2025-11-12 14:03:39 +08:00
return processAtValue(input, start, end);
2024-11-08 00:32:00 +08:00
} else if (
this.options.animation &&
2024-11-08 00:32:00 +08:00
OPTIONALLY_VENDOR_PREFIXED_KEYFRAMES_AT_RULE.test(name) &&
isLocalMode()
) {
return processLocalAtRule(input, end, {
string: true,
identifier: true
});
} else if (
this.options.customIdents &&
name === "@counter-style" &&
isLocalMode()
) {
return processLocalAtRule(input, end, {
identifier: true
});
} else if (
this.options.container &&
name === "@container" &&
isLocalMode()
) {
return processLocalAtRule(input, end, {
identifier: /^(none|and|or|not)$/
});
2024-11-08 00:32:00 +08:00
} else if (name === "@scope") {
2024-10-16 03:32:17 +08:00
isNextRulePrelude = true;
return end;
}
2023-05-20 00:05:14 +08:00
2024-10-16 03:32:17 +08:00
isNextRulePrelude = false;
}
2021-12-01 20:27:00 +08:00
}
2024-10-16 03:32:17 +08:00
}
return end;
},
semicolon: (input, start, end) => {
2024-10-16 11:04:30 +08:00
if (isModules && scope === CSS_MODE_IN_BLOCK) {
isNextRulePrelude = isNextNestedSyntax(input, end);
2021-12-01 20:27:00 +08:00
}
2021-11-30 19:55:51 +08:00
return end;
2021-12-14 23:02:26 +08:00
},
identifier: (input, start, end) => {
2024-11-07 00:11:54 +08:00
if (isModules) {
const identifier = input.slice(start, end);
if (icssDefinitions.has(identifier)) {
return processICSSSymbol(identifier, start, end);
}
if (
this.options.dashedIdents &&
isLocalMode() &&
isDashedIdentifier(identifier)
) {
return processDashedIdent(input, start, end);
2024-11-08 00:32:00 +08:00
}
2024-11-07 00:11:54 +08:00
2024-11-08 00:32:00 +08:00
switch (scope) {
case CSS_MODE_IN_BLOCK: {
2025-12-12 17:04:58 +08:00
if (isModules && !isNextRulePrelude) {
2024-11-07 00:11:54 +08:00
// Handle only top level values and not inside functions
2025-11-12 14:03:39 +08:00
return processLocalDeclaration(input, start, end);
2024-11-07 00:11:54 +08:00
}
break;
2021-12-14 23:02:26 +08:00
}
2023-05-05 03:24:13 +08:00
}
2021-12-14 23:02:26 +08:00
}
2024-11-07 00:11:54 +08:00
2021-12-14 23:02:26 +08:00
return end;
},
2024-10-09 17:09:36 +08:00
delim: (input, start, end) => {
if (isNextRulePrelude && isLocalMode()) {
2025-12-12 17:04:58 +08:00
return processClassSelector(input, start, end);
2021-12-15 15:34:31 +08:00
}
2023-05-05 06:52:08 +08:00
2021-12-15 15:34:31 +08:00
return end;
},
2024-10-09 14:21:00 +08:00
hash: (input, start, end, isID) => {
2024-10-09 17:09:36 +08:00
if (isNextRulePrelude && isLocalMode() && isID) {
2025-12-12 17:04:58 +08:00
return processIdSelector(input, start, end);
2023-05-05 02:26:32 +08:00
}
2024-10-09 17:09:36 +08:00
return end;
},
colon: (input, start, end) => {
if (isModules) {
2024-10-16 03:32:17 +08:00
const ident = walkCssTokens.skipCommentsAndEatIdentSequence(
input,
end
);
if (!ident) return end;
2024-10-09 18:20:41 +08:00
const name = input.slice(ident[0], ident[1]).toLowerCase();
2024-10-09 17:09:36 +08:00
switch (scope) {
case CSS_MODE_TOP_LEVEL: {
2024-11-07 00:11:54 +08:00
if (name === "import") {
2025-11-12 14:03:39 +08:00
const pos = processImportOrExport(0, input, ident[1]);
2024-11-07 00:11:54 +08:00
const dep = new ConstDependency("", [start, pos]);
module.addPresentationalDependency(dep);
return pos;
} else if (name === "export") {
2025-11-12 14:03:39 +08:00
const pos = processImportOrExport(1, input, ident[1]);
2024-10-09 17:09:36 +08:00
const dep = new ConstDependency("", [start, pos]);
module.addPresentationalDependency(dep);
return pos;
}
}
// falls through
default: {
2024-10-09 18:20:41 +08:00
if (isNextRulePrelude) {
const isFn = input.charCodeAt(ident[1]) === CC_LEFT_PARENTHESIS;
if (isFn && name === "local") {
2025-11-12 14:03:39 +08:00
// Eat extra whitespace
2025-12-12 17:04:58 +08:00
const end = walkCssTokens.eatWhitespaceAndComments(
input,
ident[1] + 1
)[0];
modeData = LOCAL_MODE;
2024-10-09 17:09:36 +08:00
const dep = new ConstDependency("", [start, end]);
module.addPresentationalDependency(dep);
2025-12-12 17:04:58 +08:00
balanced.push([":local", start, end, true]);
2024-10-09 17:09:36 +08:00
return end;
2024-10-09 18:20:41 +08:00
} else if (name === "local") {
2025-12-12 17:04:58 +08:00
modeData = LOCAL_MODE;
const found = walkCssTokens.eatWhitespaceAndComments(
input,
ident[1]
);
2025-12-12 17:04:58 +08:00
if (!found[1]) {
this._emitWarning(
state,
`Missing whitespace after ':local' in '${input.slice(
start,
2024-10-16 03:32:17 +08:00
eatUntilLeftCurly(input, end) + 1
)}'`,
locConverter,
start,
end
);
}
2025-12-12 17:04:58 +08:00
end = walkCssTokens.eatWhitespace(input, ident[1]);
2024-10-09 18:20:41 +08:00
const dep = new ConstDependency("", [start, end]);
module.addPresentationalDependency(dep);
return end;
} else if (isFn && name === "global") {
2025-11-12 14:03:39 +08:00
// Eat extra whitespace
2025-12-12 17:04:58 +08:00
const end = walkCssTokens.eatWhitespaceAndComments(
input,
ident[1] + 1
)[0];
modeData = GLOBAL_MODE;
2024-10-09 18:20:41 +08:00
const dep = new ConstDependency("", [start, end]);
module.addPresentationalDependency(dep);
2025-12-12 17:04:58 +08:00
balanced.push([":global", start, end, true]);
2024-10-09 18:20:41 +08:00
return end;
} else if (name === "global") {
2025-12-12 17:04:58 +08:00
modeData = GLOBAL_MODE;
// Eat extra whitespace
2025-12-12 17:04:58 +08:00
const found = walkCssTokens.eatWhitespaceAndComments(
input,
ident[1]
);
2025-12-12 17:04:58 +08:00
if (!found[1]) {
this._emitWarning(
state,
`Missing whitespace after ':global' in '${input.slice(
start,
2024-10-16 03:32:17 +08:00
eatUntilLeftCurly(input, end) + 1
)}'`,
locConverter,
start,
end
);
}
2025-12-12 17:04:58 +08:00
end = walkCssTokens.eatWhitespace(input, ident[1]);
2024-10-09 17:09:36 +08:00
const dep = new ConstDependency("", [start, end]);
module.addPresentationalDependency(dep);
return end;
}
}
}
}
}
2024-10-17 23:11:14 +08:00
lastTokenEndForComments = end;
2023-05-05 02:26:32 +08:00
return end;
},
2023-04-25 09:17:51 +08:00
function: (input, start, end) => {
2024-10-16 03:32:17 +08:00
const name = input
.slice(start, end - 1)
.replace(/\\/g, "")
.toLowerCase();
2023-04-25 09:17:51 +08:00
2024-10-09 18:20:41 +08:00
balanced.push([name, start, end]);
2024-10-16 03:32:17 +08:00
switch (name) {
case "src":
case "url": {
if (!this.options.url) {
return end;
}
2025-11-12 14:03:39 +08:00
return processURLFunction(input, end, name);
2024-10-16 03:32:17 +08:00
}
default: {
if (this.options.url && IMAGE_SET_FUNCTION.test(name)) {
2025-11-12 14:03:39 +08:00
return processImageSetFunction(input, start, end);
2024-10-16 03:32:17 +08:00
}
2025-12-12 17:04:58 +08:00
if (isModules) {
if (
this.options.function &&
isLocalMode() &&
isDashedIdentifier(name)
) {
return processDashedIdent(input, start, end);
}
2025-12-12 17:04:58 +08:00
const type =
name === "local" ? 1 : name === "global" ? 2 : undefined;
if (type && !isNextRulePrelude) {
return processLocalOrGlobalFunction(input, type, start, end);
}
}
2023-04-25 09:17:51 +08:00
}
}
2023-05-05 04:01:16 +08:00
2023-04-25 09:17:51 +08:00
return end;
},
2025-12-12 17:04:58 +08:00
leftSquareBracket: (input, start, end) => {
if (isNextRulePrelude && isLocalMode()) {
return processAttributeSelector(input, start, end);
}
return end;
},
2021-12-14 23:02:26 +08:00
leftParenthesis: (input, start, end) => {
2023-04-26 08:45:15 +08:00
balanced.push(["(", start, end]);
2021-12-14 23:02:26 +08:00
return end;
},
rightParenthesis: (input, start, end) => {
2023-05-05 00:47:38 +08:00
const popped = balanced.pop();
2023-04-14 06:52:50 +08:00
2025-12-12 17:04:58 +08:00
if (isModules && popped) {
const isLocal = popped[0] === ":local";
const isGlobal = popped[0] === ":global";
if (isLocal || isGlobal) {
modeData = balanced[balanced.length - 1]
? balanced[balanced.length - 1][0] === ":local"
? LOCAL_MODE
: balanced[balanced.length - 1][0] === ":global"
? GLOBAL_MODE
: undefined
: undefined;
if (popped[3] && isLocal) {
while (walkCssTokens.isWhiteSpace(input.charCodeAt(start - 1))) {
start -= 1;
}
}
const dep = new ConstDependency("", [start, end]);
module.addPresentationalDependency(dep);
} else if (isNextRulePrelude) {
modeData = undefined;
}
}
2023-04-14 04:25:46 +08:00
2021-12-14 23:02:26 +08:00
return end;
},
comma: (input, start, end) => {
if (isModules) {
const popped = balanced.pop();
if (!popped) {
// Reset stack for `:global .class :local .class-other` selector after
modeData = undefined;
}
2021-12-14 23:02:26 +08:00
}
2024-10-17 00:24:48 +08:00
lastTokenEndForComments = start;
2021-12-14 23:02:26 +08:00
return end;
2021-11-30 19:55:51 +08:00
}
});
2024-10-01 03:05:27 +08:00
/** @type {BuildInfo} */
(module.buildInfo).strict = true;
2025-11-06 04:13:12 +08:00
const buildMeta = /** @type {BuildMeta} */ (state.module.buildMeta);
buildMeta.exportsType = this.options.namedExports ? "namespace" : "default";
buildMeta.defaultObject = this.options.namedExports
? false
: "redirect-warn";
buildMeta.exportType = this.options.exportType;
if (!buildMeta.exportType) {
// Inherit exportType from parent module to ensure consistency.
// When a CSS file is imported with syntax like `import "./basic.css" with { type: "css" }`,
// the parent module's exportType is set to "css-style-sheet".
// Child modules imported via @import should inherit this exportType
// instead of using the default "link", ensuring that the entire
// import chain uses the same export format.
const parent = state.compilation.moduleGraph.getIssuer(module);
if (parent instanceof CssModule) {
buildMeta.exportType = /** @type {BuildMeta} */ (
parent.buildMeta
).exportType;
}
}
if (!buildMeta.exportType) {
buildMeta.exportType = "link";
}
2025-11-06 04:13:12 +08:00
// TODO this.namedExports?
if (
buildMeta.exportType === "text" ||
buildMeta.exportType === "css-style-sheet"
) {
2025-11-06 04:13:12 +08:00
module.addDependency(new StaticExportsDependency(["default"], true));
} else {
module.addDependency(new StaticExportsDependency([], true));
}
2021-11-30 19:55:51 +08:00
return state;
}
2024-10-16 22:42:26 +08:00
/**
* @param {Range} range range
* @returns {Comment[]} comments in the range
*/
getComments(range) {
if (!this.comments) return [];
const [rangeStart, rangeEnd] = range;
/**
* @param {Comment} comment comment
* @param {number} needle needle
* @returns {number} compared
*/
const compare = (comment, needle) =>
/** @type {Range} */ (comment.range)[0] - needle;
const comments = /** @type {Comment[]} */ (this.comments);
let idx = binarySearchBounds.ge(comments, rangeStart, compare);
/** @type {Comment[]} */
const commentsInRange = [];
while (
comments[idx] &&
/** @type {Range} */ (comments[idx].range)[1] <= rangeEnd
) {
commentsInRange.push(comments[idx]);
idx++;
}
return commentsInRange;
}
/**
* @param {Range} range range of the comment
2025-04-04 21:38:51 +08:00
* @returns {{ options: Record<string, EXPECTED_ANY> | null, errors: (Error & { comment: Comment })[] | null }} result
2024-10-16 22:42:26 +08:00
*/
parseCommentOptions(range) {
const comments = this.getComments(range);
if (comments.length === 0) {
return EMPTY_COMMENT_OPTIONS;
}
2025-12-16 20:58:39 +08:00
/** @type {Record<string, EXPECTED_ANY>} */
2024-10-16 22:42:26 +08:00
const options = {};
/** @type {(Error & { comment: Comment })[]} */
const errors = [];
for (const comment of comments) {
const { value } = comment;
if (value && webpackCommentRegExp.test(value)) {
// try compile only if webpack options comment is present
try {
for (let [key, val] of Object.entries(
vm.runInContext(
`(function(){return {${value}};})()`,
this.magicCommentContext
)
)) {
if (typeof val === "object" && val !== null) {
val =
val.constructor.name === "RegExp"
? new RegExp(val)
: JSON.parse(JSON.stringify(val));
}
options[key] = val;
}
} catch (err) {
const newErr = new Error(String(/** @type {Error} */ (err).message));
newErr.stack = String(/** @type {Error} */ (err).stack);
Object.assign(newErr, { comment });
2025-09-10 19:38:19 +08:00
errors.push(/** @type {(Error & { comment: Comment })} */ (newErr));
2024-10-16 22:42:26 +08:00
}
}
}
return { options, errors };
}
2021-11-30 19:55:51 +08:00
}
module.exports = CssParser;
module.exports.escapeIdentifier = escapeIdentifier;
module.exports.unescapeIdentifier = unescapeIdentifier;