Registry / devops / biome-plugin-solidjs

biome-plugin-solidjs

library0.2.2jsnpmunverified

Biome GritQL lint rules for SolidJS that catch common reactivity bugs at lint time, such as destructured props, .map() in JSX, memo in loops, top-level effects, and stored JSX. Current stable version is 0.2.2, with regular bugfix and minor feature releases. Designed as a lightweight alternative to eslint-plugin-solid that integrates directly into Biome's plugin system using GritQL pattern matching, requiring no TypeScript type inference. Opt-in rule solid-no-object-signal-without-equals is not enabled by default due to potential false positives.

devops testing

npm install biome-plugin-solidjs

github ↗package ↗

INSTALL

IMPORT

SIG · BIOME-PLUGIN-SOLID

biome-plugin-solidjs

devopsjavascriptv0.2.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

biome-plugin-solidjs (as plugin path)

✓ import { plugins } from 'biome.jsonc' and use "./node_modules/biome-plugin-solidjs"

✗ import { biomePluginSolidjs } from 'biome-plugin-solidjs'

This package does not export JavaScript modules; it provides GritQL rule files. Add it to the plugins array in biome.json(c).

solid-no-destructured-props rule

✓ Add "./node_modules/biome-plugin-solidjs" to plugins array in biome.json(c).

✗ import { solidNoDestructuredProps } from 'biome-plugin-solidjs'

Rules are not imported individually; enabling the plugin via manifest enables default rules. For opt-in rules, include the .grit file path.

Opt-in rule file (e.g., solid-no-object-signal-without-equals)

✓ "./node_modules/biome-plugin-solidjs/rules/solid-no-object-signal-without-equals.grit"

✗ "biome-plugin-solidjs/rules/solid-no-object-signal-without-equals"

Opt-in rules must reference the .grit file explicitly. Use the same path style as the main plugin path.

Setup and usage of the Biome SolidJS plugin showing installation, biome.json configuration with both default and opt-in rules, and running the linter.

// 1. Install the plugin npm install -D biome-plugin-solidjs // 2. Create or update biome.json with: { "plugins": ["./node_modules/biome-plugin-solidjs"] } // 3. (Optional) Add the opt-in rule for object signals without equals: { "plugins": ["./node_modules/biome-plugin-solidjs", "./node_modules/biome-plugin-solidjs/rules/solid-no-object-signal-without-equals.grit"] } // 4. Lint your SolidJS project: npm exec biome lint .

Debug

Known issues

gotchaThe opt-in rule solid-no-object-signal-without-equals is not enabled by default due to potential false positives with set-once-then-clear patterns.

fix

Only enable this rule if you understand its limitation and can suppress false positives.

affects: >=0.2.2

gotchaCore rules use structural heuristics and do not use TypeScript type information, so they may miss some bugs or produce false positives.

fix

For type-aware linting, consider using eslint-plugin-solid alongside this plugin.

affects: >=0.2.0

gotchaThe plugin requires Biome >=2.0.0 with GritQL plugin support. Older versions of Biome or other linters are not supported.

fix

Ensure you have @biomejs/biome >=2.0.0 installed and that Biome's plugin feature is enabled.

affects: >=0.2.0

deprecatedIn v0.2.1, the rule solid-no-object-signal-without-equals was narrowed to only flag nullable object types; array signals and standalone object types are no longer flagged.

fix

Update to v0.2.1+ to avoid false positives on non-nullable object signals.

affects: >=0.2.0 <0.2.1

Errors

Common errors & fixes

Biome configuration error: Plugin 'biome-plugin-solidjs' not found

The plugin is referenced incorrectly in biome.json. Users often omit the ./node_modules/ prefix or use wrong path.

fix

Use "./node_modules/biome-plugin-solidjs" instead of just "biome-plugin-solidjs".

Cannot find module 'biome-plugin-solidjs'

Attempting to require/import the plugin as a JavaScript module, which is not how Biome plugins work.

fix

Do not import in JS/TS files. Add the path to the plugins array in biome.json.

GritQL rule error: solid-no-object-signal-without-equals is not a valid rule

The rule is opt-in and must be explicitly included in the plugins array as a .grit file path.

fix

Add "./node_modules/biome-plugin-solidjs/rules/solid-no-object-signal-without-equals.grit" to the plugins array.

The biome engine is not compatible with this plugin (requires biome >= 2.0.0)

Installed @biomejs/biome version is older than 2.0.0, which lacks GritQL plugin support.

fix

Upgrade @biomejs/biome to >=2.0.0.

Upgrade

Version history

0.2.2latest on npm

Audit

Dependencies

@biomejs/biomerequiredRuntime peer dependency — the plugin is loaded into Biome >=2.0.0 as a GritQL plugin.

Agent activity

18 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/tommymorgan/biome-plugin-solidjs ↗

packagehttps://www.npmjs.com/package/biome-plugin-solidjs ↗