[ { "path": ".browserslistrc", "content": "# `npx browserslist --mobile-to-desktop \"baseline widely available\"` when the last major is released.\n# On update, sync references where \"#stable-snapshot\" is mentioned in the codebase.\n[stable]\nand_chr 141\nand_chr 140\nand_chr 139\nand_chr 138\nand_chr 137\nand_chr 136\nand_chr 135\nand_chr 134\nand_chr 133\nand_chr 132\nand_chr 131\nand_chr 130\nand_chr 129\nand_chr 128\nand_chr 127\nand_chr 126\nand_chr 125\nand_chr 124\nand_chr 123\nand_chr 122\nand_chr 121\nand_chr 120\nand_chr 119\nand_chr 118\nand_chr 117\nand_chr 116\nand_chr 115\nand_chr 114\nand_chr 113\nand_chr 112\nand_chr 111\nand_ff 144\nand_ff 143\nand_ff 142\nand_ff 141\nand_ff 140\nand_ff 139\nand_ff 138\nand_ff 137\nand_ff 136\nand_ff 135\nand_ff 134\nand_ff 133\nand_ff 132\nand_ff 131\nand_ff 130\nand_ff 129\nand_ff 128\nand_ff 127\nand_ff 126\nand_ff 125\nand_ff 124\nand_ff 123\nand_ff 122\nand_ff 121\nand_ff 120\nand_ff 119\nand_ff 118\nand_ff 117\nand_ff 116\nand_ff 115\nand_ff 114\nand_ff 113\nchrome 141\nchrome 140\nchrome 139\nchrome 138\nchrome 137\nchrome 136\nchrome 135\nchrome 134\nchrome 133\nchrome 132\nchrome 131\nchrome 130\nchrome 129\nchrome 128\nchrome 127\nchrome 126\nchrome 125\nchrome 124\nchrome 123\nchrome 122\nchrome 121\nchrome 120\nchrome 119\nchrome 118\nchrome 117\nchrome 116\nchrome 115\nchrome 114\nchrome 113\nchrome 112\nchrome 111\nedge 141\nedge 140\nedge 139\nedge 138\nedge 137\nedge 136\nedge 135\nedge 134\nedge 133\nedge 132\nedge 131\nedge 130\nedge 129\nedge 128\nedge 127\nedge 126\nedge 125\nedge 124\nedge 123\nedge 122\nedge 121\nedge 120\nedge 119\nedge 118\nedge 117\nedge 116\nedge 115\nedge 114\nedge 113\nedge 112\nedge 111\nfirefox 144\nfirefox 143\nfirefox 142\nfirefox 141\nfirefox 140\nfirefox 139\nfirefox 138\nfirefox 137\nfirefox 136\nfirefox 135\nfirefox 134\nfirefox 133\nfirefox 132\nfirefox 131\nfirefox 130\nfirefox 129\nfirefox 128\nfirefox 127\nfirefox 126\nfirefox 125\nfirefox 124\nfirefox 123\nfirefox 122\nfirefox 121\nfirefox 120\nfirefox 119\nfirefox 118\nfirefox 117\nfirefox 116\nfirefox 115\nfirefox 114\nfirefox 113\nios_saf 26.0\nios_saf 18.5-18.6\nios_saf 18.4\nios_saf 18.3\nios_saf 18.2\nios_saf 18.1\nios_saf 18.0\nios_saf 17.6-17.7\nios_saf 17.5\nios_saf 17.4\nios_saf 17.3\nios_saf 17.2\nios_saf 17.1\nios_saf 17.0\nios_saf 16.6-16.7\nios_saf 16.5\nios_saf 16.4\nsafari 26.0\nsafari 18.5-18.6\nsafari 18.4\nsafari 18.3\nsafari 18.2\nsafari 18.1\nsafari 18.0\nsafari 17.6\nsafari 17.5\nsafari 17.4\nsafari 17.3\nsafari 17.2\nsafari 17.1\nsafari 17.0\nsafari 16.6\nsafari 16.5\nsafari 16.4\n\n# snapshot of `npx browserslist \"maintained node versions\"`\n# On update check all #stable-snapshot markers\n[node]\nnode 25.0.0\nnode 24.10.0\nnode 22.21.0\nnode 20.19.0\n\n# same as `node`\n[coverage]\nnode 25.0.0\nnode 24.10.0\nnode 22.21.0\nnode 20.19.0\n\n# same as `node`\n[development]\nnode 25.0.0\nnode 24.10.0\nnode 22.21.0\nnode 20.19.0\n\n# same as `node`\n[test]\nnode 25.0.0\nnode 24.10.0\nnode 22.21.0\nnode 20.19.0\n" }, { "path": ".circleci/config.yml", "content": "version: 2.1\n\norbs:\n code-infra: https://raw.githubusercontent.com/mui/mui-public/f544b55fdbbb922b7293365705cf62895b4f5186/.circleci/orbs/code-infra.yml\n\nparameters:\n browserstack-force:\n description: Whether to force browserstack usage. We have limited resources on browserstack so the pipeline might decide to skip browserstack if this parameter isn't set to true.\n type: boolean\n default: false\n react-version:\n description: The version of react to be used\n type: string\n default: stable\n workflow:\n description: The name of the workflow to run\n type: string\n default: pipeline\n\ndefault-job: &default-job\n parameters:\n react-version:\n description: The version of react to be used\n type: string\n default: << pipeline.parameters.react-version >>\n resource_class: medium\n environment:\n # expose it globally otherwise we have to thread it from each job to the install command\n BROWSERSTACK_FORCE: << pipeline.parameters.browserstack-force >>\n COREPACK_ENABLE_DOWNLOAD_PROMPT: '0'\n working_directory: /tmp/base-ui\n executor: code-infra/mui-node\n\ndefault-context: &default-context\n context:\n - org-global\n\n# CircleCI has disabled the cache across forks for security reasons.\n# Following their official statement, it was a quick solution, they\n# are working on providing this feature back with appropriate security measures.\n# https://discuss.circleci.com/t/saving-cache-stopped-working-warning-skipping-this-step-disabled-in-configuration/24423/21\n#\n# restore_repo: &restore_repo\n# restore_cache:\n# key: v1-repo-{{ .Branch }}-{{ .Revision }}\n\ncommands:\n build-with-compiler:\n description: 'Build packages with React Compiler'\n steps:\n - run:\n name: Add compiler package\n command: pnpm -F \"./packages/*\" add react-compiler-runtime\n - run:\n name: Build with compiler\n command: pnpm -F \"./packages/*\" build --enableReactCompiler\n environment:\n MUI_REACT_COMPILER_MODE: 'infer'\n\njobs:\n test_unit:\n <<: *default-job\n resource_class: large\n steps:\n - checkout\n - code-infra/install-deps:\n package-overrides: react@<< parameters.react-version >>\n - run:\n name: Run tests on JSDOM\n command: pnpm test:jsdom\n - store_test_results:\n path: test-results\n docs_validate:\n <<: *default-job\n steps:\n - checkout\n - code-infra/install-deps\n - run:\n name: Validate the documentation files\n command: pnpm docs:validate\n test_lint:\n <<: *default-job\n steps:\n - checkout\n - code-infra/install-deps\n - code-infra/run-linters\n test_static:\n <<: *default-job\n steps:\n - checkout\n - code-infra/install-deps\n - code-infra/check-static-changes\n - run:\n name: Generate the documentation\n command: pnpm docs:api\n - run:\n name: '`pnpm docs:api` changes committed?'\n command: git add -A && git diff --exit-code --staged\n - run:\n name: '`pnpm extract-error-codes` changes committed?'\n command: |\n pnpm extract-error-codes\n git add -A && git diff --exit-code --staged\n - run:\n name: '`pnpm inline-scripts` changes committed?'\n command: |\n pnpm inline-scripts\n git add -A && git diff --exit-code --staged\n test_types:\n <<: *default-job\n resource_class: 'medium+'\n steps:\n - checkout\n - code-infra/install-deps:\n package-overrides: react@<< parameters.react-version >>\n - run:\n name: Tests TypeScript definitions\n command: pnpm typescript\n environment:\n NODE_OPTIONS: --max-old-space-size=3072\n - run:\n name: Any defect declaration files?\n command: pnpm code-infra validate-built-types\n - save_cache:\n name: Save generated declaration files\n key: typescript-declaration-files-{{ .Branch }}-{{ .Revision }}\n paths:\n # packages with generated declaration files\n - packages/react/build\n test_types_next:\n <<: *default-job\n resource_class: 'medium+'\n steps:\n - checkout\n - code-infra/install-deps:\n package-overrides: typescript@next\n - run:\n name: Tests TypeScript definitions\n command: pnpm typescript\n - restore_cache:\n name: Restore generated declaration files\n keys:\n # We assume that the target branch is `master` and that declaration files are persisted in commit order.\n # \"If there are multiple matches, the most recently generated cache will be used.\"\n - typescript-declaration-files-master\n - run:\n name: Log defect declaration files\n command: |\n # ignore build failures\n # Fixing these takes some effort that isn't viable to merge in a single PR.\n # We'll simply monitor them for now.\n set +e\n pnpm code-infra validate-built-types\n exit 0\n test_browser:\n <<: *default-job\n resource_class: large\n executor:\n name: code-infra/mui-node-browser\n playwright-img-version: v1.58.2-noble\n steps:\n - checkout\n - code-infra/install-deps:\n package-overrides: react@<< parameters.react-version >>\n - run:\n name: Run tests on headless Chromium\n command: pnpm test:chromium\n - store_test_results:\n path: test-results\n test_regressions:\n <<: *default-job\n resource_class: 'medium+'\n executor:\n name: code-infra/mui-node-browser\n playwright-img-version: v1.58.2-noble\n steps:\n - checkout\n - code-infra/install-deps\n - run:\n name: Run visual regression tests\n command: xvfb-run pnpm test:regressions\n - store_test_results:\n path: test-results\n - run:\n name: Upload screenshots to Argos CI\n command: pnpm test:argos\n test_e2e:\n <<: *default-job\n executor:\n name: code-infra/mui-node-browser\n playwright-img-version: v1.58.2-noble\n steps:\n - checkout\n - code-infra/install-deps\n - run:\n name: pnpm test:e2e\n command: pnpm test:e2e\n - store_test_results:\n path: test-results\n\n test_package:\n <<: *default-job\n resource_class: 'medium+'\n steps:\n - checkout\n - code-infra/install-deps\n - run:\n name: Build packages\n command: pnpm release:build\n - run:\n name: Validate type declarations\n command: pnpm code-infra validate-built-types\n - run:\n name: Check public types\n command: pnpm -r run release:test\n - run:\n name: Test Node.js module resolution\n command: pnpm -F @base-ui/test-node-resolution test\n - run:\n name: Verify built packages\n command: pnpm -r test:package\n - code-infra/upload-size-snapshot\n\n test_unit_compiler:\n <<: *default-job\n resource_class: large\n steps:\n - checkout\n - code-infra/install-deps\n - build-with-compiler\n - run:\n name: Run tests on JSDOM\n command: pnpm test:jsdom\n environment:\n MUI_DISABLE_WORKSPACE_ALIASES: 1\n - store_test_results:\n path: test-results\n\n test_browser_compiler:\n <<: *default-job\n resource_class: large\n executor:\n name: code-infra/mui-node-browser\n playwright-img-version: v1.58.2-noble\n steps:\n - checkout\n - code-infra/install-deps\n - build-with-compiler\n - run:\n name: Run tests on headless Chromium\n command: pnpm test:chromium\n environment:\n MUI_DISABLE_WORKSPACE_ALIASES: 1\n - store_test_results:\n path: test-results\n\nworkflows:\n pipeline:\n when:\n equal: [pipeline, << pipeline.parameters.workflow >>]\n jobs:\n - test_unit:\n <<: *default-context\n name: 'JSDOM tests'\n - test_lint:\n <<: *default-context\n name: 'Linting'\n - test_static:\n <<: *default-context\n name: 'Generated files verification'\n - test_types:\n <<: *default-context\n name: 'Typechecking'\n - test_browser:\n <<: *default-context\n name: 'Browser tests'\n - test_regressions:\n <<: *default-context\n name: 'Regression tests'\n - test_e2e:\n <<: *default-context\n name: 'E2E tests'\n - test_package:\n <<: *default-context\n name: 'Package verification'\n - docs_validate:\n <<: *default-context\n name: 'Validating Docs'\n - test_unit_compiler:\n <<: *default-context\n name: 'JSDOM tests (React Compiler)'\n - test_browser_compiler:\n <<: *default-context\n name: 'Browser tests (React Compiler)'\n react-18:\n when:\n equal: [pipeline, << pipeline.parameters.workflow >>]\n jobs:\n - test_unit:\n <<: *default-context\n name: 'JSDOM tests (React 18)'\n react-version: '^18'\n - test_browser:\n <<: *default-context\n name: 'Browser tests (React 18)'\n react-version: '^18'\n - test_types:\n <<: *default-context\n name: 'Typechecking (React 18)'\n react-version: '^18'\n typescript-next:\n triggers:\n - schedule:\n cron: '0 0 * * *'\n filters:\n branches:\n only:\n - master\n jobs:\n - test_types_next:\n <<: *default-context\n name: 'Typechecking (typescript@next)'\n" }, { "path": ".editorconfig", "content": "# EditorConfig is awesome: https://editorconfig.org/\n\n# top-most EditorConfig file\nroot = true\n\n# Unix-style newlines with a newline ending every file\n[*]\ntrim_trailing_whitespace = true\nindent_style = space\nindent_size = 2\nend_of_line = lf\ncharset = utf-8\ninsert_final_newline = true\nmax_line_length = 100\n" }, { "path": ".gitattributes", "content": "# Set the default behavior, in case people don't have core.autocrlf set.\n* text=auto eol=lf\n\n# Undo the GitHub's default\n# https://github.com/github/linguist/blob/96ad1185828f44bb9b774328a584551ee57ed264/lib/linguist/vendor.yml#L177\npackages/**/*.d.ts -linguist-vendored\n" }, { "path": ".github/CODEOWNERS", "content": "* @atomiks @michaldudak @flaviendelangle\n/docs/src/ @atomiks @colmtuite @michaldudak @flaviendelangle\n/packages/react/ @atomiks @colmtuite @michaldudak @flaviendelangle @LukasTy \n/scripts/ @michaldudak\n/packages/utils/ @romgrk \n" }, { "path": ".github/ISSUE_TEMPLATE/1.bug.md", "content": "---\nname: 'Bug report'\nabout: 'File a bug report.'\nlabels: ['status: waiting for maintainer']\n---\n\n# Bug report\n\n## Current behavior\n\nProvide a clear and concise description of the current behavior you're experiencing. If applicable, provide screenshots and/or videos.\n\n## Expected behavior\n\nProvide a clear and concise description of the expected behavior.\n\n## Reproducible example\n\nLink to a CodeSandbox, StackBlitz, or other IDE.\n\n## Base UI version\n\nFor example v1.0.2\n\n## Which browser are you using?\n\nChrome/Safari/Firefox/Safari iOS etc.\n\n## Which OS are you using?\n\nMac OS/Windows/Other etc.\n\n## Which assistive tech are you using (if applicable)?\n\nVoiceover/JAWS etc.\n\n## Additional context\n\nProvide any additional context that might help us identify the problem and find a solution.\n" }, { "path": ".github/ISSUE_TEMPLATE/2.feature-request.md", "content": "---\nname: 'Feature request'\nabout: 'Suggest a new component or an enhancement for an existing component.'\nlabels: ['status: waiting for maintainer']\n---\n\n# Feature request\n\n## Summary\n\n\n\n## Examples in other libraries\n\n\n\n## Motivation\n\n\n" }, { "path": ".github/ISSUE_TEMPLATE/3.get-help.md", "content": "---\nname: 'Get help'\nabout: 'Ask a question.'\nlabels: ['status: waiting for maintainer']\n---\n\n# Get help\n\n## Ask a question\n\nBefore opening an issue, please consider starting a [GitHub Discussion](https://github.com/mui/base-ui/discussions) or asking the community for help in our [Discord](https://base-ui.com/r/discord).\n" }, { "path": ".github/ISSUE_TEMPLATE/4.docs-feedback.md", "content": "---\nname: 'Docs feedback'\nabout: 'Help us improve Base UI documentation.'\nlabels: ['status: waiting for maintainer']\n---\n\n# Docs feedback\n\n## How can we improve Base UI documentation?\n\nProvide a clear and concise description of the issue you're experiencing. If applicable, provide screenshots and/or videos.\n" }, { "path": ".github/PULL_REQUEST_TEMPLATE.md", "content": "\n\n- [ ] I have followed (at least) the [PR section of the contributing guide](https://github.com/mui/base-ui/blob/HEAD/CONTRIBUTING.md#sending-a-pull-request).\n" }, { "path": ".github/codeql/codeql-config.yml", "content": "name: CodeQL configuration\n" }, { "path": ".github/dependabot.yml", "content": "version: 2\nupdates:\n # Enable version updates for npm\n - package-ecosystem: npm\n # Look for `package.json` and `lock` files in the `root` directory\n directory: /\n schedule:\n interval: yearly\n # https://stackoverflow.com/questions/64047526/how-to-get-dependabot-to-trigger-for-security-updates-only\n open-pull-requests-limit: 0\n labels:\n - dependencies\n - security\n" }, { "path": ".github/workflows/check-if-pr-has-label.yml", "content": "name: Check if PR has label\n\non:\n pull_request:\n types: [opened, labeled, unlabeled, synchronize]\n\npermissions: {}\n\njobs:\n test-label-applied:\n # Tests that label is added on the PR\n runs-on: ubuntu-latest\n permissions:\n contents: read\n steps:\n - uses: mnajdova/github-action-required-labels@ca0df9249827e43aa4b4a0d25d9fe3e9b19b0705 # v2.1.0\n with:\n mode: minimum\n count: 1\n labels: ''\n" }, { "path": ".github/workflows/ci.yml", "content": "name: CI\n\non:\n push:\n branches-ignore:\n # Renovate branches are always Pull Requests.\n # We don't need to run CI twice (push+pull_request)\n - 'renovate/**'\n - 'dependabot/**'\n pull_request:\n\npermissions: {}\n\njobs:\n # Tests dev-only scripts across all supported dev environments\n test-dev:\n # l10nbot does not affect dev scripts.\n if: ${{ github.actor != 'l10nbot' }}\n runs-on: ${{ matrix.os }}\n strategy:\n matrix:\n os: [macos-latest, windows-latest, ubuntu-latest]\n steps:\n - run: echo \"${{ github.actor }}\"\n - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2\n with:\n # fetch all tags which are required for `pnpm release:changelog`\n fetch-depth: 0\n - name: Set up pnpm\n uses: pnpm/action-setup@b906affcce14559ad1aafd4ab0e942779e9f58b1 # v4.3.0\n - name: Use Node.js 22.x\n uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0\n with:\n node-version: '22.18'\n cache: 'pnpm' # https://github.com/actions/setup-node/blob/main/docs/advanced-usage.md#caching-packages-dependencies\n - run: pnpm install\n - run: pnpm release:build\n - name: Publish packages\n if: matrix.os == 'ubuntu-latest'\n uses: mui/mui-public/.github/actions/ci-publish@f544b55fdbbb922b7293365705cf62895b4f5186\n with:\n pr-comment: true\n" }, { "path": ".github/workflows/codeql.yml", "content": "name: CodeQL\n\non:\n schedule:\n - cron: '0 2 * * *'\n\npermissions: {}\n\njobs:\n analyze:\n name: Analyze\n runs-on: ubuntu-latest\n permissions:\n actions: read\n contents: read\n security-events: write\n steps:\n - name: Checkout repository\n uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2\n # Initializes the CodeQL tools for scanning.\n - name: Initialize CodeQL\n uses: github/codeql-action/init@0d579ffd059c29b07949a3cce3983f0780820c98 # v4.32.6\n with:\n languages: typescript\n config-file: ./.github/codeql/codeql-config.yml\n # If you wish to specify custom queries, you can do so here or in a config file.\n # By default, queries listed here will override any specified in a config file.\n # Prefix the list here with \"+\" to use these queries and those in the config file.\n\n # Details on CodeQL's query packs refer to : https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs\n # queries: security-extended,security-and-quality\n - name: Perform CodeQL Analysis\n uses: github/codeql-action/analyze@0d579ffd059c29b07949a3cce3983f0780820c98 # v4.32.6\n" }, { "path": ".github/workflows/ensure-triage-label.yml", "content": "name: Ensure triage label is present\n\non:\n label:\n types:\n - deleted\n issues:\n types:\n - opened\n\npermissions: {}\n\njobs:\n label_issues:\n runs-on: ubuntu-latest\n permissions:\n issues: write\n steps:\n - uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8\n with:\n script: |\n const { data: labels } = await github.rest.issues.listLabelsOnIssue({\n issue_number: context.issue.number,\n owner: context.repo.owner,\n repo: context.repo.repo,\n });\n\n if (labels.length <= 0) {\n await github.rest.issues.addLabels({\n issue_number: context.issue.number,\n owner: context.repo.owner,\n repo: context.repo.repo,\n labels: ['status: waiting for maintainer']\n })\n }\n" }, { "path": ".github/workflows/fixed-issue.yml", "content": "name: Comment on fixed issues\n\non:\n issues:\n types: [closed]\n\npermissions: {}\n\njobs:\n add-comment:\n runs-on: ubuntu-latest\n permissions:\n issues: write\n pull-requests: read\n steps:\n - name: Get associated PRs\n id: get-prs\n uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8\n with:\n script: |\n const issue_number = context.payload.issue.number;\n\n console.log(`Processing issue #${issue_number}`);\n\n // Use GraphQL to find PRs that close this issue\n const query = `\n query($owner:String!, $repo:String!, $issueNumber:Int!) {\n repository(owner: $owner, name: $repo) {\n issue(number: $issueNumber) {\n timelineItems(last: 100, itemTypes: [CONNECTED_EVENT, CROSS_REFERENCED_EVENT]) {\n nodes {\n __typename\n ... on ConnectedEvent {\n subject {\n ... on PullRequest {\n number\n merged\n mergedAt\n }\n }\n }\n ... on CrossReferencedEvent {\n source {\n ... on PullRequest {\n number\n merged\n mergedAt\n }\n }\n }\n }\n }\n }\n }\n }\n `;\n\n const variables = {\n owner: context.repo.owner,\n repo: context.repo.repo,\n issueNumber: parseInt(issue_number)\n };\n\n try {\n const result = await github.graphql(query, variables);\n console.log('GraphQL query completed successfully');\n\n // Extract all merged PRs that are linked to this issue\n const relatedPRs = [];\n if (result.repository.issue) {\n const timelineItems = result.repository.issue.timelineItems.nodes;\n\n for (const item of timelineItems) {\n let pr = null;\n\n if (item.__typename === 'ConnectedEvent' && item.subject) {\n pr = item.subject;\n } else if (item.__typename === 'CrossReferencedEvent' && item.source) {\n pr = item.source;\n }\n\n if (pr && pr.merged) {\n relatedPRs.push({\n number: pr.number,\n mergedAt: pr.mergedAt\n });\n }\n }\n }\n\n // Sort by merge date (newest first) and take the first one\n relatedPRs.sort((a, b) => new Date(b.mergedAt) - new Date(a.mergedAt));\n\n if (relatedPRs.length === 0) {\n console.log('No merged PRs found for this issue');\n return;\n }\n\n const prNumber = relatedPRs[0].number;\n console.log(`Found merged PR #${prNumber} associated with issue #${issue_number}`);\n\n // Set output for the next step\n core.setOutput('pr_number', prNumber);\n core.setOutput('has_pr', 'true');\n\n } catch (error) {\n console.error('Error fetching related PRs:', error);\n }\n\n - name: Add comment to issue\n if: steps.get-prs.outputs.has_pr == 'true'\n uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8\n with:\n script: |\n // Get PR number from the previous step's output\n const prNumber = '${{ steps.get-prs.outputs.pr_number }}';\n const issueNumber = context.payload.issue.number;\n\n // Get issue labels\n const issue = context.payload.issue;\n const labels = issue.labels.map(label => label.name);\n\n // Check if this is a bug/regression or a feature\n const isNewFeature = labels.some(label => label.includes('new feature'));\n\n const typeText = isNewFeature ? 'feature' : 'fix';\n\n const commentBody = `This ${typeText} will be available in the next npm release of Base UI.\n\n In the meantime, you can try it out on our Canary release channel:\n\n \\`\\`\\`sh\n npm i https://pkg.pr.new/@base-ui/react@${prNumber}\n \\`\\`\\``;\n\n await github.rest.issues.createComment({\n owner: context.repo.owner,\n repo: context.repo.repo,\n issue_number: issueNumber,\n body: commentBody\n });\n\n console.log(`Added comment to issue #${issueNumber}`);\n" }, { "path": ".github/workflows/maintenance.yml", "content": "name: Maintenance\n\non:\n # So that PRs touching the same files as the push are updated\n push:\n branches:\n - master\n - next\n # So that the `dirtyLabel` is removed if conflicts are resolved\n # Could put too much strain on rate limit\n # If we hit the rate limit too often remove this event\n pull_request_target:\n branches:\n - master\n - next\n types: [synchronize]\n\npermissions: {}\n\njobs:\n main:\n # l10nbot creates a lot of commits at once which starves CI.\n # We rely on other pushes to mark these branches as outdated.\n if: ${{ github.actor != 'l10nbot' }}\n runs-on: ubuntu-latest\n permissions:\n contents: read\n pull-requests: write\n steps:\n - run: echo \"${{ github.actor }}\"\n - name: Check if prs are dirty\n uses: eps1lon/actions-label-merge-conflict@1df065ebe6e3310545d4f4c4e862e43bdca146f0 # v3.0.3\n with:\n dirtyLabel: 'PR: out-of-date'\n removeOnDirtyLabel: 'PR: ready to ship'\n repoToken: '${{ secrets.GITHUB_TOKEN }}'\n retryAfter: 130\n retryMax: 10\n" }, { "path": ".github/workflows/mark-duplicate.yml", "content": "name: Mark duplicate\n\non:\n issue_comment:\n types: [created]\n\npermissions: {}\n\njobs:\n mark-duplicate:\n runs-on: ubuntu-latest\n if: ${{ !github.event.issue.pull_request }}\n permissions:\n contents: read\n issues: write\n steps:\n - name: Mark duplicate\n uses: actions-cool/issues-helper@71b62d7da76e59ff7b193904feb6e77d4dbb2777 # v3.7.6\n with:\n actions: 'mark-duplicate'\n token: ${{ secrets.GITHUB_TOKEN }}\n duplicate-labels: 'duplicate'\n remove-labels: 'status: incomplete,status: waiting for maintainer'\n close-issue: true\n" }, { "path": ".github/workflows/new-issue-triage.yml", "content": "name: New issue triage\non:\n issues:\n types:\n - opened\n\npermissions: {}\n\njobs:\n issue_cleanup:\n name: Clean issue body\n uses: mui/mui-public/.github/workflows/issues_body-cleanup.yml@f544b55fdbbb922b7293365705cf62895b4f5186\n permissions:\n contents: read\n issues: write\n" }, { "path": ".github/workflows/no-response.yml", "content": "name: No response\n\n# `issues`.`closed`, `issue_comment`.`created`, and `scheduled` event types are required for this Action\n# to work properly.\non:\n issues:\n types: [closed]\n issue_comment:\n types: [created]\n schedule:\n # These runs in our repos are spread evenly throughout the day to avoid hitting rate limits.\n # If you change this schedule, consider changing the remaining repositories as well.\n # Runs at 9 am, 9 pm\n - cron: '0 9,21 * * *'\n\npermissions: {}\n\njobs:\n noResponse:\n runs-on: ubuntu-latest\n permissions:\n contents: read\n issues: write\n steps:\n - uses: MBilalShafi/no-response-add-label@8336c12292902f27b931154c34ba4670cb9899a2\n with:\n token: ${{ secrets.GITHUB_TOKEN }}\n # Number of days of inactivity before an Issue is closed for lack of response\n daysUntilClose: 7\n # Label requiring a response\n responseRequiredLabel: 'status: waiting for author'\n # Label to add back when required label is removed\n optionalFollowupLabel: 'status: waiting for maintainer'\n # Comment to post when closing an Issue for lack of response. Set to `false` to disable\n closeComment: >\n Since the issue is missing key information and has been inactive for 7 days, it has been automatically closed.\n If you wish to see the issue reopened, please provide the missing information.\n" }, { "path": ".github/workflows/publish.yml", "content": "name: Publish packages\n\non:\n workflow_dispatch:\n inputs:\n sha:\n description: 'Commit SHA to release from'\n required: true\n type: string\n dry-run:\n description: 'Run in dry-run mode without actually publishing packages'\n required: false\n type: boolean\n default: false\n github-release:\n description: 'Create a GitHub release after publishing'\n required: false\n type: boolean\n default: true\n dist-tag:\n description: 'npm dist tag to publish to'\n required: false\n type: string\n default: 'latest'\n\npermissions: {}\n\njobs:\n publish:\n runs-on: ubuntu-latest\n permissions:\n contents: write # Required for pushing tags and creating releases\n id-token: write # Required for provenance\n environment:\n name: npm-publish\n steps:\n - name: Checkout\n uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2\n with:\n ref: ${{ inputs.sha }}\n fetch-depth: 0 # Fetch full history for proper git operations\n - name: Prepare for publishing\n uses: mui/mui-public/.github/actions/publish-prepare@f544b55fdbbb922b7293365705cf62895b4f5186\n - name: Publish packages\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n run: |\n # Build common flags\n ARGS=\"\"\n if [ \"${{ inputs.dry-run }}\" = \"true\" ]; then\n ARGS=\"$ARGS --dry-run\"\n fi\n if [ \"${{ inputs.github-release }}\" = \"true\" ]; then\n ARGS=\"$ARGS --github-release\"\n fi\n if [ -n \"${{ inputs.dist-tag }}\" ]; then\n ARGS=\"$ARGS --tag ${{ inputs.dist-tag }}\"\n fi\n\n pnpm code-infra publish --ci $ARGS\n" }, { "path": ".github/workflows/scorecards.yml", "content": "name: Scorecards supply-chain security\n\non:\n # Only the default branch is supported.\n branch_protection_rule:\n schedule:\n - cron: '0 2 * * *'\n\npermissions: {}\n\njobs:\n analysis:\n name: Scorecards analysis\n runs-on: ubuntu-latest\n permissions:\n # Needed to upload the results to code-scanning dashboard.\n security-events: write\n # Used to receive a badge.\n id-token: write\n # Needs for private repositories.\n contents: read\n actions: read\n steps:\n - name: Checkout code\n uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2\n with:\n persist-credentials: false\n - name: Run analysis\n uses: ossf/scorecard-action@4eaacf0543bb3f2c246792bd56e8cdeffafb205a # v2.4.3\n with:\n results_file: results.sarif\n results_format: sarif\n # (Optional) Read-only PAT token. Uncomment the `repo_token` line below if:\n # - you want to enable the Branch-Protection check on a *public* repository, or\n # - you are installing Scorecards on a *private* repository\n # To create the PAT, follow the steps in https://github.com/ossf/scorecard-action#authentication-with-pat.\n repo_token: ${{ secrets.SCORECARD_READ_TOKEN }}\n # Publish the results for public repositories to enable scorecard badges. For more details, see\n # https://github.com/ossf/scorecard-action#publishing-results.\n publish_results: true\n # Upload the results to GitHub's code scanning dashboard.\n - name: Upload to code-scanning\n uses: github/codeql-action/upload-sarif@0d579ffd059c29b07949a3cce3983f0780820c98 # v4.32.6\n with:\n sarif_file: results.sarif\n" }, { "path": ".github/workflows/support-stackoverflow.yml", "content": "# Configuration for support-requests - https://github.com/dessant/support-requests\nname: Support Stack Overflow\n\non:\n issues:\n types: [labeled, unlabeled, reopened]\n\npermissions: {}\n\njobs:\n mark-support:\n runs-on: ubuntu-latest\n permissions:\n contents: read\n issues: write\n steps:\n - uses: dessant/support-requests@47d5ea12f6c9e4a081637de9626b7319b415a3bf # v4.0.0\n with:\n github-token: ${{ secrets.GITHUB_TOKEN }}\n # Label used to mark issues as support requests\n support-label: 'support: Stack Overflow'\n # Comment to post on issues marked as support requests. Add a link\n # to a support page, or set to `false` to disable\n issue-comment: |\n 👋 Thanks for using this project!\n\n We use GitHub issues exclusively as a bug and feature requests tracker, however, this issue appears to be a support request.\n\n For support with Base UI please check out https://base-ui.com/react/overview/about#community.\n\n If you have a question on Stack Overflow, you are welcome to link to it here, it might help others.\n If your issue is subsequently confirmed as a bug, and the report follows the issue template, it can be reopened.\n close-issue: true\n lock-issue: false\n" }, { "path": ".github/workflows/vale-action.yml", "content": "name: Vale action\n\non: [pull_request]\n\npermissions: {}\n\njobs:\n vale:\n name: runner / vale\n runs-on: ubuntu-latest\n permissions:\n contents: read\n pull-requests: write\n steps:\n - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2\n - name: Extract Vale version from pnpm-lock.yaml\n id: vale-version\n run: |\n # Extract version from lock file\n VERSION=$(awk -F\"@|'\" '/@vvago\\/vale@/ {print $4}' pnpm-lock.yaml | head -n1)\n echo \"Extracted Vale version: $VERSION\"\n echo \"vale_version=$VERSION\" >> $GITHUB_OUTPUT\n - uses: errata-ai/vale-action@d89dee975228ae261d22c15adcd03578634d429c # v2.1.1\n continue-on-error: true # GitHub Action flag needed until https://github.com/errata-ai/vale-action/issues/89 is fixed\n with:\n version: ${{ steps.vale-version.outputs.vale_version }}\n # Errors should be more visible\n fail_on_error: true\n # The other reports don't work, not really https://github.com/reviewdog/reviewdog#reporters\n reporter: github-pr-check\n # Required, set by GitHub actions automatically:\n # https://docs.github.com/en/actions/security-guides/automatic-token-authentication#about-the-github_token-secret\n token: ${{secrets.GITHUB_TOKEN}}\n" }, { "path": ".gitignore", "content": "# It is best to ignoring editor and system files in a local .gitignore configuration file.\n# However, in order to prevent issues, they are ignored here.\n.DS_STORE\n.idea\n# IntelliJ IDEA module file\n*.iml\n*.log\n/.eslintcache\n/coverage\n/docs/.env.local\n/docs/.next\n/docs/export\n/docs/src/app/(private)/playground/*\n!/docs/src/app/(private)/playground/\\[slug\\]\n/docs/public/feed/\n/docs/reference/temp/*\n/test/regressions/screenshots\n# created by netlify dev (to perform local debug)\n.netlify\nbuild\nbuild-tests\nnode_modules\npackage-lock.json\nsize-snapshot.json\n# vale downloaded config\n.github/styles/\n.nx/cache\n.nx/workspace-data\n\n# Remove if you want to pregenerate the docs md files\ndocs/public/llms.txt\ndocs/public/llms-full.txt\ndocs/public/react\n.cursor/rules/nx-rules.mdc\n.github/instructions/nx.instructions.md\n\n# typescript\n*.tsbuildinfo\nnext-env.d.ts\n\n# Claude\n.claude/settings.local.json\n\n# Testing\ntest-results/\n" }, { "path": ".lintignore", "content": ".git\n/coverage\n/docs/next-env.d.ts\n/docs/.next\n/docs/export\n/docs/src/app/(private)/playground/\n/packages/react/**/*.min.*\nbuild\nbuild-tests\nnode_modules\npnpm-lock.yaml\nrouteTree.gen.ts" }, { "path": ".markdownlint-cli2.mjs", "content": "import { createBaseConfig } from '@mui/internal-code-infra/markdownlint';\n\nconst baseline = createBaseConfig();\n\nexport default {\n ...baseline,\n ignores: [...(baseline.ignores ?? []), 'IMPLEMENTATION_SUMMARY.md'],\n config: {\n ...baseline.config,\n MD038: false, // false positives in MDX\n MD041: false, // false positives in MDX\n },\n};\n" }, { "path": ".npmrc", "content": "enable-pre-post-scripts = true\n" }, { "path": ".vale.ini", "content": "# Vale config. More information at https://vale.sh/docs/topics/config/\nStylesPath = .github/styles\nMinAlertLevel = warning\n\n# To update mui-vale package:\n# 1. Go to the docs folder in the material-ui repo\n# 2. Update/create YAML files\n# 3. Run `pnpm docs:zipRules` to generate the zip files\n# 4. You can test locally by replacing the url with the file path of the generated zip\nPackages = Google, https://github.com/mui/material-ui/raw/HEAD/docs/mui-vale.zip\n\n[formats]\nmdx = md\n\n[*.{md,mdx}]\n# Ignore React component calls\nTokenIgnores = (<\\/?[A-Z].+>)\n\n# Ignore code injections that start with {{...\nBlockIgnores = {{.*\n\nBasedOnStyles = MUI\n\n# Google errors:\nGoogle.GenderBias = YES # No Gender bias\n# Google warings:\nGoogle.FirstPerson = YES # Avoid first-person\nGoogle.We = YES # Avoid first-person plural\nGoogle.Will = YES # Avoid future tense\nGoogle.OxfordComma = YES # Prefer Oxford comma\n\n[*.mdx]\n# MDX doesn't support HTML comments, see https://vale.sh/docs/keys/commentdelimiters.\nCommentDelimiters = {/*, */}\n\n[CHANGELOG*.md]\nMUI.CorrectReferenceAllCases = NO\n\n[IMPLEMENTATION_SUMMARY.md]\nBasedOnStyles =\n" }, { "path": ".vscode/extensions.json", "content": "{\n \"recommendations\": [\n // Formating\n \"esbenp.prettier-vscode\", // Prettier\n \"editorconfig.editorconfig\", // EditorConfig\n\n // Highlighting\n \"bradlc.vscode-tailwindcss\", // Tailwind CSS\n \"unifiedjs.vscode-mdx\", // MDX\n \"styled-components.vscode-styled-components\", // styled()\n\n // Lint\n \"dbaeumer.vscode-eslint\", // ESLint\n \"yoavbls.pretty-ts-errors\", // TypeScript\n \"stylelint.vscode-stylelint\", // Stylelint\n \"davidanson.vscode-markdownlint\" // markdownlint\n ]\n}\n" }, { "path": ".vscode/settings.json", "content": "{\n \"editor.defaultFormatter\": \"esbenp.prettier-vscode\",\n \"files.trimTrailingWhitespace\": true,\n\n // Root workspace only\n \"grammarly.selectors\": [\n {\n \"language\": \"markdown\",\n \"scheme\": \"file\"\n }\n ]\n}\n" }, { "path": "AGENTS.md", "content": "\n\n# Repository Guidelines\n\nThis repository contains the source code and documentation for Base UI: a headless, unstyled React component library.\n\n## Project structure\n\n- Source code for components and private utils is in `packages/react/`.\n- Source code for public shared utils is in `packages/utils/`.\n- Experiments are located at `docs/src/app/(private)/experiments/`. Use for creating demos that require manual testing in the browser.\n- Public documentation is located at `docs/src/app/(docs)/react/`. Alter the docs where necessary when changes must be visible to library users.\n- When creating public demos on the docs, refer to the `hero` demo for the given component and largely follow its styles (both CSS Modules and Tailwind CSS versions). Other demos may also contain relevant styling. Do not add custom styling beyond the critical layout styles necessary for new demos.\n\n## Code guidelines\n\n- Always use the `useTimeout` utility from `@base-ui/utils/useTimeout` instead of `window.setTimeout`, and `useAnimationFrame` from `@base-ui/utils/useAnimationFrame` instead of `requestAnimationFrame`. Search for other example usage in the codebase if unsure how to use them.\n- Use the `useStableCallback` utility from `@base-ui/utils/useStableCallback` instead of `React.useCallback` if the function is called within an effect or event handler. The utility cannot be used to memoize functions that are called directly in the body of a component (during render), so continue with `React.useCallback` in those scenarios.\n- Always use the `useIsoLayoutEffect` utility from `@base-ui/utils/useIsoLayoutEffect` instead of `React.useLayoutEffect`.\n- Avoid duplicating logic where necessary. If two components can share logic (such as event handlers), define the logic/handlers in the parent and share it through a context to the child; use the existing context if it exists.\n\n## Linting, typechecking, and formatting\n\n- Do not randomly cast (for example `as any`) if there are no type errors without doing so. Run `pnpm typescript` to verify types.\n- Ensure your changes pass linting - run `pnpm eslint`.\n- Ensure your styles pass stylelint - run `pnpm stylelint`.\n- Ensure your markdown passes markdownlint - run `pnpm markdownlint`.\n- Ensure your changes are formatted correctly - run `pnpm prettier`.\n- When you change a public component API (props or JSDoc), run `pnpm docs:api`.\n\n## Testing\n\n- If a repository command fails because dependencies are unavailable, run `pnpm i` first and then retry the command.\n- Run tests in JSDOM env with `pnpm test:jsdom {name} --no-watch` such as `pnpm test:jsdom NumberField --no-watch` or `pnpm test:jsdom parse --no-watch`.\n- Run tests in Chromium env with `pnpm test:chromium {name} --no-watch` such as `pnpm test:chromium NumberField --no-watch` or `pnpm test:jsdom parse --no-watch`.\n- Do not call `await flushMicrotasks()` directly after `await render(...)` when there are no interactions or state changes between them; `render` is already awaited, so that immediate flush is unnecessary.\n- If you made changes to the source code, ensure you verify your changes by running tests (see above), and writing new tests where applicable. If tests require the browser because, for example, they require layout measurements, restrict it to the Chromium env by using `it.skipIf(isJSDOM)` or `describe.skipIf(isJSDOM)` (search other tests for example usage if unsure).\n- Follow the established conventions in existing tests. Each file/component is tested with the filename `name.test.tsx`. For example, `PopoverRoot.test.tsx` is next to its source file `PopoverRoot.tsx`.\n- Tests use Vitest APIs only: `expect()`, `vi.fn()`, and `@testing-library/jest-dom` DOM matchers. Do not use Chai- or Sinon-style matcher chains or spies.\n\n## Commit guidelines\n\n- Commit messages follow the format `[scope] Imperative summary` (for example `[popover] Fix focus trap`). Choose scopes that mirror package or component names that were changed.\n- Use `[all components]` scope for changes that broadly affect most components.\n\n## Errors\n\nThese guidelines apply only to errors thrown by public packages.\n\nEvery error message must:\n\n1. **Say what happened** - Describe the problem clearly\n2. **Say why it's a problem** - Explain the consequence\n3. **Point toward how to solve it** - Give actionable guidance\n\nFormat:\n\n- Prefix with `Base UI: `\n- Use string concatenation for readability\n- Include a documentation link when applicable (`https://base-ui.com/...`)\n\n### Error Minifier\n\nYou MUST run `pnpm extract-error-codes` to update `docs/src/error-codes.json` every time you add or update an error message in an `Error` constructor.\n\n**Important:** If the update created a new error code, but the new and original message have the same number of arguments and semantics haven't changed, update the original error in `error-codes.json` instead of creating a new code.\n" }, { "path": "CHANGELOG.md", "content": "# Versions\n\n## v1.3.0\n\n_Mar 12, 2026_\n\n### General Changes\n\n- Warn when a component function is rendered directly (#4077) by @atomiks\n- Reset `openMethod` after close transition (#4128) by @atomiks\n- Fire Space activation on `keydown` in composite widgets (#4053) by @atomiks\n- Skip CSS-hidden items during keyboard navigation in composite widgets (#4195) by @atomiks\n- Optimize hot paths in `useHover` hooks and `safePolygon` (#4199) by @atomiks\n- Snap `--anchor-width` and `--anchor-height` to device pixel grid (#4082) by @flaviendelangle\n- Fix outside press dismissal when a component is portaled into a shadow DOM (#4230) by @dmitri-gb\n- Fix nested hoverable popups (#4206) by @dmitri-gb\n- Apply `data-base-ui-inert` to highest-level node (#3955) by @atomiks\n- Fix portable types (#4058) by @cgatian\n\n### Accordion\n\n- Add generic `Value` typing (#4138) by @atomiks\n\n### Autocomplete\n\n- Respect a `null` `filter` prop (#4117) by @atomiks\n- Add `InputGroup` part (#3745) by @atomiks\n\n### Avatar\n\n- Remove fallback transition logic and prevent premature image display (#4110) by @atomiks\n\n### Button\n\n- Avoid checking `disabled` twice in `onKeyDown` and `onKeyUp` (#4132) by @flaviendelangle\n\n### Checkbox\n\n- Add automatic `aria-labelledby` support (#4142) by @atomiks\n\n### Combobox\n\n- Avoid applying field attributes to input when it is inside popup (#4154) by @atomiks\n- Preserve inline input on `Enter` when nothing is highlighted (#4235) by @atomiks\n- Fix ARIA attributes during SSR (#4179) by @atomiks\n- Fix wrapping in virtualized grid arrow-key navigation (#4164) by @atomiks\n- Add `InputGroup` part (#3745) by @atomiks\n- Add support for a visually hidden close button and improve modal focus trapping (#4084) by @atomiks\n- Add `Label` part (#4167) by @atomiks\n\n### Context Menu\n\n- Ignore `mouseup` on non-Mac platforms (#3944) by @atomiks\n\n### Drawer\n\n- **Breaking change:** `Drawer` is no longer marked as preview
\n `Drawer` is now stable and should be imported as `{ Drawer } from '@base-ui/react/drawer'` (#4293) by @atomiks\n- Fix React 17 support (#4178) by @atomiks\n- Include border in frontmost height variable (#4202) by @atomiks\n- Improve touch selection (#4104) by @atomiks\n- Preserve cross-axis scrolling during touch gestures (#4187) by @atomiks\n- Prevent swipe dismissal when component is controlled (#4133) by @flaviendelangle\n- Add `SwipeArea` part (#4102) by @atomiks\n- Make `data-base-ui-swipe-ignore` explicit for touch interactions (#4295) by @atomiks\n- Disable inheritance for swipe CSS variables (#4099) by @atomiks\n\n### Field\n\n- Fix field validation when `Form` errors or `invalid` prop are present at same time (#4112) by @mj12albert\n\n### Menu\n\n- Prevent `pointerleave` from stealing focus from dialogs (#4125) by @atomiks\n- Optimize `pointer-events` for submenu hover interactions (#4231) by @atomiks\n- Fix `closeDelay` not being applied to `Menu.SubmenuTrigger` (#4134) by @flaviendelangle\n- Implement content transitions with `Viewport` (#4060) by @michaldudak\n\n### Meter\n\n- Fix label announcements in NVDA (#4200) by @mj12albert\n\n### Navigation Menu\n\n- Fix support for nested inline menus (#4198) by @atomiks\n- Fix close propagation in nested hover menus (#4285) by @atomiks\n- Close parent menus when nested link with `closeOnClick` is clicked (#4276) by @CiscoFran10\n- Fix duplicate `aria-orientation` (#4309) by @atomiks\n- Fix delayed trigger switches in Safari (#4310) by @atomiks\n\n### Number Field\n\n- Fix increment/decrement press `reason` values in `onValueCommitted` (#4259) by @jijiseong\n\n### Popover\n\n- Trap focus when `` is rendered inside and `modal` is `true`, and add support for a visually hidden close button (#4084) by @atomiks\n- Fix nested hoverable popups (#3798) by @flaviendelangle\n\n### Preview Card\n\n- Fix nested hoverable popups (#3798) by @flaviendelangle\n\n### Progress\n\n- Fix label announcements in NVDA (#4200) by @mj12albert\n\n### Radio Group\n\n- Add automatic `aria-labelledby` support (#4142) by @atomiks\n\n### Scroll Area\n\n- Fix focus trapping with a non-scrollable viewport (#4220) by @atomiks\n- Fix thumb size after remounting (#4107) by @atomiks\n\n### Select\n\n- Fix hidden input `id` fallback (#4135) by @atomiks\n- Fix `Value` placeholder not rendering with `Record` items (#4137) by @vcode-sh\n- Fire `onClick` during drag-to-select (#3969) by @obeattie\n- Fix `items` type definition for groups (#3884) by @aarongarciah\n- Fix `alignItemWithTrigger` fallback with browser zoom (#4292) by @atomiks\n- Add `Label` part (#4167) by @atomiks\n\n### Slider\n\n- Add `Label` part (#4167) by @atomiks\n- Stop committing validation on `touchend` (#4091) by @jijiseong\n\n### Switch\n\n- Add automatic `aria-labelledby` support (#4142) by @atomiks\n\n### Tabs\n\n- Re-render indicator position on tab resize (#4165) by @atomiks\n\n### Toast\n\n- Enable closing all toasts (#3979) by @chuganzy\n- Prevent duplicate `onClose` calls for ending toasts (#4280) by @chuganzy\n\n### Tooltip\n\n- Add `closeOnClick` prop (#4140) by @atomiks\n\nAll contributors of this release in alphabetical order : @aarongarciah, @atomiks, @cgatian, @chuganzy, @CiscoFran10, @dmitri-gb, @flaviendelangle, @jijiseong, @michaldudak, @mj12albert, @obeattie, @vcode-sh\n\n## v1.2.0\n\n_Feb 12, 2026_\n\n### General changes\n\n- Do not memoize `state` when not needed (#3812) by @flaviendelangle\n- Support lazy element in `render` prop (#3856) by @oliviertassinari\n- Replace Firefox deprecated mozInputSource check for virtual click detection (#3942) by @CiscoFran10\n- Use `WeakRef` for previously focused elements (#3916) by @atomiks\n- Fix page scroll jump when input has focus on unmount in Safari (#3925) by @atomiks\n- Fix flash at origin before positioning completes in Preact (#3975) by @OliverSpeir\n- Reduce style recalculation with classic scrollbars (#3854) by @mdm317\n- Fix event handling in useEnhancedClickHandler (#3981) by @sai6855\n\n### Autocomplete\n\n- Fix filter method's `useMemo` dependency (#3862) by @ZeeshanTamboli\n- Fix Autocomplete not using its internal filter method when `mode` is `list` (#3936) by @ZeeshanTamboli\n- Remove unnecessary double stringification of item in filtering logic (#3945) by @ZeeshanTamboli\n- Add `useFilteredItems` hook (#3732) by @guisehn\n- Fix popup closing on iOS VoiceOver (#3859) by @atomiks\n- Remove `aria-readonly` prop from `Clear` and `Popup` components when `readOnly` (#3907) by @markocupic024\n\n### Avatar\n\n- Add transition attributes (#3939) by @atomiks\n\n### Button\n\n- Capture component stack for `nativeButton` error message (#3861) by @atomiks\n\n### Checkbox\n\n- Cleanup disabled state tracking (#3913) by @atomiks\n- Preserve modifier key properties in the change event (#3935) by @mj12albert\n- Allow exit animations on `` when `keepMounted={false}` (#3939) by @atomiks\n\n### Combobox\n\n- Fix the type of the ref of the `Icon` part (#3796) by @flaviendelangle\n- Avoid clearing selected value if item is not present in items array (#3824) by @atomiks\n- Fix highlight change reason in `ChipRemove` (#3980) by @sai6855\n- Keep highlight on last deselect (#3923) by @atomiks\n- Fix inline filtering after selection in single mode (#3978) by @atomiks\n- Clear highlight on inline blur when inline (#3973) by @atomiks\n- Prevent opening popup on autofill change (#3924) by @atomiks\n- Distinguish `input-press` from `trigger-press` in `onOpenChange` reason (#4015) by @jijiseong\n- Fix async items while popup is open (#4034) by @atomiks\n- Prevent `Chip` from receiving focus when `disabled` (#4044) by @jijiseong\n- Add `useFilteredItems` hook (#3732) by @guisehn\n- Fix popup closing on iOS VoiceOver (#3859) by @atomiks\n- Remove `aria-readonly` prop from `Clear` and `Popup` components when `readOnly` (#3907) by @markocupic024\n- Fix `onClick` `Item` type (#3964) by @atomiks\n- Use reactive `domReferenceElement` subscriptions (#4017) by @atomiks\n- Add `autoComplete` prop for explicit browser autofill support (#4005) by @mattrothenberg\n- Fix inconsistent isItemEqualToValue argument order (#4056) by @atomiks\n\n### Context Menu\n\n- Fix `disabled` prop not working (#3806) by @arturbien\n- Fix explicit `collisionAvoidance` with `side: 'flip'` not working (#3877) by @obeattie\n\n### Drawer\n\n- Create new Drawer / Sheet component (#3680) by @atomiks\n\n### Field\n\n- Prevent re-renders when `Field.Control` is uncontrolled (#3820) by @atomiks\n- Fix autofocus in SSR environments (#3871) by @mj12albert\n- Fix max update depth loop when using `` (#3931) by @atomiks\n- Add transition attributes (#3939) by @atomiks\n\n### Input\n\n- Fix autofocus in SSR environments (#3871) by @mj12albert\n- Update ref type to `HTMLElement` (#3866) by @mj12albert\n\n### Menu\n\n- Fix `onClick` `Item` type (#3964) by @atomiks\n- Fix submenu stuck glitch (#3783) by @atomiks\n- Fix race conditions (#3821) by @atomiks\n- Add `` part (#3400) by @mj12albert\n\n### Navigation Menu\n\n- Fix forwarded ref types (#3775) by @CrawlerCode\n- Add `keepMounted` prop to `Content` part (#3794) by @atomiks\n\n### Number Field\n\n- Fix click handlers on ScrubArea (#3827) by @mj12albert\n- Remove `event.isTrusted` (#3920) by @atomiks\n- Stop repeat change at bounds (#3915) by @atomiks\n- Add `allowOutOfRange` prop (#3919) by @atomiks\n- Fix pen pointer handling (#3917) by @atomiks\n- Fix missing field state data attributes (#3909) by @mj12albert\n\n### Popover\n\n- Fix missing `aria-owns` element (#3959) by @atomiks\n- Use reactive `domReferenceElement` subscriptions (#4017) by @atomiks\n- Fix broken scale transition with detached triggers (#3810) by @michaldudak\n\n### Preview Card\n\n- Fix broken scale transition with detached triggers (#3810) by @michaldudak\n\n### Progress\n\n- De-duplicate `formatValue` function (#3805) by @sai6855\n\n### Radio Group\n\n- Preserve modifier key properties in the change event (#3935) by @mj12albert\n- Allow exit animations on `` when `keepMounted={false}` (#3939) by @atomiks\n- Rely on individual radio hidden inputs (#3826) by @atomiks\n- Add generic `Value` typing to `Radio` (#4033) by @atomiks\n\n### Scroll Area\n\n- Add `data-scrolling` state attribute to `Root` and `Viewport` parts (#3823) by @arturbien\n- Fix overflow edge rounding (#3888) by @atomiks\n\n### Select\n\n- Add `finalFocus` prop (#3785) by @markocupic024\n- Fix `alignItemWithTrigger` transform with CSS animations (#3831) by @atomiks\n- Fix `highlightItemOnHover` not being respected (#3868) by @sarthakmalik0810\n- Reset typeahead on external blur (#2618) by @antonfrolovsky\n- Fix scroll height loop (#3795) by @atomiks\n- Add `autoComplete` prop for explicit browser autofill support (#4005) by @mattrothenberg\n- Fix inconsistent isItemEqualToValue argument order (#4056) by @atomiks\n\n### Slider\n\n- Fix missing field state data attributes (#3909) by @mj12albert\n- Fix change event cloning (#3960) by @atomiks\n\n### Switch\n\n- Preserve modifier key properties in the change event (#3935) by @mj12albert\n\n### Tabs\n\n- Add transition attributes to `` part (#3880) by @atomiks\n\n### Toast\n\n- Make `useToastManager` and `createToastManager` generic functions (#3882) by @solastley\n- Prevent dismissed promise toast from reopening on updates (#4040) by @atomiks\n- Introduce a store (#3464) by @flaviendelangle\n\n### Toggle\n\n- Improve type safety and inference (#3173) by @michaelhazan\n\n### Toggle Group\n\n- Type value as string to match Toggle (#3770) by @markocupic024\n- Enable `Home`/`End` key navigation (#3971) by @jijiseong\n- Improve type safety and inference (#3173) by @michaelhazan\n\n### Tooltip\n\n- Prevent opening when focusing a disabled Trigger (#3902) by @michaldudak\n- Fix broken scale transition with detached triggers (#3810) by @michaldudak\n- Fix disabled prop on Triggers (#4049) by @michaldudak\n\nAll contributors of this release in alphabetical order : @antonfrolovsky, @arturbien, @atomiks, @CiscoFran10, @CrawlerCode, @flaviendelangle, @guisehn, @jijiseong, @LukasTy, @markocupic024, @mattrothenberg, @mdm317, @michaelhazan, @michaldudak, @mj12albert, @obeattie, @OliverSpeir, @oliviertassinari, @sai6855, @sarthakmalik0810, @solastley, @ZeeshanTamboli\n\n## v1.1.0\n\n_Jan 15, 2026_\n\n### General changes\n\n- Fix `onOpenChangeComplete(true)` timing (#3558) by @atomiks\n- Fix touch `openMethod` when tapping outside element bounds on Safari (#3541) by @atomiks\n- Fix visually hidden input styles across form components (#3606) by @atomiks\n- Fix click and drags outside a nested popup component from closing its parents (#3571) by @atomiks\n- Fix forwarded ref types (#3638) by @atomiks\n- Fix detached trigger remounting (#3724) by @atomiks\n- Include `ref` in `BaseUIComponentProps` (#2813) by @atomiks\n- Remove duplicated `disabled` prop (#3650) by @seongminn\n- Allow `actionsRef` to be `null` (#3682) by @mj12albert\n\n### Accordion\n\n- Fix keyboard navigation with non-interactive trigger elements (#3684) by @ZeeshanTamboli\n\n### Autocomplete\n\n- Add `data-popup-side` and `data-list-empty` state attributes to `` (#3491) by @atomiks\n- Add `loopFocus` prop (#3592) by @atomiks\n- Fix hidden input `id` and `required` props (#3640) by @atomiks\n\n### Button\n\n- Remove discriminated props union (#3643) by @atomiks\n\n### Checkbox\n\n- Fix hidden input `id` and `required` props (#3640) by @atomiks\n\n### Combobox\n\n- Add `data-popup-side` and `data-list-empty` state attributes to `` (#3491) by @atomiks\n- Add `loopFocus` prop (#3592) by @atomiks\n- Add `toolbar` role to `` to prevent NVDA from entering browse mode (#3647) by @atomiks\n- Add `placeholder` prop to `` (#3604) by @atomiks\n- Fix controlled `value` prop when `items` change (#3607) by @atomiks\n- Fix `multiple` values label resolution in `` (#3314) by @atomiks\n- Forward root `id` to visible form element (#3722) by @atomiks\n- Do not trigger Field `onBlur` handlers when opening popup (#3609) by @atomiks\n\n### Context Menu\n\n- Avoid creating sibling elements next to trigger (#3645) by @atomiks\n\n### CSP Provider\n\n- Add `CSPProvider` (#3553) by @atomiks\n\n### Dialog\n\n- Fix `Maximum update depth exceeded` error with Suspense (#3700) by @michaldudak\n- Fix `` forwardedRef type (#3736) by @ZeeshanTamboli\n\n### Field\n\n- Add `actionsRef` prop (#3395) by @mj12albert\n- Add `nativeLabel` prop to `` (#3723) by @atomiks\n- Add missing type export (#3702) by @DiegoAndai\n\n### Form\n\n- Add `actionsRef` prop (#3395) by @mj12albert\n\n### Menu\n\n- Fix focus guard handling (#3654) by @atomiks\n- Avoid disabling modality on click after hover-open (#3455) by @atomiks\n\n### Menubar\n\n- Fix submenu outside-press dismiss on touch (#3556) by @atomiks\n\n### Number Field\n\n- Fix Field `data-focused` state (#3563) by @atomiks\n- Fix hidden input focus on submit (#3581) by @atomiks\n\n### Popover\n\n- Fix popup auto resize glitches (#3591) by @atomiks\n- Fix focus guard handling (#3654) by @atomiks\n- Prevent disabling focus management when clicking trigger before hover delay completes (#3572) by @atomiks\n- Refactor popup auto resize logic. It is no longer necessary to specify `--positioner-width`/`--positioner-height` CSS variables on `` when using detached triggers unless the `Viewport` part has been added to the JSX. (#3652) by @atomiks\n\n### Preview Card\n\n- Support detached triggers (#3566) by @michaldudak and @atomiks\n\n### Radio Group\n\n- Fix `value` type (#3582) by @atomiks\n- Fix hidden input `id` and `required` props (#3640) by @atomiks\n\n### Scroll Area\n\n- Perf improvements (#3536) by @atomiks\n\n### Select\n\n- Add `placeholder` prop to `` (#3604) by @atomiks\n- Fix support for transform animations when `alignItemWithTrigger` is active (#3532) by @atomiks\n- Fix support for `max-height` popup style when `alignItemWithTrigger` is active (#3573) by @atomiks\n- Fix `data-filled` state in `multiple` mode (#3608) by @atomiks\n- Fix highlight being removed on popup mouseout when `highlightItemOnHover` is disabled (#3492) by @atomiks\n- Fix support for individual transform animations when `alignItemWithTrigger` is active (#3637) by @atomiks\n- Fix `multiple` values label resolution in `` (#3314) by @atomiks\n- Forward root `id` to visible form element (#3722) by @atomiks\n- Do not trigger Field `onBlur` handlers when opening popup (#3609) by @atomiks\n\n### Slider\n\n- Fix `onValueCommitted` not called for range sliders (#3600) by @mj12albert\n\n### Switch\n\n- Add `value` prop (#3676) by @Grafikart\n- Fix hidden input `id` and `required` props (#3640) by @atomiks\n\n### Toast\n\n- Fix timers not being rescheduled when updated (#3564) by @atomiks\n\n### Tooltip\n\n- Fix popup auto resize glitches (#3591) by @atomiks\n- Fix `trackCursorAxis` handling (#3679) by @atomiks\n- Refactor popup auto resize logic. It is no longer necessary to specify `--positioner-width`/`--positioner-height` CSS variables on `` when using detached triggers unless the `Viewport` part has been added to the JSX. (#3652) by @atomiks\n\n### mergeProps\n\n- Make `mergeProps` public (#3642) by @michaldudak and @LukasTy\n\n### useRender\n\n- Export missing types (#3565) by @michaldudak\n\nAll contributors of this release in alphabetical order: @albertdugba, @atomiks, @brijeshb42, @chuganzy, @colmtuite, @dav-is, @DiegoAndai, @Grafikart, @Janpot, @LukasTy, @michaldudak, @mj12albert, @oliviertassinari, @seongminn, @updbqn, @ZeeshanTamboli\n\n## v1.0.0\n\n_Dec 11, 2025_\n\n### General changes\n\n- **Breaking change:** Rename packages to use the `@base-ui` org.
\n The package name has changed from `@base-ui-components/react` to `@base-ui/react`.\n (#3462) by @mnajdova\n\n### Combobox\n\n- Respect `itemToStringValue` for `onFormSubmit` (#3441) by @atomiks\n- Add `null` as an option for the value prop (#3488) by @mnajdova\n\n### Menu\n\n- Fix submenu opens with 0 delay (#3459) by @atomiks\n- Fix focus not returning to trigger on Esc while pointer rests on popup (#3482) by @atomiks\n- Fix always `null` open method (#3486) by @atomiks\n- Allow side axis fallback for submenus by default (#3470) by @atomiks\n\n### Navigation Menu\n\n- Fix mount transitions on `Positioner` in Firefox (#3424) by @atomiks\n\n### Number Field\n\n- Fix multiple scrub area support (#3471) by @atomiks\n\n### Popover\n\n- Fix mount transitions on `Positioner` in Firefox (#3424) by @atomiks\n- Fix skipped viewport transitions (#3453) by @atomiks\n\n### Select\n\n- Respect `itemToStringValue` for `onFormSubmit` (#3441) by @atomiks\n- Add `null` as an option for the value prop (#3488) by @mnajdova\n\n### Tabs\n\n- Fix indicator positioning in transformed containers (#3439) by @atomiks\n- Do not initially select a disabled tab (#3475) by @michaldudak\n\n### Toast\n\n- Fix `flushSync` dev error when toast is added (#3443) by @atomiks\n- Fix `;` emitting `aria-hidden` warning on click (#3469) by @atomiks\n\n### Toggle Group\n\n- More permissive towards falsy toggle values (#3477) by @mj12albert\n\n### Tooltip\n\n- Fix mount transitions on `Positioner` in Firefox (#3424) by @atomiks\n- Fix ignored \"modal\" setting in Popovers experiment (#3474) by @michaldudak\n- Fix shared tooltip closing with trigger gaps (#3452) by @atomiks\n- Fix skipped viewport transitions (#3453) by @atomiks\n\nAll contributors of this release in alphabetical order: @atomiks, @LukasTy, @michaldudak, @mj12albert, @mnajdova, @oliviertassinari, @pondorasti, @romgrk, @ZeeshanTamboli\n\n## v1.0.0-rc.2\n\n_Dec 11, 2025_\n\nThis release contains the same code as v1.0.0.\nPlease refer to that version to see the changes.\n\n## v1.0.0-rc.1\n\n_Dec 11, 2025_\n\nThis release contains the same code as v1.0.0.\nPlease refer to that version to see the changes.\n\n## v1.0.0-rc.0\n\n_Dec 4, 2025_\n\n### General changes\n\n- Fix missing `'use client'` directives (#3408) by @atomiks\n\n### Autocomplete\n\n- Fix `keepHighlight` focus sync (#3399) by @atomiks\n\n### Checkbox\n\n- **Breaking change:** Match native unchecked state in form submission.
\n The Checkbox will not submit the `\"off\"` value with a form when unchecked anymore, unless the new `uncheckedValue` prop is set.\n (#3406) by @atomiks\n\n### Collapsible\n\n- Remove `render={null}` (#3407) by @mj12albert\n\n### Combobox\n\n- **Breaking change:** Removed the `keepHighlight` prop (#3377) by @atomiks\n\n### Dialog\n\n- Close when pressing focusable element outside (#3380) by @atomiks\n- Fix closing after pointer lock exit in Firefox (#3379) by @atomiks\n\n### Menu\n\n- Add `highlightItemOnHover` prop (#3377) by @atomiks\n- Do not import client components from MenuStore (#3409) by @michaldudak\n\n### Number Field\n\n- Ensure hidden input participates in form validation (#3374) by @atomiks\n- Improve symbol replacement logic (#3376) by @atomiks\n- Fix fractional step snapping (#3375) by @atomiks\n- Fix parsing numbers with Swiss locale (#3361) by @michaldudak\n- Fix pointer lock release when soft clicking in Firefox (#3378) by @atomiks\n\n### Popover\n\n- Close when pressing focusable element outside (#3380) by @atomiks\n- Fix modal backdrop on touch (#3383) by @atomiks\n- Fix popover glitching when flipped (#3364) by @michaldudak\n\n### Select\n\n- Add `highlightItemOnHover` prop (#3377) by @atomiks\n\n### Switch\n\n- **Breaking change:** Match native off state in form submission.
\n The Switch will not submit the `\"off\"` value with a form when unchecked anymore, unless the new `uncheckedValue` prop is set.\n (#3406) by @atomiks\n\n### Tabs\n\n- **Breaking change:** Fix Panel `keepMounted` behavior.
\n The `value` prop is now required on `` and `` parts.\n (#3372) by @atomiks\n\n### Toast\n\n- Recalculate content height when layout size is fixed (#3359) by @atomiks\n- Fix multiple swipe directions on same axis (#3392) by @mj12albert\n\n### Tooltip\n\n- Improve contained triggers performance (#3385) by @michaldudak\n\nAll contributors of this release in alphabetical order: @atomiks, @michaldudak, @mj12albert, @oliviertassinari, @pondorasti, @romgrk\n\n## v1.0.0-beta.7\n\n_Nov 27, 2025_\n\n### General changes\n\n- Fix error about `props.ref` access in React <=18 (#3257) by @atomiks\n- Prefer non-adaptive anchoring position in `` components and fix `autoFocus` scroll jumps (#3250) by @atomiks\n- Make popups' `data-anchor-hidden` state attribute check for anchor presence in layout (#3267) by @atomiks\n- Prevent popups from sticking after hover when pressing `<a>` tags inside them (#3318) by @atomiks\n- Improve performance when detached triggers are used (#3277)\n- Fix iOS VoiceOver voice control accessibility in non-modal popups (#3340)\n\n### Alert Dialog\n\n- Fix trigger registration loop (#3249) by @atomiks\n- Fix focus restoration when focused element is hidden with CSS (#3313)\n\n### Checkbox Group\n\n- Fix `aria-describedby` on checkbox group (#3269) by @mj12albert\n\n### Combobox\n\n- Revert overload types to ensure typed wrappers work correctly (#3254) by @atomiks\n- Fix ignored `filteredItems` instances (#3272) by @atomiks\n- Fix loop when passing `undefined` to `items` prop (#3348)\n\n### Context Menu\n\n- Block mouseup at initial cursor point (#3274) by @atomiks\n\n### Dialog\n\n- Fix trigger registration loop (#3249) by @atomiks\n- Fix focus restoration when focused element is hidden with CSS (#3313)\n\n### Form\n\n- Fix cast `ref` type (#3324) by @mj12albert\n\n### Menu\n\n- Fix trigger registration loop (#3249) by @atomiks\n- Do not pass `key` to the rendered element (#3255) by @michaldudak\n- Fix nested dialog from closing on Shift+Tab (#3346)\n\n### Navigation Menu\n\n- Fix Safari 18 issue where `` width may be set to 0 on hover (#3309) by @EmilNordling\n- Ensure submenu triggers participate in composite list (#3344) by @atomiks\n\n### Number Field\n\n- Fix literal space handling with symbols (#3334) by @atomiks\n\n### Popover\n\n- Fix trigger registration loop (#3249) by @atomiks\n- Do not pass `key` to the rendered element (#3255) by @michaldudak\n- Fix focus restoration when focused element is hidden with CSS (#3313)\n\n### Select\n\n- Revert overload types to ensure typed wrappers work correctly (#3254) by @atomiks\n\n### Slider\n\n- Fix extra `onValueCommitted` calls (#3312) by @mj12albert\n- Fix cast `ref` type (#3324) by @mj12albert\n\n### Tooltip\n\n- Fix trigger registration loop (#3249) by @atomiks\n\nAll contributors of this release in alphabetical order: @atomiks, @brijeshb42, @Copilot, @EmilNordling, @michaldudak, @mj12albert, @oliviertassinari, @ZeeshanTamboli\n\n## v1.0.0-beta.6\n\n_Nov 17, 2025_\n\nThis is a hotfix release with the following changes:\n\n- Fix for rendering of Alert Dialog, Dialog, Menu, Popover, and Tooltip in React Server Components (#3241) by @michaldudak\n- Fix of the types of the refs in the Checkbox, Switch and Radio components (#3246) by @mnajdova\n- Fix of the value type error with mergeProps (#3247) by @atomiks\n\n## v1.0.0-beta.5\n\n_Nov 17, 2025_\n\n### General changes\n\n- **Breaking change:** Replace `trackAnchor` with `disableAnchorTracking`.
\n If you were using `trackAnchor={false}`, be sure to update your usage to `disableAnchorTracking` instead.\n (#3188) by @mnajdova\n- **Breaking change:** Rename `loop` to `loopFocus` (#3186) by @mnajdova\n- Fix type portability (#2912) by @atomiks\n- Accept a function for the `style` prop (#3038) by @mnajdova\n- Create portal elements inside React (#2889) by @atomiks\n- Avoid applying `hidden` attribute to indicator elements when they specify `keepMounted` and are invisible (#3228) by @atomiks\n- Fix crash in Next.js 16 when accessing `render.props.ref` (#3231) by @atomiks\n\n### Accordion\n\n- **Breaking change:** Change `multiple` prop to be false by default and add a demo (#3141) by @mnajdova\n- Fix flaky exit transition (#3101) by @atomiks\n\n### Alert Dialog\n\n- Fix `initialFocus` as function being called on close (#2949) by @atomiks\n- Support detached triggers (#2974) by @michaldudak\n- Place `overflow: hidden` on `` for overlay scrollbars by default. Avoids sticky elements shifting if `` has an `overflow` style specified. (#3083) by @atomiks\n- Add `` part (#2808) by @atomiks\n\n### Autocomplete\n\n- **Breaking change:** Refactor `alwaysSubmitOnEnter` to `submitOnItemClick` prop.
\n If you were using `alwaysSubmitOnEnter`, be sure to update your usage to `submitOnItemClick` instead.\n (#3018) by @atomiks\n- Prevent blocking filtering while composing text on Android (#2944) by @atomiks\n- Add empty state to `List.State` (#2934) by @atomiks\n- Fix `initialFocus` as function being called on close (#2949) by @atomiks\n- Add `role=\"combobox\"` to `` if `` is inside Popup (#2973) by @atomiks\n- Fix stale `onItemHighlighted` data when filtering with `autoHighlight` (#2829) by @atomiks\n- Add empty and side styling attributes on `` (#2926) by @atomiks\n- Fix `` component return type for React 17 (#3050) by @atomiks\n- Support `autoHighlight: \"always\"`, and add `keepHighlight`, `highlightItemOnHover` props (#2976) by @atomiks\n- Keep focus on input when pressing list element (#3092) by @atomiks\n- Allow Esc to bubble if `` is not used (#2935) by @atomiks\n- Add `dialog` role to popup when input is inside (#3213) by @atomiks\n\n### Button\n\n- New `