@eslint-react/jsx 0.5.8 → 0.5.9

package/dist/index.cjs

@@ -1,17 +1,9 @@
 'use strict';
 
-var memo = require('micro-memoize');
 require('@typescript-eslint/scope-manager');
 var types = require('@typescript-eslint/types');
 var utils = require('@typescript-eslint/utils');
-
-/**
- * Check if a JSXElement or JSXFragment has children
- * @param node The AST node to check
- * @returns `true` if the node has children
- */ function hasChildren(node) {
-    return node.children.length > 0;
-}
+var memo = require('micro-memoize');
 
 /**
  * @since 2.0.0
@@ -4760,43 +4752,6 @@ var effectData_esm = /*#__PURE__*/ Object.freeze({
     unsafeStruct: unsafeStruct
 });
 
-/**
- * Tests if a value is a `string`.
- *
- * @param input - The value to test.
- *
- * @example
- * import { isString } from "effect/Predicate"
- *
- * assert.deepStrictEqual(isString("a"), true)
- *
- * assert.deepStrictEqual(isString(1), false)
- *
- * @category guards
- * @since 2.0.0
- */
-const isString$1 = input => typeof input === "string";
-
-const RE_JSX_ANNOTATION_REGEX = /@jsx\s+(\S+)/u;
-// Does not check for reserved keywords or unicode characters
-const RE_JS_IDENTIFIER_REGEX = /^[$A-Z_a-z][\w$]*$/u;
-function getFragmentFromContext(context) {
-    // eslint-disable-next-line prefer-destructuring
-    const settings = context.settings;
-    const fragment = settings.react?.fragment;
-    if (isString$1(fragment) && RE_JS_IDENTIFIER_REGEX.test(fragment)) {
-        return fragment;
-    }
-    return "Fragment";
-}
-const getPragmaFromContext = memo((context)=>{
-    // eslint-disable-next-line prefer-destructuring
-    const settings = context.settings;
-    const sourceCode = context.getSourceCode();
-    const pragmaNode = sourceCode.getAllComments().find((node)=>RE_JSX_ANNOTATION_REGEX.test(node.value));
-    return effectFunction_esm.pipe(effectOption_esm.orElse(effectOption_esm.fromNullable(settings.react?.pragma), ()=>effectFunction_esm.pipe(effectOption_esm.fromNullable(pragmaNode), effectOption_esm.map(({ value })=>RE_JSX_ANNOTATION_REGEX.exec(value)), effectOption_esm.flatMapNullable((matches)=>matches?.[1]?.split(".")[0]))), effectOption_esm.flatMap(effectOption_esm.liftPredicate((x)=>RE_JS_IDENTIFIER_REGEX.test(x))), effectOption_esm.getOrElse(effectFunction_esm.constant("React")));
-});
-
 function isNil(x){
   return x === undefined || x === null
 }
@@ -4815,7 +4770,7 @@ function isNil(x){
  *
  * @category guards
  * @since 2.0.0
- */ const isString = (input)=>typeof input === "string";
+ */ const isString$1 = (input)=>typeof input === "string";
 const t$1 = Symbol.for("@ts-pattern/matcher"), e$1 = Symbol.for("@ts-pattern/isVariadic"), n$1 = "@ts-pattern/anonymous-select-key", r$1 = (t)=>Boolean(t && "object" == typeof t), i$1 = (e)=>e && !!e[t$1], s$1 = (n, o, c)=>{
     if (i$1(n)) {
         const e = n[t$1](), { matched: r, selections: i } = e.match(o);
@@ -6480,7 +6435,7 @@ Function.call.bind(Object.hasOwnProperty);
     return returnStatements;
 }
 function isStringLiteral(node) {
-    return node?.type === NodeType.Literal && isString(node.value);
+    return node?.type === NodeType.Literal && isString$1(node.value);
 }
 /**
  * Check if a node is multiline
@@ -6552,6 +6507,62 @@ function isStringLiteral(node) {
     };
 }
 
+/**
+ * Check if a `JSXElement` or `JSXFragment` has children
+ * @param node The AST node to check
+ * @param predicate A predicate to filter the children
+ * @returns `true` if the node has children
+ */ function hasChildren(node, predicate) {
+    if (typeof predicate === "function") {
+        return node.children.some(predicate);
+    }
+    return node.children.length > 0;
+}
+/**
+ * Check if a node is a child of a `JSXElement`
+ * @param node The AST node to check
+ * @returns `true` if the node is a child of a `JSXElement`
+ */ function isChildOfJSXElement(node) {
+    return node.parent?.type === NodeType.JSXElement && node.parent.children.some((child)=>child === node);
+}
+
+/**
+ * Tests if a value is a `string`.
+ *
+ * @param input - The value to test.
+ *
+ * @example
+ * import { isString } from "effect/Predicate"
+ *
+ * assert.deepStrictEqual(isString("a"), true)
+ *
+ * assert.deepStrictEqual(isString(1), false)
+ *
+ * @category guards
+ * @since 2.0.0
+ */
+const isString = input => typeof input === "string";
+
+const RE_JSX_ANNOTATION_REGEX = /@jsx\s+(\S+)/u;
+// Does not check for reserved keywords or unicode characters
+const RE_JS_IDENTIFIER_REGEX = /^[$A-Z_a-z][\w$]*$/u;
+function getFragmentFromContext(context) {
+    // eslint-disable-next-line prefer-destructuring
+    const settings = context.settings;
+    const fragment = settings.react?.fragment;
+    if (isString(fragment) && RE_JS_IDENTIFIER_REGEX.test(fragment)) {
+        return fragment;
+    }
+    return "Fragment";
+}
+const getPragmaFromContext = memo((context)=>{
+    // eslint-disable-next-line prefer-destructuring
+    const settings = context.settings;
+    const sourceCode = context.getSourceCode();
+    const pragmaNode = sourceCode.getAllComments().find((node)=>RE_JSX_ANNOTATION_REGEX.test(node.value));
+    return effectFunction_esm.pipe(effectOption_esm.orElse(effectOption_esm.fromNullable(settings.react?.pragma), ()=>effectFunction_esm.pipe(effectOption_esm.fromNullable(pragmaNode), effectOption_esm.map(({ value })=>RE_JSX_ANNOTATION_REGEX.exec(value)), effectOption_esm.flatMapNullable((matches)=>matches?.[1]?.split(".")[0]))), effectOption_esm.flatMap(effectOption_esm.liftPredicate((x)=>RE_JS_IDENTIFIER_REGEX.test(x))), effectOption_esm.getOrElse(effectFunction_esm.constant("React")));
+});
+
 const t=Symbol.for("@ts-pattern/matcher"),e=Symbol.for("@ts-pattern/isVariadic"),n="@ts-pattern/anonymous-select-key",r=t=>Boolean(t&&"object"==typeof t),i=e=>e&&!!e[t],s=(n,o,c)=>{if(i(n)){const e=n[t](),{matched:r,selections:i}=e.match(o);return r&&i&&Object.keys(i).forEach(t=>c(t,i[t])),r}if(r(n)){if(!r(o))return !1;if(Array.isArray(n)){if(!Array.isArray(o))return !1;let t=[],r=[],a=[];for(const s of n.keys()){const o=n[s];i(o)&&o[e]?a.push(o):a.length?r.push(o):t.push(o);}if(a.length){if(a.length>1)throw new Error("Pattern error: Using `...P.array(...)` several times in a single pattern is not allowed.");if(o.length<t.length+r.length)return !1;const e=o.slice(0,t.length),n=0===r.length?[]:o.slice(-r.length),i=o.slice(t.length,0===r.length?Infinity:-r.length);return t.every((t,n)=>s(t,e[n],c))&&r.every((t,e)=>s(t,n[e],c))&&(0===a.length||s(a[0],i,c))}return n.length===o.length&&n.every((t,e)=>s(t,o[e],c))}return Object.keys(n).every(e=>{const r=n[e];return (e in o||i(a=r)&&"optional"===a[t]().matcherType)&&s(r,o[e],c);var a;})}return Object.is(o,n)},o=e=>{var n,s,a;return r(e)?i(e)?null!=(n=null==(s=(a=e[t]()).getSelectionKeys)?void 0:s.call(a))?n:[]:Array.isArray(e)?c(e,o):c(Object.values(e),o):[]},c=(t,e)=>t.reduce((t,n)=>t.concat(e(n)),[]);function a(...t){if(1===t.length){const[e]=t;return t=>s(e,t,()=>{})}if(2===t.length){const[e,n]=t;return s(e,n,()=>{})}throw new Error(`isMatching wasn't given the right number of arguments: expected 1 or 2, received ${t.length}.`)}function u(t){return Object.assign(t,{optional:()=>l(t),and:e=>m(t,e),or:e=>y(t,e),select:e=>void 0===e?p(t):p(e,t)})}function h(t){return Object.assign((t=>Object.assign(t,{*[Symbol.iterator](){yield Object.assign(t,{[e]:!0});}}))(t),{optional:()=>h(l(t)),select:e=>h(void 0===e?p(t):p(e,t))})}function l(e){return u({[t]:()=>({match:t=>{let n={};const r=(t,e)=>{n[t]=e;};return void 0===t?(o(e).forEach(t=>r(t,void 0)),{matched:!0,selections:n}):{matched:s(e,t,r),selections:n}},getSelectionKeys:()=>o(e),matcherType:"optional"})})}const f=(t,e)=>{for(const n of t)if(!e(n))return !1;return !0},g=(t,e)=>{for(const[n,r]of t.entries())if(!e(r,n))return !1;return !0};function m(...e){return u({[t]:()=>({match:t=>{let n={};const r=(t,e)=>{n[t]=e;};return {matched:e.every(e=>s(e,t,r)),selections:n}},getSelectionKeys:()=>c(e,o),matcherType:"and"})})}function y(...e){return u({[t]:()=>({match:t=>{let n={};const r=(t,e)=>{n[t]=e;};return c(e,o).forEach(t=>r(t,void 0)),{matched:e.some(e=>s(e,t,r)),selections:n}},getSelectionKeys:()=>c(e,o),matcherType:"or"})})}function d(e){return {[t]:()=>({match:t=>({matched:Boolean(e(t))})})}}function p(...e){const r="string"==typeof e[0]?e[0]:void 0,i=2===e.length?e[1]:"string"==typeof e[0]?void 0:e[0];return u({[t]:()=>({match:t=>{let e={[null!=r?r:n]:t};return {matched:void 0===i||s(i,t,(t,n)=>{e[t]=n;}),selections:e}},getSelectionKeys:()=>[null!=r?r:n].concat(void 0===i?[]:o(i))})})}function v(t){return "number"==typeof t}function b(t){return "string"==typeof t}function w(t){return "bigint"==typeof t}const S=u(d(function(t){return !0})),O=S,j=t=>Object.assign(u(t),{startsWith:e=>{return j(m(t,(n=e,d(t=>b(t)&&t.startsWith(n)))));var n;},endsWith:e=>{return j(m(t,(n=e,d(t=>b(t)&&t.endsWith(n)))));var n;},minLength:e=>j(m(t,(t=>d(e=>b(e)&&e.length>=t))(e))),maxLength:e=>j(m(t,(t=>d(e=>b(e)&&e.length<=t))(e))),includes:e=>{return j(m(t,(n=e,d(t=>b(t)&&t.includes(n)))));var n;},regex:e=>{return j(m(t,(n=e,d(t=>b(t)&&Boolean(t.match(n))))));var n;}}),E=j(d(b)),K=t=>Object.assign(u(t),{between:(e,n)=>K(m(t,((t,e)=>d(n=>v(n)&&t<=n&&e>=n))(e,n))),lt:e=>K(m(t,(t=>d(e=>v(e)&&e<t))(e))),gt:e=>K(m(t,(t=>d(e=>v(e)&&e>t))(e))),lte:e=>K(m(t,(t=>d(e=>v(e)&&e<=t))(e))),gte:e=>K(m(t,(t=>d(e=>v(e)&&e>=t))(e))),int:()=>K(m(t,d(t=>v(t)&&Number.isInteger(t)))),finite:()=>K(m(t,d(t=>v(t)&&Number.isFinite(t)))),positive:()=>K(m(t,d(t=>v(t)&&t>0))),negative:()=>K(m(t,d(t=>v(t)&&t<0)))}),A=K(d(v)),x=t=>Object.assign(u(t),{between:(e,n)=>x(m(t,((t,e)=>d(n=>w(n)&&t<=n&&e>=n))(e,n))),lt:e=>x(m(t,(t=>d(e=>w(e)&&e<t))(e))),gt:e=>x(m(t,(t=>d(e=>w(e)&&e>t))(e))),lte:e=>x(m(t,(t=>d(e=>w(e)&&e<=t))(e))),gte:e=>x(m(t,(t=>d(e=>w(e)&&e>=t))(e))),positive:()=>x(m(t,d(t=>w(t)&&t>0))),negative:()=>x(m(t,d(t=>w(t)&&t<0)))}),P=x(d(w)),T=u(d(function(t){return "boolean"==typeof t})),k=u(d(function(t){return "symbol"==typeof t})),B=u(d(function(t){return null==t}));var _={__proto__:null,matcher:t,optional:l,array:function(...e){return h({[t]:()=>({match:t=>{if(!Array.isArray(t))return {matched:!1};if(0===e.length)return {matched:!0};const n=e[0];let r={};if(0===t.length)return o(n).forEach(t=>{r[t]=[];}),{matched:!0,selections:r};const i=(t,e)=>{r[t]=(r[t]||[]).concat([e]);};return {matched:t.every(t=>s(n,t,i)),selections:r}},getSelectionKeys:()=>0===e.length?[]:o(e[0])})})},set:function(...e){return u({[t]:()=>({match:t=>{if(!(t instanceof Set))return {matched:!1};let n={};if(0===t.size)return {matched:!0,selections:n};if(0===e.length)return {matched:!0};const r=(t,e)=>{n[t]=(n[t]||[]).concat([e]);},i=e[0];return {matched:f(t,t=>s(i,t,r)),selections:n}},getSelectionKeys:()=>0===e.length?[]:o(e[0])})})},map:function(...e){return u({[t]:()=>({match:t=>{if(!(t instanceof Map))return {matched:!1};let n={};if(0===t.size)return {matched:!0,selections:n};const r=(t,e)=>{n[t]=(n[t]||[]).concat([e]);};if(0===e.length)return {matched:!0};var i;if(1===e.length)throw new Error(`\`P.map\` wasn't given enough arguments. Expected (key, value), received ${null==(i=e[0])?void 0:i.toString()}`);const[o,c]=e;return {matched:g(t,(t,e)=>{const n=s(o,e,r),i=s(c,t,r);return n&&i}),selections:n}},getSelectionKeys:()=>0===e.length?[]:[...o(e[0]),...o(e[1])]})})},intersection:m,union:y,not:function(e){return u({[t]:()=>({match:t=>({matched:!s(e,t,()=>{})}),getSelectionKeys:()=>[],matcherType:"not"})})},when:d,select:p,any:S,_:O,string:E,number:A,bigint:P,boolean:T,symbol:k,nullish:B,instanceOf:function(t){return u(d(function(t){return e=>e instanceof t}(t)))},shape:function(t){return u(d(a(t)))}};const W={matched:!1,value:void 0};function N(t){return new $(t,W)}class ${constructor(t,e){this.input=void 0,this.state=void 0,this.input=t,this.state=e;}with(...t){if(this.state.matched)return this;const e=t[t.length-1],r=[t[0]];let i;3===t.length&&"function"==typeof t[1]?(r.push(t[0]),i=t[1]):t.length>2&&r.push(...t.slice(1,t.length-1));let o=!1,c={};const a=(t,e)=>{o=!0,c[t]=e;},u=!r.some(t=>s(t,this.input,a))||i&&!Boolean(i(this.input))?W:{matched:!0,value:e(o?n in c?c[n]:c:this.input,this.input)};return new $(this.input,u)}when(t,e){if(this.state.matched)return this;const n=Boolean(t(this.input));return new $(this.input,n?{matched:!0,value:e(this.input,this.input)}:W)}otherwise(t){return this.state.matched?this.state.value:t(this.input)}exhaustive(){return this.run()}run(){if(this.state.matched)return this.state.value;let t;try{t=JSON.stringify(this.input);}catch(e){t=this.input;}throw new Error(`Pattern matching error: no pattern matches value ${t}`)}returnType(){return this}}
 
 function isPropertyOfPragma(name, context, pragma = getPragmaFromContext(context)) {
@@ -6667,6 +6678,21 @@ function isChildrenOfCreateElement(node, context) {
     return maybeCallExpression.arguments.slice(2).some((child)=>child === node);
 }
 
+/**
+ * Check if a node is a `JSXElement` of `User-Defined Component` type
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXElement` of `User-Defined Component` type
+ */ function isJSXElementOfUserDefinedComponent(node) {
+    return node.type === NodeType.JSXElement && node.openingElement.name.type === NodeType.JSXIdentifier && /^[A-Z]/u.test(node.openingElement.name.name);
+}
+/**
+ * Check if a node is a `JSXFragment` of `Built-in Component` type
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXFragment` of `Built-in Component` type
+ */ function isJSXElementOfBuiltinComponent(node) {
+    return node.type === NodeType.JSXElement && node.openingElement.name.type === NodeType.JSXIdentifier && node.openingElement.name.name.toLowerCase() === node.openingElement.name.name && /^[a-z]/u.test(node.openingElement.name.name);
+}
+
 /**
  * Determines whether inside createElement's props.
  * @param node The AST node to check
@@ -6822,6 +6848,89 @@ const hdlWheel = [
     ...hdlWheel
 ];
 
+/**
+ * Check if a node is a Literal or JSXText
+ * @param node The AST node to check
+ * @returns boolean `true` if the node is a Literal or JSXText
+ */ const isLiteral = isOneOf([
+    NodeType.Literal,
+    NodeType.JSXText
+]);
+/**
+ * Check if a Literal or JSXText node is whitespace
+ * @param node The AST node to check
+ * @returns boolean `true` if the node is whitespace
+ */ function isWhiteSpace(node) {
+    return isString(node.value) && node.value.trim() === "";
+}
+/**
+ * Check if a Literal or JSXText node is a line break
+ * @param node The AST node to check
+ * @returns boolean
+ */ function isLineBreak(node) {
+    return isLiteral(node) && isWhiteSpace(node) && isMultiLine(node);
+}
+/**
+ * Check if a Literal or JSXText node is padding spaces
+ * @param node The AST node to check
+ * @returns boolean
+ */ function isPaddingSpaces(node) {
+    return isLiteral(node) && isWhiteSpace(node) && node.raw.includes("\n");
+}
+
+const isFragment = (node, pragma, fragment)=>{
+    if (!isOneOf([
+        NodeType.JSXElement,
+        NodeType.JSXFragment
+    ])(node)) {
+        return false;
+    }
+    return isFragmentSyntax(node) || isFragmentElement(node, pragma, fragment);
+};
+/**
+ * Check if a node is `<></>`
+ */ const isFragmentSyntax = is(NodeType.JSXFragment);
+/**
+ * Check if a node is `<Fragment></Fragment>` or `<Pragma.Fragment></Pragma.Fragment>`
+ * @param node
+ * @param pragma
+ * @param fragment
+ */ function isFragmentElement(node, pragma, fragment) {
+    const { name } = node.openingElement;
+    // <Fragment>
+    if (name.type === NodeType.JSXIdentifier && name.name === fragment) {
+        return true;
+    }
+    // <Pragma.Fragment>
+    return name.type === NodeType.JSXMemberExpression && name.object.type === NodeType.JSXIdentifier && name.object.name === pragma && name.property.name === fragment;
+}
+/**
+ * Check if a JSXElement or JSXFragment has only one literal child and is not a child
+ * @param node The AST node to check
+ * @returns `true` if the node has only one literal child and is not a child
+ * @example Somehow fragment like this is useful: <Foo content={<>ee eeee eeee ...</>} />
+ */ function isFragmentWithOnlyTextAndIsNotChild(node) {
+    return node.children.length === 1 && isLiteral(node.children[0]) && !(node.parent.type === NodeType.JSXElement || node.parent.type === NodeType.JSXFragment);
+}
+function containsCallExpression(node) {
+    return node.type === NodeType.JSXExpressionContainer && node.expression.type === NodeType.CallExpression;
+}
+/**
+ * Check if a JSXElement or JSXFragment has less than two non-padding children and the first child is not a call expression
+ * @param node The AST node to check
+ * @returns boolean
+ */ function isFragmentHasLessThanTwoChildren(node) {
+    const nonPaddingChildren = node.children.filter((child)=>!isPaddingSpaces(child));
+    if (nonPaddingChildren.length === 1) {
+        return !containsCallExpression(nonPaddingChildren[0]);
+    }
+    return nonPaddingChildren.length === 0;
+}
+function isFragmentWithSingleExpression(node) {
+    const children = node.children.filter((child)=>!isPaddingSpaces(child));
+    return children.length === 1 && children[0]?.type === NodeType.JSXExpressionContainer;
+}
+
 const defaultJSXValueCheckOptions = {
     ignoreNull: false,
     strict: false
@@ -6871,7 +6980,7 @@ const defaultJSXValueCheckOptions = {
         if (isJSXTagNameExpression(node)) {
             return true;
         }
-        if (!isString$1(node.name) && node.name.type !== NodeType.Identifier) {
+        if (!isString(node.name) && node.name.type !== NodeType.Identifier) {
             return isJSXTagNameExpression(node.name);
         }
         const name = N(node.name).with(_.string, effectFunction_esm.identity).with({
@@ -7053,29 +7162,6 @@ const defaultJSXValueCheckOptions = {
     return effectOption_esm.some(getStaticValue(argument, scope));
 }
 
-/**
- * Check if a node is a Literal or JSXText
- * @param node The AST node to check
- * @returns boolean `true` if the node is a Literal or JSXText
- */ const isLiteral = isOneOf([
-    NodeType.Literal,
-    NodeType.JSXText
-]);
-/**
- * Check if a Literal or JSXText node is whitespace
- * @param node The AST node to check
- * @returns boolean `true` if the node is whitespace
- */ function isWhiteSpace(node) {
-    return isString$1(node.value) && node.value.trim() === "";
-}
-/**
- * Check if a Literal or JSXText node is a line break
- * @param node The AST node to check
- * @returns boolean
- */ function isLineBreak(node) {
-    return isLiteral(node) && isWhiteSpace(node) && isMultiLine(node);
-}
-
 exports.defaultJSXValueCheckOptions = defaultJSXValueCheckOptions;
 exports.elementType = elementType;
 exports.findPropInAttributes = findPropInAttributes;
@@ -7104,16 +7190,26 @@ exports.hdlTouch = hdlTouch;
 exports.hdlTransition = hdlTransition;
 exports.hdlWheel = hdlWheel;
 exports.isCallFromPragma = isCallFromPragma;
+exports.isChildOfJSXElement = isChildOfJSXElement;
 exports.isChildrenOfCreateElement = isChildrenOfCreateElement;
 exports.isCloneElementCall = isCloneElementCall;
 exports.isCreateElementCall = isCreateElementCall;
+exports.isFragment = isFragment;
+exports.isFragmentElement = isFragmentElement;
+exports.isFragmentHasLessThanTwoChildren = isFragmentHasLessThanTwoChildren;
+exports.isFragmentSyntax = isFragmentSyntax;
+exports.isFragmentWithOnlyTextAndIsNotChild = isFragmentWithOnlyTextAndIsNotChild;
+exports.isFragmentWithSingleExpression = isFragmentWithSingleExpression;
 exports.isFunctionReturningJSXValue = isFunctionReturningJSXValue;
 exports.isInitializedFromPragma = isInitializedFromPragma;
 exports.isInsideCreateElementProps = isInsideCreateElementProps;
 exports.isInsidePropValue = isInsidePropValue;
+exports.isJSXElementOfBuiltinComponent = isJSXElementOfBuiltinComponent;
+exports.isJSXElementOfUserDefinedComponent = isJSXElementOfUserDefinedComponent;
 exports.isJSXValue = isJSXValue;
 exports.isLineBreak = isLineBreak;
 exports.isLiteral = isLiteral;
+exports.isPaddingSpaces = isPaddingSpaces;
 exports.isPropertyOfPragma = isPropertyOfPragma;
 exports.isWhiteSpace = isWhiteSpace;
 exports.traverseUpProp = traverseUpProp;

package/dist/index.d.mts

@@ -5,14 +5,36 @@ import { TSESTree as TSESTree$1 } from '@typescript-eslint/utils';
 import { O } from '@eslint-react/tools';
 
 /**
- * Check if a JSXElement or JSXFragment has children
+ * Check if a `JSXElement` or `JSXFragment` has children
  * @param node The AST node to check
+ * @param predicate A predicate to filter the children
  * @returns `true` if the node has children
  */
-declare function hasChildren(node: TSESTree.JSXElement | TSESTree.JSXFragment): boolean;
+declare function hasChildren(node: TSESTree.JSXElement | TSESTree.JSXFragment, predicate?: (node: TSESTree.JSXChild) => boolean): boolean;
+/**
+ * Check if a node is a child of a `JSXElement`
+ * @param node The AST node to check
+ * @returns `true` if the node is a child of a `JSXElement`
+ */
+declare function isChildOfJSXElement(node: TSESTree.Node): node is TSESTree.JSXElement & {
+    parent: TSESTree.JSXElement;
+};
 
 declare function isChildrenOfCreateElement(node: TSESTree.Node, context: RuleContext): boolean;
 
+/**
+ * Check if a node is a `JSXElement` of `User-Defined Component` type
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXElement` of `User-Defined Component` type
+ */
+declare function isJSXElementOfUserDefinedComponent(node: TSESTree.Node): node is TSESTree.JSXElement;
+/**
+ * Check if a node is a `JSXFragment` of `Built-in Component` type
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXFragment` of `Built-in Component` type
+ */
+declare function isJSXElementOfBuiltinComponent(node: TSESTree.Node): node is TSESTree.JSXFragment;
+
 declare function getFragmentFromContext<T extends RuleContext>(context: T): string;
 declare const getPragmaFromContext: <T extends RuleContext>(context: T) => string;
 
@@ -72,6 +94,33 @@ declare const hdlTransition: readonly ["onTransitionEnd"];
 declare const hdlScroll: readonly ["onScroll"];
 declare const hdlWheel: readonly ["onWheel"];
 
+declare const isFragment: (node: TSESTree.Node, pragma: string, fragment: string) => node is TSESTree.JSXElement | TSESTree.JSXFragment;
+/**
+ * Check if a node is `<></>`
+ */
+declare const isFragmentSyntax: (node: TSESTree.Node | null | undefined) => node is TSESTree.JSXFragment;
+/**
+ * Check if a node is `<Fragment></Fragment>` or `<Pragma.Fragment></Pragma.Fragment>`
+ * @param node
+ * @param pragma
+ * @param fragment
+ */
+declare function isFragmentElement(node: TSESTree.JSXElement, pragma: string, fragment: string): boolean;
+/**
+ * Check if a JSXElement or JSXFragment has only one literal child and is not a child
+ * @param node The AST node to check
+ * @returns `true` if the node has only one literal child and is not a child
+ * @example Somehow fragment like this is useful: <Foo content={<>ee eeee eeee ...</>} />
+ */
+declare function isFragmentWithOnlyTextAndIsNotChild(node: TSESTree.JSXElement | TSESTree.JSXFragment): boolean;
+/**
+ * Check if a JSXElement or JSXFragment has less than two non-padding children and the first child is not a call expression
+ * @param node The AST node to check
+ * @returns boolean
+ */
+declare function isFragmentHasLessThanTwoChildren(node: TSESTree.JSXElement | TSESTree.JSXFragment): boolean;
+declare function isFragmentWithSingleExpression(node: TSESTree.JSXElement | TSESTree.JSXFragment): boolean;
+
 type JSXValueCheckOptions = {
     /**
      * Whether to check all branches of the conditional expression
@@ -196,5 +245,11 @@ declare function isWhiteSpace(node: TSESTree.JSXText | TSESTree.Literal): boolea
  * @returns boolean
  */
 declare function isLineBreak(node: TSESTree.Node): boolean;
+/**
+ * Check if a Literal or JSXText node is padding spaces
+ * @param node The AST node to check
+ * @returns boolean
+ */
+declare function isPaddingSpaces(node: TSESTree.Node): boolean;
 
-export { type CallFromPragmaPredicate, type JSXValueCheckOptions, defaultJSXValueCheckOptions, elementType, findPropInAttributes, findPropInProperties, getFragmentFromContext, getPragmaFromContext, getPropName, getPropNameWithNamespace, getPropValue, hasAnyProp, hasChildren, hasEveryProp, hasProp, hdlAnimation, hdlClipboard, hdlComposition, hdlFocus, hdlForm, hdlImage, hdlKeyboard, hdlMedia, hdlMouse, hdlScroll, hdlSelection, hdlTouch, hdlTransition, hdlWheel, isCallFromPragma, isChildrenOfCreateElement, isCloneElementCall, isCreateElementCall, isFunctionReturningJSXValue, isInitializedFromPragma, isInsideCreateElementProps, isInsidePropValue, isJSXValue, isLineBreak, isLiteral, isPropertyOfPragma, isWhiteSpace, traverseUpProp };
+export { type CallFromPragmaPredicate, type JSXValueCheckOptions, defaultJSXValueCheckOptions, elementType, findPropInAttributes, findPropInProperties, getFragmentFromContext, getPragmaFromContext, getPropName, getPropNameWithNamespace, getPropValue, hasAnyProp, hasChildren, hasEveryProp, hasProp, hdlAnimation, hdlClipboard, hdlComposition, hdlFocus, hdlForm, hdlImage, hdlKeyboard, hdlMedia, hdlMouse, hdlScroll, hdlSelection, hdlTouch, hdlTransition, hdlWheel, isCallFromPragma, isChildOfJSXElement, isChildrenOfCreateElement, isCloneElementCall, isCreateElementCall, isFragment, isFragmentElement, isFragmentHasLessThanTwoChildren, isFragmentSyntax, isFragmentWithOnlyTextAndIsNotChild, isFragmentWithSingleExpression, isFunctionReturningJSXValue, isInitializedFromPragma, isInsideCreateElementProps, isInsidePropValue, isJSXElementOfBuiltinComponent, isJSXElementOfUserDefinedComponent, isJSXValue, isLineBreak, isLiteral, isPaddingSpaces, isPropertyOfPragma, isWhiteSpace, traverseUpProp };

package/dist/index.d.ts

@@ -5,14 +5,36 @@ import { TSESTree as TSESTree$1 } from '@typescript-eslint/utils';
 import { O } from '@eslint-react/tools';
 
 /**
- * Check if a JSXElement or JSXFragment has children
+ * Check if a `JSXElement` or `JSXFragment` has children
  * @param node The AST node to check
+ * @param predicate A predicate to filter the children
  * @returns `true` if the node has children
  */
-declare function hasChildren(node: TSESTree.JSXElement | TSESTree.JSXFragment): boolean;
+declare function hasChildren(node: TSESTree.JSXElement | TSESTree.JSXFragment, predicate?: (node: TSESTree.JSXChild) => boolean): boolean;
+/**
+ * Check if a node is a child of a `JSXElement`
+ * @param node The AST node to check
+ * @returns `true` if the node is a child of a `JSXElement`
+ */
+declare function isChildOfJSXElement(node: TSESTree.Node): node is TSESTree.JSXElement & {
+    parent: TSESTree.JSXElement;
+};
 
 declare function isChildrenOfCreateElement(node: TSESTree.Node, context: RuleContext): boolean;
 
+/**
+ * Check if a node is a `JSXElement` of `User-Defined Component` type
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXElement` of `User-Defined Component` type
+ */
+declare function isJSXElementOfUserDefinedComponent(node: TSESTree.Node): node is TSESTree.JSXElement;
+/**
+ * Check if a node is a `JSXFragment` of `Built-in Component` type
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXFragment` of `Built-in Component` type
+ */
+declare function isJSXElementOfBuiltinComponent(node: TSESTree.Node): node is TSESTree.JSXFragment;
+
 declare function getFragmentFromContext<T extends RuleContext>(context: T): string;
 declare const getPragmaFromContext: <T extends RuleContext>(context: T) => string;
 
@@ -72,6 +94,33 @@ declare const hdlTransition: readonly ["onTransitionEnd"];
 declare const hdlScroll: readonly ["onScroll"];
 declare const hdlWheel: readonly ["onWheel"];
 
+declare const isFragment: (node: TSESTree.Node, pragma: string, fragment: string) => node is TSESTree.JSXElement | TSESTree.JSXFragment;
+/**
+ * Check if a node is `<></>`
+ */
+declare const isFragmentSyntax: (node: TSESTree.Node | null | undefined) => node is TSESTree.JSXFragment;
+/**
+ * Check if a node is `<Fragment></Fragment>` or `<Pragma.Fragment></Pragma.Fragment>`
+ * @param node
+ * @param pragma
+ * @param fragment
+ */
+declare function isFragmentElement(node: TSESTree.JSXElement, pragma: string, fragment: string): boolean;
+/**
+ * Check if a JSXElement or JSXFragment has only one literal child and is not a child
+ * @param node The AST node to check
+ * @returns `true` if the node has only one literal child and is not a child
+ * @example Somehow fragment like this is useful: <Foo content={<>ee eeee eeee ...</>} />
+ */
+declare function isFragmentWithOnlyTextAndIsNotChild(node: TSESTree.JSXElement | TSESTree.JSXFragment): boolean;
+/**
+ * Check if a JSXElement or JSXFragment has less than two non-padding children and the first child is not a call expression
+ * @param node The AST node to check
+ * @returns boolean
+ */
+declare function isFragmentHasLessThanTwoChildren(node: TSESTree.JSXElement | TSESTree.JSXFragment): boolean;
+declare function isFragmentWithSingleExpression(node: TSESTree.JSXElement | TSESTree.JSXFragment): boolean;
+
 type JSXValueCheckOptions = {
     /**
      * Whether to check all branches of the conditional expression
@@ -196,5 +245,11 @@ declare function isWhiteSpace(node: TSESTree.JSXText | TSESTree.Literal): boolea
  * @returns boolean
  */
 declare function isLineBreak(node: TSESTree.Node): boolean;
+/**
+ * Check if a Literal or JSXText node is padding spaces
+ * @param node The AST node to check
+ * @returns boolean
+ */
+declare function isPaddingSpaces(node: TSESTree.Node): boolean;
 
-export { type CallFromPragmaPredicate, type JSXValueCheckOptions, defaultJSXValueCheckOptions, elementType, findPropInAttributes, findPropInProperties, getFragmentFromContext, getPragmaFromContext, getPropName, getPropNameWithNamespace, getPropValue, hasAnyProp, hasChildren, hasEveryProp, hasProp, hdlAnimation, hdlClipboard, hdlComposition, hdlFocus, hdlForm, hdlImage, hdlKeyboard, hdlMedia, hdlMouse, hdlScroll, hdlSelection, hdlTouch, hdlTransition, hdlWheel, isCallFromPragma, isChildrenOfCreateElement, isCloneElementCall, isCreateElementCall, isFunctionReturningJSXValue, isInitializedFromPragma, isInsideCreateElementProps, isInsidePropValue, isJSXValue, isLineBreak, isLiteral, isPropertyOfPragma, isWhiteSpace, traverseUpProp };
+export { type CallFromPragmaPredicate, type JSXValueCheckOptions, defaultJSXValueCheckOptions, elementType, findPropInAttributes, findPropInProperties, getFragmentFromContext, getPragmaFromContext, getPropName, getPropNameWithNamespace, getPropValue, hasAnyProp, hasChildren, hasEveryProp, hasProp, hdlAnimation, hdlClipboard, hdlComposition, hdlFocus, hdlForm, hdlImage, hdlKeyboard, hdlMedia, hdlMouse, hdlScroll, hdlSelection, hdlTouch, hdlTransition, hdlWheel, isCallFromPragma, isChildOfJSXElement, isChildrenOfCreateElement, isCloneElementCall, isCreateElementCall, isFragment, isFragmentElement, isFragmentHasLessThanTwoChildren, isFragmentSyntax, isFragmentWithOnlyTextAndIsNotChild, isFragmentWithSingleExpression, isFunctionReturningJSXValue, isInitializedFromPragma, isInsideCreateElementProps, isInsidePropValue, isJSXElementOfBuiltinComponent, isJSXElementOfUserDefinedComponent, isJSXValue, isLineBreak, isLiteral, isPaddingSpaces, isPropertyOfPragma, isWhiteSpace, traverseUpProp };

package/dist/index.js

@@ -1,17 +1,9 @@
 'use strict';
 
-var memo = require('micro-memoize');
 require('@typescript-eslint/scope-manager');
 var types = require('@typescript-eslint/types');
 var utils = require('@typescript-eslint/utils');
-
-/**
- * Check if a JSXElement or JSXFragment has children
- * @param node The AST node to check
- * @returns `true` if the node has children
- */ function hasChildren(node) {
-    return node.children.length > 0;
-}
+var memo = require('micro-memoize');
 
 /**
  * @since 2.0.0
@@ -4760,43 +4752,6 @@ var effectData_esm = /*#__PURE__*/ Object.freeze({
     unsafeStruct: unsafeStruct
 });
 
-/**
- * Tests if a value is a `string`.
- *
- * @param input - The value to test.
- *
- * @example
- * import { isString } from "effect/Predicate"
- *
- * assert.deepStrictEqual(isString("a"), true)
- *
- * assert.deepStrictEqual(isString(1), false)
- *
- * @category guards
- * @since 2.0.0
- */
-const isString$1 = input => typeof input === "string";
-
-const RE_JSX_ANNOTATION_REGEX = /@jsx\s+(\S+)/u;
-// Does not check for reserved keywords or unicode characters
-const RE_JS_IDENTIFIER_REGEX = /^[$A-Z_a-z][\w$]*$/u;
-function getFragmentFromContext(context) {
-    // eslint-disable-next-line prefer-destructuring
-    const settings = context.settings;
-    const fragment = settings.react?.fragment;
-    if (isString$1(fragment) && RE_JS_IDENTIFIER_REGEX.test(fragment)) {
-        return fragment;
-    }
-    return "Fragment";
-}
-const getPragmaFromContext = memo((context)=>{
-    // eslint-disable-next-line prefer-destructuring
-    const settings = context.settings;
-    const sourceCode = context.getSourceCode();
-    const pragmaNode = sourceCode.getAllComments().find((node)=>RE_JSX_ANNOTATION_REGEX.test(node.value));
-    return effectFunction_esm.pipe(effectOption_esm.orElse(effectOption_esm.fromNullable(settings.react?.pragma), ()=>effectFunction_esm.pipe(effectOption_esm.fromNullable(pragmaNode), effectOption_esm.map(({ value })=>RE_JSX_ANNOTATION_REGEX.exec(value)), effectOption_esm.flatMapNullable((matches)=>matches?.[1]?.split(".")[0]))), effectOption_esm.flatMap(effectOption_esm.liftPredicate((x)=>RE_JS_IDENTIFIER_REGEX.test(x))), effectOption_esm.getOrElse(effectFunction_esm.constant("React")));
-});
-
 function isNil(x){
   return x === undefined || x === null
 }
@@ -4815,7 +4770,7 @@ function isNil(x){
  *
  * @category guards
  * @since 2.0.0
- */ const isString = (input)=>typeof input === "string";
+ */ const isString$1 = (input)=>typeof input === "string";
 const t$1 = Symbol.for("@ts-pattern/matcher"), e$1 = Symbol.for("@ts-pattern/isVariadic"), n$1 = "@ts-pattern/anonymous-select-key", r$1 = (t)=>Boolean(t && "object" == typeof t), i$1 = (e)=>e && !!e[t$1], s$1 = (n, o, c)=>{
     if (i$1(n)) {
         const e = n[t$1](), { matched: r, selections: i } = e.match(o);
@@ -6480,7 +6435,7 @@ Function.call.bind(Object.hasOwnProperty);
     return returnStatements;
 }
 function isStringLiteral(node) {
-    return node?.type === NodeType.Literal && isString(node.value);
+    return node?.type === NodeType.Literal && isString$1(node.value);
 }
 /**
  * Check if a node is multiline
@@ -6552,6 +6507,62 @@ function isStringLiteral(node) {
     };
 }
 
+/**
+ * Check if a `JSXElement` or `JSXFragment` has children
+ * @param node The AST node to check
+ * @param predicate A predicate to filter the children
+ * @returns `true` if the node has children
+ */ function hasChildren(node, predicate) {
+    if (typeof predicate === "function") {
+        return node.children.some(predicate);
+    }
+    return node.children.length > 0;
+}
+/**
+ * Check if a node is a child of a `JSXElement`
+ * @param node The AST node to check
+ * @returns `true` if the node is a child of a `JSXElement`
+ */ function isChildOfJSXElement(node) {
+    return node.parent?.type === NodeType.JSXElement && node.parent.children.some((child)=>child === node);
+}
+
+/**
+ * Tests if a value is a `string`.
+ *
+ * @param input - The value to test.
+ *
+ * @example
+ * import { isString } from "effect/Predicate"
+ *
+ * assert.deepStrictEqual(isString("a"), true)
+ *
+ * assert.deepStrictEqual(isString(1), false)
+ *
+ * @category guards
+ * @since 2.0.0
+ */
+const isString = input => typeof input === "string";
+
+const RE_JSX_ANNOTATION_REGEX = /@jsx\s+(\S+)/u;
+// Does not check for reserved keywords or unicode characters
+const RE_JS_IDENTIFIER_REGEX = /^[$A-Z_a-z][\w$]*$/u;
+function getFragmentFromContext(context) {
+    // eslint-disable-next-line prefer-destructuring
+    const settings = context.settings;
+    const fragment = settings.react?.fragment;
+    if (isString(fragment) && RE_JS_IDENTIFIER_REGEX.test(fragment)) {
+        return fragment;
+    }
+    return "Fragment";
+}
+const getPragmaFromContext = memo((context)=>{
+    // eslint-disable-next-line prefer-destructuring
+    const settings = context.settings;
+    const sourceCode = context.getSourceCode();
+    const pragmaNode = sourceCode.getAllComments().find((node)=>RE_JSX_ANNOTATION_REGEX.test(node.value));
+    return effectFunction_esm.pipe(effectOption_esm.orElse(effectOption_esm.fromNullable(settings.react?.pragma), ()=>effectFunction_esm.pipe(effectOption_esm.fromNullable(pragmaNode), effectOption_esm.map(({ value })=>RE_JSX_ANNOTATION_REGEX.exec(value)), effectOption_esm.flatMapNullable((matches)=>matches?.[1]?.split(".")[0]))), effectOption_esm.flatMap(effectOption_esm.liftPredicate((x)=>RE_JS_IDENTIFIER_REGEX.test(x))), effectOption_esm.getOrElse(effectFunction_esm.constant("React")));
+});
+
 const t=Symbol.for("@ts-pattern/matcher"),e=Symbol.for("@ts-pattern/isVariadic"),n="@ts-pattern/anonymous-select-key",r=t=>Boolean(t&&"object"==typeof t),i=e=>e&&!!e[t],s=(n,o,c)=>{if(i(n)){const e=n[t](),{matched:r,selections:i}=e.match(o);return r&&i&&Object.keys(i).forEach(t=>c(t,i[t])),r}if(r(n)){if(!r(o))return !1;if(Array.isArray(n)){if(!Array.isArray(o))return !1;let t=[],r=[],a=[];for(const s of n.keys()){const o=n[s];i(o)&&o[e]?a.push(o):a.length?r.push(o):t.push(o);}if(a.length){if(a.length>1)throw new Error("Pattern error: Using `...P.array(...)` several times in a single pattern is not allowed.");if(o.length<t.length+r.length)return !1;const e=o.slice(0,t.length),n=0===r.length?[]:o.slice(-r.length),i=o.slice(t.length,0===r.length?Infinity:-r.length);return t.every((t,n)=>s(t,e[n],c))&&r.every((t,e)=>s(t,n[e],c))&&(0===a.length||s(a[0],i,c))}return n.length===o.length&&n.every((t,e)=>s(t,o[e],c))}return Object.keys(n).every(e=>{const r=n[e];return (e in o||i(a=r)&&"optional"===a[t]().matcherType)&&s(r,o[e],c);var a;})}return Object.is(o,n)},o=e=>{var n,s,a;return r(e)?i(e)?null!=(n=null==(s=(a=e[t]()).getSelectionKeys)?void 0:s.call(a))?n:[]:Array.isArray(e)?c(e,o):c(Object.values(e),o):[]},c=(t,e)=>t.reduce((t,n)=>t.concat(e(n)),[]);function a(...t){if(1===t.length){const[e]=t;return t=>s(e,t,()=>{})}if(2===t.length){const[e,n]=t;return s(e,n,()=>{})}throw new Error(`isMatching wasn't given the right number of arguments: expected 1 or 2, received ${t.length}.`)}function u(t){return Object.assign(t,{optional:()=>l(t),and:e=>m(t,e),or:e=>y(t,e),select:e=>void 0===e?p(t):p(e,t)})}function h(t){return Object.assign((t=>Object.assign(t,{*[Symbol.iterator](){yield Object.assign(t,{[e]:!0});}}))(t),{optional:()=>h(l(t)),select:e=>h(void 0===e?p(t):p(e,t))})}function l(e){return u({[t]:()=>({match:t=>{let n={};const r=(t,e)=>{n[t]=e;};return void 0===t?(o(e).forEach(t=>r(t,void 0)),{matched:!0,selections:n}):{matched:s(e,t,r),selections:n}},getSelectionKeys:()=>o(e),matcherType:"optional"})})}const f=(t,e)=>{for(const n of t)if(!e(n))return !1;return !0},g=(t,e)=>{for(const[n,r]of t.entries())if(!e(r,n))return !1;return !0};function m(...e){return u({[t]:()=>({match:t=>{let n={};const r=(t,e)=>{n[t]=e;};return {matched:e.every(e=>s(e,t,r)),selections:n}},getSelectionKeys:()=>c(e,o),matcherType:"and"})})}function y(...e){return u({[t]:()=>({match:t=>{let n={};const r=(t,e)=>{n[t]=e;};return c(e,o).forEach(t=>r(t,void 0)),{matched:e.some(e=>s(e,t,r)),selections:n}},getSelectionKeys:()=>c(e,o),matcherType:"or"})})}function d(e){return {[t]:()=>({match:t=>({matched:Boolean(e(t))})})}}function p(...e){const r="string"==typeof e[0]?e[0]:void 0,i=2===e.length?e[1]:"string"==typeof e[0]?void 0:e[0];return u({[t]:()=>({match:t=>{let e={[null!=r?r:n]:t};return {matched:void 0===i||s(i,t,(t,n)=>{e[t]=n;}),selections:e}},getSelectionKeys:()=>[null!=r?r:n].concat(void 0===i?[]:o(i))})})}function v(t){return "number"==typeof t}function b(t){return "string"==typeof t}function w(t){return "bigint"==typeof t}const S=u(d(function(t){return !0})),O=S,j=t=>Object.assign(u(t),{startsWith:e=>{return j(m(t,(n=e,d(t=>b(t)&&t.startsWith(n)))));var n;},endsWith:e=>{return j(m(t,(n=e,d(t=>b(t)&&t.endsWith(n)))));var n;},minLength:e=>j(m(t,(t=>d(e=>b(e)&&e.length>=t))(e))),maxLength:e=>j(m(t,(t=>d(e=>b(e)&&e.length<=t))(e))),includes:e=>{return j(m(t,(n=e,d(t=>b(t)&&t.includes(n)))));var n;},regex:e=>{return j(m(t,(n=e,d(t=>b(t)&&Boolean(t.match(n))))));var n;}}),E=j(d(b)),K=t=>Object.assign(u(t),{between:(e,n)=>K(m(t,((t,e)=>d(n=>v(n)&&t<=n&&e>=n))(e,n))),lt:e=>K(m(t,(t=>d(e=>v(e)&&e<t))(e))),gt:e=>K(m(t,(t=>d(e=>v(e)&&e>t))(e))),lte:e=>K(m(t,(t=>d(e=>v(e)&&e<=t))(e))),gte:e=>K(m(t,(t=>d(e=>v(e)&&e>=t))(e))),int:()=>K(m(t,d(t=>v(t)&&Number.isInteger(t)))),finite:()=>K(m(t,d(t=>v(t)&&Number.isFinite(t)))),positive:()=>K(m(t,d(t=>v(t)&&t>0))),negative:()=>K(m(t,d(t=>v(t)&&t<0)))}),A=K(d(v)),x=t=>Object.assign(u(t),{between:(e,n)=>x(m(t,((t,e)=>d(n=>w(n)&&t<=n&&e>=n))(e,n))),lt:e=>x(m(t,(t=>d(e=>w(e)&&e<t))(e))),gt:e=>x(m(t,(t=>d(e=>w(e)&&e>t))(e))),lte:e=>x(m(t,(t=>d(e=>w(e)&&e<=t))(e))),gte:e=>x(m(t,(t=>d(e=>w(e)&&e>=t))(e))),positive:()=>x(m(t,d(t=>w(t)&&t>0))),negative:()=>x(m(t,d(t=>w(t)&&t<0)))}),P=x(d(w)),T=u(d(function(t){return "boolean"==typeof t})),k=u(d(function(t){return "symbol"==typeof t})),B=u(d(function(t){return null==t}));var _={__proto__:null,matcher:t,optional:l,array:function(...e){return h({[t]:()=>({match:t=>{if(!Array.isArray(t))return {matched:!1};if(0===e.length)return {matched:!0};const n=e[0];let r={};if(0===t.length)return o(n).forEach(t=>{r[t]=[];}),{matched:!0,selections:r};const i=(t,e)=>{r[t]=(r[t]||[]).concat([e]);};return {matched:t.every(t=>s(n,t,i)),selections:r}},getSelectionKeys:()=>0===e.length?[]:o(e[0])})})},set:function(...e){return u({[t]:()=>({match:t=>{if(!(t instanceof Set))return {matched:!1};let n={};if(0===t.size)return {matched:!0,selections:n};if(0===e.length)return {matched:!0};const r=(t,e)=>{n[t]=(n[t]||[]).concat([e]);},i=e[0];return {matched:f(t,t=>s(i,t,r)),selections:n}},getSelectionKeys:()=>0===e.length?[]:o(e[0])})})},map:function(...e){return u({[t]:()=>({match:t=>{if(!(t instanceof Map))return {matched:!1};let n={};if(0===t.size)return {matched:!0,selections:n};const r=(t,e)=>{n[t]=(n[t]||[]).concat([e]);};if(0===e.length)return {matched:!0};var i;if(1===e.length)throw new Error(`\`P.map\` wasn't given enough arguments. Expected (key, value), received ${null==(i=e[0])?void 0:i.toString()}`);const[o,c]=e;return {matched:g(t,(t,e)=>{const n=s(o,e,r),i=s(c,t,r);return n&&i}),selections:n}},getSelectionKeys:()=>0===e.length?[]:[...o(e[0]),...o(e[1])]})})},intersection:m,union:y,not:function(e){return u({[t]:()=>({match:t=>({matched:!s(e,t,()=>{})}),getSelectionKeys:()=>[],matcherType:"not"})})},when:d,select:p,any:S,_:O,string:E,number:A,bigint:P,boolean:T,symbol:k,nullish:B,instanceOf:function(t){return u(d(function(t){return e=>e instanceof t}(t)))},shape:function(t){return u(d(a(t)))}};const W={matched:!1,value:void 0};function N(t){return new $(t,W)}class ${constructor(t,e){this.input=void 0,this.state=void 0,this.input=t,this.state=e;}with(...t){if(this.state.matched)return this;const e=t[t.length-1],r=[t[0]];let i;3===t.length&&"function"==typeof t[1]?(r.push(t[0]),i=t[1]):t.length>2&&r.push(...t.slice(1,t.length-1));let o=!1,c={};const a=(t,e)=>{o=!0,c[t]=e;},u=!r.some(t=>s(t,this.input,a))||i&&!Boolean(i(this.input))?W:{matched:!0,value:e(o?n in c?c[n]:c:this.input,this.input)};return new $(this.input,u)}when(t,e){if(this.state.matched)return this;const n=Boolean(t(this.input));return new $(this.input,n?{matched:!0,value:e(this.input,this.input)}:W)}otherwise(t){return this.state.matched?this.state.value:t(this.input)}exhaustive(){return this.run()}run(){if(this.state.matched)return this.state.value;let t;try{t=JSON.stringify(this.input);}catch(e){t=this.input;}throw new Error(`Pattern matching error: no pattern matches value ${t}`)}returnType(){return this}}
 
 function isPropertyOfPragma(name, context, pragma = getPragmaFromContext(context)) {
@@ -6667,6 +6678,21 @@ function isChildrenOfCreateElement(node, context) {
     return maybeCallExpression.arguments.slice(2).some((child)=>child === node);
 }
 
+/**
+ * Check if a node is a `JSXElement` of `User-Defined Component` type
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXElement` of `User-Defined Component` type
+ */ function isJSXElementOfUserDefinedComponent(node) {
+    return node.type === NodeType.JSXElement && node.openingElement.name.type === NodeType.JSXIdentifier && /^[A-Z]/u.test(node.openingElement.name.name);
+}
+/**
+ * Check if a node is a `JSXFragment` of `Built-in Component` type
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXFragment` of `Built-in Component` type
+ */ function isJSXElementOfBuiltinComponent(node) {
+    return node.type === NodeType.JSXElement && node.openingElement.name.type === NodeType.JSXIdentifier && node.openingElement.name.name.toLowerCase() === node.openingElement.name.name && /^[a-z]/u.test(node.openingElement.name.name);
+}
+
 /**
  * Determines whether inside createElement's props.
  * @param node The AST node to check
@@ -6822,6 +6848,89 @@ const hdlWheel = [
     ...hdlWheel
 ];
 
+/**
+ * Check if a node is a Literal or JSXText
+ * @param node The AST node to check
+ * @returns boolean `true` if the node is a Literal or JSXText
+ */ const isLiteral = isOneOf([
+    NodeType.Literal,
+    NodeType.JSXText
+]);
+/**
+ * Check if a Literal or JSXText node is whitespace
+ * @param node The AST node to check
+ * @returns boolean `true` if the node is whitespace
+ */ function isWhiteSpace(node) {
+    return isString(node.value) && node.value.trim() === "";
+}
+/**
+ * Check if a Literal or JSXText node is a line break
+ * @param node The AST node to check
+ * @returns boolean
+ */ function isLineBreak(node) {
+    return isLiteral(node) && isWhiteSpace(node) && isMultiLine(node);
+}
+/**
+ * Check if a Literal or JSXText node is padding spaces
+ * @param node The AST node to check
+ * @returns boolean
+ */ function isPaddingSpaces(node) {
+    return isLiteral(node) && isWhiteSpace(node) && node.raw.includes("\n");
+}
+
+const isFragment = (node, pragma, fragment)=>{
+    if (!isOneOf([
+        NodeType.JSXElement,
+        NodeType.JSXFragment
+    ])(node)) {
+        return false;
+    }
+    return isFragmentSyntax(node) || isFragmentElement(node, pragma, fragment);
+};
+/**
+ * Check if a node is `<></>`
+ */ const isFragmentSyntax = is(NodeType.JSXFragment);
+/**
+ * Check if a node is `<Fragment></Fragment>` or `<Pragma.Fragment></Pragma.Fragment>`
+ * @param node
+ * @param pragma
+ * @param fragment
+ */ function isFragmentElement(node, pragma, fragment) {
+    const { name } = node.openingElement;
+    // <Fragment>
+    if (name.type === NodeType.JSXIdentifier && name.name === fragment) {
+        return true;
+    }
+    // <Pragma.Fragment>
+    return name.type === NodeType.JSXMemberExpression && name.object.type === NodeType.JSXIdentifier && name.object.name === pragma && name.property.name === fragment;
+}
+/**
+ * Check if a JSXElement or JSXFragment has only one literal child and is not a child
+ * @param node The AST node to check
+ * @returns `true` if the node has only one literal child and is not a child
+ * @example Somehow fragment like this is useful: <Foo content={<>ee eeee eeee ...</>} />
+ */ function isFragmentWithOnlyTextAndIsNotChild(node) {
+    return node.children.length === 1 && isLiteral(node.children[0]) && !(node.parent.type === NodeType.JSXElement || node.parent.type === NodeType.JSXFragment);
+}
+function containsCallExpression(node) {
+    return node.type === NodeType.JSXExpressionContainer && node.expression.type === NodeType.CallExpression;
+}
+/**
+ * Check if a JSXElement or JSXFragment has less than two non-padding children and the first child is not a call expression
+ * @param node The AST node to check
+ * @returns boolean
+ */ function isFragmentHasLessThanTwoChildren(node) {
+    const nonPaddingChildren = node.children.filter((child)=>!isPaddingSpaces(child));
+    if (nonPaddingChildren.length === 1) {
+        return !containsCallExpression(nonPaddingChildren[0]);
+    }
+    return nonPaddingChildren.length === 0;
+}
+function isFragmentWithSingleExpression(node) {
+    const children = node.children.filter((child)=>!isPaddingSpaces(child));
+    return children.length === 1 && children[0]?.type === NodeType.JSXExpressionContainer;
+}
+
 const defaultJSXValueCheckOptions = {
     ignoreNull: false,
     strict: false
@@ -6871,7 +6980,7 @@ const defaultJSXValueCheckOptions = {
         if (isJSXTagNameExpression(node)) {
             return true;
         }
-        if (!isString$1(node.name) && node.name.type !== NodeType.Identifier) {
+        if (!isString(node.name) && node.name.type !== NodeType.Identifier) {
             return isJSXTagNameExpression(node.name);
         }
         const name = N(node.name).with(_.string, effectFunction_esm.identity).with({
@@ -7053,29 +7162,6 @@ const defaultJSXValueCheckOptions = {
     return effectOption_esm.some(getStaticValue(argument, scope));
 }
 
-/**
- * Check if a node is a Literal or JSXText
- * @param node The AST node to check
- * @returns boolean `true` if the node is a Literal or JSXText
- */ const isLiteral = isOneOf([
-    NodeType.Literal,
-    NodeType.JSXText
-]);
-/**
- * Check if a Literal or JSXText node is whitespace
- * @param node The AST node to check
- * @returns boolean `true` if the node is whitespace
- */ function isWhiteSpace(node) {
-    return isString$1(node.value) && node.value.trim() === "";
-}
-/**
- * Check if a Literal or JSXText node is a line break
- * @param node The AST node to check
- * @returns boolean
- */ function isLineBreak(node) {
-    return isLiteral(node) && isWhiteSpace(node) && isMultiLine(node);
-}
-
 exports.defaultJSXValueCheckOptions = defaultJSXValueCheckOptions;
 exports.elementType = elementType;
 exports.findPropInAttributes = findPropInAttributes;
@@ -7104,16 +7190,26 @@ exports.hdlTouch = hdlTouch;
 exports.hdlTransition = hdlTransition;
 exports.hdlWheel = hdlWheel;
 exports.isCallFromPragma = isCallFromPragma;
+exports.isChildOfJSXElement = isChildOfJSXElement;
 exports.isChildrenOfCreateElement = isChildrenOfCreateElement;
 exports.isCloneElementCall = isCloneElementCall;
 exports.isCreateElementCall = isCreateElementCall;
+exports.isFragment = isFragment;
+exports.isFragmentElement = isFragmentElement;
+exports.isFragmentHasLessThanTwoChildren = isFragmentHasLessThanTwoChildren;
+exports.isFragmentSyntax = isFragmentSyntax;
+exports.isFragmentWithOnlyTextAndIsNotChild = isFragmentWithOnlyTextAndIsNotChild;
+exports.isFragmentWithSingleExpression = isFragmentWithSingleExpression;
 exports.isFunctionReturningJSXValue = isFunctionReturningJSXValue;
 exports.isInitializedFromPragma = isInitializedFromPragma;
 exports.isInsideCreateElementProps = isInsideCreateElementProps;
 exports.isInsidePropValue = isInsidePropValue;
+exports.isJSXElementOfBuiltinComponent = isJSXElementOfBuiltinComponent;
+exports.isJSXElementOfUserDefinedComponent = isJSXElementOfUserDefinedComponent;
 exports.isJSXValue = isJSXValue;
 exports.isLineBreak = isLineBreak;
 exports.isLiteral = isLiteral;
+exports.isPaddingSpaces = isPaddingSpaces;
 exports.isPropertyOfPragma = isPropertyOfPragma;
 exports.isWhiteSpace = isWhiteSpace;
 exports.traverseUpProp = traverseUpProp;

package/dist/index.mjs

@@ -1,15 +1,7 @@
-import memo from 'micro-memoize';
 import '@typescript-eslint/scope-manager';
 import { AST_NODE_TYPES } from '@typescript-eslint/types';
 import { ASTUtils } from '@typescript-eslint/utils';
-
-/**
- * Check if a JSXElement or JSXFragment has children
- * @param node The AST node to check
- * @returns `true` if the node has children
- */ function hasChildren(node) {
-    return node.children.length > 0;
-}
+import memo from 'micro-memoize';
 
 /**
  * @since 2.0.0
@@ -4758,43 +4750,6 @@ var effectData_esm = /*#__PURE__*/ Object.freeze({
     unsafeStruct: unsafeStruct
 });
 
-/**
- * Tests if a value is a `string`.
- *
- * @param input - The value to test.
- *
- * @example
- * import { isString } from "effect/Predicate"
- *
- * assert.deepStrictEqual(isString("a"), true)
- *
- * assert.deepStrictEqual(isString(1), false)
- *
- * @category guards
- * @since 2.0.0
- */
-const isString$1 = input => typeof input === "string";
-
-const RE_JSX_ANNOTATION_REGEX = /@jsx\s+(\S+)/u;
-// Does not check for reserved keywords or unicode characters
-const RE_JS_IDENTIFIER_REGEX = /^[$A-Z_a-z][\w$]*$/u;
-function getFragmentFromContext(context) {
-    // eslint-disable-next-line prefer-destructuring
-    const settings = context.settings;
-    const fragment = settings.react?.fragment;
-    if (isString$1(fragment) && RE_JS_IDENTIFIER_REGEX.test(fragment)) {
-        return fragment;
-    }
-    return "Fragment";
-}
-const getPragmaFromContext = memo((context)=>{
-    // eslint-disable-next-line prefer-destructuring
-    const settings = context.settings;
-    const sourceCode = context.getSourceCode();
-    const pragmaNode = sourceCode.getAllComments().find((node)=>RE_JSX_ANNOTATION_REGEX.test(node.value));
-    return effectFunction_esm.pipe(effectOption_esm.orElse(effectOption_esm.fromNullable(settings.react?.pragma), ()=>effectFunction_esm.pipe(effectOption_esm.fromNullable(pragmaNode), effectOption_esm.map(({ value })=>RE_JSX_ANNOTATION_REGEX.exec(value)), effectOption_esm.flatMapNullable((matches)=>matches?.[1]?.split(".")[0]))), effectOption_esm.flatMap(effectOption_esm.liftPredicate((x)=>RE_JS_IDENTIFIER_REGEX.test(x))), effectOption_esm.getOrElse(effectFunction_esm.constant("React")));
-});
-
 function isNil(x){
   return x === undefined || x === null
 }
@@ -4813,7 +4768,7 @@ function isNil(x){
  *
  * @category guards
  * @since 2.0.0
- */ const isString = (input)=>typeof input === "string";
+ */ const isString$1 = (input)=>typeof input === "string";
 const t$1 = Symbol.for("@ts-pattern/matcher"), e$1 = Symbol.for("@ts-pattern/isVariadic"), n$1 = "@ts-pattern/anonymous-select-key", r$1 = (t)=>Boolean(t && "object" == typeof t), i$1 = (e)=>e && !!e[t$1], s$1 = (n, o, c)=>{
     if (i$1(n)) {
         const e = n[t$1](), { matched: r, selections: i } = e.match(o);
@@ -6478,7 +6433,7 @@ Function.call.bind(Object.hasOwnProperty);
     return returnStatements;
 }
 function isStringLiteral(node) {
-    return node?.type === NodeType.Literal && isString(node.value);
+    return node?.type === NodeType.Literal && isString$1(node.value);
 }
 /**
  * Check if a node is multiline
@@ -6550,6 +6505,62 @@ function isStringLiteral(node) {
     };
 }
 
+/**
+ * Check if a `JSXElement` or `JSXFragment` has children
+ * @param node The AST node to check
+ * @param predicate A predicate to filter the children
+ * @returns `true` if the node has children
+ */ function hasChildren(node, predicate) {
+    if (typeof predicate === "function") {
+        return node.children.some(predicate);
+    }
+    return node.children.length > 0;
+}
+/**
+ * Check if a node is a child of a `JSXElement`
+ * @param node The AST node to check
+ * @returns `true` if the node is a child of a `JSXElement`
+ */ function isChildOfJSXElement(node) {
+    return node.parent?.type === NodeType.JSXElement && node.parent.children.some((child)=>child === node);
+}
+
+/**
+ * Tests if a value is a `string`.
+ *
+ * @param input - The value to test.
+ *
+ * @example
+ * import { isString } from "effect/Predicate"
+ *
+ * assert.deepStrictEqual(isString("a"), true)
+ *
+ * assert.deepStrictEqual(isString(1), false)
+ *
+ * @category guards
+ * @since 2.0.0
+ */
+const isString = input => typeof input === "string";
+
+const RE_JSX_ANNOTATION_REGEX = /@jsx\s+(\S+)/u;
+// Does not check for reserved keywords or unicode characters
+const RE_JS_IDENTIFIER_REGEX = /^[$A-Z_a-z][\w$]*$/u;
+function getFragmentFromContext(context) {
+    // eslint-disable-next-line prefer-destructuring
+    const settings = context.settings;
+    const fragment = settings.react?.fragment;
+    if (isString(fragment) && RE_JS_IDENTIFIER_REGEX.test(fragment)) {
+        return fragment;
+    }
+    return "Fragment";
+}
+const getPragmaFromContext = memo((context)=>{
+    // eslint-disable-next-line prefer-destructuring
+    const settings = context.settings;
+    const sourceCode = context.getSourceCode();
+    const pragmaNode = sourceCode.getAllComments().find((node)=>RE_JSX_ANNOTATION_REGEX.test(node.value));
+    return effectFunction_esm.pipe(effectOption_esm.orElse(effectOption_esm.fromNullable(settings.react?.pragma), ()=>effectFunction_esm.pipe(effectOption_esm.fromNullable(pragmaNode), effectOption_esm.map(({ value })=>RE_JSX_ANNOTATION_REGEX.exec(value)), effectOption_esm.flatMapNullable((matches)=>matches?.[1]?.split(".")[0]))), effectOption_esm.flatMap(effectOption_esm.liftPredicate((x)=>RE_JS_IDENTIFIER_REGEX.test(x))), effectOption_esm.getOrElse(effectFunction_esm.constant("React")));
+});
+
 const t=Symbol.for("@ts-pattern/matcher"),e=Symbol.for("@ts-pattern/isVariadic"),n="@ts-pattern/anonymous-select-key",r=t=>Boolean(t&&"object"==typeof t),i=e=>e&&!!e[t],s=(n,o,c)=>{if(i(n)){const e=n[t](),{matched:r,selections:i}=e.match(o);return r&&i&&Object.keys(i).forEach(t=>c(t,i[t])),r}if(r(n)){if(!r(o))return !1;if(Array.isArray(n)){if(!Array.isArray(o))return !1;let t=[],r=[],a=[];for(const s of n.keys()){const o=n[s];i(o)&&o[e]?a.push(o):a.length?r.push(o):t.push(o);}if(a.length){if(a.length>1)throw new Error("Pattern error: Using `...P.array(...)` several times in a single pattern is not allowed.");if(o.length<t.length+r.length)return !1;const e=o.slice(0,t.length),n=0===r.length?[]:o.slice(-r.length),i=o.slice(t.length,0===r.length?Infinity:-r.length);return t.every((t,n)=>s(t,e[n],c))&&r.every((t,e)=>s(t,n[e],c))&&(0===a.length||s(a[0],i,c))}return n.length===o.length&&n.every((t,e)=>s(t,o[e],c))}return Object.keys(n).every(e=>{const r=n[e];return (e in o||i(a=r)&&"optional"===a[t]().matcherType)&&s(r,o[e],c);var a;})}return Object.is(o,n)},o=e=>{var n,s,a;return r(e)?i(e)?null!=(n=null==(s=(a=e[t]()).getSelectionKeys)?void 0:s.call(a))?n:[]:Array.isArray(e)?c(e,o):c(Object.values(e),o):[]},c=(t,e)=>t.reduce((t,n)=>t.concat(e(n)),[]);function a(...t){if(1===t.length){const[e]=t;return t=>s(e,t,()=>{})}if(2===t.length){const[e,n]=t;return s(e,n,()=>{})}throw new Error(`isMatching wasn't given the right number of arguments: expected 1 or 2, received ${t.length}.`)}function u(t){return Object.assign(t,{optional:()=>l(t),and:e=>m(t,e),or:e=>y(t,e),select:e=>void 0===e?p(t):p(e,t)})}function h(t){return Object.assign((t=>Object.assign(t,{*[Symbol.iterator](){yield Object.assign(t,{[e]:!0});}}))(t),{optional:()=>h(l(t)),select:e=>h(void 0===e?p(t):p(e,t))})}function l(e){return u({[t]:()=>({match:t=>{let n={};const r=(t,e)=>{n[t]=e;};return void 0===t?(o(e).forEach(t=>r(t,void 0)),{matched:!0,selections:n}):{matched:s(e,t,r),selections:n}},getSelectionKeys:()=>o(e),matcherType:"optional"})})}const f=(t,e)=>{for(const n of t)if(!e(n))return !1;return !0},g=(t,e)=>{for(const[n,r]of t.entries())if(!e(r,n))return !1;return !0};function m(...e){return u({[t]:()=>({match:t=>{let n={};const r=(t,e)=>{n[t]=e;};return {matched:e.every(e=>s(e,t,r)),selections:n}},getSelectionKeys:()=>c(e,o),matcherType:"and"})})}function y(...e){return u({[t]:()=>({match:t=>{let n={};const r=(t,e)=>{n[t]=e;};return c(e,o).forEach(t=>r(t,void 0)),{matched:e.some(e=>s(e,t,r)),selections:n}},getSelectionKeys:()=>c(e,o),matcherType:"or"})})}function d(e){return {[t]:()=>({match:t=>({matched:Boolean(e(t))})})}}function p(...e){const r="string"==typeof e[0]?e[0]:void 0,i=2===e.length?e[1]:"string"==typeof e[0]?void 0:e[0];return u({[t]:()=>({match:t=>{let e={[null!=r?r:n]:t};return {matched:void 0===i||s(i,t,(t,n)=>{e[t]=n;}),selections:e}},getSelectionKeys:()=>[null!=r?r:n].concat(void 0===i?[]:o(i))})})}function v(t){return "number"==typeof t}function b(t){return "string"==typeof t}function w(t){return "bigint"==typeof t}const S=u(d(function(t){return !0})),O=S,j=t=>Object.assign(u(t),{startsWith:e=>{return j(m(t,(n=e,d(t=>b(t)&&t.startsWith(n)))));var n;},endsWith:e=>{return j(m(t,(n=e,d(t=>b(t)&&t.endsWith(n)))));var n;},minLength:e=>j(m(t,(t=>d(e=>b(e)&&e.length>=t))(e))),maxLength:e=>j(m(t,(t=>d(e=>b(e)&&e.length<=t))(e))),includes:e=>{return j(m(t,(n=e,d(t=>b(t)&&t.includes(n)))));var n;},regex:e=>{return j(m(t,(n=e,d(t=>b(t)&&Boolean(t.match(n))))));var n;}}),E=j(d(b)),K=t=>Object.assign(u(t),{between:(e,n)=>K(m(t,((t,e)=>d(n=>v(n)&&t<=n&&e>=n))(e,n))),lt:e=>K(m(t,(t=>d(e=>v(e)&&e<t))(e))),gt:e=>K(m(t,(t=>d(e=>v(e)&&e>t))(e))),lte:e=>K(m(t,(t=>d(e=>v(e)&&e<=t))(e))),gte:e=>K(m(t,(t=>d(e=>v(e)&&e>=t))(e))),int:()=>K(m(t,d(t=>v(t)&&Number.isInteger(t)))),finite:()=>K(m(t,d(t=>v(t)&&Number.isFinite(t)))),positive:()=>K(m(t,d(t=>v(t)&&t>0))),negative:()=>K(m(t,d(t=>v(t)&&t<0)))}),A=K(d(v)),x=t=>Object.assign(u(t),{between:(e,n)=>x(m(t,((t,e)=>d(n=>w(n)&&t<=n&&e>=n))(e,n))),lt:e=>x(m(t,(t=>d(e=>w(e)&&e<t))(e))),gt:e=>x(m(t,(t=>d(e=>w(e)&&e>t))(e))),lte:e=>x(m(t,(t=>d(e=>w(e)&&e<=t))(e))),gte:e=>x(m(t,(t=>d(e=>w(e)&&e>=t))(e))),positive:()=>x(m(t,d(t=>w(t)&&t>0))),negative:()=>x(m(t,d(t=>w(t)&&t<0)))}),P=x(d(w)),T=u(d(function(t){return "boolean"==typeof t})),k=u(d(function(t){return "symbol"==typeof t})),B=u(d(function(t){return null==t}));var _={__proto__:null,matcher:t,optional:l,array:function(...e){return h({[t]:()=>({match:t=>{if(!Array.isArray(t))return {matched:!1};if(0===e.length)return {matched:!0};const n=e[0];let r={};if(0===t.length)return o(n).forEach(t=>{r[t]=[];}),{matched:!0,selections:r};const i=(t,e)=>{r[t]=(r[t]||[]).concat([e]);};return {matched:t.every(t=>s(n,t,i)),selections:r}},getSelectionKeys:()=>0===e.length?[]:o(e[0])})})},set:function(...e){return u({[t]:()=>({match:t=>{if(!(t instanceof Set))return {matched:!1};let n={};if(0===t.size)return {matched:!0,selections:n};if(0===e.length)return {matched:!0};const r=(t,e)=>{n[t]=(n[t]||[]).concat([e]);},i=e[0];return {matched:f(t,t=>s(i,t,r)),selections:n}},getSelectionKeys:()=>0===e.length?[]:o(e[0])})})},map:function(...e){return u({[t]:()=>({match:t=>{if(!(t instanceof Map))return {matched:!1};let n={};if(0===t.size)return {matched:!0,selections:n};const r=(t,e)=>{n[t]=(n[t]||[]).concat([e]);};if(0===e.length)return {matched:!0};var i;if(1===e.length)throw new Error(`\`P.map\` wasn't given enough arguments. Expected (key, value), received ${null==(i=e[0])?void 0:i.toString()}`);const[o,c]=e;return {matched:g(t,(t,e)=>{const n=s(o,e,r),i=s(c,t,r);return n&&i}),selections:n}},getSelectionKeys:()=>0===e.length?[]:[...o(e[0]),...o(e[1])]})})},intersection:m,union:y,not:function(e){return u({[t]:()=>({match:t=>({matched:!s(e,t,()=>{})}),getSelectionKeys:()=>[],matcherType:"not"})})},when:d,select:p,any:S,_:O,string:E,number:A,bigint:P,boolean:T,symbol:k,nullish:B,instanceOf:function(t){return u(d(function(t){return e=>e instanceof t}(t)))},shape:function(t){return u(d(a(t)))}};const W={matched:!1,value:void 0};function N(t){return new $(t,W)}class ${constructor(t,e){this.input=void 0,this.state=void 0,this.input=t,this.state=e;}with(...t){if(this.state.matched)return this;const e=t[t.length-1],r=[t[0]];let i;3===t.length&&"function"==typeof t[1]?(r.push(t[0]),i=t[1]):t.length>2&&r.push(...t.slice(1,t.length-1));let o=!1,c={};const a=(t,e)=>{o=!0,c[t]=e;},u=!r.some(t=>s(t,this.input,a))||i&&!Boolean(i(this.input))?W:{matched:!0,value:e(o?n in c?c[n]:c:this.input,this.input)};return new $(this.input,u)}when(t,e){if(this.state.matched)return this;const n=Boolean(t(this.input));return new $(this.input,n?{matched:!0,value:e(this.input,this.input)}:W)}otherwise(t){return this.state.matched?this.state.value:t(this.input)}exhaustive(){return this.run()}run(){if(this.state.matched)return this.state.value;let t;try{t=JSON.stringify(this.input);}catch(e){t=this.input;}throw new Error(`Pattern matching error: no pattern matches value ${t}`)}returnType(){return this}}
 
 function isPropertyOfPragma(name, context, pragma = getPragmaFromContext(context)) {
@@ -6665,6 +6676,21 @@ function isChildrenOfCreateElement(node, context) {
     return maybeCallExpression.arguments.slice(2).some((child)=>child === node);
 }
 
+/**
+ * Check if a node is a `JSXElement` of `User-Defined Component` type
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXElement` of `User-Defined Component` type
+ */ function isJSXElementOfUserDefinedComponent(node) {
+    return node.type === NodeType.JSXElement && node.openingElement.name.type === NodeType.JSXIdentifier && /^[A-Z]/u.test(node.openingElement.name.name);
+}
+/**
+ * Check if a node is a `JSXFragment` of `Built-in Component` type
+ * @param node The AST node to check
+ * @returns `true` if the node is a `JSXFragment` of `Built-in Component` type
+ */ function isJSXElementOfBuiltinComponent(node) {
+    return node.type === NodeType.JSXElement && node.openingElement.name.type === NodeType.JSXIdentifier && node.openingElement.name.name.toLowerCase() === node.openingElement.name.name && /^[a-z]/u.test(node.openingElement.name.name);
+}
+
 /**
  * Determines whether inside createElement's props.
  * @param node The AST node to check
@@ -6820,6 +6846,89 @@ const hdlWheel = [
     ...hdlWheel
 ];
 
+/**
+ * Check if a node is a Literal or JSXText
+ * @param node The AST node to check
+ * @returns boolean `true` if the node is a Literal or JSXText
+ */ const isLiteral = isOneOf([
+    NodeType.Literal,
+    NodeType.JSXText
+]);
+/**
+ * Check if a Literal or JSXText node is whitespace
+ * @param node The AST node to check
+ * @returns boolean `true` if the node is whitespace
+ */ function isWhiteSpace(node) {
+    return isString(node.value) && node.value.trim() === "";
+}
+/**
+ * Check if a Literal or JSXText node is a line break
+ * @param node The AST node to check
+ * @returns boolean
+ */ function isLineBreak(node) {
+    return isLiteral(node) && isWhiteSpace(node) && isMultiLine(node);
+}
+/**
+ * Check if a Literal or JSXText node is padding spaces
+ * @param node The AST node to check
+ * @returns boolean
+ */ function isPaddingSpaces(node) {
+    return isLiteral(node) && isWhiteSpace(node) && node.raw.includes("\n");
+}
+
+const isFragment = (node, pragma, fragment)=>{
+    if (!isOneOf([
+        NodeType.JSXElement,
+        NodeType.JSXFragment
+    ])(node)) {
+        return false;
+    }
+    return isFragmentSyntax(node) || isFragmentElement(node, pragma, fragment);
+};
+/**
+ * Check if a node is `<></>`
+ */ const isFragmentSyntax = is(NodeType.JSXFragment);
+/**
+ * Check if a node is `<Fragment></Fragment>` or `<Pragma.Fragment></Pragma.Fragment>`
+ * @param node
+ * @param pragma
+ * @param fragment
+ */ function isFragmentElement(node, pragma, fragment) {
+    const { name } = node.openingElement;
+    // <Fragment>
+    if (name.type === NodeType.JSXIdentifier && name.name === fragment) {
+        return true;
+    }
+    // <Pragma.Fragment>
+    return name.type === NodeType.JSXMemberExpression && name.object.type === NodeType.JSXIdentifier && name.object.name === pragma && name.property.name === fragment;
+}
+/**
+ * Check if a JSXElement or JSXFragment has only one literal child and is not a child
+ * @param node The AST node to check
+ * @returns `true` if the node has only one literal child and is not a child
+ * @example Somehow fragment like this is useful: <Foo content={<>ee eeee eeee ...</>} />
+ */ function isFragmentWithOnlyTextAndIsNotChild(node) {
+    return node.children.length === 1 && isLiteral(node.children[0]) && !(node.parent.type === NodeType.JSXElement || node.parent.type === NodeType.JSXFragment);
+}
+function containsCallExpression(node) {
+    return node.type === NodeType.JSXExpressionContainer && node.expression.type === NodeType.CallExpression;
+}
+/**
+ * Check if a JSXElement or JSXFragment has less than two non-padding children and the first child is not a call expression
+ * @param node The AST node to check
+ * @returns boolean
+ */ function isFragmentHasLessThanTwoChildren(node) {
+    const nonPaddingChildren = node.children.filter((child)=>!isPaddingSpaces(child));
+    if (nonPaddingChildren.length === 1) {
+        return !containsCallExpression(nonPaddingChildren[0]);
+    }
+    return nonPaddingChildren.length === 0;
+}
+function isFragmentWithSingleExpression(node) {
+    const children = node.children.filter((child)=>!isPaddingSpaces(child));
+    return children.length === 1 && children[0]?.type === NodeType.JSXExpressionContainer;
+}
+
 const defaultJSXValueCheckOptions = {
     ignoreNull: false,
     strict: false
@@ -6869,7 +6978,7 @@ const defaultJSXValueCheckOptions = {
         if (isJSXTagNameExpression(node)) {
             return true;
         }
-        if (!isString$1(node.name) && node.name.type !== NodeType.Identifier) {
+        if (!isString(node.name) && node.name.type !== NodeType.Identifier) {
             return isJSXTagNameExpression(node.name);
         }
         const name = N(node.name).with(_.string, effectFunction_esm.identity).with({
@@ -7051,27 +7160,4 @@ const defaultJSXValueCheckOptions = {
     return effectOption_esm.some(getStaticValue(argument, scope));
 }
 
-/**
- * Check if a node is a Literal or JSXText
- * @param node The AST node to check
- * @returns boolean `true` if the node is a Literal or JSXText
- */ const isLiteral = isOneOf([
-    NodeType.Literal,
-    NodeType.JSXText
-]);
-/**
- * Check if a Literal or JSXText node is whitespace
- * @param node The AST node to check
- * @returns boolean `true` if the node is whitespace
- */ function isWhiteSpace(node) {
-    return isString$1(node.value) && node.value.trim() === "";
-}
-/**
- * Check if a Literal or JSXText node is a line break
- * @param node The AST node to check
- * @returns boolean
- */ function isLineBreak(node) {
-    return isLiteral(node) && isWhiteSpace(node) && isMultiLine(node);
-}
-
-export { defaultJSXValueCheckOptions, elementType, findPropInAttributes, findPropInProperties, getFragmentFromContext, getPragmaFromContext, getPropName, getPropNameWithNamespace, getPropValue, hasAnyProp, hasChildren, hasEveryProp, hasProp, hdlAnimation, hdlClipboard, hdlComposition, hdlFocus, hdlForm, hdlImage, hdlKeyboard, hdlMedia, hdlMouse, hdlScroll, hdlSelection, hdlTouch, hdlTransition, hdlWheel, isCallFromPragma, isChildrenOfCreateElement, isCloneElementCall, isCreateElementCall, isFunctionReturningJSXValue, isInitializedFromPragma, isInsideCreateElementProps, isInsidePropValue, isJSXValue, isLineBreak, isLiteral, isPropertyOfPragma, isWhiteSpace, traverseUpProp };
+export { defaultJSXValueCheckOptions, elementType, findPropInAttributes, findPropInProperties, getFragmentFromContext, getPragmaFromContext, getPropName, getPropNameWithNamespace, getPropValue, hasAnyProp, hasChildren, hasEveryProp, hasProp, hdlAnimation, hdlClipboard, hdlComposition, hdlFocus, hdlForm, hdlImage, hdlKeyboard, hdlMedia, hdlMouse, hdlScroll, hdlSelection, hdlTouch, hdlTransition, hdlWheel, isCallFromPragma, isChildOfJSXElement, isChildrenOfCreateElement, isCloneElementCall, isCreateElementCall, isFragment, isFragmentElement, isFragmentHasLessThanTwoChildren, isFragmentSyntax, isFragmentWithOnlyTextAndIsNotChild, isFragmentWithSingleExpression, isFunctionReturningJSXValue, isInitializedFromPragma, isInsideCreateElementProps, isInsidePropValue, isJSXElementOfBuiltinComponent, isJSXElementOfUserDefinedComponent, isJSXValue, isLineBreak, isLiteral, isPaddingSpaces, isPropertyOfPragma, isWhiteSpace, traverseUpProp };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint-react/jsx",
-  "version": "0.5.8",
+  "version": "0.5.9",
   "description": "AST Utility Module for Static Analysis of JSX",
   "homepage": "https://github.com/Rel1cx/eslint-react",
   "bugs": {
@@ -40,10 +40,10 @@
     "micro-memoize": "4.1.2"
   },
   "devDependencies": {
-    "@eslint-react/ast": "0.5.8",
-    "@eslint-react/types": "0.5.8",
-    "@eslint-react/tools": "0.5.8",
-    "@eslint-react/shared": "0.5.8"
+    "@eslint-react/shared": "0.5.9",
+    "@eslint-react/types": "0.5.9",
+    "@eslint-react/ast": "0.5.9",
+    "@eslint-react/tools": "0.5.9"
   },
   "scripts": {
     "build": "rollup -c rollup.config.ts --configPlugin swc3 && cp dist/index.d.ts dist/index.d.mts",