gerillass 2.0.1 → 2.1.1

package/gerillass.json

@@ -1,6 +1,6 @@
 {
   "name": "gerillass",
-  "version": "2.0.1",
+  "version": "2.1.1",
   "description": "Gerillass is an open-source toolkit that contains a set of Sass mixins to help designers and developers to create better, faster and consistent user interfaces.",
   "homepage": "https://gerillass.com",
   "documentation": "https://docs.gerillass.com",
@@ -42,17 +42,23 @@
           "accepts": [
             "a string used as the content value",
             "a data- attribute name, rendered as attr()",
-            "null to write content yourself"
+            "null to write content yourself",
+            "var(), attr(), counter() or counters(), written as they are"
           ]
         }
       ],
       "file": "scss/library/_after.scss",
       "signature": "after($content: null)",
       "summary": "Styles the ::after pseudo-element. A `data-` argument becomes an attr() content value.",
+      "caveats": [
+        "With no argument no `content` is emitted, so the pseudo-element does not render unless the block sets `content`. Pass `\"\"` for an empty one."
+      ],
       "examples": [
         ".a { @include after(\"→\") { color: red; } }",
         ".a { @include after(\"data-label\") { color: red; } }",
-        ".a { @include after { content: \"x\"; } }"
+        ".a { @include after { content: \"x\"; } }",
+        ".a { @include after(var(--label)) { color: red; } }",
+        ".a { @include after(attr(data-label)) { color: red; } }"
       ],
       "rejects": [
         ".a { @include after(42) { color: red; } }",
@@ -151,7 +157,8 @@
             "a slash separated string, such as \"16/9\"",
             "a colon separated string, such as \"16:9\"",
             "a number, where 1.5 means 1.5 / 1",
-            "null for the 16/9 default"
+            "null for the 16/9 default",
+            "var(), written as it is"
           ]
         },
         {
@@ -170,17 +177,22 @@
       "file": "scss/library/_aspect-ratio.scss",
       "signature": "aspect-ratio($ratio: null, $fit: cover)",
       "summary": "Holds an element to a ratio and adds what CSS aspect-ratio alone leaves out: object-fit so an image is cropped rather than stretched, and border: 0 so an iframe does not overflow its container by 4px. Apply it to the element itself, not to a wrapper.",
+      "caveats": [
+        "On an element with a `height` attribute, such as `<img width=\"1600\" height=\"900\">` or an embed code's `<iframe>`, the attribute height wins and the ratio is ignored. Write `height: auto` after the include."
+      ],
       "examples": [
         ".thumb { @include aspect-ratio(\"16:9\"); }",
         ".video { @include aspect-ratio(\"16/9\"); }",
         ".tile { @include aspect-ratio(\"1:1\", contain); }",
         ".plain { @include aspect-ratio(1.5, null); }",
-        ".default { @include aspect-ratio; }"
+        ".default { @include aspect-ratio; }",
+        ".a { @include aspect-ratio(var(--ratio)); }"
       ],
       "rejects": [
         ".thumb { @include aspect-ratio(\"16:9\", nonsense); }",
         ".thumb { @include aspect-ratio(16 9); }",
-        ".thumb { @include aspect-ratio(\"sixteen/nine\"); }"
+        ".thumb { @include aspect-ratio(\"sixteen/nine\"); }",
+        ".a { @include aspect-ratio(url(a.png)); }"
       ]
     },
     {
@@ -199,14 +211,15 @@
           "name": "$size",
           "default": "1em",
           "accepts": [
-            "dot radius"
+            "dot radius: a length, or var(), env() or a calculation such as calc() or clamp()"
           ]
         },
         {
           "name": "$gutter",
-          "default": "$size * 5",
+          "default": "null",
           "accepts": [
-            "spacing between dots"
+            "spacing between dots, in the same forms as $size",
+            "null, the default, for five times $size"
           ]
         },
         {
@@ -221,21 +234,27 @@
           "name": "$image",
           "default": "null",
           "accepts": [
-            "an image path to sit behind the dots"
+            "an image path to sit behind the dots",
+            "var(), url(), image-set() or a gradient, written as they are rather than wrapped in url()"
           ]
         }
       ],
       "file": "scss/library/_background-dots.scss",
-      "signature": "background-dots($color: null, $size: 1em, $gutter: $size * 5, $diagonal: true, $image: null)",
+      "signature": "background-dots($color: null, $size: 1em, $gutter: null, $diagonal: true, $image: null)",
       "summary": "Repeating dot pattern as a background, optionally over an image.",
       "examples": [
         ".a { @include background-dots; }",
         ".a { @include background-dots(red); }",
-        ".a { @include background-dots(red, 1em, 5em, false); }"
+        ".a { @include background-dots(red, 1em, 5em, false); }",
+        ".a { @include background-dots(red, var(--dot), calc(var(--dot) * 6)); }",
+        ".a { @include background-dots(red, clamp(2px, 0.5vw, 6px)); }",
+        ".a { @include background-dots(red, $image: var(--photo)); }"
       ],
       "rejects": [
         ".a { @include background-dots(red, 1em, 5em, maybe); }",
-        ".a { @include background-dots(red, 1em, 5em, true, 42); }"
+        ".a { @include background-dots(red, 1em, 5em, true, 42); }",
+        ".a { @include background-dots(red, nonsense); }",
+        ".a { @include background-dots(red, 1em, nonsense); }"
       ]
     },
     {
@@ -247,7 +266,8 @@
           "default": "null",
           "accepts": [
             "an image path",
-            "null to filter the element itself instead"
+            "null to filter the element itself instead",
+            "var(), url(), image-set() or a gradient, written as they are rather than wrapped in url()"
           ]
         },
         {
@@ -272,10 +292,14 @@
       "examples": [
         ".a { @include background-image(\"/img/a.png\"); }",
         ".a { @include background-image(\"/img/a.png\", rgba(0,0,0,0.5)); }",
-        ".a { @include background-image(\"/img/a.png\", (red, blue), \"top\"); }"
+        ".a { @include background-image(\"/img/a.png\", (red, blue), \"top\"); }",
+        ".a { @include background-image(var(--hero), rgba(0,0,0,0.5)); }",
+        ".a { @include background-image(image-set(\"/img/a.png\" 1x, \"/img/a@2x.png\" 2x)); }"
       ],
       "rejects": [
-        ".a { @include background-image(\"/img/a.png\", (red, blue), sideways); }"
+        ".a { @include background-image(\"/img/a.png\", (red, blue), sideways); }",
+        ".a { @include background-image(\"/img/a.png\", rgba(0,0,0,0.5), sideways); }",
+        ".a { @include background-image(null, rgba(0,0,0,0.5), sideways); }"
       ]
     },
     {
@@ -294,7 +318,7 @@
           "name": "$thickness",
           "default": "1em",
           "accepts": [
-            "stripe thickness"
+            "stripe thickness: a length, or var(), env() or a calculation such as calc() or clamp()"
           ]
         },
         {
@@ -308,7 +332,8 @@
           "name": "$image",
           "default": "null",
           "accepts": [
-            "an image path to sit behind the stripes"
+            "an image path to sit behind the stripes",
+            "var(), url(), image-set() or a gradient, written as they are rather than wrapped in url()"
           ]
         }
       ],
@@ -317,11 +342,14 @@
       "summary": "Repeating stripe pattern as a background, optionally over an image.",
       "examples": [
         ".a { @include background-stripes; }",
-        ".a { @include background-stripes(red, 2em, -30deg); }"
+        ".a { @include background-stripes(red, 2em, -30deg); }",
+        ".a { @include background-stripes(red blue, var(--stripe)); }",
+        ".a { @include background-stripes(red, 2em, -30deg, var(--photo)); }"
       ],
       "rejects": [
         ".a { @include background-stripes(red, 2em, nonsense); }",
-        ".a { @include background-stripes(red, 2em, -45deg, 42); }"
+        ".a { @include background-stripes(red, 2em, -45deg, 42); }",
+        ".a { @include background-stripes(red, nonsense); }"
       ]
     },
     {
@@ -334,16 +362,21 @@
           "accepts": [
             "a string used as the content value",
             "a data- attribute name, rendered as attr()",
-            "null to write content yourself"
+            "null to write content yourself",
+            "var(), attr(), counter() or counters(), written as they are"
           ]
         }
       ],
       "file": "scss/library/_before.scss",
       "signature": "before($content: null)",
       "summary": "Styles the ::before pseudo-element. A `data-` argument becomes an attr() content value.",
+      "caveats": [
+        "With no argument no `content` is emitted, so the pseudo-element does not render unless the block sets `content`. Pass `\"\"` for an empty one."
+      ],
       "examples": [
         ".a { @include before(\"→\") { color: red; } }",
-        ".a { @include before(\"data-label\") { color: red; } }"
+        ".a { @include before(\"data-label\") { color: red; } }",
+        ".a { @include before(var(--label)) { color: red; } }"
       ],
       "rejects": [
         ".a { @include before(42) { color: red; } }"
@@ -423,7 +456,8 @@
           "name": "$image-url",
           "default": "null",
           "accepts": [
-            "an image path"
+            "an image path",
+            "var(), url(), image-set() or a gradient, written as they are rather than wrapped in url()"
           ]
         }
       ],
@@ -431,7 +465,8 @@
       "signature": "brand-logo($width, $height, $image-url: null)",
       "summary": "Logo box with an image and an accessible stretched link over it.",
       "examples": [
-        ".logo { @include brand-logo(120px, 40px, \"/img/logo.svg\"); }"
+        ".logo { @include brand-logo(120px, 40px, \"/img/logo.svg\"); }",
+        ".logo { @include brand-logo(120px, 40px, var(--logo)); }"
       ],
       "rejects": []
     },
@@ -453,12 +488,21 @@
       "file": "scss/library/_breakpoint.scss",
       "signature": "breakpoint($params...)",
       "summary": "Media query built from the breakpoint map, or from raw lengths.",
+      "caveats": [
+        "With one argument the query matches exactly that width, `(width: 768px)`, which is a single pixel. Use `min`, `max` or a range for anything wider.",
+        "Declarations written after the include, in the same rule, are emitted after the `@media` block and win over it. Write them before the include."
+      ],
       "examples": [
         ".a { @include breakpoint(\"medium\") { color: red; } }",
         ".a { @include breakpoint(\"min\", \"medium\") { color: red; } }",
         ".a { @include breakpoint(\"between\", \"medium\" \"large\") { color: red; } }"
       ],
-      "rejects": []
+      "rejects": [
+        ".a { @include breakpoint(\"between\", \"medium\", \"large\") { color: red; } }",
+        ".a { @include breakpoint() { color: red; } }",
+        ".a { @include breakpoint(\"min\", var(--wide)) { color: red; } }",
+        ".a { @include breakpoint(\"between\", var(--start) \"large\") { color: red; } }"
+      ]
     },
     {
       "name": "breakpointer",
@@ -571,6 +615,76 @@
         ".grid { @include columnizer(3, nonsense); }"
       ]
     },
+    {
+      "name": "container-query",
+      "kind": "mixin",
+      "arguments": [
+        {
+          "name": "$params",
+          "variadic": true,
+          "accepts": [
+            "a size",
+            "two sizes for a range",
+            "one of min, max, only or between followed by a size",
+            "$name as a keyword, to query one named container"
+          ]
+        }
+      ],
+      "file": "scss/library/_container-query.scss",
+      "signature": "container-query($params...)",
+      "summary": "A @container rule, taking the same argument shapes as breakpoint so the two read alike. Sizes may be a key from $map-for-breakpoints or a raw length, and a length is the common case because a container is usually narrower than the viewport. Nothing matches at all unless an ancestor was declared with the container mixin.",
+      "examples": [
+        ".title { @include container-query(\"min\", 400px) { font-size: 2rem; } }",
+        ".title { @include container-query(\"max\", 399px) { font-size: 1rem; } }",
+        ".title { @include container-query(\"between\", 300px 500px) { color: red; } }",
+        ".title { @include container-query(300px, 500px) { color: red; } }",
+        ".title { @include container-query(\"min\", \"medium\") { color: red; } }",
+        ".title { @include container-query(\"min\", 400px, $name: \"card\") { color: red; } }"
+      ],
+      "rejects": [
+        ".title { @include container-query(\"min\", 400px, 800px) { color: red; } }",
+        ".title { @include container-query(\"min\", 400px, $name: 42) { color: red; } }",
+        ".title { @include container-query(\"min\", var(--wide)) { color: red; } }"
+      ]
+    },
+    {
+      "name": "container",
+      "kind": "mixin",
+      "arguments": [
+        {
+          "name": "$name",
+          "default": "null",
+          "accepts": [
+            "a container name as a string, such as \"card\"",
+            "null for an unnamed container"
+          ]
+        },
+        {
+          "name": "$type",
+          "default": "inline-size",
+          "accepts": [
+            "inline-size",
+            "size",
+            "normal"
+          ]
+        }
+      ],
+      "file": "scss/library/_container.scss",
+      "signature": "container($name: null, $type: inline-size)",
+      "summary": "Marks an element as a query container, so container-query can ask about its width instead of the viewport's. The rule that asks has to sit on a descendant: an element is never matched by a @container rule reading its own container, and nothing warns you when it is not.",
+      "caveats": [
+        "An element does not match a `@container` query that reads its own container, and nothing warns. Put the `container-query` on a descendant."
+      ],
+      "examples": [
+        ".card { @include container(\"card\"); }",
+        ".panel { @include container; }",
+        ".panel { @include container(null, size); }"
+      ],
+      "rejects": [
+        ".card { @include container(\"card\", sideways); }",
+        ".card { @include container(42); }"
+      ]
+    },
     {
       "name": "counter",
       "kind": "mixin",
@@ -581,17 +695,22 @@
           "accepts": [
             "a counter style name",
             "a prefix and/or suffix string",
-            "a prefix, a counter style and a suffix"
+            "a prefix, a counter style and a suffix",
+            "var(), attr(), counter() or counters() in place of a prefix or suffix, written as they are"
           ]
         }
       ],
       "file": "scss/library/_counter.scss",
       "signature": "counter($params...)",
       "summary": "CSS counter for a list, with optional text before and after the number.",
+      "caveats": [
+        "Numbering restarts on every item, each showing the first number, when the items are size containers (`container-type: inline-size`): containment scopes counters to each item."
+      ],
       "examples": [
         ".list { @include counter(\"decimal\"); }",
         ".list { @include counter(\".\"); }",
-        ".list { @include counter(\"(\", \"decimal\", \")\"); }"
+        ".list { @include counter(\"(\", \"decimal\", \")\"); }",
+        ".list { @include counter(var(--prefix), \"decimal\"); }"
       ],
       "rejects": []
     },
@@ -722,7 +841,11 @@
       "rejects": [
         ".a { @include font-face(\"Inter\", \"/fonts/inter\"); }",
         "@include font-face(42, \"/fonts/x\");",
-        "@include font-face(\"Inter\", 42);"
+        "@include font-face(\"Inter\", 42);",
+        "@include font-face(\"Inter\", \"/fonts/inter\", $file-formats: otf);",
+        "@include font-face(\"Inter\", \"/fonts/inter\", $file-formats: woff2 wof);",
+        "@include font-face(\"Inter\", \"/fonts/inter\", $file-formats: null);",
+        "@include font-face(\"Inter\", var(--font-path));"
       ]
     },
     {
@@ -749,6 +872,38 @@
         ".a { @include hide(nonsense); }"
       ]
     },
+    {
+      "name": "line-clamp",
+      "kind": "mixin",
+      "arguments": [
+        {
+          "name": "$lines",
+          "default": "3",
+          "accepts": [
+            "a whole number of lines, at least 1",
+            "none, to undo a clamp",
+            "var(), written as it is"
+          ]
+        }
+      ],
+      "file": "scss/library/_line-clamp.scss",
+      "signature": "line-clamp($lines: 3)",
+      "summary": "Truncates text after a number of lines, where ellipsis truncates one. It emits five declarations rather than one because -webkit-line-clamp does nothing on its own: without display: -webkit-box or without -webkit-box-orient: vertical the text is not clamped at all and nothing warns you, and without overflow: hidden the clamped text spills out below the box. The unprefixed line-clamp is emitted too, for when it becomes Baseline.",
+      "examples": [
+        ".excerpt { @include line-clamp(3); }",
+        ".title { @include line-clamp(2); }",
+        ".full { @include line-clamp(none); }",
+        ".default { @include line-clamp; }",
+        ".a { @include line-clamp(var(--lines)); }"
+      ],
+      "rejects": [
+        ".a { @include line-clamp(0); }",
+        ".a { @include line-clamp(2.5); }",
+        ".a { @include line-clamp(3px); }",
+        ".a { @include line-clamp(\"three\"); }",
+        ".a { @include line-clamp(url(a.png)); }"
+      ]
+    },
     {
       "name": "linear-gradient",
       "kind": "mixin",
@@ -796,7 +951,10 @@
       ],
       "file": "scss/library/_loadify.scss",
       "signature": "loadify($params...)",
-      "summary": "Fades elements in on page load. Call once at the root to set up, then on each element.",
+      "summary": "Fades elements in on page load. Call once at the root to set up, then on each element. Under prefers-reduced-motion: reduce the end state is applied directly and no animation runs. Switching the animation off alone would not do, because the element starts invisible and the animation is what reveals it, so the content would stay hidden for good.",
+      "caveats": [
+        "`init` and every call must be in the same module, or the module with the call must `@use` the one that calls `init`. Otherwise Sass fails with \"The target selector was not found\"."
+      ],
       "examples": [
         "@include loadify(init);\n.a { @include loadify; }",
         "@include loadify;\n.a { @include loadify(0.4s, 1s); }"
@@ -871,7 +1029,8 @@
           "name": "$offsets",
           "default": "0",
           "accepts": [
-            "one to four lengths in shorthand order, or auto/inherit/initial/0"
+            "one to four lengths in shorthand order, or auto/inherit/initial/0",
+            "null in any position to leave that edge out"
           ]
         }
       ],
@@ -880,7 +1039,9 @@
       "summary": "Sets position and offsets in one call, using shorthand order.",
       "examples": [
         ".a { @include position(absolute, 0); }",
-        ".a { @include position(fixed, 0 10px); }"
+        ".a { @include position(fixed, 0 10px); }",
+        ".a { @include position(absolute, null 16px 16px 16px); }",
+        ".a { @include position(absolute, 0 null null 0); }"
       ],
       "rejects": []
     },
@@ -931,7 +1092,7 @@
           "variadic": true,
           "accepts": [
             "nothing, to hide it always",
-            "one breakpoint",
+            "one breakpoint, for exactly that width and no other",
             "min or max plus a breakpoint",
             "a start and an end breakpoint"
           ]
@@ -939,14 +1100,20 @@
       ],
       "file": "scss/library/_remove.scss",
       "signature": "remove($params...)",
-      "summary": "Hides an element outright, or only within a breakpoint range.",
+      "summary": "Hides an element outright, or within a media query: from a breakpoint up with min, up to it with max, or between two breakpoints. One breakpoint on its own hides the element at exactly that width, a single pixel.",
+      "caveats": [
+        "With one argument the element is hidden at exactly that width, `(width: 768px)`, which is a single pixel. Use `min`, `max` or a range for anything wider.",
+        "A `display` written after the include, in the same rule, is emitted after the `@media` block and wins over it. Write it before the include."
+      ],
       "examples": [
         ".a { @include remove; }",
-        ".a { @include remove(\"medium\"); }",
-        ".a { @include remove(\"min\", \"medium\"); }"
+        ".a { @include remove(\"min\", \"medium\"); }",
+        ".a { @include remove(\"max\", \"medium\"); }",
+        ".a { @include remove(\"small\", \"large\"); }"
       ],
       "rejects": [
-        ".a { @include remove(a, b, c); }"
+        ".a { @include remove(a, b, c); }",
+        ".a { @include remove(\"max\", var(--narrow)); }"
       ]
     },
     {
@@ -1059,7 +1226,9 @@
       "examples": [
         ".a { @include screen-agent(\"2x\") { background-image: url(\"/img/a@2x.png\"); } }"
       ],
-      "rejects": []
+      "rejects": [
+        ".a { @include screen-agent(var(--density)) { color: red; } }"
+      ]
     },
     {
       "name": "sizer",
@@ -1242,7 +1411,8 @@
           "name": "$image",
           "default": "null",
           "accepts": [
-            "an image path"
+            "an image path",
+            "var(), url(), image-set() or a gradient, written as they are rather than wrapped in url()"
           ]
         }
       ],
@@ -1250,7 +1420,8 @@
       "signature": "text-image($image: null)",
       "summary": "Fills the text with an image via background-clip.",
       "examples": [
-        ".a { @include text-image(\"/img/t.png\"); }"
+        ".a { @include text-image(\"/img/t.png\"); }",
+        ".a { @include text-image(var(--texture)); }"
       ],
       "rejects": []
     },
@@ -1365,14 +1536,17 @@
           "name": "$color",
           "default": "black",
           "accepts": [
-            "any colour value"
+            "a Sass colour, such as red, #333 or oklch(70% 0.1 200)",
+            "currentColor",
+            "var(), color-mix() or light-dark(), which CSS resolves"
           ]
         },
         {
           "name": "$size",
           "default": "10px 8px",
           "accepts": [
-            "one length, or two lengths as width then height"
+            "one length, or two lengths as width then height",
+            "var(), env() or a calculation in place of any length"
           ]
         }
       ],
@@ -1381,11 +1555,17 @@
       "summary": "Draws a CSS triangle out of borders, pointing in a given direction.",
       "examples": [
         ".caret { @include triangle(\"bottom\", black, 10px 8px); }",
-        ".arrow { @include triangle(\"left\", red); }"
+        ".arrow { @include triangle(\"left\", red); }",
+        ".arrow { @include triangle(\"right\", var(--accent), 6px 8px); }",
+        ".arrow { @include triangle(\"right\", currentColor); }",
+        ".arrow { @include triangle(\"top\", color-mix(in srgb, red 50%, blue)); }",
+        ".arrow { @include triangle(\"bottom\", currentColor, var(--caret-w) var(--caret-h)); }"
       ],
       "rejects": [
         ".caret { @include triangle(sideways); }",
-        ".caret { @include triangle(\"top\", notacolor); }"
+        ".caret { @include triangle(\"top\", notacolor); }",
+        ".caret { @include triangle(\"top\", url(a.png)); }",
+        ".caret { @include triangle(\"top\", red, nonsense); }"
       ]
     },
     {
@@ -1406,7 +1586,9 @@
       "examples": [
         ".a { line-height: clearUnit(24px); }"
       ],
-      "rejects": []
+      "rejects": [
+        ".a { line-height: clearUnit(nonsense); }"
+      ]
     },
     {
       "name": "clearWhitespace",
@@ -1448,7 +1630,10 @@
       "examples": [
         ".a { margin: convertToEm(24px); }"
       ],
-      "rejects": []
+      "rejects": [
+        ".a { margin: convertToEm(nonsense); }",
+        ".a { margin: convertToEm(24); }"
+      ]
     },
     {
       "name": "convertToNumber",
@@ -1469,7 +1654,9 @@
         ".a { z-index: convertToNumber(\"42\"); }"
       ],
       "rejects": [
-        ".a { --x: #{convertToNumber(42)}; }"
+        ".a { --x: #{convertToNumber(42)}; }",
+        ".a { z-index: convertToNumber(\"4a\"); }",
+        ".a { z-index: convertToNumber(\"\"); }"
       ]
     },
     {
@@ -1509,6 +1696,55 @@
         ".a { --x: #{fillNulls(1px null, nonsense)}; }"
       ]
     },
+    {
+      "name": "fluid",
+      "kind": "function",
+      "arguments": [
+        {
+          "name": "$min",
+          "required": true,
+          "accepts": [
+            "a length in px or rem, the value at $min-viewport"
+          ]
+        },
+        {
+          "name": "$max",
+          "required": true,
+          "accepts": [
+            "a length in px or rem, the value at $max-viewport, no smaller than $min"
+          ]
+        },
+        {
+          "name": "$min-viewport",
+          "default": "320px",
+          "accepts": [
+            "a length in px or rem, the width below which the value stops shrinking"
+          ]
+        },
+        {
+          "name": "$max-viewport",
+          "default": "1280px",
+          "accepts": [
+            "a length in px or rem, larger than $min-viewport"
+          ]
+        }
+      ],
+      "file": "scss/utilities/_fluid.scss",
+      "signature": "fluid($min, $max, $min-viewport: 320px, $max-viewport: 1280px)",
+      "summary": "A clamp() value that grows with the viewport between two widths, then stops. The preferred value keeps a rem term rather than being pure vw, because a vw-only value ignores browser text zoom and fails WCAG 1.4.4. It is a function rather than a mixin because the value is the hard part and belongs to any property, not only font-size.",
+      "examples": [
+        ".title { font-size: fluid(24px, 48px); }",
+        ".title { font-size: fluid(1rem, 3rem, 320px, 1200px); }",
+        ".section { padding: fluid(16px, 64px) fluid(8px, 40px); }",
+        ".stack { gap: fluid(0.5rem, 2rem); }"
+      ],
+      "rejects": [
+        ".title { font-size: fluid(16px, 24px, 1280px, 320px); }",
+        ".title { font-size: fluid(40px, 20px); }",
+        ".title { font-size: fluid(16, 24); }",
+        ".title { font-size: fluid(1em, 2em); }"
+      ]
+    },
     {
       "name": "fontSizer",
       "kind": "function",
@@ -1534,7 +1770,10 @@
       "examples": [
         ".a { font-size: fontSizer(16px, 1.5); }"
       ],
-      "rejects": []
+      "rejects": [
+        ".a { font-size: fontSizer(nonsense, 1.5); }",
+        ".a { font-size: fontSizer(16px, 1px); }"
+      ]
     },
     {
       "name": "fontSource",
@@ -1749,7 +1988,11 @@
       "examples": [
         ".a { font-size: remify(24px); }"
       ],
-      "rejects": []
+      "rejects": [
+        ".a { font-size: remify(nonsense); }",
+        ".a { font-size: remify(1.5rem); }",
+        ".a { font-size: remify(24); }"
+      ]
     },
     {
       "name": "shade",
@@ -1777,7 +2020,8 @@
         ".a { color: shade(red, 20%); }"
       ],
       "rejects": [
-        ".a { color: shade(notacolor, 20%); }"
+        ".a { color: shade(notacolor, 20%); }",
+        ".a { color: shade(var(--x), 20%); }"
       ]
     },
     {
@@ -1828,7 +2072,8 @@
         ".a { color: tint(red, 20%); }"
       ],
       "rejects": [
-        ".a { color: tint(notacolor, 20%); }"
+        ".a { color: tint(notacolor, 20%); }",
+        ".a { color: tint(var(--x), 20%); }"
       ]
     },
     {
@@ -1859,13 +2104,14 @@
           "name": "$value",
           "required": true,
           "accepts": [
-            "a length with a unit, or auto, inherit, initial, 0"
+            "a length with a unit, or auto, inherit, initial, 0",
+            "null, returned as null without a warning"
           ]
         }
       ],
       "file": "scss/utilities/_validate-length.scss",
       "signature": "validateLength($value)",
-      "summary": "Returns the value if it is a length or one of auto, inherit, initial, 0.",
+      "summary": "Returns the value if it is a length or one of auto, inherit, initial, 0. Returns null quietly for null, so a caller can skip a value.",
       "examples": [
         ".a { width: validateLength(20px); }"
       ],
@@ -1881,7 +2127,8 @@
           "accepts": [
             "a string such as \"16/9\" or \"16:9\"",
             "a unitless number",
-            "null for the 16/9 default"
+            "null for the 16/9 default",
+            "var(), returned as it is"
           ]
         }
       ],
@@ -1890,10 +2137,12 @@
       "summary": "Turns an aspect ratio into a value for the CSS aspect-ratio property.",
       "examples": [
         ".a { aspect-ratio: validateRatio(\"16/9\"); }",
-        ".a { aspect-ratio: validateRatio(1.5); }"
+        ".a { aspect-ratio: validateRatio(1.5); }",
+        ".a { aspect-ratio: validateRatio(var(--ratio)); }"
       ],
       "rejects": [
-        ".a { aspect-ratio: validateRatio(16 9); }"
+        ".a { aspect-ratio: validateRatio(16 9); }",
+        ".a { aspect-ratio: validateRatio(\"16 / 9\"); }"
       ]
     },
     {