import postcssValueParser from 'postcss-value-parser'; import { basicKeywords, fontFamilyKeywords, fontShorthandKeywords, fontSizeKeywords, } from '../reference/keywords.mjs'; import { assert } from './validateTypes.mjs'; import isNumbery from './isNumbery.mjs'; import isStandardSyntaxValue from './isStandardSyntaxValue.mjs'; import isValidFontSize from './isValidFontSize.mjs'; import isVariable from './isVariable.mjs'; const nodeTypesToCheck = new Set(['word', 'string', 'space', 'div']); /** @typedef {import('postcss-value-parser').Node} Node */ /** * @param {Node} firstNode * @param {Node} secondNode * @param {string | null} charactersBetween * @returns {Node} */ function joinValueNodes(firstNode, secondNode, charactersBetween) { firstNode.value = firstNode.value + charactersBetween + secondNode.value; return firstNode; } /** * @param {Node} valueNode * @returns {valueNode is postcssValueParser.DivNode & { value: ',' }} */ const isCommaDiv = (valueNode) => valueNode.type === 'div' && valueNode.value === ','; /** * Get the font-families within a `font` shorthand property value. * * @param {string} value * @returns {Node[]} Collection font-family nodes */ export default function findFontFamily(value) { /** @type {Node[]} */ const fontFamilies = []; const valueNodes = postcssValueParser(value); const { nodes: children } = valueNodes; // Handle `inherit`, `initial` and etc if (children.length === 1 && children[0] && basicKeywords.has(children[0].value.toLowerCase())) { return [children[0]]; } let needMergeNodesByValue = false; /** @type {string | null} */ let mergeCharacters = null; valueNodes.walk((valueNode, index, nodes) => { if (valueNode.type === 'function') { return false; } if (!nodeTypesToCheck.has(valueNode.type)) { return; } const valueLowerCase = valueNode.value.toLowerCase(); // Ignore non standard syntax if (!isStandardSyntaxValue(valueLowerCase)) { return; } // Ignore variables if (isVariable(valueLowerCase)) { return; } const isFontFamilyKeyword = fontFamilyKeywords.has(valueLowerCase); // Ignore keywords for other font parts if (!isFontFamilyKeyword && fontShorthandKeywords.has(valueLowerCase)) { return; } // Ignore font-sizes // NOTE: `math` is a keyword for both `font-family` and `font-size`. if (!isFontFamilyKeyword && isValidFontSize(valueNode.value)) { return; } const nextNode = nodes[index + 1]; const prevNode = nodes[index - 1]; const prevPrevNode = nodes[index - 2]; const allPrevNodes = nodes.slice(0, index); // When the value is a keyword for both `font-family` and `font-size` (e.g. `math`), // if its next node is a comma, or if it is already the last node, or if there is any comma before it, // then treat it as a `font-family` keyword, otherwise treat it as a `font-size` keyword. if ( isFontFamilyKeyword && fontSizeKeywords.has(valueLowerCase) && !(!nextNode || isCommaDiv(nextNode) || allPrevNodes.find(isCommaDiv)) ) return; // Ignore anything come after a /, because it's a line-height if (prevNode && prevNode.value === '/' && prevPrevNode && isValidFontSize(prevPrevNode.value)) { return; } // Ignore number values if (isNumbery(valueLowerCase)) { return; } // Detect when a space or comma is dividing a list of font-families, and save the joining character. if ( (valueNode.type === 'space' || (valueNode.type === 'div' && valueNode.value !== ',')) && fontFamilies.length !== 0 ) { needMergeNodesByValue = true; mergeCharacters = valueNode.value; return; } if (valueNode.type === 'space' || valueNode.type === 'div') { return; } const fontFamily = valueNode; if (needMergeNodesByValue) { const lastFontFamily = fontFamilies[fontFamilies.length - 1]; assert(lastFontFamily); joinValueNodes(lastFontFamily, fontFamily, mergeCharacters); needMergeNodesByValue = false; mergeCharacters = null; } else { fontFamilies.push(fontFamily); } }); return fontFamilies; }