@ovineko/spa-guard-eslint

ESLint plugin with rules that enforce spa-guard usage patterns: no-direct-lazy and no-direct-error-boundary.

Install

pnpm

pnpm add -D @ovineko/spa-guard-eslint eslint

npm

npm install --save-dev @ovineko/spa-guard-eslint eslint

yarn

yarn add -D @ovineko/spa-guard-eslint eslint

bun

bun add -d @ovineko/spa-guard-eslint eslint

deno

deno add npm:@ovineko/spa-guard-eslint npm:eslint

Usage

Add the recommended config to your eslint.config.js (flat config):

import spaGuard from "@ovineko/spa-guard-eslint";

export default [
  spaGuard.configs.recommended,
  // ... your other configs
];

The recommended config enables both rules at "error" level with autofixes.

Rules

no-direct-lazy

Disallows importing lazy from react. Use lazyWithRetry from @ovineko/spa-guard-react instead.

// Bad - flagged by the rule
import { lazy } from "react";

// Good - autofix replaces it with:
import { lazyWithRetry } from "@ovineko/spa-guard-react";

no-direct-error-boundary

Disallows importing from react-error-boundary. Use @ovineko/spa-guard-react/error-boundary instead.

// Bad - flagged by the rule
import { ErrorBoundary } from "react-error-boundary";

// Good - autofix replaces it with:
import { ErrorBoundary } from "@ovineko/spa-guard-react/error-boundary";

Both rules provide autofixes and are fixable via eslint --fix.

API

• plugin (default export) - ESLint plugin object with rules and configs
• configs - Named export; configs.recommended is the flat config object
• rules - Named export; object with no-direct-lazy and no-direct-error-boundary

Related packages

• @ovineko/spa-guard — Core package
• @ovineko/spa-guard-react — React integration (lazyWithRetry, ErrorBoundary)