summaryrefslogtreecommitdiff
path: root/node_modules/postcss-discard-comments
diff options
context:
space:
mode:
authorlittleblack111 <littleblack11111@gmail.com>2023-10-14 15:05:55 +0800
committerlittleblack111 <littleblack11111@gmail.com>2023-10-14 15:05:55 +0800
commitc06f7ee0a40255214c477e13d9b956a7e07c2900 (patch)
treef5982a568ef8fab865d0142e71c7494fea3e4c1b /node_modules/postcss-discard-comments
parent3fd9400d4dccc25aa29b5702216732e0b7542073 (diff)
postcss,(plugins): nanocss, postcss-preset-env
Diffstat (limited to 'node_modules/postcss-discard-comments')
-rw-r--r--node_modules/postcss-discard-comments/LICENSE-MIT22
-rw-r--r--node_modules/postcss-discard-comments/README.md114
-rw-r--r--node_modules/postcss-discard-comments/package.json40
-rw-r--r--node_modules/postcss-discard-comments/src/index.js153
-rw-r--r--node_modules/postcss-discard-comments/src/lib/commentParser.js31
-rw-r--r--node_modules/postcss-discard-comments/src/lib/commentRemover.js32
-rw-r--r--node_modules/postcss-discard-comments/types/index.d.ts21
-rw-r--r--node_modules/postcss-discard-comments/types/lib/commentParser.d.ts2
-rw-r--r--node_modules/postcss-discard-comments/types/lib/commentRemover.d.ts14
9 files changed, 429 insertions, 0 deletions
diff --git a/node_modules/postcss-discard-comments/LICENSE-MIT b/node_modules/postcss-discard-comments/LICENSE-MIT
new file mode 100644
index 00000000..fd0e863a
--- /dev/null
+++ b/node_modules/postcss-discard-comments/LICENSE-MIT
@@ -0,0 +1,22 @@
+Copyright (c) Ben Briggs <beneb.info@gmail.com> (http://beneb.info)
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
diff --git a/node_modules/postcss-discard-comments/README.md b/node_modules/postcss-discard-comments/README.md
new file mode 100644
index 00000000..e22ffad4
--- /dev/null
+++ b/node_modules/postcss-discard-comments/README.md
@@ -0,0 +1,114 @@
+# [postcss][postcss]-discard-comments
+
+> Discard comments in your CSS files with PostCSS.
+
+
+## Install
+
+With [npm](https://npmjs.org/package/postcss-discard-comments) do:
+
+```
+npm install postcss-discard-comments --save
+```
+
+
+## Example
+
+### Input
+
+```css
+h1/* heading */{
+ margin: 0 auto
+}
+```
+
+### Output
+
+```css
+h1 {
+ margin: 0 auto
+}
+```
+
+This module discards comments from your CSS files; by default, it will remove
+all regular comments (`/* comment */`) and preserve comments marked as important
+(`/*! important */`).
+
+Note that this module does not handle source map comments because they are not
+available to it; PostCSS handles this internally, so if they are removed then
+you will have to [configure source maps in PostCSS][maps].
+
+[maps]: https://github.com/postcss/postcss/blob/master/docs/source-maps.md
+
+
+## API
+
+### comments([options])
+
+#### options
+
+##### remove(function)
+
+Type: `function`
+Return: `boolean`
+Variable: `comment` contains a comment without `/**/`
+
+For each comment, return true to remove, or false to keep the comment.
+
+```js
+function(comment) {}
+```
+
+```js
+var css = '/* headings *//*@ h1 */h1{margin:0 auto}/*@ h2 */h2{color:red}';
+console.log(postcss(comments({
+ remove: function(comment) { return comment[0] == "@"; }
+})).process(css).css);
+//=> /* headings */h1{margin:0 auto}h2{color:red}
+```
+**NOTE:** If you use the `remove` function other options will not be available.
+
+##### removeAll
+
+Type: `boolean`
+Default: `false`
+
+Remove all comments marked as important.
+
+```js
+var css = '/*! heading */h1{margin:0 auto}/*! heading 2 */h2{color:red}';
+console.log(postcss(comments({removeAll: true})).process(css).css);
+//=> h1{margin:0 auto}h2{color:red}
+```
+
+##### removeAllButFirst
+
+Type: `boolean`
+Default: `false`
+
+Remove all comments marked as important, but the first one.
+
+```js
+var css = '/*! heading */h1{margin:0 auto}/*! heading 2 */h2{color:red}';
+console.log(postcss(comments({removeAllButFirst: true})).process(css).css);
+//=> /*! heading */h1{margin:0 auto}h2{color:red}
+```
+
+
+## Usage
+
+See the [PostCSS documentation](https://github.com/postcss/postcss#usage) for
+examples for your environment.
+
+
+## Contributors
+
+See [CONTRIBUTORS.md](https://github.com/cssnano/cssnano/blob/master/CONTRIBUTORS.md).
+
+
+## License
+
+MIT © [Ben Briggs](http://beneb.info)
+
+
+[postcss]: https://github.com/postcss/postcss
diff --git a/node_modules/postcss-discard-comments/package.json b/node_modules/postcss-discard-comments/package.json
new file mode 100644
index 00000000..d6020cac
--- /dev/null
+++ b/node_modules/postcss-discard-comments/package.json
@@ -0,0 +1,40 @@
+{
+ "name": "postcss-discard-comments",
+ "version": "6.0.0",
+ "description": "Discard comments in your CSS files with PostCSS.",
+ "main": "src/index.js",
+ "types": "types/index.d.ts",
+ "files": [
+ "src",
+ "LICENSE-MIT",
+ "types"
+ ],
+ "keywords": [
+ "css",
+ "comments",
+ "postcss",
+ "postcss-plugin"
+ ],
+ "license": "MIT",
+ "homepage": "https://github.com/cssnano/cssnano",
+ "author": {
+ "name": "Ben Briggs",
+ "email": "beneb.info@gmail.com",
+ "url": "http://beneb.info"
+ },
+ "repository": "cssnano/cssnano",
+ "bugs": {
+ "url": "https://github.com/cssnano/cssnano/issues"
+ },
+ "engines": {
+ "node": "^14 || ^16 || >=18.0"
+ },
+ "devDependencies": {
+ "postcss": "^8.2.15",
+ "postcss-simple-vars": "^7.0.1",
+ "postcss-scss": "^4.0.6"
+ },
+ "peerDependencies": {
+ "postcss": "^8.2.15"
+ }
+} \ No newline at end of file
diff --git a/node_modules/postcss-discard-comments/src/index.js b/node_modules/postcss-discard-comments/src/index.js
new file mode 100644
index 00000000..8ebd8590
--- /dev/null
+++ b/node_modules/postcss-discard-comments/src/index.js
@@ -0,0 +1,153 @@
+'use strict';
+const CommentRemover = require('./lib/commentRemover');
+const commentParser = require('./lib/commentParser');
+
+/** @typedef {object} Options
+ * @property {boolean=} removeAll
+ * @property {boolean=} removeAllButFirst
+ * @property {(s: string) => boolean=} remove
+ */
+/**
+ * @type {import('postcss').PluginCreator<Options>}
+ * @param {Options} opts
+ * @return {import('postcss').Plugin}
+ */
+function pluginCreator(opts = {}) {
+ const remover = new CommentRemover(opts);
+ const matcherCache = new Map();
+ const replacerCache = new Map();
+
+ /**
+ * @param {string} source
+ * @return {[number, number, number][]}
+ */
+ function matchesComments(source) {
+ if (matcherCache.has(source)) {
+ return matcherCache.get(source);
+ }
+
+ const result = commentParser(source).filter(([type]) => type);
+
+ matcherCache.set(source, result);
+
+ return result;
+ }
+
+ /**
+ * @param {string} source
+ * @param {(s: string) => string[]} space
+ * @return {string}
+ */
+ function replaceComments(source, space, separator = ' ') {
+ const key = source + '@|@' + separator;
+
+ if (replacerCache.has(key)) {
+ return replacerCache.get(key);
+ }
+ const parsed = commentParser(source).reduce((value, [type, start, end]) => {
+ const contents = source.slice(start, end);
+
+ if (!type) {
+ return value + contents;
+ }
+
+ if (remover.canRemove(contents)) {
+ return value + separator;
+ }
+
+ return `${value}/*${contents}*/`;
+ }, '');
+
+ const result = space(parsed).join(' ');
+
+ replacerCache.set(key, result);
+
+ return result;
+ }
+
+ return {
+ postcssPlugin: 'postcss-discard-comments',
+
+ OnceExit(css, { list }) {
+ css.walk((node) => {
+ if (node.type === 'comment' && remover.canRemove(node.text)) {
+ node.remove();
+
+ return;
+ }
+
+ if (typeof node.raws.between === 'string') {
+ node.raws.between = replaceComments(node.raws.between, list.space);
+ }
+
+ if (node.type === 'decl') {
+ if (node.raws.value && node.raws.value.raw) {
+ if (node.raws.value.value === node.value) {
+ node.value = replaceComments(node.raws.value.raw, list.space);
+ } else {
+ node.value = replaceComments(node.value, list.space);
+ }
+
+ /** @type {null | {value: string, raw: string}} */ (
+ node.raws.value
+ ) = null;
+ }
+
+ if (node.raws.important) {
+ node.raws.important = replaceComments(
+ node.raws.important,
+ list.space
+ );
+
+ const b = matchesComments(node.raws.important);
+
+ node.raws.important = b.length ? node.raws.important : '!important';
+ } else {
+ node.value = replaceComments(node.value, list.space);
+ }
+
+ return;
+ }
+
+ if (
+ node.type === 'rule' &&
+ node.raws.selector &&
+ node.raws.selector.raw
+ ) {
+ node.raws.selector.raw = replaceComments(
+ node.raws.selector.raw,
+ list.space,
+ ''
+ );
+
+ return;
+ }
+
+ if (node.type === 'atrule') {
+ if (node.raws.afterName) {
+ const commentsReplaced = replaceComments(
+ node.raws.afterName,
+ list.space
+ );
+
+ if (!commentsReplaced.length) {
+ node.raws.afterName = commentsReplaced + ' ';
+ } else {
+ node.raws.afterName = ' ' + commentsReplaced + ' ';
+ }
+ }
+
+ if (node.raws.params && node.raws.params.raw) {
+ node.raws.params.raw = replaceComments(
+ node.raws.params.raw,
+ list.space
+ );
+ }
+ }
+ });
+ },
+ };
+}
+
+pluginCreator.postcss = true;
+module.exports = pluginCreator;
diff --git a/node_modules/postcss-discard-comments/src/lib/commentParser.js b/node_modules/postcss-discard-comments/src/lib/commentParser.js
new file mode 100644
index 00000000..a8834701
--- /dev/null
+++ b/node_modules/postcss-discard-comments/src/lib/commentParser.js
@@ -0,0 +1,31 @@
+'use strict';
+
+/**
+ * @param {string} input
+ * @return {[number, number, number][]}
+ */
+module.exports = function commentParser(input) {
+ /** @type [number, number, number][] */
+ const tokens = [];
+ const length = input.length;
+ let pos = 0;
+ let next;
+
+ while (pos < length) {
+ next = input.indexOf('/*', pos);
+
+ if (~next) {
+ tokens.push([0, pos, next]);
+ pos = next;
+
+ next = input.indexOf('*/', pos + 2);
+ tokens.push([1, pos + 2, next]);
+ pos = next + 2;
+ } else {
+ tokens.push([0, pos, length]);
+ pos = length;
+ }
+ }
+
+ return tokens;
+};
diff --git a/node_modules/postcss-discard-comments/src/lib/commentRemover.js b/node_modules/postcss-discard-comments/src/lib/commentRemover.js
new file mode 100644
index 00000000..6d0dd81b
--- /dev/null
+++ b/node_modules/postcss-discard-comments/src/lib/commentRemover.js
@@ -0,0 +1,32 @@
+'use strict';
+
+/** @param {import('../index.js').Options} options */
+function CommentRemover(options) {
+ this.options = options;
+}
+/**
+ * @param {string} comment
+ * @return {boolean | undefined}
+ */
+CommentRemover.prototype.canRemove = function (comment) {
+ const remove = this.options.remove;
+
+ if (remove) {
+ return remove(comment);
+ } else {
+ const isImportant = comment.indexOf('!') === 0;
+
+ if (!isImportant) {
+ return true;
+ }
+
+ if (this.options.removeAll || this._hasFirst) {
+ return true;
+ } else if (this.options.removeAllButFirst && !this._hasFirst) {
+ this._hasFirst = true;
+ return false;
+ }
+ }
+};
+
+module.exports = CommentRemover;
diff --git a/node_modules/postcss-discard-comments/types/index.d.ts b/node_modules/postcss-discard-comments/types/index.d.ts
new file mode 100644
index 00000000..39c3d5e4
--- /dev/null
+++ b/node_modules/postcss-discard-comments/types/index.d.ts
@@ -0,0 +1,21 @@
+export = pluginCreator;
+/** @typedef {object} Options
+ * @property {boolean=} removeAll
+ * @property {boolean=} removeAllButFirst
+ * @property {(s: string) => boolean=} remove
+ */
+/**
+ * @type {import('postcss').PluginCreator<Options>}
+ * @param {Options} opts
+ * @return {import('postcss').Plugin}
+ */
+declare function pluginCreator(opts?: Options): import('postcss').Plugin;
+declare namespace pluginCreator {
+ export { postcss, Options };
+}
+type Options = {
+ removeAll?: boolean | undefined;
+ removeAllButFirst?: boolean | undefined;
+ remove?: ((s: string) => boolean) | undefined;
+};
+declare var postcss: true;
diff --git a/node_modules/postcss-discard-comments/types/lib/commentParser.d.ts b/node_modules/postcss-discard-comments/types/lib/commentParser.d.ts
new file mode 100644
index 00000000..72ab9a95
--- /dev/null
+++ b/node_modules/postcss-discard-comments/types/lib/commentParser.d.ts
@@ -0,0 +1,2 @@
+declare function _exports(input: string): [number, number, number][];
+export = _exports;
diff --git a/node_modules/postcss-discard-comments/types/lib/commentRemover.d.ts b/node_modules/postcss-discard-comments/types/lib/commentRemover.d.ts
new file mode 100644
index 00000000..c1ef01b0
--- /dev/null
+++ b/node_modules/postcss-discard-comments/types/lib/commentRemover.d.ts
@@ -0,0 +1,14 @@
+export = CommentRemover;
+/** @param {import('../index.js').Options} options */
+declare function CommentRemover(options: import('../index.js').Options): void;
+declare class CommentRemover {
+ /** @param {import('../index.js').Options} options */
+ constructor(options: import('../index.js').Options);
+ options: import("../index.js").Options;
+ /**
+ * @param {string} comment
+ * @return {boolean | undefined}
+ */
+ canRemove(comment: string): boolean | undefined;
+ _hasFirst: boolean | undefined;
+}