@marinoscar/platform-web 0.1.0-next.3 → 0.1.0-next.4

package/dist/datatable/headless/types.d.ts.map

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

package/dist/datatable/headless/types.js

@@ -0,0 +1,12 @@
+/**
+ * DataTable — shared column contract.
+ *
+ * This module is the single public API every table in the app is built
+ * against. It is deliberately renderer-agnostic: the SAME `DataTableColumn[]`
+ * feeds the desktop DataGrid renderer (issue #252, this file's sibling
+ * `desktop/`) and the mobile card-list renderer (issue #253), and will feed
+ * filtering (#254), column visibility / saved views (#255), and
+ * virtualization / export (#256) without any column definition changing.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/datatable/headless/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/datatable/headless/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/datatable/headless/virtualization/cardVirtualization.d.ts

@@ -0,0 +1,101 @@
+/**
+ * DataTable — card-list render skipping (issue #256, epic #238).
+ *
+ * ## What this is, and what it deliberately is not
+ *
+ * Cards are variable height: a card's body grows with its `secondary` column
+ * count and its detail region expands in place. A windowing virtualizer needs a
+ * height estimate per item, and a WRONG estimate is not a small inefficiency —
+ * it is a scroll position that jumps under the user's thumb. Issue #237 is that
+ * bug, shipped: a gallery placeholder computed for the wrong column count made
+ * scrolling jump. An incorrect virtualizer is worse than none.
+ *
+ * So this is not a virtualizer. It is the browser's own render-skipping:
+ *
+ * - **`content-visibility: auto`** lets the engine skip layout, paint and style
+ *   for a card that is outside the viewport, and un-skip it when it approaches.
+ *   Unlike `display: none` the subtree stays focusable and find-in-page-able —
+ *   the browser force-renders it when focus or a find lands inside — so
+ *   keyboard navigation and Ctrl-F are unaffected.
+ * - **`contain-intrinsic-size: auto <measured>px`** supplies the placeholder
+ *   height while a card is skipped. The `auto` keyword makes the browser
+ *   remember each card's LAST RENDERED size and prefer it over the estimate, so
+ *   the estimate only ever has to be right for cards that have never been on
+ *   screen — and it is a *measurement* of a real card in this table, not a
+ *   guess derived from a column count.
+ * - **`loading="lazy"` on card images**, applied to whatever a column's `render`
+ *   produced. A card list of thumbnails otherwise fetches every image on the
+ *   page at once.
+ *
+ * ## Why the first card is excluded
+ *
+ * It is the one being measured. A card that may skip its own layout is a card
+ * whose `getBoundingClientRect()` can legitimately report the placeholder size,
+ * which would feed the measurement back into itself. The first card is on screen
+ * by definition, so skipping it would buy nothing anyway.
+ */
+/**
+ * Rows below which nothing is applied.
+ *
+ * `content-visibility` costs a containment context per card; below ~20 cards
+ * there is nothing to skip and the plain list is both simpler and faster.
+ *
+ * @stability experimental
+ */
+export declare const CARD_VIRTUALIZATION_MIN_ROWS = 20;
+/**
+ * Placeholder height used until a real card has been measured, in px.
+ *
+ * Only ever visible for the frames between mount and the first measurement, and
+ * only for cards that are already off screen.
+ *
+ * @stability experimental
+ */
+export declare const CARD_FALLBACK_INTRINSIC_HEIGHT = 168;
+/**
+ * Whether a card list of this size is worth skipping renders for.
+ *
+ * @stability experimental
+ */
+export declare function shouldVirtualizeCards(rowCount: number, minRows?: number): boolean;
+/**
+ * The `contain-intrinsic-size` value for a measured card height.
+ *
+ * `auto <length>` rather than a bare length: the browser then remembers each
+ * card's real rendered size and uses the length only for cards it has never
+ * laid out. That is what keeps the scrollbar honest as the user scrolls through
+ * cards of genuinely different heights.
+ *
+ * @stability experimental
+ */
+export declare function containIntrinsicSize(height: number | null | undefined): string;
+/**
+ * Measure one real card and report its height.
+ *
+ * A callback ref plus a `ResizeObserver`, so a card that reflows (a wider
+ * container, a density change, a longer value) updates the placeholder instead
+ * of pinning it to the first paint.
+ *
+ * @stability experimental
+ */
+export declare function useMeasuredCardHeight(enabled: boolean): {
+    /** Ref callback to attach to the element whose height is measured. */
+    measureRef: (node: HTMLElement | null) => void;
+    /** The measured height in pixels, or `null` before the first measurement. */
+    height: number | null;
+};
+/**
+ * Mark every image inside a subtree lazy, unless the author already said
+ * otherwise.
+ *
+ * A column's `render` is used verbatim and belongs to the calling page, so
+ * the card cannot rewrite it — but it can annotate what that render produced.
+ * An explicit `loading` attribute is never overwritten: a page that deliberately
+ * wrote `loading="eager"` on an above-the-fold thumbnail keeps it.
+ *
+ * @stability experimental
+ */
+export declare function useLazyImages(ref: {
+    current: HTMLElement | null;
+}, enabled?: boolean): void;
+//# sourceMappingURL=cardVirtualization.d.ts.map

package/dist/datatable/headless/virtualization/cardVirtualization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardVirtualization.d.ts","sourceRoot":"","sources":["../../../../src/datatable/headless/virtualization/cardVirtualization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAIH;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAKlD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,MAAqC,GAC7C,OAAO,CAET;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAG9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG;IACvD,sEAAsE;IACtE,UAAU,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/C,6EAA6E;IAC7E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAgCA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE;IAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,EACpC,OAAO,GAAE,OAAc,GACtB,IAAI,CASN"}

package/dist/datatable/headless/virtualization/cardVirtualization.js

@@ -0,0 +1,139 @@
+/**
+ * DataTable — card-list render skipping (issue #256, epic #238).
+ *
+ * ## What this is, and what it deliberately is not
+ *
+ * Cards are variable height: a card's body grows with its `secondary` column
+ * count and its detail region expands in place. A windowing virtualizer needs a
+ * height estimate per item, and a WRONG estimate is not a small inefficiency —
+ * it is a scroll position that jumps under the user's thumb. Issue #237 is that
+ * bug, shipped: a gallery placeholder computed for the wrong column count made
+ * scrolling jump. An incorrect virtualizer is worse than none.
+ *
+ * So this is not a virtualizer. It is the browser's own render-skipping:
+ *
+ * - **`content-visibility: auto`** lets the engine skip layout, paint and style
+ *   for a card that is outside the viewport, and un-skip it when it approaches.
+ *   Unlike `display: none` the subtree stays focusable and find-in-page-able —
+ *   the browser force-renders it when focus or a find lands inside — so
+ *   keyboard navigation and Ctrl-F are unaffected.
+ * - **`contain-intrinsic-size: auto <measured>px`** supplies the placeholder
+ *   height while a card is skipped. The `auto` keyword makes the browser
+ *   remember each card's LAST RENDERED size and prefer it over the estimate, so
+ *   the estimate only ever has to be right for cards that have never been on
+ *   screen — and it is a *measurement* of a real card in this table, not a
+ *   guess derived from a column count.
+ * - **`loading="lazy"` on card images**, applied to whatever a column's `render`
+ *   produced. A card list of thumbnails otherwise fetches every image on the
+ *   page at once.
+ *
+ * ## Why the first card is excluded
+ *
+ * It is the one being measured. A card that may skip its own layout is a card
+ * whose `getBoundingClientRect()` can legitimately report the placeholder size,
+ * which would feed the measurement back into itself. The first card is on screen
+ * by definition, so skipping it would buy nothing anyway.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+/**
+ * Rows below which nothing is applied.
+ *
+ * `content-visibility` costs a containment context per card; below ~20 cards
+ * there is nothing to skip and the plain list is both simpler and faster.
+ *
+ * @stability experimental
+ */
+export const CARD_VIRTUALIZATION_MIN_ROWS = 20;
+/**
+ * Placeholder height used until a real card has been measured, in px.
+ *
+ * Only ever visible for the frames between mount and the first measurement, and
+ * only for cards that are already off screen.
+ *
+ * @stability experimental
+ */
+export const CARD_FALLBACK_INTRINSIC_HEIGHT = 168;
+/** Re-measure only past this delta, so a 1px reflow cannot loop the state. */
+const MEASURE_EPSILON_PX = 4;
+/**
+ * Whether a card list of this size is worth skipping renders for.
+ *
+ * @stability experimental
+ */
+export function shouldVirtualizeCards(rowCount, minRows = CARD_VIRTUALIZATION_MIN_ROWS) {
+    return rowCount >= minRows;
+}
+/**
+ * The `contain-intrinsic-size` value for a measured card height.
+ *
+ * `auto <length>` rather than a bare length: the browser then remembers each
+ * card's real rendered size and uses the length only for cards it has never
+ * laid out. That is what keeps the scrollbar honest as the user scrolls through
+ * cards of genuinely different heights.
+ *
+ * @stability experimental
+ */
+export function containIntrinsicSize(height) {
+    const px = Math.max(1, Math.round(height ?? CARD_FALLBACK_INTRINSIC_HEIGHT));
+    return `auto ${px}px`;
+}
+/**
+ * Measure one real card and report its height.
+ *
+ * A callback ref plus a `ResizeObserver`, so a card that reflows (a wider
+ * container, a density change, a longer value) updates the placeholder instead
+ * of pinning it to the first paint.
+ *
+ * @stability experimental
+ */
+export function useMeasuredCardHeight(enabled) {
+    const [height, setHeight] = useState(null);
+    const observerRef = useRef(null);
+    const record = useCallback((next) => {
+        if (!Number.isFinite(next) || next <= 0)
+            return;
+        setHeight((current) => current !== null && Math.abs(current - next) < MEASURE_EPSILON_PX ? current : next);
+    }, []);
+    const measureRef = useCallback((node) => {
+        observerRef.current?.disconnect();
+        observerRef.current = null;
+        if (!node || !enabled)
+            return;
+        record(node.getBoundingClientRect().height);
+        if (typeof ResizeObserver === 'undefined')
+            return;
+        const observer = new ResizeObserver((entries) => {
+            for (const entry of entries)
+                record(entry.contentRect.height);
+        });
+        observer.observe(node);
+        observerRef.current = observer;
+    }, [enabled, record]);
+    useEffect(() => () => observerRef.current?.disconnect(), []);
+    return { measureRef, height: enabled ? height : null };
+}
+/**
+ * Mark every image inside a subtree lazy, unless the author already said
+ * otherwise.
+ *
+ * A column's `render` is used verbatim and belongs to the calling page, so
+ * the card cannot rewrite it — but it can annotate what that render produced.
+ * An explicit `loading` attribute is never overwritten: a page that deliberately
+ * wrote `loading="eager"` on an above-the-fold thumbnail keeps it.
+ *
+ * @stability experimental
+ */
+export function useLazyImages(ref, enabled = true) {
+    useEffect(() => {
+        const root = ref.current;
+        if (!enabled || !root)
+            return;
+        for (const image of Array.from(root.querySelectorAll('img'))) {
+            if (!image.hasAttribute('loading'))
+                image.setAttribute('loading', 'lazy');
+            if (!image.hasAttribute('decoding'))
+                image.setAttribute('decoding', 'async');
+        }
+    });
+}
+//# sourceMappingURL=cardVirtualization.js.map

package/dist/datatable/headless/virtualization/cardVirtualization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardVirtualization.js","sourceRoot":"","sources":["../../../../src/datatable/headless/virtualization/cardVirtualization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAElD,8EAA8E;AAC9E,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,UAAkB,4BAA4B;IAE9C,OAAO,QAAQ,IAAI,OAAO,CAAC;AAC7B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAiC;IACpE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,8BAA8B,CAAC,CAAC,CAAC;IAC7E,OAAO,QAAQ,EAAE,IAAI,CAAC;AACxB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IAMpD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,IAAY,EAAE,EAAE;QAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;YAAE,OAAO;QAChD,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CACpB,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CACnF,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,IAAwB,EAAE,EAAE;QAC3B,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;QAClC,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QAE9B,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,MAAM,CAAC,CAAC;QAE5C,IAAI,OAAO,cAAc,KAAK,WAAW;YAAE,OAAO;QAClD,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,CAAC,OAAO,EAAE,EAAE;YAC9C,KAAK,MAAM,KAAK,IAAI,OAAO;gBAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IACjC,CAAC,EACD,CAAC,OAAO,EAAE,MAAM,CAAC,CAClB,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACzD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAoC,EACpC,UAAmB,IAAI;IAEvB,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC;QACzB,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI;YAAE,OAAO;QAC9B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC7D,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC;gBAAE,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC1E,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC;gBAAE,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/datatable/headless/virtualization/gridVirtualization.d.ts

@@ -0,0 +1,118 @@
+/**
+ * DataTable — grid row virtualization (issue #256, epic #238).
+ *
+ * MUI X's DataGrid virtualizes rows out of the box, but with ONE precondition
+ * that is easy to miss and that this table tripped over from #252 onward:
+ *
+ * ```js
+ * // @mui/x-data-grid/hooks/features/virtualization/useGridVirtualization.js
+ * enabledForRows: !disableVirtualization && !autoHeight && HAS_LAYOUT
+ * ```
+ *
+ * `autoHeight` **disables row virtualization**, and `autoHeight` is exactly what
+ * this renderer uses whenever the caller omits `height` (the documented default:
+ * the table grows with its rows and the PAGE scrolls). So the default table
+ * was rendering every loaded row, virtualizer or not.
+ *
+ * The fix is not "always take a fixed height" — auto-height is the right
+ * behaviour for a 10- or 25-row page and turning every table into an internally
+ * scrolling box would be a worse regression than the one being fixed. It is a
+ * threshold: past {@link GRID_VIRTUALIZATION_ROW_THRESHOLD} loaded rows the grid
+ * takes a bounded viewport, which is precisely the condition under which
+ * virtualization pays for itself.
+ *
+ * ## Scale, honestly stated
+ *
+ * Every target table is server-paginated, and the MIT DataGrid throws above a
+ * 100-row page, so the realistic worst case is 100 rows plus a few synthetic
+ * tablet detail rows. This is **robustness for large page sizes**, not
+ * the performance strategy — the performance strategy is server-side
+ * pagination, and it already shipped in #252.
+ *
+ * Nothing here needs a custom virtualizer. `disableVirtualization` is left at
+ * its default (`false`) and the grid's own row/column windowing does the work;
+ * this module only decides whether the grid is *allowed* to use it.
+ *
+ * (In jsdom `HAS_LAYOUT` is false, so virtualization is off in tests no matter
+ * what — which is why the tests assert the *plan* and assert that selection is
+ * row-set-derived rather than DOM-derived.)
+ */
+import type { DataTableDensity } from '../types.js';
+/**
+ * Loaded-row count above which the grid swaps auto-height for a bounded,
+ * virtualizing viewport.
+ *
+ * 50 sits between the two page sizes that matter: the default 25-row page keeps
+ * growing naturally, a 100-row page virtualizes.
+ *
+ * @stability experimental
+ */
+export declare const GRID_VIRTUALIZATION_ROW_THRESHOLD = 50;
+/**
+ * Rows visible at once in a virtualized viewport, before scrolling.
+ *
+ * @stability experimental
+ */
+export declare const GRID_VIRTUALIZED_VISIBLE_ROWS = 12;
+/**
+ * MUI X row heights per density preset, in px.
+ *
+ * @stability experimental
+ */
+export declare const GRID_ROW_HEIGHT: Record<DataTableDensity, number>;
+/**
+ * Column header (56px) + footer (53px) — the chrome a viewport must also fit.
+ *
+ * @stability experimental
+ */
+export declare const GRID_CHROME_HEIGHT = 109;
+/**
+ * The height a virtualized viewport takes when the caller supplied none.
+ *
+ * @stability experimental
+ */
+export declare function virtualizedViewportHeight(density: DataTableDensity, rowCount: number, visibleRows?: number): number;
+/**
+ * How the desktop grid is virtualized for a given row count.
+ *
+ * @stability experimental
+ */
+export interface GridVirtualizationPlan {
+    /** Whether DataGrid's row virtualization is enabled for this render. */
+    virtualized: boolean;
+    /** What to pass as the grid's `autoHeight`. */
+    autoHeight: boolean;
+    /** Height for the scroll container, or `undefined` for auto-height. */
+    height: number | string | undefined;
+}
+/**
+ * What {@link planGridVirtualization} decides from.
+ *
+ * @stability experimental
+ */
+export interface GridVirtualizationInput {
+    /** Rows handed to the grid, INCLUDING any synthetic tablet detail rows. */
+    rowCount: number;
+    /** The caller's explicit `height` prop, if any. */
+    height?: number | string;
+    /** The row density in force. */
+    density: DataTableDensity;
+    /** Override for tests / unusual hosts. */
+    threshold?: number;
+}
+/**
+ * Decide how this render sizes itself, and therefore whether rows virtualize.
+ *
+ * Three cases:
+ *
+ * 1. **An explicit `height`** — the caller already asked for an internally
+ *    scrolling body, so virtualization is on and nothing is overridden.
+ * 2. **More loaded rows than the threshold** — auto-height is dropped in favour
+ *    of a computed viewport so the grid may virtualize.
+ * 3. **Anything else** — auto-height, unchanged from #252. The table grows with
+ *    its rows and the page scrolls.
+ *
+ * @stability experimental
+ */
+export declare function planGridVirtualization({ rowCount, height, density, threshold, }: GridVirtualizationInput): GridVirtualizationPlan;
+//# sourceMappingURL=gridVirtualization.d.ts.map

package/dist/datatable/headless/virtualization/gridVirtualization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridVirtualization.d.ts","sourceRoot":"","sources":["../../../../src/datatable/headless/virtualization/gridVirtualization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,KAAK,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAI5D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAsC,GAClD,MAAM,CAGR;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,WAAW,EAAE,OAAO,CAAC;IACrB,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAC;IACpB,uEAAuE;IACvE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,gCAAgC;IAChC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,QAAQ,EACR,MAAM,EACN,OAAO,EACP,SAA6C,GAC9C,EAAE,uBAAuB,GAAG,sBAAsB,CAUlD"}

package/dist/datatable/headless/virtualization/gridVirtualization.js

@@ -0,0 +1,107 @@
+/**
+ * DataTable — grid row virtualization (issue #256, epic #238).
+ *
+ * MUI X's DataGrid virtualizes rows out of the box, but with ONE precondition
+ * that is easy to miss and that this table tripped over from #252 onward:
+ *
+ * ```js
+ * // @mui/x-data-grid/hooks/features/virtualization/useGridVirtualization.js
+ * enabledForRows: !disableVirtualization && !autoHeight && HAS_LAYOUT
+ * ```
+ *
+ * `autoHeight` **disables row virtualization**, and `autoHeight` is exactly what
+ * this renderer uses whenever the caller omits `height` (the documented default:
+ * the table grows with its rows and the PAGE scrolls). So the default table
+ * was rendering every loaded row, virtualizer or not.
+ *
+ * The fix is not "always take a fixed height" — auto-height is the right
+ * behaviour for a 10- or 25-row page and turning every table into an internally
+ * scrolling box would be a worse regression than the one being fixed. It is a
+ * threshold: past {@link GRID_VIRTUALIZATION_ROW_THRESHOLD} loaded rows the grid
+ * takes a bounded viewport, which is precisely the condition under which
+ * virtualization pays for itself.
+ *
+ * ## Scale, honestly stated
+ *
+ * Every target table is server-paginated, and the MIT DataGrid throws above a
+ * 100-row page, so the realistic worst case is 100 rows plus a few synthetic
+ * tablet detail rows. This is **robustness for large page sizes**, not
+ * the performance strategy — the performance strategy is server-side
+ * pagination, and it already shipped in #252.
+ *
+ * Nothing here needs a custom virtualizer. `disableVirtualization` is left at
+ * its default (`false`) and the grid's own row/column windowing does the work;
+ * this module only decides whether the grid is *allowed* to use it.
+ *
+ * (In jsdom `HAS_LAYOUT` is false, so virtualization is off in tests no matter
+ * what — which is why the tests assert the *plan* and assert that selection is
+ * row-set-derived rather than DOM-derived.)
+ */
+/**
+ * Loaded-row count above which the grid swaps auto-height for a bounded,
+ * virtualizing viewport.
+ *
+ * 50 sits between the two page sizes that matter: the default 25-row page keeps
+ * growing naturally, a 100-row page virtualizes.
+ *
+ * @stability experimental
+ */
+export const GRID_VIRTUALIZATION_ROW_THRESHOLD = 50;
+/**
+ * Rows visible at once in a virtualized viewport, before scrolling.
+ *
+ * @stability experimental
+ */
+export const GRID_VIRTUALIZED_VISIBLE_ROWS = 12;
+/**
+ * MUI X row heights per density preset, in px.
+ *
+ * @stability experimental
+ */
+export const GRID_ROW_HEIGHT = {
+    compact: 36,
+    standard: 52,
+    comfortable: 67,
+};
+/**
+ * Column header (56px) + footer (53px) — the chrome a viewport must also fit.
+ *
+ * @stability experimental
+ */
+export const GRID_CHROME_HEIGHT = 109;
+/**
+ * The height a virtualized viewport takes when the caller supplied none.
+ *
+ * @stability experimental
+ */
+export function virtualizedViewportHeight(density, rowCount, visibleRows = GRID_VIRTUALIZED_VISIBLE_ROWS) {
+    const rowHeight = GRID_ROW_HEIGHT[density] ?? GRID_ROW_HEIGHT.standard;
+    return Math.min(rowCount, visibleRows) * rowHeight + GRID_CHROME_HEIGHT;
+}
+/**
+ * Decide how this render sizes itself, and therefore whether rows virtualize.
+ *
+ * Three cases:
+ *
+ * 1. **An explicit `height`** — the caller already asked for an internally
+ *    scrolling body, so virtualization is on and nothing is overridden.
+ * 2. **More loaded rows than the threshold** — auto-height is dropped in favour
+ *    of a computed viewport so the grid may virtualize.
+ * 3. **Anything else** — auto-height, unchanged from #252. The table grows with
+ *    its rows and the page scrolls.
+ *
+ * @stability experimental
+ */
+export function planGridVirtualization({ rowCount, height, density, threshold = GRID_VIRTUALIZATION_ROW_THRESHOLD, }) {
+    if (height != null)
+        return { virtualized: true, autoHeight: false, height };
+    if (rowCount > threshold) {
+        return {
+            virtualized: true,
+            autoHeight: false,
+            height: virtualizedViewportHeight(density, rowCount),
+        };
+    }
+    return { virtualized: false, autoHeight: true, height: undefined };
+}
+//# sourceMappingURL=gridVirtualization.js.map

package/dist/datatable/headless/virtualization/gridVirtualization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridVirtualization.js","sourceRoot":"","sources":["../../../../src/datatable/headless/virtualization/gridVirtualization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAC;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAqC;IAC/D,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAEtC;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAyB,EACzB,QAAgB,EAChB,cAAsB,6BAA6B;IAEnD,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC;IACvE,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,SAAS,GAAG,kBAAkB,CAAC;AAC1E,CAAC;AAgCD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,QAAQ,EACR,MAAM,EACN,OAAO,EACP,SAAS,GAAG,iCAAiC,GACrB;IACxB,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC5E,IAAI,QAAQ,GAAG,SAAS,EAAE,CAAC;QACzB,OAAO;YACL,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,KAAK;YACjB,MAAM,EAAE,yBAAyB,CAAC,OAAO,EAAE,QAAQ,CAAC;SACrD,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACrE,CAAC"}

package/dist/datatable/index.d.ts

@@ -0,0 +1,3 @@
+export { DataTable } from './ui/index.js';
+export type { DataTableColumn, DataTableRowAction } from './headless/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/datatable/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/datatable/index.js

@@ -0,0 +1,9 @@
+// The datatable slice's entry point for SIBLING SLICES of this package (issue
+// #899): the boundary lint lets one slice import another only through the
+// other's `index.ts`, and only when packages/platform-slices.json lists the
+// dependency (ai -> datatable). Not a package subpath: apps import
+// `@marinoscar/platform-web/datatable/headless` and `/datatable/ui`. Narrow on
+// purpose: only what a sibling uses (the table and the types of its columns
+// and row actions).
+export { DataTable } from './ui/index.js';
+//# sourceMappingURL=index.js.map

package/dist/datatable/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/datatable/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0EAA0E;AAC1E,4EAA4E;AAC5E,mEAAmE;AACnE,+EAA+E;AAC/E,4EAA4E;AAC5E,oBAAoB;AAEpB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,58 @@
+/**
+ * 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.
+ */
+/**
+ * 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 declare 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 declare const THIRD_PARTY_CHROME_SELECTOR = ".MuiDataGrid-columnHeaders, .MuiDataGrid-columnHeader";
+/** Human-readable identifier for a failing control, so a regression names the offender. */
+export declare function describeControl(control: HTMLElement): string;
+/**
+ * Options of {@link assertNoInvisibleHitTargets}.
+ *
+ * @stability experimental
+ */
+export interface AssertNoInvisibleHitTargetsOptions {
+    /**
+     * Overrides `DEFAULT_VISIBLE_CONTROL_SELECTOR`. The export suite
+     * passes this with `, [role="menuitem"]` appended, since its export menu's
+     * controls are menu items rather than plain buttons or checkboxes.
+     */
+    selector?: string;
+    /** Selector for third-party chrome the sweep skips. */
+    thirdPartyChrome?: string;
+}
+/**
+ * Sweep every visible control under `root` and fail — naming the offender —
+ * if any is `opacity: 0` while remaining hit-testable.
+ *
+ * @stability experimental
+ */
+export declare function assertNoInvisibleHitTargets(root: HTMLElement, options?: AssertNoInvisibleHitTargetsOptions): void;
+//# sourceMappingURL=a11yGuards.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"a11yGuards.d.ts","sourceRoot":"","sources":["../../../src/datatable/testing/a11yGuards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gCAAgC,0DAAwD,CAAC;AAEtG,8EAA8E;AAC9E,eAAO,MAAM,2BAA2B,0DAA0D,CAAC;AAEnG,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAG5D;AAED;;;;GAIG;AACH,MAAM,WAAW,kCAAkC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,kCAAuC,GAC/C,IAAI,CAiBN"}