@santi020k/eslint-config-basic 1.5.0 → 2.0.0-beta.0

package/CHANGELOG.md

@@ -1,5 +1,176 @@
 # @santi020k/eslint-config-basic
 
+## 2.0.0-beta.0
+
+### Major Changes
+
+- [#87](https://github.com/santi020k/eslint-config-basic/pull/87) [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc) Thanks [@santi020k](https://github.com/santi020k)! - **Breaking**: require ESLint 10. All packages now declare `"eslint": "^10.0.0"` as peer dependency (previously `^9.0.0 || ^10.0.0`), and `@santi020k/eslint-config-core` depends on `@eslint/js` v10.
+
+  ESLint v9.x reaches end-of-life on 2026-08-06; targeting v10 only lets the configs rely on v10 behavior:
+
+  - per-file config lookup (`eslint.config.*` resolved from each linted file's directory) — workspace packages can now ship their own config files alongside or instead of the root `projects` option
+  - JSX reference tracking — correct scope analysis for JSX without plugin workarounds
+  - the updated `eslint:recommended` baseline from `@eslint/js` v10
+
+  If you are still on ESLint 9, stay on the v1.x line of these packages.
+
+- [#87](https://github.com/santi020k/eslint-config-basic/pull/87) [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc) Thanks [@santi020k](https://github.com/santi020k)! - Lazy framework loading and normalized framework export naming.
+
+  **Lazy loading**: framework packages (angular-eslint, vue-eslint-parser, eslint-plugin-svelte, …) are now imported dynamically and only when their framework is enabled. Projects that enable none or few frameworks no longer pay the startup cost of loading every bundled framework plugin when `eslintConfig()` / `defineConfig()` runs.
+
+  **Breaking — normalized naming**: framework exports from `@santi020k/eslint-config-basic` now use bare framework names, and all of them are async factories returning `Promise<FlatConfigArray>`:
+
+  `angular`, `astro`, `expo`, `hono`, `lit`, `nest`, `next`, `nuxt`, `qwik`, `react`, `reactRouter`, `slidev`, `solid`, `svelte`, `tanstackStart`, `vite`, `vue` (plus deprecated `remix`).
+
+  The previous mixed-style names (`angularConfig`, `expoConfig`, `nestConfig`, `nextConfig`, `reactConfig`, `solidConfig`, `svelteConfig`, `vueConfig`) remain available as deprecated aliases of the same factories, but they are no longer plain config arrays — call them (and `await` the result) when composing manually:
+
+  ```js
+  // before (v1)
+  import { reactConfig } from "@santi020k/eslint-config-basic";
+
+  export default [...reactConfig];
+  ```
+
+  ```js
+  // after (v2)
+  import { react } from "@santi020k/eslint-config-basic";
+
+  export default [...(await react())];
+  ```
+
+  Most users are unaffected: `frameworks: { react: true }` and auto-detection behave exactly as before.
+
+  `@santi020k/eslint-config-core`: the `ImportedFramework` type now also accepts async factories (`(options?) => Promise<FlatConfigArray>`), so lazy factories can be passed directly as framework option values.
+
+- [#87](https://github.com/santi020k/eslint-config-basic/pull/87) [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc) Thanks [@santi020k](https://github.com/santi020k)! - Release v2 with a single public application install through `@santi020k/eslint-config-basic`.
+
+  Application projects no longer need to install or import separate framework config packages. Framework integrations are bundled behind the main package and can be enabled with booleans such as `frameworks.react: true`, `frameworks.next: true`, or by relying on auto-detection from `eslintConfig()`.
+
+  Detected framework configs are now enabled by default, while an explicit `frameworks: {}` remains the opt-out path. Next.js, Expo, and Remix automatically include React rules when enabled.
+
+  The documentation site now keeps the previous v1 docs under `/v1/`, updates the root docs for v2, and includes a v1 to v2 migration guide.
+
+- [#87](https://github.com/santi020k/eslint-config-basic/pull/87) [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc) Thanks [@santi020k](https://github.com/santi020k)! - Modernize the React stack and rename Remix:
+
+  - **BREAKING**: `@santi020k/eslint-config-react` now uses `@eslint-react/eslint-plugin` instead of `eslint-plugin-react` + `eslint-plugin-react-hooks`. Rule names change from `react/*` and `react-hooks/*` to `@eslint-react/*` (e.g. `react-hooks/exhaustive-deps` → `@eslint-react/exhaustive-deps`). This removes the `fixupConfigRules` compatibility shim, is ESLint 10-native, and includes the hooks rules. `react-compiler` and `react-refresh` plugins are unchanged.
+  - **BREAKING**: `@santi020k/eslint-config-remix` is now a deprecated alias that re-exports `@santi020k/eslint-config-react-router` (Remix merged into React Router v7). The `frameworks.remix` key still works but is deprecated — use `frameworks['react-router']`. The alias will be removed in the next major.
+  - The toolchain now builds with TypeScript 6.
+
+### Minor Changes
+
+- [#87](https://github.com/santi020k/eslint-config-basic/pull/87) [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc) Thanks [@santi020k](https://github.com/santi020k)! - Add first-class support for Preact.
+
+- [#87](https://github.com/santi020k/eslint-config-basic/pull/87) [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc) Thanks [@santi020k](https://github.com/santi020k)! - AI tooling workflow improvements:
+
+  - **Default ignores for AI artifacts**: the composed config now ignores AI coding-assistant folders (`.agent`, `.agents`, `.aider*`, `.claude`, `.clinerules`, `.codex`, `.copilot`, `.cursor`, `.gemini`, `.kiro`, `.opencode`, `.roo`, `.windsurf`) so generated agent rules are never linted as source code. Disable via `settings: [Setting.NoDefaultIgnores]`.
+  - **`generate-skill --check`**: CI mode that compares existing agent skill files (and guarded `AGENTS.md` / copilot-instructions sections) against freshly generated content without writing, and exits with code 1 when anything is stale or missing.
+  - **`generate-skill --create`**: scaffolds a root `AGENTS.md` with the guarded ESLint-standards section when the project has none.
+  - **`doctor` duplicate-ESLint detection**: warns when the project and the config packages resolve two different ESLint versions (e.g. an ESLint 9 project pulling in the config's ESLint 10 dependency). Both majors remain supported; the warning helps avoid editor/CLI rule-behavior drift.
+
+- [#87](https://github.com/santi020k/eslint-config-basic/pull/87) [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc) Thanks [@santi020k](https://github.com/santi020k)! - Add broader AI tooling support:
+
+  - **New agent skill targets** in `generate-skill`: Gemini (`.gemini/styleguide.md`), Cline (`.clinerules/`), Roo Code (`.roo/rules/`), and Kiro (`.kiro/steering/` with `inclusion: always` front-matter). The generator also maintains a guarded ESLint-standards section in an existing root `AGENTS.md` (the open standard read by Codex CLI, OpenCode, Jules, Amp, and others), mirroring the `.github/copilot-instructions.md` behavior.
+  - **New library integrations**: `Library.Langchain` and `Library.LlamaIndex` add import safety rules for LangChain.js (`langchain`, `@langchain/*`) and LlamaIndex.TS (`llamaindex`, `@llamaindex/*`) projects, with auto-detection from `package.json` dependencies.
+  - Generated agent skills now report AI SDK, MCP, Mastra, OpenAI Agents, LangChain, and LlamaIndex integrations in the feature summary.
+
+- [#87](https://github.com/santi020k/eslint-config-basic/pull/87) [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc) Thanks [@santi020k](https://github.com/santi020k)! - Add optional `ignores` to `eslintConfig()` / `EslintConfigOptions` for extra global ignore globs, documented in the configuration guide.
+
+- [#87](https://github.com/santi020k/eslint-config-basic/pull/87) [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc) Thanks [@santi020k](https://github.com/santi020k)! - Add `defineConfig` as a named alias for `eslintConfig`, keep implicit framework expansion from mutating caller-provided options, declare ESLint as a peer dependency of the umbrella package, and mark the package as side-effect free for bundlers.
+
+- [#87](https://github.com/santi020k/eslint-config-basic/pull/87) [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc) Thanks [@santi020k](https://github.com/santi020k)! - Fix `optionMergeStrategy: 'merge'` so explicitly passed options (`tools`, `testing`, `formats`, `libraries`, `extensions`, `frameworks`) are actually unioned with detected and preset values, as documented. Previously, providing any of these options silently replaced detected/preset values regardless of strategy. To fully opt out of detected frameworks, use `autoFrameworks: false` or `optionMergeStrategy: 'replace'` (an explicit `frameworks: {}` no longer opts out under the default merge strategy).
+
+  Other fixes:
+
+  - `detection: false` now also disables the default detected extensions (Unicorn, Perfectionist, Security); a new granular `detection: { extensions: false }` control is available.
+  - Negated glob patterns (`!pattern`) in `projects` sub-configs are now scoped correctly instead of producing invalid `path/!glob` patterns.
+  - Deprecate the unused `TsOptions` interface (`typescript: { project }` was ignored since v2) and correct stale doc comments on `ImportedFramework` and the no-op `Setting.Gitignore` / `Setting.DefaultIgnores` values.
+
+- [#87](https://github.com/santi020k/eslint-config-basic/pull/87) [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc) Thanks [@santi020k](https://github.com/santi020k)! - Disable context-sensitive framework rules that produce false positives in lint-staged and monorepo layouts: Nest's provider reference rule and Next's Pages Router link rule.
+
+- [#87](https://github.com/santi020k/eslint-config-basic/pull/87) [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc) Thanks [@santi020k](https://github.com/santi020k)! - Add new framework and integration support:
+
+  - **New framework packages**: Nuxt (`@nuxt/eslint-plugin` on top of the Vue config), Lit (`eslint-plugin-lit` + `eslint-plugin-wc`), React Router v7 (successor to Remix), and TanStack Start (bundles TanStack Router + Query rules). All are wired into `eslintConfig()` framework keys, bundled resolvers, auto-detection (`nuxt`, `lit`, `@react-router/dev`, `@tanstack/react-start`, `@tanstack/solid-start`), the CLI, and the agent-skill generator.
+  - **New formats**: `Format.Css` (official `@eslint/css` plugin) and `Format.Html` (`@html-eslint`).
+  - **New extensions**: `Extension.Node` (`eslint-plugin-n`, with TS-aware module-resolution overrides), `Extension.Compat` (browserslist compatibility), `Extension.DeMorgan`, `Extension.Depend`, and `Extension.Oxlint` (disables rules covered by Oxlint for hybrid setups, applied last like Biome).
+  - **New tool**: `Tool.Pnpm` (`eslint-plugin-pnpm`) enforcing pnpm catalogs and workspace settings in `package.json` and `pnpm-workspace.yaml`.
+
+### Patch Changes
+
+- [#87](https://github.com/santi020k/eslint-config-basic/pull/87) [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc) Thanks [@santi020k](https://github.com/santi020k)! - Refresh all external dependencies to their latest versions across the monorepo (58 bumps), including majors: TypeScript 6.0, Vite 8, Angular 22, MikroORM 7, and TypeORM 1.0. ESLint moves to 10.5, the `vite` and `eslint` pnpm overrides are updated to match, and the Angular and NestJS playgrounds now declare `rxjs@^7.8.2` explicitly so framework peer dependencies no longer resolve against a stale transitive rxjs 6.
+
+- [#87](https://github.com/santi020k/eslint-config-basic/pull/87) [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc) Thanks [@santi020k](https://github.com/santi020k)! - Add `@santi020k/eslint-config-lite` as an optional composer package for projects that want to install framework and integration config packages manually. The full `@santi020k/eslint-config-basic` package remains the recommended default install.
+
+  Expose integration composition helpers from `@santi020k/eslint-config-integrations` so the lite package can lazy-load integration configs only when selected.
+
+  Teach `basic-eslint doctor` to recognize lite configs and warn when detected frameworks or integrations are missing their manually installed config packages.
+
+  Add `basic-eslint doctor --lite-install` to print the detected package-manager install command for switching a project to the lite package, including framework config packages, integrations, ESLint, and TypeScript when needed.
+
+  Document package-choice metrics, a Basic-to-Lite migration recipe, and a lite-specific `Preset.All` warning.
+
+- Updated dependencies [[`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc), [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc), [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc), [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc), [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc), [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc), [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc), [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc), [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc), [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc), [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc), [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc), [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc), [`2ee503b`](https://github.com/santi020k/eslint-config-basic/commit/2ee503be55f5484624ee2e873fe59f348709eadc)]:
+  - @santi020k/eslint-config-preact@2.0.0-beta.0
+  - @santi020k/eslint-config-core@2.0.0-beta.0
+  - @santi020k/eslint-config-integrations@2.0.0-beta.0
+  - @santi020k/eslint-config-angular@2.0.0-beta.0
+  - @santi020k/eslint-config-astro@2.0.0-beta.0
+  - @santi020k/eslint-config-expo@2.0.0-beta.0
+  - @santi020k/eslint-config-hono@2.0.0-beta.0
+  - @santi020k/eslint-config-lit@2.0.0-beta.0
+  - @santi020k/eslint-config-nest@2.0.0-beta.0
+  - @santi020k/eslint-config-next@2.0.0-beta.0
+  - @santi020k/eslint-config-nuxt@2.0.0-beta.0
+  - @santi020k/eslint-config-qwik@2.0.0-beta.0
+  - @santi020k/eslint-config-react@2.0.0-beta.0
+  - @santi020k/eslint-config-react-router@2.0.0-beta.0
+  - @santi020k/eslint-config-remix@2.0.0-beta.0
+  - @santi020k/eslint-config-slidev@2.0.0-beta.0
+  - @santi020k/eslint-config-solid@2.0.0-beta.0
+  - @santi020k/eslint-config-svelte@2.0.0-beta.0
+  - @santi020k/eslint-config-tanstack-start@2.0.0-beta.0
+  - @santi020k/eslint-config-typescript@2.0.0-beta.0
+  - @santi020k/eslint-config-vite@2.0.0-beta.0
+  - @santi020k/eslint-config-vue@2.0.0-beta.0
+
+## 1.6.0
+
+### Minor Changes
+
+- [#85](https://github.com/santi020k/eslint-config-basic/pull/85) [`664693e`](https://github.com/santi020k/eslint-config-basic/commit/664693ef8edeb51239bf4dc2c75148203bcf41a6) Thanks [@santi020k](https://github.com/santi020k)! - Add `basic-eslint generate-skill` CLI command and `generateAgentSkills()` API.
+
+  The new command scans a project for AI coding-assistant agent folders (`.agent`, `.agents`, `.claude`, `.cursor`, `.windsurf`, `.copilot`, `.aider`) and writes a tailored ESLint standards skill file into each one. The generated file describes the active configuration (TypeScript, frameworks, testing, tools, etc.) and instructs the agent to follow the project's lint conventions automatically.
+
+  A companion GitHub Actions workflow (`.github/workflows/agent-skills.yml`) is included so projects can auto-regenerate skill files whenever the ESLint config changes.
+
+  **Usage:**
+
+  ```bash
+  npx basic-eslint generate-skill          # write skill files (skip existing)
+  npx basic-eslint generate-skill --force  # overwrite all skill files
+  ```
+
+  **Programmatic API:**
+
+  ```ts
+  import { generateAgentSkills } from "@santi020k/eslint-config-basic";
+
+  const { skipped, written } = generateAgentSkills({
+    cwd: process.cwd(),
+    force: true,
+  });
+  ```
+
+### Patch Changes
+
+- [#85](https://github.com/santi020k/eslint-config-basic/pull/85) [`664693e`](https://github.com/santi020k/eslint-config-basic/commit/664693ef8edeb51239bf4dc2c75148203bcf41a6) Thanks [@santi020k](https://github.com/santi020k)! - Load optional integrations lazily so projects can import the base config without installing unrelated integration peers such as Storybook, GraphQL, Stencil, Cypress, or Testing Library.
+
+  Also include the generated agent-skill API entry in the basic package build output so published packages do not reference a missing `agent-skill-generator.js` file.
+
+- Updated dependencies [[`664693e`](https://github.com/santi020k/eslint-config-basic/commit/664693ef8edeb51239bf4dc2c75148203bcf41a6)]:
+  - @santi020k/eslint-config-optionals@1.6.0
+  - @santi020k/eslint-config-core@1.6.0
+  - @santi020k/eslint-config-typescript@1.6.0
+
 ## 1.5.0
 
 ### Minor Changes

package/README.md

@@ -1,29 +1,11 @@
 # @santi020k/eslint-config-basic
 
-[![CI](https://github.com/santi020k/eslint-config-basic/actions/workflows/build.yml/badge.svg)](https://github.com/santi020k/eslint-config-basic/actions/workflows/build.yml)
-[![npm version](https://img.shields.io/npm/v/@santi020k/eslint-config-basic.svg)](https://www.npmjs.com/package/@santi020k/eslint-config-basic)
-[![npm downloads](https://img.shields.io/npm/dm/@santi020k/eslint-config-basic.svg)](https://www.npmjs.com/package/@santi020k/eslint-config-basic)
-[![license](https://img.shields.io/npm/l/@santi020k/eslint-config-basic.svg)](https://github.com/santi020k/eslint-config-basic/blob/main/LICENSE)
+The primary entry point that composes all feature-specific configurations.
 
-Composable ESLint 10+ flat-config for JavaScript, TypeScript, and all major frameworks.
+This package is part of the [`@santi020k/eslint-config-basic`](https://github.com/santi020k/eslint-config-basic) monorepo.
 
-This is the main entry point of the [`@santi020k/eslint-config-basic`](https://github.com/santi020k/eslint-config-basic) monorepo.
-
-- Docs: [eslint.santi020k.com](https://eslint.santi020k.com/)
+- Docs: [Main package](https://eslint.santi020k.com/packages/basic.html)
 - Repository: [santi020k/eslint-config-basic](https://github.com/santi020k/eslint-config-basic)
 - Author: [santi020k](https://santi020k.com)
 
-## Quick start
-
-```bash
-npm install -D eslint @santi020k/eslint-config-basic
-```
-
-```js
-// eslint.config.js
-import { eslintConfig } from '@santi020k/eslint-config-basic'
-
-export default eslintConfig()
-```
-
-Auto-detects TypeScript, frameworks, and common tools from your `package.json`. See the [full docs](https://eslint.santi020k.com/) for all options.
+The canonical documentation lives on the Starlight site, so this README intentionally stays short to avoid duplication.

package/dist/agent-skill-generator.d.ts

@@ -0,0 +1,108 @@
+interface AgentTarget {
+    /** Format variant used when generating content */
+    format: 'cursor' | 'frontmatter' | 'kiro' | 'plain';
+    /** Human-readable label for logging */
+    label: string;
+    /** Folder that must exist in cwd to be considered "present" */
+    markerFolder: string;
+    /** File name for the generated skill */
+    skillFile: string;
+    /** Subdirectory inside the agent folder where the skill file is placed */
+    skillSubdir: string;
+}
+/**
+ * Features extracted from the project's actual `eslint.config.js`.
+ * All arrays hold display-friendly labels (e.g. `'TypeScript'`, `'React'`).
+ */
+interface EslintConfigFeatures {
+    /** Path to the config file that was loaded, or null when falling back to detection */
+    configFile: null | string;
+    extensions: string[];
+    formats: string[];
+    frameworks: string[];
+    libraries: string[];
+    /** The lint command found in the project's package.json scripts, or a sensible default */
+    lintCommand: string;
+    /** Whether features came from the real config file or from package.json detection */
+    source: 'config-file' | 'detection-fallback';
+    testing: string[];
+    tools: string[];
+    typescript: boolean;
+}
+interface GenerateSkillOptions {
+    /**
+     * Check mode — compare existing skill files against freshly generated
+     * content without writing anything. Stale or missing files are reported
+     * in {@link GenerateSkillResult.stale}.
+     * @default false
+     */
+    check?: boolean;
+    /**
+     * Create a root `AGENTS.md` when it does not exist yet, instead of only
+     * updating an existing one.
+     * @default false
+     */
+    createAgentsMd?: boolean;
+    /** Working directory — defaults to process.cwd() */
+    cwd?: string;
+    /**
+     * Overwrite files that already exist.
+     * @default false
+     */
+    force?: boolean;
+}
+interface GenerateSkillResult {
+    skipped: string[];
+    /** Files that are out of date (or missing) — only populated in check mode */
+    stale: string[];
+    written: string[];
+}
+/**
+ * All AI coding-assistant agent folders that are probed for.
+ * Add new entries here as new agents emerge — the generator picks them up
+ * automatically on the next run.
+ */
+declare const AGENT_TARGETS: AgentTarget[];
+/**
+ * Loads the user's `eslint.config.js` (or `.mjs` / `.cjs`) via dynamic
+ * `import()` and derives features from the resulting flat-config array.
+ *
+ * Returns `null` when no config file is found or it cannot be imported.
+ */
+declare const analyzeEslintConfig: (cwd: string) => Promise<EslintConfigFeatures | null>;
+/**
+ * Builds the skill document body from the project's {@link EslintConfigFeatures}.
+ * Four format variants are produced:
+ *
+ * - `frontmatter` — YAML front-matter + Markdown (`.agent`, `.agents`, `.windsurf`)
+ * - `cursor`      — Cursor MDC front-matter + Markdown
+ * - `kiro`        — Kiro steering front-matter (`inclusion: always`) + Markdown
+ * - `plain`       — pure Markdown, no front-matter (Claude Code, Copilot, Aider, Gemini, Cline, Roo Code)
+ */
+declare const generateSkillContent: (features: EslintConfigFeatures, format: AgentTarget["format"]) => string;
+/**
+ * Detects which AI agent folders exist in the project, reads the actual
+ * `eslint.config.js` to understand what is configured, and writes a tailored
+ * ESLint standards skill file into each found folder.
+ *
+ * Falls back to package.json auto-detection when the config file cannot be
+ * dynamically imported (e.g. when running outside a built environment).
+ *
+ * @example
+ * ```ts
+ * import { generateAgentSkills } from '@santi020k/eslint-config-basic'
+ *
+ * const result = await generateAgentSkills({ cwd: process.cwd() })
+ * process.stdout.write(`Written to: ${result.written}\n`)
+ * ```
+ */
+declare const generateAgentSkills: (opts?: GenerateSkillOptions) => Promise<GenerateSkillResult>;
+interface HandleGenerateSkillFlags {
+    /** Check mode — report stale files and set a non-zero exit code, write nothing */
+    check?: boolean;
+    /** Create a root `AGENTS.md` when it does not exist */
+    createAgentsMd?: boolean;
+}
+declare const handleGenerateSkill: (cwd?: string, force?: boolean, flags?: HandleGenerateSkillFlags) => Promise<void>;
+
+export { AGENT_TARGETS, type AgentTarget, type EslintConfigFeatures, type GenerateSkillOptions, type GenerateSkillResult, type HandleGenerateSkillFlags, analyzeEslintConfig, generateAgentSkills, generateSkillContent, handleGenerateSkill };