@elastic/eslint-plugin-eui 2.15.0 → 2.16.0

package/lib/esm/rules/no_deprecated_icon_aliases.js

@@ -0,0 +1,307 @@
+"use strict";
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoDeprecatedIconAliases = exports.DEPRECATED_ICONS_WITHOUT_REPLACEMENT = exports.DEPRECATED_ICON_ALIASES = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+exports.DEPRECATED_ICON_ALIASES = {
+    alert: 'warning',
+    anomalyChart: 'chartAnomaly',
+    apmTrace: 'chartWaterfall',
+    arrowDown: 'chevronSingleDown',
+    arrowEnd: 'chevronLimitRight',
+    arrowLeft: 'chevronSingleLeft',
+    arrowRight: 'chevronSingleRight',
+    arrowStart: 'chevronLimitLeft',
+    arrowUp: 'chevronSingleUp',
+    beaker: 'flask',
+    boxesHorizontal: 'ellipsis',
+    boxesVertical: 'ellipsis',
+    changePointDetection: 'chartChangePoint',
+    checkInCircleFilled: 'checkCircleFill',
+    cheer: 'popper',
+    color: 'paintBucket',
+    compute: 'processor',
+    console: 'commandLine',
+    contrastHigh: 'contrastFill',
+    controlsHorizontal: 'controls',
+    controlsVertical: 'controls',
+    copyClipboard: 'copy',
+    crossInCircle: 'crossCircle',
+    crosshairs: 'crosshair',
+    currency: 'money',
+    cut: 'scissors',
+    desktop: 'display',
+    diff: 'compare',
+    discuss: 'comment',
+    documentEdit: 'pencil',
+    documents: 'document',
+    doubleArrowLeft: 'chevronDoubleLeft',
+    doubleArrowRight: 'chevronDoubleRight',
+    editorAlignCenter: 'textAlignCenter',
+    editorAlignLeft: 'textAlignLeft',
+    editorAlignRight: 'textAlignRight',
+    editorBold: 'textBold',
+    editorChecklist: 'listCheck',
+    editorCodeBlock: 'code',
+    editorComment: 'comment',
+    editorDistributeHorizontal: 'distributeHorizontal',
+    editorDistributeVertical: 'distributeVertical',
+    editorHeading: 'textHeading',
+    editorItalic: 'textItalic',
+    editorItemAlignBottom: 'alignBottom',
+    editorItemAlignCenter: 'alignCenterHorizontal',
+    editorItemAlignLeft: 'alignLeft',
+    editorItemAlignMiddle: 'alignCenterVertical',
+    editorItemAlignRight: 'alignRight',
+    editorItemAlignTop: 'alignTop',
+    editorLink: 'link',
+    editorOrderedList: 'listNumber',
+    editorPositionBottomLeft: 'alignBottomLeft',
+    editorPositionBottomRight: 'alignBottomRight',
+    editorPositionTopLeft: 'alignTopLeft',
+    editorPositionTopRight: 'alignTopRight',
+    editorRedo: 'redo',
+    editorStrike: 'textStrike',
+    editorTable: 'table',
+    editorUnderline: 'textUnderline',
+    editorUndo: 'undo',
+    editorUnorderedList: 'listBullet',
+    email: 'mail',
+    eql: 'query',
+    errorFilled: 'errorFill',
+    exit: 'logOut',
+    expand: 'maximize',
+    expandMini: 'maximize',
+    export: 'upload',
+    exportAction: 'upload',
+    eyeClosed: 'eyeSlash',
+    fieldStatistics: 'tableInfo',
+    filterInCircle: 'filter',
+    folderCheck: 'check',
+    folderOpened: 'folderOpen',
+    glasses: 'readOnly',
+    grab: 'dragVertical',
+    grabHorizontal: 'dragHorizontal',
+    grabOmnidirectional: 'drag',
+    heatmap: 'chartHeatmap',
+    importAction: 'download',
+    indexClose: 'tableCross',
+    indexEdit: 'tablePencil',
+    indexFlush: 'chartThreshold',
+    indexMapping: 'mapping',
+    indexOpen: 'tablePlus',
+    indexRuntime: 'tablePlay',
+    indexSettings: 'tableGear',
+    indexTemporary: 'tableTime',
+    invert: 'contrast',
+    kqlField: 'queryField',
+    kqlOperand: 'queryOperand',
+    kqlSelector: 'querySelector',
+    kqlValue: 'queryValue',
+    kubernetesPod: 'cube',
+    launch: 'rocket',
+    lettering: 'text',
+    lineDashed: 'lineDash',
+    lineDotted: 'lineDot',
+    list: 'listBullet',
+    listAdd: 'plusCircle',
+    logPatternAnalysis: 'pattern',
+    logRateAnalysis: 'chartBarVertical',
+    logstashIf: 'if',
+    logstashQueue: 'queue',
+    magnifyWithExclamation: 'magnifyExclamation',
+    magnifyWithMinus: 'magnifyMinus',
+    magnifyWithPlus: 'magnifyPlus',
+    mapMarker: 'waypoint',
+    minusInCircle: 'minusCircle',
+    minusInCircleFilled: 'minusCircle',
+    minusInSquare: 'minusSquare',
+    newChat: 'plusCircle',
+    node: 'vectorTriangle',
+    offline: 'wifiSlash',
+    online: 'wifi',
+    pagesSelect: 'documentsCheck',
+    pinFilled: 'pinFill',
+    pipeBreaks: 'lineBreak',
+    pipeNoBreaks: 'lineBreakSlash',
+    playFilled: 'play',
+    plusInCircle: 'plusCircle',
+    plusInCircleFilled: 'plusCircle',
+    plusInSquare: 'plusSquare',
+    popout: 'external',
+    productRobot: 'productAgent',
+    push: 'send',
+    returnKey: 'return',
+    search: 'magnify',
+    securitySignal: 'radar',
+    starEmpty: 'star',
+    starFilled: 'starFill',
+    starFilledSpace: 'starFillSpace',
+    starMinusFilled: 'starMinusFill',
+    starPlusFilled: 'starPlusFill',
+    stopFilled: 'stopFill',
+    streamsClassic: 'productStreamsClassic',
+    streamsWired: 'productStreamsWired',
+    submodule: 'merge',
+    tableDensityCompact: 'tableDensityHigh',
+    tableDensityExpanded: 'tableDensityLow',
+    tableDensityNormal: 'table',
+    temperature: 'thermometer',
+    timeRefresh: 'refreshTime',
+    timelineWithArrow: 'timelinePointer',
+    timeslider: 'clockControl',
+    tokenDenseVector: 'tokenVectorDense',
+    training: 'presentation',
+    unlink: 'linkSlash',
+    userAvatar: 'user',
+    vector: 'vectorSquare',
+    visArea: 'chartArea',
+    visAreaStacked: 'chartAreaStack',
+    visBarHorizontal: 'chartBarHorizontal',
+    visBarHorizontalStacked: 'chartBarHorizontalStack',
+    visBarVertical: 'chartBarVertical',
+    visBarVerticalStacked: 'chartBarVerticalStack',
+    visGauge: 'chartGauge',
+    visLine: 'chartLine',
+    visMapCoordinate: 'waypoint',
+    visMapRegion: 'map',
+    visMetric: 'chartMetric',
+    visPie: 'chartPie',
+    visTable: 'table',
+    visTagCloud: 'chartTagCloud',
+    visText: 'text',
+    visVega: 'code',
+    warningFilled: 'warningFill',
+};
+exports.DEPRECATED_ICONS_WITHOUT_REPLACEMENT = new Set(['mobile']);
+const getComponentName = (node) => node.name.type === 'JSXIdentifier' ? node.name.name : undefined;
+const COMPONENT_ICON_ATTRIBUTES = {
+    EuiCommentTimeline: new Set(['timelineAvatar']),
+    EuiFormAppend: new Set(['iconLeft', 'iconRight']),
+    EuiFormAppendPrepend: new Set(['iconLeft', 'iconRight']),
+    EuiFormPrepend: new Set(['iconLeft', 'iconRight']),
+    EuiLoadingLogo: new Set(['logo']),
+    EuiTimelineItem: new Set(['icon']),
+};
+const isIconAttribute = (attributeName, importedComponentName) => {
+    const normalizedName = attributeName.toLowerCase();
+    return (normalizedName.endsWith('icontype') ||
+        COMPONENT_ICON_ATTRIBUTES[importedComponentName]?.has(attributeName) ===
+            true ||
+        (normalizedName === 'type' &&
+            (importedComponentName === 'EuiIcon' ||
+                importedComponentName === 'EuiIconTip')));
+};
+const getStaticStringNode = (node) => {
+    if (node.value?.type === 'Literal' && typeof node.value.value === 'string') {
+        return node.value;
+    }
+    if (node.value?.type !== 'JSXExpressionContainer') {
+        return;
+    }
+    const { expression } = node.value;
+    if (expression.type === 'Literal' && typeof expression.value === 'string') {
+        return expression;
+    }
+    if (expression.type === 'TemplateLiteral' &&
+        expression.expressions.length === 0) {
+        return expression;
+    }
+};
+const getStaticStringValue = (node) => {
+    if (node.type === 'Literal') {
+        return typeof node.value === 'string' ? node.value : undefined;
+    }
+    return node.quasis[0]?.value.cooked ?? undefined;
+};
+const isDeprecatedIconAlias = (value) => value in exports.DEPRECATED_ICON_ALIASES;
+exports.NoDeprecatedIconAliases = utils_1.ESLintUtils.RuleCreator.withoutDocs({
+    create(context) {
+        const euiComponentImports = new Map();
+        return {
+            ImportDeclaration(node) {
+                if (typeof node.source.value !== 'string' ||
+                    (node.source.value !== '@elastic/eui' &&
+                        !node.source.value.startsWith('@elastic/eui/'))) {
+                    return;
+                }
+                for (const specifier of node.specifiers) {
+                    if (specifier.type !== 'ImportSpecifier') {
+                        continue;
+                    }
+                    const importedName = specifier.imported.type === 'Identifier'
+                        ? specifier.imported.name
+                        : specifier.imported.value;
+                    if (importedName.startsWith('Eui')) {
+                        euiComponentImports.set(specifier.local.name, importedName);
+                    }
+                }
+            },
+            JSXAttribute(node) {
+                if (node.name.type !== 'JSXIdentifier') {
+                    return;
+                }
+                const openingElement = node.parent;
+                const localComponentName = openingElement.type === 'JSXOpeningElement'
+                    ? getComponentName(openingElement)
+                    : undefined;
+                const importedComponentName = localComponentName
+                    ? euiComponentImports.get(localComponentName)
+                    : undefined;
+                if (!importedComponentName ||
+                    !isIconAttribute(node.name.name, importedComponentName)) {
+                    return;
+                }
+                const staticStringNode = getStaticStringNode(node);
+                if (!staticStringNode) {
+                    return;
+                }
+                const iconType = getStaticStringValue(staticStringNode);
+                if (!iconType) {
+                    return;
+                }
+                if (!isDeprecatedIconAlias(iconType)) {
+                    if (exports.DEPRECATED_ICONS_WITHOUT_REPLACEMENT.has(iconType)) {
+                        context.report({
+                            node: staticStringNode,
+                            messageId: 'deprecatedIcon',
+                            data: { iconType },
+                        });
+                    }
+                    return;
+                }
+                const replacement = exports.DEPRECATED_ICON_ALIASES[iconType];
+                context.report({
+                    node: staticStringNode,
+                    messageId: 'deprecatedIconAlias',
+                    data: { alias: iconType, replacement },
+                    fix(fixer) {
+                        const sourceText = context.sourceCode.getText(staticStringNode);
+                        const quote = sourceText[0];
+                        return fixer.replaceText(staticStringNode, `${quote}${replacement}${quote}`);
+                    },
+                });
+            },
+        };
+    },
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: 'Disallow deprecated EUI icons in JSX icon props.',
+        },
+        fixable: 'code',
+        schema: [],
+        messages: {
+            deprecatedIcon: 'Icon `{{iconType}}` is deprecated and has no direct replacement.',
+            deprecatedIconAlias: 'Icon alias `{{alias}}` is deprecated. Use `{{replacement}}` instead.',
+        },
+    },
+    defaultOptions: [],
+});
+//# sourceMappingURL=no_deprecated_icon_aliases.js.map

package/lib/esm/rules/no_deprecated_icon_aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no_deprecated_icon_aliases.js","sourceRoot":"","sources":["../../../src/rules/no_deprecated_icon_aliases.ts"],"names":[],"mappings":"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"}

package/lib/esm/utils/flat_map.d.ts

@@ -0,0 +1 @@
+export declare function flatMap<T, U>(arr: readonly T[], fn: (item: T) => U[]): U[];

package/lib/esm/utils/flat_map.js

@@ -0,0 +1,22 @@
+"use strict";
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flatMap = flatMap;
+// `Array.prototype.flatMap` requires ES2019 lib; this shim keeps rules that
+// need it within the package's es5 lib setting without widening it for others.
+function flatMap(arr, fn) {
+    const out = [];
+    for (const item of arr) {
+        const items = fn(item);
+        for (const i of items)
+            out.push(i);
+    }
+    return out;
+}
+//# sourceMappingURL=flat_map.js.map

package/lib/esm/utils/flat_map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flat_map.js","sourceRoot":"","sources":["../../../src/utils/flat_map.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAIH,0BAOC;AATD,4EAA4E;AAC5E,+EAA+E;AAC/E,SAAgB,OAAO,CAAO,GAAiB,EAAE,EAAoB;IACnE,MAAM,GAAG,GAAQ,EAAE,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib/esm/utils/has_meaningful_attr.d.ts

@@ -0,0 +1,19 @@
+import type { TSESTree } from '@typescript-eslint/utils';
+/**
+ * Checks whether a JSX opening element has an attribute whose value is
+ * statically "meaningful" — present and not a statically-known empty/falsy
+ * value (`""`, `{''}`, `{0}`, `{false}`, `{null}`, `{undefined}`).
+ *
+ * Dynamic or otherwise non-statically-analyzable values (variables, JSX,
+ * template literals, calls, …) are treated as meaningful, since their runtime
+ * value is unknown. Boolean shorthand (`<El attr />`) is also meaningful.
+ *
+ * Useful for rules that must distinguish an attribute that actually renders
+ * something from one that is present but effectively empty.
+ *
+ * @param openingElement - The `JSXOpeningElement` node (ESTree).
+ * @param attrName - The attribute name to look up.
+ * @returns `true` if the attribute is present with a non-empty/non-falsy or
+ * dynamic value; otherwise `false`.
+ */
+export declare function hasMeaningfulAttr(openingElement: TSESTree.JSXOpeningElement, attrName: string): boolean;

package/lib/esm/utils/has_meaningful_attr.js

@@ -0,0 +1,55 @@
+"use strict";
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasMeaningfulAttr = hasMeaningfulAttr;
+/**
+ * Checks whether a JSX opening element has an attribute whose value is
+ * statically "meaningful" — present and not a statically-known empty/falsy
+ * value (`""`, `{''}`, `{0}`, `{false}`, `{null}`, `{undefined}`).
+ *
+ * Dynamic or otherwise non-statically-analyzable values (variables, JSX,
+ * template literals, calls, …) are treated as meaningful, since their runtime
+ * value is unknown. Boolean shorthand (`<El attr />`) is also meaningful.
+ *
+ * Useful for rules that must distinguish an attribute that actually renders
+ * something from one that is present but effectively empty.
+ *
+ * @param openingElement - The `JSXOpeningElement` node (ESTree).
+ * @param attrName - The attribute name to look up.
+ * @returns `true` if the attribute is present with a non-empty/non-falsy or
+ * dynamic value; otherwise `false`.
+ */
+function hasMeaningfulAttr(openingElement, attrName) {
+    const attr = openingElement.attributes.find((a) => a.type === 'JSXAttribute' &&
+        a.name.type === 'JSXIdentifier' &&
+        a.name.name === attrName);
+    if (!attr)
+        return false;
+    // Boolean shorthand: `<El attr />` → present and truthy.
+    if (attr.value == null)
+        return true;
+    // String literal: `attr="…"`.
+    if (attr.value.type === 'Literal') {
+        return Boolean(attr.value.value);
+    }
+    if (attr.value.type === 'JSXExpressionContainer') {
+        const { expression } = attr.value;
+        // Statically-known literals: `{''}`, `{0}`, `{false}`, `{null}`.
+        if (expression.type === 'Literal') {
+            return Boolean(expression.value);
+        }
+        // `{undefined}` (an identifier, not a literal).
+        if (expression.type === 'Identifier' && expression.name === 'undefined') {
+            return false;
+        }
+    }
+    // Dynamic / unknown value → treat as present.
+    return true;
+}
+//# sourceMappingURL=has_meaningful_attr.js.map

package/lib/esm/utils/has_meaningful_attr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has_meaningful_attr.js","sourceRoot":"","sources":["../../../src/utils/has_meaningful_attr.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAqBH,8CAqCC;AAtDD;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,iBAAiB,CAC/B,cAA0C,EAC1C,QAAgB;IAEhB,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,IAAI,CACzC,CAAC,CAAC,EAA8B,EAAE,CAChC,CAAC,CAAC,IAAI,KAAK,cAAc;QACzB,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe;QAC/B,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAC3B,CAAC;IAEF,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAExB,yDAAyD;IACzD,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAEpC,8BAA8B;IAC9B,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;QACjD,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAElC,iEAAiE;QACjE,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,gDAAgD;QAChD,IAAI,UAAU,CAAC,IAAI,KAAK,YAAY,IAAI,UAAU,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACxE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/esm/utils/is_fragment.d.ts

@@ -0,0 +1,7 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+/**
+ * Returns true if the opening element is a React fragment: `<Fragment>` or
+ * `<React.Fragment>`. The `<>` shorthand is represented as a `JSXFragment`
+ * node (not a `JSXOpeningElement`) and is handled separately by callers.
+ */
+export declare function isFragment(opening: TSESTree.JSXOpeningElement): boolean;

package/lib/esm/utils/is_fragment.js

@@ -0,0 +1,26 @@
+"use strict";
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFragment = isFragment;
+/**
+ * Returns true if the opening element is a React fragment: `<Fragment>` or
+ * `<React.Fragment>`. The `<>` shorthand is represented as a `JSXFragment`
+ * node (not a `JSXOpeningElement`) and is handled separately by callers.
+ */
+function isFragment(opening) {
+    const { name } = opening;
+    if (name.type === 'JSXIdentifier' && name.name === 'Fragment')
+        return true;
+    return (name.type === 'JSXMemberExpression' &&
+        name.object.type === 'JSXIdentifier' &&
+        name.object.name === 'React' &&
+        name.property.type === 'JSXIdentifier' &&
+        name.property.name === 'Fragment');
+}
+//# sourceMappingURL=is_fragment.js.map

package/lib/esm/utils/is_fragment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_fragment.js","sourceRoot":"","sources":["../../../src/utils/is_fragment.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AASH,gCAUC;AAfD;;;;GAIG;AACH,SAAgB,UAAU,CAAC,OAAmC;IAC5D,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC3E,OAAO,CACL,IAAI,CAAC,IAAI,KAAK,qBAAqB;QACnC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,eAAe;QACpC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO;QAC5B,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,eAAe;QACtC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU,CAClC,CAAC;AACJ,CAAC"}

package/lib/esm/utils/walk_jsx_children.d.ts

@@ -0,0 +1,29 @@
+import { type TSESTree, type TSESLint } from '@typescript-eslint/utils';
+/**
+ * Recursively walks JSX children, expanding structural nodes transparently
+ * and calling `visit` for each content node.
+ *
+ * Always expanded (structural nodes):
+ *  - `<>...</>`, `<Fragment>`, `<React.Fragment>` (transparent grouping)
+ *  - `{expr}`                              (JSXExpressionContainer)
+ *  - `{a && b}`, `{a || b}`, `{a ?? b}`   (LogicalExpression → both sides)
+ *  - `{c ? a : b}`                         (ConditionalExpression → both branches)
+ *  - `{[a, b]}`                            (ArrayExpression → each element)
+ *  - `{(arg) => <El />}`                   (ArrowFunctionExpression)
+ *  - `{arr.map(fn)}`                       (CallExpression `.map()` with arrow-fn callback)
+ *
+ * With `options.sourceCode`: Identifiers and local arrow-fn components are
+ * also expanded via scope lookup when resolvable.
+ *
+ * `options.shouldSkip` - when provided, called for each JSXElement reached
+ * (after fragment and local-component checks). Returning true skips the
+ * element itself and recurses into its children instead. Use this to make
+ * layout wrappers or non-interactive shells transparent to the visitor.
+ *
+ * `visit` is called for leaf nodes: JSXElement, JSXText, Literal,
+ * TemplateLiteral, MemberExpression.
+ */
+export declare function walkJsxChildren(node: TSESTree.Node, visit: (node: TSESTree.Node) => void, options?: {
+    sourceCode?: TSESLint.SourceCode;
+    shouldSkip?: (el: TSESTree.JSXElement) => boolean;
+}): void;