gerillass 0.0.6 → 3.0.0

data/scss/internal/_keyword-value.scss

@@ -0,0 +1,76 @@
+@charset "UTF-8";
+
+@use "sass:list";
+@use "sass:meta";
+@use "sass:string";
+@use "words" as *;
+
+// Shared by the mixins and not public API; see _is-css-function.scss.
+
+$-css-wide: "inherit" "initial" "unset" "revert" "revert-layer";
+
+// Returns what is wrong with $value as a keyword value, or null when it is fine.
+// It checks the kind of each word, not whether the words make sense together;
+// a mixin whose property has a grammar, such as display, checks that itself.
+//
+// - null is fine: the declaration is left out, as it always was.
+// - Any word holding a parenthesis makes the whole value fine when $functions is
+//   true. var(), env() and calc() are resolved by the browser, and a value such
+//   as `var(--x) auto` cannot be judged here. In a @font-face descriptor, which
+//   drops var(), the caller passes false.
+// - Up to $max-words words, each one of $keywords in any case; `STICKY` and
+//   `BOTH` were kept in Chrome 152.
+// - A CSS-wide keyword only on its own: `overflow: inherit auto` was dropped.
+// - A vendor-prefixed word when $vendor is true. Chrome drops `-webkit-sticky`
+//   and `-moz-box`, but other engines use them, so refusing one could break a
+//   stylesheet written for Safari.
+@function keywordProblem($value, $keywords, $max-words: 1, $functions: true, $vendor: false) {
+  @if $value == null {
+    @return null;
+  }
+  @if meta.type-of($value) == "list" and list.separator($value) == "comma" {
+    @return "it takes a space-separated value, not a comma-separated list";
+  }
+  $words: wordsOf($value);
+  @if list.length($words) == 0 {
+    @return "it is empty";
+  }
+  @each $word in $words {
+    @if meta.type-of($word) == "string" and string.index($word, "(") {
+      @if $functions {
+        @return null;
+      }
+      @return "a function cannot supply it here";
+    }
+  }
+  @if list.length($words) > $max-words {
+    @if $max-words == 1 {
+      @return "it takes one keyword, and got #{list.length($words)}";
+    }
+    @return "it takes at most #{$max-words} keywords, and got #{list.length($words)}";
+  }
+  $expected: list.join($keywords, (), $separator: comma);
+  @each $word in $words {
+    @if meta.type-of($word) != "string" {
+      @if list.length($words) == 1 {
+        @return "it takes a keyword, one of: #{$expected}";
+      }
+      @return "`#{meta.inspect($word)}` is not a keyword; pass words from: #{$expected}";
+    }
+    $lower: string.to-lower-case(string.unquote($word));
+    @if list.index($-css-wide, $lower) {
+      @if list.length($words) > 1 {
+        @return "`#{$lower}` only works as the whole value";
+      }
+    } @else if not list.index($keywords, $lower) {
+      $prefixed: string.index($lower, "-webkit-") == 1 or string.index($lower, "-moz-") == 1 or string.index($lower, "-ms-") == 1 or string.index($lower, "-o-") == 1;
+      @if not ($vendor and $prefixed) {
+        @if list.length($words) == 1 {
+          @return "it is not one of: #{$expected}";
+        }
+        @return "`#{$lower}` is not one of: #{$expected}";
+      }
+    }
+  }
+  @return null;
+}

data/scss/internal/_length-problem.scss

@@ -0,0 +1,127 @@
+@charset "UTF-8";
+
+@use "sass:list";
+@use "sass:math";
+@use "sass:meta";
+@use "sass:string";
+@use "is-condition-value" as *;
+
+// Shared by the mixins and not public API; see _is-css-function.scss.
+
+// Maths functions a browser resolves to a length, and the substitutions whose
+// value only the browser knows. Sass reduces most maths on plain numbers before
+// they get here (`round(10.5px, 1px)` arrives as 11px), so these are the forms
+// it leaves as text.
+$-functions: "var" "env" "attr" "calc" "clamp" "min" "max" "round" "abs" "sign" "mod" "rem" "hypot" "sqrt" "pow" "exp" "log";
+$-css-wide: "inherit" "initial" "unset" "revert" "revert-layer";
+
+// Returns what is wrong with $value as one length for a property, or null when
+// a browser keeps it. Each caller passes what its property takes, measured in
+// Chrome 152 (see todos/silent-values-plan.md, S7):
+//
+// - $percent: whether a percentage works (width yes, outline-width no);
+// - $negative: whether a negative length works (outline-offset yes, width no);
+// - $keywords: the words the property takes, such as auto or thin;
+// - $functions: sizing functions beyond maths, such as anchor-size;
+// - $css-wide: whether a CSS-wide keyword works, which is only as a whole
+//   declaration;
+// - $quoted: whether a quoted length works, which is only where the mixin
+//   interpolates it; written raw, `width: "10px"` is dropped.
+//
+// A unitless 0 is accepted; a caller whose output breaks on it handles it.
+// A calculation is taken on trust, since Sass keeps it only when it cannot
+// reduce it.
+@function lengthProblem($value, $percent: true, $negative: true, $keywords: (), $functions: (), $css-wide: false, $quoted: false) {
+  @if meta.type-of($value) == "calculation" {
+    @return null;
+  }
+  @if meta.type-of($value) == "list" and list.length($value) > 1 {
+    @return "it is several values where one length is meant";
+  }
+  @if meta.type-of($value) == "number" {
+    @if math.is-unitless($value) {
+      @if $value == 0 {
+        @return null;
+      }
+      @return "a unitless number is not a length; add a unit, such as `#{$value}px`";
+    }
+    @if math.unit($value) == "%" and not $percent {
+      @return "a percentage does not work here";
+    }
+    @if not isConditionValue($value, "length-percentage") {
+      @return "`#{math.unit($value)}` is not a length unit";
+    }
+    @if not $negative and $value < 0 {
+      @return "a length below zero does not work here";
+    }
+    @return null;
+  }
+  @if meta.type-of($value) != "string" {
+    @return "it is not a length";
+  }
+  $kind: "length";
+  @if $percent {
+    $kind: "length-percentage";
+  }
+  @if string.slice(meta.inspect($value), 1, 1) == "\"" {
+    @if $quoted and isConditionValue($value, $kind) {
+      @return null;
+    }
+    @return "a length in quotes is text here; write it without quotes";
+  }
+  $lower: string.to-lower-case($value);
+  $open: string.index($lower, "(");
+  @if $open {
+    $name: string.slice($lower, 1, $open - 1);
+    @if list.index($-functions, $name) or list.index($functions, $name) {
+      @return null;
+    }
+    @return "`#{$name}()` does not give a length here";
+  }
+  @if string.index($lower, " ") {
+    @return "it is several values where one length is meant";
+  }
+  // Interpolation, such as `#{$n}px`, gives an unquoted string rather than a
+  // number, and it is written into the CSS as it reads, so its content decides.
+  @if isConditionValue($value, $kind) {
+    @if not $negative and string.index($lower, "-") == 1 {
+      @return "a length below zero does not work here";
+    }
+    @return null;
+  }
+  @if string.index($lower, "%") and isConditionValue($value, "length-percentage") {
+    @return "a percentage does not work here";
+  }
+  @if list.index($keywords, $lower) {
+    @return null;
+  }
+  @if list.index($-css-wide, $lower) {
+    @if $css-wide {
+      @return null;
+    }
+    @return "a CSS-wide keyword only works as a whole declaration, not here";
+  }
+  @if list.length($keywords) > 0 {
+    @return "it is not a length or one of: #{list.join($keywords, (), $separator: comma)}";
+  }
+  @return "it is not a length";
+}
+
+// lengthProblem for a width or height, and for max-width with $max. Measured in
+// Chrome 152: width and height keep the intrinsic keywords, stretch,
+// -webkit-fill-available, anchor-size(), calc-size() and a CSS-wide keyword;
+// max-width keeps none where width keeps auto, and drops calc-size(). Both drop
+// a negative length. -moz-available is Firefox's spelling of stretch; Chrome
+// drops it, and it is let through like the other vendor keywords.
+//
+// null is accepted, since Sass leaves the declaration out, as it always has.
+@function sizeProblem($value, $max: false) {
+  @if $value == null {
+    @return null;
+  }
+  $keywords: "min-content" "max-content" "fit-content" "stretch" "-webkit-fill-available" "-moz-available";
+  @if $max {
+    @return lengthProblem($value, $negative: false, $keywords: list.append($keywords, "none"), $functions: ("anchor-size",), $css-wide: true);
+  }
+  @return lengthProblem($value, $negative: false, $keywords: list.append($keywords, "auto"), $functions: "anchor-size" "calc-size", $css-wide: true);
+}

data/scss/internal/_sibling-index.scss

@@ -0,0 +1,51 @@
+@charset "UTF-8";
+
+@use "sass:math";
+@use "sass:meta";
+
+// Shared by the mixins and not public API; see _is-css-function.scss.
+
+// Returns what is wrong with $value as a sibling position for `only` or
+// `except`, or null when it is a whole number other than 0. Measured in Chrome
+// 152 on six siblings:
+//
+// - a number with any unit or a fraction, `:nth-of-type(10deg)`,
+//   `:nth-of-type(10px)`, `:nth-of-type(1.5)`, is an invalid selector, and the
+//   browser drops the whole rule. In a selector list that takes every other
+//   selector with it: `.a:nth-of-type(1), .a:nth-of-type(10deg)` was dropped.
+// - `:nth-of-type(0)` is valid and matched none of the six, and
+//   `:not(:nth-of-type(0))` matched all six, since positions count from 1.
+// - a negative number, `+3` and `99999` were kept; `only` and `except` turn a
+//   negative position into :nth-last-of-type.
+//
+// $several is true when the value is one of several arguments, where only
+// positions are taken; alone, a word is a keyword or a selector.
+@function siblingIndexProblem($value, $mixin, $several: false) {
+  @if meta.type-of($value) != "number" {
+    @if $several {
+      @return "several arguments are all positions, whole numbers such as `1` or `-2`. Pass a keyword such as `first`, or a selector such as `.foo`, on its own";
+    }
+    @return null;
+  }
+  // A multiple of n, such as `3n`, reaches here as a number whose unit is n.
+  // Measured in Chrome 152, :nth-of-type(3n) is valid and matched two of six
+  // siblings, and main compiled only(3n) to it, so it is accepted. Its
+  // coefficient is checked like a position: `1.5n` was dropped and `0n`
+  // matched nothing.
+  $coefficient: $value;
+  @if math.unit($value) == "n" {
+    $coefficient: math.div($value, 1n);
+  } @else if not math.is-unitless($value) {
+    @return "a position is a whole number such as `2`, or a multiple of n such as `3n`, and `:nth-of-type(#{math.abs($value)})` is an invalid selector, so the browser would drop the rule. Pass a number such as `2`, or `-2` to count from the end";
+  }
+  @if math.round($coefficient) != $coefficient {
+    @return "a position is a whole number, and `:nth-of-type(#{math.abs($value)})` is an invalid selector, so the browser would drop the rule. Pass a number such as `2`, or `-2` to count from the end";
+  }
+  @if $coefficient == 0 {
+    @if $mixin == "except" {
+      @return "positions count from 1, so `:not(:nth-of-type(0))` excludes nothing. Pass `1` for the first, or `-1` for the last";
+    }
+    @return "positions count from 1, so `:nth-of-type(0)` matches nothing. Pass `1` for the first, or `-1` for the last";
+  }
+  @return null;
+}

data/scss/internal/_words.scss

@@ -0,0 +1,35 @@
+@charset "UTF-8";
+
+@use "sass:list";
+@use "sass:meta";
+@use "sass:string";
+
+// Shared by the mixins and not public API; see _is-css-function.scss.
+
+// The words of a value, as a space-separated list. A quoted string such as
+// "block flow-root" is split on its spaces, the way the browser reads it once
+// the quotes are gone; a space-separated list gives its items; anything else is
+// one word. Empty words from repeated spaces are skipped.
+@function wordsOf($value) {
+  @if meta.type-of($value) == "list" and list.separator($value) != "comma" {
+    @return $value;
+  }
+  @if meta.type-of($value) != "string" {
+    @return ($value,);
+  }
+  $words: ();
+  $rest: $value;
+  $at: string.index($rest, " ");
+  @while $at {
+    $word: string.slice($rest, 1, $at - 1);
+    @if string.length($word) > 0 {
+      $words: list.append($words, $word);
+    }
+    $rest: string.slice($rest, $at + 1);
+    $at: string.index($rest, " ");
+  }
+  @if string.length($rest) > 0 {
+    $words: list.append($words, $rest);
+  }
+  @return $words;
+}

data/scss/library/_adaptive.scss

@@ -0,0 +1,31 @@
+@charset "UTF-8";
+
+@use "sass:map";
+@use "sass:math";
+@use "sass:meta";
+@use "sass:string";
+@use "../maps/map-for-breakpoints" as *;
+@use "../internal/length-problem" as *;
+
+@mixin adaptive($gutter: 30px) {
+  // The gutter is subtracted twice inside calc(), which in Chrome 152 kept a
+  // length, a percentage, a negative length and var(), and dropped the
+  // max-width for a word, a CSS-wide keyword, a unitless number and a unit that
+  // is not a length. A quoted length works, since it is interpolated.
+  $problem: lengthProblem($gutter, $functions: ("anchor-size",), $quoted: true);
+  @if $problem {
+    @error "`#{meta.inspect($gutter)}` is not a valid $gutter for `adaptive`: #{$problem}. A browser drops the max-width at every breakpoint.";
+  }
+  // A unitless 0 made `calc(576px - 0 * 2)`, a length minus a number, which was
+  // dropped; 0px is kept.
+  @if (meta.type-of($gutter) == "number" and math.is-unitless($gutter)) or (meta.type-of($gutter) == "string" and string.unquote($gutter) == string.unquote("0")) {
+    $gutter: 0px;
+  }
+  $actual-breakpoints: map.remove($map-for-breakpoints, "xsmall");
+  margin: 0 auto;
+  @each $item, $value in $actual-breakpoints {
+    @media (min-width: #{$value}) {
+      max-width: calc(#{$value} - (#{$gutter} * 2));
+    }
+  }
+}

data/scss/library/_after.scss

@@ -0,0 +1,28 @@
+@charset "UTF-8";
+
+@use "sass:meta";
+@use "sass:string";
+@use "../internal/is-css-function" as *;
+
+@mixin after($content: null) {
+  &::after {
+    @if $content == null {
+      @content;
+    } @else if meta.type-of($content) != "string" {
+      @error "`#{$content}` is not a valid $content for `after`. Pass a string to use as the content value, a data- attribute name such as `\"data-label\"` to render it with attr(), or no argument at all and write the content yourself.";
+    } @else if isCssFunction($content, "var" "attr" "counter" "counters") {
+      // Quoting would turn the call into text: content: "var(--label)".
+      content: $content;
+      @content;
+    } @else {
+      $data: string.slice($content, 1, 5);
+      @if $data == "data-" {
+        content: attr(#{$content});
+        @content;
+      } @else {
+        content: "#{$content}";
+        @content;
+      }
+    }
+  }
+}

data/scss/library/_all-buttons.scss

@@ -0,0 +1,21 @@
+@charset "UTF-8";
+
+@use "sass:list";
+@use "../lists/list-of-buttons" as *;
+@use "../utilities/pseudo-selector" as *;
+
+@mixin all-buttons($pseudo: null) {
+  $list: "hover", "focus", "active", "disabled";
+  @if not $pseudo {
+    #{$list-of-buttons} {
+      @content;
+    }   
+  } @else if list.index($list, $pseudo) {
+    $all-buttons: pseudoSelector($list-of-buttons, $pseudo);
+    #{$all-buttons} {
+      @content;
+    }
+  } @else {
+    @error "The argument must be `null` or one of the followings: #{$list}.";
+  }
+}

data/scss/library/_all-text-inputs.scss

@@ -0,0 +1,21 @@
+@charset "UTF-8";
+
+@use "sass:list";
+@use "../lists/list-of-text-inputs" as *;
+@use "../utilities/pseudo-selector" as *;
+
+@mixin all-text-inputs($pseudo: null) {
+  $list: "hover", "focus", "focus-visible", "active", "invalid", "user-invalid", "required", "disabled";
+  @if not $pseudo {
+    #{$list-of-text-inputs} {
+      @content;
+    }
+  } @else if list.index($list, $pseudo) {
+    $all-text-inputs: pseudoSelector($list-of-text-inputs, $pseudo);
+    #{$all-text-inputs} {
+      @content;
+    }
+  } @else {
+    @error "The argument must be `null` or one of the followings: #{$list}";
+  }
+}

data/{core → scss}/library/_antialias.scss

@@ -1,6 +1,6 @@
 @charset "UTF-8";
 
-@mixin gorillass-antialias($value: null) {
+@mixin antialias($value: null) {
   @if not & and $value == null {
     *,
     *::before,
@@ -25,5 +25,9 @@
       -webkit-font-smoothing: antialiased;
       -moz-osx-font-smoothing: grayscale;
     }
+  } @else if not & and $value == "only" {
+    @error "`only` has no meaning at the root of a stylesheet, because there is no selector to limit the effect to. Call `antialias(\"only\")` inside a selector, or pass no argument at all.";
+  } @else {
+    @error "`#{$value}` is not a valid argument for `antialias`. Pass `\"only\"` inside a selector to affect just that element, or pass no argument at all.";
   }
 }

data/scss/library/_aspect-ratio.scss

@@ -0,0 +1,27 @@
+@charset "UTF-8";
+
+@use "sass:list";
+@use "../utilities/validate-ratio" as *;
+
+// Holds an element to a ratio, and closes the three gaps CSS leaves open when
+// you set `aspect-ratio` by hand. All three were measured in a browser:
+//
+//   * an <img> with a ratio but no `object-fit` is stretched, not cropped;
+//   * an <iframe> carries a 2px default border, so `width: 100%` overflows its
+//     container by 4px;
+//   * the ratio belongs on the element itself. On a wrapper it does nothing for
+//     an <iframe> inside, which keeps its intrinsic 300x150.
+//
+// Pass `null` as $fit to leave `object-fit` alone.
+@mixin aspect-ratio($ratio: null, $fit: cover) {
+  @if $fit and not list.index("fill" "contain" "cover" "none" "scale-down", $fit) {
+    @error "`#{$fit}` is not a valid $fit for `aspect-ratio`. Pass one of: fill, contain, cover, none, scale-down, or null to leave object-fit alone.";
+  }
+  display: block;
+  width: 100%;
+  aspect-ratio: validateRatio($ratio);
+  border: 0;
+  @if $fit {
+    object-fit: $fit;
+  }
+}

data/scss/library/_background-dots.scss

@@ -0,0 +1,104 @@
+@charset "UTF-8";
+
+@use "sass:list";
+@use "sass:meta";
+@use "sass:string";
+@use "../internal/is-size" as *;
+@use "../internal/image-value" as *;
+@use "../internal/color-problem" as *;
+@use "../internal/length-problem" as *;
+@use "../internal/gradient" as *;
+
+@mixin background-dots(
+  $color: null,
+  $size: 1em,
+  $gutter: null,
+  $diagonal: true,
+  $image: null
+) {
+  // The gutter defaults to five times the size. Deriving it here rather than in
+  // the signature lets $size be checked first, and doing the arithmetic in
+  // calc() lets var() and clamp() through: Sass simplifies calc() on plain
+  // numbers back to a number, so a call with lengths emits the same CSS.
+  @if not isSize($size) {
+    @error "`#{meta.inspect($size)}` is not a valid $size for `background-dots`. Pass a length, or var(), env() or a calculation such as `clamp()`.";
+  }
+  @if $gutter == null {
+    $gutter: calc($size * 5);
+  }
+  @if not isSize($gutter) {
+    @error "`#{meta.inspect($gutter)}` is not a valid $gutter for `background-dots`. Pass a length, or var(), env() or a calculation such as `calc()`.";
+  }
+  // isSize takes any number, since it only guards the arithmetic. The size is a
+  // colour stop's position and the gutter a background-size, which in Chrome
+  // 152 kept a percentage and dropped a negative length, a unitless number
+  // other than 0 and a unit that is not a length, so no dots were drawn.
+  @each $name, $value in ("$size": $size, "$gutter": $gutter) {
+    $problem: lengthProblem($value, $negative: false);
+    @if $problem {
+      @error "`#{meta.inspect($value)}` is not a valid #{$name} for `background-dots`: #{$problem}. A browser drops the pattern.";
+    }
+  }
+  @if $image != null and meta.type-of($image) != "string" {
+    @error "`#{$image}` is not a valid $image for `background-dots`. Pass an image path as a string.";
+  }
+  @if $diagonal != true and $diagonal != false {
+    @error "`#{$diagonal}` is not a valid $diagonal for `background-dots`. Pass `true` or `false`.";
+  }
+  // Each colour goes into a radial gradient as `radial-gradient($color $size,
+  // ...)`. Measured in Chrome 152, a word or a quoted colour there drops the
+  // gradient, and a length is read as the gradient's size instead, so neither
+  // draws the dots meant; see scss/internal/_color-problem.scss.
+  @if $color != null {
+    @each $item in $color {
+      $problem: colorProblem($item);
+      @if $problem {
+        @error "`#{meta.inspect($item)}` is not a valid colour in $color for `background-dots`: #{$problem}. Pass one colour, or two for the diagonal variant, such as `red` or `var(--dot)`.";
+      }
+    }
+  }
+  @if not $color {
+    $color: rgba(0, 0, 0, 0.1);
+    @if $diagonal == true {
+      background-image: gradientOf(($color $size, transparent 0), radial, $member: "background-dots"),
+        gradientOf(($color $size, transparent 0), radial, $member: "background-dots");
+      background-position: calc($gutter / 2) calc($gutter / 2),
+        calc($gutter * 2) calc($gutter * 2);
+    } @else if $diagonal == false {
+      background-image: gradientOf(($color $size, transparent 0), radial, $member: "background-dots");
+      background-position: calc($gutter / 2) calc($gutter / 2);
+    }
+  } @else if $color {
+    @if $diagonal == true {
+      background-image: gradientOf((list.nth($color, 1) $size, transparent 0), radial, $member: "background-dots"),
+        gradientOf((list.nth($color, list.length($color)) $size, transparent 0), radial, $member: "background-dots");
+      background-position: calc($gutter / 2) calc($gutter / 2),
+        calc($gutter * 2) calc($gutter * 2);
+    } @else if $diagonal == false {
+      background-image: gradientOf((list.nth($color, 1) $size, transparent 0), radial, $member: "background-dots");
+      background-position: calc($gutter / 2) calc($gutter / 2);
+      @if list.length($color) > 1 {
+        @error "Please do not pass more than one argument when you disable 'diagonal' property! Simply remove the argument(s) after '#{list.nth($color, 1)}' to resolve the problem.";
+      }
+    }
+  }
+  background-size: $gutter $gutter;
+  background-repeat: repeat;
+  @if $image {
+    position: relative;
+    &::before {
+      content: "";
+      display: block;
+      position: absolute;
+      width: 100%;
+      height: 100%;
+      top: 0;
+      left: 0;
+      background-image: imageValue($image, "background-dots", "$image", $unquote: true);
+      background-repeat: no-repeat;
+      background-position: center;
+      background-size: cover;
+      z-index: -1;
+    }
+  }
+}

data/scss/library/_background-image.scss

@@ -0,0 +1,89 @@
+@charset "UTF-8";
+
+@use "sass:list";
+@use "sass:map";
+@use "sass:math";
+@use "sass:meta";
+@use "../maps/map-for-directions" as *;
+@use "../internal/image-value" as *;
+@use "../internal/color-problem" as *;
+@use "../internal/color-stops-problem" as *;
+@use "../internal/gradient" as *;
+@use "../internal/is-css-function" as *;
+
+@mixin background-image(
+  $image-url: null,
+  $filter-color: null,
+  $filter-direction: null
+) {
+  // The direction used to be read only when there were two or more colours,
+  // so with one colour any value was dropped without a word, a typo included.
+  // Check it first, against what the gradient branches accept.
+  @if $filter-direction and gradientDirection($filter-direction) == null {
+    @error "`#{meta.inspect($filter-direction)}` is not a valid $filter-direction for `background-image`. Pass an angle such as `45deg` or `0.25turn`, `\"to top right\"`, or one of: #{map.keys($map-for-directions)}.";
+  }
+  // One filter colour is written into `linear-gradient(to top, $c, $c)` over an
+  // image, or into `background` when there is none; several are the stops of a
+  // gradient. Measured in Chrome 152, a word or a quoted colour drops either, and
+  // a length in `background` is read as a position, so none of them is a filter.
+  // CSS-wide keywords are refused, since they drop the gradient.
+  // With no $image-url the image sits in the markup and the filter is written
+  // as an ::after layer's `background`, where an image is as valid as a colour.
+  // Measured in Chrome 152 over an image in a style attribute, a
+  // linear-gradient drew a scrim, a radial-gradient a vignette and url() a
+  // pattern, so those are accepted there. `inherit` drew the same image over
+  // itself and `10px` an empty layer, so they stay refused. With an image the
+  // filter goes inside linear-gradient(), where a gradient dropped the whole
+  // declaration, image included.
+  // paint(), image() and -webkit-cross-fade() were kept as images in Chrome 152;
+  // cross-fade(), element() and -moz-element() are in the specification or other
+  // engines and are let through on the same grounds.
+  $overlay-image: not $image-url and isCssFunction($filter-color, "url" "image-set" "var" "linear-gradient" "radial-gradient" "conic-gradient" "repeating-linear-gradient" "repeating-radial-gradient" "repeating-conic-gradient" "paint" "image" "cross-fade" "-webkit-cross-fade" "element" "-moz-element");
+  @if $filter-color != null and not $overlay-image {
+    $problem: null;
+    @if list.length($filter-color) == 1 {
+      $problem: colorProblem($filter-color);
+    } @else {
+      $problem: colorStopsProblem($filter-color);
+    }
+    @if $problem {
+      @error "`#{meta.inspect($filter-color)}` is not a valid $filter-color for `background-image`: #{$problem}. Pass a colour, such as `rgba(0, 0, 0, 0.5)`, or several for a gradient.";
+    }
+  }
+  @if $image-url {
+    @if $filter-color {
+      @if list.length($filter-color) == 1 {
+        background-image: linear-gradient(to top, $filter-color, $filter-color),
+          imageValue($image-url, "background-image", "$image-url");
+      } @else if list.length($filter-color) > 1 {
+        background-image: gradientOf($filter-color, linear, $filter-direction or "top", $member: "background-image", $colors-name: "$filter-color", $direction-name: "$filter-direction"),
+          imageValue($image-url, "background-image", "$image-url");
+      }
+    } @else {
+      background-image: imageValue($image-url, "background-image", "$image-url");
+    }
+  } @else {
+    position: relative;
+    &::after {
+      content: "";
+      display: block;
+      position: absolute;
+      left: 0;
+      top: 0;
+      width: 100%;
+      height: 100%;
+      @if list.length($filter-color) == 1 {
+        background: $filter-color;
+      } @else if list.length($filter-color) > 1 {
+        background: gradientOf($filter-color, linear, $filter-direction or "top", $member: "background-image", $colors-name: "$filter-color", $direction-name: "$filter-direction");
+      }
+    }
+    & > * {
+      position: relative;
+      z-index: 1;
+    }
+  }
+  background-position: center center;
+  background-repeat: no-repeat;
+  background-size: cover;
+}