@marinoscar/platform-web 0.0.0-stage → 0.1.0-next.4

package/dist/datatable/testing/a11yGuards.js

@@ -0,0 +1,59 @@
+/**
+ * DataTable test suites — shared issue #243 regression guard.
+ *
+ * The rule, stated once: no control may be hidden with `opacity: 0` while
+ * remaining hit-testable (`pointer-events` anything other than `none`). That
+ * is the exact bug filed as issue #243 — a hover-revealed control that sat at
+ * `opacity: 0` on a touch device stayed fully tappable, silently starring
+ * photos the user could not see.
+ *
+ * Before issue #257 this guard was copy-pasted, with tiny drifts, into FOUR
+ * test files (`ResponsiveDataTable.test.tsx`, `DataTableFilters.test.tsx`,
+ * `DataTableLayoutPrefs.test.tsx`, `DataTableExport.test.tsx` — the export
+ * suite's copy additionally swept `[role="menuitem"]`, since its menu's
+ * controls are menu items rather than bare buttons). This module is the one
+ * copy; every one of those files, plus the new shared conformance suite
+ * (`conformance/runDataTableConformanceSuite.tsx`), imports it instead of
+ * redefining it.
+ */
+import { expect } from 'vitest';
+/**
+ * The *visible* controls a sweep should ever consider — i.e. the ones whose
+ * disappearance while remaining tappable would be a bug.
+ *
+ * Two deliberate exclusions, unchanged from the original guard:
+ *  - Bare `<input>`: MUI's Checkbox/Radio put a transparent native input
+ *    exactly on top of a painted SVG. That is the correct pattern (the hit
+ *    target coincides with a visible affordance) and is the opposite of
+ *    #243, so the sweep looks at the painted `.MuiCheckbox-root` instead.
+ *  - MUI X's own hover-revealed column-header chrome (sort/menu buttons) —
+ *    not ours to assert on, and reachable by keyboard regardless.
+ */
+export const DEFAULT_VISIBLE_CONTROL_SELECTOR = 'button, [role="button"], .MuiCheckbox-root, a[href]';
+/** Selector for third-party (MUI X) chrome the sweep should not walk into. */
+export const THIRD_PARTY_CHROME_SELECTOR = '.MuiDataGrid-columnHeaders, .MuiDataGrid-columnHeader';
+/** Human-readable identifier for a failing control, so a regression names the offender. */
+export function describeControl(control) {
+    const label = control.getAttribute('aria-label') ?? control.textContent?.slice(0, 24) ?? '';
+    return `${control.tagName.toLowerCase()}[${label}]`;
+}
+/**
+ * Sweep every visible control under `root` and fail — naming the offender —
+ * if any is `opacity: 0` while remaining hit-testable.
+ *
+ * @stability experimental
+ */
+export function assertNoInvisibleHitTargets(root, options = {}) {
+    const selector = options.selector ?? DEFAULT_VISIBLE_CONTROL_SELECTOR;
+    const thirdPartyChrome = options.thirdPartyChrome ?? THIRD_PARTY_CHROME_SELECTOR;
+    const controls = Array.from(root.querySelectorAll(selector)).filter((control) => !control.closest(thirdPartyChrome));
+    expect(controls.length).toBeGreaterThan(0);
+    const offenders = controls
+        .filter((control) => {
+        const style = getComputedStyle(control);
+        return style.opacity === '0' && style.pointerEvents !== 'none';
+    })
+        .map(describeControl);
+    expect(offenders).toEqual([]);
+}
+//# sourceMappingURL=a11yGuards.js.map

package/dist/datatable/testing/a11yGuards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11yGuards.js","sourceRoot":"","sources":["../../../src/datatable/testing/a11yGuards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,qDAAqD,CAAC;AAEtG,8EAA8E;AAC9E,MAAM,CAAC,MAAM,2BAA2B,GAAG,uDAAuD,CAAC;AAEnG,2FAA2F;AAC3F,MAAM,UAAU,eAAe,CAAC,OAAoB;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IAC5F,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,KAAK,GAAG,CAAC;AACtD,CAAC;AAkBD;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAiB,EACjB,UAA8C,EAAE;IAEhD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,gCAAgC,CAAC;IACtE,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,2BAA2B,CAAC;IAEjF,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAc,QAAQ,CAAC,CAAC,CAAC,MAAM,CAC9E,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAChD,CAAC;IACF,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAE3C,MAAM,SAAS,GAAG,QAAQ;SACvB,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QAClB,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC,OAAO,KAAK,GAAG,IAAI,KAAK,CAAC,aAAa,KAAK,MAAM,CAAC;IACjE,CAAC,CAAC;SACD,GAAG,CAAC,eAAe,CAAC,CAAC;IAExB,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/dist/datatable/testing/dom-matchers.d.ts

@@ -0,0 +1,11 @@
+declare module 'vitest' {
+    interface Assertion<T = any> {
+        toBeInTheDocument(): void;
+        toHaveAttribute(name: string, value?: unknown): void;
+        toHaveTextContent(text?: string | RegExp, options?: {
+            normalizeWhitespace: boolean;
+        }): void;
+    }
+}
+export {};
+//# sourceMappingURL=dom-matchers.d.ts.map

package/dist/datatable/testing/dom-matchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-matchers.d.ts","sourceRoot":"","sources":["../../../src/datatable/testing/dom-matchers.ts"],"names":[],"mappings":"AAQA,OAAO,QAAQ,QAAQ,CAAC;IACtB,UAAU,SAAS,CAAC,CAAC,GAAG,GAAG;QACzB,iBAAiB,IAAI,IAAI,CAAC;QAC1B,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QACrD,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE;YAAE,mBAAmB,EAAE,OAAO,CAAA;SAAE,GAAG,IAAI,CAAC;KAC7F;CACF;AAED,OAAO,EAAE,CAAC"}

package/dist/datatable/testing/dom-matchers.js

@@ -0,0 +1,9 @@
+// The three Testing Library DOM matchers the conformance suite asserts with,
+// declared on vitest's `Assertion` so the package compiles without
+// `@testing-library/jest-dom`'s own augmentation (which a CommonJS type
+// resolution attaches to a different `vitest` declaration file than the one
+// this ESM package imports). The runtime side is the host's test setup, which
+// registers jest-dom (`import '@testing-library/jest-dom/vitest'`), as the
+// reference app and this package's own `test/setup.ts` do.
+export {};
+//# sourceMappingURL=dom-matchers.js.map

package/dist/datatable/testing/dom-matchers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-matchers.js","sourceRoot":"","sources":["../../../src/datatable/testing/dom-matchers.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,mEAAmE;AACnE,wEAAwE;AACxE,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,2DAA2D"}

package/dist/datatable/testing/index.d.ts

@@ -0,0 +1,6 @@
+export { conformanceFixtureColumns, conformanceFixtureRowId, conformanceFixtureRows, runDataTableConformanceSuite, } from './runDataTableConformanceSuite.js';
+export type { ConformanceRow, DataTableConformanceOptions, DataTableConformanceThemes } from './runDataTableConformanceSuite.js';
+export { assertNoInvisibleHitTargets } from './a11yGuards.js';
+export type { AssertNoInvisibleHitTargetsOptions } from './a11yGuards.js';
+export { CARD_HEIGHT, VIEWPORT_HEIGHT, VIEWPORT_WIDTH, installLayoutStubs, resetContainerWidth, setContainerWidth, setInitialContainerWidth, } from './layoutStubs.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/datatable/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/datatable/testing/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACjI,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EAAE,kCAAkC,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/datatable/testing/index.js

@@ -0,0 +1,10 @@
+// `@marinoscar/platform-web/datatable/testing`: the DataTable's test support.
+// `runDataTableConformanceSuite` runs the mechanics suite against a fixture
+// table (or a page's own columns), and `layoutStubs` gives jsdom a layout.
+// Test-only: never import it from production code. Needs `vitest`,
+// `@testing-library/react`, `@testing-library/user-event` and `vitest-axe`.
+// Documented in ../README.md.
+export { conformanceFixtureColumns, conformanceFixtureRowId, conformanceFixtureRows, runDataTableConformanceSuite, } from './runDataTableConformanceSuite.js';
+export { assertNoInvisibleHitTargets } from './a11yGuards.js';
+export { CARD_HEIGHT, VIEWPORT_HEIGHT, VIEWPORT_WIDTH, installLayoutStubs, resetContainerWidth, setContainerWidth, setInitialContainerWidth, } from './layoutStubs.js';
+//# sourceMappingURL=index.js.map

package/dist/datatable/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/datatable/testing/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4EAA4E;AAC5E,2EAA2E;AAC3E,mEAAmE;AACnE,4EAA4E;AAC5E,8BAA8B;AAE9B,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/datatable/testing/layoutStubs.d.ts

@@ -0,0 +1,61 @@
+/**
+ * DataTable test suites — shared jsdom layout stub recipe.
+ *
+ * jsdom performs no real layout, so both the container-width hook
+ * (`useContainerLayout.ts`) and MUI X's own row virtualizer would otherwise
+ * measure a 0×0 viewport. This module is the "#253 recipe" (first written for
+ * `ResponsiveDataTable.test.tsx`, extended in `DataTableExport.test.tsx` for
+ * card-height measurement) as one reusable, documented module — issue #257's
+ * shared conformance suite is built on it, and it is safe for any future
+ * DataTable test file to import instead of re-deriving its own copy.
+ *
+ * `window.matchMedia` is pinned to a FIXED 1440px viewport, so every viewport
+ * media query in the tree answers "desktop" — the only way a `mobile` layout
+ * result can be trusted to have come from the CONTAINER measurement rather
+ * than an accidental viewport match (the drawer case, issue #261).
+ */
+/**
+ * The viewport width the layout stubs report, in pixels.
+ *
+ * @stability experimental
+ */
+export declare const VIEWPORT_WIDTH = 1440;
+/**
+ * The viewport height the layout stubs report, in pixels.
+ *
+ * @stability experimental
+ */
+export declare const VIEWPORT_HEIGHT = 900;
+/** A card reports a card-sized height so a "measured placeholder" assertion
+ * measures something real rather than the stubbed viewport. *
+ * @stability experimental
+ */
+export declare const CARD_HEIGHT = 220;
+/** Mutated by {@link setContainerWidth}; read by every stubbed geometry getter. */
+export declare let containerWidth: number;
+/**
+ * Install the geometry + ResizeObserver + matchMedia stubs onto the shared
+ * jsdom globals. Call once, in a `beforeAll`.
+ *
+ * @stability experimental
+ */
+export declare function installLayoutStubs(): void;
+/**
+ * Reset the container to a desktop-sized default. Call in a `beforeEach`.
+ *
+ * @stability experimental
+ */
+export declare function resetContainerWidth(width?: number): void;
+/**
+ * Set the width used by the NEXT render (no resize observers fired).
+ *
+ * @stability experimental
+ */
+export declare function setInitialContainerWidth(width: number): void;
+/**
+ * Resize the container and let every live observer report the new width.
+ *
+ * @stability experimental
+ */
+export declare function setContainerWidth(width: number): void;
+//# sourceMappingURL=layoutStubs.d.ts.map

package/dist/datatable/testing/layoutStubs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutStubs.d.ts","sourceRoot":"","sources":["../../../src/datatable/testing/layoutStubs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH;;;;GAIG;AACH,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC;;;;GAIG;AACH,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC;;;GAGG;AACH,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B,mFAAmF;AACnF,eAAO,IAAI,cAAc,QAAO,CAAC;AASjC;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAuFzC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,SAAO,GAAG,IAAI,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAKrD"}

package/dist/datatable/testing/layoutStubs.js

@@ -0,0 +1,154 @@
+/**
+ * DataTable test suites — shared jsdom layout stub recipe.
+ *
+ * jsdom performs no real layout, so both the container-width hook
+ * (`useContainerLayout.ts`) and MUI X's own row virtualizer would otherwise
+ * measure a 0×0 viewport. This module is the "#253 recipe" (first written for
+ * `ResponsiveDataTable.test.tsx`, extended in `DataTableExport.test.tsx` for
+ * card-height measurement) as one reusable, documented module — issue #257's
+ * shared conformance suite is built on it, and it is safe for any future
+ * DataTable test file to import instead of re-deriving its own copy.
+ *
+ * `window.matchMedia` is pinned to a FIXED 1440px viewport, so every viewport
+ * media query in the tree answers "desktop" — the only way a `mobile` layout
+ * result can be trusted to have come from the CONTAINER measurement rather
+ * than an accidental viewport match (the drawer case, issue #261).
+ */
+import { vi } from 'vitest';
+import { act } from '@testing-library/react';
+/**
+ * The viewport width the layout stubs report, in pixels.
+ *
+ * @stability experimental
+ */
+export const VIEWPORT_WIDTH = 1440;
+/**
+ * The viewport height the layout stubs report, in pixels.
+ *
+ * @stability experimental
+ */
+export const VIEWPORT_HEIGHT = 900;
+/** A card reports a card-sized height so a "measured placeholder" assertion
+ * measures something real rather than the stubbed viewport. *
+ * @stability experimental
+ */
+export const CARD_HEIGHT = 220;
+/** Mutated by {@link setContainerWidth}; read by every stubbed geometry getter. */
+export let containerWidth = 1400;
+const observers = new Set();
+/**
+ * Install the geometry + ResizeObserver + matchMedia stubs onto the shared
+ * jsdom globals. Call once, in a `beforeAll`.
+ *
+ * @stability experimental
+ */
+export function installLayoutStubs() {
+    for (const prop of ['clientWidth', 'offsetWidth', 'scrollWidth']) {
+        Object.defineProperty(HTMLElement.prototype, prop, {
+            configurable: true,
+            get: () => containerWidth,
+        });
+    }
+    for (const prop of ['clientHeight', 'offsetHeight', 'scrollHeight']) {
+        Object.defineProperty(HTMLElement.prototype, prop, {
+            configurable: true,
+            get: () => VIEWPORT_HEIGHT,
+        });
+    }
+    HTMLElement.prototype.getBoundingClientRect = function getBoundingClientRect() {
+        const isCard = this.getAttribute?.('data-testid') === 'datatable-card';
+        const height = isCard ? CARD_HEIGHT : VIEWPORT_HEIGHT;
+        return {
+            width: containerWidth,
+            height,
+            top: 0,
+            left: 0,
+            right: containerWidth,
+            bottom: height,
+            x: 0,
+            y: 0,
+            toJSON: () => ({}),
+        };
+    };
+    class ControllableResizeObserver {
+        entry;
+        constructor(callback) {
+            this.entry = {
+                targets: new Set(),
+                fire: () => {
+                    const entries = Array.from(this.entry.targets, (target) => ({
+                        target,
+                        contentRect: {
+                            width: containerWidth,
+                            height: target.getAttribute('data-testid') === 'datatable-card'
+                                ? CARD_HEIGHT
+                                : VIEWPORT_HEIGHT,
+                        },
+                    }));
+                    if (entries.length > 0)
+                        callback(entries, this);
+                },
+            };
+            observers.add(this.entry);
+        }
+        observe(target) {
+            this.entry.targets.add(target);
+            this.entry.fire();
+        }
+        unobserve(target) {
+            this.entry.targets.delete(target);
+        }
+        disconnect() {
+            this.entry.targets.clear();
+            observers.delete(this.entry);
+        }
+    }
+    globalThis.ResizeObserver = ControllableResizeObserver;
+    window.matchMedia = vi.fn().mockImplementation((query) => {
+        const max = /max-width:\s*([\d.]+)px/.exec(query);
+        const min = /min-width:\s*([\d.]+)px/.exec(query);
+        let matches = true;
+        if (max)
+            matches = matches && VIEWPORT_WIDTH <= Number.parseFloat(max[1]);
+        if (min)
+            matches = matches && VIEWPORT_WIDTH >= Number.parseFloat(min[1]);
+        return {
+            matches,
+            media: query,
+            onchange: null,
+            addListener: vi.fn(),
+            removeListener: vi.fn(),
+            addEventListener: vi.fn(),
+            removeEventListener: vi.fn(),
+            dispatchEvent: vi.fn(),
+        };
+    });
+}
+/**
+ * Reset the container to a desktop-sized default. Call in a `beforeEach`.
+ *
+ * @stability experimental
+ */
+export function resetContainerWidth(width = 1400) {
+    containerWidth = width;
+}
+/**
+ * Set the width used by the NEXT render (no resize observers fired).
+ *
+ * @stability experimental
+ */
+export function setInitialContainerWidth(width) {
+    containerWidth = width;
+}
+/**
+ * Resize the container and let every live observer report the new width.
+ *
+ * @stability experimental
+ */
+export function setContainerWidth(width) {
+    containerWidth = width;
+    act(() => {
+        observers.forEach((observer) => observer.fire());
+    });
+}
+//# sourceMappingURL=layoutStubs.js.map

package/dist/datatable/testing/layoutStubs.js.map

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

package/dist/datatable/testing/runDataTableConformanceSuite.d.ts

@@ -0,0 +1,143 @@
+/**
+ * DataTable — the shared conformance suite (issue #257, epic #238).
+ *
+ * The point of this module, stated in the issue that created it: the
+ * component replaces 16 hand-rolled tables, so whatever regression surface it
+ * has is inherited by every one of them at once. The migration issues
+ * (#258–#261) should only ever need to write PAGE-specific tests — their own
+ * column definitions, their own business logic — never table MECHANICS.
+ * Mechanics are tested exactly once, here, against a fixture table, and every
+ * migrated page gets that coverage for free by calling
+ * {@link runDataTableConformanceSuite}.
+ *
+ * ## How a page uses this
+ *
+ * The zero-argument call is what `DataTableConformance.test.tsx` in this
+ * directory does — it runs the whole suite against the built-in fixture below
+ * and IS the DataTable component's own regression suite for #257's
+ * requirements. A migrating page (#258 onward) does not usually need to call
+ * this at all: table mechanics don't change per column set, so the coverage
+ * below already applies to every table built on this component. The one
+ * reason a page WOULD call it is a column whose `render` produces something
+ * unusual (a multi-control cell, an embedded form) where "does keyboard nav
+ * survive this specific custom content" is worth re-asking against the page's
+ * own columns:
+ *
+ * ```tsx
+ * import { runDataTableConformanceSuite } from '@marinoscar/platform-web/datatable/testing';
+ *
+ * describe('JobsTable', () => {
+ *   runDataTableConformanceSuite({
+ *     label: 'JobsTable',
+ *     columns: jobsTableColumns,   // the page's real DataTableColumn[]
+ *     rows: sampleJobs,
+ *     rowId: (job) => job.id,
+ *   });
+ *
+ *   // ...page-specific tests only: business logic behind bulk actions,
+ *   // the page's own fetch-and-map layer, column-specific rendering, etc.
+ * });
+ * ```
+ *
+ * See below for the accessibility contract and keyboard model this suite
+ * enforces, and for the full "what a migrating page still needs to test"
+ * contract.
+ *
+ * ## What it covers
+ *
+ * Renderer switching + state preservation across a resize; server-side
+ * pagination/sort/filter round-trips; selection and select-all including
+ * under virtualization; loading/empty/error states in both renderers; column
+ * visibility, density and persisted-view defaults; CSV escaping; the issue
+ * #243 "invisible but tappable" guard; "no horizontal document scroll at
+ * 360px"; automated axe checks in both renderers and both themes; the row/list
+ * semantics, live-region announcements, and focus-management rules from the
+ * accessibility contract; and that DataGrid's own keyboard cell
+ * navigation survives a column whose `render` produces interactive content
+ * (chips, links, buttons).
+ */
+import type { Theme } from '@mui/material/styles';
+import 'vitest-axe/extend-expect';
+import './dom-matchers.js';
+import type { DataTableColumn } from '../headless/types.js';
+/**
+ * A row of the conformance suite's built-in fixture.
+ *
+ * @stability experimental
+ */
+export interface ConformanceRow {
+    /** The row id. */
+    id: string;
+    /** The row's name. */
+    name: string;
+    /** The row's status. */
+    status: 'active' | 'paused' | 'archived';
+    /** The row's owner. */
+    owner: string;
+    /** The row's score. */
+    score: number;
+    /** Free text, or `null`. */
+    notes: string | null;
+}
+/**
+ * The conformance suite's built-in fixture rows.
+ *
+ * @stability experimental
+ */
+export declare const conformanceFixtureRows: ConformanceRow[];
+/**
+ * The id of a fixture row.
+ *
+ * @param row - a fixture row.
+ * @returns its id.
+ *
+ * @stability experimental
+ */
+export declare const conformanceFixtureRowId: (row: ConformanceRow) => string;
+/**
+ * Deliberately exercises every corner of the column contract a page might
+ * lean on: a `render`-only chip (status), a `render`ed interactive LINK
+ * (owner) — the specific case that must survive DataGrid's own cell keyboard
+ * navigation — a sortable+filterable number, and a `detail`+`truncate`
+ * column with a null value in the fixture (row-1/row-3/row-5).
+ *
+ * @stability experimental
+ */
+export declare const conformanceFixtureColumns: DataTableColumn<ConformanceRow>[];
+/**
+ * The two themes the suite renders under (the axe passes run in both).
+ *
+ * @stability experimental
+ */
+export interface DataTableConformanceThemes {
+    /** The light theme. */
+    light: Theme;
+    /** The dark theme. */
+    dark: Theme;
+}
+/**
+ * Options of {@link runDataTableConformanceSuite}.
+ *
+ * @stability experimental
+ */
+export interface DataTableConformanceOptions<Row> {
+    /** Prefixes every `describe` block. Default `'DataTable'`. */
+    label?: string;
+    /** The columns under test. Default: the built-in fixture's. */
+    columns?: DataTableColumn<Row>[];
+    /** The rows under test. Default: the built-in fixture's. */
+    rows?: Row[];
+    /** Row id extractor. Default: the fixture's. */
+    rowId?: (row: Row) => string;
+    /** The themes to render under. Default: MUI's light and dark defaults; an app passes its own. */
+    themes?: DataTableConformanceThemes;
+}
+/**
+ * Runs the full shared conformance suite. Call this at the top of a
+ * `describe` block (or at module scope) — see the module docblock for the
+ * default-fixture vs. custom-fixture usage split.
+ *
+ * @stability experimental
+ */
+export declare function runDataTableConformanceSuite<Row = ConformanceRow>(options?: DataTableConformanceOptions<Row>): void;
+//# sourceMappingURL=runDataTableConformanceSuite.d.ts.map

package/dist/datatable/testing/runDataTableConformanceSuite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runDataTableConformanceSuite.d.ts","sourceRoot":"","sources":["../../../src/datatable/testing/runDataTableConformanceSuite.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAeH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAGlD,OAAO,0BAA0B,CAAC;AAClC,OAAO,mBAAmB,CAAC;AAI3B,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,sBAAsB,CAAC;AAa9B;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IACzC,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,cAAc,EAalD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAAI,KAAK,cAAc,WAAW,CAAC;AAEvE;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,EAAE,eAAe,CAAC,cAAc,CAAC,EA0DtE,CAAC;AA8BF;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,uBAAuB;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,sBAAsB;IACtB,IAAI,EAAE,KAAK,CAAC;CACb;AAOD;;;;GAIG;AACH,MAAM,WAAW,2BAA2B,CAAC,GAAG;IAC9C,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;IACjC,4DAA4D;IAC5D,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACb,gDAAgD;IAChD,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;IAC7B,iGAAiG;IACjG,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,GAAG,cAAc,EAC/D,OAAO,GAAE,2BAA2B,CAAC,GAAG,CAAM,GAC7C,IAAI,CAmwBN"}