@dashforge/tw 0.6.0-beta → 0.7.0-beta

package/dist/src/components/_shared/data/useVirtualizer.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Window descriptor — which slice of the row array is currently
+ * mounted in DOM, and how much spacer height to render above and
+ * below the visible window so the scrollbar size matches the
+ * "virtual" total height.
+ */
+export interface VirtualizerWindow {
+    /** First row index inside the visible window (inclusive). */
+    startIndex: number;
+    /** Last row index inside the visible window (inclusive). */
+    endIndex: number;
+    /** Pixels to render above the visible rows (spacer top). */
+    paddingTop: number;
+    /** Pixels to render below the visible rows (spacer bottom). */
+    paddingBottom: number;
+}
+export interface UseVirtualizerArgs {
+    /** Total number of rows in the underlying data set. */
+    totalCount: number;
+    /** Fixed row height in pixels. */
+    rowHeight: number;
+    /**
+     * Visible viewport height in pixels. Pass the height of the
+     * scroll container.
+     */
+    viewportHeight: number;
+    /** Current scrollTop of the scroll container. */
+    scrollTop: number;
+    /**
+     * How many extra rows to render above / below the visible window
+     * for smoother scrolling (reduces blank-flash on fast scroll).
+     * @default 5
+     */
+    overscan?: number;
+}
+/**
+ * Compute the visible window of rows + the spacer heights given the
+ * current scroll position. Pure function — exported for testability.
+ *
+ * @example
+ * ```ts
+ * computeWindow({ totalCount: 1000, rowHeight: 48, viewportHeight: 600,
+ *                 scrollTop: 0, overscan: 5 });
+ * // → { startIndex: 0, endIndex: 17, paddingTop: 0, paddingBottom: 47136 }
+ * ```
+ */
+export declare function computeWindow(args: UseVirtualizerArgs): VirtualizerWindow;
+/**
+ * `useVirtualizer` — viewport-based row windowing for `<DataGrid>`.
+ *
+ * Hand-rolled (no `@tanstack/react-virtual` dep — constraint memorized
+ * in `feedback_dashforge_preset_is_identity` companion: "no new
+ * external runtime deps"). Uses scroll event + `requestAnimationFrame`
+ * debounce + `ResizeObserver` on the container. Fixed row height
+ * only in v1 — variable-height with measurement cache deferred to
+ * v1-bis.
+ *
+ * Returns:
+ *  - `scrollRef`: attach to the scroll container `<div>`.
+ *  - `window`: which row indices to mount + top/bottom spacer heights
+ *    to preserve scroll-area size.
+ *  - `viewportHeight`: current container height (re-measured on
+ *    `ResizeObserver` ticks).
+ *
+ * The DataGrid renders `rows.slice(window.startIndex, window.endIndex + 1)`
+ * between two spacer `<tr style={{ height: paddingTop }} />` elements
+ * (above and below). This preserves `<table>` semantics — screen
+ * readers see a continuous structure with `aria-hidden` spacers.
+ *
+ * @example
+ * ```tsx
+ * const { scrollRef, window } = useVirtualizer({
+ *   totalCount: rows.length,
+ *   rowHeight: 48,
+ *   overscan: 5,
+ * });
+ *
+ * return (
+ *   <div ref={scrollRef} style={{ height: 600, overflow: 'auto' }}>
+ *     <table>
+ *       <tbody>
+ *         <tr aria-hidden="true" style={{ height: window.paddingTop }} />
+ *         {rows.slice(window.startIndex, window.endIndex + 1).map(...)}
+ *         <tr aria-hidden="true" style={{ height: window.paddingBottom }} />
+ *       </tbody>
+ *     </table>
+ *   </div>
+ * );
+ * ```
+ */
+export declare function useVirtualizer(args: {
+    totalCount: number;
+    rowHeight: number;
+    overscan?: number;
+    /**
+     * Initial viewport height — used before the ResizeObserver
+     * settles on first paint. Pass an explicit `height` prop value
+     * if you have one; otherwise the hook re-measures on layout.
+     * @default 400
+     */
+    initialViewportHeight?: number;
+}): {
+    scrollRef: React.RefObject<HTMLDivElement | null>;
+    window: VirtualizerWindow;
+    viewportHeight: number;
+};
+//# sourceMappingURL=useVirtualizer.d.ts.map

package/dist/src/components/_shared/data/useVirtualizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVirtualizer.d.ts","sourceRoot":"","sources":["../../../../../src/components/_shared/data/useVirtualizer.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,CAmBzE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,GAAG;IACF,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAClD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB,CAqEA"}

package/dist/src/index.d.ts

@@ -119,7 +119,10 @@ export type { TableProps, TableColumn, TableColumnInferredType, TableCellContext
 export { tableVariants } from './components/Table/table.variants.js';
 export { RenderText, RenderTwoLine, RenderChip, RenderButton, RowActionsMenu, } from './components/Table/cells/index.js';
 export type { RenderTextProps, RenderTwoLineProps, RenderChipProps, RenderButtonProps, RowActionsMenuProps, TableRowAction, } from './components/Table/cells/index.js';
-export { getNestedValue } from './components/Table/_internal/getNestedValue.js';
+export { getNestedValue } from './components/_shared/data/getNestedValue.js';
+export { DataGrid } from './components/DataGrid/DataGrid.js';
+export type { DataGridProps, DataGridSlotProps, DataGridSelectAllScope, DataGridServerSideFlags, DataGridPaginationConfig, } from './components/DataGrid/dataGrid.types.js';
+export { dataGridVariants } from './components/DataGrid/dataGrid.variants.js';
 export { useAccessState } from './hooks/useAccessState.js';
 export { cn } from './utils/cn.js';
 export { tv } from 'tailwind-variants';
@@ -127,5 +130,5 @@ export type { VariantProps } from 'tailwind-variants';
 /**
  * Package version (synced with `package.json` at publish time).
  */
-export declare const VERSION = "0.6.0-beta";
+export declare const VERSION = "0.7.0-beta";
 //# sourceMappingURL=index.d.ts.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dashforge/tw",
-  "version": "0.6.0-beta",
+  "version": "0.7.0-beta",
   "private": false,
   "type": "module",
   "main": "./dist/index.esm.js",
@@ -31,8 +31,8 @@
     "tailwind-variants": "^3.1.1",
     "vitest": "*",
     "@dashforge/forms": "0.2.3-beta",
-    "@dashforge/rbac": "0.2.3-beta",
-    "@dashforge/ui-core": "0.2.3-beta"
+    "@dashforge/ui-core": "0.2.3-beta",
+    "@dashforge/rbac": "0.2.3-beta"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",

package/src/components/Accordion/accordion.variants.ts

@@ -3,11 +3,13 @@ import { tv, type VariantProps } from 'tailwind-variants';
 export const accordionVariants = tv({
   slots: {
     root: 'w-full',
-    item: 'border-b border-neutral-200 dark:border-neutral-800',
+    // Neutral palette auto-inverts via the dashforgePreset() CSS-var
+    // swap — no `dark:` variant needed (would double-invert).
+    item: 'border-b border-neutral-200',
     header: 'flex',
     trigger: [
       'flex flex-1 items-center justify-between py-3 text-left',
-      'text-sm font-medium text-neutral-900 dark:text-neutral-50',
+      'text-sm font-medium text-neutral-900',
       'transition-all hover:underline',
       'focus:outline-none focus-visible:ring-2 focus-visible:ring-primary-500 focus-visible:rounded',
       '[&[data-state=open]>svg]:rotate-180',
@@ -15,7 +17,7 @@ export const accordionVariants = tv({
       'motion-reduce:transition-none',
     ],
     content: [
-      'overflow-hidden text-sm text-neutral-700 dark:text-neutral-300',
+      'overflow-hidden text-sm text-neutral-700',
       'data-[state=open]:animate-accordion-down',
       'data-[state=closed]:animate-accordion-up',
       'motion-reduce:animate-none',

package/src/components/Box/Box.test.tsx

@@ -46,7 +46,11 @@ describe('<Box>', () => {
       const { container } = render(<Box variant="elevated" elevation={3}>x</Box>);
       const cls = container.firstElementChild?.className ?? '';
       expect(cls).toContain('bg-white');
-      expect(cls).toContain('dark:bg-neutral-900');
+      // Sprint 4.3 theme identity sweep: corrected `dark:bg-neutral-900`
+      // (which resolved to near-white in dark mode via inversion — broken
+      // elevation) to `dark:bg-neutral-100` which resolves to `#171717`,
+      // one elevation tier above the page surface in dark mode.
+      expect(cls).toContain('dark:bg-neutral-100');
       expect(cls).toContain('shadow-md');
       expect(cls).not.toContain('border ');
     });
@@ -203,11 +207,17 @@ describe('<Box>', () => {
         const { container } = render(<Box variant="outlined" color={color}>x</Box>);
         const cls = container.firstElementChild?.className ?? '';
         if (color === 'neutral') {
-          // neutral uses the special border-neutral-200 + bg-white shape
+          // Sprint 4.3 identity sweep: neutral outlined uses
+          // `border-neutral-200` (auto-inverts via CSS-var swap; no
+          // `dark:` needed) + `bg-white dark:bg-neutral-100`
+          // (bg-white is hardcoded so `dark:` is required; target
+          // `dark:bg-neutral-100` = `#171717` is one tier elevated
+          // above the page surface in dark mode).
           expect(cls).toContain('border-neutral-200');
           expect(cls).toContain('bg-white');
-          expect(cls).toContain('dark:border-neutral-700');
-          expect(cls).toContain('dark:bg-neutral-900');
+          expect(cls).toContain('dark:bg-neutral-100');
+          // No more dark:border-neutral-700 (auto-inverts).
+          expect(cls).not.toContain('dark:border-neutral-');
         } else {
           // primary/secondary/success/warning/danger/info share the
           // border-{color}-300 + bg-{color}-50/40 + dark:* pattern
@@ -229,10 +239,12 @@ describe('<Box>', () => {
         const { container } = render(<Box variant="soft" color={color}>x</Box>);
         const cls = container.firstElementChild?.className ?? '';
         if (color === 'neutral') {
+          // Sprint 4.3 identity sweep: both neutral classes auto-invert
+          // via the dashforgePreset() CSS-var swap — no `dark:` needed.
           expect(cls).toContain('bg-neutral-100');
           expect(cls).toContain('text-neutral-900');
-          expect(cls).toContain('dark:bg-neutral-800');
-          expect(cls).toContain('dark:text-neutral-100');
+          expect(cls).not.toContain('dark:bg-neutral-');
+          expect(cls).not.toContain('dark:text-neutral-');
         } else {
           expect(cls).toContain(`bg-${color}-100`);
           expect(cls).toContain(`text-${color}-900`);
@@ -254,10 +266,17 @@ describe('<Box>', () => {
         const { container } = render(<Box variant="solid" color={color}>x</Box>);
         const cls = container.firstElementChild?.className ?? '';
         if (color === 'neutral') {
+          // Sprint 4.3 identity sweep: solid neutral now uses
+          // `bg-neutral-900 text-neutral-50` (both auto-invert) — the
+          // accent surface inverts WITH the page (dark surface in
+          // light mode, light surface in dark mode), consistent with
+          // identity rule. Previously was `text-white` (no inversion)
+          // forcing double-invert pattern to stay readable.
           expect(cls).toContain('bg-neutral-900');
-          expect(cls).toContain('text-white');
-          expect(cls).toContain('dark:bg-neutral-100');
-          expect(cls).toContain('dark:text-neutral-900');
+          expect(cls).toContain('text-neutral-50');
+          expect(cls).not.toContain('text-white');
+          expect(cls).not.toContain('dark:bg-neutral-');
+          expect(cls).not.toContain('dark:text-neutral-');
         } else if (color === 'warning') {
           // warning uses 500/600 instead of 600/500 to keep contrast
           // legible against an already-yellow surface in light mode.
@@ -289,9 +308,11 @@ describe('<Box>', () => {
     it('elevated + color="danger" stays on the neutral surface', () => {
       const { container } = render(<Box variant="elevated" color="danger">x</Box>);
       const cls = container.firstElementChild?.className ?? '';
-      // elevated paints bg-white / dark:bg-neutral-900 regardless of intent
+      // elevated paints bg-white / dark:bg-neutral-100 regardless of
+      // intent (Sprint 4.3 sweep: dark target corrected to
+      // `dark:bg-neutral-100` for proper dark elevation).
       expect(cls).toContain('bg-white');
-      expect(cls).toContain('dark:bg-neutral-900');
+      expect(cls).toContain('dark:bg-neutral-100');
       expect(cls).not.toContain('bg-danger-');
       expect(cls).not.toContain('border-danger-');
     });

package/src/components/Box/box.variants.ts

@@ -55,7 +55,13 @@ export const boxVariants = tv({
     variant: {
       plain:    '',
       outlined: 'border',
-      elevated: 'bg-white dark:bg-neutral-900',
+      // `bg-white` is hardcoded (does NOT auto-invert via CSS vars),
+      // so the `dark:` variant is required. Target `dark:bg-neutral-100`
+      // resolves to `#171717` via the inversion → one elevation tier
+      // above the page surface (`bg-neutral-50` = `#0a0a0a`) in dark
+      // mode. `dark:bg-neutral-900` was wrong (resolved to near-white
+      // in dark mode — overpowering elevation).
+      elevated: 'bg-white dark:bg-neutral-100',
       soft:     '',
       solid:    '',
     },
@@ -165,7 +171,11 @@ export const boxVariants = tv({
     { variant: 'outlined', color: 'info',
       class: 'border-info-300 bg-info-50/40 dark:border-info-800 dark:bg-info-950/30' },
     { variant: 'outlined', color: 'neutral',
-      class: 'border-neutral-200 bg-white dark:border-neutral-700 dark:bg-neutral-900' },
+      // border-neutral-200 auto-inverts via CSS var swap (no `dark:`
+      // needed). bg-white is hardcoded — `dark:bg-neutral-100` keeps
+      // elevation tier above page surface in dark mode (NOT
+      // `dark:bg-neutral-900` which renders near-white).
+      class: 'border-neutral-200 bg-white dark:bg-neutral-100' },
 
     // ─── soft × color ─────────────────────────────────────────────────
     { variant: 'soft', color: 'primary',
@@ -181,7 +191,9 @@ export const boxVariants = tv({
     { variant: 'soft', color: 'info',
       class: 'bg-info-100 text-info-900 dark:bg-info-950/50 dark:text-info-100' },
     { variant: 'soft', color: 'neutral',
-      class: 'bg-neutral-100 text-neutral-900 dark:bg-neutral-800 dark:text-neutral-100' },
+      // Both neutral classes auto-invert via the dashforgePreset() CSS
+      // var swap — no `dark:` variants needed.
+      class: 'bg-neutral-100 text-neutral-900' },
 
     // ─── solid × color ────────────────────────────────────────────────
     { variant: 'solid', color: 'primary',
@@ -197,7 +209,14 @@ export const boxVariants = tv({
     { variant: 'solid', color: 'info',
       class: 'bg-info-600 text-white dark:bg-info-500' },
     { variant: 'solid', color: 'neutral',
-      class: 'bg-neutral-900 text-white dark:bg-neutral-100 dark:text-neutral-900' },
+      // Solid neutral is the high-emphasis "always-foreground accent"
+      // variant. Both classes auto-invert: dark surface + light text
+      // in light mode (`#171717` / `#fafafa`) flips to light surface +
+      // dark text in dark mode (`#f5f5f5` / `#0a0a0a`). The
+      // accent inverts WITH the page surface — consistent with the
+      // identity rule. Previously used `text-white` (no auto-invert)
+      // which forced double-inversion to keep readable.
+      class: 'bg-neutral-900 text-neutral-50' },
   ],
 
   defaultVariants: {