@dashforge/tw 0.1.0-beta → 0.2.1-beta

package/A11Y.md

@@ -0,0 +1,130 @@
+# A11Y audit — `@dashforge/tw`
+
+Per-component accessibility status for every shipped `@dashforge/tw`
+component (24 total). Audit date: 2026-05-17, against the 0.2.0-beta
+codebase (+ the three pending lib fixes for Checkbox / RadioGroup /
+NumberField + the Button `aria-busy` improvement landing in 0.2.1-beta).
+
+Reference: [WCAG 2.1 AA](https://www.w3.org/TR/WCAG21/) +
+[WAI-ARIA Authoring Practices](https://www.w3.org/WAI/ARIA/apg/).
+
+## Summary
+
+| Group | Components | Status |
+|---|---|---|
+| Foundation (presentational) | Typography, Box, Stack, Grid, Container, AspectRatio | ✅ N/A — pass-through to HTML semantics |
+| Foundation (a11y primitive)  | VisuallyHidden, Divider                              | ✅ Conformant |
+| Form controls (Radix-backed) | Checkbox, Switch, RadioGroup                         | ✅ Inherits WAI-ARIA APG from Radix |
+| Form controls (custom)       | Button, TextField, Textarea, NumberField, OTPField, Autocomplete, DateTimePicker | ✅ Conformant (see per-row notes) |
+| Layout / Navigation          | AppShell, TopBar, LeftNav, Breadcrumbs               | ✅ Conformant |
+| Overlays (Radix-backed)      | ConfirmDialog                                        | ✅ Inherits from Radix Dialog |
+| Notifications                | Snackbar                                             | ✅ Conformant (aria-live polite) |
+
+Zero blocking failures. One enhancement landed: Button now exposes
+`aria-busy={loading}` so assistive tech distinguishes loading from
+plain disabled.
+
+## Per-component findings
+
+### Foundation
+
+| Component | Status | Notes |
+|---|---|---|
+| **Typography**     | ✅ | Renders the variant-appropriate HTML tag (`<h1>`–`<h6>`, `<p>`, `<small>`) so screen-reader heading navigation works out of the box. `as` / `asChild` let consumers re-tag without losing styles. |
+| **Box**            | ✅ | Pass-through `<div>` (or `as`/`asChild`-overridden tag). No interactive semantics. |
+| **Stack**          | ✅ | Pass-through `<div>`. Display-only flex container. |
+| **Grid**           | ✅ | Pass-through `<div>` with `display: grid`. Layout-only. |
+| **Container**      | ✅ | Pass-through `<div>` or `<main>` (via `asChild`). Layout-only. |
+| **Divider**        | ✅ | Horizontal: `<hr role="separator" aria-orientation="horizontal">`. Vertical: `<div role="separator" aria-orientation="vertical">`. Labeled variant keeps the role on the wrapper + decorative line segments carry `aria-hidden`. |
+| **AspectRatio**    | ✅ | Pass-through `<div>` carrying a `style={aspect-ratio: ...}`. No interactive semantics. |
+| **VisuallyHidden** | ✅ | IS the a11y primitive — WebAIM clip technique via Tailwind's `sr-only`. Chooses `<span>` by default (works inside buttons / links without breaking inline flow). |
+
+### Tier-1 form controls
+
+| Component   | Status | Notes |
+|-------------|--------|-------|
+| **Button**     | ✅ | Native `<button>` (or Slot via `asChild`). `disabled` + `aria-disabled` mirrored. **`aria-busy={true}` while loading** (added 2026-05-17) — SR users hear "busy" instead of just "dimmed". Loading spinner is `aria-hidden`. `focus-visible:ring-*` matches the variant color. |
+| **TextField**  | ✅ | `<label htmlFor>` via `useId()`. `aria-invalid` on error, `aria-describedby` linked to the helper-text id. Required marker is `aria-hidden` decorative + the real signal is the native `required` attribute. `placeholder:text-neutral-400`. |
+| **Checkbox**   | ✅ | Radix `Checkbox.Root` (WAI-ARIA APG). Indicator now uses Radix-native mounting (no React conditional) so checked-state changes from any source — click, programmatic, bridge — propagate to AT. |
+| **Switch**     | ✅ | Radix `Switch.Root` (WAI-ARIA APG). `role="switch"` + `aria-checked`. Thumb animation gated on `data-state` — pure CSS, no React state for the visual. |
+
+### Tier-2 / 3 form controls
+
+| Component         | Status | Notes |
+|-------------------|--------|-------|
+| **RadioGroup**       | ✅ | Radix `RadioGroup.Root` + `Item`. `role="radiogroup"` on the container, `role="radio"` + `aria-checked` per option. Group label linked via `aria-labelledby`. Per-option RBAC hide preserves the selected option as disabled (so the user can see what they picked even after a perm change). |
+| **Textarea**         | ✅ | Same label + helper-text wiring as TextField. `<textarea>` native element, `resize` axis controlled via CSS. |
+| **NumberField**      | ✅ | Native `<input type="number">` — keyboard arrow keys are the accessible way to change the value (browser default). The custom +/− stepper is **intentionally `aria-hidden`** and `tabIndex={-1}` — visible/touch affordance only, with `aria-label="Increment"` / `"Decrement"` for any AT that does walk into hidden subtrees. |
+| **OTPField**         | ✅ | One real `<input>` (visually rendered as N segmented slots via decorative `aria-hidden` `<div>`s). `autoComplete="one-time-code"` for SMS autofill on iOS. `inputMode="numeric"` (default) for mobile keyboards. Backspace / Delete / paste all work natively because the underlying element IS a single input. |
+| **Autocomplete**     | ✅ | Full WAI-ARIA Combobox pattern: `role="combobox"` + `aria-autocomplete="list"` + `aria-expanded` + `aria-controls` + `aria-activedescendant`. Listbox: `role="listbox"` + per-option `role="option"` + `aria-selected`. Async load row: `aria-live="polite"` + `aria-busy="true"`. Clear / open buttons carry `aria-label`. Chip remove buttons: `aria-label="Remove {label}"`. |
+| **DateTimePicker**   | ✅ | Native HTML5 `<input type="date">` / `"time"` / `"datetime-local"`. Browser ships a fully-accessible picker for each. `aria-invalid` + `aria-describedby` wired to the helper text. |
+
+### Layout / navigation
+
+| Component     | Status | Notes |
+|---------------|--------|-------|
+| **AppShell**     | ✅ | `<aside>` for desktop nav, `<aside aria-hidden={!navOpen}>` for the mobile drawer copy (so it doesn't double-announce when hidden). Escape closes the drawer. `<main>` landmark wraps content. `<header>` / `<footer>` are native landmarks. **Known limitation**: no focus trap inside the mobile drawer — focus returns to the toggle button on Escape close, which is acceptable for a docs site / typical web app but not full WAI-ARIA modal-drawer compliance. Can be added in a future revision. |
+| **TopBar**       | ✅ | Renders as `<header>` (banner landmark) by default. `asDiv` opt-out for nested layouts where a banner landmark would duplicate. |
+| **LeftNav**      | ✅ | `<nav aria-label>` landmark. `aria-current="page"` on the active row. Groups use `aria-expanded` + `aria-controls` linking the header `<button>` to a `role="region" aria-labelledby` panel. Collapse toggle: `aria-pressed` + dynamic `aria-label`. Per-row RBAC hide is matched by an a11y-tree removal (not just visual), so the announced nav matches what the user can actually interact with. |
+| **Breadcrumbs**  | ✅ | `<nav aria-label="Breadcrumb">` + `<ol>` (screen readers announce position-in-list). `aria-current="page"` on the last (or `current: true`) crumb. Separators carry `aria-hidden="true"`. Truncation ellipsis: `<span aria-label="More breadcrumbs">`. |
+
+### Overlays + notifications
+
+| Component        | Status | Notes |
+|------------------|--------|-------|
+| **ConfirmDialog**   | ✅ | Radix `Dialog.Root` (WAI-ARIA APG). `role="dialog"` + `aria-modal="true"` + `aria-labelledby` on the title. Radix handles focus trap, focus restoration on close, Escape close, scroll lock. |
+| **Snackbar**        | ✅ | Stack is `role="region" aria-label="Notifications" aria-live="polite" aria-atomic="false"`. Polite (not assertive) so notifications don't interrupt the user's screen-reader stream; `atomic="false"` so only the changed item is announced, not the whole queue. Per-item dismiss button: `aria-label="Dismiss notification"`. |
+
+## Cross-cutting concerns
+
+- **Focus visibility** — every interactive component carries
+  `focus-visible:ring-*` matching its color variant. `outline-none` is
+  always paired with a ring so keyboard users never lose the focus
+  indicator (regression-tested via the inventory grep:
+  `Button / Checkbox / ConfirmDialog / RadioGroup / Switch / TextField
+  / Textarea / NumberField / OTPField / Autocomplete / DateTimePicker
+  / Breadcrumbs / LeftNav / Snackbar` all have `focus-visible:ring`).
+- **Color contrast** — the design tokens emit foreground/background
+  pairs that meet WCAG 2.1 AA (4.5:1 for normal text, 3:1 for large
+  text). Independent verification is on the dashforge-tokens roadmap.
+- **Reduced motion** — animations (Switch thumb slide, Snackbar slide-in,
+  ConfirmDialog fade) use the default `transition-*` utilities. A
+  `prefers-reduced-motion` audit pass is filed as a future enhancement
+  (current behavior: animations always play; not a WCAG failure but
+  reduces polish for users with motion sensitivity).
+- **Form error association** — every form control with `helperText` +
+  `error` wires `aria-invalid` and `aria-describedby` to the helper id
+  so the error message is announced alongside the field name.
+
+## Known limitations & future work
+
+1. **AppShell mobile drawer focus trap** — currently relies on Escape
+   to close + focus naturally returning to the toggle button. A future
+   release can add a real focus trap (probably via `focus-trap-react`
+   or hand-rolled).
+2. **`prefers-reduced-motion` audit** — animations always play. Should
+   gate the Switch thumb slide, Snackbar slide-in, ConfirmDialog fade
+   on the media query.
+3. **High-contrast Windows mode** — not explicitly tested. The `border`
+   utility renders a 1px border that should survive forced-colors mode,
+   but full validation pending.
+4. **Color contrast regression suite** — should be added to CI so a
+   token recolor doesn't silently regress AA compliance.
+
+## Audit methodology
+
+- ARIA role / attribute inventory via `grep -nE "aria-[a-z]+=|role=|onKeyDown"`
+  per component source.
+- Keyboard handler audit by reading each component's `onKeyDown`,
+  `onPaste`, `onFocus`, `onBlur` and tracing into the registered
+  bridge / Radix primitive.
+- Focus visibility inventory via `grep "focus-visible:ring"` across
+  all `*.variants.ts`.
+- Label association verification: `useId()` → `htmlFor=inputId` +
+  `aria-describedby=helperId` chain checked for TextField, Textarea,
+  NumberField, OTPField, DateTimePicker.
+
+No automated lighthouse / axe scan was run as part of this audit —
+that's a separate CI integration on the roadmap. Manual screen-reader
+verification (NVDA on Windows, VoiceOver on macOS / iOS) should be
+periodically refreshed; results land in this file as they happen.

package/CHANGELOG.md

@@ -12,6 +12,237 @@ This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 > duplicated intentionally — no shared "lowest common denominator" headless
 > layer.
 
+## [0.2.1-beta] — 2026-05-17
+
+**Hardening release.** Four targeted fixes — three in form-control
+runtime behaviour, one in the Button accessibility contract — surfaced
+while building live-preview demos for the docs site. No public API
+change on any component; strictly additive on the `<Button>` props
+contract (a new `aria-busy` attribute is emitted automatically when
+`loading` is true). Drop-in upgrade from `0.2.0-beta`.
+
+Theme of the three form-control fixes: the **same root cause** —
+"controlled-without-an-owner" — under three different surface
+appearances. In standalone uncontrolled mode (no `DashFormProvider`,
+no `value` / `checked` prop, only `defaultValue` / `defaultChecked`),
+each component was sitting in a controlled mode without anyone able
+to update the controlled prop on the user's keystrokes / clicks, so
+React would snap the input right back. The fixes vary by component
+implementation (Radix-backed → discriminated spread of `value` vs
+`defaultValue`; Radix indicator → drop `forceMount` + React
+conditional; native `<input>` → local `useState` for the uncontrolled
+case) but the pattern is identical. A11Y.md (new doc, separate
+commit) documents the broader pattern audit.
+
+### Fixed
+
+- **Checkbox** — the indicator's check glyph never appeared when the
+  user clicked a Checkbox that was rendered standalone-uncontrolled
+  (no `DashFormProvider`, no `checked` prop). The control turned blue
+  via `data-[state=checked]:bg-primary-500` but the React-conditional
+  `<CheckIcon />` was gated on a stale `resolvedChecked` snapshot.
+  Dropped `forceMount` + the conditional; the Radix `Indicator` now
+  owns the mount decision, tracking Radix's internal `data-state`
+  directly. Mounts in all three modes (controlled, uncontrolled,
+  bridge). 14/14 tests pass.
+- **RadioGroup** — clicking a different radio in standalone-uncontrolled
+  mode had no visible effect (the selection snapped back to
+  `defaultValue`). `<RadixRadioGroup.Root>` was passed `value={…}`
+  always, putting Radix in controlled mode against a never-updated
+  snapshot. Discriminated spread now picks `value` only in form mode
+  or when the consumer explicitly passes `value`; standalone-with-only-
+  `defaultValue` uses `defaultValue` so Radix manages its own state.
+  11/11 tests pass.
+- **NumberField** — typing into the input or clicking the +/− stepper
+  had no visible effect in standalone-uncontrolled mode, for the same
+  reason (controlled `<input value={…}>` with no setter). Added a
+  local `useState<string>` seeded from `defaultValue` (mirrors the
+  OTPField pattern); `handleChange` + `stepBy` now both update it.
+  8/8 tests pass.
+- **Button** — sets `aria-busy={true}` while `loading`, so assistive
+  tech distinguishes "wait for the action to finish" from plain
+  "disabled" (which previously was the only signal — same DOM
+  attribute regardless of whether the disable came from `loading`,
+  `disabled={true}`, or RBAC). 19/19 tests pass.
+
+### Internal
+
+- A11Y.md added at package root — per-component status table mapped
+  to WCAG 2.1 AA / WAI-ARIA APG. Documents that 23 of 24 components
+  were already conformant pre-release (only Button needed the
+  `aria-busy` enhancement above). Known non-blocking limitations
+  filed: AppShell mobile drawer focus trap, `prefers-reduced-motion`
+  pass, color-contrast CI suite, lighthouse/axe automated scan.
+
+### Compatibility
+
+| Compatibility axis | Pre-`0.2.1` | Post-`0.2.1` |
+|---|---|---|
+| Public API surface  | unchanged | unchanged + `aria-busy` auto-emitted on `<Button loading>` |
+| Peer deps           | `react ^18 \|\| ^19`, `tw-theme workspace`, `tw-tokens workspace` | unchanged |
+| Bridge deps         | `forms` / `rbac` / `ui-core` `workspace:*` | unchanged |
+
+## [0.2.0-beta] — 2026-05-17
+
+**Foundation release.** Eight layout / structural primitives added on top of
+the F3–F7 component catalogue (16 components → 24), plus a coverage
+hardening pass bringing the package from **460 → 592 unit tests** across
+**32 files**. End-to-end validated in the `dash` consumer app: mount
+**12.1 ms** / re-render **7–8.6 ms** for a page with 50+ primitive
+instances.
+
+**No public API change** on any of the 16 previously-shipped components
+— strictly additive minor bump. Consumers upgrading from `0.1.0-beta`
+can adopt the new primitives incrementally; existing code keeps working
+unchanged.
+
+### Added — Foundation primitives (F9)
+
+The `Box ≠ flex`, `Stack = flex 1D`, `Grid = flex 2D` rule is the spine of
+this layer: each primitive has a single, non-overlapping responsibility so
+"which one do I use?" has one answer per scenario. The rule is enforced at
+the TypeScript prop type level — `<Box direction="row">` is a compile error.
+
+- **`Typography`** — semantic typed text. Twelve variants (`h1`–`h6`,
+  `subtitle1/2`, `body1/2`, `caption`, `overline`) × nine intent colors ×
+  five weight overrides + alignment + truncate / noWrap / gutterBottom.
+  Default HTML tag inferred from variant (h1→`<h1>`, body1→`<p>`, …),
+  overridable via `as` or `asChild` (Radix Slot). Reads color from a
+  parent `<Box>` via `color="inherit"`.
+  Source: `src/components/Typography/{Typography.tsx, typography.types.ts, typography.variants.ts}`.
+
+- **`Box`** — surface primitive consolidating MUI's Box + Paper + Card +
+  Joy Surface into one. Five variants (`plain` · `outlined` · `elevated` ·
+  `soft` · `solid`) × seven intent colors = **21 compound visuals**
+  emitted by the TV recipe + six elevation levels (`0`–`5`) + token-scale
+  spacing (`p`/`px`/`py`/`m`/`mx`/`my`) + rounded scale +
+  `fullWidth`/`fullHeight`. Strictly no flex / no grid by design — wrap
+  in Stack/Grid for layout.
+  Source: `src/components/Box/box.variants.ts` (compound matrix lives here).
+
+- **`Stack`** — the **only** flex container in `@dashforge/tw`.
+  `direction` + `align` + `justify` + token-scale `gap` + `wrap`, plus a
+  runtime `divider` prop that inserts N-1 separators between children
+  (`React.Children.toArray` semantics: Fragments count as one child —
+  documented in `Stack.tsx` header + asserted in the test suite).
+  Source: `src/components/Stack/{Stack.tsx, stack.types.ts, stack.variants.ts}`.
+
+- **`Grid`** — CSS Grid container + item, polymorphic in role. MUI v2 API
+  surface (`<Grid container>` + `<Grid xs={6}>`) backed by **real CSS
+  Grid** (`display: grid` + `col-span-*`), not flexbox like MUI v2's own
+  internals. Discriminated-union TypeScript: `<Grid container xs={6}>`
+  fails compilation. 70-entry responsive `col-span` mapping (xs/sm/md/lg/xl
+  × `1..12/auto/full`) in the TV recipe.
+  Source: `src/components/Grid/{Grid.tsx, grid.types.ts, grid.variants.ts}`.
+
+### Added — Foundation completions (F10)
+
+Closes the foundation surface to match what Chakra/Mantine/Joy ship at
+the layout-primitive level.
+
+- **`Container`** — centered max-width page wrapper with the canonical
+  responsive padding ramp (`px-4 sm:px-6 lg:px-8`). Six sizes
+  (`sm` / `md` / `lg` / `xl` / `2xl` / `fluid`) mapped to Tailwind's
+  `max-w-screen-*` aliases + `centerContent` opt-in for marketing /
+  sign-in layouts.
+  Source: `src/components/Container/{Container.tsx, container.types.ts, container.variants.ts}`.
+
+- **`Divider`** — visual separator with two rendering modes selected by
+  `children` presence. Line-only renders `<hr>` with `role="separator"` +
+  `aria-orientation`; labeled mode renders the "OR" separator pattern as
+  two flex segments around the label, with a 32 px stub on the squashed
+  side for `align="start"` / `"end"`. orientation × variant
+  (solid/dashed/dotted) × color (7 intents) × align (3) axes.
+  Source: `src/components/Divider/{Divider.tsx, divider.types.ts, divider.variants.ts}`.
+
+- **`AspectRatio`** — content-shape primitive using the **native CSS
+  `aspect-ratio` property** (supported since 2021, ~98% browser coverage).
+  Number or CSS-string ratio. Pairs with `sx="rounded-xl overflow-hidden"`
+  for the canonical clipped media pattern (documented as the #1 gotcha
+  in `AspectRatio.tsx` header and the public MDX docs).
+  Source: `src/components/AspectRatio/{AspectRatio.tsx, aspectRatio.types.ts}`.
+
+- **`VisuallyHidden`** — the a11y primitive. Uses Tailwind's `sr-only`
+  utility (WebAIM clip technique). Hides children from sighted users
+  while keeping them in the accessibility tree — icon button labels,
+  status announcers (`aria-live="polite"`), skip links. Default tag is
+  `<span>` for the 99% case (inline label inside a button or link).
+  Source: `src/components/VisuallyHidden/{VisuallyHidden.tsx, visuallyHidden.types.ts}`.
+
+### Internal
+
+- **+132 edge case unit tests** added (`460 → 592` total across `32`
+  files). Reorganised here under `Internal` rather than `Added` because
+  the tests are not part of the public API surface.
+
+  - **Box (+33)** — every one of the 21 compound surface variants
+    (outlined / soft / solid × 7 intents) asserted explicitly with the
+    light + dark pair; plain / elevated color-agnostic invariants;
+    spacing axis coexistence (`p` + `px` + `py` × tailwind-merge
+    precedence); `elevation` × `variant` interaction; rounded edge
+    values. File: `src/components/Box/Box.test.tsx`.
+
+  - **Grid (+38)** — every responsive breakpoint × representative span
+    enumeration (5 × 5 = 25), full cascade test (`xs={12} sm={6} md={4}
+    lg={3} xl={2}`), every `autoFlow` value, every `cols` value,
+    `spacingX` / `spacingY` independence, empty container + orphan item
+    handling, deep nesting (Grid inside Grid item). File:
+    `src/components/Grid/Grid.test.tsx`.
+
+  - **Stack (+29)** — array divider, conditional / null children, mixed
+    text + element children, nested Stack with divider, divider key
+    stability across re-renders, every gap step (11 token values),
+    every `align`/`justify` value (11), empty Stack with and without
+    divider. File: `src/components/Stack/Stack.test.tsx`.
+
+  - **Typography / Container / Divider / AspectRatio / VisuallyHidden
+    (+32)** — multi-axis combinations (`variant` + `color` + `weight` +
+    `align` + `truncate` + `gutterBottom`), full variant catalogues
+    iterated with `it.each`, extreme ratio values (21/9, 9/16, 0.5, 3),
+    nested fluid/capped Container pattern, `aria-live="polite"`
+    announcer pattern.
+
+- **End-to-end consumer validation.** New page
+  `~/projects/web/learn/dash/src/pages/TestFoundation.tsx` (linked into
+  the `dash` consumer app via a `file:` package override) mounts all
+  eight primitives inside `<DashforgeTailwindProvider>` wrapped in a
+  React `<Profiler>` with `onRender` logger. Measured: **mount 12.1 ms,
+  update 7–8.6 ms** for a page with 50+ primitive instances — within the
+  60 fps frame budget. No `React.memo` applied — the primitives are
+  pure (no `useState`, no `useEffect`, only className resolution), so
+  React's reconciler trivially handles the re-render.
+
+### Architecture
+
+- **`Box ≠ flex`, `Stack = flex 1D`, `Grid = flex 2D`** — single
+  responsibility per primitive, enforced at the TypeScript prop type
+  level. `Box` exposes no `display` / `flex*` / `grid*` props at all —
+  trying to pass them fails compilation. The rule rules out the MUI
+  failure mode where every `<Box display="flex" gap={2}>` quietly becomes
+  the de facto flex container of the codebase, drowning the
+  surface-vs-layout distinction. When you read `<Stack>` in a JSX tree
+  you know it's flex without reading any further.
+
+### Compatibility
+
+- **Peer deps unchanged**: `@dashforge/tw-theme@^0.1.0-beta` and
+  `@dashforge/tw-tokens@^0.1.0-beta` (neither package was modified in
+  this cycle). Bridge layer (`@dashforge/forms`, `@dashforge/ui-core`,
+  `@dashforge/rbac`) likewise unchanged at the workspace `0.2.3-beta`
+  version.
+
+- **No breaking changes**: the public API of the 16 previously-shipped
+  components is byte-identical. Diff `0.1.0-beta..0.2.0-beta` against
+  `src/index.ts` shows only additive exports (the new Foundation
+  primitives + their `*Variants` recipes + their `*Props` types).
+
+- **Bundle size impact** (gzipped, when fully exercised):
+  `dist/index.esm.js` grew from 255 KB to 272 KB (+17 KB / +6.7%) for
+  the eight new primitives. Tree-shaking unaffected — consumers only
+  pay for what they import.
+
+---
+
 ## [0.1.0-beta] — 2026-05-16
 
 First public beta. Sixteen components shipped across forms, layout, and

package/dist/index.d.ts

@@ -1,82 +1 @@
-/**
- * @dashforge/tw
- *
- * Tailwind-rendered UI components for the Dashforge ecosystem.
- *
- * Architectural contract (plan v2 — 2026-05-15):
- *  - **Props-driven**: each Tailwind utility that matters for the public
- *    API becomes a typed prop. `sx` + `slotProps` are escape hatches.
- *  - **Tokens as source of truth**: components reference colors /
- *    spacing / radius / fontSize through `@dashforge/tw-tokens` via the
- *    `dashforgePreset()` from `@dashforge/tw-theme`.
- *  - **Shared bridge with MUI side**: both ecosystems consume
- *    `@dashforge/forms` + `@dashforge/ui-core` + `@dashforge/rbac`.
- *    No styling code is shared.
- *  - **Variant API**: `tailwind-variants` (TV) with `slots` +
- *    `compoundVariants`.
- *
- * F3 surface (tier-1, this release):
- *  - `<Button>` (action, RBAC only, `asChild` polymorphism)
- *  - `<TextField>` (bridge-integrated, 7 slots)
- *  - `<Checkbox>` (bridge-integrated, Radix Checkbox primitive)
- *  - `<Switch>` (bridge-integrated, Radix Switch primitive)
- *
- * @module @dashforge/tw
- */
-export { Button } from './components/Button/Button.js';
-export type { ButtonProps } from './components/Button/button.types.js';
-export { buttonVariants } from './components/Button/button.variants.js';
-export { TextField } from './components/TextField/TextField.js';
-export type { TextFieldProps, TextFieldSlotProps, } from './components/TextField/textField.types.js';
-export { textFieldVariants } from './components/TextField/textField.variants.js';
-export { Checkbox } from './components/Checkbox/Checkbox.js';
-export type { CheckboxProps, CheckboxSlotProps, } from './components/Checkbox/checkbox.types.js';
-export { checkboxVariants } from './components/Checkbox/checkbox.variants.js';
-export { Switch } from './components/Switch/Switch.js';
-export type { SwitchProps, SwitchSlotProps, } from './components/Switch/switch.types.js';
-export { switchVariants } from './components/Switch/switch.variants.js';
-export { RadioGroup } from './components/RadioGroup/RadioGroup.js';
-export type { RadioGroupProps, RadioGroupOption, RadioGroupSlotProps, } from './components/RadioGroup/radioGroup.types.js';
-export { radioGroupVariants } from './components/RadioGroup/radioGroup.variants.js';
-export { Textarea } from './components/Textarea/Textarea.js';
-export type { TextareaProps, TextareaSlotProps, } from './components/Textarea/textarea.types.js';
-export { textareaVariants } from './components/Textarea/textarea.variants.js';
-export { NumberField } from './components/NumberField/NumberField.js';
-export type { NumberFieldProps, NumberFieldSlotProps, } from './components/NumberField/numberField.types.js';
-export { numberFieldVariants } from './components/NumberField/numberField.variants.js';
-export { OTPField } from './components/OTPField/OTPField.js';
-export type { OTPFieldProps, OTPFieldSlotProps, OTPFieldMode, } from './components/OTPField/otpField.types.js';
-export { otpFieldVariants } from './components/OTPField/otpField.variants.js';
-export { Autocomplete } from './components/Autocomplete/Autocomplete.js';
-export type { AutocompleteProps, AutocompleteOption, AutocompleteSlotProps, AutocompleteValue, } from './components/Autocomplete/autocomplete.types.js';
-export { autocompleteVariants } from './components/Autocomplete/autocomplete.variants.js';
-export { DateTimePicker, isoToInputValue, } from './components/DateTimePicker/DateTimePicker.js';
-export type { DateTimePickerProps, DateTimePickerMode, DateTimePickerSlotProps, } from './components/DateTimePicker/dateTimePicker.types.js';
-export { dateTimePickerVariants } from './components/DateTimePicker/dateTimePicker.variants.js';
-export { Breadcrumbs } from './components/Breadcrumbs/Breadcrumbs.js';
-export type { BreadcrumbsProps, BreadcrumbItem, BreadcrumbsSlotProps, BreadcrumbLinkComponent, } from './components/Breadcrumbs/breadcrumbs.types.js';
-export { breadcrumbsVariants } from './components/Breadcrumbs/breadcrumbs.variants.js';
-export { LeftNav } from './components/LeftNav/LeftNav.js';
-export type { LeftNavProps, LeftNavNode, LeftNavItem, LeftNavGroup, LeftNavSlotProps, LeftNavLinkComponent, } from './components/LeftNav/leftNav.types.js';
-export { leftNavVariants } from './components/LeftNav/leftNav.variants.js';
-export { TopBar } from './components/TopBar/TopBar.js';
-export type { TopBarProps, TopBarSlotProps, } from './components/TopBar/topBar.types.js';
-export { topBarVariants } from './components/TopBar/topBar.variants.js';
-export { AppShell } from './components/AppShell/AppShell.js';
-export type { AppShellProps, AppShellSlotProps, } from './components/AppShell/appShell.types.js';
-export { appShellVariants } from './components/AppShell/appShell.variants.js';
-export { ConfirmDialogProvider, useConfirm, } from './components/ConfirmDialog/ConfirmDialog.js';
-export type { ConfirmDialogProviderProps, ConfirmDialogSlotProps, ConfirmFn, ConfirmOptions, ConfirmSeverity, } from './components/ConfirmDialog/confirmDialog.types.js';
-export { confirmDialogVariants } from './components/ConfirmDialog/confirmDialog.variants.js';
-export { SnackbarProvider, useSnackbar, } from './components/Snackbar/Snackbar.js';
-export type { SnackbarProviderProps, SnackbarApi, SnackbarOptions, SnackbarRecord, SnackbarSeverity, SnackbarPosition, SnackbarSlotProps, } from './components/Snackbar/snackbar.types.js';
-export { snackbarVariants } from './components/Snackbar/snackbar.variants.js';
-export { useAccessState } from './hooks/useAccessState.js';
-export { cn } from './utils/cn.js';
-export { tv } from 'tailwind-variants';
-export type { VariantProps } from 'tailwind-variants';
-/**
- * Package version (synced with `package.json` at publish time).
- */
-export declare const VERSION = "0.1.0-beta";
-//# sourceMappingURL=index.d.ts.map
+export * from "./src/index";