eslint-config-agent 3.0.4 → 3.1.0

package/exports/to-warnings.d.ts

@@ -0,0 +1,20 @@
+import type { Linter } from 'eslint'
+
+/**
+ * Downgrade every error-level rule in a flat-config block to a warning.
+ *
+ * The single source of truth used internally by the
+ * `eslint-config-agent/incremental` and
+ * `eslint-config-agent/recommended-incremental` presets. Map it over a
+ * flat-config array to warn-level the shared ruleset while composing your own
+ * config — for example to keep a handful of rules as hard errors from day one
+ * without copy-pasting the downgrade logic by hand.
+ *
+ * Blocks without a `rules` object (for example `ignores`-only blocks) are
+ * returned untouched. Both shorthand (`'error'`) and tuple (`['error',
+ * options]`) rule values are handled, and `off`/`warn` rules are left exactly
+ * as they are.
+ * @param block A flat-config block.
+ * @returns The block with error-level rules downgraded to warnings.
+ */
+export declare const toWarnings: (block: Linter.Config) => Linter.Config

package/exports/to-warnings.js

@@ -0,0 +1,41 @@
+/**
+ * Shared severity-downgrade helper for the warn-level adoption presets.
+ *
+ * Both `eslint-config-agent/incremental` and
+ * `eslint-config-agent/recommended-incremental` need to take a built flat-config
+ * array and rewrite every error-level rule to a warning so `eslint` exits `0`
+ * while still reporting the full backlog. That logic lived inline in
+ * `incremental.js`; extracting it here keeps a single source of truth so the two
+ * presets cannot drift apart.
+ */
+
+const WARN = 'warn'
+const ERROR_LEVELS = new Set(['error', 2])
+
+const downgrade = severity => (ERROR_LEVELS.has(severity) ? WARN : severity)
+
+/**
+ * Downgrade every error-level rule in a flat-config block to a warning.
+ *
+ * Blocks without a `rules` object (for example `ignores`-only blocks) are
+ * returned untouched. Both shorthand (`'error'`) and tuple
+ * (`['error', options]`) rule values are handled, and `off`/`warn` rules are
+ * left exactly as they are.
+ * @param block A flat-config block.
+ * @returns The block with error-level rules downgraded to warnings.
+ */
+export const toWarnings = block => {
+  if (block.rules === undefined) {
+    return block
+  }
+
+  const rules = Object.fromEntries(
+    Object.entries(block.rules).map(([name, value]) =>
+      Array.isArray(value)
+        ? [name, [downgrade(value[0]), ...value.slice(1)]]
+        : [name, downgrade(value)]
+    )
+  )
+
+  return { ...block, rules }
+}

package/index.d.ts

@@ -0,0 +1,18 @@
+import type { Linter } from 'eslint'
+
+/**
+ * The default `eslint-config-agent` flat config: the full strict ruleset for
+ * TypeScript, React, and Preact projects.
+ *
+ * It is an array of flat-config blocks, so spread it into (or export it
+ * directly as) your `eslint.config.*`:
+ *
+ * ```ts
+ * import config from 'eslint-config-agent'
+ *
+ * export default config
+ * ```
+ */
+declare const config: Linter.Config[]
+
+export default config