@re-reduced/biome-plugin 0.2.0

package/README.md

@@ -0,0 +1,26 @@
+# @re-reduced/biome-plugin
+
+Biome [GritQL](https://biomejs.dev/linter/plugins/) lint rules for the
+`re-reduced` container API — catching **type-valid but semantically-wrong**
+usage that TypeScript can't see.
+
+## Rules
+
+- **no-unstable-selector** — a `useSelect` selector that returns a fresh object
+  or array literal (`(s) => ({ … })` / `(s) => [ … ]`). It type-checks, but
+  produces a new reference every call, defeating the snapshot bail-out so the
+  component re-renders on **every** store update. Return a primitive or stable
+  reference, or split into multiple `useSelect` calls.
+
+## Usage
+
+```jsonc
+// biome.json
+{
+  "plugins": [
+    "./node_modules/@re-reduced/biome-plugin/rules/no-unstable-selector.grit"
+  ]
+}
+```
+
+Requires `@biomejs/biome >= 2.0`.

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@re-reduced/biome-plugin",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "Biome GritQL plugin: lint rules for the re-reduced container API.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alanrsoares/re-reduced.git",
+    "directory": "packages/biome-plugin"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "rules"
+  ],
+  "exports": {
+    "./rules/no-unstable-selector.grit": "./rules/no-unstable-selector.grit"
+  },
+  "scripts": {
+    "test": "bun test"
+  },
+  "peerDependencies": {
+    "@biomejs/biome": ">=2.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.0"
+  }
+}

package/rules/no-unstable-selector.grit

@@ -0,0 +1,21 @@
+// @re-reduced/biome-plugin: no-unstable-selector
+//
+// TypeScript can't catch this: a `useSelect` selector that returns a fresh
+// object or array literal type-checks fine, but produces a new reference on
+// every call — defeating the snapshot bail-out, so the component re-renders on
+// EVERY store update. Return a primitive or a stable reference, or split into
+// multiple `useSelect` calls.
+
+engine biome(1.0)
+language js
+
+or {
+  `useSelect($store, ($args) => ({ $props }))` as $sel,
+  `useSelect($store, ($args) => [$elems])` as $sel
+} where {
+  register_diagnostic(
+    span = $sel,
+    message = "useSelect selector returns a fresh object/array each call — this defeats the bail-out and re-renders on every update. Return a primitive/stable ref, or use multiple useSelect calls.",
+    severity = "warn"
+  )
+}