Merge branch 'main' into externaldimensions

Author: nstepien

.github/workflows/ci.yml

@@ -53,7 +53,7 @@ jobs:
           if-no-files-found: ignore
 
       - name: Upload coverage
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v6
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
 

.npmrc

@@ -1,3 +1,3 @@
 {
-  "recommendations": ["dbaeumer.vscode-eslint", "oxc.oxc-vscode"]
+  "recommendations": ["dbaeumer.vscode-eslint", "oxc.oxc-vscode", "typescriptteam.native-preview"]
 }

.vscode/extensions.json

@@ -10,6 +10,7 @@
   "editor.formatOnSaveMode": "file",
   "js/ts.tsdk.promptToUseWorkspaceVersion": true,
   "js/ts.tsdk.path": "node_modules/typescript/lib",
+  "js/ts.experimental.useTsgo": true,
   "files.readonlyInclude": {
     "**/routeTree.gen.ts": true
   },

.vscode/settings.json

@@ -1,11 +1,11 @@
 # AGENTS.md
 
-## Quick ref
+## Commands
 
 ```shell
 npm install                  # setup (requires Node.js ≥ 22 for `node --run`)
 node --run build             # library → lib/
-node --run typecheck         # tsc --build
+node --run typecheck         # tsgo --build
 node --run eslint            # eslint --max-warnings 0
 node --run eslint:fix        # eslint --fix
 node --run format            # oxfmt
@@ -48,12 +48,12 @@ website/              # demo site (Vite + TanStack Router)
 - **Light/dark mode** — handled via CSS `light-dark()` + `color-scheme`, not JS.
 - **Accessibility first** — ARIA attributes (e.g. `aria-colindex`, `aria-rowindex`, `aria-selected`, roles) are required. Tests query by role.
 - **Formatting** — oxfmt (not Prettier). **Linting** — ESLint (must pass with zero warnings).
-- **Build** — Rolldown bundles library to `lib/`; `ecij` plugin prefixes classes with `rdg-{version}-` (dots→dashes) to avoid cross-version conflicts.
+- **Build** — tsdown bundles library to `lib/`; `ecij` plugin prefixes classes with `rdg-{version}-` (dots→dashes) to avoid cross-version conflicts.
 
 ## Testing
 
-- Browser tests use `vitest/browser` + Playwright. `test/setupBrowser.ts` configures `page.render()` via `vitest-browser-react` and registers custom locators via `locators.extend()` — prefer `page.getGrid()`, `page.getCell({ name })`, `page.getRow()`, `page.getHeaderCell()`, `page.getSelectedCell()`, etc. over raw `page.getByRole()`.
-- Test helpers in `test/browser/utils.tsx`: `setup()`, `getRowWithCell()`, `getCellsAtRowIndex()`, `validateCellPosition()`, `scrollGrid()`, `tabIntoGrid()`, `testCount()`, `testRowCount()`.
+- Browser tests use `vitest/browser` + Playwright. `test/setupBrowser.ts` configures `page.render()` via `vitest-browser-react` and registers custom locators via `locators.extend()` — prefer `page.getGrid()`, `page.getCell({ name })`, `page.getRow()`, `page.getHeaderCell()`, `page.getActiveCell()`, etc. over raw `page.getByRole()`.
+- Test helpers in `test/browser/utils.tsx`: `setup()`, `getRowWithCell()`, `getCellsAtRowIndex()`, `validateCellPosition()`, `scrollGrid()`, `safeTab()`, `testCount()`, `testRowCount()`.
 - `test/failOnConsole.ts` fails tests on unexpected console warnings/errors.
 - **Never run visual regression tests** — screenshots are environment-dependent so visual regression tests must run in CI only.
 

AGENTS.md

@@ -1,14 +1,8 @@
 import eslintReact from '@eslint-react/eslint-plugin';
 import markdown from '@eslint/markdown';
 import vitest from '@vitest/eslint-plugin';
-import jestDom from 'eslint-plugin-jest-dom';
-import reactDom from 'eslint-plugin-react-dom';
 import reactHooks from 'eslint-plugin-react-hooks';
-import reactNamingConvention from 'eslint-plugin-react-naming-convention';
-import reactRsc from 'eslint-plugin-react-rsc';
-import reactWebApi from 'eslint-plugin-react-web-api';
 import sonarjs from 'eslint-plugin-sonarjs';
-import testingLibrary from 'eslint-plugin-testing-library';
 import { defineConfig, globalIgnores } from 'eslint/config';
 import tseslint from 'typescript-eslint';
 
@@ -29,10 +23,6 @@ export default defineConfig([
       // @ts-expect-error
       'react-hooks': reactHooks,
       '@eslint-react': eslintReact,
-      '@eslint-react/rsc': reactRsc,
-      '@eslint-react/dom': reactDom,
-      '@eslint-react/web-api': reactWebApi,
-      '@eslint-react/naming-convention': reactNamingConvention,
       sonarjs,
       '@typescript-eslint': tseslint.plugin
     },
@@ -288,7 +278,7 @@ export default defineConfig([
       // https://www.eslint-react.xyz/docs/rules/overview
       /*
 // copy all the rules from the rules table for easy pasting
-function getRules(id, prefix) {
+function getRules(id) {
   return (
     Iterator.from(
       document
@@ -298,38 +288,33 @@ function getRules(id, prefix) {
         .querySelectorAll('tr a')
     )
       // map link to rule declaration
-      .map((a) => `'@eslint-react/${prefix}${a.textContent}': 1,`)
+      .map((a) => `'@eslint-react/${a.getAttribute('href')}': 1,`)
   );
 }
 copy(
   Iterator.from([
-    getRules('x-rules', ''),
-    getRules('rsc-rules', 'rsc/'),
-    getRules('dom-rules', 'dom/'),
-    getRules('web-api-rules', 'web-api/'),
-    getRules('naming-convention-rules', 'naming-convention/'),
+    getRules('x-rules'),
+    getRules('jsx-rules'),
+    getRules('rsc-rules'),
+    getRules('dom-rules'),
+    getRules('web-api-rules'),
+    getRules('naming-convention-rules'),
   ])
     .flatMap((x) => x)
     .toArray()
     .join('\n')
 );
       */
-      '@eslint-react/jsx-dollar': 1,
-      '@eslint-react/jsx-key-before-spread': 1,
-      '@eslint-react/jsx-no-comment-textnodes': 1,
-      '@eslint-react/jsx-shorthand-boolean': 1,
-      '@eslint-react/jsx-shorthand-fragment': 1,
       '@eslint-react/component-hook-factories': 1,
       '@eslint-react/error-boundaries': 1,
       '@eslint-react/exhaustive-deps': 1,
-      '@eslint-react/immutability': 0,
+      '@eslint-react/immutability': 1,
       '@eslint-react/no-access-state-in-setstate': 1,
       '@eslint-react/no-array-index-key': 0,
       '@eslint-react/no-children-count': 1,
       '@eslint-react/no-children-for-each': 1,
       '@eslint-react/no-children-map': 1,
       '@eslint-react/no-children-only': 1,
-      '@eslint-react/no-children-prop': 1,
       '@eslint-react/no-children-to-array': 1,
       '@eslint-react/no-class-component': 1,
       '@eslint-react/no-clone-element': 1,
@@ -367,7 +352,6 @@ copy(
       '@eslint-react/no-unused-props': 1,
       '@eslint-react/no-unused-state': 1,
       '@eslint-react/no-use-context': 1,
-      '@eslint-react/no-useless-fragment': [1, { allowExpressions: false }],
       '@eslint-react/prefer-destructuring-assignment': 1,
       '@eslint-react/prefer-namespace-import': 1,
       '@eslint-react/purity': 1,
@@ -378,32 +362,37 @@ copy(
       '@eslint-react/unsupported-syntax': 1,
       '@eslint-react/use-memo': 1,
       '@eslint-react/use-state': 1,
-      '@eslint-react/rsc/function-definition': 1,
-      '@eslint-react/dom/no-dangerously-set-innerhtml': 1,
-      '@eslint-react/dom/no-dangerously-set-innerhtml-with-children': 1,
-      '@eslint-react/dom/no-find-dom-node': 1,
-      '@eslint-react/dom/no-flush-sync': 0,
-      '@eslint-react/dom/no-hydrate': 1,
-      '@eslint-react/dom/no-missing-button-type': 1,
-      '@eslint-react/dom/no-missing-iframe-sandbox': 1,
-      '@eslint-react/dom/no-namespace': 1,
-      '@eslint-react/dom/no-render': 1,
-      '@eslint-react/dom/no-render-return-value': 1,
-      '@eslint-react/dom/no-script-url': 1,
-      '@eslint-react/dom/no-string-style-prop': 1,
-      '@eslint-react/dom/no-unknown-property': 0,
-      '@eslint-react/dom/no-unsafe-iframe-sandbox': 1,
-      '@eslint-react/dom/no-unsafe-target-blank': 1,
-      '@eslint-react/dom/no-use-form-state': 1,
-      '@eslint-react/dom/no-void-elements-with-children': 1,
-      '@eslint-react/dom/prefer-namespace-import': 1,
-      '@eslint-react/web-api/no-leaked-event-listener': 1,
-      '@eslint-react/web-api/no-leaked-interval': 1,
-      '@eslint-react/web-api/no-leaked-resize-observer': 1,
-      '@eslint-react/web-api/no-leaked-timeout': 1,
-      '@eslint-react/naming-convention/context-name': 1,
-      '@eslint-react/naming-convention/id-name': 1,
-      '@eslint-react/naming-convention/ref-name': 1,
+      '@eslint-react/jsx-no-children-prop': 1,
+      '@eslint-react/jsx-no-children-prop-with-children': 1,
+      '@eslint-react/jsx-no-comment-textnodes': 1,
+      '@eslint-react/jsx-no-useless-fragment': [1, { allowExpressions: false }],
+      '@eslint-react/jsx-no-key-after-spread': 1,
+      '@eslint-react/jsx-no-namespace': 1,
+      '@eslint-react/rsc-function-definition': 1,
+      '@eslint-react/dom-no-dangerously-set-innerhtml': 1,
+      '@eslint-react/dom-no-dangerously-set-innerhtml-with-children': 1,
+      '@eslint-react/dom-no-find-dom-node': 1,
+      '@eslint-react/dom-no-flush-sync': 0,
+      '@eslint-react/dom-no-hydrate': 1,
+      '@eslint-react/dom-no-missing-button-type': 1,
+      '@eslint-react/dom-no-missing-iframe-sandbox': 1,
+      '@eslint-react/dom-no-render': 1,
+      '@eslint-react/dom-no-render-return-value': 1,
+      '@eslint-react/dom-no-script-url': 1,
+      '@eslint-react/dom-no-string-style-prop': 1,
+      '@eslint-react/dom-no-unknown-property': 1,
+      '@eslint-react/dom-no-unsafe-iframe-sandbox': 1,
+      '@eslint-react/dom-no-unsafe-target-blank': 1,
+      '@eslint-react/dom-no-use-form-state': 1,
+      '@eslint-react/dom-no-void-elements-with-children': 1,
+      '@eslint-react/dom-prefer-namespace-import': 1,
+      '@eslint-react/web-api-no-leaked-event-listener': 1,
+      '@eslint-react/web-api-no-leaked-interval': 1,
+      '@eslint-react/web-api-no-leaked-resize-observer': 1,
+      '@eslint-react/web-api-no-leaked-timeout': 1,
+      '@eslint-react/naming-convention-context-name': 1,
+      '@eslint-react/naming-convention-id-name': 1,
+      '@eslint-react/naming-convention-ref-name': 1,
 
       // SonarJS rules
       // https://github.com/SonarSource/SonarJS/blob/master/packages/jsts/src/rules/README.md#rules
@@ -893,7 +882,7 @@ copy(
         1,
         { path: 'never', types: 'never', lib: 'never' }
       ],
-      '@typescript-eslint/unbound-method': 0,
+      '@typescript-eslint/unbound-method': 0, // replaced by vitest/unbound-method
       '@typescript-eslint/unified-signatures': 0,
       '@typescript-eslint/use-unknown-in-catch-callback-variable': 1
     }
@@ -905,9 +894,7 @@ copy(
     files: ['test/**/*'],
 
     plugins: {
-      vitest,
-      'jest-dom': jestDom,
-      'testing-library': testingLibrary
+      vitest
     },
 
     rules: {
@@ -1022,55 +1009,12 @@ copy(
       'vitest/require-test-timeout': 0,
       'vitest/require-to-throw-message': 1,
       'vitest/require-top-level-describe': 0,
+      'vitest/unbound-method': 0,
       'vitest/valid-describe-callback': 1,
       'vitest/valid-expect': [1, { alwaysAwait: true }],
       'vitest/valid-expect-in-promise': 1,
       'vitest/valid-title': 1,
-      'vitest/warn-todo': 1,
-
-      // https://github.com/testing-library/eslint-plugin-jest-dom#supported-rules
-      'jest-dom/prefer-checked': 1,
-      'jest-dom/prefer-empty': 1,
-      'jest-dom/prefer-enabled-disabled': 1,
-      'jest-dom/prefer-focus': 1,
-      'jest-dom/prefer-in-document': 1,
-      'jest-dom/prefer-required': 1,
-      'jest-dom/prefer-to-have-attribute': 1,
-      'jest-dom/prefer-to-have-class': 1,
-      'jest-dom/prefer-to-have-style': 1,
-      'jest-dom/prefer-to-have-text-content': 1,
-      'jest-dom/prefer-to-have-value': 1,
-
-      // eslint-plugin-testing-library Rules
-      // https://github.com/testing-library/eslint-plugin-testing-library#supported-rules
-      'testing-library/await-async-events': 0,
-      'testing-library/await-async-queries': 0,
-      'testing-library/await-async-utils': 0,
-      'testing-library/consistent-data-testid': 0,
-      'testing-library/no-await-sync-events': 0,
-      'testing-library/no-await-sync-queries': 0,
-      'testing-library/no-container': 1,
-      'testing-library/no-debugging-utils': 1,
-      'testing-library/no-dom-import': 1,
-      'testing-library/no-global-regexp-flag-in-query': 1,
-      'testing-library/no-manual-cleanup': 0,
-      'testing-library/no-node-access': 0,
-      'testing-library/no-promise-in-fire-event': 0,
-      'testing-library/no-render-in-lifecycle': 0,
-      'testing-library/no-test-id-queries': 0,
-      'testing-library/no-unnecessary-act': 1,
-      'testing-library/no-wait-for-multiple-assertions': 1,
-      'testing-library/no-wait-for-side-effects': 1,
-      'testing-library/no-wait-for-snapshot': 0,
-      'testing-library/prefer-explicit-assert': 1,
-      'testing-library/prefer-find-by': 1,
-      'testing-library/prefer-implicit-assert': 0,
-      'testing-library/prefer-presence-queries': 0,
-      'testing-library/prefer-query-by-disappearance': 1,
-      'testing-library/prefer-query-matchers': 0,
-      'testing-library/prefer-screen-queries': 0,
-      'testing-library/prefer-user-event': 1,
-      'testing-library/render-result-naming-convention': 0
+      'vitest/warn-todo': 1
     }
   },
 
@@ -1103,20 +1047,38 @@ copy(
     name: 'markdown',
     files: ['**/*.md'],
     plugins: {
-      // @ts-expect-error
       markdown
     },
-    language: 'markdown/commonmark',
+    language: 'markdown/gfm',
     rules: {
+      // `@eslint/markdown` rules
+      // https://github.com/eslint/markdown/blob/main/README.md#rules
+      /*
+// copy all the rules from the rules table for easy pasting
+copy(
+  Iterator.from(
+    document
+      // select rules table
+      .querySelector('.markdown-heading:has(> a[href="#rules"]) ~ markdown-accessiblity-table tbody')
+      // select all rule links
+      .querySelectorAll(':any-link')
+  )
+    // map link to rule declaration
+    .map((link) => `'markdown/${link.textContent}': 1,`)
+    .toArray()
+    .join('\n')
+);
+      */
       'markdown/fenced-code-language': 1,
+      'markdown/fenced-code-meta': 0,
       'markdown/heading-increment': 1,
       'markdown/no-bare-urls': 1,
       'markdown/no-duplicate-definitions': 1,
-      'markdown/no-duplicate-headings': 0,
+      'markdown/no-duplicate-headings': [1, { checkSiblingsOnly: true }],
       'markdown/no-empty-definitions': 1,
       'markdown/no-empty-images': 1,
       'markdown/no-empty-links': 1,
-      'markdown/no-html': 0,
+      'markdown/no-html': [1, { allowed: ['br', 'kbd'] }],
       'markdown/no-invalid-label-refs': 1,
       'markdown/no-missing-atx-heading-space': 1,
       'markdown/no-missing-label-refs': 1,