eslint-plugin-recursica 0.2.0

package/README.md

@@ -0,0 +1,42 @@
+# eslint-plugin-recursica
+
+ESLint plugin enforcing Recursica design-system conventions in applications that consume the Recursica adapters.
+
+## Installation
+
+```bash
+npm install --save-dev eslint-plugin-recursica
+```
+
+## Usage
+
+Flat config (`eslint.config.js`):
+
+```js
+import recursica from "eslint-plugin-recursica";
+
+export default [
+  {
+    plugins: { recursica },
+    rules: {
+      "recursica/no-over-styled": "error",
+    },
+  },
+];
+```
+
+Or use the recommended config directly:
+
+```js
+import recursica from "eslint-plugin-recursica";
+
+export default [recursica.configs.recommended];
+```
+
+## Rules
+
+| Rule             | Description                                                           | Recommended |
+| ---------------- | --------------------------------------------------------------------- | ----------- |
+| `no-over-styled` | Disallows the `overStyled` escape-hatch prop on Recursica components. | `error`     |
+
+`no-over-styled` is a plain ESLint rule — set it to `"warn"` in your own config to downgrade it from the default `"error"`.

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export declare const rules: {
+    "no-over-styled": import("@typescript-eslint/utils/ts-eslint").RuleModule<"noOverStyled", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+};
+export declare const configs: {
+    recommended: {
+        plugins: string[];
+        rules: {
+            "recursica/no-over-styled": string;
+        };
+    };
+};
+declare const plugin: {
+    rules: {
+        "no-over-styled": import("@typescript-eslint/utils/ts-eslint").RuleModule<"noOverStyled", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+    };
+    configs: {
+        recommended: {
+            plugins: string[];
+            rules: {
+                "recursica/no-over-styled": string;
+            };
+        };
+    };
+};
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK;;CAEjB,CAAC;AAEF,eAAO,MAAM,OAAO;;;;;;;CAOnB,CAAC;AAEF,QAAA,MAAM,MAAM;;;;;;;;;;;;CAGX,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+import { noOverStyled } from "./rules/no-over-styled.js";
+export const rules = {
+    "no-over-styled": noOverStyled,
+};
+export const configs = {
+    recommended: {
+        plugins: ["recursica"],
+        rules: {
+            "recursica/no-over-styled": "error",
+        },
+    },
+};
+const plugin = {
+    rules,
+    configs,
+};
+export default plugin;

package/dist/rules/no-over-styled.d.ts

@@ -0,0 +1,3 @@
+import { ESLintUtils } from "@typescript-eslint/utils";
+export declare const noOverStyled: ESLintUtils.RuleModule<"noOverStyled", [], unknown, ESLintUtils.RuleListener>;
+//# sourceMappingURL=no-over-styled.d.ts.map

package/dist/rules/no-over-styled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-over-styled.d.ts","sourceRoot":"","sources":["../../src/rules/no-over-styled.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAIvD,eAAO,MAAM,YAAY,+EAuBvB,CAAC"}

package/dist/rules/no-over-styled.js

@@ -0,0 +1,24 @@
+import { ESLintUtils } from "@typescript-eslint/utils";
+const createRule = ESLintUtils.RuleCreator.withoutDocs;
+export const noOverStyled = createRule({
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Disallow the `overStyled` escape-hatch prop on Recursica components.",
+        },
+        schema: [],
+        messages: {
+            noOverStyled: "`overStyled` bypasses Recursica's design-token sandboxing and should only exist as short-term technical debt (see OVERSTYLING.md). Remove it or refactor to use a supported Recursica variant/prop instead.",
+        },
+    },
+    defaultOptions: [],
+    create(context) {
+        return {
+            JSXAttribute(node) {
+                if (node.name.type === "JSXIdentifier" && node.name.name === "overStyled") {
+                    context.report({ node, messageId: "noOverStyled" });
+                }
+            },
+        };
+    },
+});

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "eslint-plugin-recursica",
+  "version": "0.2.0",
+  "description": "ESLint plugin enforcing Recursica design-system conventions in consuming applications.",
+  "private": false,
+  "homepage": "https://github.com/borderux/recursica/tree/main/packages/eslint-plugin",
+  "author": "hi@borderux.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/borderux/recursica.git",
+    "directory": "packages/eslint-plugin"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "eslint",
+    "eslintplugin",
+    "eslint-plugin",
+    "recursica"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "lint": "eslint .",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "eslint": "^8.57.0 || ^9.0.0"
+  },
+  "dependencies": {
+    "@typescript-eslint/utils": "^8.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.28.0",
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/rule-tester": "^8.68.0",
+    "eslint": "^9.28.0",
+    "globals": "^16.2.0",
+    "typescript": "~5.8.3",
+    "typescript-eslint": "^8.33.0",
+    "vitest": "^3.2.4"
+  },
+  "license": "MIT"
+}