@thejaredwilcurt/csslop 0.0.49 → 0.0.50

package/src/value/minify.js

@@ -2,1634 +2,105 @@
  * @file Minifies CSS declaration values by applying color conversion, math simplification, shorthand compression, and other property-specific optimizations.
  */
 
-import { isUnicodeCharset } from '../context.js';
-import {
-  findMatchingParenthesis,
-  skipParenthesizedGroup,
-  skipQuotedString,
-  splitTopLevelComponents,
-  startsUrlToken
-} from '../parser/source-search.js';
-import { tokenizeCssValue } from '../parser/tokenizer.js';
-import { resolveUnicodeEscape } from '../utilities.js';
-
-import { evaluateColorMix } from './color-mix.js';
-import {
-  convertLabToHex,
-  convertOklabToHex,
-  convertOklchToHex,
-  hslToRgbChannels,
-  hwbToRgbChannels,
-  parseHex,
-  rgbaToHex,
-  shortestColor
-} from './colors.js';
-import { minifyFontShorthand } from './font.js';
-import { minifyGradients } from './gradients.js';
-import { simplifyEquivalentLightDarkFunctions } from './light-dark.js';
-import {
-  normalizeMathFunctions,
-  simplifyStandaloneCalc
-} from './math.js';
-import { namedColors } from './named-colors.js';
-import {
-  formatShortestNumber,
-  parseNumericParts,
-  scaleByPowerOfTen,
-  shortenNumericText
-} from './numbers.js';
-import { isQuotesNoneEquivalent } from './quotes.js';
-import {
-  evaluateRelativeColor,
-  minifyRelativeColorSyntax
-} from './relative-colors.js';
-import {
-  collapseShorthandParts,
-  convertAbsoluteLengthToPx,
-  formatCompactNumber,
-  formatResolvedNumber,
-  hasSubstitutedParts,
-  normalizeScaleComponent,
-  parseAlphaString,
-  parseAngleToDegrees,
-  roundCompactNumber
-} from './shared.js';
-import { minifySvgDataUri } from './svg-data-uri.js';
-import {
-  elideRedundantSeparators,
-  shortenDimensionNumbers
-} from './tokens.js';
-import { minifyTransformValue } from './transforms.js';
-import { optimizeUnicodeRange } from './unicode-range.js';
-
-/**
- * Map of position-area two-keyword values to their single-keyword equivalents.
- * Per CSS spec, `center center` is redundant with `center`, etc.
- *
- * @type {{[key: string]: string}}
- */
-const POSITION_AREA_SHORTHANDS = {
-  'center center': 'center',
-  'top center': 'top',
-  'bottom center': 'bottom',
-  'center top': 'top',
-  'center bottom': 'bottom',
-  'left center': 'left',
-  'right center': 'right'
-};
-
-/**
- * Regex matching hex color tokens (#rgb, #rgba, #rrggbb, #rrggbbaa) and CSS named
- * color keywords. Hex patterns are ordered longest-first to avoid partial matches.
- * Named colors are sorted longest-first so longer names like `darkslategray` are
- * matched before shorter substrings. A named color only counts as a color keyword
- * when it is a complete identifier, so hyphens on either side disqualify it (this
- * keeps identifiers such as the custom property name in `var(--grey)` intact).
- *
- * @type {RegExp}
- */
-const COLOR_TOKEN_PATTERN = new RegExp(
-  '#[0-9a-fA-F]{8}(?![0-9a-fA-F])|' +
-  '#[0-9a-fA-F]{6}(?![0-9a-fA-F])|' +
-  '#[0-9a-fA-F]{4}(?![0-9a-fA-F])|' +
-  '#[0-9a-fA-F]{3}(?![0-9a-fA-F])|' +
-  '(?<![\\w-])(?:' +
-  Object.keys(namedColors).sort((a, b) => {
-    return b.length - a.length;
-  }).join('|') +
-  ')(?![\\w-])',
-  'gi'
-);
-
-/**
- * Replaces every hex color and named color keyword in a CSS value segment with
- * the shortest equivalent representation, comparing full hex, shortened hex,
- * and any matching named color keyword.
- *
- * @param  {string}  segment                      A CSS value segment (outside strings and urls).
- * @param  {boolean} rewritesEqualLengthSpelling  Whether a spelling of the same length is worth switching to.
- * @return {string}                               The segment with all colors shortened to their minimal form.
- */
-function shortenColorValues (segment, rewritesEqualLengthSpelling = true) {
-  // Match "color-mix(" as a whole word, case-insensitive
-  const hasColorMix = /\bcolor-mix\(/i.test(segment);
-  return segment.replace(COLOR_TOKEN_PATTERN, (match) => {
-    let channels;
-    if (match.startsWith('#')) {
-      channels = parseHex(match);
-    } else {
-      if (hasColorMix) {
-        return match;
-      }
-      const rgb = namedColors[match.toLowerCase()];
-      if (rgb) {
-        // transparent has alpha=0, all other named colors have alpha=1
-        const alpha = match.toLowerCase() === 'transparent' ? 0 : 1;
-        channels = [rgb[0], rgb[1], rgb[2], alpha];
-      }
-    }
-    if (!channels) {
-      return match;
-    }
-    const shortest = shortestColor(channels[0], channels[1], channels[2], channels[3]);
-    if (!rewritesEqualLengthSpelling && shortest.length >= match.length) {
-      return match;
-    }
-    return shortest;
-  });
-}
-
-/**
- * @typedef  {object}  ValueSegment
- * @property {string}  text          The segment's slice of the value.
- * @property {boolean} isLiteral     Whether the segment is a quoted string or a url() token.
- */
-
-/**
- * Splits a CSS value into literal and syntax segments. A quoted string and a
- * `url()` token are literals: they hold data rather than CSS syntax, so no pass
- * may rewrite what is inside them. Everything between the literals is syntax.
- *
- * @param  {string} value  The full CSS value string.
- * @return {Array}         The value's segments, in order.
- */
-function splitValueSegments (value) {
-  const segments = [];
-  let index = 0;
-
-  while (index < value.length) {
-    if (value[index] === '"' || value[index] === '\'') {
-      const end = skipQuotedString(value, index);
-      segments.push({ text: value.slice(index, end), isLiteral: true });
-      index = end;
-      continue;
-    }
-
-    if (startsUrlToken(value, index)) {
-      // The `url(` token opens its parenthesized group at its fourth character
-      const end = skipParenthesizedGroup(value, index + 3);
-      segments.push({ text: value.slice(index, end), isLiteral: true });
-      index = end;
-      continue;
-    }
-
-    const start = index;
-    while (index < value.length && value[index] !== '"' && value[index] !== '\'' && !startsUrlToken(value, index)) {
-      index++;
-    }
-    segments.push({ text: value.slice(start, index), isLiteral: false });
-  }
-
-  return segments;
-}
-
-/**
- * Applies a replacer function only to segments of a CSS value that are outside quoted strings and url() functions, preserving those literal segments unchanged.
- *
- * @param  {string}                   value     The full CSS value string.
- * @param  {function(string): string} replacer  A function called with each non-string, non-url segment, returning the replacement string.
- * @return {string}                             The value with the replacer applied to all eligible segments.
- */
-function replaceOutsideStringsAndUrls (value, replacer) {
-  return splitValueSegments(value).map((segment) => {
-    if (segment.isLiteral) {
-      return segment.text;
-    }
-    return replacer(segment.text);
-  }).join('');
-}
-
-/**
- * Lowercases every hex color token in a CSS value, since uppercase hex digits
- * compress worse and are equivalent to their lowercase form.
- *
- * @param  {string} value  The CSS value string.
- * @return {string}        The value with all hex color tokens lowercased.
- */
-function lowercaseHexColors (value) {
-  return replaceOutsideStringsAndUrls(value, (segment) => {
-    // Match hex color tokens of 3 to 8 hex digits
-    return segment.replace(/#([0-9a-fA-F]{3,8})\b/gi, (hexColor) => {
-      return hexColor.toLowerCase();
-    });
-  });
-}
-
-/**
- * Restores the whitespace that a math function requires before a `+` or a `-`
- * operator. Both operators have to be surrounded by whitespace to be read as
- * operators rather than as the sign of the term that follows, and the
- * whitespace before one that trails a closing parenthesis is removed together
- * with the rest of the parenthesis padding.
- *
- * @param  {string} value  The CSS value string with parenthesis padding removed.
- * @return {string}        The value with the operator separator restored.
- */
-function restoreSpaceBeforeMathOperators (value) {
-  return replaceOutsideStringsAndUrls(value, (segment) => {
-    // Match a closing parenthesis immediately followed by a `+` or `-` operator
-    return segment.replace(/\)(?=[+-])/g, ') ');
-  });
-}
-
-/**
- * Escapes the characters an unquoted url() token cannot hold, so the path can
- * drop its quotes. A backslash already escaping a character is left alone, so
- * a path that arrived escaped is never escaped a second time.
- *
- * @param  {string} path  The url path, without surrounding quotes.
- * @return {string}       The path with every bare space and parenthesis escaped.
- */
-function escapeUrlPathCharacters (path) {
-  // Match each space and parenthesis that no escaping backslash precedes
-  return path.replace(/(?<!\\)([ ()])/g, '\\$1');
-}
-
-/**
- * Chooses the shortest valid representation for the path inside a `url(...)`
- * token, weighing an unquoted form — its spaces and parentheses escaped —
- * against a quoted form. Quotation marks can only ever appear in the quoted
- * form, so a path holding one always keeps its wrapper.
- *
- * @param  {string} path  The resolved url path, without surrounding quotes.
- * @return {string}       The shortest valid url() content string.
- */
-function formatUrlPath (path) {
-  // Escape any embedded double quotes so the double-quoted wrapper stays valid
-  const quotedForm = '"' + path.replace(/"/g, '\\"') + '"';
-  // Match a quotation mark, which an unquoted url() token cannot hold
-  if (/["']/.test(path)) {
-    return quotedForm;
-  }
-  const unquotedForm = escapeUrlPathCharacters(path);
-  // Each escaped character costs one backslash, so dropping the two quotation
-  // marks pays off whenever at most one character needs escaping
-  if (unquotedForm.length < quotedForm.length) {
-    return unquotedForm;
-  }
-  return quotedForm;
-}
-
-/**
- * Produces the shortest valid contents for a single `url(...)` token from the
- * raw text between its parentheses, stripping a leading current-directory
- * indicator and normalizing quoting.
- *
- * @param  {string} rawContent  The trimmed text found between the url parentheses.
- * @return {string}             The minified url() content.
- */
-function minifyUrlContent (rawContent) {
-  const wasQuoted = rawContent.startsWith('"') || rawContent.startsWith('\'');
-  let path = rawContent;
-  if (wasQuoted) {
-    const quote = rawContent[0];
-    if (rawContent.length >= 2 && rawContent.endsWith(quote)) {
-      path = rawContent.slice(1, -1);
-    }
-  }
-
-  const minifiedSvgDataUri = minifySvgDataUri(path);
-  if (minifiedSvgDataUri) {
-    return minifiedSvgDataUri;
-  }
-
-  // Remove a leading current-directory indicator (`./`); browsers resolve it implicitly
-  path = path.replace(/^\.\//, '');
-
-  return formatUrlPath(path);
-}
-
-/**
- * Builds a marker that cannot appear in a parsed CSS value. URL functions are
- * temporarily replaced with these markers while generic string operations run.
- *
- * @param  {number} index  The URL token index.
- * @return {string}        The marker representing that URL token.
- */
-function createUrlTokenMarker (index) {
-  return '\u0000csslop-url-' + index + '\u0000';
-}
-
-/**
- * Replaces URL tokens with stable markers so generic value normalization does
- * not alter data carried inside a URL.
- *
- * @param  {string} value  The CSS value to protect.
- * @return {object}        The protected value and the original URL tokens.
- */
-function protectUrlTokens (value) {
-  const urlTokens = [];
-  let protectedValue = '';
-  for (const segment of splitValueSegments(value)) {
-    const isUrlToken = segment.isLiteral && startsUrlToken(segment.text, 0);
-    if (isUrlToken) {
-      protectedValue += createUrlTokenMarker(urlTokens.length);
-      urlTokens.push(segment.text);
-    } else {
-      protectedValue += segment.text;
-    }
-  }
-  return { value: protectedValue, urlTokens };
-}
-
-/**
- * Restores the URL tokens removed by `protectUrlTokens`.
- *
- * @param  {string} value      The value containing URL markers.
- * @param  {Array}  urlTokens  The original URL token text.
- * @return {string}            The value with URL tokens restored.
- */
-function restoreUrlTokens (value, urlTokens) {
-  let restoredValue = value;
-  for (let index = 0; index < urlTokens.length; index++) {
-    const marker = createUrlTokenMarker(index);
-    restoredValue = restoredValue.split(marker).join(urlTokens[index]);
-  }
-  return restoredValue;
-}
-
-/**
- * Removes whitespace after protected URL tokens. A CSS URL token closes itself
- * at `)`, so the following component remains distinguishable without a space.
- *
- * @param  {string} value      The protected CSS value.
- * @param  {Array}  urlTokens  The original URL token text.
- * @return {string}            The protected value without trailing URL spacing.
- */
-function removeWhitespaceAfterUrlTokens (value, urlTokens) {
-  let compactValue = value;
-  for (let index = 0; index < urlTokens.length; index++) {
-    const marker = createUrlTokenMarker(index);
-    const markerIndex = compactValue.indexOf(marker);
-    if (markerIndex === -1) {
-      continue;
-    }
-    const contentStart = markerIndex + marker.length;
-    let nextContentIndex = contentStart;
-    while (' \t\n\r\f'.includes(compactValue[nextContentIndex])) {
-      nextContentIndex++;
-    }
-    compactValue = compactValue.slice(0, contentStart) + compactValue.slice(nextContentIndex);
-  }
-  return compactValue;
-}
-
-/**
- * Removes an explicit default background position directly after a protected
- * URL marker, where the ordinary close-parenthesis optimization cannot see it.
- *
- * @param  {string} value      The protected background value.
- * @param  {Array}  urlTokens  The original URL token text.
- * @return {string}            The value with redundant URL positions removed.
- */
-function removeDefaultBackgroundPositionsAfterUrlTokens (value, urlTokens) {
-  let normalizedValue = value;
-  for (let index = 0; index < urlTokens.length; index++) {
-    const marker = createUrlTokenMarker(index);
-    // Match a URL marker followed by the default 0 0 background-position pair.
-    const defaultPositionPattern = new RegExp(
-      marker + '\\s*0(?:%|px)?\\s+0(?:%|px)?(?=\\s|$)',
-      'g'
-    );
-    normalizedValue = normalizedValue.replace(defaultPositionPattern, marker);
-  }
-  return normalizedValue;
-}
-
-/**
- * Rewrites every `url(...)` token in a CSS value to its shortest valid form,
- * skipping any quoted strings so an embedded `url(` inside a string is ignored.
- *
- * @param  {string} value  The CSS value string potentially containing url() tokens.
- * @return {string}        The value with all url() tokens minified.
- */
-function minifyUrls (value) {
-  let result = '';
-  let index = 0;
-
-  const consumeQuoted = (start) => {
-    const quote = value[start];
-    let end = start + 1;
-    while (end < value.length) {
-      if (value[end] === '\\') {
-        end += 2;
-        continue;
-      }
-      if (value[end] === quote) {
-        end++;
-        break;
-      }
-      end++;
-    }
-    return end;
-  };
-
-  const startsUrl = (start) => {
-    return value.slice(start, start + 4).toLowerCase() === 'url(';
-  };
-
-  while (index < value.length) {
-    if (value[index] === '"' || value[index] === '\'') {
-      const end = consumeQuoted(index);
-      result += value.slice(index, end);
-      index = end;
-      continue;
-    }
-
-    if (startsUrl(index)) {
-      const closingParenIndex = findMatchingParenthesis(value, index + 3);
-      if (closingParenIndex === -1) {
-        result += value.slice(index);
-        break;
-      }
-      const inner = value.slice(index + 4, closingParenIndex).trim();
-      result += 'url(' + minifyUrlContent(inner) + ')';
-      index = closingParenIndex + 1;
-      continue;
-    }
-
-    result += value[index];
-    index++;
-  }
-
-  return result;
-}
-
-/**
- * Normalizes whitespace, quotes, and unicode escapes in a CSS value string.
- *
- * @param  {string} val       The raw CSS value string to normalize.
- * @param  {string} property  The CSS property name, used for context-aware quote handling.
- * @return {string}           The value with whitespace collapsed, quotes normalized, and unicode escapes resolved.
- */
-function normalizeWhitespaceAndQuotes (val, property) {
-  const protectedUrls = protectUrlTokens(val);
-  val = protectedUrls.value;
-
-  // Unescape unicode (skip control characters — they must stay escaped in CSS strings).
-  // Only resolve escapes when the charset is unicode-compatible (UTF-8/UTF-16 or default).
-  if (isUnicodeCharset()) {
-    val = val.replace(/\\([0-9a-fA-F]{1,6})\s?/g, (match, hex) => {
-      return resolveUnicodeEscape(hex) ?? match;
-    });
-  }
-  // Normalize single-quoted strings to double-quoted
-  val = val.replace(/'((?:[^'\\]|\\.)*?)'/g, '"$1"');
-
-  // Remove space between string literals
-  val = val.replace(/("(?:[^"\\]|\\.)*")\s+(?=")/g, '$1');
-
-  // Whitespace minification
-  val = val.replace(/\s*!\s*important/i, '!important');
-  // val = val.replace(/\s*([+*/=])\s*/g, '$1');
-  // Strip whitespace around commas
-  val = val.replace(/\s*([,])\s*/g, '$1');
-  // Match quoted strings (to skip them) or parentheses with surrounding whitespace (to strip whitespace)
-  val = val.replace(/("[^"]*"|'[^']*')|\s*([()])\s*/g, (match, str, paren) => {
-    if (str) {
-      return str;
-    }
-    return paren;
-  });
-
-  // Strip quotes from simple strings (like "Custom", "image.png"), but not for content where quoted strings are semantically distinct
-  if (property !== 'content' && property !== 'font' && property !== 'font-feature-settings' && property !== 'font-variation-settings') {
-    // Match a boundary (start, whitespace, comma, open-paren), then a quoted simple value (alphanumeric, dots, slashes, hyphens), then a boundary lookahead
-    val = val.replace(/(^|\s|,|\()("|')([a-zA-Z0-9_./-]+)\2(?=\s|,|$|\)|!)/g, (match, before, quote, inner) => {
-      // Keep quotes around CSS generic font-family keywords — unquoted they mean something different
-      if (property === 'font-family' && /^(?:serif|sans-serif|monospace|cursive|fantasy|system-ui|math|emoji|fangsong|ui-serif|ui-sans-serif|ui-monospace|ui-rounded)$/i.test(inner)) {
-        return before + '"' + inner + '"';
-      }
-      return before + inner;
-    });
-  }
-
-  val = removeWhitespaceAfterUrlTokens(val, protectedUrls.urlTokens);
-  return restoreUrlTokens(val, protectedUrls.urlTokens);
-}
-
-/**
- * The OKLCH chroma value that `100%` resolves to, per CSS Color Level 4.
- *
- * @type {number}
- */
-const OKLCH_CHROMA_PERCENT_REFERENCE = 0.4;
-
-/**
- * Regex matching an `oklch()` function with three space-separated components
- * and an optional slash-delimited alpha. Lightness and chroma accept numbers
- * or percentages, hue accepts a number with an optional CSS angle unit, and
- * every component accepts the `none` keyword.
- *
- * @type {RegExp}
- */
-const OKLCH_FUNCTION_PATTERN = new RegExp(
-  '\\boklch\\(\\s*' +
-  '(none|-?(?:\\d+|\\d*\\.\\d+)%?)\\s+' +
-  '(none|-?(?:\\d+|\\d*\\.\\d+)%?)\\s+' +
-  '(none|-?(?:\\d+|\\d*\\.\\d+)(?:deg|grad|rad|turn)?)' +
-  '(?:\\s*/\\s*(none|-?(?:\\d+|\\d*\\.\\d+)%?))?' +
-  '\\s*\\)',
-  'gi'
-);
-
-/**
- * Parses an OKLCH lightness or chroma component into its numeric value.
- * Missing components (`none`) resolve to zero, and percentages are scaled
- * against the reference value for that component.
- *
- * @param  {string}      token             The raw component token.
- * @param  {number}      percentReference  The value that `100%` represents for this component.
- * @return {number|null}                   The numeric component value, or null when unparsable.
- */
-function parseOklchComponent (token, percentReference) {
-  const normalized = token.trim().toLowerCase();
-  if (normalized === 'none') {
-    return 0;
-  }
-  const numeric = parseFloat(normalized);
-  if (!Number.isFinite(numeric)) {
-    return null;
-  }
-  if (normalized.endsWith('%')) {
-    return numeric / 100 * percentReference;
-  }
-  return numeric;
-}
-
-/**
- * Parses an OKLCH hue component into degrees, treating `none` as zero.
- *
- * @param  {string}      token  The raw hue token, optionally carrying an angle unit.
- * @return {number|null}        The hue in degrees, or null when unparsable.
- */
-function parseOklchHue (token) {
-  const normalized = token.trim().toLowerCase();
-  if (normalized === 'none') {
-    return 0;
-  }
-  return parseAngleToDegrees(normalized);
-}
-
-/**
- * Removes whitespace before a negative numeric channel in Lab-family colors.
- * A preceding numeric token already separates the sign from the prior channel.
- *
- * @param  {string} functionName  The name of the color function.
- * @param  {string} value         The minified function arguments.
- * @return {string}               The arguments with redundant channel spacing removed.
- */
-function compactNegativeColorChannelSpacing (functionName, value) {
-  const normalizedFunctionName = functionName.toLowerCase();
-  if (!['lab', 'lch', 'oklab', 'oklch'].includes(normalizedFunctionName)) {
-    return value;
-  }
-
-  let result = '';
-  let nestingDepth = 0;
-  for (let index = 0; index < value.length; index++) {
-    const character = value[index];
-    if (character === ' ' && nestingDepth === 0) {
-      const previousCharacter = result[result.length - 1];
-      const nextCharacter = value[index + 1];
-      const characterAfterSign = value[index + 2];
-      const characterAfterDecimal = value[index + 3];
-      const previousEndsNumber = (
-        isCssDigit(previousCharacter) ||
-        previousCharacter === '%'
-      );
-      const nextStartsNegativeNumber = (
-        nextCharacter === '-' &&
-        (
-          isCssDigit(characterAfterSign) ||
-          (
-            characterAfterSign === '.' &&
-            isCssDigit(characterAfterDecimal)
-          )
-        )
-      );
-      if (previousEndsNumber && nextStartsNegativeNumber) {
-        continue;
-      }
-    }
-    result += character;
-    if (character === '(') {
-      nestingDepth++;
-    } else if (character === ')') {
-      nestingDepth--;
-    }
-  }
-  return result;
-}
-
-/**
- * Checks whether a character is an ASCII decimal digit.
- *
- * @param  {string}  character  The character to inspect.
- * @return {boolean}            Whether the character is a digit.
- */
-function isCssDigit (character) {
-  return character >= '0' && character <= '9';
-}
-
-/**
- * Converts OKLCH lightness and chroma percentages when doing so is shorter,
- * including the separator each spelling needs before the hue.
- *
- * @param  {string} value  The normalized arguments of an `oklch()` function.
- * @return {string}        The arguments with shorter percentage spellings.
- */
-function minifyOklchPercentages (value) {
-  const slashIndex = value.indexOf('/');
-  const componentsText = slashIndex === -1 ? value : value.slice(0, slashIndex);
-  const alphaText = slashIndex === -1 ? '' : value.slice(slashIndex + 1);
-  const components = componentsText.trim().split(' ');
-  if (components.length !== 3) {
-    return value;
-  }
-
-  let [lightness, chroma, hue] = components;
-  if (lightness.endsWith('%')) {
-    lightness = formatCompactNumber(Number.parseFloat(lightness) / 100);
-  }
-  if (chroma.endsWith('%')) {
-    const convertedChroma = formatCompactNumber(
-      Number.parseFloat(chroma) / 100 * OKLCH_CHROMA_PERCENT_REFERENCE
-    );
-    const convertedWithHueSeparator = convertedChroma.length + 1;
-    if (chroma.length < convertedWithHueSeparator) {
-      return [lightness, chroma + hue].join(' ') + (slashIndex === -1 ? '' : '/' + alphaText);
-    }
-    chroma = convertedChroma;
-  }
-
-  return [lightness, chroma, hue].join(' ') + (slashIndex === -1 ? '' : '/' + alphaText);
-}
-
-/**
- * Converts `oklch()` colors that fall inside the sRGB gamut to their hex
- * equivalent when that is shorter. Out-of-gamut colors have no sRGB
- * representation, so they are left in their native color space.
- *
- * @param  {string} value  The CSS value string that may contain oklch() colors.
- * @return {string}        The value with in-gamut oklch() colors replaced by hex.
- */
-function convertOklchFunctionsToHex (value) {
-  return value.replace(OKLCH_FUNCTION_PATTERN, (match, lightnessToken, chromaToken, hueToken, alphaToken) => {
-    const lightness = parseOklchComponent(lightnessToken, 1);
-    const chroma = parseOklchComponent(chromaToken, OKLCH_CHROMA_PERCENT_REFERENCE);
-    const hue = parseOklchHue(hueToken);
-    if (lightness === null || chroma === null || hue === null) {
-      return match;
-    }
-    const alpha = alphaToken?.trim().toLowerCase() === 'none' ? 0 : parseAlphaString(alphaToken);
-    const hex = convertOklchToHex(lightness, chroma, hue, alpha);
-    if (!hex) {
-      return match; // out-of-gamut: keep native oklch form
-    }
-    if (hex.length < match.length) {
-      return hex;
-    }
-    return match;
-  });
-}
-
-/**
- * Converts CSS color functions (rgb, hsl, hwb, oklab, color-mix, etc.) to their
- * shortest hex equivalents and applies hex shortening.
- *
- * @param  {string} val  The CSS value string with potential color functions.
- * @return {string}      The value with color functions converted to hex where shorter.
- */
-function convertColorsToHex (val) {
-  // Evaluate color-mix() expressions (before space minification to avoid nested-paren issues)
-  if (/\bcolor-mix\(/i.test(val)) {
-    const result = evaluateColorMix(val);
-    if (result) {
-      val = result;
-    }
-  }
-
-  // Handle color(from ...) relative color syntax (identity case)
-  if (/\bcolor\(\s*from\b/i.test(val)) {
-    const result = evaluateRelativeColor(val);
-    if (result) {
-      val = result;
-    }
-  }
-
-  // Convert in-gamut lab() (CIE Lab, D50) to hex when it produces a shorter representation
-  val = val.replace(/\blab\(\s*(-?(?:\d+|\d*\.\d+)%?)\s+(-?(?:\d+|\d*\.\d+)%?)\s+(-?(?:\d+|\d*\.\d+)%?)(?:\s*\/\s*(-?(?:\d+|\d*\.\d+)%?))?\s*\)/gi, (match, lStr, aStr, bStr, alphaStr) => {
-    const alpha = parseAlphaString(alphaStr);
-    const l = parseFloat(lStr);
-    const aNumber = parseFloat(aStr);
-    const a = aStr.endsWith('%') ? aNumber * 1.25 : aNumber;
-    const bNumber = parseFloat(bStr);
-    const b = bStr.endsWith('%') ? bNumber * 1.25 : bNumber;
-    const hex = convertLabToHex(l, a, b, alpha);
-    if (!hex) {
-      return match; // out-of-gamut: keep native lab form
-    }
-    if (hex.length < match.length) {
-      return hex;
-    }
-    return match;
-  });
-
-  // Convert in-gamut oklch() to hex before precision rounding, so the full authored precision is used
-  val = convertOklchFunctionsToHex(val);
-
-  // Minify whitespace and numeric precision inside wide-gamut and functional color notations
-  val = val.replace(/\b(oklab|oklch|lch|lab|color|hwb)\((.*?)\)/gi, (match, func, inner) => {
-    // Collapse whitespace to single space
-    let minified = inner.replace(/\s+/g, ' ');
-    // Remove space after commas
-    minified = minified.replace(/, /g, ',');
-    // Remove spaces around slash separator (alpha delimiter)
-    minified = minified.replace(/ \/ /g, '/');
-    // Strip leading zeros from decimal numbers (e.g. 0.5 → .5)
-    minified = minified.replace(/\b0+(\.[\d]+)/g, '$1');
-    // Strip leading zeros from decimals preceded by a keyword (e.g. srgb 0.5 → srgb .5)
-    minified = minified.replace(/([A-Za-z]) 0+(\.[\d]+)/g, '$1 $2');
-    // Check if function uses a wide-gamut color space requiring higher numeric precision
-    const useWidePrecision = func.toLowerCase() === 'color' && /\b(srgb-linear|xyz-d65|xyz-d50|xyz)\b/i.test(inner);
-    // Round numbers with 3+ decimal places, using context-aware precision
-    minified = minified.replace(/(^|[\s(,/-])(-?\d*\.\d{3,})/g, (match, before, num) => {
-      const isAlpha = before === '/';
-      const absoluteValue = Math.abs(parseFloat(num));
-      // Check if function is a Lab/LCH color notation with a large channel value (less precision needed)
-      const isLargeLabValue = /^(?:lch|lab|oklch|oklab)$/i.test(func) && absoluteValue >= 10;
-      let precision;
-      if (isAlpha) {
-        precision = 3;
-      } else if (isLargeLabValue) {
-        precision = 1;
-      } else if (useWidePrecision) {
-        precision = 4;
-      } else {
-        precision = 3;
-      }
-      const factor = Math.pow(10, precision);
-      const roundedNum = Math.round(parseFloat(num) * factor) / factor;
-      // Strip trailing zeros and trailing decimal point from the rounded number
-      let rounded = roundedNum.toFixed(precision).replace(/0+$/, '').replace(/\.$/, '');
-      if (rounded.startsWith('0.')) {
-        rounded = rounded.substring(1);
-      }
-      if (rounded.startsWith('-0.')) {
-        rounded = '-' + rounded.substring(2);
-      }
-      return before + rounded;
-    });
-    // Remove trailing ".0" from numbers so integer channel values stay integer
-    // (e.g. display-p3 1.0 0.0 0.0 becomes display-p3 1 0 0)
-    minified = minified.replace(/(-?\d*)\.0\b/g, (match, integer) => {
-      if (integer === '' || integer === '-' || integer === '-0') {
-        return '0';
-      }
-      return integer;
-    });
-    minified = compactNegativeColorChannelSpacing(func, minified);
-    if (func.toLowerCase() === 'oklch') {
-      minified = minifyOklchPercentages(minified);
-    }
-    return func + '(' + minified.trim() + ')';
-  });
-
-  // Convert in-gamut oklab() to hex when it produces a shorter representation
-  // A negative channel may touch the preceding number because its sign separates the CSS number tokens.
-  val = val.replace(/\boklab\(\s*(-?(?:\d+|\d*\.\d+))(?:\s+|(?=-))(-?(?:\d+|\d*\.\d+))(?:\s+|(?=-))(-?(?:\d+|\d*\.\d+))(?:\s*\/\s*(-?(?:\d+|\d*\.\d+)%?))?\s*\)/gi, (match, lStr, aStr, bStr, alphaStr) => {
-    const alpha = parseAlphaString(alphaStr);
-    const hex = convertOklabToHex(parseFloat(lStr), parseFloat(aStr), parseFloat(bStr), alpha);
-    if (!hex) {
-      return match; // out-of-gamut: keep native oklab form
-    }
-    if (hex.length < match.length) {
-      return hex;
-    }
-    return match;
-  });
-
-  // Handle 'none' keyword in rgb/hsl functions (CSS Color Level 4: treated as 0)
-  val = val.replace(/\b(rgba?|hsla?)\([^)]*\)/gi, (match) => {
-    return match.replace(/\bnone\b/gi, '0');
-  });
-
-  // hwb() → hex (percent signs optional for whiteness/blackness, values always treated as percentages)
-  val = val.replace(/\bhwb\(\s*(-?(?:\d+|\d*\.\d+))\s+((?:\d+|\d*\.\d+))%?\s+((?:\d+|\d*\.\d+))%?(?:\s*\/\s*(-?(?:\d+|\d*\.\d+)%?))?\s*\)/gi, (match, hStr, wStr, bStr, aStr) => {
-    const [r, g, b] = hwbToRgbChannels(parseFloat(hStr), parseFloat(wStr) / 100, parseFloat(bStr) / 100);
-    return rgbaToHex(r, g, b, parseAlphaString(aStr));
-  });
-
-  // rgb()/rgba() space syntax → hex, case-insensitive (handles decimals and any alpha)
-  val = val.replace(/\brgba?\(\s*(-?(?:\d+|\d*\.\d+))\s+(-?(?:\d+|\d*\.\d+))\s+(-?(?:\d+|\d*\.\d+))(?:\s*\/\s*(-?(?:\d+|\d*\.\d+)%?))?\s*\)/gi, (match, rStr, gStr, bStr, aStr) => {
-    const r = Math.round(parseFloat(rStr));
-    const g = Math.round(parseFloat(gStr));
-    const b = Math.round(parseFloat(bStr));
-    return rgbaToHex(r, g, b, parseAlphaString(aStr));
-  });
-
-  // hsl()/hsla() space syntax → hex, case-insensitive (percent signs optional, values always treated as percentages)
-  val = val.replace(/\bhsla?\(\s*(-?(?:\d+|\d*\.\d+))\s+((?:\d+|\d*\.\d+))%?\s+((?:\d+|\d*\.\d+))%?(?:\s*\/\s*(-?(?:\d+|\d*\.\d+)%?))?\s*\)/gi, (match, hStr, sStr, lStr, aStr) => {
-    const [r, g, b] = hslToRgbChannels(parseFloat(hStr), parseFloat(sStr) / 100, parseFloat(lStr) / 100);
-    return rgbaToHex(r, g, b, parseAlphaString(aStr));
-  });
-
-  // rgba() comma syntax → hex, case-insensitive (handles any alpha)
-  val = val.replace(/\brgba\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*,\s*(-?(?:\d+|\d*\.\d+)%?)\s*\)/gi, (match, rStr, gStr, bStr, aStr) => {
-    const r = parseInt(rStr, 10);
-    const g = parseInt(gStr, 10);
-    const b = parseInt(bStr, 10);
-    return rgbaToHex(r, g, b, parseAlphaString(aStr));
-  });
-
-  // hsla() comma syntax → hex, case-insensitive (percent signs optional, values always treated as percentages)
-  val = val.replace(/\bhsla\(\s*(-?(?:\d+|\d*\.\d+))\s*,\s*((?:\d+|\d*\.\d+))%?\s*,\s*((?:\d+|\d*\.\d+))%?\s*,\s*(-?(?:\d+|\d*\.\d+)%?)\s*\)/gi, (match, hStr, sStr, lStr, aStr) => {
-    const [r, g, b] = hslToRgbChannels(parseFloat(hStr), parseFloat(sStr) / 100, parseFloat(lStr) / 100);
-    return rgbaToHex(r, g, b, parseAlphaString(aStr));
-  });
-
-  // hsl()/hsla() comma syntax without alpha → hex, case-insensitive (percent signs optional, values always treated as percentages)
-  val = val.replace(/\bhsla?\(\s*(-?(?:\d+|\d*\.\d+))\s*,\s*((?:\d+|\d*\.\d+))%?\s*,\s*((?:\d+|\d*\.\d+))%?\s*\)/gi, (match, hStr, sStr, lStr) => {
-    const [r, g, b] = hslToRgbChannels(parseFloat(hStr), parseFloat(sStr) / 100, parseFloat(lStr) / 100);
-    return rgbaToHex(r, g, b, 1);
-  });
-
-  // rgb() comma syntax → hex, case-insensitive
-  val = val.replace(/\brgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)/gi, (match, r, g, b) => {
-    return rgbaToHex(parseInt(r, 10), parseInt(g, 10), parseInt(b, 10), 1);
-  });
-  return val;
-}
-
-/**
- * Map from background-position keyword names to their equivalent percent values.
- *
- * @type {{[key: string]: string}}
- */
-const POSITION_KEYWORD_TO_PERCENT = {
-  left: '0',
-  center: '50%',
-  right: '100%',
-  top: '0',
-  bottom: '100%'
-};
-
-/**
- * Converts background-position keyword values to their shorter percent
- * equivalents when possible. Single Y-axis keywords (top, bottom) and
- * multi-value offset syntax (3 or 4 values) are left unchanged.
- *
- * @param  {string} value  The background-position value string.
- * @return {string}        The value with keywords converted to percents where shorter.
- */
-function convertBackgroundPositionKeywords (value) {
-  // Split on whitespace to determine the number of position parts
-  const parts = value.split(/\s+/);
-
-  // 3 or 4 value syntax uses keyword offsets, retain keywords
-  if (parts.length >= 3) {
-    return value;
-  }
-
-  if (parts.length === 1) {
-    const keyword = parts[0].toLowerCase();
-    // Y-axis-only keywords (top, bottom) can't be expressed as a single X-axis percent
-    const isYAxisOnly = keyword === 'top' || keyword === 'bottom';
-    if (isYAxisOnly) {
-      return value;
-    }
-    if (POSITION_KEYWORD_TO_PERCENT[keyword] !== undefined) {
-      return POSITION_KEYWORD_TO_PERCENT[keyword];
-    }
-    return value;
-  }
-
-  if (parts.length === 2) {
-    const firstKeyword = parts[0].toLowerCase();
-    const secondKeyword = parts[1].toLowerCase();
-    const firstIsPositionKeyword = POSITION_KEYWORD_TO_PERCENT[firstKeyword] !== undefined;
-    const secondIsPositionKeyword = POSITION_KEYWORD_TO_PERCENT[secondKeyword] !== undefined;
-
-    if (firstIsPositionKeyword && secondIsPositionKeyword) {
-      const firstPercent = POSITION_KEYWORD_TO_PERCENT[firstKeyword];
-      const secondPercent = POSITION_KEYWORD_TO_PERCENT[secondKeyword];
-      // Collapse to single value when Y is center (50%), since a single value defaults Y to 50%
-      if (secondPercent === '50%') {
-        return firstPercent;
-      }
-      return firstPercent + ' ' + secondPercent;
-    }
-  }
-
-  return value;
-}
-
-/**
- * The power of ten that separates a time in seconds from the same time in
- * milliseconds, keyed by the lowercased time unit.
- *
- * @type {{[unit: string]: number}}
- */
-const TIME_UNIT_POWERS = {
-  s: 0,
-  ms: -3
-};
-
-/**
- * Rewrites one time token in whichever of seconds or milliseconds spells it
- * shortest, scientific notation included. Every conversion moves the exponent
- * of the exact digits, so no precision is lost however large the time is.
- * Seconds win a tie, and a zero time becomes `0s`.
- *
- * @param  {string} text  The text of a dimension token.
- * @return {string}       The shortest spelling of the same time.
- */
-function shortenTimeToken (text) {
-  const parts = parseNumericParts(text);
-  const writtenUnit = parts?.unit.toLowerCase();
-  if (!parts || !(writtenUnit in TIME_UNIT_POWERS)) {
-    return text;
-  }
-  if (!parts.digits) {
-    return '0s';
-  }
-  const writtenSpelling = shortenNumericText(text, true);
-  const secondsSpelling = formatShortestNumber(
-    scaleByPowerOfTen(parts, TIME_UNIT_POWERS[writtenUnit], 's'),
-    true
-  );
-  const millisecondsSpelling = formatShortestNumber(
-    scaleByPowerOfTen(parts, TIME_UNIT_POWERS[writtenUnit] - TIME_UNIT_POWERS.ms, 'ms'),
-    true
-  );
-  // Seconds are the conventional unit, so they win a tie with milliseconds
-  const convertedSpelling = millisecondsSpelling.length < secondsSpelling.length ? millisecondsSpelling : secondsSpelling;
-  return convertedSpelling.length <= writtenSpelling.length ? convertedSpelling : writtenSpelling;
-}
-
-/**
- * Reports whether rewriting a number keeps its numeric type. A number written
- * with a decimal point or an exponent has the `<number>` type, while one
- * written with digits alone is an `<integer>`. A custom property can be
- * substituted into, or registered with, a grammar that tells the two apart, so
- * `100.0` cannot become `100` there.
- *
- * @param  {string}  originalNumber   The number as it was written.
- * @param  {string}  rewrittenNumber  The number as it would be rewritten.
- * @return {boolean}                  True when both spellings have the same type.
- */
-function keepsNumberType (originalNumber, rewrittenNumber) {
-  return isIntegerSpelling(originalNumber) === isIntegerSpelling(rewrittenNumber);
-}
-
-/**
- * Reports whether a number is spelled as an `<integer>`: digits with an
- * optional sign, and no decimal point or exponent.
- *
- * @param  {string}  number  The number as written.
- * @return {boolean}         True when the spelling is an integer.
- */
-function isIntegerSpelling (number) {
-  // An optional sign followed by nothing but digits
-  return /^[+-]?\d+$/.test(number);
-}
-
-/**
- * Converts each time in a value between seconds and milliseconds, whichever
- * is the shorter string.
- *
- * @param  {string} value  The CSS value string potentially containing time values.
- * @return {string}        The value with each time in its shortest unit.
- */
-function convertTimesToShortestUnit (value) {
-  return tokenizeCssValue(value).map((token) => {
-    if (token.type !== 'dimension') {
-      return token.text;
-    }
-    return shortenTimeToken(token.text);
-  }).join('');
-}
-
-/**
- * Matches an absolute CSS length token: an optionally signed number followed by
- * an absolute length unit. The lookbehind rejects digits that belong to a larger
- * identifier, such as the custom property name in `var(--size-2in)`, where the
- * digits and unit do not form a value of their own.
- *
- * @type {RegExp}
- */
-const ABSOLUTE_LENGTH_PATTERN = /(?<![\w#.%-])(-?(?:\d+|\d*\.\d+))(pt|pc|in|cm|mm|q)\b/gi;
+import { isCustomProperty } from '../utilities.js';
 
-/**
- * The largest difference in pixels that a rounded conversion may introduce and
- * still count as exact, which allows for binary floating point error without
- * allowing a visible change to the rendered length.
- *
- * @type {number}
- */
-const PIXEL_ROUNDING_TOLERANCE = 1e-6;
+import { convertColorsToHex } from './color/functions.js';
+import { simplifyEquivalentLightDarkFunctions } from './color/light-dark.js';
+import { minifyRelativeColorSyntax } from './color/relative.js';
+import {
+  lowercaseHexColors,
+  shortenColorValues
+} from './color/shorten.js';
+import { minifyGradients } from './gradients.js';
+import { shortenLengthyInitialKeyword } from './initial-keywords.js';
+import {
+  normalizeMathFunctions,
+  simplifyStandaloneCalc
+} from './math/index.js';
+import { keepsNumberType } from './numbers.js';
+import { POSITION_AREA_SHORTHANDS } from './positions.js';
+import {
+  applyPropertyOptimizations,
+  PUNCTUATED_COMPONENT_PROPERTIES
+} from './property-optimizations.js';
+import { isQuotesNoneEquivalent } from './quotes.js';
+import { replaceOutsideStringsAndUrls } from './segments.js';
+import { formatResolvedNumber } from './shared.js';
+import {
+  elideRedundantSeparators,
+  shortenDimensionNumbers
+} from './tokens.js';
+import { optimizeUnicodeRange } from './unicode-range.js';
+import {
+  minifyUrls,
+  protectUrlTokens,
+  removeWhitespaceAfterUrlTokens,
+  restoreUrlTokens
+} from './urls.js';
+import { normalizeWhitespaceAndQuotes } from './whitespace.js';
 
 /**
- * Converts absolute length values (pt, pc, in, cm, mm, Q) to their pixel
- * equivalent when the conversion is exact and the pixel form is no longer than
- * the original. Normalizing to px also improves compression by reducing the
- * number of distinct unit strings in the output.
+ * Simplifies the `calc()` expressions that add a zero percentage to a
+ * non-zero one, dropping the additive identity term.
  *
- * @param  {string} value  A CSS value segment, outside strings and urls.
- * @return {string}        The segment with eligible absolute lengths converted to px.
- */
-function convertAbsoluteLengthsToPx (value) {
-  return value.replace(ABSOLUTE_LENGTH_PATTERN, (token, amount, unit) => {
-    const pixels = convertAbsoluteLengthToPx(amount, unit);
-    if (pixels === null) {
-      return token;
-    }
-    const converted = roundCompactNumber(pixels) + 'px';
-    const isExact = Math.abs(parseFloat(converted) - pixels) < PIXEL_ROUNDING_TOLERANCE;
-    if (!isExact || converted.length > token.length) {
-      return token;
+ * @param  {string} value  The CSS value string.
+ * @return {string}        The value with zero-percent additive terms removed.
+ */
+function removeZeroPercentTermsFromCalc (value) {
+  // Match a calc() whose contents hold no further parentheses
+  return value.replace(/calc\(([^()]+)\)/gi, (match, inner) => {
+    // Collapse whitespace inside calc expression
+    const compactInner = inner.replace(/\s+/g, ' ').trim();
+    // Extract all percentage terms from the expression
+    const percentTerms = compactInner.match(/[+-]?\s*(?:\d*\.\d+|\d+)%/g) || [];
+    const hasNonZeroPercent = percentTerms.some((term) => {
+      return Math.abs(parseFloat(term)) > 0;
+    });
+    if (!hasNonZeroPercent) {
+      return match;
     }
-    return converted;
+    // Remove trailing "+ 0%" and leading "0% +" additive identity terms
+    return 'calc(' + compactInner.replace(/\s*\+\s*0%(?=\s*$)/g, '').replace(/^0%\s*\+\s*/g, '').trim() + ')';
   });
 }
 
 /**
- * Properties whose `initial` value is a number the browser resolves, so the
- * keyword only ever shortens for the two that have a shorter written form.
- *
- * @type {Set<string>}
- */
-const NUMERIC_INITIAL_PROPERTIES = new Set([
-  'opacity',
-  'z-index',
-  'flex-grow',
-  'flex-shrink',
-  'order',
-  'line-height',
-  'zoom'
-]);
-
-/**
- * Properties whose `initial` value is zero.
- *
- * @type {Set<string>}
- */
-const ZERO_INITIAL_PROPERTIES = new Set(['margin', 'padding']);
-
-/**
- * Properties whose `initial` value is `auto`.
- *
- * @type {Set<string>}
- */
-const AUTO_INITIAL_PROPERTIES = new Set([
-  'min-width',
-  'min-height',
-  'hyphenate-limit-chars'
-]);
-
-/**
- * Properties whose initial value is a single keyword longer than the global
- * `initial` keyword itself. These replacements are applied when serializing
- * declarations, because shorthand builders reconstruct their value from the
- * actual longhand keywords, and a CSS-wide keyword such as `initial` is only
- * valid as a declaration's entire value.
- *
- * @type {Map<string, string>}
- */
-const LENGTHY_INITIAL_KEYWORDS = new Map([
-  ['background-clip', 'border-box'],
-  ['background-origin', 'padding-box'],
-  ['border-collapse', 'separate'],
-  ['border-color', 'currentcolor'],
-  ['border-top-color', 'currentcolor'],
-  ['border-right-color', 'currentcolor'],
-  ['border-bottom-color', 'currentcolor'],
-  ['border-left-color', 'currentcolor'],
-  ['box-sizing', 'content-box'],
-  ['mask-clip', 'border-box'],
-  ['mask-origin', 'border-box'],
-  ['vertical-align', 'baseline'],
-  ['writing-mode', 'horizontal-tb']
-]);
-
-/**
- * Properties whose value is a time, where a millisecond amount may be worth
- * rewriting in seconds.
- *
- * @type {Set<string>}
- */
-const TIME_PROPERTIES = new Set([
-  'transition',
-  'transition-duration',
-  'transition-delay',
-  'animation',
-  'animation-duration',
-  'animation-delay'
-]);
-
-/**
- * Properties whose grammar delimits its own components, either with punctuation
- * (the `/` and `,` of the `background`, `mask`, and `src` layers) or by taking
- * nothing but functions (`transform`). Their components stay readable without
- * the whitespace that follows a closing parenthesis, so that whitespace is left
- * elided and each of them restores only the separators its grammar still needs.
- *
- * @type {Set<string>}
- */
-const PUNCTUATED_COMPONENT_PROPERTIES = new Set([
-  'background',
-  'mask',
-  'src',
-  'transform'
-]);
-
-/**
- * Reports whether a property is a custom property. A custom property holds an
- * arbitrary token stream rather than a typed value, so every one of its tokens,
- * whitespace included, is part of what it stores.
- *
- * @param  {string}  property  The CSS property name.
- * @return {boolean}           Whether the property is a custom property.
- */
-function isCustomProperty (property) {
-  return Boolean(property) && property.startsWith('--');
-}
-
-/**
- * Matches one offset of a position: an edge keyword or a numeric distance.
- *
- * @type {string}
- */
-const POSITION_OFFSET_SOURCE = '(?:left|center|right|top|bottom|[+-]?(?:\\d+|\\d*\\.\\d+)(?:%|[a-z]+)?)';
-
-/**
- * Matches a whole position component, which is one or two of those offsets.
- *
- * @type {string}
- */
-const POSITION_COMPONENT_SOURCE = '(' + POSITION_OFFSET_SOURCE + '(?:\\s+' + POSITION_OFFSET_SOURCE + ')?)';
-
-/**
- * Matches everything a `url()` holds up to but not including its own closing
- * parenthesis. A url is written without nested parentheses, so the first one
- * that closes it is the end of the token.
- *
- * @type {string}
- */
-const URL_TOKEN_BODY_SOURCE = 'url\\([^()]*';
-
-/**
- * Matches a close-paren that ends an image function, followed by a separated
- * position that no slash follows. The parenthesis that ends a `url()` is
- * skipped, since that one closes a token rather than a function.
- *
- * @type {RegExp}
- */
-const SEPARATED_FUNCTION_POSITION_PATTERN = new RegExp('(?<!' + URL_TOKEN_BODY_SOURCE + ')\\)\\s+' + POSITION_COMPONENT_SOURCE + '(?!\\/)', 'gi');
-
-/**
- * Matches a `url()` separated from the position that follows it, which is the
- * separator a url does not need.
- *
- * @type {RegExp}
- */
-const SEPARATED_URL_POSITION_PATTERN = new RegExp('(' + URL_TOKEN_BODY_SOURCE + '\\))\\s+' + POSITION_COMPONENT_SOURCE, 'gi');
-
-/**
- * Matches a close-paren separated from a position that a slash follows, where
- * the slash already delimits the position from the size behind it.
- *
- * @type {RegExp}
- */
-const SEPARATED_IMAGE_SIZE_POSITION_PATTERN = new RegExp('\\)\\s+' + POSITION_COMPONENT_SOURCE + '(?=\\/)', 'gi');
-
-/**
- * Normalizes the separator between the image of a layer and the position that
- * follows it. Both `background` and `mask` take a `<position> [ / <size> ]`
- * component after their image. The closing parenthesis already delimits a
- * function token from the position, and neither a position that a `/` follows
- * nor one that follows a `url()` needs a separator either.
- *
- * @param  {string} value  The layered image value, with the parenthesis padding removed.
- * @return {string}        The value with the position separator normalized.
- */
-function normalizeImagePositionSeparator (value) {
-  const joinedToFunction = value.replace(SEPARATED_FUNCTION_POSITION_PATTERN, ')$1');
-  const joinedToUrl = joinedToFunction.replace(SEPARATED_URL_POSITION_PATTERN, '$1$2');
-  return joinedToUrl.replace(SEPARATED_IMAGE_SIZE_POSITION_PATTERN, ')$1');
-}
-
-/**
- * Matches the keywords that state a border line style.
- *
- * @type {string}
- */
-const BORDER_STYLE_KEYWORD_SOURCE = 'solid|dashed|dotted|double|groove|ridge|inset|outset|hidden|none';
-
-/**
- * Matches the ways a border line width is stated: one of its three keywords, a
- * length, or a math function that resolves to one.
- *
- * @type {string}
- */
-const BORDER_WIDTH_SOURCE = 'thin|medium|thick|[+-]?(?:\\d+|\\d*\\.\\d+)(?:e[+-]?\\d+)?[a-z]*|(?:calc|min|max|clamp)\\([^()]*\\)';
-
-/**
- * Matches a `border` value that states its line style in front of its line
- * width, with the two captured so they can be swapped.
- *
- * @type {RegExp}
- */
-const BORDER_STYLE_BEFORE_WIDTH_PATTERN = new RegExp(
-  '^(' + BORDER_STYLE_KEYWORD_SOURCE + ')\\s+(' + BORDER_WIDTH_SOURCE + ')(?=\\s|$)',
-  'i'
-);
-
-/**
- * Rewrites a `border` value that leads with its line style into the canonical
- * width-style-color order. The width has to be recognized before the two are
- * swapped: `border` states its components in any order, so the component behind
- * the style may be a color instead, as in `solid #8aadf4 1px`, and that one
- * belongs behind the width rather than in front of it.
- *
- * @param  {string} value  The `border` value.
- * @return {string}        The value with its width stated before its style.
- */
-function reorderBorderWidthBeforeStyle (value) {
-  return value.replace(BORDER_STYLE_BEFORE_WIDTH_PATTERN, '$2 $1');
-}
-
-/**
- * Matches a trailing `!important` flag, so the components in front of it can be
- * rewritten without the flag being mistaken for part of the last one.
+ * Matches a value that is a single number with an optional unit, capturing
+ * the number and the unit.
  *
  * @type {RegExp}
  */
-const IMPORTANT_SUFFIX_PATTERN = /!important$/i;
-
-/**
- * Separates a value from the `!important` flag it may end with.
- *
- * @param  {string} value  The declaration value, possibly flagged important.
- * @return {object}        The components in front of the flag, and the flag itself or an empty string.
- */
-function splitImportantSuffix (value) {
-  const match = value.match(IMPORTANT_SUFFIX_PATTERN);
-  if (!match) {
-    return { components: value, importantSuffix: '' };
-  }
-  return {
-    components: value.slice(0, match.index).trim(),
-    importantSuffix: match[0]
-  };
-}
-
-/**
- * Collapses a `hyphenate-limit-chars` value to its shortest equivalent form.
- * The property states up to three components: the shortest word that may be
- * hyphenated, then the fewest characters allowed before a hyphen, then the
- * fewest allowed after it. An unstated "before" component is read as `auto`,
- * and an unstated "after" component repeats whatever "before" holds, so a
- * trailing component that only restates the default it stands in for is
- * redundant.
- *
- * @param  {string} value  The `hyphenate-limit-chars` value.
- * @return {string}        The value with its redundant trailing components dropped.
- */
-function collapseHyphenateLimitChars (value) {
-  const {
-    components,
-    importantSuffix
-  } = splitImportantSuffix(value);
-  const parts = components.split(' ').filter(Boolean);
-  if (hasSubstitutedParts(parts)) {
-    return value;
-  }
-  const isAfterMatchingBefore = (
-    parts.length === 3 &&
-    parts[2].toLowerCase() === parts[1].toLowerCase()
-  );
-  if (isAfterMatchingBefore) {
-    parts.pop();
-  }
-  const isBeforeLeftAtDefault = (
-    parts.length === 2 &&
-    parts[1].toLowerCase() === 'auto'
-  );
-  if (isBeforeLeftAtDefault) {
-    parts.pop();
-  }
-  return parts.join(' ') + importantSuffix;
-}
+const STANDALONE_NUMBER_PATTERN = /^([+-]?(?:\d+|\d*\.\d+))([a-z%]+)?$/i;
 
 /**
- * Minifies a declaration's value for output, rewriting its initial keyword to
- * the shorter global `initial` keyword after shorthand assembly. Both are
- * equivalent, but `initial` is shorter than these particular keywords and,
- * being repeated across properties, gives gzip more opportunities to deduplicate it.
+ * Rounds a value that is a standalone number with an optional unit into the
+ * character budget a number is written within. A custom property only takes
+ * the rounding when it keeps the number's type, and a tiny dimension whose
+ * significant digits rounding would lose keeps its exponent form instead.
  *
- * @param  {object} declaration  The CSS declaration object with property and value fields.
- * @return {string}              The minified value with its initial keyword shortened to `initial` when that saves bytes.
+ * @param  {string} value     The CSS value string.
+ * @param  {string} property  The CSS property name.
+ * @return {string}           The rounded value, or the value unchanged when it is not a standalone number.
  */
-function minifyValueForOutput (declaration) {
-  const value = minifyValue(declaration);
-  const property = declaration.property;
-  // Custom properties hold an arbitrary token stream that JavaScript can read
-  // back, so their keywords are left exactly as written.
-  if (isCustomProperty(property)) {
-    return value;
-  }
-  // A keyword spelling the property's own initial value is shorter as the
-  // global keyword (box-sizing: content-box -> box-sizing: initial)
-  const initialKeyword = LENGTHY_INITIAL_KEYWORDS.get(property?.toLowerCase());
-  if (!initialKeyword || 'initial'.length >= initialKeyword.length) {
-    return value;
-  }
-  // A trailing `!important` rides along inside the value, so the keyword
-  // comparison and the rewrite only concern what sits in front of it.
-  const isImportant = value.endsWith('!important');
-  const keyword = isImportant ? value.slice(0, value.length - '!important'.length) : value;
-  if (keyword.toLowerCase() !== initialKeyword) {
+function roundStandaloneNumber (value, property) {
+  const standaloneNumber = value.match(STANDALONE_NUMBER_PATTERN);
+  if (!standaloneNumber) {
     return value;
   }
-  return 'initial' + (isImportant ? '!important' : '');
-}
-
-/**
- * Applies property-specific optimizations to a CSS value (transition, flex, font,
- * background, display, scale, border-radius, shorthand collapsing, etc.).
- *
- * @param  {string} val        The CSS value string after generic minification.
- * @param  {string} property   The CSS property name.
- * @param  {Array}  urlTokens  URL tokens currently represented by markers.
- * @return {string}            The value with property-specific optimizations applied.
- */
-function applyPropertyOptimizations (val, property, urlTokens) {
-  if (property === 'font-weight' && isUnicodeCharset()) {
-    // Replace font-weight keyword "bold" with its numeric equivalent
-    val = val.replace(/\bbold\b/gi, '700');
-    // Replace font-weight keyword "normal" with its numeric equivalent
-    val = val.replace(/\bnormal\b/gi, '400');
-  }
-
-  // Convert ms to s for time-related properties when the seconds form is shorter
-  if (TIME_PROPERTIES.has(property)) {
-    val = convertTimesToShortestUnit(val);
-  }
-
-  // Transition: remove " 0s" duration (transition: all 0s -> transition: all)
-  if (property === 'transition') {
-    // Remove zero-second duration from transition shorthand
-    val = val.replace(/\s+0s/g, ' ');
-    // Remove leading zero-pixel value from transition shorthand
-    val = val.replace(/^0px\s*/, '');
-    // Replace cubic-bezier functions with their equivalent named timing-function keywords
-    val = val.replace(/cubic-bezier\(0,0,1,1\)/g, 'linear');
-    val = val.replace(/cubic-bezier\(\.25,\.1,\.25,1\)/g, 'ease');
-    val = val.replace(/cubic-bezier\(\.42,0,1,1\)/g, 'ease-in');
-    val = val.replace(/cubic-bezier\(0,0,\.58,1\)/g, 'ease-out');
-    val = val.trim();
-  }
-
-  if (property === 'animation') {
-    // Replace steps() functions with their equivalent named timing-function keywords
-    val = val.replace(/steps\(1,start\)/g, 'step-start');
-    val = val.replace(/steps\(1,end\)/g, 'step-end');
-    // Restore space between step-start/step-end keyword and following token
-    // (the parenthesis whitespace stripping removes the space before replacement)
-    val = val.replace(/(step-start|step-end)(?=[a-zA-Z0-9#-])/g, '$1 ');
-  }
-
-  // Flex: remove " 0px" from flex shorthand (flex: 0 0 0px -> flex: 0 0)
-  if (property === 'flex') {
-    // Remove trailing zero-pixel basis value
-    val = val.replace(/\s+0px/g, ' ');
-    // Remove leading zero-pixel value
-    val = val.replace(/^0px\s*/, '');
-    // Remove an explicit zero basis: a trailing zero is only a basis when grow
-    // and shrink precede it, and the shorthand already reads an unwritten basis
-    // as 0. In `0 0` the trailing zero is the shrink, which the shorthand
-    // defaults to 1 instead, so dropping it would size the element differently.
-    val = val.replace(/^(\S+\s+\S+)\s+0$/, '$1');
-    // Remove standalone zero-pixel value
-    val = val.replace(/^0px$/, '');
-    val = val.trim();
-  }
-
-  // Initial values
-  if (val === 'initial') {
-    if (NUMERIC_INITIAL_PROPERTIES.has(property)) {
-      // Just leaving them or mapping some: opacity: initial -> opacity: 1
-      if (property === 'opacity') {
-        val = '1';
-      }
-      if (property === 'z-index') {
-        val = 'auto';
-      }
-    }
-    if (ZERO_INITIAL_PROPERTIES.has(property)) {
-      val = '0';
-    }
-    if (AUTO_INITIAL_PROPERTIES.has(property)) {
-      val = 'auto';
-    }
-    // background-color: initial should become #0000 (transparent)
-    if (property === 'background-color') {
-      val = '#0000';
-    }
-  }
-
-  if (property === 'background' && val === 'none') {
-    val = '0 0';
-  }
-
-  if (property === 'display') {
-    if (val === 'block flow') {
-      val = 'block';
-    }
-    if (val === 'inline flow-root') {
-      val = 'inline-block';
-    }
-  }
-
-  if (property === 'background-repeat') {
-    if (val === 'no-repeat no-repeat') {
-      val = 'no-repeat';
-    }
-    if (val === 'repeat no-repeat') {
-      val = 'repeat-x';
-    }
-    if (val === 'no-repeat repeat') {
-      val = 'repeat-y';
-    }
-  }
-
-  if (property === 'background-position') {
-    val = convertBackgroundPositionKeywords(val);
-  }
-
-  if (property === 'border') {
-    val = reorderBorderWidthBeforeStyle(val);
-  }
-
-  if (property === 'flex-flow') {
-    // Reorder flex-flow from wrap-direction to direction-wrap (canonical order)
-    val = val.replace(/^(nowrap|wrap|wrap-reverse)\s+(row|row-reverse|column|column-reverse)$/i, '$2 $1');
-  }
-
-  if (property === 'font-family') {
-    // Strip quotes from simple multi-word font family names that don't require quoting
-    val = val.replace(/"([A-Za-z0-9-]+(?: [A-Za-z0-9-]+)+)"/g, '$1');
-    const seenFamilies = new Set();
-    val = val.split(',').map((part) => {
-      return part.trim();
-    }).filter(Boolean).filter((part) => {
-      const lowercaseName = part.toLowerCase();
-      if (seenFamilies.has(lowercaseName)) {
-        return false;
-      }
-      seenFamilies.add(lowercaseName);
-      return true;
-    }).join(',');
-  }
-
-  if (property === 'grid-template-areas') {
-    // Normalize each quoted grid-template-areas row string
-    val = val.replace(/"([^"]*)"/g, (match, inner) => {
-      // Collapse whitespace to single space within grid row
-      let normalized = inner.replace(/\s+/g, ' ').trim();
-      // Collapse consecutive dots (null cell tokens) to a single dot
-      normalized = normalized.replace(/(^| )\.{2,}(?= |$)/g, '$1.');
-      return '"' + normalized + '"';
-    });
-  }
-
-  // Custom properties hold an arbitrary token stream rather than a typed value,
-  // so a unit-like token in one is not necessarily a length.
-  if (!isCustomProperty(property)) {
-    val = replaceOutsideStringsAndUrls(val, convertAbsoluteLengthsToPx);
-  }
-
-  if (property === 'syntax') {
-    // Remove whitespace around pipe separators in @property syntax descriptors
-    val = val.replace(/\s*\|\s*/g, '|');
-  }
-
-  // Simplify clamp() where all three arguments are identical (e.g. clamp(1rem,1rem,1rem) → 1rem)
-  val = val.replace(/\bclamp\(([^,]+),\1,\1\)/gi, '$1');
-
-  // Convert display-p3 neutral grays to sRGB (equal channels are identical across gamuts)
-  val = val.replace(/\bcolor\(display-p3\s+([\d.]+)\s+\1\s+\1(?:\s*\/\s*(-?(?:\d+|\d*\.\d+)%?))?\s*\)/gi, (match, channelStr, alphaStr) => {
-    const channelValue = parseFloat(channelStr);
-    const r = Math.round(channelValue * 255);
-    return rgbaToHex(r, r, r, parseAlphaString(alphaStr));
-  });
-
-  // Font families may contain color names, but never color values.
-  if (property !== 'font' && property !== 'font-family') {
-    val = replaceOutsideStringsAndUrls(val, (segment) => {
-      return shortenColorValues(segment);
-    });
-  }
-
-  if (!PUNCTUATED_COMPONENT_PROPERTIES.has(property)) {
-    // Restore space after close-paren when followed by an alphanumeric, hash, or hyphen
-    val = val.replace(/\)(?=[0-9a-zA-Z#-])/g, ') ');
-  }
-  val = restoreSpaceBeforeMathOperators(val);
-
-  if (property === 'font') {
-    val = minifyFontShorthand(val);
-  }
-
-  if (property === 'background' && val !== 'none') {
-    let normalized = val
-      // Remove default "0 0" background-position values
-      .replace(/(?:^|\s)0(?:%|px)? 0(?:%|px)?(?=\s|$)/g, ' ')
-      // Remove "0 0" background-position after a close-paren (e.g. after url())
-      .replace(/\)0(?:%|px)? 0(?:%|px)?(?=\s|$)/g, ') ')
-      // Remove default "repeat" background-repeat keyword (excluding compound values like no-repeat)
-      .replace(/(?<!-)\brepeat\b(?!-)/g, ' ')
-      // Remove default "scroll" background-attachment keyword
-      .replace(/\bscroll\b/g, ' ')
-      // Remove default "none" background-image keyword
-      .replace(/\bnone\b/g, ' ')
-      // Collapse whitespace to single space
-      .replace(/\s+/g, ' ')
-      .trim();
-    normalized = removeDefaultBackgroundPositionsAfterUrlTokens(normalized, urlTokens);
-    if (normalized) {
-      val = normalized;
-    }
-    val = normalizeImagePositionSeparator(val);
-  }
-
-  if (property === 'mask') {
-    val = normalizeImagePositionSeparator(val);
-  }
-
-  if (property === 'border') {
-    // Remove default "medium" border-width keyword
-    val = val.replace(/\bmedium\s+/g, '');
-  }
-
-  if (property === 'outline') {
-    // Restore missing space between outline-style and a color keyword when they are adjacent
-    val = val.replace(/\b(solid|dashed|dotted|double|groove|ridge|inset|outset|hidden|none)(red|green|olive|tan|transparent)\b/g, '$1 $2');
-  }
-
-  if (property === 'transform') {
-    val = minifyTransformValue(val);
-    // Remove whitespace between consecutive transform functions
-    val = val.replace(/\)\s+(?=[a-z-]+\()/gi, ')');
-  }
-
-  if (property === 'scale') {
-    // Split scale value on whitespace into individual axis components
-    const parts = val.split(/\s+/).filter(Boolean).map(normalizeScaleComponent);
-    if (parts.length === 2 && parts[0] === parts[1]) {
-      val = parts[0];
-    } else if (parts.length === 3 && parts[2] === '1') {
-      if (parts[0] === parts[1]) {
-        val = parts[0];
-      } else {
-        val = parts[0] + ' ' + parts[1];
-      }
-    } else {
-      val = parts.join(' ');
-    }
-  }
-
-  // Replace multiple spaces
-  val = val.replace(/\s+/g, ' ');
-
-  // Shorthands: margin, padding, border-width, border-style, border-color, inset
-  // Check if property supports box-model shorthand collapsing (4 → 3 → 2 → 1 values)
-  if (/^(margin|padding|inset|border-width|border-style|border-color|gap|overflow)$/.test(property)) {
-    // Split components instead of splitting on spaces, so values that legally
-    // touch, like the adjacent hex colors of `#ddd#ddd`, count separately
-    val = collapseShorthandParts(splitTopLevelComponents(val))
-      .join(' ')
-      // A hash token may touch the component before it, so the separator space is not needed
-      .replace(/ #/g, '#');
-  }
-
-  if (property === 'hyphenate-limit-chars') {
-    val = collapseHyphenateLimitChars(val);
+  const [, rawNumber, rawUnit = ''] = standaloneNumber;
+  const isCustom = isCustomProperty(property);
+  const scientificValue = isCustom ? value : shortenDimensionNumbers(value, property);
+  const roundedNumber = formatResolvedNumber(rawNumber);
+  const losesPrecision = Number(roundedNumber) !== Number(rawNumber);
+  // Preserve tiny dimensions whose significant digits would otherwise be
+  // rounded away before their shorter exponent form can be considered.
+  if (losesPrecision && scientificValue !== value) {
+    return scientificValue;
   }
-
-  if (property === 'border-radius') {
-    const segments = val.split('/').map((segment) => {
-      return segment.trim();
-    }).filter(Boolean).map((segment) => {
-      // Split each segment on whitespace and collapse redundant parts
-      return collapseShorthandParts(segment.split(/\s+/)).join(' ');
-    });
-    val = segments.join('/');
+  if (!isCustom || keepsNumberType(rawNumber, roundedNumber)) {
+    return roundedNumber + rawUnit;
   }
-
-  return val;
+  return value;
 }
 
 /**
@@ -1648,118 +119,88 @@ function computeMinifiedValue (declaration) {
   if (declaration.property === 'quotes' && isQuotesNoneEquivalent(declaration.value)) {
     return 'none';
   }
-  let val = declaration.value;
+  let value = declaration.value;
   let protectedUrlState = null;
 
-  if (typeof val === 'string') {
-    val = val.trim();
-    val = normalizeWhitespaceAndQuotes(val, declaration.property);
-    val = minifyUrls(val);
-    protectedUrlState = protectUrlTokens(val);
-    val = protectedUrlState.value;
+  if (typeof value === 'string') {
+    value = value.trim();
+    value = normalizeWhitespaceAndQuotes(value, declaration.property);
+    value = minifyUrls(value);
+    protectedUrlState = protectUrlTokens(value);
+    value = protectedUrlState.value;
 
     // Instead of unconditionally removing spaces around + and - and *, handle math vs non-math
     // Collapse spaces around division operator
-    val = val.replace(/ \/ /g, '/');
+    value = value.replace(/ \/ /g, '/');
     // Remove whitespace around * and / operators (safe outside calc context)
-    val = val.replace(/\s*([*/])\s*/g, '$1');
-    val = normalizeMathFunctions(val, declaration.property, declaration.value || '');
-    val = simplifyStandaloneCalc(val, declaration.property);
-    // Simplify calc() expressions containing zero-percent additive terms
-    val = val.replace(/calc\(([^()]+)\)/gi, (match, inner) => {
-      // Collapse whitespace inside calc expression
-      const compactInner = inner.replace(/\s+/g, ' ').trim();
-      // Extract all percentage terms from the expression
-      const percentTerms = compactInner.match(/[+-]?\s*(?:\d*\.\d+|\d+)%/g) || [];
-      const hasNonZeroPercent = percentTerms.some((term) => {
-        return Math.abs(parseFloat(term)) > 0;
-      });
-      if (!hasNonZeroPercent) {
-        return match;
-      }
-      // Remove trailing "+ 0%" and leading "0% +" additive identity terms
-      return 'calc(' + compactInner.replace(/\s*\+\s*0%(?=\s*$)/g, '').replace(/^0%\s*\+\s*/g, '').trim() + ')';
-    });
+    value = value.replace(/\s*([*/])\s*/g, '$1');
+    value = normalizeMathFunctions(value, declaration.property, declaration.value || '');
+    value = simplifyStandaloneCalc(value, declaration.property);
+    value = removeZeroPercentTermsFromCalc(value);
 
     // Zeros and Decimals
     if (declaration.property !== 'initial-value') {
       // Strip units from zero values (0px → 0, 0em → 0, etc.) at a value boundary
-      val = val.replace(/(^|\s|,|\()0(?:px|em|rem|vw|vh|cm|mm|in|pt|pc|ex|ch|vmin|vmax)(?=\s|,|$|\)|!)/g, '$10');
-    }
-    val = val.replace(/(^|\s|,|\()(-?)0+(\.\d+)/g, '$1$2$3'); // e.g. 0.5 -> .5, -0.5 -> -.5
-
-    // If value is a standalone number with optional unit, round it into the
-    // character budget a number is written within
-    if (/^[+-]?(?:\d+|\d*\.\d+)([a-z%]+)?$/i.test(val)) {
-      const [, rawNumber, rawUnit = ''] = val.match(/^([+-]?(?:\d+|\d*\.\d+))([a-z%]+)?$/i);
-      const isCustom = isCustomProperty(declaration.property);
-      const scientificValue = isCustom ? val : shortenDimensionNumbers(val, declaration.property);
-      const roundedNumber = formatResolvedNumber(rawNumber);
-      const losesPrecision = Number(roundedNumber) !== Number(rawNumber);
-      // Preserve tiny dimensions whose significant digits would otherwise be
-      // rounded away before their shorter exponent form can be considered.
-      if (losesPrecision && scientificValue !== val) {
-        val = scientificValue;
-      } else if (!isCustom || keepsNumberType(rawNumber, roundedNumber)) {
-        val = roundedNumber + rawUnit;
-      }
+      value = value.replace(/(^|\s|,|\()0(?:px|em|rem|vw|vh|cm|mm|in|pt|pc|ex|ch|vmin|vmax)(?=\s|,|$|\)|!)/g, '$10');
     }
+    value = value.replace(/(^|\s|,|\()(-?)0+(\.\d+)/g, '$1$2$3'); // e.g. 0.5 -> .5, -0.5 -> -.5
+    value = roundStandaloneNumber(value, declaration.property);
 
-    val = lowercaseHexColors(val);
+    value = lowercaseHexColors(value);
 
     if (declaration.property !== 'font' && declaration.property !== 'font-family') {
-      val = convertColorsToHex(val);
-      val = replaceOutsideStringsAndUrls(val, (segment) => {
+      value = convertColorsToHex(value);
+      value = replaceOutsideStringsAndUrls(value, (segment) => {
         return shortenColorValues(segment);
       });
     }
 
     // Collapse light-dark() when both normalized branches are identical
-    val = simplifyEquivalentLightDarkFunctions(val);
+    value = simplifyEquivalentLightDarkFunctions(value);
 
     // Property-specific optimizations
-    val = applyPropertyOptimizations(
-      val,
+    value = applyPropertyOptimizations(
+      value,
       declaration.property,
       protectedUrlState ? protectedUrlState.urlTokens : []
     );
 
     // Minify relative color syntax (identity resolution and whitespace collapsing)
-    val = minifyRelativeColorSyntax(val);
+    value = minifyRelativeColorSyntax(value);
   }
 
   // Gradient optimizations
   // Check if value contains a gradient function
-  if (/gradient\(/.test(val)) {
-    val = minifyGradients(val);
+  if (/gradient\(/.test(value)) {
+    value = minifyGradients(value);
   }
 
   if (protectedUrlState) {
-    val = removeWhitespaceAfterUrlTokens(val, protectedUrlState.urlTokens);
-    val = restoreUrlTokens(val, protectedUrlState.urlTokens);
+    value = removeWhitespaceAfterUrlTokens(value, protectedUrlState.urlTokens);
+    value = restoreUrlTokens(value, protectedUrlState.urlTokens);
   }
 
   // Unicode range optimization: dedup, merge overlapping/adjacent, wildcard compression
   if (declaration.property === 'unicode-range') {
-    val = optimizeUnicodeRange(val);
+    value = optimizeUnicodeRange(value);
   }
 
   // Every earlier pass reads the value with its component separators in place,
   // so the ones that turned out to be redundant are only dropped at the end.
   const elidesRedundantSeparators = (
-    typeof val === 'string' &&
+    typeof value === 'string' &&
     !isCustomProperty(declaration.property)
   );
   if (elidesRedundantSeparators) {
-    val = shortenDimensionNumbers(val, declaration.property);
+    value = shortenDimensionNumbers(value, declaration.property);
     // A property that punctuates its own components already had the whitespace
     // after its closing parentheses taken out, and only the separators its
     // grammar still needs put back, so those are the ones left alone here.
     const elidesAfterSelfEndingTokens = !PUNCTUATED_COMPONENT_PROPERTIES.has(declaration.property);
-    val = elideRedundantSeparators(val, elidesAfterSelfEndingTokens);
+    value = elideRedundantSeparators(value, elidesAfterSelfEndingTokens);
   }
 
-  return val;
+  return value;
 }
 
 /**
@@ -1838,6 +279,23 @@ function minifyValue (declaration) {
   return minifiedValue;
 }
 
+/**
+ * Minifies a declaration's value for output, rewriting its initial keyword to
+ * the shorter global `initial` keyword after shorthand assembly.
+ *
+ * @param  {object} declaration  The CSS declaration object with property and value fields.
+ * @return {string}              The minified value with its initial keyword shortened to `initial` when that saves bytes.
+ */
+function minifyValueForOutput (declaration) {
+  const value = minifyValue(declaration);
+  // Custom properties hold an arbitrary token stream that JavaScript can read
+  // back, so their keywords are left exactly as written.
+  if (isCustomProperty(declaration.property)) {
+    return value;
+  }
+  return shortenLengthyInitialKeyword(value, declaration.property);
+}
+
 export {
   clearMinifiedValueCache,
   minifyValue,