@webority/biome-config 0.7.3

package/LICENSE

@@ -0,0 +1,5 @@
+Copyright (c) Webority Technologies. All rights reserved.
+
+This software and its source code are proprietary and confidential to
+Webority Technologies. Use is restricted to Webority products and teams under
+internal license. Redistribution outside Webority Technologies is prohibited.

package/README.md

@@ -0,0 +1,47 @@
+# @webority/biome-config
+
+The **single source of truth** for Biome lint + format policy across Webority frontend
+products. Extend it from a product's `biome.json` so every repo inherits the same
+fleet-decided ruleset — and a policy change is one version bump, not an N-way copy that
+drifts. Same model as the shared `@webority/theme` + `@webority/ui-react`.
+
+## Use
+
+```bash
+npm install -D @webority/biome-config @biomejs/biome
+```
+
+Then a product's `biome.json` extends this base and adds **only** its own repo-specific
+bits — `vcs.root`, `files.includes`, and `formatter.lineEnding` (LF is Biome's default;
+set `crlf` only for a CRLF repo):
+
+```jsonc
+{
+  "$schema": "https://biomejs.dev/schemas/2.5.5/schema.json",
+  "extends": ["@webority/biome-config/biome.jsonc"],
+  "vcs": { "enabled": true, "clientKind": "git", "useIgnoreFile": true, "root": ".." },
+  "files": {
+    "ignoreUnknown": true,
+    "includes": ["**", "!!**/dist", "!!**/build", "!!**/node_modules", "!**/src/appsettings.Compiled.json", "!**/public/version.json"]
+  },
+  // Only if the repo is CRLF (e.g. a Windows repo with `end_of_line = crlf`).
+  "formatter": { "lineEnding": "crlf" }
+}
+```
+
+## What's decided here (once, for the fleet)
+
+- **Format:** 4-space, width 140, double quotes, semicolons, trailing commas.
+- **`useExhaustiveDependencies: off`** — noise-by-nature on correct React effect/RHF code.
+- **`noArrayIndexKey: warn`** — kept on (catches real dynamic-list bugs); genuine
+  static-list exceptions get a documented per-line `biome-ignore`.
+- **`noConsole`** off for `scripts/**` + `logger.js`; CSS/SCSS not linted; the icon
+  module's mixed export allowed.
+
+Product-specific one-offs (a bespoke file that co-exports, etc.) still use a local
+`overrides` entry or a documented inline `biome-ignore` in that product.
+
+## Versioning
+
+Published from the `webority-ui` monorepo on each release, in lockstep with the other
+`@webority/*` packages. Pin a version; bump to adopt policy changes deliberately.

package/biome.jsonc

@@ -0,0 +1,117 @@
+{
+    "$schema": "https://biomejs.dev/schemas/2.5.5/schema.json",
+    // Not a standalone root config — it exists only to be `extends`-ed by a product's
+    // biome.json (which is the root). `root: false` stops Biome treating it as a nested
+    // competing root inside the monorepo that ships it.
+    "root": false,
+    // Shared Webority frontend lint + format policy. Products EXTEND this and add
+    // only their own repo-specific bits (vcs.root, files.includes, formatter.lineEnding).
+    // Every rule decision below is made ONCE for the fleet, with rationale, and inherited
+    // by every product via a version bump — no per-repo drift.
+    "formatter": {
+        "enabled": true,
+        "indentStyle": "space",
+        "indentWidth": 4,
+        "lineWidth": 140,
+        "attributePosition": "auto",
+        "bracketSameLine": false,
+        "bracketSpacing": true,
+        "useEditorconfig": false
+    },
+    "linter": {
+        "enabled": true,
+        "rules": {
+            "preset": "recommended",
+            "a11y": "warn",
+            "complexity": {
+                "noImportantStyles": "off",
+                "useOptionalChain": "off",
+                "noUselessFragments": "off"
+            },
+            "correctness": {
+                "noUnusedVariables": "error",
+                "noUnusedFunctionParameters": "warn",
+                // Noise-by-nature on correct React effect/RHF code (fires on every
+                // deliberate trigger-only / run-once effect). Fleet decision: off.
+                "useExhaustiveDependencies": "off",
+                "useHookAtTopLevel": "error"
+            },
+            "style": {
+                "useTemplate": "off",
+                "noDescendingSpecificity": "off",
+                "useComponentExportOnlyModules": "warn"
+            },
+            "suspicious": {
+                // Valuable on dynamic lists (reorder/reconciliation bugs). Genuine
+                // static-list exceptions get a documented per-line biome-ignore.
+                "noArrayIndexKey": "warn",
+                "useIterableCallbackReturn": "off",
+                "noGlobalIsNan": "off",
+                "noAssignInExpressions": "off",
+                "noDuplicateProperties": "warn",
+                "noConsole": {
+                    "level": "warn",
+                    "options": {
+                        "allow": ["warn", "error"]
+                    }
+                }
+            }
+        }
+    },
+    "javascript": {
+        "formatter": {
+            "jsxQuoteStyle": "double",
+            "quoteProperties": "asNeeded",
+            "trailingCommas": "all",
+            "semicolons": "always",
+            "arrowParentheses": "always",
+            "bracketSameLine": false,
+            "quoteStyle": "double",
+            "attributePosition": "auto",
+            "bracketSpacing": true
+        },
+        "jsxRuntime": "transparent"
+    },
+    "assist": {
+        "enabled": true,
+        "actions": {
+            "source": {
+                "organizeImports": "off"
+            }
+        }
+    },
+    "overrides": [
+        {
+            // Loggers + build/tooling scripts legitimately use console.
+            "includes": ["scripts/**", "**/logger.js"],
+            "linter": {
+                "rules": {
+                    "suspicious": {
+                        "noConsole": "off"
+                    }
+                }
+            }
+        },
+        {
+            // The icon module co-exports a component + its glyph map by design.
+            "includes": ["**/icons.jsx"],
+            "linter": {
+                "rules": {
+                    "style": {
+                        "useComponentExportOnlyModules": "off"
+                    },
+                    "suspicious": {
+                        "noArrayIndexKey": "off"
+                    }
+                }
+            }
+        },
+        {
+            // Styling lives in the shared theme; product CSS/SCSS isn't linted here.
+            "includes": ["**/*.css", "**/*.scss"],
+            "linter": {
+                "enabled": false
+            }
+        }
+    ]
+}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@webority/biome-config",
+  "version": "0.7.3",
+  "description": "Shared Biome lint + format policy for Webority frontend products. Extend it from a product biome.json so every repo inherits one fleet-decided ruleset, bumped by version — no per-repo drift.",
+  "license": "SEE LICENSE IN LICENSE",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Webority/webority-ui.git",
+    "directory": "packages/biome-config"
+  },
+  "files": [
+    "biome.jsonc"
+  ],
+  "main": "biome.jsonc",
+  "peerDependencies": {
+    "@biomejs/biome": ">=2.5.0"
+  }
+}