collect plugins data

Author: github-actions[bot]

npm-data/links.json

@@ -164,5 +164,5 @@
 	"license": "MIT",
 	"readme": "\n**Fork Info:** Implements [#169](https://github.com/postcss/postcss-custom-properties/issues/169) by adding a `preserveWithFallback` flag.\n\n# PostCSS Custom Properties [<img src=\"https://postcss.github.io/postcss/logo.svg\" alt=\"PostCSS\" width=\"90\" height=\"90\" align=\"right\">][postcss]\n\n[![NPM Version][npm-img]][npm-url]\n[![CSS Standard Status][css-img]][css-url]\n[![Build Status][cli-img]][cli-url]\n[![Support Chat][git-img]][git-url]\n\n[PostCSS Custom Properties] lets you use Custom Properties in CSS, following\nthe [CSS Custom Properties] specification.\n\n[!['Can I use' table](https://caniuse.bitsofco.de/image/css-variables.png)](https://caniuse.com/#feat=css-variables)\n\n```pcss\n:root {\n  --color: red;\n}\n\nh1 {\n  color: var(--color);\n}\n\n/* becomes */\n\n:root {\n  --color: red;\n}\n\nh1 {\n  color: red;\n  color: var(--color);\n}\n```\n\n## Usage\n\nAdd [PostCSS Custom Properties] to your project:\n\n```bash\nnpm install postcss-custom-properties --save-dev\n```\n\nUse [PostCSS Custom Properties] to process your CSS:\n\n```js\nconst postcssCustomProperties = require('postcss-custom-properties');\n\npostcssCustomProperties.process(YOUR_CSS /*, processOptions, pluginOptions */);\n```\n\nOr use it as a [PostCSS] plugin:\n\n```js\nconst postcss = require('postcss');\nconst postcssCustomProperties = require('postcss-custom-properties');\n\npostcss([\n  postcssCustomProperties(/* pluginOptions */)\n]).process(YOUR_CSS /*, processOptions */);\n```\n\n[PostCSS Custom Properties] runs in all Node environments, with special instructions for:\n\n| [Node](INSTALL.md#node) | [PostCSS CLI](INSTALL.md#postcss-cli) | [Webpack](INSTALL.md#webpack) | [Create React App](INSTALL.md#create-react-app) | [Gulp](INSTALL.md#gulp) | [Grunt](INSTALL.md#grunt) |\n| --- | --- | --- | --- | --- | --- |\n\n## Options\n\n### preserve\n\nThe `preserve` option determines whether Custom Properties and properties using\ncustom properties should be preserved in their original form. By default, both\nof these are preserved.\n\n```js\npostcssCustomProperties({\n  preserve: false\n});\n```\n\n```pcss\n:root {\n  --color: red;\n}\n\nh1 {\n  color: var(--color);\n}\n\n/* becomes */\n\nh1 {\n  color: red;\n}\n```\n\n### importFrom\n\nThe `importFrom` option specifies sources where Custom Properties can be imported\nfrom, which might be CSS, JS, and JSON files, functions, and directly passed\nobjects.\n\n```js\npostcssCustomProperties({\n  importFrom: 'path/to/file.css' // => :root { --color: red }\n});\n```\n\n```pcss\nh1 {\n  color: var(--color);\n}\n\n/* becomes */\n\nh1 {\n  color: red;\n}\n```\n\nMultiple sources can be passed into this option, and they will be parsed in the\norder they are received. JavaScript files, JSON files, functions, and objects\nwill need to namespace Custom Properties using the `customProperties` or\n`custom-properties` key.\n\n```js\npostcssCustomProperties({\n  importFrom: [\n    'path/to/file.css',   // :root { --color: red; }\n    'and/then/this.js',   // module.exports = { customProperties: { '--color': 'red' } }\n    'and/then/that.json', // { \"custom-properties\": { \"--color\": \"red\" } }\n    {\n      customProperties: { '--color': 'red' }\n    },\n    () => {\n      const customProperties = { '--color': 'red' };\n\n      return { customProperties };\n    }\n  ]\n});\n```\n\nSee example imports written in [CSS](test/import-properties.css),\n[JS](test/import-properties.js), and [JSON](test/import-properties.json).\n\n### exportTo\n\nThe `exportTo` option specifies destinations where Custom Properties can be exported\nto, which might be CSS, JS, and JSON files, functions, and directly passed\nobjects.\n\n```js\npostcssCustomProperties({\n  exportTo: 'path/to/file.css' // :root { --color: red; }\n});\n```\n\nMultiple destinations can be passed into this option, and they will be parsed\nin the order they are received. JavaScript files, JSON files, and objects will\nneed to namespace Custom Properties using the `customProperties` or\n`custom-properties` key.\n\n```js\nconst cachedObject = { customProperties: {} };\n\npostcssCustomProperties({\n  exportTo: [\n    'path/to/file.css',   // :root { --color: red; }\n    'and/then/this.js',   // module.exports = { customProperties: { '--color': 'red' } }\n    'and/then/this.mjs',  // export const customProperties = { '--color': 'red' } }\n    'and/then/that.json', // { \"custom-properties\": { \"--color\": \"red\" } }\n    cachedObject,\n    customProperties => {\n      customProperties    // { '--color': 'red' }\n    }\n  ]\n});\n```\n\nSee example exports written to [CSS](test/export-properties.css),\n[JS](test/export-properties.js), [MJS](test/export-properties.mjs), and\n[JSON](test/export-properties.json).\n\n[cli-img]: https://img.shields.io/travis/postcss/postcss-custom-properties/master.svg\n[cli-url]: https://travis-ci.org/postcss/postcss-custom-properties\n[css-img]: https://cssdb.org/badge/custom-properties.svg\n[css-url]: https://cssdb.org/#custom-properties\n[git-img]: https://img.shields.io/badge/support-chat-blue.svg\n[git-url]: https://gitter.im/postcss/postcss\n[npm-img]: https://img.shields.io/npm/v/postcss-custom-properties.svg\n[npm-url]: https://www.npmjs.com/package/postcss-custom-properties\n\n[CSS Custom Properties]: https://www.w3.org/TR/css-variables-1/\n[PostCSS]: https://github.com/postcss/postcss\n[PostCSS Custom Properties]: https://github.com/postcss/postcss-custom-properties\n",
 	"readmeFilename": "README.md",
-	"_downloads": 25
+	"_downloads": 31
 }

npm-data/maintained-plugins.json

@@ -3608,5 +3608,5 @@
 	],
 	"readme": "# PostCSS Bundler [<img src=\"https://postcss.github.io/postcss/logo.svg\" alt=\"PostCSS Logo\" width=\"90\" height=\"90\" align=\"right\">][PostCSS]\n\n`npm install @csstools/postcss-bundler --save-dev`\n\n[PostCSS Bundler] bundles your CSS.\n\nThis plugin pack contains :\n- a bundler based on standard CSS `@import` statements.\n- [a rebaser that rewrites URLs in your CSS.](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-rebase-url)\n\n`examples/example.css` :\n```css\n@import url(\"imports/basic.css\");\n@import url(\"node_modules:open-props/red\");\n```\n\n`examples/imports/basic.css`:\n```css\n.foo {\n\tbackground: url('../../images/green.png');\n}\n```\n\nwhen bundled :\n```css\n/* imports/basic.css */\n.foo {\n\tbackground: url(\"../images/green.png\");\n}\n/* node_modules:open-props/red */\n:where(html){--red-0:#fff5f5;--red-1:#ffe3e3;--red-2:#ffc9c9;--red-3:#ffa8a8;--red-4:#ff8787;--red-5:#ff6b6b;--red-6:#fa5252;--red-7:#f03e3e;--red-8:#e03131;--red-9:#c92a2a;--red-10:#b02525;--red-11:#962020;--red-12:#7d1a1a}\n```\n\n## Usage\n\nAdd [PostCSS Bundler] to your project:\n\n```bash\nnpm install postcss @csstools/postcss-bundler --save-dev\n```\n\nUse it as a [PostCSS] plugin:\n\n```js\nconst postcss = require('postcss');\nconst postcssBundler = require('@csstools/postcss-bundler');\n\npostcss([\n\tpostcssBundler(/* pluginOptions */)\n]).process(YOUR_CSS /*, processOptions */);\n```\n\n\n\n## `postcss-import`\n\n[`postcss-import`](https://github.com/postcss/postcss-import) is also a CSS bundler and parts of [PostCSS Bundler] are based on it.  \nWhile creating this plugin we also submitted patches to [`postcss-import`](https://github.com/postcss/postcss-import) where possible.  \n\n[PostCSS Bundler] is tuned differently and lacks configuration options that are present in [`postcss-import`](https://github.com/postcss/postcss-import).\n\n[PostCSS Bundler] is intended to just work and to be a drop-in replacement for native CSS `@import` statements.\n\n[cli-url]: https://github.com/csstools/postcss-plugins/actions/workflows/test.yml?query=workflow/test\n\n[discord]: https://discord.gg/bUadyRwkJS\n[npm-url]: https://www.npmjs.com/package/@csstools/postcss-bundler\n\n[PostCSS]: https://github.com/postcss/postcss\n[PostCSS Bundler]: https://github.com/csstools/postcss-plugins/tree/main/plugin-packs/postcss-bundler\n",
 	"readmeFilename": "README.md",
-	"_downloads": 3615
+	"_downloads": 3693
 }

npm-data/maybe-plugins.json

@@ -4814,5 +4814,5 @@
 	],
 	"readme": "# PostCSS Color Function [<img src=\"https://postcss.github.io/postcss/logo.svg\" alt=\"PostCSS Logo\" width=\"90\" height=\"90\" align=\"right\">][PostCSS]\n\n`npm install @csstools/postcss-color-function --save-dev`\n\n[PostCSS Color Function] lets you use the `color` function in\nCSS, following the [CSS Color] specification.\n\n```css\n.color {\n\tcolor: color(display-p3 0.64331 0.19245 0.16771);\n}\n\n:root {\n\t--a-color: color(srgb 0.64331 0.19245 0.16771);\n}\n\n/* becomes */\n\n.color {\n\tcolor: rgb(179, 35, 35);\n}\n\n:root {\n\t--a-color: rgb(164, 49, 43);\n}\n```\n\n## Usage\n\nAdd [PostCSS Color Function] to your project:\n\n```bash\nnpm install postcss @csstools/postcss-color-function --save-dev\n```\n\nUse it as a [PostCSS] plugin:\n\n```js\nconst postcss = require('postcss');\nconst postcssColorFunction = require('@csstools/postcss-color-function');\n\npostcss([\n\tpostcssColorFunction(/* pluginOptions */)\n]).process(YOUR_CSS /*, processOptions */);\n```\n\n\n\n## Options\n\n### preserve\n\nThe `preserve` option determines whether the original notation\nis preserved. By default, it is not preserved.\n\n```js\npostcssColorFunction({ preserve: true })\n```\n\n```css\n.color {\n\tcolor: color(display-p3 0.64331 0.19245 0.16771);\n}\n\n:root {\n\t--a-color: color(srgb 0.64331 0.19245 0.16771);\n}\n\n/* becomes */\n\n.color {\n\tcolor: rgb(179, 35, 35);\n\tcolor: color(display-p3 0.64331 0.19245 0.16771);\n}\n\n:root {\n\t--a-color: rgb(164, 49, 43);\n}\n\n@supports (color: color(display-p3 0 0 0%)) {\n:root {\n\t--a-color: color(srgb 0.64331 0.19245 0.16771);\n}\n}\n```\n\n### enableProgressiveCustomProperties\n\nThe `enableProgressiveCustomProperties` option determines whether the original notation\nis wrapped with `@supports` when used in Custom Properties. By default, it is enabled.\n\n> [!NOTE]\n> We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties.  \n> See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).\n\n```js\npostcssColorFunction({ enableProgressiveCustomProperties: false })\n```\n\n```css\n.color {\n\tcolor: color(display-p3 0.64331 0.19245 0.16771);\n}\n\n:root {\n\t--a-color: color(srgb 0.64331 0.19245 0.16771);\n}\n\n/* becomes */\n\n.color {\n\tcolor: rgb(179, 35, 35);\n\tcolor: color(display-p3 0.64331 0.19245 0.16771);\n}\n\n:root {\n\t--a-color: rgb(164, 49, 43);\n\t--a-color: color(srgb 0.64331 0.19245 0.16771);\n}\n```\n\n_Custom properties do not fallback to the previous declaration_\n\n## Supported Color Spaces\n\n```css\n.color-spaces {\n\tcolor: color(a98-rgb 0.803 0.484 0.944);\n\tcolor: color(display-p3 0.8434 0.509 0.934);\n\tcolor: color(prophoto-rgb 0.759 0.493 0.898);\n\tcolor: color(rec2020 0.772 0.491 0.920);\n\tcolor: color(srgb 0.897 0.488 0.959);\n\tcolor: color(srgb-linear 0.783 0.203 0.910);\n\tcolor: color(xyz 0.560 0.377 0.904);\n\tcolor: color(xyz-d50 0.550 0.375 0.680);\n\tcolor: color(xyz-d65 0.560 0.377 0.904);\n}\n```\n\n## Copyright : color conversions\n\nThis software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/tree/main/css-color-4. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).\n\n[cli-url]: https://github.com/csstools/postcss-plugins/actions/workflows/test.yml?query=workflow/test\n[css-url]: https://cssdb.org/#color-function\n[discord]: https://discord.gg/bUadyRwkJS\n[npm-url]: https://www.npmjs.com/package/@csstools/postcss-color-function\n\n[PostCSS]: https://github.com/postcss/postcss\n[PostCSS Color Function]: https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-color-function\n[CSS Color]: https://www.w3.org/TR/css-color-4/#funcdef-color\n",
 	"readmeFilename": "README.md",
-	"_downloads": 16747402
+	"_downloads": 16274658
 }

npm-data/plugins.json

@@ -3916,5 +3916,5 @@
 	],
 	"readme": "# PostCSS Color Mix Function [<img src=\"https://postcss.github.io/postcss/logo.svg\" alt=\"PostCSS Logo\" width=\"90\" height=\"90\" align=\"right\">][PostCSS]\n\n`npm install @csstools/postcss-color-mix-function --save-dev`\n\n[PostCSS Color Mix Function] lets you use the `color-mix()` function following the [CSS Color 5 Specification].\n\n```css\n.purple_plum {\n\tcolor: color-mix(in lch, purple 50%, plum 50%);\n}\n\n/* becomes */\n\n.purple_plum {\n\tcolor: rgb(175, 92, 174);\n}\n```\n\n> [!NOTE]\n> We can not dynamically resolve `var()` arguments in `color-mix()`, only static values will work.\n\n## Usage\n\nAdd [PostCSS Color Mix Function] to your project:\n\n```bash\nnpm install postcss @csstools/postcss-color-mix-function --save-dev\n```\n\nUse it as a [PostCSS] plugin:\n\n```js\nconst postcss = require('postcss');\nconst postcssColorMixFunction = require('@csstools/postcss-color-mix-function');\n\npostcss([\n\tpostcssColorMixFunction(/* pluginOptions */)\n]).process(YOUR_CSS /*, processOptions */);\n```\n\n\n\n## Options\n\n### preserve\n\nThe `preserve` option determines whether the original notation\nis preserved. By default, it is not preserved.\n\n```js\npostcssColorMixFunction({ preserve: true })\n```\n\n```css\n.purple_plum {\n\tcolor: color-mix(in lch, purple 50%, plum 50%);\n}\n\n/* becomes */\n\n.purple_plum {\n\tcolor: rgb(175, 92, 174);\n\tcolor: color-mix(in lch, purple 50%, plum 50%);\n}\n```\n\n[cli-url]: https://github.com/csstools/postcss-plugins/actions/workflows/test.yml?query=workflow/test\n[css-url]: https://cssdb.org/#color-mix\n[discord]: https://discord.gg/bUadyRwkJS\n[npm-url]: https://www.npmjs.com/package/@csstools/postcss-color-mix-function\n\n[PostCSS]: https://github.com/postcss/postcss\n[PostCSS Color Mix Function]: https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-color-mix-function\n[CSS Color 5 Specification]: https://www.w3.org/TR/css-color-5/#color-mix\n",
 	"readmeFilename": "README.md",
-	"_downloads": 4882847
+	"_downloads": 4865509
 }

npm-data/plugins/@arshaw/postcss-custom-properties.json

@@ -755,5 +755,5 @@
 	],
 	"readme": "# PostCSS Content Alt Text [<img src=\"https://postcss.github.io/postcss/logo.svg\" alt=\"PostCSS Logo\" width=\"90\" height=\"90\" align=\"right\">][PostCSS]\n\n`npm install @csstools/postcss-content-alt-text --save-dev`\n\n[PostCSS Content Alt Text] generates fallback values for `content` with alt text following the [CSS Generated Content Module].\n\n```pcss\n.foo {\n\tcontent: url(tree.jpg) / \"A beautiful tree in a dark forest\";\n}\n\n.bar {\n\tcontent: \">\" / \"\";\n}\n\n/* becomes */\n\n.foo {\n\tcontent: url(tree.jpg)  \"A beautiful tree in a dark forest\";\n\tcontent: url(tree.jpg) / \"A beautiful tree in a dark forest\";\n}\n\n.bar {\n\tcontent: \">\" ;\n\tcontent: \">\" / \"\";\n}\n```\n\n## Usage\n\nAdd [PostCSS Content Alt Text] to your project:\n\n```bash\nnpm install postcss @csstools/postcss-content-alt-text --save-dev\n```\n\nUse it as a [PostCSS] plugin:\n\n```js\nconst postcss = require('postcss');\nconst postcssContentAltText = require('@csstools/postcss-content-alt-text');\n\npostcss([\n\tpostcssContentAltText(/* pluginOptions */)\n]).process(YOUR_CSS /*, processOptions */);\n```\n\n\n\n## Options\n\n### preserve\n\nThe `preserve` option determines whether the original notation\nis preserved. By default, it is preserved.\n\n```js\npostcssContentAltText({ preserve: false })\n```\n\n```pcss\n.foo {\n\tcontent: url(tree.jpg) / \"A beautiful tree in a dark forest\";\n}\n\n.bar {\n\tcontent: \">\" / \"\";\n}\n\n/* becomes */\n\n.foo {\n\tcontent: url(tree.jpg)  \"A beautiful tree in a dark forest\";\n}\n\n.bar {\n\tcontent: \">\" ;\n}\n```\n\n### stripAltText\n\nThe `stripAltText` option determines whether the alt text is removed from the value.  \nBy default, it is not removed.  \nInstead it is added to the `content` value itself to ensure content is accessible.\n\nOnly set this to `true` if you are sure the alt text is not needed.\n\n```js\npostcssContentAltText({ stripAltText: true })\n```\n\n```pcss\n.foo {\n\tcontent: url(tree.jpg) / \"A beautiful tree in a dark forest\";\n}\n\n.bar {\n\tcontent: \">\" / \"\";\n}\n\n/* becomes */\n\n.foo {\n\tcontent: url(tree.jpg) ;\n\tcontent: url(tree.jpg) / \"A beautiful tree in a dark forest\";\n}\n\n.bar {\n\tcontent: \">\" ;\n\tcontent: \">\" / \"\";\n}\n```\n\n[cli-url]: https://github.com/csstools/postcss-plugins/actions/workflows/test.yml?query=workflow/test\n[css-url]: https://cssdb.org/#content-alt-text\n[discord]: https://discord.gg/bUadyRwkJS\n[npm-url]: https://www.npmjs.com/package/@csstools/postcss-content-alt-text\n\n[PostCSS]: https://github.com/postcss/postcss\n[PostCSS Content Alt Text]: https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-content-alt-text\n[CSS Generated Content Module]: https://drafts.csswg.org/css-content/#content-property\n",
 	"readmeFilename": "README.md",
-	"_downloads": 2518350
+	"_downloads": 2634806
 }

npm-data/plugins/@csstools/postcss-bundler.json

@@ -492,5 +492,5 @@
 	],
 	"readme": "# PostCSS Debug Logger [<img src=\"https://postcss.github.io/postcss/logo.svg\" alt=\"PostCSS Logo\" width=\"90\" height=\"90\" align=\"right\">][PostCSS]\n\n```bash\nnpm install @csstools/postcss-debug-logger --save-dev\n```\n\n[PostCSS Debug Logger] logs the AST nodes PostCSS is processing.\n\nThis is mainly useful to track down infinite loops in PostCSS plugins.\n\n## Usage\n\nAdd [PostCSS Debug Logger] to your project:\n\n```bash\nnpm install postcss @csstools/postcss-debug-logger --save-dev\n```\n\nUse it as a [PostCSS] plugin:\n\n```js\nconst postcss = require('postcss');\nconst postcssDebugLogger = require('@csstools/postcss-debug-logger');\n\npostcss([\n\tpostcssDebugLogger(/* pluginOptions */)\n]).process(YOUR_CSS /*, processOptions */);\n```\n\n\n\n[cli-url]: https://github.com/csstools/postcss-plugins/actions/workflows/test.yml?query=workflow/test\n\n[discord]: https://discord.gg/bUadyRwkJS\n[npm-url]: https://www.npmjs.com/package/@csstools/postcss-debug-logger\n\n[PostCSS]: https://github.com/postcss/postcss\n[PostCSS Debug Logger]: https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-debug-logger\n",
 	"readmeFilename": "README.md",
-	"_downloads": 282
+	"_downloads": 312
 }