postcss-minify-gradients 5.0.6 → 5.1.0

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "postcss-minify-gradients",
-  "version": "5.0.6",
+  "version": "5.1.0",
   "description": "Minify gradient parameters with PostCSS.",
   "main": "src/index.js",
+  "types": "types/index.d.ts",
   "files": [
     "LICENSE-MIT",
-    "src"
+    "src",
+    "types"
   ],
   "keywords": [
     "css",
@@ -22,7 +24,7 @@
   "repository": "cssnano/cssnano",
   "dependencies": {
     "colord": "^2.9.1",
-    "cssnano-utils": "^3.0.2",
+    "cssnano-utils": "^3.1.0",
     "postcss-value-parser": "^4.2.0"
   },
   "bugs": {

package/src/index.js

@@ -10,13 +10,21 @@ const angles = {
   left: '270deg',
 };
 
+/**
+ * @param {valueParser.Dimension} a
+ * @param {valueParser.Dimension} b
+ * @return {boolean}
+ */
 function isLessThan(a, b) {
   return (
     a.unit.toLowerCase() === b.unit.toLowerCase() &&
     parseFloat(a.number) >= parseFloat(b.number)
   );
 }
-
+/**
+ * @param {import('postcss').Declaration} decl
+ * @return {void}
+ */
 function optimise(decl) {
   const value = decl.value;
 
@@ -55,10 +63,16 @@ function optimise(decl) {
           args[0].length === 3
         ) {
           node.nodes = node.nodes.slice(2);
-          node.nodes[0].value = angles[node.nodes[0].value.toLowerCase()];
+          node.nodes[0].value =
+            angles[
+              /** @type {'top'|'right'|'bottom'|'left'}*/ (
+                node.nodes[0].value.toLowerCase()
+              )
+            ];
         }
 
-        let lastStop = null;
+        /** @type {valueParser.Dimension | false} */
+        let lastStop;
 
         args.forEach((arg, index) => {
           if (arg.length !== 3) {
@@ -68,7 +82,7 @@ function optimise(decl) {
           let isFinalStop = index === args.length - 1;
           let thisStop = valueParser.unit(arg[2].value);
 
-          if (lastStop === null) {
+          if (lastStop === undefined) {
             lastStop = thisStop;
 
             if (
@@ -102,6 +116,7 @@ function optimise(decl) {
         lowerCasedValue === 'repeating-radial-gradient'
       ) {
         let args = getArguments(node);
+        /** @type {valueParser.Dimension | false} */
         let lastStop;
 
         const hasAt = args[0].find((n) => n.value.toLowerCase() === 'at');
@@ -134,6 +149,7 @@ function optimise(decl) {
         lowerCasedValue === '-webkit-repeating-radial-gradient'
       ) {
         let args = getArguments(node);
+        /** @type {valueParser.Dimension | false} */
         let lastStop;
 
         args.forEach((arg) => {
@@ -191,7 +207,10 @@ function optimise(decl) {
     })
     .toString();
 }
-
+/**
+ * @type {import('postcss').PluginCreator<void>}
+ * @return {import('postcss').Plugin}
+ */
 function pluginCreator() {
   return {
     postcssPlugin: 'postcss-minify-gradients',

package/src/isColorStop.js

@@ -3,7 +3,7 @@ const { unit } = require('postcss-value-parser');
 const { colord, extend } = require('colord');
 const namesPlugin = require('colord/plugins/names');
 
-extend([namesPlugin]);
+extend([/** @type {any} */ (namesPlugin)]);
 
 /* Code derived from https://github.com/pigcan/is-color-stop */
 
@@ -25,10 +25,17 @@ const lengthUnits = new Set([
   '%',
 ]);
 
+/**
+ * @param {string} input
+ * @return {boolean}
+ */
 function isCSSLengthUnit(input) {
   return lengthUnits.has(input.toUpperCase());
 }
-
+/**
+ * @param {string|undefined} str
+ * @return {boolean}
+ */
 function isStop(str) {
   if (str) {
     let stop = false;
@@ -45,7 +52,11 @@ function isStop(str) {
   }
   return true;
 }
-
+/**
+ * @param {string} color
+ * @param {string} [stop]
+ * @return {boolean}
+ */
 module.exports = function isColorStop(color, stop) {
   return colord(color).isValid() && isStop(stop);
 };

package/types/index.d.ts

@@ -0,0 +1,9 @@
+export = pluginCreator;
+/**
+ * @type {import('postcss').PluginCreator<void>}
+ * @return {import('postcss').Plugin}
+ */
+declare function pluginCreator(): import('postcss').Plugin;
+declare namespace pluginCreator {
+    const postcss: true;
+}

package/types/isColorStop.d.ts

@@ -0,0 +1,2 @@
+declare function _exports(color: string, stop?: string | undefined): boolean;
+export = _exports;