@eslint-react/shared 2.14.0-next.0 → 3.0.0-beta.1

package/dist/index.d.ts

@@ -104,6 +104,7 @@ interface CompatibleConfig {
   /** Shared settings. */
   settings?: SettingsConfig;
 }
+type CompilationMode = "off" | "infer" | "annotation" | "syntax" | "all";
 //#endregion
 //#region src/config-adapters.d.ts
 /**
@@ -211,6 +212,14 @@ declare const RE_COMPONENT_NAME_LOOSE: RegExp;
  * Regular expression for matching a React Hook name.
  */
 declare const RE_HOOK_NAME: RegExp;
+/**
+ * Known impure functions
+ */
+declare const IMPURE_FUNCTIONS: ReadonlyMap<string, ReadonlySet<string>>;
+/**
+ * Known impure global constructors used with `new`
+ */
+declare const IMPURE_CONSTRUCTORS: ReadonlySet<string>;
 //#endregion
 //#region src/define-rule-listener.d.ts
 /**
@@ -276,6 +285,13 @@ declare function report(context: RuleContext): (descriptor?: null | ReportDescri
  */
 declare const ESLintReactSettingsSchema: z.ZodObject<{
   importSource: z.ZodOptional<z.ZodString>;
+  compilationMode: z.ZodOptional<z.ZodEnum<{
+    off: "off";
+    infer: "infer";
+    annotation: "annotation";
+    syntax: "syntax";
+    all: "all";
+  }>>;
   polymorphicPropName: z.ZodOptional<z.ZodString>;
   version: z.ZodOptional<z.ZodString>;
   additionalStateHooks: z.ZodOptional<z.ZodString>;
@@ -299,10 +315,12 @@ type ESLintReactSettings = z.infer<typeof ESLintReactSettingsSchema>;
  * Normalized ESLint React settings with processed values
  */
 interface ESLintReactSettingsNormalized {
-  additionalStateHooks: RegExpLike;
+  version: string;
   importSource: string;
+  compilationMode: CompilationMode;
+  isCompilerEnabled: boolean;
   polymorphicPropName: string | unit;
-  version: string;
+  additionalStateHooks: RegExpLike;
 }
 /**
  * Default ESLint React settings
@@ -310,6 +328,7 @@ interface ESLintReactSettingsNormalized {
 declare const DEFAULT_ESLINT_REACT_SETTINGS: {
   readonly version: "detect";
   readonly importSource: "react";
+  readonly compilationMode: "annotation";
   readonly polymorphicPropName: "as";
 };
 /**
@@ -319,6 +338,7 @@ declare const DEFAULT_ESLINT_SETTINGS: {
   readonly "react-x": {
     readonly version: "detect";
     readonly importSource: "react";
+    readonly compilationMode: "annotation";
     readonly polymorphicPropName: "as";
   };
 };
@@ -358,12 +378,15 @@ declare const decodeSettings: (settings: unknown) => ESLintReactSettings;
  */
 declare const normalizeSettings: ({
   importSource,
+  compilationMode,
   polymorphicPropName,
   version,
   additionalStateHooks,
   ...rest
 }: ESLintReactSettings) => {
   readonly importSource: string;
+  readonly compilationMode: "off" | "infer" | "annotation" | "syntax" | "all";
+  readonly isCompilerEnabled: boolean;
   readonly polymorphicPropName: string;
   readonly version: string;
   readonly additionalStateHooks: RegExpLike;
@@ -385,4 +408,4 @@ declare module "@typescript-eslint/utils/ts-eslint" {
   }
 }
 //#endregion
-export { CompatibleConfig, CompatiblePlugin, CompatibleRule, DEFAULT_ESLINT_REACT_SETTINGS, DEFAULT_ESLINT_SETTINGS, ESLintReactSettings, ESLintReactSettingsNormalized, ESLintReactSettingsSchema, ESLintSettings, ESLintSettingsSchema, GITHUB_URL, 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 { 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 };

package/dist/index.js

@@ -138,6 +138,273 @@ const RE_COMPONENT_NAME_LOOSE = /^_?[A-Z]/u;
 * Regular expression for matching a React Hook name.
 */
 const RE_HOOK_NAME = /^use/u;
+/**
+* Known impure functions
+*/
+const IMPURE_FUNCTIONS = new Map([
+	["Atomics", new Set([
+		"add",
+		"and",
+		"compareExchange",
+		"exchange",
+		"load",
+		"notify",
+		"or",
+		"store",
+		"sub",
+		"wait",
+		"waitAsync",
+		"xor"
+	])],
+	["caches", new Set([
+		"delete",
+		"has",
+		"keys",
+		"match",
+		"open"
+	])],
+	["clipboard", new Set([
+		"read",
+		"readText",
+		"write",
+		"writeText"
+	])],
+	["console", new Set([
+		"assert",
+		"clear",
+		"count",
+		"countReset",
+		"debug",
+		"dir",
+		"dirxml",
+		"error",
+		"group",
+		"groupCollapsed",
+		"groupEnd",
+		"info",
+		"log",
+		"profile",
+		"profileEnd",
+		"table",
+		"time",
+		"timeEnd",
+		"timeLog",
+		"timeStamp",
+		"trace",
+		"warn"
+	])],
+	["cookieStore", new Set([
+		"delete",
+		"get",
+		"getAll",
+		"set"
+	])],
+	["crypto", new Set(["getRandomValues", "randomUUID"])],
+	["Date", new Set(["now"])],
+	["document", new Set([
+		"adoptNode",
+		"append",
+		"close",
+		"createAttribute",
+		"createAttributeNS",
+		"createCDATASection",
+		"createComment",
+		"createDocumentFragment",
+		"createDocumentType",
+		"createElement",
+		"createElementNS",
+		"createEvent",
+		"createNodeIterator",
+		"createProcessingInstruction",
+		"createRange",
+		"createTextNode",
+		"createTreeWalker",
+		"elementFromPoint",
+		"elementsFromPoint",
+		"execCommand",
+		"exitFullscreen",
+		"exitPictureInPicture",
+		"exitPointerLock",
+		"getAnimations",
+		"getElementById",
+		"getElementsByClassName",
+		"getElementsByName",
+		"getElementsByTagName",
+		"getElementsByTagNameNS",
+		"getSelection",
+		"hasFocus",
+		"importNode",
+		"open",
+		"prepend",
+		"querySelector",
+		"querySelectorAll",
+		"replaceChildren",
+		"requestStorageAccess",
+		"startViewTransition",
+		"write",
+		"writeln"
+	])],
+	["history", new Set([
+		"back",
+		"forward",
+		"go",
+		"pushState",
+		"replaceState"
+	])],
+	["indexedDB", new Set([
+		"databases",
+		"deleteDatabase",
+		"open"
+	])],
+	["localStorage", new Set([
+		"clear",
+		"getItem",
+		"key",
+		"removeItem",
+		"setItem"
+	])],
+	["location", new Set([
+		"assign",
+		"reload",
+		"replace"
+	])],
+	["Math", new Set(["random"])],
+	["navigation", new Set([
+		"back",
+		"forward",
+		"navigate",
+		"reload",
+		"traverseTo",
+		"updateCurrentEntry"
+	])],
+	["navigator", new Set([
+		"canShare",
+		"getBattery",
+		"getGamepads",
+		"getUserMedia",
+		"javaEnabled",
+		"registerProtocolHandler",
+		"requestMediaKeySystemAccess",
+		"requestMIDIAccess",
+		"sendBeacon",
+		"share",
+		"vibrate"
+	])],
+	["Notification", new Set(["requestPermission"])],
+	["Object", new Set([
+		"assign",
+		"defineProperties",
+		"defineProperty",
+		"freeze",
+		"preventExtensions",
+		"seal",
+		"setPrototypeOf"
+	])],
+	["performance", new Set([
+		"clearMarks",
+		"clearMeasures",
+		"getEntries",
+		"getEntriesByName",
+		"getEntriesByType",
+		"mark",
+		"measure",
+		"now"
+	])],
+	["process", new Set([
+		"abort",
+		"chdir",
+		"cpuUsage",
+		"emitWarning",
+		"exit",
+		"hrtime",
+		"kill",
+		"memoryUsage",
+		"nextTick",
+		"send",
+		"stderr",
+		"stdout"
+	])],
+	["Reflect", new Set([
+		"defineProperty",
+		"deleteProperty",
+		"preventExtensions",
+		"set",
+		"setPrototypeOf"
+	])],
+	["scheduler", new Set(["postTask", "yield"])],
+	["sessionStorage", new Set([
+		"clear",
+		"getItem",
+		"key",
+		"removeItem",
+		"setItem"
+	])],
+	["URL", new Set(["createObjectURL", "revokeObjectURL"])],
+	["window", new Set([
+		"addEventListener",
+		"alert",
+		"blur",
+		"cancelAnimationFrame",
+		"cancelIdleCallback",
+		"clearInterval",
+		"clearTimeout",
+		"close",
+		"confirm",
+		"dispatchEvent",
+		"fetch",
+		"focus",
+		"getComputedStyle",
+		"getSelection",
+		"matchMedia",
+		"moveBy",
+		"moveTo",
+		"open",
+		"postMessage",
+		"print",
+		"prompt",
+		"queueMicrotask",
+		"removeEventListener",
+		"requestAnimationFrame",
+		"requestIdleCallback",
+		"resizeBy",
+		"resizeTo",
+		"scroll",
+		"scrollBy",
+		"scrollTo",
+		"setInterval",
+		"setTimeout",
+		"stop"
+	])]
+]);
+/**
+* Known impure global constructors used with `new`
+*/
+const IMPURE_CONSTRUCTORS = new Set([
+	"AbortController",
+	"Audio",
+	"AudioContext",
+	"BroadcastChannel",
+	"Date",
+	"EventSource",
+	"FileReader",
+	"Image",
+	"IntersectionObserver",
+	"MediaRecorder",
+	"MediaSource",
+	"MediaStream",
+	"MessageChannel",
+	"MutationObserver",
+	"Notification",
+	"OfflineAudioContext",
+	"PerformanceObserver",
+	"ReportingObserver",
+	"ResizeObserver",
+	"RTCPeerConnection",
+	"SharedWorker",
+	"WebSocket",
+	"Worker",
+	"XMLHttpRequest"
+]);
 
 //#endregion
 //#region src/define-rule-listener.ts
@@ -230,6 +497,13 @@ function report(context) {
 */
 const ESLintReactSettingsSchema = z.object({
 	importSource: z.optional(z.string()),
+	compilationMode: z.optional(z.enum([
+		"off",
+		"infer",
+		"annotation",
+		"syntax",
+		"all"
+	])),
 	polymorphicPropName: z.optional(z.string()),
 	version: z.optional(z.string()),
 	additionalStateHooks: z.optional(z.string())
@@ -245,6 +519,7 @@ const ESLintSettingsSchema = z.optional(z.object({ "react-x": z.optional(z.unkno
 const DEFAULT_ESLINT_REACT_SETTINGS = {
 	version: "detect",
 	importSource: "react",
+	compilationMode: "annotation",
 	polymorphicPropName: "as"
 };
 /**
@@ -299,10 +574,12 @@ const decodeSettings = (settings) => {
 * Normalizes ESLint React settings to a consistent internal format
 * Transforms component definitions and resolves version information
 */
-const normalizeSettings = ({ importSource = "react", polymorphicPropName = "as", version, additionalStateHooks, ...rest }) => {
+const normalizeSettings = ({ importSource = "react", compilationMode = "annotation", polymorphicPropName = "as", version, additionalStateHooks, ...rest }) => {
 	return {
 		...rest,
 		importSource,
+		compilationMode,
+		isCompilerEnabled: compilationMode !== "off",
 		polymorphicPropName,
 		version: match(version).with(P.union(P.nullish, "", "detect"), () => getReactVersion("19.2.0")).otherwise(identity),
 		additionalStateHooks: toRegExp(additionalStateHooks)
@@ -325,4 +602,4 @@ function getSettingsFromContext(context) {
 const defineSettings = identity;
 
 //#endregion
-export { DEFAULT_ESLINT_REACT_SETTINGS, DEFAULT_ESLINT_SETTINGS, ESLintReactSettingsSchema, ESLintSettingsSchema, GITHUB_URL, 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_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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint-react/shared",
-  "version": "2.14.0-next.0",
+  "version": "3.0.0-beta.1",
   "description": "ESLint React's Shared constants and functions.",
   "homepage": "https://github.com/Rel1cx/eslint-react",
   "bugs": {
@@ -30,10 +30,10 @@
     "./package.json"
   ],
   "dependencies": {
-    "@typescript-eslint/utils": "^8.55.0",
+    "@typescript-eslint/utils": "^8.56.0",
     "ts-pattern": "^5.9.0",
     "zod": "^3.25.0 || ^4.0.0",
-    "@eslint-react/eff": "2.14.0-next.0"
+    "@eslint-react/eff": "3.0.0-beta.1"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",
@@ -46,7 +46,7 @@
     "typescript": ">=4.8.4 <6.0.0"
   },
   "engines": {
-    "node": ">=20.19.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "build": "tsdown --dts-resolve",