@onrails/biome-plugin 0.1.1 → 0.1.3

package/README.md

@@ -16,7 +16,9 @@ Reference the rule files in `biome.json` plugins:
 {
   "plugins": [
     "./node_modules/@onrails/biome-plugin/rules/no-promise-result.grit",
-    "./node_modules/@onrails/biome-plugin/rules/no-unsafe-unwrap.grit"
+    "./node_modules/@onrails/biome-plugin/rules/no-unsafe-unwrap.grit",
+    "./node_modules/@onrails/biome-plugin/rules/no-deprecated-synonyms.grit",
+    "./node_modules/@onrails/biome-plugin/rules/fluent-stays-local.grit"
   ]
 }
 ```
@@ -27,6 +29,8 @@ Reference the rule files in `biome.json` plugins:
 |------|------------------|
 | `no-promise-result` | `Promise<Result<T, E>>` in any type position — return `ResultAsync<T, E>` and use `fromAsync` / `tryAsync` at the boundary (error) |
 | `no-unsafe-unwrap`  | `._unsafeUnwrap()` / `._unsafeUnwrapErr()` calls — use `match` / `resolve` / `yieldResult` instead (error) |
+| `no-deprecated-synonyms` | Deprecated synonyms (`chain`, `fold`, `getOrElse`, `of`, …) — use the canonical names (error) |
+| `fluent-stays-local` | Bare `FluentResult<…>` / `FluentMaybe<…>` type references — broader net than the ESLint rule, see `ENGINE_DIVERGENCES` (error) |
 
 ## Tests
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onrails/biome-plugin",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "description": "Biome GritQL plugin: boundary diagnostics for @onrails/result (Promise<Result<…>>, _unsafeUnwrap*).",
   "license": "MIT",
@@ -38,7 +38,9 @@
   ],
   "exports": {
     "./rules/no-promise-result.grit": "./rules/no-promise-result.grit",
-    "./rules/no-unsafe-unwrap.grit": "./rules/no-unsafe-unwrap.grit"
+    "./rules/no-unsafe-unwrap.grit": "./rules/no-unsafe-unwrap.grit",
+    "./rules/no-deprecated-synonyms.grit": "./rules/no-deprecated-synonyms.grit",
+    "./rules/fluent-stays-local.grit": "./rules/fluent-stays-local.grit"
   },
   "scripts": {
     "typecheck": "echo 'noop (grit files only)'",

package/rules/fluent-stays-local.grit

@@ -0,0 +1,27 @@
+// @onrails/biome-plugin: fluent-stays-local
+//
+// Flag `FluentResult<T, E>` / `FluentMaybe<T>` named as a type — the fluent
+// wrapper (`@onrails/result/fluent`, `@onrails/maybe/fluent`) must open and
+// close within a function body, never escape as a return type, an exported
+// binding, or a stored field.
+//
+// Limitation: GritQL matches the bare type reference wherever it appears —
+// a broader net than the ESLint rule, which only flags the four scoped
+// positions (return type, exported binding, stored field, serialize-sink
+// argument) and inspects call-argument shape for the sink check. This rule
+// cannot express that argument heuristic at all; declared in
+// ENGINE_DIVERGENCES (`fluent-stays-local` / `no-position-scoping`).
+
+engine biome(1.0)
+language js
+
+or {
+  `FluentResult<$ok, $err>` as $t,
+  `FluentMaybe<$value>` as $t
+} where {
+  register_diagnostic(
+    span = $t,
+    message = "FluentResult/FluentMaybe must stay local — it was flagged as a return type, an exported binding, a stored field, or an argument to a serialize/postMessage/cache call. Call toResult()/toMaybe()/toString() before it leaves the function.",
+    severity = "error"
+  )
+}