cssnano 5.0.17 → 5.1.0

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "cssnano",
-  "version": "5.0.17",
+  "version": "5.1.0",
   "description": "A modular minifier, built on top of the PostCSS ecosystem.",
   "main": "src/index.js",
+  "types": "types/index.d.ts",
   "funding": {
     "type": "opencollective",
     "url": "https://opencollective.com/cssnano"
@@ -18,7 +19,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "cssnano-preset-default": "^5.1.12",
+    "cssnano-preset-default": "^5.2.0",
     "lilconfig": "^2.0.3",
     "yaml": "^1.10.2"
   },
@@ -31,7 +32,8 @@
   "repository": "cssnano/cssnano",
   "files": [
     "src",
-    "LICENSE-MIT"
+    "LICENSE-MIT",
+    "types"
   ],
   "bugs": {
     "url": "https://github.com/cssnano/cssnano/issues"
@@ -41,8 +43,8 @@
   },
   "devDependencies": {
     "autoprefixer": "^10.3.7",
-    "cssnano-preset-advanced": "^5.1.12",
-    "cssnano-preset-lite": "^2.0.3",
+    "cssnano-preset-advanced": "^5.2.0",
+    "cssnano-preset-lite": "^2.1.0",
     "postcss": "^8.2.15"
   },
   "peerDependencies": {

package/src/index.js

@@ -1,12 +1,14 @@
 'use strict';
 const path = require('path');
+/** @type {any} */
 const postcss = require('postcss');
 const yaml = require('yaml');
 const { lilconfigSync } = require('lilconfig');
 
 const cssnano = 'cssnano';
 
-/*
+/** @typedef {{preset?: any, plugins?: any[], configFile?: string}} Options */
+/**
  * @param {string} moduleId
  * @returns {boolean}
  */
@@ -19,14 +21,16 @@ function isResolvable(moduleId) {
   }
 }
 
-/*
+/**
  * preset can be one of four possibilities:
  * preset = 'default'
  * preset = ['default', {}]
  * preset = function <- to be invoked
  * preset = {plugins: []} <- already invoked function
+ *
+ * @param {any} preset
+ * @return {[import('postcss').PluginCreator<any>, boolean | Record<string, any> | undefined][]}}
  */
-
 function resolvePreset(preset) {
   let fn, options;
 
@@ -71,22 +75,24 @@ function resolvePreset(preset) {
   );
 }
 
-/*
+/**
  * cssnano will look for configuration firstly as options passed
  * directly to it, and failing this it will use lilconfig to
  * load an external file.
- */
 
+ * @param {Options} options
+ */
 function resolveConfig(options) {
   if (options.preset) {
     return resolvePreset(options.preset);
   }
 
+  /** @type {string | undefined} */
   let searchPath = process.cwd();
-  let configPath = null;
+  let configPath = undefined;
 
   if (options.configFile) {
-    searchPath = null;
+    searchPath = undefined;
     configPath = path.resolve(process.cwd(), options.configFile);
   }
 
@@ -116,7 +122,12 @@ function resolveConfig(options) {
   return resolvePreset(config.config.preset || config.config);
 }
 
-const cssnanoPlugin = (options = {}) => {
+/**
+ * @type {import('postcss').PluginCreator<Options>}
+ * @param {Options=} options
+ * @return {import('postcss').Plugin}
+ */
+function cssnanoPlugin(options = {}) {
   if (Array.isArray(options.plugins)) {
     if (!options.preset || !options.preset.plugins) {
       options.preset = { plugins: [] };
@@ -154,7 +165,7 @@ const cssnanoPlugin = (options = {}) => {
     }
   }
   return postcss(plugins);
-};
+}
 
 cssnanoPlugin.postcss = true;
 module.exports = cssnanoPlugin;

package/types/index.d.ts

@@ -0,0 +1,16 @@
+export = cssnanoPlugin;
+/**
+ * @type {import('postcss').PluginCreator<Options>}
+ * @param {Options=} options
+ * @return {import('postcss').Plugin}
+ */
+declare function cssnanoPlugin(options?: Options | undefined): import('postcss').Plugin;
+declare namespace cssnanoPlugin {
+    export { postcss, Options };
+}
+type Options = {
+    preset?: any;
+    plugins?: any[];
+    configFile?: string;
+};
+declare var postcss: true;