postcss-reduce-transforms 5.0.4 → 5.1.0

package/README.md

@@ -19,7 +19,7 @@ see the [tests](src/__tests__/index.js).
 
 ```css
 h1 {
-    transform: rotate3d(0, 0, 1, 20deg);
+  transform: rotate3d(0, 0, 1, 20deg);
 }
 ```
 
@@ -27,7 +27,7 @@ h1 {
 
 ```css
 h1 {
-    transform: rotate(20deg);
+  transform: rotate(20deg);
 }
 ```
 

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "postcss-reduce-transforms",
-  "version": "5.0.4",
+  "version": "5.1.0",
   "description": "Reduce transform functions with PostCSS.",
   "main": "src/index.js",
+  "types": "types/index.d.ts",
   "files": [
     "LICENSE-MIT",
-    "src"
+    "src",
+    "types"
   ],
   "license": "MIT",
   "homepage": "https://github.com/cssnano/cssnano",
@@ -30,5 +32,5 @@
   "peerDependencies": {
     "postcss": "^8.2.15"
   },
-  "readme": "# [postcss][postcss]-reduce-transforms\n\n> Reduce transform functions with PostCSS.\n\n## Install\n\nWith [npm](https://npmjs.org/package/postcss-reduce-transforms) do:\n\n```\nnpm install postcss-reduce-transforms --save\n```\n\n## Example\n\nThis module will reduce transform functions where possible. For more examples,\nsee the [tests](src/__tests__/index.js).\n\n### Input\n\n```css\nh1 {\n    transform: rotate3d(0, 0, 1, 20deg);\n}\n```\n\n### Output\n\n```css\nh1 {\n    transform: rotate(20deg);\n}\n```\n\n## Usage\n\nSee the [PostCSS documentation](https://github.com/postcss/postcss#usage) for\nexamples for your environment.\n\n## Contributors\n\nSee [CONTRIBUTORS.md](https://github.com/cssnano/cssnano/blob/master/CONTRIBUTORS.md).\n\n## License\n\nMIT © [Ben Briggs](http://beneb.info)\n\n[postcss]: https://github.com/postcss/postcss\n"
+  "readme": "# [postcss][postcss]-reduce-transforms\n\n> Reduce transform functions with PostCSS.\n\n## Install\n\nWith [npm](https://npmjs.org/package/postcss-reduce-transforms) do:\n\n```\nnpm install postcss-reduce-transforms --save\n```\n\n## Example\n\nThis module will reduce transform functions where possible. For more examples,\nsee the [tests](src/__tests__/index.js).\n\n### Input\n\n```css\nh1 {\n  transform: rotate3d(0, 0, 1, 20deg);\n}\n```\n\n### Output\n\n```css\nh1 {\n  transform: rotate(20deg);\n}\n```\n\n## Usage\n\nSee the [PostCSS documentation](https://github.com/postcss/postcss#usage) for\nexamples for your environment.\n\n## Contributors\n\nSee [CONTRIBUTORS.md](https://github.com/cssnano/cssnano/blob/master/CONTRIBUTORS.md).\n\n## License\n\nMIT © [Ben Briggs](http://beneb.info)\n\n[postcss]: https://github.com/postcss/postcss\n"
 }

package/src/index.js

@@ -1,8 +1,15 @@
 'use strict';
 const valueParser = require('postcss-value-parser');
 
+/**
+ * @param {(number|string)[]} list
+ * @param {valueParser.Node} node
+ * @param {number} index
+ * @return {(number|string)[]}
+ */
 function getValues(list, node, index) {
   if (index % 2 === 0) {
+    /** @type {number|string} */
     let value = NaN;
 
     if (
@@ -21,6 +28,11 @@ function getValues(list, node, index) {
   return list;
 }
 
+/**
+ * @param {valueParser.FunctionNode} node
+ * @param {(number|string)[]} values
+ * @return {void}
+ */
 function matrix3d(node, values) {
   if (values.length !== 16) {
     return;
@@ -65,6 +77,11 @@ const rotate3dMappings = new Map([
   [[0, 0, 1].toString(), 'rotate'], // rotate3d(0, 0, 1, a) => rotate(a)
 ]);
 
+/**
+ * @param {valueParser.FunctionNode} node
+ * @param {(number|string)[]} values
+ * @return {void}
+ */
 function rotate3d(node, values) {
   if (values.length !== 4) {
     return;
@@ -79,6 +96,11 @@ function rotate3d(node, values) {
   }
 }
 
+/**
+ * @param {valueParser.FunctionNode} node
+ * @param {(number|string)[]} values
+ * @return {void}
+ */
 function rotateZ(node, values) {
   if (values.length !== 1) {
     return;
@@ -88,6 +110,11 @@ function rotateZ(node, values) {
   node.value = 'rotate';
 }
 
+/**
+ * @param {valueParser.FunctionNode} node
+ * @param {(number|string)[]} values
+ * @return {void}
+ */
 function scale(node, values) {
   if (values.length !== 2) {
     return;
@@ -120,6 +147,11 @@ function scale(node, values) {
   }
 }
 
+/**
+ * @param {valueParser.FunctionNode} node
+ * @param {(number|string)[]} values
+ * @return {void}
+ */
 function scale3d(node, values) {
   if (values.length !== 3) {
     return;
@@ -153,6 +185,11 @@ function scale3d(node, values) {
   }
 }
 
+/**
+ * @param {valueParser.FunctionNode} node
+ * @param {(number|string)[]} values
+ * @return {void}
+ */
 function translate(node, values) {
   if (values.length !== 2) {
     return;
@@ -176,6 +213,11 @@ function translate(node, values) {
   }
 }
 
+/**
+ * @param {valueParser.FunctionNode} node
+ * @param {(number|string)[]} values
+ * @return {void}
+ */
 function translate3d(node, values) {
   if (values.length !== 3) {
     return;
@@ -199,7 +241,10 @@ const reducers = new Map([
   ['translate', translate],
   ['translate3d', translate3d],
 ]);
-
+/**
+ * @param {string} name
+ * @return {string}
+ */
 function normalizeReducerName(name) {
   const lowerCasedName = name.toLowerCase();
 
@@ -210,6 +255,10 @@ function normalizeReducerName(name) {
   return lowerCasedName;
 }
 
+/**
+ * @param {valueParser.Node} node
+ * @return {false}
+ */
 function reduce(node) {
   if (node.type === 'function') {
     const normalizedReducerName = normalizeReducerName(node.value);
@@ -221,6 +270,10 @@ function reduce(node) {
   return false;
 }
 
+/**
+ * @type {import('postcss').PluginCreator<void>}
+ * @return {import('postcss').Plugin}
+ */
 function pluginCreator() {
   return {
     postcssPlugin: 'postcss-reduce-transforms',

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;
+}