@eslint-react/shared 1.24.0-next.1 → 1.24.0-next.12

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.
@@ -69,7 +70,7 @@ type SchemaWithPipe<TPipe extends [
      *
      * @internal
      */
-    readonly '~standard': StandardSchemaProps<InferInput<FirstTupleItem<TPipe>>, InferOutput<LastTupleItem<TPipe>>>;
+    readonly '~standard': StandardProps<InferInput<FirstTupleItem<TPipe>>, InferOutput<LastTupleItem<TPipe>>>;
     /**
      * Parses unknown input values.
      *
@@ -113,7 +114,7 @@ type SchemaWithPipeAsync<TPipe extends [
      *
      * @internal
      */
-    readonly '~standard': StandardSchemaProps<InferInput<FirstTupleItem<TPipe>>, InferOutput<LastTupleItem<TPipe>>>;
+    readonly '~standard': StandardProps<InferInput<FirstTupleItem<TPipe>>, InferOutput<LastTupleItem<TPipe>>>;
     /**
      * Parses unknown input values.
      *
@@ -138,7 +139,7 @@ type SchemaWithPipeAsync<TPipe extends [
 };
 
 /**
- * Base metadata type.
+ * Base metadata interface.
  */
 interface BaseMetadata<TInput> {
     /**
@@ -166,7 +167,7 @@ interface BaseMetadata<TInput> {
 }
 
 /**
- * Unknown dataset type.
+ * Unknown dataset interface.
  */
 interface UnknownDataset {
     /**
@@ -183,7 +184,7 @@ interface UnknownDataset {
     issues?: undefined;
 }
 /**
- * Success dataset type.
+ * Success dataset interface.
  */
 interface SuccessDataset<TValue> {
     /**
@@ -200,7 +201,7 @@ interface SuccessDataset<TValue> {
     issues?: undefined;
 }
 /**
- * Partial dataset type.
+ * Partial dataset interface.
  */
 interface PartialDataset<TValue, TIssue extends BaseIssue<unknown>> {
     /**
@@ -217,7 +218,7 @@ interface PartialDataset<TValue, TIssue extends BaseIssue<unknown>> {
     issues: [TIssue, ...TIssue[]];
 }
 /**
- * Failure dataset type.
+ * Failure dataset interface.
  */
 interface FailureDataset<TIssue extends BaseIssue<unknown>> {
     /**
@@ -241,7 +242,7 @@ type OutputDataset<TValue, TIssue extends BaseIssue<unknown>> = SuccessDataset<T
 /**
  * The Standard Schema properties interface.
  */
-interface StandardSchemaProps<Input, Output> {
+interface StandardProps<TInput, TOutput> {
     /**
      * The version number of the standard.
      */
@@ -253,24 +254,24 @@ interface StandardSchemaProps<Input, Output> {
     /**
      * Validates unknown input values.
      */
-    readonly validate: (value: unknown) => StandardResult<Output> | Promise<StandardResult<Output>>;
+    readonly validate: (value: unknown) => StandardResult<TOutput> | Promise<StandardResult<TOutput>>;
     /**
      * Inferred types associated with the schema.
      */
-    readonly types?: StandardTypes<Input, Output> | undefined;
+    readonly types?: StandardTypes<TInput, TOutput> | undefined;
 }
 /**
  * The result interface of the validate function.
  */
-type StandardResult<Output> = StandardSuccessResult<Output> | StandardFailureResult;
+type StandardResult<TOutput> = StandardSuccessResult<TOutput> | StandardFailureResult;
 /**
  * The result interface if validation succeeds.
  */
-interface StandardSuccessResult<Output> {
+interface StandardSuccessResult<TOutput> {
     /**
      * The typed output value.
      */
-    readonly value: Output;
+    readonly value: TOutput;
     /**
      * The non-existent issues.
      */
@@ -296,33 +297,33 @@ interface StandardIssue {
     /**
      * The path of the issue, if any.
      */
-    readonly path?: readonly (PropertyKey | StandardPathSegment)[] | undefined;
+    readonly path?: readonly (PropertyKey | StandardPathItem)[] | undefined;
 }
 /**
- * The path segment interface of the issue.
+ * The path item interface of the issue.
  */
-interface StandardPathSegment {
+interface StandardPathItem {
     /**
-     * The key representing a path segment.
+     * The key of the path item.
      */
     readonly key: PropertyKey;
 }
 /**
- * The base types interface of Standard Schema.
+ * The Standard Schema types interface.
  */
-interface StandardTypes<Input, Output> {
+interface StandardTypes<TInput, TOutput> {
     /**
      * The input type of the schema.
      */
-    readonly input: Input;
+    readonly input: TInput;
     /**
      * The output type of the schema.
      */
-    readonly output: Output;
+    readonly output: TOutput;
 }
 
 /**
- * Base schema type.
+ * Base schema interface.
  */
 interface BaseSchema<TInput, TOutput, TIssue extends BaseIssue<unknown>> {
     /**
@@ -350,7 +351,7 @@ interface BaseSchema<TInput, TOutput, TIssue extends BaseIssue<unknown>> {
      *
      * @internal
      */
-    readonly '~standard': StandardSchemaProps<TInput, TOutput>;
+    readonly '~standard': StandardProps<TInput, TOutput>;
     /**
      * Parses unknown input values.
      *
@@ -374,7 +375,7 @@ interface BaseSchema<TInput, TOutput, TIssue extends BaseIssue<unknown>> {
     } | undefined;
 }
 /**
- * Base schema async type.
+ * Base schema async interface.
  */
 interface BaseSchemaAsync<TInput, TOutput, TIssue extends BaseIssue<unknown>> extends Omit<BaseSchema<TInput, TOutput, TIssue>, 'reference' | 'async' | '~run'> {
     /**
@@ -399,7 +400,7 @@ interface BaseSchemaAsync<TInput, TOutput, TIssue extends BaseIssue<unknown>> ex
 }
 
 /**
- * Base transformation type.
+ * Base transformation interface.
  */
 interface BaseTransformation<TInput, TOutput, TIssue extends BaseIssue<unknown>> {
     /**
@@ -441,7 +442,7 @@ interface BaseTransformation<TInput, TOutput, TIssue extends BaseIssue<unknown>>
     } | undefined;
 }
 /**
- * Base transformation async type.
+ * Base transformation async interface.
  */
 interface BaseTransformationAsync<TInput, TOutput, TIssue extends BaseIssue<unknown>> extends Omit<BaseTransformation<TInput, TOutput, TIssue>, 'reference' | 'async' | '~run'> {
     /**
@@ -466,7 +467,7 @@ interface BaseTransformationAsync<TInput, TOutput, TIssue extends BaseIssue<unkn
 }
 
 /**
- * Base validation type.
+ * Base validation interface.
  */
 interface BaseValidation<TInput, TOutput, TIssue extends BaseIssue<unknown>> {
     /**
@@ -512,7 +513,7 @@ interface BaseValidation<TInput, TOutput, TIssue extends BaseIssue<unknown>> {
     } | undefined;
 }
 /**
- * Base validation async type.
+ * Base validation async interface.
  */
 interface BaseValidationAsync<TInput, TOutput, TIssue extends BaseIssue<unknown>> extends Omit<BaseValidation<TInput, TOutput, TIssue>, 'reference' | 'async' | '~run'> {
     /**
@@ -619,13 +620,13 @@ type SchemaWithoutPipe<TSchema extends BaseSchema<unknown, unknown, BaseIssue<un
 };
 
 /**
- * Object entries type.
+ * Object entries interface.
  */
 interface ObjectEntries {
     [key: string]: BaseSchema<unknown, unknown, BaseIssue<unknown>>;
 }
 /**
- * Object entries async type.
+ * Object entries async interface.
  */
 interface ObjectEntriesAsync {
     [key: string]: BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>;
@@ -702,7 +703,7 @@ type InferObjectOutput<TEntries extends ObjectEntries | ObjectEntriesAsync> = Pr
 type InferObjectIssue<TEntries extends ObjectEntries | ObjectEntriesAsync> = InferIssue<TEntries[keyof TEntries]>;
 
 /**
- * Array path item type.
+ * Array path item interface.
  */
 interface ArrayPathItem {
     /**
@@ -727,7 +728,7 @@ interface ArrayPathItem {
     readonly value: unknown;
 }
 /**
- * Map path item type.
+ * Map path item interface.
  */
 interface MapPathItem {
     /**
@@ -752,7 +753,7 @@ interface MapPathItem {
     readonly value: unknown;
 }
 /**
- * Object path item type.
+ * Object path item interface.
  */
 interface ObjectPathItem {
     /**
@@ -777,7 +778,7 @@ interface ObjectPathItem {
     readonly value: unknown;
 }
 /**
- * Set path item type.
+ * Set path item interface.
  */
 interface SetPathItem {
     /**
@@ -802,7 +803,7 @@ interface SetPathItem {
     readonly value: unknown;
 }
 /**
- * Unknown path item type.
+ * Unknown path item interface.
  */
 interface UnknownPathItem {
     /**
@@ -831,7 +832,7 @@ interface UnknownPathItem {
  */
 type IssuePathItem = ArrayPathItem | MapPathItem | ObjectPathItem | SetPathItem | UnknownPathItem;
 /**
- * Base issue type.
+ * Base issue interface.
  */
 interface BaseIssue<TInput> extends Config<BaseIssue<TInput>> {
     /**
@@ -873,7 +874,7 @@ interface BaseIssue<TInput> extends Config<BaseIssue<TInput>> {
 }
 
 /**
- * Config type.
+ * Config interface.
  */
 interface Config<TIssue extends BaseIssue<unknown>> {
     /**
@@ -895,7 +896,7 @@ interface Config<TIssue extends BaseIssue<unknown>> {
 }
 
 /**
- * Array issue type.
+ * Array issue interface.
  */
 interface ArrayIssue extends BaseIssue<unknown> {
     /**
@@ -913,7 +914,7 @@ interface ArrayIssue extends BaseIssue<unknown> {
 }
 
 /**
- * Array schema type.
+ * Array schema interface.
  */
 interface ArraySchema<TItem extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, TMessage extends ErrorMessage<ArrayIssue> | undefined> extends BaseSchema<InferInput<TItem>[], InferOutput<TItem>[], ArrayIssue | InferIssue<TItem>> {
     /**
@@ -956,7 +957,7 @@ declare function array<const TItem extends BaseSchema<unknown, unknown, BaseIssu
 declare function array<const TItem extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, const TMessage extends ErrorMessage<ArrayIssue> | undefined>(item: TItem, message: TMessage): ArraySchema<TItem, TMessage>;
 
 /**
- * Boolean issue type.
+ * Boolean issue interface.
  */
 interface BooleanIssue extends BaseIssue<unknown> {
     /**
@@ -973,7 +974,7 @@ interface BooleanIssue extends BaseIssue<unknown> {
     readonly expected: 'boolean';
 }
 /**
- * Boolean schema type.
+ * Boolean schema interface.
  */
 interface BooleanSchema<TMessage extends ErrorMessage<BooleanIssue> | undefined> extends BaseSchema<boolean, boolean, BooleanIssue> {
     /**
@@ -1008,73 +1009,13 @@ 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.
  */
 type InferNullishOutput<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, TDefault extends DefaultAsync<TWrapped, null | undefined>> = undefined extends TDefault ? InferOutput<TWrapped> | null | undefined : InferOutput<TWrapped> | Extract<DefaultValue<TDefault>, null | undefined>;
 
 /**
- * Nullish schema type.
+ * Nullish schema interface.
  */
 interface NullishSchema<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, TDefault extends Default<TWrapped, null | undefined>> extends BaseSchema<InferInput<TWrapped> | null | undefined, InferNullishOutput<TWrapped, TDefault>, InferIssue<TWrapped>> {
     /**
@@ -1117,7 +1058,7 @@ declare function nullish<const TWrapped extends BaseSchema<unknown, unknown, Bas
 declare function nullish<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, const TDefault extends Default<TWrapped, null | undefined>>(wrapped: TWrapped, default_: TDefault): NullishSchema<TWrapped, TDefault>;
 
 /**
- * Nullish schema async type.
+ * Nullish schema async interface.
  */
 interface NullishSchemaAsync<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, TDefault extends DefaultAsync<TWrapped, null | undefined>> extends BaseSchemaAsync<InferInput<TWrapped> | null | undefined, InferNullishOutput<TWrapped, TDefault>, InferIssue<TWrapped>> {
     /**
@@ -1160,7 +1101,7 @@ declare function nullishAsync<const TWrapped extends BaseSchema<unknown, unknown
 declare function nullishAsync<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, const TDefault extends DefaultAsync<TWrapped, null | undefined>>(wrapped: TWrapped, default_: TDefault): NullishSchemaAsync<TWrapped, TDefault>;
 
 /**
- * Object issue type.
+ * Object issue interface.
  */
 interface ObjectIssue extends BaseIssue<unknown> {
     /**
@@ -1178,7 +1119,7 @@ interface ObjectIssue extends BaseIssue<unknown> {
 }
 
 /**
- * Object schema type.
+ * Object schema interface.
  */
 interface ObjectSchema<TEntries extends ObjectEntries, TMessage extends ErrorMessage<ObjectIssue> | undefined> extends BaseSchema<InferObjectInput<TEntries>, InferObjectOutput<TEntries>, ObjectIssue | InferObjectIssue<TEntries>> {
     /**
@@ -1236,7 +1177,7 @@ declare function object<const TEntries extends ObjectEntries, const TMessage ext
 type InferOptionalOutput<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, TDefault extends DefaultAsync<TWrapped, undefined>> = undefined extends TDefault ? InferOutput<TWrapped> | undefined : InferOutput<TWrapped> | Extract<DefaultValue<TDefault>, undefined>;
 
 /**
- * Optional schema type.
+ * Optional schema interface.
  */
 interface OptionalSchema<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, TDefault extends Default<TWrapped, undefined>> extends BaseSchema<InferInput<TWrapped> | undefined, InferOptionalOutput<TWrapped, TDefault>, InferIssue<TWrapped>> {
     /**
@@ -1279,7 +1220,7 @@ declare function optional<const TWrapped extends BaseSchema<unknown, unknown, Ba
 declare function optional<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, const TDefault extends Default<TWrapped, undefined>>(wrapped: TWrapped, default_: TDefault): OptionalSchema<TWrapped, TDefault>;
 
 /**
- * Optional schema async type.
+ * Optional schema async interface.
  */
 interface OptionalSchemaAsync<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, TDefault extends DefaultAsync<TWrapped, undefined>> extends BaseSchemaAsync<InferInput<TWrapped> | undefined, InferOptionalOutput<TWrapped, TDefault>, InferIssue<TWrapped>> {
     /**
@@ -1322,7 +1263,7 @@ declare function optionalAsync<const TWrapped extends BaseSchema<unknown, unknow
 declare function optionalAsync<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, const TDefault extends DefaultAsync<TWrapped, undefined>>(wrapped: TWrapped, default_: TDefault): OptionalSchemaAsync<TWrapped, TDefault>;
 
 /**
- * String issue type.
+ * String issue interface.
  */
 interface StringIssue extends BaseIssue<unknown> {
     /**
@@ -1339,7 +1280,7 @@ interface StringIssue extends BaseIssue<unknown> {
     readonly expected: 'string';
 }
 /**
- * String schema type.
+ * String schema interface.
  */
 interface StringSchema<TMessage extends ErrorMessage<StringIssue> | undefined> extends BaseSchema<string, string, StringIssue> {
     /**
@@ -1375,7 +1316,7 @@ declare function string(): StringSchema<undefined>;
 declare function string<const TMessage extends ErrorMessage<StringIssue> | undefined>(message: TMessage): StringSchema<TMessage>;
 
 /**
- * Readonly action type.
+ * Readonly action interface.
  */
 interface ReadonlyAction<TInput> extends BaseTransformation<TInput, Readonly<TInput>, never> {
     /**
@@ -1394,37 +1335,30 @@ interface ReadonlyAction<TInput> extends BaseTransformation<TInput, Readonly<TIn
  */
 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 };