@dashforge/tw 0.2.1-beta → 0.3.0-beta

package/dist/src/components/TextField/textField.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"textField.types.d.ts","sourceRoot":"","sources":["../../../../src/components/TextField/textField.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cACf,SAAQ,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC,EACvE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC1D,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAE1C,mCAAmC;IACnC,UAAU,CAAC,EAAE,SAAS,CAAC;IAEvB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,wBAAwB;IACxB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAE3B,2EAA2E;IAC3E,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,qDAAqD;IACrD,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC"}
+{"version":3,"file":"textField.types.d.ts","sourceRoot":"","sources":["../../../../src/components/TextField/textField.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cACf,SAAQ,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC,EACvE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC1D,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAE1C,mCAAmC;IACnC,UAAU,CAAC,EAAE,SAAS,CAAC;IAEvB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,wBAAwB;IACxB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAE3B,2EAA2E;IAC3E,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,qDAAqD;IACrD,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC"}

package/dist/src/components/TextField/textField.variants.d.ts

@@ -59,6 +59,8 @@ export declare const textFieldVariants: import("tailwind-variants").TVReturnType
     input: string[];
     helperText: string;
     errorText: string;
+    prefix: string[];
+    suffix: string[];
 }, undefined, {
     size: {
         sm: {
@@ -107,6 +109,8 @@ export declare const textFieldVariants: import("tailwind-variants").TVReturnType
     input: string[];
     helperText: string;
     errorText: string;
+    prefix: string[];
+    suffix: string[];
 }, import("tailwind-variants").TVReturnType<{
     size: {
         sm: {
@@ -155,6 +159,8 @@ export declare const textFieldVariants: import("tailwind-variants").TVReturnType
     input: string[];
     helperText: string;
     errorText: string;
+    prefix: string[];
+    suffix: string[];
 }, undefined, unknown, unknown, undefined>>;
 export type TextFieldVariants = VariantProps<typeof textFieldVariants>;
 //# sourceMappingURL=textField.variants.d.ts.map

package/dist/src/components/TextField/textField.variants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"textField.variants.d.ts","sourceRoot":"","sources":["../../../../src/components/TextField/textField.variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAsE5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"textField.variants.d.ts","sourceRoot":"","sources":["../../../../src/components/TextField/textField.variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAwF5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/src/index.d.ts

@@ -100,5 +100,5 @@ export type { VariantProps } from 'tailwind-variants';
 /**
  * Package version (synced with `package.json` at publish time).
  */
-export declare const VERSION = "0.2.1-beta";
+export declare const VERSION = "0.3.0-beta";
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dashforge/tw",
-  "version": "0.2.1-beta",
+  "version": "0.3.0-beta",
   "private": false,
   "type": "module",
   "main": "./dist/index.esm.js",
@@ -26,8 +26,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/AppShell/AppShell.tsx

@@ -1,8 +1,32 @@
-import { useEffect } from 'react';
+import { useEffect, useRef } from 'react';
 import { cn } from '../../utils/cn.js';
 import { appShellVariants } from './appShell.variants.js';
 import type { AppShellProps } from './appShell.types.js';
 
+/**
+ * Query selector for natively-focusable elements + anything with an
+ * explicit positive (or implicit `0`) tabindex. Used by the focus
+ * trap to enumerate the drawer's interactive content.
+ *
+ * Notes:
+ *  - Excludes `[tabindex="-1"]` (intentionally non-tabbable).
+ *  - Excludes `:disabled` — the browser already skips them in tab
+ *    order; including them here would route focus to dead elements.
+ *  - `details > summary` is the standard way to get a focusable
+ *    `<details>` toggle.
+ *
+ * @internal
+ */
+const FOCUSABLE_SELECTOR = [
+  'a[href]',
+  'button:not(:disabled)',
+  'input:not(:disabled):not([type="hidden"])',
+  'select:not(:disabled)',
+  'textarea:not(:disabled)',
+  '[tabindex]:not([tabindex="-1"]):not(:disabled)',
+  'details > summary:first-of-type',
+].join(',');
+
 /**
  * Dashforge TW AppShell — top-level layout orchestrator.
  *
@@ -31,6 +55,20 @@ import type { AppShellProps } from './appShell.types.js';
  *   - The mobile drawer + backdrop participate in the standard
  *     "click outside to close" pattern — `Escape` closes the drawer
  *     too (added via global keydown).
+ *   - **Focus trap** (WCAG 2.4.3) — when the mobile drawer opens:
+ *       1. The previously-focused element is captured.
+ *       2. Focus moves to the first focusable element inside the drawer.
+ *       3. Tab / Shift+Tab wrap inside the drawer (cycle from
+ *          last → first and first → last) — Tab can never escape
+ *          to the page underneath while the drawer is open.
+ *       4. On close, focus returns to the captured element (typically
+ *          the hamburger toggle the user pressed to open the drawer).
+ *     This pattern matches WAI-ARIA APG's modal dialog guidance even
+ *     though the drawer isn't strictly a dialog — same focus
+ *     management makes keyboard users' experience predictable.
+ *   - **`role="dialog"` + `aria-modal="true"`** are applied to the
+ *     drawer when open so screen readers announce it as a modal
+ *     overlay rather than just an aside.
  */
 export function AppShell(props: AppShellProps) {
   const {
@@ -66,6 +104,86 @@ export function AppShell(props: AppShellProps) {
     return () => document.removeEventListener('keydown', handler);
   }, [navOpen, onNavOpenChange]);
 
+  /*
+   * Focus trap for the mobile drawer.
+   *
+   * Implementation:
+   *  - On open: capture the currently-focused element (`document.activeElement`)
+   *    so we can restore it on close. Then move focus to the first
+   *    focusable element inside the drawer.
+   *  - While open: a Tab/Shift+Tab keydown listener wraps focus inside
+   *    the drawer subtree (last → first on Tab from end, first → last
+   *    on Shift+Tab from start).
+   *  - On close: restore focus to the captured element.
+   *
+   * Hand-rolled (no `focus-trap-react` dep) — the logic is ~20 LOC and
+   * scoped to a single drawer; adding a runtime dep felt like overkill.
+   * If we ever need more sophisticated trap semantics (nested traps,
+   * sentinel nodes, etc.) the dep is the right call.
+   */
+  const drawerRef = useRef<HTMLDivElement | null>(null);
+  const restoreFocusRef = useRef<HTMLElement | null>(null);
+
+  useEffect(() => {
+    if (!navOpen) return;
+    // 1) Capture the element that had focus before the drawer opened.
+    restoreFocusRef.current = document.activeElement as HTMLElement | null;
+
+    // 2) Move focus to the first focusable element inside the drawer.
+    //    Defer via rAF so the drawer DOM (slide-in animation start) has
+    //    settled and the elements are actually visible/focusable.
+    const raf = requestAnimationFrame(() => {
+      const drawer = drawerRef.current;
+      if (!drawer) return;
+      const first = drawer.querySelector<HTMLElement>(FOCUSABLE_SELECTOR);
+      first?.focus();
+    });
+
+    // 3) Trap Tab / Shift+Tab inside the drawer.
+    const onKeyDown = (event: KeyboardEvent) => {
+      if (event.key !== 'Tab') return;
+      const drawer = drawerRef.current;
+      if (!drawer) return;
+      const focusables = Array.from(
+        drawer.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)
+      );
+      if (focusables.length === 0) {
+        event.preventDefault();
+        return;
+      }
+      const first = focusables[0];
+      const last = focusables[focusables.length - 1];
+      const active = document.activeElement as HTMLElement | null;
+      if (event.shiftKey) {
+        // Shift+Tab on first → wrap to last.
+        if (active === first || !drawer.contains(active)) {
+          event.preventDefault();
+          last.focus();
+        }
+      } else {
+        // Tab on last → wrap to first.
+        if (active === last || !drawer.contains(active)) {
+          event.preventDefault();
+          first.focus();
+        }
+      }
+    };
+    document.addEventListener('keydown', onKeyDown);
+
+    return () => {
+      cancelAnimationFrame(raf);
+      document.removeEventListener('keydown', onKeyDown);
+      // 4) Restore focus to the previously-focused element on close.
+      //    Guard against the element being removed from the DOM (rare
+      //    but possible if the consumer re-renders the page while the
+      //    drawer is open).
+      const restore = restoreFocusRef.current;
+      if (restore && document.body.contains(restore)) {
+        restore.focus();
+      }
+    };
+  }, [navOpen]);
+
   return (
     <div className={cn(v.root(), sx, slotProps?.root?.className)}>
       {header && (
@@ -81,8 +199,15 @@ export function AppShell(props: AppShellProps) {
               {nav}
             </aside>
             <aside
+              ref={drawerRef}
               className={cn(v.navMobile(), slotProps?.navMobile?.className)}
               aria-hidden={!navOpen}
+              // When open, the drawer is a modal overlay — `dialog` +
+              // `aria-modal="true"` so screen readers announce it as
+              // such. When closed, drop both attributes (the aria-
+              // hidden=true above already removes it from the AT tree).
+              role={navOpen ? 'dialog' : undefined}
+              aria-modal={navOpen ? true : undefined}
               // The drawer is the SAME nav content rendered twice — once
               // inline (desktop) and once as a slide-in (mobile). We
               // mark the inactive copy hidden from AT to avoid double

package/src/components/AppShell/appShell.variants.ts

@@ -21,14 +21,20 @@ export const appShellVariants = tv({
     nav: 'hidden md:flex shrink-0',
     navMobile: [
       'flex md:hidden fixed inset-y-0 left-0 z-40',
-      'transition-transform duration-200 ease-out',
+      // Drawer slide-in is the most prominent motion in AppShell and
+      // a clear WCAG 2.3.3 candidate. Gate the transition on
+      // `prefers-reduced-motion: no-preference`; the data-driven
+      // `-translate-x-full` / `translate-x-0` still applies, just
+      // without the smooth slide.
+      'transition-transform duration-200 ease-out motion-reduce:transition-none motion-reduce:duration-0',
       '-translate-x-full',
     ],
     main: 'flex-1 min-w-0 overflow-y-auto',
     footer: 'shrink-0',
     backdrop: [
       'md:hidden fixed inset-0 z-30 bg-black/40',
-      'transition-opacity duration-200',
+      // Backdrop opacity fade — micro motion, gated for consistency.
+      'transition-opacity duration-200 motion-reduce:transition-none motion-reduce:duration-0',
       'opacity-0 pointer-events-none',
     ],
   },

package/src/components/Autocomplete/Autocomplete.tsx

@@ -23,6 +23,61 @@ import type {
   AutocompleteValue,
 } from './autocomplete.types.js';
 
+/**
+ * Inline SVG icons used by the Autocomplete chrome (chip remove, clear,
+ * dropdown caret). Stroke uses `currentColor` so the parent's `text-*`
+ * propagates — same pattern as Checkbox's CheckIcon.
+ *
+ * Why inline SVG (not lucide / heroicons / unicode glyphs):
+ *  - Zero icon-library dependency: keeps `@dashforge/tw` self-contained.
+ *  - Crisp at every size (the unicode `×` / `▾` glyphs we shipped pre-
+ *    0.2.2 rendered as chunky font characters that looked unpolished
+ *    next to the rest of the design system).
+ *  - SVG scales with parent font-size cleanly via `width="1em" height="1em"`.
+ *
+ * @internal
+ */
+function CloseIcon({ className }: { className?: string }) {
+  return (
+    <svg
+      aria-hidden="true"
+      viewBox="0 0 16 16"
+      width="1em"
+      height="1em"
+      fill="none"
+      className={className}
+    >
+      <path
+        d="M4 4l8 8M12 4l-8 8"
+        stroke="currentColor"
+        strokeWidth="1.75"
+        strokeLinecap="round"
+      />
+    </svg>
+  );
+}
+
+function ChevronDownIcon({ className }: { className?: string }) {
+  return (
+    <svg
+      aria-hidden="true"
+      viewBox="0 0 16 16"
+      width="1em"
+      height="1em"
+      fill="none"
+      className={className}
+    >
+      <path
+        d="M4 6l4 4 4-4"
+        stroke="currentColor"
+        strokeWidth="1.75"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      />
+    </svg>
+  );
+}
+
 /**
  * Coerce a raw value (from bridge / props) into a canonical shape:
  *
@@ -402,7 +457,17 @@ export function Autocomplete<TOption = AutocompleteOption>(
         if (next == null) {
           setInputValue('');
         } else {
-          const found = options.find((opt) => getOptionValue(opt) === next);
+          // Look up the label in the EFFECTIVE option pool (static
+          // `options` + async `asyncOptions` when `loadOptions` is
+          // configured). Looking only at the static `options` here
+          // means async-loaded picks never update the input — the
+          // user sees their search query stick instead of the
+          // selected label after click. Same lookup logic mirrored in
+          // `displayInputValue` so the two paths can't drift.
+          const pool = loadOptions && asyncOptions !== null
+            ? asyncOptions
+            : options;
+          const found = pool.find((opt) => getOptionValue(opt) === next);
           const found_label = found ? labelAsString(found) : undefined;
           if (found_label !== undefined) {
             setInputValue(found_label);
@@ -434,6 +499,8 @@ export function Autocomplete<TOption = AutocompleteOption>(
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [
       options,
+      asyncOptions,
+      loadOptions,
       isFormMode,
       bridge,
       name,
@@ -837,7 +904,7 @@ export function Autocomplete<TOption = AutocompleteOption>(
                         slotProps?.chipRemove?.className
                       )}
                     >
-                      ×
+                      <CloseIcon />
                     </button>
                   )}
                 </span>
@@ -893,7 +960,7 @@ export function Autocomplete<TOption = AutocompleteOption>(
             tabIndex={-1}
             className={cn(v.clearButton(), slotProps?.clearButton?.className)}
           >
-            ×
+            <CloseIcon />
           </button>
         )}
 
@@ -908,7 +975,13 @@ export function Autocomplete<TOption = AutocompleteOption>(
           disabled={effectiveDisabled}
           className={cn(v.trigger(), slotProps?.trigger?.className)}
         >
-          ▾
+          {/*
+           * Chevron flips up when popover is open (CSS-only, driven by
+           * the `aria-expanded` attribute selector on the parent
+           * `<button>`). See autocomplete.variants.ts → `trigger` slot
+           * for the `aria-expanded:rotate-180` rule.
+           */}
+          <ChevronDownIcon />
         </button>
 
         {isOpen && (

package/src/components/Autocomplete/autocomplete.variants.ts

@@ -44,6 +44,12 @@ export const autocompleteVariants = tv({
       'text-neutral-600 hover:text-neutral-900',
       'disabled:cursor-not-allowed disabled:opacity-40',
       'transition-colors',
+      // Chevron flip on open — targets the SVG child via the aria-
+      // expanded state on the button itself (set by React). Smooth
+      // rotate gated on prefers-reduced-motion (WCAG 2.3.3); the
+      // 180° state still applies, just without the animated tween.
+      '[&[aria-expanded=true]>svg]:rotate-180',
+      '[&>svg]:transition-transform [&>svg]:duration-150 motion-reduce:[&>svg]:transition-none',
     ],
     clearButton: [
       'flex items-center justify-center shrink-0 px-2',

package/src/components/Breadcrumbs/breadcrumbs.variants.ts

@@ -23,6 +23,11 @@ export const breadcrumbsVariants = tv({
       'rounded-sm outline-none',
       'focus-visible:ring-2 focus-visible:ring-primary-500/50',
       'transition-colors',
+      // Defensive `no-underline` — see the matching comment in
+      // LeftNav itemLink slot. The Breadcrumbs root cause covers
+      // TopBar too because Breadcrumbs is typically rendered in
+      // TopBar's center slot.
+      'no-underline hover:no-underline',
     ],
     current: [
       'inline-flex items-center gap-1 truncate',

package/src/components/Checkbox/Checkbox.tsx

@@ -10,8 +10,8 @@ import { checkboxVariants } from './checkbox.variants.js';
 import type { CheckboxProps } from './checkbox.types.js';
 
 /**
- * Inline checkmark SVG used by `Radix.Indicator`. Stroke uses
- * `currentColor` so the parent's `text-white` propagates correctly.
+ * Inline checkmark SVG used by `Radix.Indicator` when fully checked.
+ * Stroke uses `currentColor` so the parent's `text-white` propagates.
  *
  * @internal
  */
@@ -34,6 +34,37 @@ function CheckIcon({ className }: { className?: string }) {
   );
 }
 
+/**
+ * Inline dash SVG used by `Radix.Indicator` when the checkbox is in
+ * the `indeterminate` tri-state ("some, but not all, children
+ * selected" — the canonical "select all" partial state).
+ *
+ * Pre-0.2.2-beta the indicator rendered the CheckIcon for BOTH
+ * checked and indeterminate (Radix mounts the Indicator for either
+ * state). We now discriminate via the `data-state` attribute Radix
+ * sets on the Indicator element itself — see the parent `Indicator`
+ * rendering below for the CSS toggle.
+ *
+ * @internal
+ */
+function DashIcon({ className }: { className?: string }) {
+  return (
+    <svg
+      aria-hidden="true"
+      viewBox="0 0 16 16"
+      fill="none"
+      className={className}
+    >
+      <path
+        d="M3 8h10"
+        stroke="currentColor"
+        strokeWidth="2.5"
+        strokeLinecap="round"
+      />
+    </svg>
+  );
+}
+
 /**
  * Dashforge TW Checkbox — bridge-integrated form control.
  *
@@ -212,16 +243,19 @@ export function Checkbox(props: CheckboxProps) {
          * modes — controlled, uncontrolled, bridge). Indicator mounts
          * exactly when the checkbox is checked OR indeterminate.
          *
-         * Indeterminate caveat: this renders the check glyph for
-         * BOTH checked AND indeterminate states. Previously
-         * indeterminate rendered nothing inside the blue square
-         * (same level of broken). A future improvement would render
-         * a dash for indeterminate — out of scope here.
+         * Per-state glyph (Sprint 2 P4): when Indicator is mounted we
+         * render BOTH glyphs and toggle visibility via the Indicator's
+         * own `data-state` attribute. The `group` class on Indicator
+         * lets the SVG children target the parent's state with
+         * `group-data-[state=checked]:hidden` / `…:indeterminate:hidden`.
+         * No React state required — Radix's data-state attribute is
+         * the single source of truth.
          */}
         <RadixCheckbox.Indicator
-          className={cn(v.indicator(), slotProps?.indicator?.className)}
+          className={cn(v.indicator(), 'group', slotProps?.indicator?.className)}
         >
-          <CheckIcon className="h-full w-full" />
+          <CheckIcon className="h-full w-full group-data-[state=indeterminate]:hidden" />
+          <DashIcon className="h-full w-full group-data-[state=checked]:hidden" />
         </RadixCheckbox.Indicator>
       </RadixCheckbox.Root>
 

package/src/components/LeftNav/leftNav.variants.ts

@@ -24,7 +24,10 @@ export const leftNavVariants = tv({
     root: [
       'flex flex-col h-full',
       'bg-neutral-50 border-r border-neutral-200',
-      'transition-[width] duration-200',
+      // Width transition (rail-mode toggle) — gated on
+      // prefers-reduced-motion (WCAG 2.3.3). The new width still
+      // applies, just without the animated tween.
+      'transition-[width] duration-200 motion-reduce:transition-none motion-reduce:duration-0',
     ],
     brand: [
       'flex items-center gap-2 px-3 h-14 shrink-0',
@@ -39,6 +42,14 @@ export const leftNavVariants = tv({
       'transition-colors w-full',
       'aria-disabled:opacity-50 aria-disabled:cursor-not-allowed',
       'aria-disabled:hover:bg-transparent',
+      // Defensive `no-underline` — Tailwind's preflight removes the
+      // default browser anchor underline globally, but environments
+      // that DISABLE preflight (e.g. our docs-lab, where the tw
+      // section coexists with MUI's chrome) get raw browser defaults
+      // back. Without this, `<a>` items in the nav render underlined
+      // in those contexts. Explicit `no-underline` + `hover:no-underline`
+      // keeps the appearance consistent regardless of preflight state.
+      'no-underline hover:no-underline',
     ],
     itemActive: 'bg-primary-100 text-primary-900 font-medium',
     itemIcon: 'shrink-0 w-5 h-5 flex items-center justify-center',

package/src/components/Snackbar/snackbar.variants.ts

@@ -23,8 +23,10 @@ export const snackbarVariants = tv({
       'rounded-lg border shadow-lg',
       'text-sm bg-neutral-50 text-neutral-900',
       // Subtle enter transition — opacity + translate, kept short so a
-      // burst of snackbars feels snappy.
-      'transition-all duration-200',
+      // burst of snackbars feels snappy. Gated on motion-reduce
+      // (WCAG 2.3.3) — users who request reduced motion see snackbars
+      // pop in instantly without the slide animation.
+      'transition-all duration-200 motion-reduce:transition-none motion-reduce:duration-0',
       'data-[state=entered]:opacity-100 data-[state=exited]:opacity-0',
     ],
     icon: 'shrink-0 mt-0.5 w-5 h-5 inline-flex items-center justify-center',

package/src/components/Switch/switch.variants.ts

@@ -25,7 +25,12 @@ export const switchVariants = tv({
     ],
     thumb: [
       'pointer-events-none inline-block rounded-full bg-white shadow ring-0',
-      'transition-transform',
+      // Slide animation gated on `prefers-reduced-motion: no-preference`
+      // (WCAG 2.3.3). The thumb still moves between positions instantly
+      // for users who request reduced motion — the data-state change
+      // applies the translate-x rule unconditionally, only the smooth
+      // transition between the two is suppressed.
+      'transition-transform motion-reduce:transition-none',
       'data-[state=unchecked]:translate-x-0',
     ],
     label: 'select-none cursor-pointer text-neutral-900',

package/src/components/TextField/TextField.tsx

@@ -178,6 +178,22 @@ export function TextField(props: TextFieldProps) {
       )}
 
       <div className={cn(v.inputWrapper(), slotProps?.inputWrapper?.className)}>
+        {/*
+         * Prefix slot (Sprint 2 P4.1) — inline adornment rendered
+         * BEFORE the input. Mounts only when `slotProps.prefix.children`
+         * is provided so empty configs don't add layout cost. Common
+         * use: currency symbols (`$`, `€`), units (`@`, `#`), status
+         * icons. The slot wrapper carries `pointer-events-none` to
+         * avoid stealing focus from the input on click.
+         */}
+        {slotProps?.prefix?.children !== undefined && (
+          <span
+            aria-hidden="true"
+            className={cn(v.prefix(), slotProps.prefix.className)}
+          >
+            {slotProps.prefix.children}
+          </span>
+        )}
         <input
           {...rest}
           id={inputId}
@@ -196,6 +212,19 @@ export function TextField(props: TextFieldProps) {
           ref={inputRef}
           className={cn(v.input(), slotProps?.input?.className)}
         />
+        {/*
+         * Suffix slot (Sprint 2 P4.1) — same pattern as prefix,
+         * rendered AFTER the input. Typical use: unit labels (`USD`,
+         * `kg`, `%`), trailing icons, length counters.
+         */}
+        {slotProps?.suffix?.children !== undefined && (
+          <span
+            aria-hidden="true"
+            className={cn(v.suffix(), slotProps.suffix.className)}
+          >
+            {slotProps.suffix.children}
+          </span>
+        )}
       </div>
 
       {resolvedHelperText && (

package/src/components/TextField/textField.types.ts

@@ -6,9 +6,27 @@ import type { TextFieldVariants } from './textField.variants.js';
 /**
  * Per-slot overrides for `<TextField>`.
  *
- * Each slot accepts `{ className: string }` so the override path is
- * extensible (style / aria-* / data-* can be added without a breaking
- * change). Mirrors the MUI-side `slotProps` shape.
+ * Each slot accepts `{ className: string }` (and, for `prefix` /
+ * `suffix`, a `children` node) so the override path is extensible —
+ * extra fields like `style`, `aria-*`, `data-*` can be added without
+ * a breaking change. Mirrors the MUI-side `slotProps` shape.
+ *
+ * **`prefix` / `suffix`** are inline adornments rendered INSIDE the
+ * `inputWrapper`, before / after the `<input>` element. Typical use:
+ * currency symbols, units, status icons. Passing only `className`
+ * (no `children`) is allowed but renders an empty slot — usually
+ * you'll always pair the two.
+ *
+ *   ```tsx
+ *   <TextField
+ *     name="price"
+ *     type="number"
+ *     slotProps={{
+ *       prefix: { children: '$' },
+ *       suffix: { children: 'USD' },
+ *     }}
+ *   />
+ *   ```
  */
 export interface TextFieldSlotProps {
   root?: { className?: string };
@@ -18,6 +36,8 @@ export interface TextFieldSlotProps {
   input?: { className?: string };
   helperText?: { className?: string };
   errorText?: { className?: string };
+  prefix?: { children?: ReactNode; className?: string };
+  suffix?: { children?: ReactNode; className?: string };
 }
 
 /**

package/src/components/TextField/textField.variants.ts

@@ -34,6 +34,24 @@ export const textFieldVariants = tv({
     ],
     helperText: 'mt-1 text-sm text-neutral-600',
     errorText: 'mt-1 text-sm text-danger-600',
+    /*
+     * `prefix` / `suffix` slot — inline adornment rendered before /
+     * after the input INSIDE the inputWrapper. `shrink-0` keeps the
+     * adornment width fixed so it doesn't compete for space with the
+     * input; `select-none` + `pointer-events-none` avoids
+     * accidentally stealing focus from the input on click (the
+     * inputWrapper handles focus via `focus-within`).
+     */
+    prefix: [
+      'shrink-0 inline-flex items-center select-none pointer-events-none',
+      'text-neutral-500',
+      'mr-2',
+    ],
+    suffix: [
+      'shrink-0 inline-flex items-center select-none pointer-events-none',
+      'text-neutral-500',
+      'ml-2',
+    ],
   },
   variants: {
     size: {

package/src/index.ts

@@ -237,4 +237,4 @@ export type { VariantProps } from 'tailwind-variants';
 /**
  * Package version (synced with `package.json` at publish time).
  */
-export const VERSION = '0.2.1-beta';
+export const VERSION = '0.3.0-beta';