@dhzh/eslint-plugin-better-tailwindcss 0.0.0-stage → 4.9.0-patch

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Roger Schönbächler
+
+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.

package/README.md

@@ -1,3 +1,248 @@
-# Temporary Holding Version
+<div align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="./assets/eslint-plugin-better-tailwindcss-logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="./assets/eslint-plugin-better-tailwindcss-logo-light.svg">
+    <img alt="eslint-plugin-better-tailwindcss logo" src="./assets/eslint-plugin-better-tailwindcss-logo.svg">
+  </picture>
+</div>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<h1 align="center">eslint-plugin-better-tailwindcss</h1>
+
+<br/>
+<br/>
+
+<div align="center">
+  <a alt="GitHub license" href="https://github.com/schoero/eslint-plugin-better-tailwindcss/blob/main/LICENSE"><picture><source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/license/schoero/eslint-plugin-better-tailwindcss?style=flat-square&labelColor=32363B&color=ffffff" /><source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/github/license/schoero/eslint-plugin-better-tailwindcss?style=flat-square&labelColor=EBEEF2&color=000000" /><img alt="eslint-plugin-better-tailwindcss logo" src="https://img.shields.io/github/license/schoero/eslint-plugin-better-tailwindcss?style=flat-square&labelColor=EBEEF2&color=000000" /></picture></a>
+  <a alt="npm version" href="https://www.npmjs.com/package/eslint-plugin-better-tailwindcss?activeTab=versions"><picture><source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/npm/v/eslint-plugin-better-tailwindcss?style=flat-square&labelColor=32363B&color=ffffff" /><source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/npm/v/eslint-plugin-better-tailwindcss?style=flat-square&labelColor=EBEEF2&color=000000" /><img alt="eslint-plugin-better-tailwindcss logo" src="https://img.shields.io/npm/v/eslint-plugin-better-tailwindcss?style=flat-square&labelColor=EBEEF2&color=000000" /></picture></a>
+  <a alt="GitHub issues" href="https://github.com/schoero/eslint-plugin-better-tailwindcss/issues"><picture><source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/issues/schoero/eslint-plugin-better-tailwindcss?style=flat-square&labelColor=32363B&color=ffffff" /><source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/github/issues/schoero/eslint-plugin-better-tailwindcss?style=flat-square&labelColor=EBEEF2&color=000000" /><img alt="eslint-plugin-better-tailwindcss logo" src="https://img.shields.io/github/issues/schoero/eslint-plugin-better-tailwindcss?style=flat-square&labelColor=EBEEF2&color=000000" /></picture></a>
+  <a alt="npm total downloads" href="https://www.npmjs.com/package/eslint-plugin-better-tailwindcss?activeTab=readme"><picture><source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/npm/dt/eslint-plugin-better-tailwindcss?style=flat-square&labelColor=32363B&color=ffffff" /><source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/npm/dt/eslint-plugin-better-tailwindcss?style=flat-square&labelColor=EBEEF2&color=000000" /><img alt="eslint-plugin-better-tailwindcss logo" src="https://img.shields.io/npm/dt/eslint-plugin-better-tailwindcss?style=flat-square&labelColor=EBEEF2&color=000000" /></picture></a>
+  <a alt="GitHub repo stars" href="https://github.com/schoero/eslint-plugin-better-tailwindcss/stargazers"><picture><source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/stars/schoero/eslint-plugin-better-tailwindcss?style=flat-square&labelColor=32363B&color=ffffff" /><source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/github/stars/schoero/eslint-plugin-better-tailwindcss?style=flat-square&labelColor=EBEEF2&color=000000" /><img alt="eslint-plugin-better-tailwindcss logo" src="https://img.shields.io/github/stars/schoero/eslint-plugin-better-tailwindcss?style=flat-square&labelColor=EBEEF2&color=000000"/></picture></a>
+  <a alt="GitHub sponsors" href="https://github.com/sponsors/schoero"><picture><source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/sponsors/schoero?style=flat-square&labelColor=32363B&color=ffffff" /><source media="(prefers-color-scheme: light)" srcset="hhttps://img.shields.io/github/sponsors/schoero?style=flat-square&labelColor=EBEEF2&color=000000" /><img alt="eslint-plugin-better-tailwindcss logo" src="https://img.shields.io/github/sponsors/schoero?style=flat-square&labelColor=EBEEF2&color=000000" /></picture></a>
+</div>
+
+<br/>
+<br/>
+
+ESLint/Oxlint plugin with formatting and linting rules to help you write cleaner, more maintainable Tailwind CSS.  
+
+The formatting rules focus on improving readability by automatically breaking up long Tailwind class strings into multiple lines and sorting/grouping them in a logical order. The linting rules enforce best practices and catch potential issues, ensuring that you're writing valid Tailwind CSS.  
+
+This plugin supports a wide range of projects, including React, Solid.js, Qwik, Svelte, Vue, Astro, Angular, HTML or plain JavaScript or TypeScript.  
+
+<br/>
+<br/>
+
+<div align="center">
+  <img alt="eslint-plugin-better-tailwindcss example" width="640px" src="./assets/eslint-plugin-better-tailwindcss-demo.png">
+</div>
+
+<br/>
+<br/>
+
+<div align="center">
+
+  <a href="https://github.com/sponsors/schoero">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="./assets/sponsor-dark.svg">
+      <source media="(prefers-color-scheme: light)" srcset="./assets/sponsor-light.svg">
+      <img alt="eslint-plugin-better-tailwindcss logo" src="./assets/sponsor-light.svg">
+    </picture>
+  </a>
+  
+  <br/>
+  <br/>
+  
+  [Buy me a coffee](https://buymeacoffee.com/schoero) | [GitHub Sponsors](https://github.com/sponsors/schoero)
+  
+  Help support this project.  
+  If you or your company benefit from this project, please consider becoming a sponsor or making a one-time donation.  
+  Your contribution will help me to maintain and develop the project.
+
+</div>
+
+<br/>
+<br/>
+
+## Installation
+
+```sh
+npm i -D eslint-plugin-better-tailwindcss
+```
+
+<br/>
+
+## Quick start
+
+Depending on the flavor you are using, you need to install and configure the corresponding parser:
+
+- React: [.jsx](docs/parsers/jsx.md) · [.tsx](docs/parsers/tsx.md)  
+- SolidJS: [.jsx](docs/parsers/jsx.md) · [.tsx](docs/parsers/tsx.md)  
+- Qwik: [.jsx](docs/parsers/jsx.md) · [.tsx](docs/parsers/tsx.md)  
+- Svelte: [.svelte](docs/parsers/svelte.md)  
+- Vue: [.vue](docs/parsers/vue.md)  
+- Astro: [.astro](docs/parsers/astro.md)  
+- Angular: [.html, .ts](docs/parsers/angular.md)  
+- HTML: [.html](docs/parsers/html.md)  
+- CSS: [.css](docs/parsers/css.md)  
+- JavaScript: [.js](docs/parsers/javascript.md)  
+- TypeScript: [.ts](docs/parsers/typescript.md)  
+
+<br/>
+<br/>
+
+### Rules
+
+The rules are categorized into two types: `stylistic` and `correctness`.
+
+#### Configs
+
+The plugin offers three recommended configurations to help you get started quickly:
+  
+- `stylistic`: Enforces stylistic rules for tailwind classes.
+- `correctness`: Enforces correctness rules for tailwind classes.
+- `recommended`: Enforces both stylistic and correctness rules.
+  
+By default:
+
+- `stylistic` rules are reported as warnings
+- `correctness` rules are reported as errors
+  
+You can change the severity by adding a suffix to the config name:
+  
+- Use `-error` to report all rules as errors
+- Use `-warn` to report all rules as warnings
+  
+For example, `recommended-warn` will report every rule as a warning and `stylistic-error` will report the formatting rules as errors.
+  
+If you still use the old .eslintrc configuration format, you can prefix the config names with `legacy-`.
+
+For example, `legacy-recommended` or `legacy-correctness-warn`.
+
+The table below lists all available rules, the Tailwind CSS versions they support, and whether they are enabled by default in each recommended configuration:
+
+<br/>
+<br/>
+
+#### Stylistic rules
+
+| Name | Description | `tw3` | `tw4` | `recommended` | autofix |
+| :--- | :--- | :---: | :---: | :---: | :---: |
+| [enforce-consistent-line-wrapping](docs/rules/enforce-consistent-line-wrapping.md) | Enforce consistent line wrapping for tailwind classes. | ✔ | ✔ | ✔ | ✔ |
+| [enforce-consistent-class-order](docs/rules/enforce-consistent-class-order.md) | Enforce a consistent order for tailwind classes. | ✔ | ✔ | ✔ | ✔ |
+| [enforce-consistent-variant-order](docs/rules/enforce-consistent-variant-order.md) | Enforce a consistent variant order for tailwind classes. |  | ✔ |  | ✔ |
+| [enforce-consistent-variable-syntax](docs/rules/enforce-consistent-variable-syntax.md) | Enforce consistent variable syntax. | ✔ | ✔ |  | ✔ |
+| [enforce-consistent-important-position](docs/rules/enforce-consistent-important-position.md) | Enforce consistent position of the important modifier. | ✔ | ✔ |  | ✔ |
+| [enforce-shorthand-classes](docs/rules/enforce-shorthand-classes.md) | Enforce shorthand class names. | ✔ | ✔ |  | ✔ |
+| [enforce-logical-properties](docs/rules/enforce-logical-properties.md) | Enforce logical property class names. | ✔ | ✔ |  | ✔ |
+| [enforce-canonical-classes](docs/rules/enforce-canonical-classes.md) | Enforce canonical class names. |  | ✔ | ✔ | ✔ |
+| [no-duplicate-classes](docs/rules/no-duplicate-classes.md) | Remove duplicate classes. | ✔ | ✔ | ✔ | ✔ |
+| [no-deprecated-classes](docs/rules/no-deprecated-classes.md) | Remove deprecated classes. |  | ✔ | ✔ | ✔ |
+| [no-unnecessary-whitespace](docs/rules/no-unnecessary-whitespace.md) | Disallow unnecessary whitespace in tailwind classes. | ✔ | ✔ | ✔ | ✔ |
+
+#### Correctness rules
+
+| Name | Description | `tw3` | `tw4` | `recommended` | autofix |
+| :--- | :--- | :---: | :---: | :---: | :---: |
+| [no-concatenated-classes](docs/rules/no-concatenated-classes.md) | Disallow concatenated classes in Tailwind CSS class strings. | ✔ | ✔ | ✔ |  |
+| [no-unknown-classes](docs/rules/no-unknown-classes.md) | Report classes not registered with Tailwind CSS. | ✔ | ✔ | ✔ |  |
+| [no-conflicting-classes](docs/rules/no-conflicting-classes.md) | Report classes that produce conflicting styles. |  | ✔ | ✔ |  |
+| [no-restricted-classes](docs/rules/no-restricted-classes.md) | Disallow restricted classes. | ✔ | ✔ |  | ✔ |
+
+<br/>
+<br/>
+
+### Utilities
+
+This plugin is pre-configured to lint tailwind classes for the most popular utilities:
+
+- [tailwind merge](https://github.com/dcastil/tailwind-merge): `twMerge` · `twJoin`
+- [class variance authority](https://github.com/joe-bell/cva): `cva`
+- [tailwind variants](https://github.com/nextui-org/tailwind-variants?tab=readme-ov-file): `tv`
+- [shadcn](https://ui.shadcn.com/docs/installation/manual): `cn`
+- [classcat](https://github.com/jorgebucaran/classcat): `cc`
+- [class list builder](https://github.com/crswll/clb): `clb`
+- [clsx](https://github.com/lukeed/clsx): `clsx`
+- [cnbuilder](https://github.com/xobotyi/cnbuilder): `cnb`
+- [classnames template literals](https://github.com/netlify/classnames-template-literals): `ctl`
+- [obj str](https://github.com/lukeed/obj-str): `objstr`
+- [react-twc](https://github.com/gregberge/twc): `twc` · `twx`
+
+<br/>
+<br/>
+
+### Advanced configuration
+
+If an utility is not supported by default, or you want to customize the configuration, you can define which [attributes](./docs/configuration/advanced.md#attribute), [callees](./docs/configuration/advanced.md#callee), [variables](./docs/configuration/advanced.md#variable), and [tags](./docs/configuration/advanced.md#tag) should get linted.  
+See the [Advanced configuration guide](./docs/configuration/advanced.md) to learn how to override or extend the default settings.
+
+<br/>
+<br/>
+
+### Monorepo setup
+
+In monorepos, linting is often started from the repository root while each package has its own Tailwind setup.
+You can configure `settings["better-tailwindcss"].cwd` per file group so the plugin resolves `tailwindcss` and config files from the correct project directory.
+
+```js
+// eslint.config.js
+export default [
+  {
+    files: ["packages/website/**/*.{js,jsx,cjs,mjs,ts,tsx}"],
+    settings: {
+      "better-tailwindcss": {
+        cwd: "./packages/website"
+      }
+    }
+  },
+  {
+    files: ["packages/app/**/*.{js,jsx,cjs,mjs,ts,tsx}"],
+    settings: {
+      "better-tailwindcss": {
+        cwd: "./packages/app"
+      }
+    }
+  }
+];
+```
+
+See [Settings](./docs/settings/settings.md#cwd) for more details.
+
+<br/>
+<br/>
+
+### Editor configuration
+
+#### VSCode
+
+##### Auto-fix on save
+
+Most rules are intended to automatically fix the tailwind classes using VSCode extensions.
+
+###### ESLint
+
+For ESLint, you can install the [VSCode ESLint plugin](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) and configure it to automatically fix the classes on save by adding the following options to your `.vscode/settings.json`:
+
+```jsonc
+{
+  // enable VSCode to fix tailwind classes on save
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  }
+}
+```
+
+###### Oxlint
+
+For Oxlint, you can install the [VSCode Oxc plugin](https://marketplace.visualstudio.com/items?itemName=oxc.oxc-vscode) and configure it to automatically fix the classes on save by adding the following options to your `.vscode/settings.json`:
+
+```jsonc
+{
+  // enable VSCode to fix tailwind classes on save
+  "editor.codeActionsOnSave": {
+    "source.fixAll.oxc": "explicit"
+  }
+}
+```
+
+<br/>
+<br/>

package/lib/api/defaults.d.ts

@@ -0,0 +1,103 @@
+import { SelectorKind } from "../types/rule.js";
+/**
+ * @deprecated Migrate to selectors instead.
+ */
+export declare function getDefaultCallees(): (string | [string, ({
+    match: import("../types/rule.js").MatcherType.String;
+} | {
+    match: import("../types/rule.js").MatcherType.ObjectKey;
+    pathPattern?: string | undefined;
+} | {
+    match: import("../types/rule.js").MatcherType.ObjectValue;
+    pathPattern?: string | undefined;
+})[]])[];
+/**
+ * @deprecated Migrate to selectors instead.
+ */
+export declare function getDefaultAttributes(): (string | [string, ({
+    match: import("../types/rule.js").MatcherType.String;
+} | {
+    match: import("../types/rule.js").MatcherType.ObjectKey;
+    pathPattern?: string | undefined;
+} | {
+    match: import("../types/rule.js").MatcherType.ObjectValue;
+    pathPattern?: string | undefined;
+})[]])[];
+/**
+ * @deprecated Migrate to selectors instead.
+ */
+export declare function getDefaultVariables(): (string | [string, ({
+    match: import("../types/rule.js").MatcherType.String;
+} | {
+    match: import("../types/rule.js").MatcherType.ObjectKey;
+    pathPattern?: string | undefined;
+} | {
+    match: import("../types/rule.js").MatcherType.ObjectValue;
+    pathPattern?: string | undefined;
+})[]])[];
+/**
+ * @deprecated Migrate to selectors instead.
+ */
+export declare function getDefaultTags(): (string | [string, ({
+    match: import("../types/rule.js").MatcherType.String;
+} | {
+    match: import("../types/rule.js").MatcherType.ObjectKey;
+    pathPattern?: string | undefined;
+} | {
+    match: import("../types/rule.js").MatcherType.ObjectValue;
+    pathPattern?: string | undefined;
+})[]])[];
+export declare function getDefaultSelectors(): ({
+    kind: SelectorKind.Callee;
+    match: {
+        type: import("../types/rule.js").MatcherType.String;
+    }[];
+    name: string;
+} | {
+    kind: SelectorKind.Callee;
+    match: {
+        type: import("../types/rule.js").MatcherType.ObjectKey;
+    }[];
+    name: string;
+} | {
+    kind: SelectorKind.Callee;
+    match: {
+        path: string;
+        type: import("../types/rule.js").MatcherType.ObjectValue;
+    }[];
+    name: string;
+} | {
+    kind: SelectorKind.Tag;
+    path: string;
+} | {
+    kind: SelectorKind.Callee;
+    match: ({
+        type: import("../types/rule.js").MatcherType.String;
+        match?: never;
+    } | {
+        match: {
+            type: import("../types/rule.js").MatcherType.String;
+        }[];
+        type: import("../types/rule.js").MatcherType.AnonymousFunctionReturn;
+    })[];
+    path: string;
+} | {
+    kind: SelectorKind.Attribute;
+    name: string;
+    match?: never;
+} | {
+    kind: SelectorKind.Attribute;
+    match: ({
+        type: import("../types/rule.js").MatcherType.String;
+    } | {
+        type: import("../types/rule.js").MatcherType.ObjectKey;
+    })[];
+    name: string;
+} | {
+    kind: SelectorKind.Variable;
+    match: {
+        type: import("../types/rule.js").MatcherType.String;
+    }[];
+    name: string;
+})[];
+//# sourceMappingURL=defaults.d.ts.map

package/lib/api/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/api/defaults.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAQhE;;GAEG;AACH,wBAAgB,iBAAiB;;;;;;;;SAIhC;AAED;;GAEG;AACH,wBAAgB,oBAAoB;;;;;;;;SAInC;AAED;;GAEG;AACH,wBAAgB,mBAAmB;;;;;;;;SAIlC;AAED;;GAEG;AACH,wBAAgB,cAAc;;;;;;;;SAI7B;AAED,wBAAgB,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAElC"}

package/lib/api/defaults.js

@@ -0,0 +1,34 @@
+/* eslint-disable eslint-plugin-jsdoc/require-returns */
+/* eslint-disable eslint-plugin-jsdoc/require-description */
+import { DEFAULT_SELECTORS } from "../options/default-options.js";
+import { migrateFlatSelectorsToLegacySelectors } from "../options/migrate.js";
+import { SelectorKind } from "../types/rule.js";
+import { isSelectorKind } from "../utils/selectors.js";
+/**
+ * @deprecated Migrate to selectors instead.
+ */
+export function getDefaultCallees() {
+    return migrateFlatSelectorsToLegacySelectors(DEFAULT_SELECTORS.filter(isSelectorKind(SelectorKind.Callee))).callees ?? [];
+}
+/**
+ * @deprecated Migrate to selectors instead.
+ */
+export function getDefaultAttributes() {
+    return migrateFlatSelectorsToLegacySelectors(DEFAULT_SELECTORS.filter(isSelectorKind(SelectorKind.Attribute))).attributes ?? [];
+}
+/**
+ * @deprecated Migrate to selectors instead.
+ */
+export function getDefaultVariables() {
+    return migrateFlatSelectorsToLegacySelectors(DEFAULT_SELECTORS.filter(isSelectorKind(SelectorKind.Variable))).variables ?? [];
+}
+/**
+ * @deprecated Migrate to selectors instead.
+ */
+export function getDefaultTags() {
+    return migrateFlatSelectorsToLegacySelectors(DEFAULT_SELECTORS.filter(isSelectorKind(SelectorKind.Tag))).tags ?? [];
+}
+export function getDefaultSelectors() {
+    return DEFAULT_SELECTORS;
+}
+//# sourceMappingURL=defaults.js.map

package/lib/api/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/api/defaults.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,4DAA4D;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,EAAE,qCAAqC,EAAE,MAAM,uCAAuC,CAAC;AAC9F,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAOvE;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,qCAAqC,CAC1C,iBAAiB,CAAC,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAC9D,CAAC,OAAO,IAAI,EAAoB,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,qCAAqC,CAC1C,iBAAiB,CAAC,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CACjE,CAAC,UAAU,IAAI,EAAuB,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,qCAAqC,CAC1C,iBAAiB,CAAC,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAChE,CAAC,SAAS,IAAI,EAAsB,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,qCAAqC,CAC1C,iBAAiB,CAAC,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAC3D,CAAC,IAAI,IAAI,EAAiB,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/lib/api/types.d.ts

@@ -0,0 +1,9 @@
+export type { Settings } from "../options/descriptions.js";
+export type { ArgumentTarget, CallTarget } from "../types/rule.js";
+export { MatcherType } from "../types/rule.js";
+export type { Matcher, ObjectKeyMatcher, ObjectValueMatcher, StringMatcher } from "../types/rule.js";
+export { SelectorKind } from "../types/rule.js";
+export type { AttributeSelector, CalleeSelector, Selector, TagSelector, VariableSelector } from "../types/rule.js";
+export type { SelectorAnonymousFunctionReturnMatcher, SelectorMatcher, SelectorObjectKeyMatcher, SelectorObjectValueMatcher, SelectorStringMatcher } from "../types/rule.js";
+export type { Regex, Selectors } from "../types/rule.js";
+//# sourceMappingURL=types.d.ts.map

package/lib/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,QAAQ,EAAE,MAAM,4CAA4C,CAAC;AAG3E,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAGnF,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGrH,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACnI,YAAY,EAAE,sCAAsC,EAAE,eAAe,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAG7L,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC"}

package/lib/api/types.js

@@ -0,0 +1,5 @@
+/* Legacy Matchers */
+export { MatcherType } from "../types/rule.js";
+/* Selector */
+export { SelectorKind } from "../types/rule.js";
+//# sourceMappingURL=types.js.map

package/lib/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAMA,qBAAqB;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAG/D,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC"}

package/lib/async-utils/cache.d.ts

@@ -0,0 +1,30 @@
+import type { AsyncContext } from "../utils/context.js";
+interface CacheItem {
+    date: Date;
+    value: any;
+}
+export declare function invalidateByModifiedDate(cache: CacheItem, path: string | undefined): boolean;
+export declare function withCache<Result>(key: string, path: string | undefined, callback: () => Result, invalidate?: (cache: CacheItem, path: string | undefined) => boolean): Result;
+export declare function withCache<Result>(key: string, path: string | undefined, callback: () => Promise<Result>, invalidate?: (cache: CacheItem, path: string | undefined) => boolean): Promise<Result>;
+/**
+ * Caches worker operation results.
+ *
+ * @template Operation The signature of the wrapped operation.
+ * @param name Unique name of the operation, used as part of the cache key.
+ * @param operation The operation to cache.
+ * @returns The wrapped operation.
+ */
+export declare function withOperationCache<Operation extends (ctx: AsyncContext, ...args: any[]) => any>(name: string, operation: Operation): Operation;
+/**
+ * Caches an operation that filters a class list per class.
+ *
+ * @param key Unique name of the operation, used as part of the cache key.
+ * @param path Path of the file to watch for changes.
+ * @param classes The classes to filter.
+ * @param filterClasses The operation, called with the classes that have no cached verdict yet.
+ * @returns The classes for which the operation's verdict is positive, in input order.
+ */
+export declare function withPerClassCache(key: string, path: string | undefined, classes: string[], filterClasses: (uncachedClasses: string[]) => string[]): string[];
+export declare function clearCache(): void;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/lib/async-utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/async-utils/cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,UAAU,SAAS;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,GAAG,CAAC;CACZ;AAkDD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAQ5F;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,GAAG,MAAM,CAAC;AAC/K,wBAAgB,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAsBjM;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,CAM9I;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,GAAG,MAAM,EAAE,CAmC5J;AAED,wBAAgB,UAAU,SAGzB"}

package/lib/async-utils/cache.js

@@ -0,0 +1,116 @@
+import { getModifiedDate } from "./fs.js";
+class LruCache {
+    constructor(maxSize) {
+        this.cache = new Map();
+        this.maxSize = maxSize;
+    }
+    get(key) {
+        const item = this.cache.get(key);
+        if (item) {
+            // fresh access, move to the end
+            this.cache.delete(key);
+            this.cache.set(key, item);
+        }
+        return item;
+    }
+    set(key, item) {
+        // fresh write, move to the end if present
+        this.cache.delete(key);
+        this.cache.set(key, item);
+        // size limit
+        if (this.cache.size > this.maxSize) {
+            const oldestKey = this.cache.keys().next().value;
+            if (oldestKey !== undefined) {
+                this.cache.delete(oldestKey);
+            }
+        }
+    }
+    clear() {
+        this.cache.clear();
+    }
+}
+// operation results and resolved configs are few but potentially large
+const CACHE = new LruCache(1000);
+// per-class verdicts are booleans, but every distinct class name ever seen creates an entry
+const CLASS_CACHE = new LruCache(20000);
+export function invalidateByModifiedDate(cache, path) {
+    // without a path there is no file to watch for staleness
+    // the entry stays cached until clearCache() or lru eviction
+    // this requires callers to encode everything the callback depends on in the key
+    if (!path) {
+        return false;
+    }
+    const modified = getModifiedDate(path);
+    return modified > cache.date;
+}
+export function withCache(key, path, callback, invalidate = invalidateByModifiedDate) {
+    const cacheKey = `${key}-${path}`;
+    const cached = CACHE.get(cacheKey);
+    if (cached && !invalidate(cached, path)) {
+        return cached.value;
+    }
+    const value = callback();
+    if (value instanceof Promise) {
+        return value.then(resolvedValue => {
+            CACHE.set(cacheKey, { date: new Date(), value: resolvedValue });
+            return resolvedValue;
+        });
+    }
+    else {
+        CACHE.set(cacheKey, { date: new Date(), value });
+        return value;
+    }
+}
+/**
+ * Caches worker operation results.
+ *
+ * @template Operation The signature of the wrapped operation.
+ * @param name Unique name of the operation, used as part of the cache key.
+ * @param operation The operation to cache.
+ * @returns The wrapped operation.
+ */
+export function withOperationCache(name, operation) {
+    return ((ctx, ...args) => withCache(`${name}-${ctx.cwd}-${ctx.tsconfigPath}-${JSON.stringify(args)}`, ctx.tailwindConfigPath, () => operation(ctx, ...args)));
+}
+/**
+ * Caches an operation that filters a class list per class.
+ *
+ * @param key Unique name of the operation, used as part of the cache key.
+ * @param path Path of the file to watch for changes.
+ * @param classes The classes to filter.
+ * @param filterClasses The operation, called with the classes that have no cached verdict yet.
+ * @returns The classes for which the operation's verdict is positive, in input order.
+ */
+export function withPerClassCache(key, path, classes, filterClasses) {
+    const modified = path ? getModifiedDate(path) : undefined;
+    const verdicts = new Map();
+    const uncachedClasses = [];
+    for (const className of classes) {
+        if (verdicts.has(className)) {
+            continue;
+        }
+        const cached = CLASS_CACHE.get(`${key}-${className}-${path}`);
+        if (cached && !(modified && modified > cached.date)) {
+            verdicts.set(className, cached.value);
+        }
+        else {
+            uncachedClasses.push(className);
+            verdicts.set(className, false);
+        }
+    }
+    if (uncachedClasses.length > 0) {
+        const matchedClasses = new Set(filterClasses(uncachedClasses));
+        const date = new Date();
+        for (const className of uncachedClasses) {
+            const value = matchedClasses.has(className);
+            verdicts.set(className, value);
+            CLASS_CACHE.set(`${key}-${className}-${path}`, { date, value });
+        }
+    }
+    return classes.filter(className => verdicts.get(className));
+}
+export function clearCache() {
+    CACHE.clear();
+    CLASS_CACHE.clear();
+}
+//# sourceMappingURL=cache.js.map

package/lib/async-utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/async-utils/cache.ts"],"names":[],"mappings":"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"}

package/lib/async-utils/escape.d.ts

@@ -0,0 +1,2 @@
+export declare function escapeForRegex(word: string): string;
+//# sourceMappingURL=escape.d.ts.map

package/lib/async-utils/escape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../../src/async-utils/escape.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,UAE1C"}

package/lib/async-utils/escape.js

@@ -0,0 +1,5 @@
+import { getCachedRegex } from "./regex.js";
+export function escapeForRegex(word) {
+    return word.replace(getCachedRegex(/[$()*+./?[\\\]^{|}-]/g), "\\$&");
+}
+//# sourceMappingURL=escape.js.map

package/lib/async-utils/escape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.js","sourceRoot":"","sources":["../../src/async-utils/escape.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC,CAAC;AACvE,CAAC"}

package/lib/async-utils/fs.d.ts

@@ -0,0 +1,3 @@
+export declare function findPathRecursive(cwd: string, startDirectory: string, entries: string[]): string | undefined;
+export declare function getModifiedDate(filePath: string): Date;
+//# sourceMappingURL=fs.d.ts.map

package/lib/async-utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/async-utils/fs.ts"],"names":[],"mappings":"AAIA,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAqB5G;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOtD"}