feat: add TypeScript definitions and update package.json

Author: hex-ci

index.d.ts

@@ -0,0 +1,66 @@
+import { Plugin } from 'postcss';
+
+declare namespace PostcssUnitProcessor {
+  interface Options {
+    /**
+     * A function to process the value and unit.
+     * @param value The numeric value to process.
+     * @param unit The unit of the value (e.g., 'px', 'rem').
+     * @param node The PostCSS node being processed.
+     * @param root The root PostCSS node.
+     * @returns The processed value as a number, string, or an object with value and unit.
+     */
+    processor?: (value: number, unit: string, node: any, root: any) => number | string | { value: number | string; unit?: string };
+
+    /**
+     * The precision for rounding unit values.
+     * @default 5
+     */
+    unitPrecision?: number;
+
+    /**
+     * List of selectors to exclude from processing.
+     * @default []
+     */
+    selectorBlackList?: Array<string | RegExp>;
+
+    /**
+     * List of properties to process. Supports wildcards and negation.
+     * @default ['*']
+     */
+    propList?: string[];
+
+    /**
+     * Whether to replace the original declaration or add a new one.
+     * @default true
+     */
+    replace?: boolean;
+
+    /**
+     * Whether to process units in media queries.
+     * @default false
+     */
+    mediaQuery?: boolean;
+
+    /**
+     * Pattern or function to exclude files from processing.
+     * @default /node_modules/i
+     */
+    exclude?: RegExp | string | ((filePath: string) => boolean);
+
+    /**
+     * Custom units to support in addition to default units.
+     * @default []
+     */
+    customUnitList?: string[];
+  }
+}
+
+/**
+ * A PostCSS plugin to process units in CSS declarations and media queries.
+ * @param options Configuration options for the plugin.
+ * @returns A PostCSS plugin instance.
+ */
+declare function PostcssUnitProcessor(options?: PostcssUnitProcessor.Options): Plugin;
+
+export = PostcssUnitProcessor;

package.json

@@ -3,6 +3,13 @@
   "version": "1.1.1",
   "description": "PostCSS plugin to process css unit.",
   "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "LICENSE",
+    "README.md"
+  ],
   "scripts": {
     "test": "jest",
     "test:coverage": "jest --coverage"