postcss-normalize-charset 5.0.3 → 6.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postcss-normalize-charset",
-  "version": "5.0.3",
+  "version": "6.0.0",
   "description": "Add necessary or remove extra charset with PostCSS",
   "keywords": [
     "postcss",
@@ -11,7 +11,8 @@
   "author": "Bogdan Chadkin <trysound@yandex.ru>",
   "files": [
     "src",
-    "LICENSE"
+    "LICENSE",
+    "types"
   ],
   "license": "MIT",
   "repository": "cssnano/cssnano",
@@ -20,14 +21,14 @@
   },
   "homepage": "https://github.com/cssnano/cssnano",
   "main": "src/index.js",
+  "types": "types/index.d.ts",
   "engines": {
-    "node": "^10 || ^12 || >=14.0"
+    "node": "^14 || ^16 || >=18.0"
   },
   "devDependencies": {
     "postcss": "^8.2.15"
   },
   "peerDependencies": {
     "postcss": "^8.2.15"
-  },
-  "readme": "# postcss-normalize-charset\n\nAdd necessary or remove extra charset with PostCSS\n\n```css\na{\n  content: \"©\";\n}\n```\n\n```css\n@charset \"utf-8\";\na{\n  content: \"©\";\n}\n```\n\n## API\n\n### normalizeCharset([options])\n\n#### options\n\n##### add\n\nType: `boolean`  \nDefault: `true`\n\nPass `false` to stop the module from adding a `@charset` declaration if it was\nmissing from the file (and the file contained non-ascii characters).\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 © [Bogdan Chadkin](mailto:trysound@yandex.ru)\n"
+  }
 }

package/src/index.js

@@ -3,12 +3,22 @@ const charset = 'charset';
 // eslint-disable-next-line no-control-regex
 const nonAscii = /[^\x00-\x7F]/;
 
+/**
+ * @typedef {{add?: boolean}} Options
+ */
+/**
+ * @type {import('postcss').PluginCreator<Options>}
+ * @param {Options} opts
+ * @return {import('postcss').Plugin}
+ */
 function pluginCreator(opts = {}) {
   return {
     postcssPlugin: 'postcss-normalize-' + charset,
 
     OnceExit(css, { AtRule }) {
+      /** @type {import('postcss').AtRule | undefined} */
       let charsetRule;
+      /** @type {import('postcss').Node | undefined} */
       let nonAsciiNode;
 
       css.walk((node) => {

package/types/index.d.ts

@@ -0,0 +1,17 @@
+export = pluginCreator;
+/**
+ * @typedef {{add?: boolean}} Options
+ */
+/**
+ * @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 = {
+    add?: boolean;
+};
+declare var postcss: true;