@santi020k/eslint-config-lite 2.0.0-beta.0

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# @santi020k/eslint-config-lite
+
+## 2.0.0-beta.0
+
+### 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 `@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.
+
+### Patch Changes
+
+- 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
+
+- Add the lite composer package for manual framework and integration installs.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 santi020k
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# @santi020k/eslint-config-lite
+
+Lite composer for projects that install framework and integration config packages manually.
+
+This package is part of the [`@santi020k/eslint-config-basic`](https://github.com/santi020k/eslint-config-basic) monorepo.
+
+- Docs: [Lite package](https://eslint.santi020k.com/packages/lite.html)
+- Repository: [santi020k/eslint-config-basic](https://github.com/santi020k/eslint-config-basic)
+- Author: [santi020k](https://santi020k.com)
+
+The canonical documentation lives on the Starlight site, so this README intentionally stays short to avoid duplication.

package/dist/compose.d.ts

@@ -0,0 +1,10 @@
+import { FlatConfigArray } from '@santi020k/eslint-config-core';
+
+type NormalizedStrictMode = 'ci' | 'pedantic' | 'recommended';
+declare const normalizeStrictMode: (strict: boolean | NormalizedStrictMode | undefined) => NormalizedStrictMode;
+/**
+ * Applies strict mode by promoting all 'warn' rules to 'error'.
+ */
+declare const applyStrictMode: (configs: FlatConfigArray, strict: boolean | NormalizedStrictMode | undefined) => FlatConfigArray;
+
+export { type NormalizedStrictMode, applyStrictMode, normalizeStrictMode };

package/dist/compose.js

@@ -0,0 +1,30 @@
+const normalizeStrictMode = (strict) => {
+  if (strict === true) return "ci";
+  if (strict === "ci" || strict === "pedantic") return strict;
+  return "recommended";
+};
+const promoteRuleSeverity = (value) => {
+  if (value === void 0) return void 0;
+  if (value === "warn" || value === 1) return "error";
+  if (Array.isArray(value) && (value[0] === "warn" || value[0] === 1)) {
+    return ["error", ...value.slice(1)];
+  }
+  return value;
+};
+const applyStrictMode = (configs, strict) => {
+  const strictMode = normalizeStrictMode(strict);
+  if (strictMode === "recommended") return configs;
+  return configs.map((config) => {
+    if (config.rules) {
+      const strictRules = Object.fromEntries(
+        Object.entries(config.rules).map(([key, value]) => [key, promoteRuleSeverity(value)])
+      );
+      return { ...config, rules: strictRules };
+    }
+    return config;
+  });
+};
+export {
+  applyStrictMode,
+  normalizeStrictMode
+};

package/dist/frameworks.d.ts

@@ -0,0 +1,58 @@
+import { DetectedFrameworkName, Runtime, FlatConfigArray } from '@santi020k/eslint-config-core';
+
+type FrameworkFlags = Partial<Record<FrameworkName, true>>;
+type FrameworkName = DetectedFrameworkName;
+interface FrameworkOptions {
+    [key: string]: unknown;
+    hasReact?: boolean;
+    hasSolid?: boolean;
+    hasSvelte?: boolean;
+    hasVue?: boolean;
+    runtime?: Runtime;
+}
+declare const createDetectedFrameworkFlags: (detectedFrameworks?: DetectedFrameworkName[]) => FrameworkFlags;
+declare const getBundledFrameworkConfig: (frameworkName: FrameworkName, options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const angular: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const astro: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const expo: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const hono: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const lit: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const nest: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const next: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const nuxt: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const preact: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const qwik: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const react: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const reactRouter: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const slidev: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const solid: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const svelte: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const tanstackStart: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const vite: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+declare const vue: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+/**
+ * @deprecated Remix merged into React Router v7. Use `reactRouter` (the
+ * `react-router` framework key) instead. This alias loads the legacy Remix
+ * config and will be removed in the next major version.
+ */
+declare const remix: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+/** @deprecated Use `angular` instead. */
+declare const angularConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+/** @deprecated Use `expo` instead. */
+declare const expoConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+/** @deprecated Use `nest` instead. */
+declare const nestConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+/** @deprecated Use `next` instead. */
+declare const nextConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+/** @deprecated Use `preact` instead. */
+declare const preactConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+/** @deprecated Use `react` instead. */
+declare const reactConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+/** @deprecated Use `solid` instead. */
+declare const solidConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+/** @deprecated Use `svelte` instead. */
+declare const svelteConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+/** @deprecated Use `vue` instead. */
+declare const vueConfig: (options?: FrameworkOptions) => Promise<FlatConfigArray>;
+
+export { type FrameworkFlags, type FrameworkName, type FrameworkOptions, angular, angularConfig, astro, createDetectedFrameworkFlags, expo, expoConfig, getBundledFrameworkConfig, hono, lit, nest, nestConfig, next, nextConfig, nuxt, preact, preactConfig, qwik, react, reactConfig, reactRouter, remix, slidev, solid, solidConfig, svelte, svelteConfig, tanstackStart, vite, vue, vueConfig };

package/dist/frameworks.js

@@ -0,0 +1,105 @@
+import { loadModule } from "./lazy.js";
+const createDetectedFrameworkFlags = (detectedFrameworks = []) => Object.fromEntries(
+  detectedFrameworks.map((framework) => [framework, true])
+);
+const frameworkLoaders = /* @__PURE__ */ new Map([
+  ["angular", async () => (await loadModule("@santi020k/eslint-config-angular")).angularConfig],
+  ["astro", async () => (await loadModule("@santi020k/eslint-config-astro")).default],
+  ["expo", async () => (await loadModule("@santi020k/eslint-config-expo")).expoConfig],
+  ["hono", async () => (await loadModule("@santi020k/eslint-config-hono")).hono],
+  ["lit", async () => (await loadModule("@santi020k/eslint-config-lit")).lit],
+  ["nest", async () => (await loadModule("@santi020k/eslint-config-nest")).nestConfig],
+  ["next", async () => (await loadModule("@santi020k/eslint-config-next")).nextConfig],
+  ["nuxt", async () => (await loadModule("@santi020k/eslint-config-nuxt")).nuxt],
+  ["preact", async () => (await loadModule("@santi020k/eslint-config-preact")).preactConfig],
+  ["qwik", async () => (await loadModule("@santi020k/eslint-config-qwik")).qwik],
+  ["react", async () => (await loadModule("@santi020k/eslint-config-react")).reactConfig],
+  ["react-router", async () => (await loadModule("@santi020k/eslint-config-react-router")).reactRouter],
+  ["remix", async () => (await loadModule("@santi020k/eslint-config-remix")).default],
+  ["slidev", async () => (await loadModule("@santi020k/eslint-config-slidev")).slidev],
+  ["solid", async () => (await loadModule("@santi020k/eslint-config-solid")).solidConfig],
+  ["svelte", async () => (await loadModule("@santi020k/eslint-config-svelte")).svelteConfig],
+  ["tanstack-start", async () => (await loadModule("@santi020k/eslint-config-tanstack-start")).tanstackStart],
+  ["vite", async () => (await loadModule("@santi020k/eslint-config-vite")).vite],
+  ["vue", async () => (await loadModule("@santi020k/eslint-config-vue")).vueConfig]
+]);
+const frameworkConfigCache = /* @__PURE__ */ new Map();
+const loadFrameworkConfigInput = (frameworkName) => {
+  const cached = frameworkConfigCache.get(frameworkName);
+  if (cached) return cached;
+  const loader = frameworkLoaders.get(frameworkName);
+  if (!loader) return Promise.resolve([]);
+  const pending = loader().catch((error) => {
+    throw new Error(
+      `Unable to load optional framework config "${frameworkName}". Install "@santi020k/eslint-config-${frameworkName}" when using @santi020k/eslint-config-lite, or remove that framework from your eslintConfig options.`,
+      { cause: error }
+    );
+  });
+  frameworkConfigCache.set(frameworkName, pending);
+  return pending;
+};
+const getBundledFrameworkConfig = async (frameworkName, options) => {
+  const input = await loadFrameworkConfigInput(frameworkName);
+  return typeof input === "function" ? input(options) : input;
+};
+const createBundledFramework = (frameworkName) => async (options) => getBundledFrameworkConfig(frameworkName, options);
+const angular = createBundledFramework("angular");
+const astro = createBundledFramework("astro");
+const expo = createBundledFramework("expo");
+const hono = createBundledFramework("hono");
+const lit = createBundledFramework("lit");
+const nest = createBundledFramework("nest");
+const next = createBundledFramework("next");
+const nuxt = createBundledFramework("nuxt");
+const preact = createBundledFramework("preact");
+const qwik = createBundledFramework("qwik");
+const react = createBundledFramework("react");
+const reactRouter = createBundledFramework("react-router");
+const slidev = createBundledFramework("slidev");
+const solid = createBundledFramework("solid");
+const svelte = createBundledFramework("svelte");
+const tanstackStart = createBundledFramework("tanstack-start");
+const vite = createBundledFramework("vite");
+const vue = createBundledFramework("vue");
+const remix = createBundledFramework("remix");
+const angularConfig = angular;
+const expoConfig = expo;
+const nestConfig = nest;
+const nextConfig = next;
+const preactConfig = preact;
+const reactConfig = react;
+const solidConfig = solid;
+const svelteConfig = svelte;
+const vueConfig = vue;
+export {
+  angular,
+  angularConfig,
+  astro,
+  createDetectedFrameworkFlags,
+  expo,
+  expoConfig,
+  getBundledFrameworkConfig,
+  hono,
+  lit,
+  nest,
+  nestConfig,
+  next,
+  nextConfig,
+  nuxt,
+  preact,
+  preactConfig,
+  qwik,
+  react,
+  reactConfig,
+  reactRouter,
+  remix,
+  slidev,
+  solid,
+  solidConfig,
+  svelte,
+  svelteConfig,
+  tanstackStart,
+  vite,
+  vue,
+  vueConfig
+};

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { EslintConfigOptions, FlatConfigArray } from '@santi020k/eslint-config-core';
+export { DetectedFrameworkName, DetectionOptions, EslintConfigOptions, Extension, ExtensionName, ExtensionOption, FlatConfigArray, Format, FormatName, FormatOption, ImportedFramework, Library, LibraryName, LibraryOption, NextMode, NextModeName, NextModeOption, OptionalConfigMap, OptionalConfigName, Preset, PresetName, PresetOption, ReactConfigKeys, Runtime, RuntimeName, RuntimeOption, Setting, SettingName, SettingOption, StrictMode, Testing, TestingName, TestingOption, Tool, ToolName, ToolOption, TypeScriptMode, TypeScriptOptions, coreConfig, createCoreConfig, createImportGroups, detectProjectOptions, getGlobalsForRuntime, gitignore, hasReactConfig, jsConfig } from '@santi020k/eslint-config-core';
+export { angular, angularConfig, astro, expo, expoConfig, hono, lit, nest, nestConfig, next, nextConfig, nuxt, preact, preactConfig, qwik, react, reactConfig, reactRouter, remix, slidev, solid, solidConfig, svelte, svelteConfig, tanstackStart, vite, vue, vueConfig } from './frameworks.js';
+export { tsConfig, typescriptConfig } from '@santi020k/eslint-config-typescript';
+
+/**
+ * Generates the ESLint configuration array, applying configurations
+ * and integration settings based on the input configuration.
+ *
+ * @param {EslintConfigOptions} options - Configuration and integration settings
+ * @returns {FlatConfigArray} The final ESLint configuration array
+ */
+declare const eslintConfig: (options?: EslintConfigOptions) => Promise<FlatConfigArray>;
+/**
+ * Alias for `eslintConfig()` that reads naturally in `eslint.config.*` files.
+ */
+declare const defineConfig: (options?: EslintConfigOptions) => Promise<FlatConfigArray>;
+
+export { defineConfig, eslintConfig };