@devbie/style-guide 1.1.2 → 1.2.0

package/README.md

@@ -5,27 +5,26 @@ Single source of truth for code style across the devbie ecosystem
 
 ## Exports
 
-| Entry                                | Contents                                                       |
-| ------------------------------------ | -------------------------------------------------------------- |
-| `@devbie/style-guide/prettier`       | Canonical prettier config (all repos)                          |
-| `@devbie/style-guide/eslint/backend` | eslint flat standard for Nest/Node TypeScript backends         |
-| `@devbie/style-guide/eslint/frontend`| eslint flat standard for frontend repos (TS + React + a11y)    |
-| `@devbie/style-guide/eslint/next`    | Frontend standard + canonical Next.js rules (overlay)          |
+| Entry                             | Contents                                            |
+| --------------------------------- | --------------------------------------------------- |
+| `@devbie/style-guide/prettier`    | Canonical prettier config (all repos)               |
+| `@devbie/style-guide/eslint/base` | eslint flat standard for Node TypeScript repos      |
+| `@devbie/style-guide/eslint/next` | `base` + canonical Next.js rules (for Next.js apps) |
 
 ## Which entry each repo uses
 
-| Repo                                                                              | eslint entry |
-| --------------------------------------------------------------------------------- | ------------ |
-| newbie, newbie-starter, nightwatch-backend, newbie-modules, apits                   | `backend`    |
-| fewbie                                                                            | `frontend`   |
-| fewbie-starter, nightwatch-frontend                                                | `next`       |
+| Repo                                                       | eslint entry |
+| ---------------------------------------------------------- | ------------ |
+| newbie, newbie-starter, nightwatch-backend, newbie-modules | `base`       |
+| fewbie-starter, nightwatch-frontend                        | `next`       |
 
-`next` is the shared `core` baseline plus `eslint-config-next` (which already
-bundles the React / react-hooks / jsx-a11y layers), so every repo shares the
-same language-level rules while Next.js applications add only the canonical
-framework layer. `eslint-config-next` requires the `next` package at load
-time, which is why repos without a Next runtime (fewbie) use `frontend`
-instead.
+`base` is the shared default: language-level rules plus prettier, with no
+framework content — it serves Nest services, CLIs, code generators, and
+source registries alike. `next` is `base`'s baseline plus `eslint-config-next`
+(which already bundles the React / react-hooks / jsx-a11y layers), so every
+repo shares the same language-level rules while Next.js applications add only
+the canonical framework layer. `eslint-config-next` requires the `next`
+package at load time, which is why Node repos cannot use `next`.
 
 ## Usage
 
@@ -48,12 +47,11 @@ not style decisions.
 `eslint.config.mjs` in the consumer repo:
 
 ```js
-import backend from "@devbie/style-guide/eslint/backend";
-// frontend repos: import frontend from "@devbie/style-guide/eslint/frontend";
-// Next.js apps:   import next from "@devbie/style-guide/eslint/next";
+import base from "@devbie/style-guide/eslint/base";
+// Next.js apps: import next from "@devbie/style-guide/eslint/next";
 
 export default [
-  ...backend,
+  ...base,
   // Repo-specific rules and ignores go here.
 ];
 ```
@@ -70,11 +68,22 @@ default, only as a deliberate milestone.
 
 ## Changelog
 
+- 1.2.0 — `backend` renamed to `base` and `frontend` removed. After apits and
+  fewbie-cli joined the newbie monorepo (ADR-012/ADR-015), `frontend` had no
+  consumer left, and `backend` no longer described its consumers (CLIs, code
+  generators, registries — none of them backends). The pair is now named for
+  what it is: `base` (the default) and `next` (the Next.js specialization).
+  The react/react-hooks/jsx-a11y plugin dependencies are dropped; `next`
+  gets those layers from `eslint-config-next`.
+- 1.1.3 — `frontend` pins the React version for rule evaluation (19.0) instead
+  of detecting it: fewbie lints React template sources without a `react`
+  package installed, where detection only emits a warning.
 - 1.1.2 — fix: `next` extends `core` plus the canonical Next rule set
   (`eslint-config-next` already bundles React/react-hooks/jsx-a11y, so
   spreading `frontend` on top redefined `jsx-a11y` and flat config rejected
-  it). The `frontend` React layer is now scoped to JSX/TSX files, so
-  non-React frontend repos (fewbie-cli) never evaluate React rules.
+  it). The `frontend` React layer is now scoped to JSX/TSX files, so Node code
+  in frontend repos is not evaluated against React rules while React template
+  sources are.
 - 1.1.1 — fix: `frontend` uses the flat variant of eslint-plugin-react-hooks
   (`configs.flat["recommended-latest"]`); 1.1.0 shipped the legacy shape and
   failed to load under flat config.

package/eslint/base.js

@@ -0,0 +1,15 @@
+import core from "./core.js";
+import prettierConfig from "eslint-config-prettier";
+
+/**
+ * Base standard for the devbie ecosystem.
+ *
+ * Consumers: newbie (monorepo), newbie-starter, nightwatch-backend,
+ * newbie-modules, apits, fewbie-cli (inside newbie). All of them are Node.js
+ * TypeScript codebases — no browser DOM framework. The language-level rules
+ * live in `core` so base and next standards never drift on the shared part.
+ *
+ * Repo-specific rules and ignores belong in the consumer's own
+ * eslint.config.mjs, spread after this entry.
+ */
+export default [...core, prettierConfig];

package/eslint/core.js

@@ -11,20 +11,27 @@ import tseslint from "typescript-eslint";
  * Internal entry: consumers import `backend`, `frontend` or `next`, never
  * this file.
  */
-export default [...tseslint.configs.recommended, {
-  rules: {
-    "@typescript-eslint/no-explicit-any": "off",
-    "@typescript-eslint/no-unused-vars": [
-      "error",
-      { argsIgnorePattern: "^_", varsIgnorePattern: "^_", caughtErrorsIgnorePattern: "^_" },
-    ],
+export default [
+  ...tseslint.configs.recommended,
+  {
+    rules: {
+      "@typescript-eslint/no-explicit-any": "off",
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        { argsIgnorePattern: "^_", varsIgnorePattern: "^_", caughtErrorsIgnorePattern: "^_" },
+      ],
 
-    // Code-quality rules carried over from the legacy gts-derived config.
-    "block-scoped-var": "error",
-    eqeqeq: ["error", "always", { null: "ignore" }],
-    "no-var": "error",
-    "prefer-const": "error",
-    "prefer-arrow-callback": "error",
-    "no-restricted-properties": ["error", { object: "describe", property: "only" }, { object: "it", property: "only" }],
+      // Code-quality rules carried over from the legacy gts-derived config.
+      "block-scoped-var": "error",
+      eqeqeq: ["error", "always", { null: "ignore" }],
+      "no-var": "error",
+      "prefer-const": "error",
+      "prefer-arrow-callback": "error",
+      "no-restricted-properties": [
+        "error",
+        { object: "describe", property: "only" },
+        { object: "it", property: "only" },
+      ],
+    },
   },
-}];
+];

package/eslint/next.js

@@ -10,11 +10,11 @@ import prettierConfig from "eslint-config-prettier";
  *
  * Extends the shared `core` baseline with the canonical Next rule set.
  * `eslint-config-next` already bundles the React / react-hooks / jsx-a11y
- * layers, so the `frontend` React layer is not repeated here: spreading both
+ * layers, so nothing else is layered on top: spreading another React layer
  * would redefine the same plugin and flat config rejects that.
  *
- * This entry can only be loaded where the `next` package is installed, which
- * is why frontend repos without a Next runtime use `frontend` instead.
+ * This entry can only be loaded where the `next` package is installed; Node
+ * repos without a Next runtime use the `base` entry instead.
  */
 export default defineConfig([
   ...core,

package/package.json

@@ -1,14 +1,13 @@
 {
   "name": "@devbie/style-guide",
-  "version": "1.1.2",
-  "description": "Single source of truth for devbie ecosystem code style: shared prettier config and eslint flat standards (backend, frontend, next)",
+  "version": "1.2.0",
+  "description": "Single source of truth for devbie ecosystem code style: shared prettier config and eslint flat standards (base, next)",
   "license": "MIT",
   "author": "worldzhy",
   "type": "module",
   "exports": {
     "./prettier": "./prettier.js",
-    "./eslint/backend": "./eslint/backend.js",
-    "./eslint/frontend": "./eslint/frontend.js",
+    "./eslint/base": "./eslint/base.js",
     "./eslint/next": "./eslint/next.js",
     "./package.json": "./package.json"
   },
@@ -22,9 +21,6 @@
   "dependencies": {
     "eslint-config-next": "^16.4.2",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-jsx-a11y": "^6.10.0",
-    "eslint-plugin-react": "^7.37.0",
-    "eslint-plugin-react-hooks": "^7.1.0",
     "typescript-eslint": "^8.71.2"
   },
   "peerDependencies": {

package/eslint/backend.js

@@ -1,15 +0,0 @@
-import core from "./core.js";
-import prettierConfig from "eslint-config-prettier";
-
-/**
- * Backend standard for the devbie ecosystem.
- *
- * Consumers: newbie, newbie-starter, nightwatch-backend, newbie-modules,
- * apits. All of them are Nest/Node TypeScript codebases; the language-level
- * rules live in `core` so the backend and frontend standards never drift on
- * the shared part.
- *
- * Repo-specific rules and ignores belong in the consumer's own
- * eslint.config.mjs, spread after this entry.
- */
-export default [...core, prettierConfig];

package/eslint/frontend.js

@@ -1,31 +0,0 @@
-import core from "./core.js";
-import prettierConfig from "eslint-config-prettier";
-import react from "eslint-plugin-react";
-import reactHooks from "eslint-plugin-react-hooks";
-import jsxA11y from "eslint-plugin-jsx-a11y";
-
-/**
- * Frontend standard for the devbie ecosystem.
- *
- * Consumers: fewbie, fewbie-starter, nightwatch-frontend.
- *
- * Deliberately independent of `eslint-config-next`: that package requires the
- * `next` package to be installed (its parser is `next/dist/compiled/babel
- * /eslint-parser`), while fewbie ships a Node CLI and has no Next runtime.
- * Next.js applications layer `@devbie/style-guide/eslint/next` on top instead.
- *
- * The JSX/React layer is scoped to JSX/TSX files: repositories in the
- * frontend group that carry no React code (fewbie-cli) receive the same
- * standard without evaluating React rules at all.
- */
-const jsxFiles = ["**/*.jsx", "**/*.tsx"];
-const jsxOnly = (config) => ({ ...config, files: jsxFiles });
-
-export default [
-  ...core,
-  jsxOnly(react.configs.flat.recommended),
-  jsxOnly(react.configs.flat["jsx-runtime"]),
-  jsxOnly(reactHooks.configs.flat["recommended-latest"]),
-  jsxOnly(jsxA11y.flatConfigs.recommended),
-  prettierConfig,
-];