@eslint-react/shared 3.0.0-next.6 → 3.0.0-next.60

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { unit } from "@eslint-react/eff";
 import { z } from "zod/v4";
 import * as tseslint from "@typescript-eslint/utils/ts-eslint";
-import { ReportDescriptor, RuleListener } from "@typescript-eslint/utils/ts-eslint";
+import { ReportDescriptor, ReportFixFunction, RuleFix, RuleFixer, RuleListener } from "@typescript-eslint/utils/ts-eslint";
 
 //#region src/_id.d.ts
 /**
@@ -21,115 +21,6 @@ declare class IdGenerator {
   next(): string;
 }
 //#endregion
-//#region src/types.d.ts
-/**
- * Rule severity.
- * @since 0.0.1
- */
-type SeverityName = "off" | "warn" | "error";
-/**
- * The numeric severity level for a rule.
- *
- * - `0` means off.
- * - `1` means warn.
- * - `2` means error.
- */
-type SeverityLevel = 0 | 1 | 2;
-/**
- * The severity of a rule in a configuration.
- */
-type Severity = SeverityName | SeverityLevel;
-/**
- * Rule declaration.
- * @internal
- * @since 0.0.1
- */
-type RuleConfig<RuleOptions extends unknown[] = unknown[]> = Severity | [Severity, ...Partial<RuleOptions>];
-/**
- * Rule context.
- * @since 0.0.1
- */
-type RuleContext<MessageIds extends string = string, Options extends readonly unknown[] = readonly unknown[]> = tseslint.RuleContext<MessageIds, Options>;
-/**
- * Rule feature.
- * @since 1.20.0
- */
-type RuleFeature = "CFG" | "DBG" | "FIX" | "MOD" | "TSC" | "EXP";
-/**
- * The numeric policy value for a rule (severity level).
- */
-type RulePolicy = number;
-/**
- * A suggestion for fixing a reported issue.
- */
-type RuleSuggest<MessageIds extends string = string> = {
-  /** The message ID for the suggestion. */messageId: MessageIds; /** Optional data to pass to the message formatter. */
-  data?: Record<string, unknown>; /** The fix function to apply the suggestion. */
-  fix: tseslint.ReportFixFunction;
-};
-/**
- * A collection of settings.
- */
-interface SettingsConfig {
-  [key: string]: unknown;
-}
-/**
- * A rule with a compatible shape for use with `defineConfig()` and `tseslint.config()`.
- * Intentionally wide/inaccurate for compatibility purposes.
- */
-interface CompatibleRule {
-  meta: Record<string, any>;
-  create: (...args: any[]) => any;
-}
-/**
- * A plugin with a compatible shape for use with `defineConfig()` and `tseslint.config()`.
- * Intentionally wide/inaccurate for compatibility purposes.
- */
-interface CompatiblePlugin {
-  meta: {
-    name: string;
-    version: string;
-  };
-  rules: Record<string, CompatibleRule>;
-}
-/**
- * A configuration object with a compatible shape for use with `defineConfig()` and `tseslint.config()`.
- * Intentionally wide/inaccurate for compatibility purposes.
- */
-interface CompatibleConfig {
-  /** Optional configuration name. */
-  name?: string;
-  /** Rule configurations. */
-  rules?: Record<string, RuleConfig>;
-  /** Shared settings. */
-  settings?: SettingsConfig;
-}
-type CompilationMode = "off" | "infer" | "annotation" | "syntax" | "all";
-//#endregion
-//#region src/config-adapters.d.ts
-/**
- * Get configuration adapters for converting between flat and legacy config formats
- * @param pluginName The name of the plugin
- * @param plugin The plugin instance
- * @returns Object with toFlatConfig and toLegacyConfig functions
- */
-declare function getConfigAdapters(pluginName: string, plugin: CompatiblePlugin): {
-  readonly toFlatConfig: (config: CompatibleConfig) => {
-    plugins: {
-      [pluginName]: CompatiblePlugin;
-    };
-    name?: string;
-    rules?: Record<string, RuleConfig>;
-    settings?: SettingsConfig;
-  };
-  readonly toLegacyConfig: ({
-    rules
-  }: CompatibleConfig) => {
-    plugins: string[];
-    rules: Record<string, RuleConfig<unknown[]>> | undefined;
-  };
-};
-//#endregion
 //#region src/constants.d.ts
 /**
  * The NPM scope for this project.
@@ -215,11 +106,11 @@ declare const RE_HOOK_NAME: RegExp;
 /**
  * Known impure functions
  */
-declare const IMPURE_FUNCTIONS: ReadonlyMap<string, ReadonlySet<string>>;
+declare const IMPURE_FUNCS: ReadonlyMap<string, ReadonlySet<string>>;
 /**
  * Known impure global constructors used with `new`
  */
-declare const IMPURE_CONSTRUCTORS: ReadonlySet<string>;
+declare const IMPURE_CTORS: ReadonlySet<string>;
 //#endregion
 //#region src/define-rule-listener.d.ts
 /**
@@ -270,6 +161,55 @@ declare function toRegExp(string: string | unit): RegExpLike;
  */
 declare function isRegExp(string: string): boolean;
 //#endregion
+//#region src/types.d.ts
+/**
+ * Rule severity.
+ * @since 0.0.1
+ */
+type SeverityName = "off" | "warn" | "error";
+/**
+ * The numeric severity level for a rule.
+ *
+ * - `0` means off.
+ * - `1` means warn.
+ * - `2` means error.
+ */
+type SeverityLevel = 0 | 1 | 2;
+/**
+ * The severity of a rule in a configuration.
+ */
+type Severity = SeverityName | SeverityLevel;
+/**
+ * Rule declaration.
+ * @internal
+ * @since 0.0.1
+ */
+type RuleConfig<RuleOptions extends unknown[] = unknown[]> = Severity | [Severity, ...Partial<RuleOptions>];
+/**
+ * Rule context.
+ * @since 0.0.1
+ */
+type RuleContext<MessageIds extends string = string, Options extends readonly unknown[] = readonly unknown[]> = tseslint.RuleContext<MessageIds, Options>;
+/**
+ * Rule feature.
+ * @since 1.20.0
+ */
+type RuleFeature = "CFG" | "DBG" | "FIX" | "MOD" | "TSC" | "EXP";
+/**
+ * A suggestion for fixing a reported issue.
+ */
+type RuleSuggest<MessageIds extends string = string> = {
+  /** Optional data to pass to the message formatter. */data?: Record<string, unknown>; /** The fix function to apply the suggestion. */
+  fix: tseslint.ReportFixFunction; /** The message ID for the suggestion. */
+  messageId: MessageIds;
+};
+/**
+ * A collection of settings.
+ */
+interface SettingsConfig {
+  [key: string]: unknown;
+}
+//#endregion
 //#region src/report.d.ts
 /**
  * Creates a report function for the given rule context.
@@ -280,13 +220,11 @@ declare function report(context: RuleContext): (descriptor?: null | ReportDescri
 //#endregion
 //#region src/settings.d.ts
 /**
- * Schema for ESLint React settings configuration
  * @internal
  */
 declare const ESLintReactSettingsSchema: z.ZodObject<{
   importSource: z.ZodOptional<z.ZodString>;
   compilationMode: z.ZodOptional<z.ZodEnum<{
-    off: "off";
     infer: "infer";
     annotation: "annotation";
     syntax: "syntax";
@@ -295,117 +233,61 @@ declare const ESLintReactSettingsSchema: z.ZodObject<{
   polymorphicPropName: z.ZodOptional<z.ZodString>;
   version: z.ZodOptional<z.ZodString>;
   additionalStateHooks: z.ZodOptional<z.ZodString>;
+  additionalEffectHooks: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
- * Schema for ESLint settings
  * @internal
  */
 declare const ESLintSettingsSchema: z.ZodOptional<z.ZodObject<{
   "react-x": z.ZodOptional<z.ZodUnknown>;
 }, z.core.$strip>>;
-/**
- * ESLint settings type inferred from the settings schema.
- */
 type ESLintSettings = z.infer<typeof ESLintSettingsSchema>;
-/**
- * ESLint React settings type inferred from the React settings schema.
- */
 type ESLintReactSettings = z.infer<typeof ESLintReactSettingsSchema>;
-/**
- * Normalized ESLint React settings with processed values
- */
 interface ESLintReactSettingsNormalized {
   version: string;
   importSource: string;
-  compilationMode: CompilationMode;
-  isCompilerEnabled: boolean;
+  compilationMode: ESLintReactSettings["compilationMode"] | "off";
   polymorphicPropName: string | unit;
   additionalStateHooks: RegExpLike;
+  additionalEffectHooks: RegExpLike;
 }
-/**
- * Default ESLint React settings
- */
 declare const DEFAULT_ESLINT_REACT_SETTINGS: {
   readonly version: "detect";
   readonly importSource: "react";
-  readonly compilationMode: "annotation";
   readonly polymorphicPropName: "as";
 };
-/**
- * Default ESLint settings with React settings included
- */
 declare const DEFAULT_ESLINT_SETTINGS: {
   readonly "react-x": {
     readonly version: "detect";
     readonly importSource: "react";
-    readonly compilationMode: "annotation";
     readonly polymorphicPropName: "as";
   };
 };
-/**
- * Check if the provided settings conform to ESLintSettings schema
- * @param settings The settings object to validate
- */
 declare function isESLintSettings(settings: unknown): settings is ESLintSettings;
-/**
- * Check if the provided settings conform to ESLintReactSettings schema
- * @param settings The settings object to validate
- */
 declare function isESLintReactSettings(settings: unknown): settings is ESLintReactSettings;
-/**
- * Coerces unknown input to ESLintSettings type
- * @param settings The settings object to coerce
- */
-declare const coerceESLintSettings: (settings: unknown) => Partial<ESLintSettings>;
-/**
- * Decodes and validates ESLint settings, using defaults if invalid
- * @param settings The settings object to decode
- */
 declare const decodeESLintSettings: (settings: unknown) => ESLintSettings;
-/**
- * Coerces unknown input to ESLintReactSettings type
- * @param settings The settings object to coerce
- */
-declare const coerceSettings: (settings: unknown) => Partial<ESLintReactSettings>;
-/**
- * Decodes and validates ESLint React settings, using defaults if invalid
- * @param settings The settings object to decode
- */
 declare const decodeSettings: (settings: unknown) => ESLintReactSettings;
-/**
- * Normalizes ESLint React settings to a consistent internal format
- * Transforms component definitions and resolves version information
- */
 declare const normalizeSettings: ({
   importSource,
   compilationMode,
   polymorphicPropName,
   version,
   additionalStateHooks,
+  additionalEffectHooks,
   ...rest
 }: ESLintReactSettings) => {
   readonly importSource: string;
-  readonly compilationMode: "off" | "infer" | "annotation" | "syntax" | "all";
-  readonly isCompilerEnabled: boolean;
+  readonly compilationMode: "infer" | "annotation" | "syntax" | "all" | "off";
   readonly polymorphicPropName: string;
   readonly version: string;
   readonly additionalStateHooks: RegExpLike;
+  readonly additionalEffectHooks: RegExpLike;
 };
-/**
- * Retrieves normalized ESLint React settings from the rule context
- * Uses caching for performance optimization
- * @param context The ESLint rule context
- */
 declare function getSettingsFromContext(context: RuleContext): ESLintReactSettingsNormalized;
-/**
- * Helper function for defining typed settings for "react-x" in JavaScript files
- * Provides type checking without runtime transformation
- */
-declare const defineSettings: (settings: ESLintReactSettings) => ESLintReactSettings;
 declare module "@typescript-eslint/utils/ts-eslint" {
   interface SharedConfigurationSettings {
     ["react-x"]?: Partial<ESLintReactSettings>;
   }
 }
 //#endregion
-export { CompatibleConfig, CompatiblePlugin, CompatibleRule, CompilationMode, DEFAULT_ESLINT_REACT_SETTINGS, DEFAULT_ESLINT_SETTINGS, ESLintReactSettings, ESLintReactSettingsNormalized, ESLintReactSettingsSchema, ESLintSettings, ESLintSettingsSchema, GITHUB_URL, IMPURE_CONSTRUCTORS, IMPURE_FUNCTIONS, IdGenerator, NPM_SCOPE, RE_ANNOTATION_JSX, RE_ANNOTATION_JSX_FRAG, RE_ANNOTATION_JSX_IMPORT_SOURCE, RE_ANNOTATION_JSX_RUNTIME, RE_CAMEL_CASE, RE_COMPONENT_NAME, RE_COMPONENT_NAME_LOOSE, RE_CONSTANT_CASE, RE_HOOK_NAME, RE_HTML_TAG, RE_JAVASCRIPT_PROTOCOL, RE_JS_EXT, RE_JS_IDENTIFIER, RE_KEBAB_CASE, RE_PASCAL_CASE, RE_REGEXP_STR, RE_SNAKE_CASE, RE_TS_EXT, RegExpLike, RuleConfig, RuleContext, RuleFeature, RulePolicy, RuleSuggest, SettingsConfig, Severity, SeverityLevel, SeverityName, WEBSITE_URL, coerceESLintSettings, coerceSettings, decodeESLintSettings, decodeSettings, defineRuleListener, defineSettings, getConfigAdapters, getReactVersion, getSettingsFromContext, isESLintReactSettings, isESLintSettings, isRegExp, normalizeSettings, report, toRegExp };
+export { DEFAULT_ESLINT_REACT_SETTINGS, DEFAULT_ESLINT_SETTINGS, ESLintReactSettings, ESLintReactSettingsNormalized, ESLintReactSettingsSchema, ESLintSettings, ESLintSettingsSchema, GITHUB_URL, IMPURE_CTORS, IMPURE_FUNCS, IdGenerator, NPM_SCOPE, RE_ANNOTATION_JSX, RE_ANNOTATION_JSX_FRAG, RE_ANNOTATION_JSX_IMPORT_SOURCE, RE_ANNOTATION_JSX_RUNTIME, RE_CAMEL_CASE, RE_COMPONENT_NAME, RE_COMPONENT_NAME_LOOSE, RE_CONSTANT_CASE, RE_HOOK_NAME, RE_HTML_TAG, RE_JAVASCRIPT_PROTOCOL, RE_JS_EXT, RE_JS_IDENTIFIER, RE_KEBAB_CASE, RE_PASCAL_CASE, RE_REGEXP_STR, RE_SNAKE_CASE, RE_TS_EXT, RegExpLike, type ReportFixFunction, RuleConfig, RuleContext, RuleFeature, type RuleFix, type RuleFixer, RuleSuggest, SettingsConfig, Severity, SeverityLevel, SeverityName, WEBSITE_URL, decodeESLintSettings, decodeSettings, defineRuleListener, getReactVersion, getSettingsFromContext, isESLintReactSettings, isESLintSettings, isRegExp, normalizeSettings, report, toRegExp };

package/dist/index.js

@@ -28,33 +28,6 @@ var IdGenerator = class {
 	}
 };
 
-//#endregion
-//#region src/config-adapters.ts
-/**
-* Get configuration adapters for converting between flat and legacy config formats
-* @param pluginName The name of the plugin
-* @param plugin The plugin instance
-* @returns Object with toFlatConfig and toLegacyConfig functions
-*/
-function getConfigAdapters(pluginName, plugin) {
-	function toFlatConfig(config) {
-		return {
-			...config,
-			plugins: { [pluginName]: plugin }
-		};
-	}
-	function toLegacyConfig({ rules }) {
-		return {
-			plugins: [pluginName],
-			rules
-		};
-	}
-	return {
-		toFlatConfig,
-		toLegacyConfig
-	};
-}
-
 //#endregion
 //#region src/constants.ts
 /**
@@ -141,7 +114,7 @@ const RE_HOOK_NAME = /^use/u;
 /**
 * Known impure functions
 */
-const IMPURE_FUNCTIONS = new Map([
+const IMPURE_FUNCS = new Map([
 	["Atomics", new Set([
 		"add",
 		"and",
@@ -379,7 +352,7 @@ const IMPURE_FUNCTIONS = new Map([
 /**
 * Known impure global constructors used with `new`
 */
-const IMPURE_CONSTRUCTORS = new Set([
+const IMPURE_CTORS = new Set([
 	"AbortController",
 	"Audio",
 	"AudioContext",
@@ -492,13 +465,11 @@ function report(context) {
 //#endregion
 //#region src/settings.ts
 /**
-* Schema for ESLint React settings configuration
 * @internal
 */
 const ESLintReactSettingsSchema = z.object({
 	importSource: z.optional(z.string()),
 	compilationMode: z.optional(z.enum([
-		"off",
 		"infer",
 		"annotation",
 		"syntax",
@@ -506,100 +477,49 @@ const ESLintReactSettingsSchema = z.object({
 	])),
 	polymorphicPropName: z.optional(z.string()),
 	version: z.optional(z.string()),
-	additionalStateHooks: z.optional(z.string())
+	additionalStateHooks: z.optional(z.string()),
+	additionalEffectHooks: z.optional(z.string())
 });
 /**
-* Schema for ESLint settings
 * @internal
 */
 const ESLintSettingsSchema = z.optional(z.object({ "react-x": z.optional(z.unknown()) }));
-/**
-* Default ESLint React settings
-*/
 const DEFAULT_ESLINT_REACT_SETTINGS = {
 	version: "detect",
 	importSource: "react",
-	compilationMode: "annotation",
 	polymorphicPropName: "as"
 };
-/**
-* Default ESLint settings with React settings included
-*/
 const DEFAULT_ESLINT_SETTINGS = { "react-x": DEFAULT_ESLINT_REACT_SETTINGS };
-/**
-* Check if the provided settings conform to ESLintSettings schema
-* @param settings The settings object to validate
-*/
 function isESLintSettings(settings) {
 	return ESLintSettingsSchema.safeParse(settings).success;
 }
-/**
-* Check if the provided settings conform to ESLintReactSettings schema
-* @param settings The settings object to validate
-*/
 function isESLintReactSettings(settings) {
 	return ESLintReactSettingsSchema.safeParse(settings).success;
 }
-/**
-* Coerces unknown input to ESLintSettings type
-* @param settings The settings object to coerce
-*/
-const coerceESLintSettings = (settings) => {
-	return settings;
-};
-/**
-* Decodes and validates ESLint settings, using defaults if invalid
-* @param settings The settings object to decode
-*/
 const decodeESLintSettings = (settings) => {
 	if (isESLintSettings(settings)) return settings;
 	return DEFAULT_ESLINT_SETTINGS;
 };
-/**
-* Coerces unknown input to ESLintReactSettings type
-* @param settings The settings object to coerce
-*/
-const coerceSettings = (settings) => {
-	return settings;
-};
-/**
-* Decodes and validates ESLint React settings, using defaults if invalid
-* @param settings The settings object to decode
-*/
 const decodeSettings = (settings) => {
 	if (isESLintReactSettings(settings)) return settings;
 	return DEFAULT_ESLINT_REACT_SETTINGS;
 };
-/**
-* Normalizes ESLint React settings to a consistent internal format
-* Transforms component definitions and resolves version information
-*/
-const normalizeSettings = ({ importSource = "react", compilationMode = "annotation", polymorphicPropName = "as", version, additionalStateHooks, ...rest }) => {
+const normalizeSettings = ({ importSource = "react", compilationMode, polymorphicPropName = "as", version, additionalStateHooks, additionalEffectHooks, ...rest }) => {
 	return {
 		...rest,
 		importSource,
-		compilationMode,
-		isCompilerEnabled: compilationMode !== "off",
+		compilationMode: compilationMode ?? "off",
 		polymorphicPropName,
 		version: match(version).with(P.union(P.nullish, "", "detect"), () => getReactVersion("19.2.4")).otherwise(identity),
-		additionalStateHooks: toRegExp(additionalStateHooks)
+		additionalStateHooks: toRegExp(additionalStateHooks),
+		additionalEffectHooks: toRegExp(additionalEffectHooks)
 	};
 };
 const cache = /* @__PURE__ */ new Map();
-/**
-* Retrieves normalized ESLint React settings from the rule context
-* Uses caching for performance optimization
-* @param context The ESLint rule context
-*/
 function getSettingsFromContext(context) {
 	const settings = context.settings;
 	return getOrElseUpdate(cache, settings["react-x"], () => normalizeSettings(decodeSettings(settings["react-x"])));
 }
-/**
-* Helper function for defining typed settings for "react-x" in JavaScript files
-* Provides type checking without runtime transformation
-*/
-const defineSettings = identity;
 
 //#endregion
-export { DEFAULT_ESLINT_REACT_SETTINGS, DEFAULT_ESLINT_SETTINGS, ESLintReactSettingsSchema, ESLintSettingsSchema, GITHUB_URL, IMPURE_CONSTRUCTORS, IMPURE_FUNCTIONS, IdGenerator, NPM_SCOPE, RE_ANNOTATION_JSX, RE_ANNOTATION_JSX_FRAG, RE_ANNOTATION_JSX_IMPORT_SOURCE, RE_ANNOTATION_JSX_RUNTIME, RE_CAMEL_CASE, RE_COMPONENT_NAME, RE_COMPONENT_NAME_LOOSE, RE_CONSTANT_CASE, RE_HOOK_NAME, RE_HTML_TAG, RE_JAVASCRIPT_PROTOCOL, RE_JS_EXT, RE_JS_IDENTIFIER, RE_KEBAB_CASE, RE_PASCAL_CASE, RE_REGEXP_STR, RE_SNAKE_CASE, RE_TS_EXT, WEBSITE_URL, coerceESLintSettings, coerceSettings, decodeESLintSettings, decodeSettings, defineRuleListener, defineSettings, getConfigAdapters, getReactVersion, getSettingsFromContext, isESLintReactSettings, isESLintSettings, isRegExp, normalizeSettings, report, toRegExp };
+export { DEFAULT_ESLINT_REACT_SETTINGS, DEFAULT_ESLINT_SETTINGS, ESLintReactSettingsSchema, ESLintSettingsSchema, GITHUB_URL, IMPURE_CTORS, IMPURE_FUNCS, IdGenerator, NPM_SCOPE, RE_ANNOTATION_JSX, RE_ANNOTATION_JSX_FRAG, RE_ANNOTATION_JSX_IMPORT_SOURCE, RE_ANNOTATION_JSX_RUNTIME, RE_CAMEL_CASE, RE_COMPONENT_NAME, RE_COMPONENT_NAME_LOOSE, RE_CONSTANT_CASE, RE_HOOK_NAME, RE_HTML_TAG, RE_JAVASCRIPT_PROTOCOL, RE_JS_EXT, RE_JS_IDENTIFIER, RE_KEBAB_CASE, RE_PASCAL_CASE, RE_REGEXP_STR, RE_SNAKE_CASE, RE_TS_EXT, WEBSITE_URL, decodeESLintSettings, decodeSettings, defineRuleListener, getReactVersion, getSettingsFromContext, isESLintReactSettings, isESLintSettings, isRegExp, normalizeSettings, report, toRegExp };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint-react/shared",
-  "version": "3.0.0-next.6",
+  "version": "3.0.0-next.60",
   "description": "ESLint React's Shared constants and functions.",
   "homepage": "https://github.com/Rel1cx/eslint-react",
   "bugs": {
@@ -32,13 +32,14 @@
   "dependencies": {
     "@typescript-eslint/utils": "canary",
     "ts-pattern": "^5.9.0",
-    "zod": "^3.25.0 || ^4.0.0",
-    "@eslint-react/eff": "3.0.0-next.6"
+    "zod": "^4.3.6",
+    "@eslint-react/eff": "3.0.0-next.60"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",
+    "@types/node": "^25.3.2",
     "@types/picomatch": "^4.0.2",
-    "tsdown": "^0.20.3",
+    "tsdown": "^0.21.0-beta.2",
     "@local/configs": "0.0.0"
   },
   "peerDependencies": {
@@ -52,6 +53,6 @@
     "build": "tsdown --dts-resolve",
     "build:docs": "typedoc",
     "lint:publish": "publint",
-    "lint:ts": "tsc --noEmit"
+    "lint:ts": "tsl"
   }
 }