@eslint-react/shared 1.24.0-next.0 → 1.24.0-next.11

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 import { ESLintUtils } from '@typescript-eslint/utils';
+import { _ } from '@eslint-react/eff';
 
 /**
  * The NPM scope for this project.
@@ -1008,66 +1009,6 @@ declare function boolean(): BooleanSchema<undefined>;
  */
 declare function boolean<const TMessage extends ErrorMessage<BooleanIssue> | undefined>(message: TMessage): BooleanSchema<TMessage>;
 
-/**
- * Class type.
- */
-type Class = new (...args: any[]) => any;
-/**
- * Instance issue type.
- */
-interface InstanceIssue extends BaseIssue<unknown> {
-    /**
-     * The issue kind.
-     */
-    readonly kind: 'schema';
-    /**
-     * The issue type.
-     */
-    readonly type: 'instance';
-    /**
-     * The expected property.
-     */
-    readonly expected: string;
-}
-/**
- * Instance schema type.
- */
-interface InstanceSchema<TClass extends Class, TMessage extends ErrorMessage<InstanceIssue> | undefined> extends BaseSchema<InstanceType<TClass>, InstanceType<TClass>, InstanceIssue> {
-    /**
-     * The schema type.
-     */
-    readonly type: 'instance';
-    /**
-     * The schema reference.
-     */
-    readonly reference: typeof instance;
-    /**
-     * The class of the instance.
-     */
-    readonly class: TClass;
-    /**
-     * The error message.
-     */
-    readonly message: TMessage;
-}
-/**
- * Creates an instance schema.
- *
- * @param class_ The class of the instance.
- *
- * @returns An instance schema.
- */
-declare function instance<TClass extends Class>(class_: TClass): InstanceSchema<TClass, undefined>;
-/**
- * Creates an instance schema.
- *
- * @param class_ The class of the instance.
- * @param message The error message.
- *
- * @returns An instance schema.
- */
-declare function instance<TClass extends Class, const TMessage extends ErrorMessage<InstanceIssue> | undefined>(class_: TClass, message: TMessage): InstanceSchema<TClass, TMessage>;
-
 /**
  * Infer nullish output type.
  */
@@ -1396,35 +1337,28 @@ declare function readonly<TInput>(): ReadonlyAction<TInput>;
 
 /**
  * @internal
- * @description
- * This allows the rule to know some key information before checking for user-defined hooks.
- * For example, the position of the `deps` argument for the user-defined `useCustomEffect` hook that represents the built-in `useEffect` hook.
  */
-declare const CustomHookSchema: ObjectSchema<{}, undefined>;
-/**
- * @internal
- */
-declare const CustomAttributeSchema: ObjectSchema<{
+declare const CustomComponentPropSchema: ObjectSchema<{
     /**
-     * The name of the attribute in the user-defined component.
+     * The name of the prop in the user-defined component.
      * @example
      * "to"
      */
     readonly name: StringSchema<undefined>;
     /**
-     * The name of the attribute in the built-in component.
+     * The name of the prop in the built-in component.
      * @example
      * "href"
      */
     readonly as: OptionalSchema<StringSchema<undefined>, undefined>;
     /**
-     * Whether the attribute is controlled or not in the user-defined component.
+     * Whether the prop is controlled or not in the user-defined component.
      * @example
      * `true`
      */
     readonly controlled: OptionalSchema<BooleanSchema<undefined>, undefined>;
     /**
-     * The default value of the attribute in the user-defined component.
+     * The default value of the prop in the user-defined component.
      * @example
      * `"/"`
      */
@@ -1435,8 +1369,7 @@ declare const CustomAttributeSchema: ObjectSchema<{
  * @description
  * This will provide some key information to the rule before checking for user-defined components.
  * For example:
- * Which attribute is used as the `href` prop for the user-defined `Link` component that represents the built-in `a` element.
- * Which attributes are used as `children` props for a user-defined `Button` component to receive children of that component.
+ * Which prop is used as the `href` prop for the user-defined `Link` component that represents the built-in `a` element.
  */
 declare const CustomComponentSchema: ObjectSchema<{
     /**
@@ -1447,6 +1380,7 @@ declare const CustomComponentSchema: ObjectSchema<{
     readonly name: StringSchema<undefined>;
     /**
      * The ESQuery selector to select the component precisely.
+     * @internal
      * @example
      * `JSXElement:has(JSXAttribute[name.name='component'][value.value='a'])`
      */
@@ -1458,68 +1392,57 @@ declare const CustomComponentSchema: ObjectSchema<{
      */
     readonly as: OptionalSchema<StringSchema<undefined>, undefined>;
     /**
-     * Pre-defined attributes that are used in the user-defined component.
+     * Attributes mapping between the user-defined component and the built-in component.
      * @example
      * `Link` component has a `to` attribute that represents the `href` attribute in the built-in `a` element with a default value of `"/"`.
      */
     readonly attributes: OptionalSchema<ArraySchema<ObjectSchema<{
         /**
-         * The name of the attribute in the user-defined component.
+         * The name of the prop in the user-defined component.
          * @example
          * "to"
          */
         readonly name: StringSchema<undefined>;
         /**
-         * The name of the attribute in the built-in component.
+         * The name of the prop in the built-in component.
          * @example
          * "href"
          */
         readonly as: OptionalSchema<StringSchema<undefined>, undefined>;
         /**
-         * Whether the attribute is controlled or not in the user-defined component.
+         * Whether the prop is controlled or not in the user-defined component.
          * @example
          * `true`
          */
         readonly controlled: OptionalSchema<BooleanSchema<undefined>, undefined>;
         /**
-         * The default value of the attribute in the user-defined component.
+         * The default value of the prop in the user-defined component.
          * @example
          * `"/"`
          */
         readonly defaultValue: OptionalSchema<StringSchema<undefined>, undefined>;
     }, undefined>, undefined>, undefined>;
 }, undefined>;
-declare const CustomComponentNormalizedSchema: ObjectSchema<{
-    readonly name: StringSchema<undefined>;
-    readonly as: StringSchema<undefined>;
-    readonly attributes: OptionalSchema<ArraySchema<ObjectSchema<{
-        /**
-         * The name of the attribute in the user-defined component.
-         * @example
-         * "to"
-         */
-        readonly name: StringSchema<undefined>;
-        /**
-         * The name of the attribute in the built-in component.
-         * @example
-         * "href"
-         */
-        readonly as: OptionalSchema<StringSchema<undefined>, undefined>;
-        /**
-         * Whether the attribute is controlled or not in the user-defined component.
-         * @example
-         * `true`
-         */
-        readonly controlled: OptionalSchema<BooleanSchema<undefined>, undefined>;
-        /**
-         * The default value of the attribute in the user-defined component.
-         * @example
-         * `"/"`
-         */
-        readonly defaultValue: OptionalSchema<StringSchema<undefined>, undefined>;
-    }, undefined>, undefined>, readonly []>;
-    readonly re: InstanceSchema<RegExpConstructor, undefined>;
-    readonly selector: OptionalSchema<StringSchema<undefined>, undefined>;
+declare const CustomHooksSchema: ObjectSchema<{
+    readonly use: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useActionState: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useCallback: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useContext: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useDebugValue: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useDeferredValue: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useEffect: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useFormStatus: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useId: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useImperativeHandle: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useInsertionEffect: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useLayoutEffect: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useMemo: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useOptimistic: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useReducer: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useRef: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useState: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useSyncExternalStore: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
+    readonly useTransition: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, undefined>;
 }, undefined>;
 /**
  * @internal
@@ -1531,41 +1454,41 @@ declare const ESLintReactSettingsSchema: ObjectSchema<{
      * @default `"react"`
      * @example `"@pika/react"`
      */
-    readonly importSource: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly importSource: OptionalSchema<StringSchema<undefined>, "react">;
     /**
      * The identifier that’s used for JSX Element creation.
      * @default `"createElement"`
      * @deprecated
      */
-    readonly jsxPragma: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly jsxPragma: OptionalSchema<StringSchema<undefined>, "createElement">;
     /**
      * The identifier that’s used for JSX fragment elements.
      * @description This should not be a member expression (i.e. use "Fragment" instead of "React.Fragment").
      * @default `"Fragment"`
      * @deprecated
      */
-    readonly jsxPragmaFrag: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly jsxPragmaFrag: OptionalSchema<StringSchema<undefined>, "Fragment">;
     /**
      * The name of the prop that is used for polymorphic components.
      * @description This is used to determine the type of the component.
      * @example `"as"`
      */
-    readonly polymorphicPropName: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly polymorphicPropName: OptionalSchema<StringSchema<undefined>, "as">;
     /**
      * @internal
      */
-    readonly strict: OptionalSchema<BooleanSchema<undefined>, undefined>;
+    readonly strict: OptionalSchema<BooleanSchema<undefined>, false>;
     /**
      * @internal
      */
-    readonly strictImportCheck: OptionalSchema<BooleanSchema<undefined>, undefined>;
+    readonly strictImportCheck: OptionalSchema<BooleanSchema<undefined>, false>;
     /**
      * React version to use, "detect" means auto detect React version from the project’s dependencies.
      * If `importSource` is specified, an equivalent version of React should be provided here.
      * @example `"18.3.1"`
      * @default `"detect"`
      */
-    readonly version: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly version: OptionalSchema<StringSchema<undefined>, "detect">;
     /**
      * An array of user-defined components
      * @description This is used to inform the ESLint React plugins how to treat these components during checks.
@@ -1580,6 +1503,7 @@ declare const ESLintReactSettingsSchema: ObjectSchema<{
         readonly name: StringSchema<undefined>;
         /**
          * The ESQuery selector to select the component precisely.
+         * @internal
          * @example
          * `JSXElement:has(JSXAttribute[name.name='component'][value.value='a'])`
          */
@@ -1591,31 +1515,31 @@ declare const ESLintReactSettingsSchema: ObjectSchema<{
          */
         readonly as: OptionalSchema<StringSchema<undefined>, undefined>;
         /**
-         * Pre-defined attributes that are used in the user-defined component.
+         * Attributes mapping between the user-defined component and the built-in component.
          * @example
          * `Link` component has a `to` attribute that represents the `href` attribute in the built-in `a` element with a default value of `"/"`.
          */
         readonly attributes: OptionalSchema<ArraySchema<ObjectSchema<{
             /**
-             * The name of the attribute in the user-defined component.
+             * The name of the prop in the user-defined component.
              * @example
              * "to"
              */
             readonly name: StringSchema<undefined>;
             /**
-             * The name of the attribute in the built-in component.
+             * The name of the prop in the built-in component.
              * @example
              * "href"
              */
             readonly as: OptionalSchema<StringSchema<undefined>, undefined>;
             /**
-             * Whether the attribute is controlled or not in the user-defined component.
+             * Whether the prop is controlled or not in the user-defined component.
              * @example
              * `true`
              */
             readonly controlled: OptionalSchema<BooleanSchema<undefined>, undefined>;
             /**
-             * The default value of the attribute in the user-defined component.
+             * The default value of the prop in the user-defined component.
              * @example
              * `"/"`
              */
@@ -1623,7 +1547,7 @@ declare const ESLintReactSettingsSchema: ObjectSchema<{
         }, undefined>, undefined>, undefined>;
     }, undefined>, undefined>, undefined>;
     /**
-     * A object of aliases for React built-in hooks.
+     * A object to define additional hooks that are equivalent to the built-in React Hooks.
      * @description ESLint React will recognize these aliases as equivalent to the built-in hooks in all its rules.
      * @example `{ useLayoutEffect: ["useIsomorphicLayoutEffect"] }`
      */
@@ -1660,41 +1584,41 @@ declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
          * @default `"react"`
          * @example `"@pika/react"`
          */
-        readonly importSource: OptionalSchema<StringSchema<undefined>, undefined>;
+        readonly importSource: OptionalSchema<StringSchema<undefined>, "react">;
         /**
          * The identifier that’s used for JSX Element creation.
          * @default `"createElement"`
          * @deprecated
          */
-        readonly jsxPragma: OptionalSchema<StringSchema<undefined>, undefined>;
+        readonly jsxPragma: OptionalSchema<StringSchema<undefined>, "createElement">;
         /**
          * The identifier that’s used for JSX fragment elements.
          * @description This should not be a member expression (i.e. use "Fragment" instead of "React.Fragment").
          * @default `"Fragment"`
          * @deprecated
          */
-        readonly jsxPragmaFrag: OptionalSchema<StringSchema<undefined>, undefined>;
+        readonly jsxPragmaFrag: OptionalSchema<StringSchema<undefined>, "Fragment">;
         /**
          * The name of the prop that is used for polymorphic components.
          * @description This is used to determine the type of the component.
          * @example `"as"`
          */
-        readonly polymorphicPropName: OptionalSchema<StringSchema<undefined>, undefined>;
+        readonly polymorphicPropName: OptionalSchema<StringSchema<undefined>, "as">;
         /**
          * @internal
          */
-        readonly strict: OptionalSchema<BooleanSchema<undefined>, undefined>;
+        readonly strict: OptionalSchema<BooleanSchema<undefined>, false>;
         /**
          * @internal
          */
-        readonly strictImportCheck: OptionalSchema<BooleanSchema<undefined>, undefined>;
+        readonly strictImportCheck: OptionalSchema<BooleanSchema<undefined>, false>;
         /**
          * React version to use, "detect" means auto detect React version from the project’s dependencies.
          * If `importSource` is specified, an equivalent version of React should be provided here.
          * @example `"18.3.1"`
          * @default `"detect"`
          */
-        readonly version: OptionalSchema<StringSchema<undefined>, undefined>;
+        readonly version: OptionalSchema<StringSchema<undefined>, "detect">;
         /**
          * An array of user-defined components
          * @description This is used to inform the ESLint React plugins how to treat these components during checks.
@@ -1709,6 +1633,7 @@ declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
             readonly name: StringSchema<undefined>;
             /**
              * The ESQuery selector to select the component precisely.
+             * @internal
              * @example
              * `JSXElement:has(JSXAttribute[name.name='component'][value.value='a'])`
              */
@@ -1720,31 +1645,31 @@ declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
              */
             readonly as: OptionalSchema<StringSchema<undefined>, undefined>;
             /**
-             * Pre-defined attributes that are used in the user-defined component.
+             * Attributes mapping between the user-defined component and the built-in component.
              * @example
              * `Link` component has a `to` attribute that represents the `href` attribute in the built-in `a` element with a default value of `"/"`.
              */
             readonly attributes: OptionalSchema<ArraySchema<ObjectSchema<{
                 /**
-                 * The name of the attribute in the user-defined component.
+                 * The name of the prop in the user-defined component.
                  * @example
                  * "to"
                  */
                 readonly name: StringSchema<undefined>;
                 /**
-                 * The name of the attribute in the built-in component.
+                 * The name of the prop in the built-in component.
                  * @example
                  * "href"
                  */
                 readonly as: OptionalSchema<StringSchema<undefined>, undefined>;
                 /**
-                 * Whether the attribute is controlled or not in the user-defined component.
+                 * Whether the prop is controlled or not in the user-defined component.
                  * @example
                  * `true`
                  */
                 readonly controlled: OptionalSchema<BooleanSchema<undefined>, undefined>;
                 /**
-                 * The default value of the attribute in the user-defined component.
+                 * The default value of the prop in the user-defined component.
                  * @example
                  * `"/"`
                  */
@@ -1752,7 +1677,7 @@ declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
             }, undefined>, undefined>, undefined>;
         }, undefined>, undefined>, undefined>;
         /**
-         * A object of aliases for React built-in hooks.
+         * A object to define additional hooks that are equivalent to the built-in React Hooks.
          * @description ESLint React will recognize these aliases as equivalent to the built-in hooks in all its rules.
          * @example `{ useLayoutEffect: ["useIsomorphicLayoutEffect"] }`
          */
@@ -1786,41 +1711,41 @@ declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
          * @default `"react"`
          * @example `"@pika/react"`
          */
-        readonly importSource: OptionalSchema<StringSchema<undefined>, undefined>;
+        readonly importSource: OptionalSchema<StringSchema<undefined>, "react">;
         /**
          * The identifier that’s used for JSX Element creation.
          * @default `"createElement"`
          * @deprecated
          */
-        readonly jsxPragma: OptionalSchema<StringSchema<undefined>, undefined>;
+        readonly jsxPragma: OptionalSchema<StringSchema<undefined>, "createElement">;
         /**
          * The identifier that’s used for JSX fragment elements.
          * @description This should not be a member expression (i.e. use "Fragment" instead of "React.Fragment").
          * @default `"Fragment"`
          * @deprecated
          */
-        readonly jsxPragmaFrag: OptionalSchema<StringSchema<undefined>, undefined>;
+        readonly jsxPragmaFrag: OptionalSchema<StringSchema<undefined>, "Fragment">;
         /**
          * The name of the prop that is used for polymorphic components.
          * @description This is used to determine the type of the component.
          * @example `"as"`
          */
-        readonly polymorphicPropName: OptionalSchema<StringSchema<undefined>, undefined>;
+        readonly polymorphicPropName: OptionalSchema<StringSchema<undefined>, "as">;
         /**
          * @internal
          */
-        readonly strict: OptionalSchema<BooleanSchema<undefined>, undefined>;
+        readonly strict: OptionalSchema<BooleanSchema<undefined>, false>;
         /**
          * @internal
          */
-        readonly strictImportCheck: OptionalSchema<BooleanSchema<undefined>, undefined>;
+        readonly strictImportCheck: OptionalSchema<BooleanSchema<undefined>, false>;
         /**
          * React version to use, "detect" means auto detect React version from the project’s dependencies.
          * If `importSource` is specified, an equivalent version of React should be provided here.
          * @example `"18.3.1"`
          * @default `"detect"`
          */
-        readonly version: OptionalSchema<StringSchema<undefined>, undefined>;
+        readonly version: OptionalSchema<StringSchema<undefined>, "detect">;
         /**
          * An array of user-defined components
          * @description This is used to inform the ESLint React plugins how to treat these components during checks.
@@ -1835,6 +1760,7 @@ declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
             readonly name: StringSchema<undefined>;
             /**
              * The ESQuery selector to select the component precisely.
+             * @internal
              * @example
              * `JSXElement:has(JSXAttribute[name.name='component'][value.value='a'])`
              */
@@ -1846,31 +1772,31 @@ declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
              */
             readonly as: OptionalSchema<StringSchema<undefined>, undefined>;
             /**
-             * Pre-defined attributes that are used in the user-defined component.
+             * Attributes mapping between the user-defined component and the built-in component.
              * @example
              * `Link` component has a `to` attribute that represents the `href` attribute in the built-in `a` element with a default value of `"/"`.
              */
             readonly attributes: OptionalSchema<ArraySchema<ObjectSchema<{
                 /**
-                 * The name of the attribute in the user-defined component.
+                 * The name of the prop in the user-defined component.
                  * @example
                  * "to"
                  */
                 readonly name: StringSchema<undefined>;
                 /**
-                 * The name of the attribute in the built-in component.
+                 * The name of the prop in the built-in component.
                  * @example
                  * "href"
                  */
                 readonly as: OptionalSchema<StringSchema<undefined>, undefined>;
                 /**
-                 * Whether the attribute is controlled or not in the user-defined component.
+                 * Whether the prop is controlled or not in the user-defined component.
                  * @example
                  * `true`
                  */
                 readonly controlled: OptionalSchema<BooleanSchema<undefined>, undefined>;
                 /**
-                 * The default value of the attribute in the user-defined component.
+                 * The default value of the prop in the user-defined component.
                  * @example
                  * `"/"`
                  */
@@ -1878,7 +1804,7 @@ declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
             }, undefined>, undefined>, undefined>;
         }, undefined>, undefined>, undefined>;
         /**
-         * A object of aliases for React built-in hooks.
+         * A object to define additional hooks that are equivalent to the built-in React Hooks.
          * @description ESLint React will recognize these aliases as equivalent to the built-in hooks in all its rules.
          * @example `{ useLayoutEffect: ["useIsomorphicLayoutEffect"] }`
          */
@@ -1905,20 +1831,37 @@ declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
         }, undefined>, undefined>;
     }, undefined>, undefined>;
 }, undefined>, {}>;
-type CustomHook = InferOutput<typeof CustomHookSchema>;
-type CustomAttribute = InferOutput<typeof CustomAttributeSchema>;
 type CustomComponent = InferOutput<typeof CustomComponentSchema>;
-type CustomComponentNormalized = InferOutput<typeof CustomComponentNormalizedSchema>;
+type CustomComponentProp = InferOutput<typeof CustomComponentPropSchema>;
+type CustomHooks = InferOutput<typeof CustomHooksSchema>;
 type ESLintReactSettings = InferOutput<typeof ESLintReactSettingsSchema>;
 type ESLintSettings = InferOutput<typeof ESLintSettingsSchema>;
 /**
- * This is an expanded version of `ESLintReactSettings` with all shorthand properties expanded.
- * @internal
+ * The default ESLint settings for "react-x".
  */
-interface ESLintReactSettingsNormalized extends ESLintReactSettings {
-    additionalComponents: CustomComponentNormalized[];
-    version: string;
-}
+declare const DEFAULT_ESLINT_REACT_SETTINGS: {
+    readonly additionalHooks: {
+        readonly useLayoutEffect: ["useIsomorphicLayoutEffect"];
+    };
+    readonly version: string;
+    readonly importSource: string;
+    readonly jsxPragma: string;
+    readonly jsxPragmaFrag: string;
+    readonly polymorphicPropName: string;
+    readonly strict: boolean;
+    readonly strictImportCheck: boolean;
+    readonly additionalComponents?: {
+        name: string;
+        as?: string;
+        selector?: string;
+        attributes?: {
+            name: string;
+            as?: string;
+            controlled?: boolean;
+            defaultValue?: string;
+        }[];
+    }[];
+};
 
 interface Dictionary<Type> {
   [key: string]: Type;
@@ -2186,17 +2129,29 @@ type PartialObjectDeep<ObjectType extends object, Options extends PartialDeepOpt
 	[KeyType in keyof ObjectType]?: PartialDeep<ObjectType[KeyType], Options>
 };
 
+interface CustomComponentNormalized {
+    name: string;
+    as: string;
+    attributes: CustomComponentPropNormalized[];
+    re: RegExp;
+}
+interface CustomComponentPropNormalized {
+    name: string;
+    as: string;
+    defaultValue?: string | _;
+}
 /**
- * The default ESLint settings for "react-x".
+ * The normalized version of the `ESLintReactSettings`.
+ * @internal
  */
-declare const DEFAULT_ESLINT_REACT_SETTINGS: {
-    readonly additionalHooks: {
-        readonly useLayoutEffect: ["useIsomorphicLayoutEffect"];
-    };
-    readonly polymorphicPropName: "as";
-    readonly strictImportCheck: false;
-    readonly version: "detect";
-};
+interface ESLintReactSettingsNormalized {
+    additionalComponents: CustomComponentNormalized[];
+    additionalHooks: CustomHooks;
+    importSource?: string;
+    polymorphicPropName?: string | _;
+    strictImportCheck: boolean;
+    version: string;
+}
 /**
  * Unsafely casts settings from a data object from `context.settings`.
  * @internal
@@ -2212,12 +2167,12 @@ declare function unsafeDecodeSettings(data: unknown): PartialDeep<ESLintReactSet
  */
 declare const decodeSettings: Memoized<(data: unknown) => ESLintReactSettings>;
 /**
- * Normalizes the settings by converting all shorthand properties to their full form.
+ * The memoized version of `ESLintReactSettings`.
  * @param settings The settings.
  * @returns The normalized settings.
  * @internal
  */
-declare const normalizeSettings: Memoized<(settings: ESLintReactSettings) => ESLintReactSettingsNormalized>;
+declare const toNormalizedSettings: Memoized<({ additionalComponents, additionalHooks, version, ...rest }: ESLintReactSettings) => ESLintReactSettingsNormalized>;
 declare function getSettingsFromContext(context: {
     settings: unknown;
 }): ESLintReactSettingsNormalized;
@@ -2233,4 +2188,47 @@ declare module "@typescript-eslint/utils/ts-eslint" {
     }
 }
 
-export { type CustomAttribute, CustomAttributeSchema, type CustomComponent, type CustomComponentNormalized, CustomComponentNormalizedSchema, CustomComponentSchema, type CustomHook, CustomHookSchema, DEFAULT_ESLINT_REACT_SETTINGS, DOM_HTML_COMPONENT_TYPES, DOM_SVG_COMPONENT_TYPES, type ESLintReactSettings, type ESLintReactSettingsNormalized, ESLintReactSettingsSchema, type ESLintSettings, ESLintSettingsSchema, GITHUB_URL, NPM_SCOPE, REACT_BUILD_IN_HOOKS, RE_CAMEL_CASE, RE_CONSTANT_CASE, RE_JAVASCRIPT_PROTOCOL, RE_KEBAB_CASE, RE_PASCAL_CASE, RE_SNAKE_CASE, WEBSITE_URL, createRuleForPlugin, decodeSettings, defineSettings, getReactVersion, getSettingsFromContext, normalizeSettings, unsafeDecodeSettings };
+/**
+ * Rule severity.
+ * @since 0.0.1
+ */
+type RuleSeverity = "error" | "off" | "warn";
+/**
+ * Rule declaration.
+ * @internal
+ * @since 0.0.1
+ */
+type RuleDeclaration = [RuleSeverity, Record<string, unknown>?] | RuleSeverity;
+/**
+ * Rule config preset.
+ * @since 0.0.1
+ */
+type RulePreset = Record<string, RuleDeclaration>;
+/**
+ * Rule creator function.
+ * @since 0.0.1
+ * @internal
+ */
+type RuleCreator = Parameters<ReturnType<typeof ESLintUtils.RuleCreator>>[0]["create"];
+/**
+ * Rule context.
+ * @since 0.0.1
+ */
+type RuleContext = Parameters<RuleCreator>[0];
+/**
+ * Rule options.
+ * @since 0.0.1
+ */
+type RuleOptions = Parameters<RuleCreator>[1];
+/**
+ * Rule namespace.
+ * @since 0.0.1
+ */
+type RuleNamespace = "x" | "dom" | "web-api" | "hooks-extra" | "naming-convention" | "debug";
+/**
+ * Rule feature.
+ * @since 1.20.0
+ */
+type RuleFeature = "CFG" | "CHK" | "DBG" | "FIX" | "MOD" | "TSC";
+
+export { type CustomComponent, type CustomComponentNormalized, type CustomComponentProp, type CustomComponentPropNormalized, CustomComponentPropSchema, CustomComponentSchema, type CustomHooks, CustomHooksSchema, DEFAULT_ESLINT_REACT_SETTINGS, DOM_HTML_COMPONENT_TYPES, DOM_SVG_COMPONENT_TYPES, type ESLintReactSettings, type ESLintReactSettingsNormalized, ESLintReactSettingsSchema, type ESLintSettings, ESLintSettingsSchema, GITHUB_URL, NPM_SCOPE, REACT_BUILD_IN_HOOKS, RE_CAMEL_CASE, RE_CONSTANT_CASE, RE_JAVASCRIPT_PROTOCOL, RE_KEBAB_CASE, RE_PASCAL_CASE, RE_SNAKE_CASE, type RuleContext, type RuleDeclaration, type RuleFeature, type RuleNamespace, type RuleOptions, type RulePreset, type RuleSeverity, WEBSITE_URL, createRuleForPlugin, decodeSettings, defineSettings, getReactVersion, getSettingsFromContext, toNormalizedSettings, unsafeDecodeSettings };