@eslint-react/shared 1.8.2 → 1.8.3-beta.2

package/dist/index.d.mts

@@ -56,9 +56,11 @@ declare const HOST_HTML_COMPONENT_TYPES: readonly ["aside", "audio", "b", "base"
  * @internal
  */
 declare const HOST_SVG_COMPONENT_TYPES: readonly ["a", "animate", "animateMotion", "animateTransform", "circle", "clipPath", "defs", "desc", "discard", "ellipse", "feBlend", "feColorMatrix", "feComponentTransfer", "feComposite", "feConvolveMatrix", "feDiffuseLighting", "feDisplacementMap", "feDistantLight", "feDropShadow", "feFlood", "feFuncA", "feFuncB", "feFuncG", "feFuncR", "feGaussianBlur", "feImage", "feMerge", "feMergeNode", "feMorphology", "feOffset", "fePointLight", "feSpecularLighting", "feSpotLight", "feTile", "feTurbulence", "filter", "foreignObject", "g", "hatch", "hatchpath", "image", "line", "linearGradient", "marker", "mask", "metadata", "mpath", "path", "pattern", "polygon", "polyline", "radialGradient", "rect", "script", "set", "stop", "style", "svg", "switch", "symbol", "text", "textPath", "title", "tspan", "use", "view"];
+declare const REACT_BUILD_IN_HOOKS: readonly ["useActionState", "useCallback", "useContext", "useDebugValue", "useDeferredValue", "useEffect", "useId", "useImperativeHandle", "useInsertionEffect", "useLayoutEffect", "useMemo", "useOptimistic", "useReducer", "useRef", "useState", "useSyncExternalStore", "useTransition"];
 
 /**
  * Get the ESLint rule creator for a plugin.
+ * @internal
  * @param pluginName The name of the plugin.
  * @returns The ESLint rule creator.
  */
@@ -1582,12 +1584,46 @@ declare const CustomComponentSchema: ObjectSchema<{
  * @internal
  */
 declare const ESLintReactSettingsSchema: ObjectSchema<{
+    /**
+     * The source where React is imported from.
+     * @description This allows to specify a custom import location for React when not using the official distribution.
+     * @default `"react"`
+     * @example `"@pika/react"`
+     */
     readonly importSource: OptionalSchema<StringSchema<undefined>, never>;
+    /**
+     * The identifier that’s used for JSX Element creation.
+     * @default `"createElement"`
+     */
     readonly jsxPragma: OptionalSchema<StringSchema<undefined>, never>;
+    /**
+     * 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"`
+     */
     readonly jsxPragmaFrag: OptionalSchema<StringSchema<undefined>, never>;
+    /**
+     * 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>, never>;
+    /**
+     * @internal
+     */
     readonly strict: OptionalSchema<BooleanSchema<undefined>, never>;
+    /**
+     * 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>, never>;
+    /**
+     * An array of user-defined components
+     * @description This is used to inform the ESLint React plugins how to treat these components during checks.
+     * @example `[{ name: "Link", as: "a", attributes: [{ name: "to", as: "href" }, { name: "rel", defaultValue: "noopener noreferrer" }] }]`
+     */
     readonly additionalComponents: OptionalSchema<ArraySchema<ObjectSchema<{
         /**
          * The name of the user-defined component.
@@ -1639,6 +1675,11 @@ declare const ESLintReactSettingsSchema: ObjectSchema<{
             readonly defaultValue: OptionalSchema<StringSchema<undefined>, never>;
         }, undefined>, undefined>, readonly []>;
     }, undefined>, undefined>, never>;
+    /**
+     * A object of aliases for React built-in hooks.
+     * @description ESLint React will recognize these aliases as equivalent to the built-in hooks in all its rules.
+     * @example `{ useLayoutEffect: ["useIsomorphicLayoutEffect"] }`
+     */
     readonly additionalHooks: OptionalSchema<ObjectSchema<{
         readonly use: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, never>;
         readonly useActionState: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, never>;
@@ -1665,12 +1706,46 @@ declare const ESLintReactSettingsSchema: ObjectSchema<{
  */
 declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
     readonly "react-x": OptionalSchema<ObjectSchema<{
+        /**
+         * The source where React is imported from.
+         * @description This allows to specify a custom import location for React when not using the official distribution.
+         * @default `"react"`
+         * @example `"@pika/react"`
+         */
         readonly importSource: OptionalSchema<StringSchema<undefined>, never>;
+        /**
+         * The identifier that’s used for JSX Element creation.
+         * @default `"createElement"`
+         */
         readonly jsxPragma: OptionalSchema<StringSchema<undefined>, never>;
+        /**
+         * 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"`
+         */
         readonly jsxPragmaFrag: OptionalSchema<StringSchema<undefined>, never>;
+        /**
+         * 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>, never>;
+        /**
+         * @internal
+         */
         readonly strict: OptionalSchema<BooleanSchema<undefined>, never>;
+        /**
+         * 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>, never>;
+        /**
+         * An array of user-defined components
+         * @description This is used to inform the ESLint React plugins how to treat these components during checks.
+         * @example `[{ name: "Link", as: "a", attributes: [{ name: "to", as: "href" }, { name: "rel", defaultValue: "noopener noreferrer" }] }]`
+         */
         readonly additionalComponents: OptionalSchema<ArraySchema<ObjectSchema<{
             /**
              * The name of the user-defined component.
@@ -1722,6 +1797,11 @@ declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
                 readonly defaultValue: OptionalSchema<StringSchema<undefined>, never>;
             }, undefined>, undefined>, readonly []>;
         }, undefined>, undefined>, never>;
+        /**
+         * A object of aliases for React built-in hooks.
+         * @description ESLint React will recognize these aliases as equivalent to the built-in hooks in all its rules.
+         * @example `{ useLayoutEffect: ["useIsomorphicLayoutEffect"] }`
+         */
         readonly additionalHooks: OptionalSchema<ObjectSchema<{
             readonly use: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, never>;
             readonly useActionState: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, never>;
@@ -1748,12 +1828,46 @@ declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
      * @deprecated
      */
     readonly reactOptions: OptionalSchema<ObjectSchema<{
+        /**
+         * The source where React is imported from.
+         * @description This allows to specify a custom import location for React when not using the official distribution.
+         * @default `"react"`
+         * @example `"@pika/react"`
+         */
         readonly importSource: OptionalSchema<StringSchema<undefined>, never>;
+        /**
+         * The identifier that’s used for JSX Element creation.
+         * @default `"createElement"`
+         */
         readonly jsxPragma: OptionalSchema<StringSchema<undefined>, never>;
+        /**
+         * 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"`
+         */
         readonly jsxPragmaFrag: OptionalSchema<StringSchema<undefined>, never>;
+        /**
+         * 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>, never>;
+        /**
+         * @internal
+         */
         readonly strict: OptionalSchema<BooleanSchema<undefined>, never>;
+        /**
+         * 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>, never>;
+        /**
+         * An array of user-defined components
+         * @description This is used to inform the ESLint React plugins how to treat these components during checks.
+         * @example `[{ name: "Link", as: "a", attributes: [{ name: "to", as: "href" }, { name: "rel", defaultValue: "noopener noreferrer" }] }]`
+         */
         readonly additionalComponents: OptionalSchema<ArraySchema<ObjectSchema<{
             /**
              * The name of the user-defined component.
@@ -1805,6 +1919,11 @@ declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
                 readonly defaultValue: OptionalSchema<StringSchema<undefined>, never>;
             }, undefined>, undefined>, readonly []>;
         }, undefined>, undefined>, never>;
+        /**
+         * A object of aliases for React built-in hooks.
+         * @description ESLint React will recognize these aliases as equivalent to the built-in hooks in all its rules.
+         * @example `{ useLayoutEffect: ["useIsomorphicLayoutEffect"] }`
+         */
         readonly additionalHooks: OptionalSchema<ObjectSchema<{
             readonly use: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, never>;
             readonly useActionState: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, never>;
@@ -1956,11 +2075,55 @@ interface ESLintReactSettingsExpanded extends ESLintReactSettings {
     additionalComponents: CustomComponentExpanded[];
     components: Map<string, string>;
 }
+/**
+ * Defines the "react-x" settings in a type-safe way.
+ * @param settings The settings.
+ * @returns The ESLint settings containing the "react-x" object.
+ */
+declare function defineSettings(settings: ESLintReactSettings): {
+    importSource?: string | undefined;
+    jsxPragma?: string | undefined;
+    jsxPragmaFrag?: string | undefined;
+    polymorphicPropName?: string | undefined;
+    strict?: boolean | undefined;
+    version?: string | undefined;
+    additionalComponents?: {
+        name: string;
+        attributes: {
+            name: string;
+            as?: string | undefined;
+            controlled?: boolean | undefined;
+            defaultValue?: string | undefined;
+        }[];
+        as?: string | undefined;
+        selector?: string | undefined;
+    }[] | undefined;
+    additionalHooks?: {
+        use?: string[] | undefined;
+        useActionState?: string[] | undefined;
+        useCallback?: string[] | undefined;
+        useContext?: string[] | undefined;
+        useDebugValue?: string[] | undefined;
+        useDeferredValue?: string[] | undefined;
+        useEffect?: string[] | undefined;
+        useId?: string[] | undefined;
+        useImperativeHandle?: string[] | undefined;
+        useInsertionEffect?: string[] | undefined;
+        useLayoutEffect?: string[] | undefined;
+        useMemo?: string[] | undefined;
+        useOptimistic?: string[] | undefined;
+        useReducer?: string[] | undefined;
+        useRef?: string[] | undefined;
+        useState?: string[] | undefined;
+        useSyncExternalStore?: string[] | undefined;
+        useTransition?: string[] | undefined;
+    } | undefined;
+};
 /**
  * Decodes settings from a data object from `context.settings`.
+ * @internal
  * @param data The data object.
  * @returns settings The settings.
- * @internal
  */
 declare function decodeSettings(data: unknown): ESLintReactSettings;
 /**
@@ -1975,4 +2138,4 @@ declare const expandSettings: Memoized<(settings: ESLintReactSettings) => ESLint
  */
 declare const DEFAULT_ESLINT_REACT_SETTINGS: ESLintReactSettings;
 
-export { type CustomAttribute, CustomAttributeSchema, type CustomComponent, type CustomComponentExpanded, CustomComponentSchema, type CustomHook, CustomHookSchema, DEFAULT_ESLINT_REACT_SETTINGS, type ESLintReactSettings, type ESLintReactSettingsExpanded, ESLintReactSettingsSchema, type ESLintSettings, ESLintSettingsSchema, GITHUB_URL, HOST_HTML_COMPONENT_TYPES, HOST_SVG_COMPONENT_TYPES, NPM_SCOPE, RE_CAMEL_CASE, RE_CONSTANT_CASE, RE_JAVASCRIPT_PROTOCOL, RE_KEBAB_CASE, RE_PASCAL_CASE, RE_SNAKE_CASE, WEBSITE_URL, createRuleForPlugin, decodeSettings, expandSettings };
+export { type CustomAttribute, CustomAttributeSchema, type CustomComponent, type CustomComponentExpanded, CustomComponentSchema, type CustomHook, CustomHookSchema, DEFAULT_ESLINT_REACT_SETTINGS, type ESLintReactSettings, type ESLintReactSettingsExpanded, ESLintReactSettingsSchema, type ESLintSettings, ESLintSettingsSchema, GITHUB_URL, HOST_HTML_COMPONENT_TYPES, HOST_SVG_COMPONENT_TYPES, 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, expandSettings };

package/dist/index.d.ts

@@ -56,9 +56,11 @@ declare const HOST_HTML_COMPONENT_TYPES: readonly ["aside", "audio", "b", "base"
  * @internal
  */
 declare const HOST_SVG_COMPONENT_TYPES: readonly ["a", "animate", "animateMotion", "animateTransform", "circle", "clipPath", "defs", "desc", "discard", "ellipse", "feBlend", "feColorMatrix", "feComponentTransfer", "feComposite", "feConvolveMatrix", "feDiffuseLighting", "feDisplacementMap", "feDistantLight", "feDropShadow", "feFlood", "feFuncA", "feFuncB", "feFuncG", "feFuncR", "feGaussianBlur", "feImage", "feMerge", "feMergeNode", "feMorphology", "feOffset", "fePointLight", "feSpecularLighting", "feSpotLight", "feTile", "feTurbulence", "filter", "foreignObject", "g", "hatch", "hatchpath", "image", "line", "linearGradient", "marker", "mask", "metadata", "mpath", "path", "pattern", "polygon", "polyline", "radialGradient", "rect", "script", "set", "stop", "style", "svg", "switch", "symbol", "text", "textPath", "title", "tspan", "use", "view"];
+declare const REACT_BUILD_IN_HOOKS: readonly ["useActionState", "useCallback", "useContext", "useDebugValue", "useDeferredValue", "useEffect", "useId", "useImperativeHandle", "useInsertionEffect", "useLayoutEffect", "useMemo", "useOptimistic", "useReducer", "useRef", "useState", "useSyncExternalStore", "useTransition"];
 
 /**
  * Get the ESLint rule creator for a plugin.
+ * @internal
  * @param pluginName The name of the plugin.
  * @returns The ESLint rule creator.
  */
@@ -1582,12 +1584,46 @@ declare const CustomComponentSchema: ObjectSchema<{
  * @internal
  */
 declare const ESLintReactSettingsSchema: ObjectSchema<{
+    /**
+     * The source where React is imported from.
+     * @description This allows to specify a custom import location for React when not using the official distribution.
+     * @default `"react"`
+     * @example `"@pika/react"`
+     */
     readonly importSource: OptionalSchema<StringSchema<undefined>, never>;
+    /**
+     * The identifier that’s used for JSX Element creation.
+     * @default `"createElement"`
+     */
     readonly jsxPragma: OptionalSchema<StringSchema<undefined>, never>;
+    /**
+     * 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"`
+     */
     readonly jsxPragmaFrag: OptionalSchema<StringSchema<undefined>, never>;
+    /**
+     * 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>, never>;
+    /**
+     * @internal
+     */
     readonly strict: OptionalSchema<BooleanSchema<undefined>, never>;
+    /**
+     * 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>, never>;
+    /**
+     * An array of user-defined components
+     * @description This is used to inform the ESLint React plugins how to treat these components during checks.
+     * @example `[{ name: "Link", as: "a", attributes: [{ name: "to", as: "href" }, { name: "rel", defaultValue: "noopener noreferrer" }] }]`
+     */
     readonly additionalComponents: OptionalSchema<ArraySchema<ObjectSchema<{
         /**
          * The name of the user-defined component.
@@ -1639,6 +1675,11 @@ declare const ESLintReactSettingsSchema: ObjectSchema<{
             readonly defaultValue: OptionalSchema<StringSchema<undefined>, never>;
         }, undefined>, undefined>, readonly []>;
     }, undefined>, undefined>, never>;
+    /**
+     * A object of aliases for React built-in hooks.
+     * @description ESLint React will recognize these aliases as equivalent to the built-in hooks in all its rules.
+     * @example `{ useLayoutEffect: ["useIsomorphicLayoutEffect"] }`
+     */
     readonly additionalHooks: OptionalSchema<ObjectSchema<{
         readonly use: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, never>;
         readonly useActionState: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, never>;
@@ -1665,12 +1706,46 @@ declare const ESLintReactSettingsSchema: ObjectSchema<{
  */
 declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
     readonly "react-x": OptionalSchema<ObjectSchema<{
+        /**
+         * The source where React is imported from.
+         * @description This allows to specify a custom import location for React when not using the official distribution.
+         * @default `"react"`
+         * @example `"@pika/react"`
+         */
         readonly importSource: OptionalSchema<StringSchema<undefined>, never>;
+        /**
+         * The identifier that’s used for JSX Element creation.
+         * @default `"createElement"`
+         */
         readonly jsxPragma: OptionalSchema<StringSchema<undefined>, never>;
+        /**
+         * 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"`
+         */
         readonly jsxPragmaFrag: OptionalSchema<StringSchema<undefined>, never>;
+        /**
+         * 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>, never>;
+        /**
+         * @internal
+         */
         readonly strict: OptionalSchema<BooleanSchema<undefined>, never>;
+        /**
+         * 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>, never>;
+        /**
+         * An array of user-defined components
+         * @description This is used to inform the ESLint React plugins how to treat these components during checks.
+         * @example `[{ name: "Link", as: "a", attributes: [{ name: "to", as: "href" }, { name: "rel", defaultValue: "noopener noreferrer" }] }]`
+         */
         readonly additionalComponents: OptionalSchema<ArraySchema<ObjectSchema<{
             /**
              * The name of the user-defined component.
@@ -1722,6 +1797,11 @@ declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
                 readonly defaultValue: OptionalSchema<StringSchema<undefined>, never>;
             }, undefined>, undefined>, readonly []>;
         }, undefined>, undefined>, never>;
+        /**
+         * A object of aliases for React built-in hooks.
+         * @description ESLint React will recognize these aliases as equivalent to the built-in hooks in all its rules.
+         * @example `{ useLayoutEffect: ["useIsomorphicLayoutEffect"] }`
+         */
         readonly additionalHooks: OptionalSchema<ObjectSchema<{
             readonly use: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, never>;
             readonly useActionState: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, never>;
@@ -1748,12 +1828,46 @@ declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
      * @deprecated
      */
     readonly reactOptions: OptionalSchema<ObjectSchema<{
+        /**
+         * The source where React is imported from.
+         * @description This allows to specify a custom import location for React when not using the official distribution.
+         * @default `"react"`
+         * @example `"@pika/react"`
+         */
         readonly importSource: OptionalSchema<StringSchema<undefined>, never>;
+        /**
+         * The identifier that’s used for JSX Element creation.
+         * @default `"createElement"`
+         */
         readonly jsxPragma: OptionalSchema<StringSchema<undefined>, never>;
+        /**
+         * 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"`
+         */
         readonly jsxPragmaFrag: OptionalSchema<StringSchema<undefined>, never>;
+        /**
+         * 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>, never>;
+        /**
+         * @internal
+         */
         readonly strict: OptionalSchema<BooleanSchema<undefined>, never>;
+        /**
+         * 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>, never>;
+        /**
+         * An array of user-defined components
+         * @description This is used to inform the ESLint React plugins how to treat these components during checks.
+         * @example `[{ name: "Link", as: "a", attributes: [{ name: "to", as: "href" }, { name: "rel", defaultValue: "noopener noreferrer" }] }]`
+         */
         readonly additionalComponents: OptionalSchema<ArraySchema<ObjectSchema<{
             /**
              * The name of the user-defined component.
@@ -1805,6 +1919,11 @@ declare const ESLintSettingsSchema: OptionalSchema<ObjectSchema<{
                 readonly defaultValue: OptionalSchema<StringSchema<undefined>, never>;
             }, undefined>, undefined>, readonly []>;
         }, undefined>, undefined>, never>;
+        /**
+         * A object of aliases for React built-in hooks.
+         * @description ESLint React will recognize these aliases as equivalent to the built-in hooks in all its rules.
+         * @example `{ useLayoutEffect: ["useIsomorphicLayoutEffect"] }`
+         */
         readonly additionalHooks: OptionalSchema<ObjectSchema<{
             readonly use: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, never>;
             readonly useActionState: OptionalSchema<ArraySchema<StringSchema<undefined>, undefined>, never>;
@@ -1956,11 +2075,55 @@ interface ESLintReactSettingsExpanded extends ESLintReactSettings {
     additionalComponents: CustomComponentExpanded[];
     components: Map<string, string>;
 }
+/**
+ * Defines the "react-x" settings in a type-safe way.
+ * @param settings The settings.
+ * @returns The ESLint settings containing the "react-x" object.
+ */
+declare function defineSettings(settings: ESLintReactSettings): {
+    importSource?: string | undefined;
+    jsxPragma?: string | undefined;
+    jsxPragmaFrag?: string | undefined;
+    polymorphicPropName?: string | undefined;
+    strict?: boolean | undefined;
+    version?: string | undefined;
+    additionalComponents?: {
+        name: string;
+        attributes: {
+            name: string;
+            as?: string | undefined;
+            controlled?: boolean | undefined;
+            defaultValue?: string | undefined;
+        }[];
+        as?: string | undefined;
+        selector?: string | undefined;
+    }[] | undefined;
+    additionalHooks?: {
+        use?: string[] | undefined;
+        useActionState?: string[] | undefined;
+        useCallback?: string[] | undefined;
+        useContext?: string[] | undefined;
+        useDebugValue?: string[] | undefined;
+        useDeferredValue?: string[] | undefined;
+        useEffect?: string[] | undefined;
+        useId?: string[] | undefined;
+        useImperativeHandle?: string[] | undefined;
+        useInsertionEffect?: string[] | undefined;
+        useLayoutEffect?: string[] | undefined;
+        useMemo?: string[] | undefined;
+        useOptimistic?: string[] | undefined;
+        useReducer?: string[] | undefined;
+        useRef?: string[] | undefined;
+        useState?: string[] | undefined;
+        useSyncExternalStore?: string[] | undefined;
+        useTransition?: string[] | undefined;
+    } | undefined;
+};
 /**
  * Decodes settings from a data object from `context.settings`.
+ * @internal
  * @param data The data object.
  * @returns settings The settings.
- * @internal
  */
 declare function decodeSettings(data: unknown): ESLintReactSettings;
 /**
@@ -1975,4 +2138,4 @@ declare const expandSettings: Memoized<(settings: ESLintReactSettings) => ESLint
  */
 declare const DEFAULT_ESLINT_REACT_SETTINGS: ESLintReactSettings;
 
-export { type CustomAttribute, CustomAttributeSchema, type CustomComponent, type CustomComponentExpanded, CustomComponentSchema, type CustomHook, CustomHookSchema, DEFAULT_ESLINT_REACT_SETTINGS, type ESLintReactSettings, type ESLintReactSettingsExpanded, ESLintReactSettingsSchema, type ESLintSettings, ESLintSettingsSchema, GITHUB_URL, HOST_HTML_COMPONENT_TYPES, HOST_SVG_COMPONENT_TYPES, NPM_SCOPE, RE_CAMEL_CASE, RE_CONSTANT_CASE, RE_JAVASCRIPT_PROTOCOL, RE_KEBAB_CASE, RE_PASCAL_CASE, RE_SNAKE_CASE, WEBSITE_URL, createRuleForPlugin, decodeSettings, expandSettings };
+export { type CustomAttribute, CustomAttributeSchema, type CustomComponent, type CustomComponentExpanded, CustomComponentSchema, type CustomHook, CustomHookSchema, DEFAULT_ESLINT_REACT_SETTINGS, type ESLintReactSettings, type ESLintReactSettingsExpanded, ESLintReactSettingsSchema, type ESLintSettings, ESLintSettingsSchema, GITHUB_URL, HOST_HTML_COMPONENT_TYPES, HOST_SVG_COMPONENT_TYPES, 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, expandSettings };

package/dist/index.js

@@ -188,6 +188,25 @@ var HOST_SVG_COMPONENT_TYPES = [
   "use",
   "view"
 ];
+var REACT_BUILD_IN_HOOKS = [
+  "useActionState",
+  "useCallback",
+  "useContext",
+  "useDebugValue",
+  "useDeferredValue",
+  "useEffect",
+  "useId",
+  "useImperativeHandle",
+  "useInsertionEffect",
+  "useLayoutEffect",
+  "useMemo",
+  "useOptimistic",
+  "useReducer",
+  "useRef",
+  "useState",
+  "useSyncExternalStore",
+  "useTransition"
+];
 var getDocsUrl = (pluginName) => (ruleName) => {
   if (pluginName === "x") return `${WEBSITE_URL}/docs/rules/${ruleName}`;
   return `${WEBSITE_URL}/docs/rules/${pluginName}-${ruleName}`;
@@ -531,13 +550,52 @@ var CustomComponentSchema = object({
   attributes: optional(array(CustomAttributeSchema), [])
 });
 var ESLintReactSettingsSchema = object({
+  /**
+   * The source where React is imported from.
+   * @description This allows to specify a custom import location for React when not using the official distribution.
+   * @default `"react"`
+   * @example `"@pika/react"`
+   */
   importSource: optional(string()),
+  /**
+   * The identifier that’s used for JSX Element creation.
+   * @default `"createElement"`
+   */
   jsxPragma: optional(string()),
+  /**
+   * 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"`
+   */
   jsxPragmaFrag: optional(string()),
+  /**
+   * The name of the prop that is used for polymorphic components.
+   * @description This is used to determine the type of the component.
+   * @example `"as"`
+   */
   polymorphicPropName: optional(string()),
+  /**
+   * @internal
+   */
   strict: optional(boolean()),
+  /**
+   * 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"`
+   */
   version: optional(string()),
+  /**
+   * An array of user-defined components
+   * @description This is used to inform the ESLint React plugins how to treat these components during checks.
+   * @example `[{ name: "Link", as: "a", attributes: [{ name: "to", as: "href" }, { name: "rel", defaultValue: "noopener noreferrer" }] }]`
+   */
   additionalComponents: optional(array(CustomComponentSchema)),
+  /**
+   * A object of aliases for React built-in hooks.
+   * @description ESLint React will recognize these aliases as equivalent to the built-in hooks in all its rules.
+   * @example `{ useLayoutEffect: ["useIsomorphicLayoutEffect"] }`
+   */
   additionalHooks: optional(object({
     use: optional(array(string())),
     useActionState: optional(array(string())),
@@ -854,6 +912,9 @@ function createMemoizedFunction(fn, options) {
   memoized.options = normalizedOptions;
   return memoized;
 }
+function defineSettings(settings) {
+  return parse(ESLintSettingsSchema, settings)["react-x"] ?? {};
+}
 function decodeSettings(data) {
   return parse(ESLintSettingsSchema, data)["react-x"] ?? {};
 }
@@ -898,6 +959,7 @@ exports.GITHUB_URL = GITHUB_URL;
 exports.HOST_HTML_COMPONENT_TYPES = HOST_HTML_COMPONENT_TYPES;
 exports.HOST_SVG_COMPONENT_TYPES = HOST_SVG_COMPONENT_TYPES;
 exports.NPM_SCOPE = NPM_SCOPE;
+exports.REACT_BUILD_IN_HOOKS = REACT_BUILD_IN_HOOKS;
 exports.RE_CAMEL_CASE = RE_CAMEL_CASE;
 exports.RE_CONSTANT_CASE = RE_CONSTANT_CASE;
 exports.RE_JAVASCRIPT_PROTOCOL = RE_JAVASCRIPT_PROTOCOL;
@@ -907,4 +969,5 @@ exports.RE_SNAKE_CASE = RE_SNAKE_CASE;
 exports.WEBSITE_URL = WEBSITE_URL;
 exports.createRuleForPlugin = createRuleForPlugin;
 exports.decodeSettings = decodeSettings;
+exports.defineSettings = defineSettings;
 exports.expandSettings = expandSettings;

package/dist/index.mjs

@@ -182,6 +182,25 @@ var HOST_SVG_COMPONENT_TYPES = [
   "use",
   "view"
 ];
+var REACT_BUILD_IN_HOOKS = [
+  "useActionState",
+  "useCallback",
+  "useContext",
+  "useDebugValue",
+  "useDeferredValue",
+  "useEffect",
+  "useId",
+  "useImperativeHandle",
+  "useInsertionEffect",
+  "useLayoutEffect",
+  "useMemo",
+  "useOptimistic",
+  "useReducer",
+  "useRef",
+  "useState",
+  "useSyncExternalStore",
+  "useTransition"
+];
 var getDocsUrl = (pluginName) => (ruleName) => {
   if (pluginName === "x") return `${WEBSITE_URL}/docs/rules/${ruleName}`;
   return `${WEBSITE_URL}/docs/rules/${pluginName}-${ruleName}`;
@@ -525,13 +544,52 @@ var CustomComponentSchema = object({
   attributes: optional(array(CustomAttributeSchema), [])
 });
 var ESLintReactSettingsSchema = object({
+  /**
+   * The source where React is imported from.
+   * @description This allows to specify a custom import location for React when not using the official distribution.
+   * @default `"react"`
+   * @example `"@pika/react"`
+   */
   importSource: optional(string()),
+  /**
+   * The identifier that’s used for JSX Element creation.
+   * @default `"createElement"`
+   */
   jsxPragma: optional(string()),
+  /**
+   * 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"`
+   */
   jsxPragmaFrag: optional(string()),
+  /**
+   * The name of the prop that is used for polymorphic components.
+   * @description This is used to determine the type of the component.
+   * @example `"as"`
+   */
   polymorphicPropName: optional(string()),
+  /**
+   * @internal
+   */
   strict: optional(boolean()),
+  /**
+   * 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"`
+   */
   version: optional(string()),
+  /**
+   * An array of user-defined components
+   * @description This is used to inform the ESLint React plugins how to treat these components during checks.
+   * @example `[{ name: "Link", as: "a", attributes: [{ name: "to", as: "href" }, { name: "rel", defaultValue: "noopener noreferrer" }] }]`
+   */
   additionalComponents: optional(array(CustomComponentSchema)),
+  /**
+   * A object of aliases for React built-in hooks.
+   * @description ESLint React will recognize these aliases as equivalent to the built-in hooks in all its rules.
+   * @example `{ useLayoutEffect: ["useIsomorphicLayoutEffect"] }`
+   */
   additionalHooks: optional(object({
     use: optional(array(string())),
     useActionState: optional(array(string())),
@@ -848,6 +906,9 @@ function createMemoizedFunction(fn, options) {
   memoized.options = normalizedOptions;
   return memoized;
 }
+function defineSettings(settings) {
+  return parse(ESLintSettingsSchema, settings)["react-x"] ?? {};
+}
 function decodeSettings(data) {
   return parse(ESLintSettingsSchema, data)["react-x"] ?? {};
 }
@@ -882,4 +943,4 @@ var DEFAULT_ESLINT_REACT_SETTINGS = {
   version: "detect"
 };
 
-export { CustomAttributeSchema, CustomComponentSchema, CustomHookSchema, DEFAULT_ESLINT_REACT_SETTINGS, ESLintReactSettingsSchema, ESLintSettingsSchema, GITHUB_URL, HOST_HTML_COMPONENT_TYPES, HOST_SVG_COMPONENT_TYPES, NPM_SCOPE, RE_CAMEL_CASE, RE_CONSTANT_CASE, RE_JAVASCRIPT_PROTOCOL, RE_KEBAB_CASE, RE_PASCAL_CASE, RE_SNAKE_CASE, WEBSITE_URL, createRuleForPlugin, decodeSettings, expandSettings };
+export { CustomAttributeSchema, CustomComponentSchema, CustomHookSchema, DEFAULT_ESLINT_REACT_SETTINGS, ESLintReactSettingsSchema, ESLintSettingsSchema, GITHUB_URL, HOST_HTML_COMPONENT_TYPES, HOST_SVG_COMPONENT_TYPES, 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, expandSettings };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint-react/shared",
-  "version": "1.8.2",
+  "version": "1.8.3-beta.2",
   "description": "ESLint React's Shared constants and functions.",
   "homepage": "https://github.com/rel1cx/eslint-react",
   "bugs": {