@xylabs/eslint-config-flat 8.2.18 → 8.2.19

package/dist/neutral/tiers/index.d.ts

@@ -1,36 +1,48 @@
 import type { Linter } from 'eslint';
+export { applyRecommendedConfigTypeChecked, DEFAULT_RECOMMENDED_CONFIG_OPTIONS, formatRecommendedConfigCall, type LintTier, parseRecommendedConfigSource, recommendedConfig, type RecommendedConfigOptions, resolveRecommendedConfigOptions, } from './recommendedConfig.ts';
 /**
  * Tier 0 — correctness: type safety, bug prevention, import restrictions.
  * Each subsequent tier is a superset of the previous tier.
+ *
+ * @deprecated Use `recommendedConfig({ tier: 0, isTypeChecked: false })` instead.
  */
 export declare const configTier0Correctness: Linter.Config[];
+/** @deprecated Use `recommendedConfig({ tier: 0, isTypeChecked: true })` instead. */
 export declare const configTier0CorrectnessTypeChecked: Linter.Config[];
 /**
  * Tier 1 — consistency: Tier 0 plus formatting, member ordering, and complexity limits.
+ *
+ * @deprecated Use `recommendedConfig({ tier: 1, isTypeChecked: false })` instead.
  */
 export declare const configTier1Consistency: Linter.Config[];
+/** @deprecated Use `recommendedConfig({ tier: 1, isTypeChecked: true })` instead. */
 export declare const configTier1ConsistencyTypeChecked: Linter.Config[];
 /**
  * Tier 2 — best practices: Tier 1 plus unicorn and import validation.
- * This is the recommended default for XY Labs repositories.
+ *
+ * @deprecated Use `recommendedConfig({ tier: 2, isTypeChecked: false })` instead.
  */
 export declare const configTier2BestPractices: Linter.Config[];
+/** @deprecated Use `recommendedConfig({ tier: 2, isTypeChecked: true })` instead. */
 export declare const configTier2BestPracticesTypeChecked: Linter.Config[];
 /**
  * Tier 3 — opinionated: Tier 2 plus unicorn v66 warnings and promotion of optional rules to errors.
+ *
+ * @deprecated Use `recommendedConfig({ tier: 3, isTypeChecked: false })` instead.
  */
 export declare const configTier3Opinionated: Linter.Config[];
+/** @deprecated Use `recommendedConfig({ tier: 3, isTypeChecked: true })` instead. */
 export declare const configTier3OpinionatedTypeChecked: Linter.Config[];
 /**
  * Tier 4 — experimental: Tier 3 plus unicorn v67 warnings (v66 remain warnings).
- * New tier-only rules default to warnings; use `xy lint --strict` to treat them as errors.
+ *
+ * @deprecated Use `recommendedConfig({ tier: 4, isTypeChecked: false })` instead.
  */
 export declare const configTier4Experimental: Linter.Config[];
+/** @deprecated Use `recommendedConfig({ tier: 4, isTypeChecked: true })` instead. */
 export declare const configTier4ExperimentalTypeChecked: Linter.Config[];
-/** @deprecated Use `configTier2BestPractices` instead. */
-export declare const recommendedConfig: Linter.Config[];
-/** @deprecated Use `configTier2BestPracticesTypeChecked` instead. */
+/** @deprecated Use `recommendedConfig({ tier: 2, isTypeChecked: false })` instead. */
 export declare const recommendedTypeCheckedConfig: Linter.Config[];
-/** @deprecated Use `configTier3OpinionatedTypeChecked` instead. */
+/** @deprecated Use `recommendedConfig({ tier: 2, isTypeChecked: true })` instead. */
 export declare const config: Linter.Config[];
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/tiers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tiers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AA0BpC;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAIjD,CAAA;AAED,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAI5D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAKjD,CAAA;AAED,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAK5D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAInD,CAAA;AAED,eAAO,MAAM,mCAAmC,EAAE,MAAM,CAAC,MAAM,EAI9D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAGjD,CAAA;AAED,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAG5D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAGlD,CAAA;AAED,eAAO,MAAM,kCAAkC,EAAE,MAAM,CAAC,MAAM,EAG7D,CAAA;AAED,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAA6B,CAAA;AAE1E,qEAAqE;AACrE,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAwC,CAAA;AAEhG,mEAAmE;AACnE,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAwC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tiers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEpC,OAAO,EACL,iCAAiC,EACjC,kCAAkC,EAClC,2BAA2B,EAC3B,KAAK,QAAQ,EACb,4BAA4B,EAC5B,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,+BAA+B,GAChC,MAAM,wBAAwB,CAAA;AAI/B;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAyD,CAAA;AAE3G,qFAAqF;AACrF,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAwD,CAAA;AAErH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAyD,CAAA;AAE3G,qFAAqF;AACrF,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAwD,CAAA;AAErH;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAyD,CAAA;AAE7G,qFAAqF;AACrF,eAAO,MAAM,mCAAmC,EAAE,MAAM,CAAC,MAAM,EAAwD,CAAA;AAEvH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAyD,CAAA;AAE3G,qFAAqF;AACrF,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAwD,CAAA;AAErH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAyD,CAAA;AAE5G,qFAAqF;AACrF,eAAO,MAAM,kCAAkC,EAAE,MAAM,CAAC,MAAM,EAAwD,CAAA;AAEtH,sFAAsF;AACtF,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAwD,CAAA;AAEhH,qFAAqF;AACrF,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAwD,CAAA"}

package/dist/neutral/tiers/recommendedConfig.d.ts

@@ -0,0 +1,16 @@
+import type { Linter } from 'eslint';
+export type LintTier = 0 | 1 | 2 | 3 | 4;
+export interface RecommendedConfigOptions {
+    isTypeChecked?: boolean;
+    tier?: LintTier;
+}
+export declare const DEFAULT_RECOMMENDED_CONFIG_OPTIONS: Required<RecommendedConfigOptions>;
+export declare function resolveRecommendedConfigOptions(options?: RecommendedConfigOptions): Required<RecommendedConfigOptions>;
+export declare function recommendedConfig(options?: RecommendedConfigOptions): Linter.Config[];
+export declare function formatRecommendedConfigCall(options: RecommendedConfigOptions): string;
+export declare function parseRecommendedConfigSource(source: string): {
+    configKind: 'custom' | 'preset';
+    options: Required<RecommendedConfigOptions>;
+} | undefined;
+export declare function applyRecommendedConfigTypeChecked(source: string, isEnabled: boolean): string;
+//# sourceMappingURL=recommendedConfig.d.ts.map

package/dist/neutral/tiers/recommendedConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendedConfig.d.ts","sourceRoot":"","sources":["../../../src/tiers/recommendedConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAsBpC,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAExC,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,IAAI,CAAC,EAAE,QAAQ,CAAA;CAChB;AAED,eAAO,MAAM,kCAAkC,EAAE,QAAQ,CAAC,wBAAwB,CAGjF,CAAA;AAqFD,wBAAgB,+BAA+B,CAC7C,OAAO,CAAC,EAAE,wBAAwB,GACjC,QAAQ,CAAC,wBAAwB,CAAC,CAKpC;AAED,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,CAGrF;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAGrF;AA4BD,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,GACb;IAAE,UAAU,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAC,wBAAwB,CAAC,CAAA;CAAE,GAAG,SAAS,CAQ9F;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,OAAO,GACjB,MAAM,CAOR"}

package/dist/node/index.mjs

@@ -824,61 +824,151 @@ var experimentalUnicornLayerConfig = {
 var experimentalLayerConfig = experimentalUnicornLayerConfig;
 var experimentalPromotionRules = experimentalUnicornLayerConfig.rules;
 
-// src/tiers/index.ts
+// src/tiers/recommendedConfig.ts
+var DEFAULT_RECOMMENDED_CONFIG_OPTIONS = {
+  isTypeChecked: true,
+  tier: 3
+};
+var composedConfigModules = [
+  "bestPracticesCoreConfig",
+  "consistencyRulesConfig",
+  "correctnessCoreConfig",
+  "importConfig",
+  "rulesConfig",
+  "typescriptConfig",
+  "typescriptConsistencyConfig",
+  "typescriptCorrectnessConfig",
+  "typescriptTypeCheckedConfig",
+  "typescriptTypeCheckedConsistencyConfig",
+  "typescriptTypeCheckedCorrectnessConfig",
+  "unicornConfig",
+  "workspacesConfig"
+];
 function mergeTierConfigs(...parts) {
   return parts.flat();
 }
-var configTier0Correctness = mergeTierConfigs(
-  markdownConfig,
-  correctnessCoreConfig,
-  typescriptCorrectnessConfig
-);
-var configTier0CorrectnessTypeChecked = mergeTierConfigs(
-  markdownConfig,
-  correctnessCoreConfig,
-  typescriptTypeCheckedCorrectnessConfig
-);
-var configTier1Consistency = mergeTierConfigs(
-  configTier0Correctness,
-  [consistencyRulesConfig],
-  typescriptConsistencyConfig,
-  [typescriptDelegationConfig]
-);
-var configTier1ConsistencyTypeChecked = mergeTierConfigs(
-  configTier0CorrectnessTypeChecked,
-  [consistencyRulesConfig],
-  typescriptTypeCheckedConsistencyConfig,
-  [typescriptDelegationConfig]
-);
-var configTier2BestPractices = mergeTierConfigs(
-  configTier1Consistency,
-  bestPracticesCoreConfig,
-  importConfig
-);
-var configTier2BestPracticesTypeChecked = mergeTierConfigs(
-  configTier1ConsistencyTypeChecked,
-  bestPracticesCoreConfig,
-  importConfig
-);
-var configTier3Opinionated = mergeTierConfigs(
-  configTier2BestPractices,
-  [opinionatedUnicornV66LayerConfig, opinionatedPromotionLayerConfig]
-);
-var configTier3OpinionatedTypeChecked = mergeTierConfigs(
-  configTier2BestPracticesTypeChecked,
-  [opinionatedUnicornV66LayerConfig, opinionatedPromotionLayerConfig]
-);
-var configTier4Experimental = mergeTierConfigs(
-  configTier3Opinionated,
-  [experimentalUnicornLayerConfig]
-);
-var configTier4ExperimentalTypeChecked = mergeTierConfigs(
-  configTier3OpinionatedTypeChecked,
-  [experimentalUnicornLayerConfig]
-);
-var recommendedConfig = configTier2BestPractices;
-var recommendedTypeCheckedConfig = configTier2BestPracticesTypeChecked;
-var config = configTier2BestPracticesTypeChecked;
+function buildTier0(isTypeChecked) {
+  return mergeTierConfigs(
+    markdownConfig,
+    correctnessCoreConfig,
+    isTypeChecked ? typescriptTypeCheckedCorrectnessConfig : typescriptCorrectnessConfig
+  );
+}
+function buildTier1(isTypeChecked) {
+  return mergeTierConfigs(
+    buildTier0(isTypeChecked),
+    [consistencyRulesConfig],
+    isTypeChecked ? typescriptTypeCheckedConsistencyConfig : typescriptConsistencyConfig,
+    [typescriptDelegationConfig]
+  );
+}
+function buildTier2(isTypeChecked) {
+  return mergeTierConfigs(
+    buildTier1(isTypeChecked),
+    bestPracticesCoreConfig,
+    importConfig
+  );
+}
+function buildTier3(isTypeChecked) {
+  return mergeTierConfigs(
+    buildTier2(isTypeChecked),
+    [opinionatedUnicornV66LayerConfig, opinionatedPromotionLayerConfig]
+  );
+}
+function buildTier4(isTypeChecked) {
+  return mergeTierConfigs(
+    buildTier3(isTypeChecked),
+    [experimentalUnicornLayerConfig]
+  );
+}
+function buildTierConfig(tier, isTypeChecked) {
+  switch (tier) {
+    case 0: {
+      return buildTier0(isTypeChecked);
+    }
+    case 1: {
+      return buildTier1(isTypeChecked);
+    }
+    case 2: {
+      return buildTier2(isTypeChecked);
+    }
+    case 3: {
+      return buildTier3(isTypeChecked);
+    }
+    case 4: {
+      return buildTier4(isTypeChecked);
+    }
+    default: {
+      const unsupported = tier;
+      throw new Error(`Unsupported lint tier ${unsupported}`);
+    }
+  }
+}
+function resolveRecommendedConfigOptions(options) {
+  return {
+    isTypeChecked: options?.isTypeChecked ?? DEFAULT_RECOMMENDED_CONFIG_OPTIONS.isTypeChecked,
+    tier: options?.tier ?? DEFAULT_RECOMMENDED_CONFIG_OPTIONS.tier
+  };
+}
+function recommendedConfig(options) {
+  const resolved = resolveRecommendedConfigOptions(options);
+  return buildTierConfig(resolved.tier, resolved.isTypeChecked);
+}
+function formatRecommendedConfigCall(options) {
+  const resolved = resolveRecommendedConfigOptions(options);
+  return `recommendedConfig({ tier: ${resolved.tier}, isTypeChecked: ${String(resolved.isTypeChecked)} })`;
+}
+function hasComposedConfigModules(source) {
+  return composedConfigModules.some((module) => source.includes(module));
+}
+function parseRecommendedConfigOptionsLiteral(literal) {
+  const resolved = { ...DEFAULT_RECOMMENDED_CONFIG_OPTIONS };
+  if (literal === void 0 || literal.trim().length === 0) return resolved;
+  const tierMatch = /tier:\s*([0-4])\b/.exec(literal);
+  if (tierMatch !== null) {
+    resolved.tier = Number(tierMatch[1]);
+  }
+  const isTypeCheckedMatch = /isTypeChecked:\s*(true|false)\b/.exec(literal);
+  if (isTypeCheckedMatch === null) {
+    const legacyTypeCheckedMatch = /typeChecked:\s*(true|false)\b/.exec(literal);
+    if (legacyTypeCheckedMatch !== null) {
+      resolved.isTypeChecked = legacyTypeCheckedMatch[1] === "true";
+    }
+  } else {
+    resolved.isTypeChecked = isTypeCheckedMatch[1] === "true";
+  }
+  return resolved;
+}
+function parseRecommendedConfigSource(source) {
+  const callPattern = /recommendedConfig\s*\(\s*(?:\{([^}]*)\})?\s*\)/g;
+  const match = callPattern.exec(source);
+  if (match === null) return void 0;
+  const options = parseRecommendedConfigOptionsLiteral(match[1]);
+  const configKind = hasComposedConfigModules(source) ? "custom" : "preset";
+  return { configKind, options };
+}
+function applyRecommendedConfigTypeChecked(source, isEnabled) {
+  const callPattern = /recommendedConfig\s*\(\s*(?:\{([^}]*)\})?\s*\)/g;
+  return source.replaceAll(callPattern, (_match, literal) => {
+    const options = parseRecommendedConfigOptionsLiteral(literal);
+    options.isTypeChecked = isEnabled;
+    return formatRecommendedConfigCall(options);
+  });
+}
+
+// src/tiers/index.ts
+var configTier0Correctness = recommendedConfig({ tier: 0, isTypeChecked: false });
+var configTier0CorrectnessTypeChecked = recommendedConfig({ tier: 0, isTypeChecked: true });
+var configTier1Consistency = recommendedConfig({ tier: 1, isTypeChecked: false });
+var configTier1ConsistencyTypeChecked = recommendedConfig({ tier: 1, isTypeChecked: true });
+var configTier2BestPractices = recommendedConfig({ tier: 2, isTypeChecked: false });
+var configTier2BestPracticesTypeChecked = recommendedConfig({ tier: 2, isTypeChecked: true });
+var configTier3Opinionated = recommendedConfig({ tier: 3, isTypeChecked: false });
+var configTier3OpinionatedTypeChecked = recommendedConfig({ tier: 3, isTypeChecked: true });
+var configTier4Experimental = recommendedConfig({ tier: 4, isTypeChecked: false });
+var configTier4ExperimentalTypeChecked = recommendedConfig({ tier: 4, isTypeChecked: true });
+var recommendedTypeCheckedConfig = recommendedConfig({ tier: 2, isTypeChecked: true });
+var config = recommendedConfig({ tier: 2, isTypeChecked: true });
 
 // src/tiers/plugin-rules.ts
 import js2 from "@eslint/js";
@@ -994,7 +1084,9 @@ var docsConfig = [
   json5Config
 ];
 export {
+  DEFAULT_RECOMMENDED_CONFIG_OPTIONS,
   RULE_OWNERSHIP_GROUPS,
+  applyRecommendedConfigTypeChecked,
   assertNoRuleOwnershipConflicts,
   bestPracticesCoreConfig,
   collectPluginRuleSnapshots,
@@ -1018,6 +1110,7 @@ export {
   experimentalPromotionRules,
   experimentalUnicornLayerConfig,
   findRuleOwnershipConflicts,
+  formatRecommendedConfigCall,
   ignores,
   importConfig,
   json5Config,
@@ -1029,8 +1122,10 @@ export {
   opinionatedPromotionLayerConfig,
   opinionatedPromotionRules,
   opinionatedUnicornV66LayerConfig,
+  parseRecommendedConfigSource,
   recommendedConfig,
   recommendedTypeCheckedConfig,
+  resolveRecommendedConfigOptions,
   rulesConfig,
   serializePluginRuleSnapshots,
   srcImportsConfig,