@dashforge/tw 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -12,7 +12,27 @@ This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 > duplicated intentionally — no shared "lowest common denominator" headless
 > layer.
 
-## [1.1.0] — 2026-06-18
+## [1.1.1] — 2026-06-18
+
+> **Re-issued from the unpublished `1.1.0`** — `1.1.0` was published
+> briefly on 2026-06-18 and unpublished within minutes due to a
+> packaging bug: a stale 10 MB `.tgz` orphan (left from `pnpm pack`
+> consumer testing) had been included inside the published npm
+> package, inflating the tarball from the expected ~310 KB to
+> 11.2 MB. `1.1.1` ships the **identical** Sprint 4.4 code — only
+> the packaging metadata changed (`files` whitelist added to
+> `package.json`, orphan `.tgz` removed from the package directory).
+> Tarball size dropped 97 %.
+
+### Packaging fix (vs unpublished 1.1.0)
+
+- **`package.json` — added `"files": ["dist", "README.md", "CHANGELOG.md"]`.**
+  Without an explicit whitelist, `pnpm publish` had been including
+  everything in the package directory that wasn't covered by
+  `.gitignore` — leading to the bloated 11.2 MB tarball. With the
+  whitelist, the published artifact drops to ~310 KB / ~330 files.
+- Removed the orphan `dashforge-tw-1.0.0.tgz` from the package
+  directory.
 
 ### Added
 

package/dist/index.esm.js

@@ -15283,6 +15283,6 @@ function SearchIcon(props) {
  */ // ───── Components ─────
 /**
  * Package version (synced with `package.json` at publish time).
- */ const VERSION = '1.1.0';
+ */ const VERSION = '1.1.1';
 
 export { AVATAR_SOFT_FALLBACK, AVATAR_TONE_FALLBACK, Accordion, Alert, AlertTitle, AppShell, AspectRatio, Autocomplete, Avatar, AvatarGroup, Badge, Box, Breadcrumbs, Button, Calendar, Card, CardActionArea, CardContent, Checkbox, Chip, ConfirmDialogProvider, Container, DataGrid, DatePicker, DateRangePicker, DateTimePicker, Dialog, Divider, Grid, ICON_BUTTON_BASE, ICON_BUTTON_SIZE_OVERRIDES, IconButton, LeftNav, Menu, MenuContent, MenuItem, MenuLabel, MenuSeparator, MenuSkeleton, MenuTrigger, NumberField, OTPField, Pagination, Popover, RadioGroup, RenderButton, RenderChip, RenderText, RenderTwoLine, RowActionsMenu, SPINNER_COLORS, SPINNER_STROKE_WIDTH, SPINNER_TRACK_OPACITY, Skeleton, SnackbarProvider, Spinner, Stack, Switch, Table, Tabs, TextField, Textarea, TimePicker, Tooltip, TopBar, Typography, VERSION, VisuallyHidden, accordionVariants, alertVariants, appShellVariants, autocompleteVariants, avatarVariants, badgeVariants, boxVariants, breadcrumbsVariants, buttonVariants, calendarDayVariants, calendarVariants, checkboxVariants, chipVariants, cn, confirmDialogVariants, containerVariants, dataGridVariants, datePickerVariants, dateRangeDayVariants, dateRangePickerVariants, dateTimePickerVariants, dialogVariants, dividerLineVariants, dividerVariants, getNestedValue, gridVariants, leftNavVariants, menuVariants, numberFieldVariants, otpFieldVariants, paginationVariants, popoverVariants, radioGroupVariants, skeletonVariants, snackbarVariants, spinnerVariants, stackVariants, switchVariants, tableVariants, tabsVariants, textFieldVariants, textareaVariants, timePickerVariants, tooltipVariants, topBarVariants, typographyVariants, useAccessState, useConfirm, useSnackbar };

package/dist/src/index.d.ts

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

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "@dashforge/tw",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "private": false,
   "type": "module",
   "main": "./dist/index.esm.js",
   "module": "./dist/index.esm.js",
   "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "exports": {
     "./package.json": "./package.json",
     ".": {
@@ -30,8 +35,8 @@
     "tailwind-variants": "^3.1.1",
     "@dashforge/calendar-core": "1.0.0",
     "@dashforge/ui-core": "1.0.0",
-    "@dashforge/forms": "1.0.0",
-    "@dashforge/rbac": "1.0.0"
+    "@dashforge/rbac": "1.0.0",
+    "@dashforge/forms": "1.0.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",

package/.swcrc

@@ -1,29 +0,0 @@
-{
-  "jsc": {
-    "target": "es2017",
-    "parser": {
-      "syntax": "typescript",
-      "decorators": true,
-      "dynamicImport": true
-    },
-    "transform": {
-      "decoratorMetadata": true,
-      "legacyDecorator": true
-    },
-    "keepClassNames": true,
-    "externalHelpers": true,
-    "loose": true
-  },
-  "module": {
-    "type": "es6"
-  },
-  "sourceMaps": true,
-  "exclude": [
-    "jest.config.[ct]s",
-    ".*\\.spec.tsx?$",
-    ".*\\.test.tsx?$",
-    "./src/jest-setup.ts$",
-    "./**/jest-setup.ts$",
-    ".*.js$"
-  ]
-}

package/A11Y.md

@@ -1,130 +0,0 @@
-# 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/CONSUMER-VALIDATION.md

@@ -1,130 +0,0 @@
-# Consumer Validation — `@dashforge/tw`
-
-> Sprint 2 P1 deliverable. Validation di tutti i 24 componenti shippati
-> in `@dashforge/tw 0.2.1-beta` su un app consumer reale
-> (`~/projects/web/learn/dash`). Esegue il check 7-point per ogni
-> componente, documenta gap residui.
-
-**Stato sessione**: 17 maggio 2026 — Sprint 2 in corso.
-**Dist sotto test**: `@dashforge/tw@0.2.1-beta`
-(file:-linked dal monorepo, dist mtime fresh).
-
-## Test pages
-
-| URL | Componenti coperti | Note |
-|---|---|---|
-| `/test-foundation` | Typography, Box, Stack, Grid, Container, Divider, AspectRatio, VisuallyHidden | Foundation 8/8 |
-| `/test-tw` | Button, TextField, Checkbox, Switch, RadioGroup, Textarea, NumberField, OTPField, Autocomplete, DateTimePicker | Tier-1 + Tier-2 form controls 10/10. Wrappati in `<DashForm>` con rules + defaultValues realistici |
-| `/test-layout` | AppShell, TopBar, LeftNav, Breadcrumbs | Nav/Layout 4/4. Drawer mobile + collapse toggle + theme switch in chrome |
-| `/test-providers` | ConfirmDialog, Snackbar | Provider patterns 2/2. Severità, action button, dedup, sticky tutti coperti |
-
-## Check 7-point
-
-Per ogni componente, marca: ✅ OK / ⚠️ minor / ❌ blocker / ➖ N/A
-
-1. **Render** — niente layout broken, niente console error, niente warning sospetti
-2. **Interactions** — click / type / toggle / select funzionano end-to-end
-3. **Theme** — dark/light flip via `toggleMode()` aggiorna il componente in lockstep
-4. **RHF** — se form-mode, `<DashForm>` registra il field e il valore va in `onSubmit`
-5. **RBAC** — se applicabile, `access` con `denied:hide/disable/readonly` rispetta la doc *(gap: TestRbac su dash usa MUI side, no test tw RBAC esplicito — testato indirettamente via Sprint 1 lib tests)*
-6. **Focus** — focus-visible ring appare con Tab, scompare con click
-7. **Keyboard** — Enter/Space/Arrow funzionano (RadioGroup option nav, Autocomplete listbox, etc.)
-
-## Foundation (8/8)
-
-| Componente | Render | Interactions | Theme | RHF | RBAC | Focus | Keyboard | Note |
-|---|:-:|:-:|:-:|:-:|:-:|:-:|:-:|---|
-| Typography | ⏳ | ➖ | ⏳ | ➖ | ➖ | ➖ | ➖ | |
-| Box | ⏳ | ➖ | ⏳ | ➖ | ➖ | ➖ | ➖ | |
-| Stack | ⏳ | ➖ | ⏳ | ➖ | ➖ | ➖ | ➖ | |
-| Grid | ⏳ | ➖ | ⏳ | ➖ | ➖ | ➖ | ➖ | |
-| Container | ⏳ | ➖ | ⏳ | ➖ | ➖ | ➖ | ➖ | |
-| Divider | ⏳ | ➖ | ⏳ | ➖ | ➖ | ➖ | ➖ | |
-| AspectRatio | ⏳ | ➖ | ⏳ | ➖ | ➖ | ➖ | ➖ | |
-| VisuallyHidden | ⏳ | ➖ | ➖ | ➖ | ➖ | ➖ | ➖ | A11y primitive — verifica solo a livello AT |
-
-## Tier-1 form controls (4/4)
-
-| Componente | Render | Interactions | Theme | RHF | RBAC | Focus | Keyboard | Note |
-|---|:-:|:-:|:-:|:-:|:-:|:-:|:-:|---|
-| Button | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ | Verifica anche `loading` (aria-busy fix Sprint 1 P7) |
-| TextField | ⏳ | ⏳ | ⏳ | ⏳ | ➖ | ⏳ | ⏳ | `required` + `pattern` rules attivati in TestTw |
-| Checkbox | ⏳ | ⏳ | ⏳ | ⏳ | ➖ | ⏳ | ⏳ | **Critical**: verifica fix Sprint 1 commit `081f6f0` (indicator mounts dopo click standalone) |
-| Switch | ⏳ | ⏳ | ⏳ | ⏳ | ➖ | ⏳ | ⏳ | Thumb animation (richiede `--tw-translate-y` init nel preflight — verificato in docs-lab ma dash potrebbe avere setup diverso) |
-
-## Tier-2 / 3 form controls (6/6)
-
-| Componente | Render | Interactions | Theme | RHF | RBAC | Focus | Keyboard | Note |
-|---|:-:|:-:|:-:|:-:|:-:|:-:|:-:|---|
-| RadioGroup | ⏳ | ⏳ | ⏳ | ⏳ | ➖ | ⏳ | ⏳ | **Critical**: verifica fix Sprint 1 commit `eb5a1c6` (click cambia selezione standalone) |
-| Textarea | ⏳ | ⏳ | ⏳ | ⏳ | ➖ | ⏳ | ➖ | `rows={3}` + `resize=vertical` default |
-| NumberField | ⏳ | ⏳ | ⏳ | ⏳ | ➖ | ⏳ | ⏳ | **Critical**: verifica fix Sprint 1 commit `12e6b67` (input + stepper persistono standalone). Stepper aria-hidden by design. |
-| OTPField | ⏳ | ⏳ | ⏳ | ⏳ | ➖ | ⏳ | ⏳ | Paste behavior, length=6 numeric in TestTw |
-| Autocomplete | ⏳ | ⏳ | ⏳ | ⏳ | ➖ | ⏳ | ⏳ | **Pre-flagged P2**: dropdown icon va a capo su multi-select, preview shell troppo piccola — questo è issue del docs-lab. Verifica se in dash si vede correttamente. |
-| DateTimePicker | ⏳ | ⏳ | ⏳ | ⏳ | ➖ | ⏳ | ⏳ | Native HTML5 inputs, modes date/time/datetime |
-
-## Nav / Layout (4/4)
-
-| Componente | Render | Interactions | Theme | RHF | RBAC | Focus | Keyboard | Note |
-|---|:-:|:-:|:-:|:-:|:-:|:-:|:-:|---|
-| AppShell | ⏳ | ⏳ | ⏳ | ➖ | ➖ | ⏳ | ⏳ | Drawer mobile + Escape close + body scroll lock |
-| TopBar | ⏳ | ⏳ | ⏳ | ➖ | ➖ | ⏳ | ➖ | **Pre-flagged P2**: rimuovi underline dai link interni |
-| LeftNav | ⏳ | ⏳ | ⏳ | ➖ | ➖ | ⏳ | ⏳ | **Pre-flagged P2**: rimuovi underline dai link. Verifica groups expand/collapse + rail mode |
-| Breadcrumbs | ⏳ | ⏳ | ⏳ | ➖ | ➖ | ⏳ | ➖ | Trail dinamico in TestLayout (cambia con sidebar pick) |
-
-## Overlays / Providers (2/2)
-
-| Componente | Render | Interactions | Theme | RHF | RBAC | Focus | Keyboard | Note |
-|---|:-:|:-:|:-:|:-:|:-:|:-:|:-:|---|
-| ConfirmDialog | ⏳ | ⏳ | ⏳ | ➖ | ➖ | ⏳ | ⏳ | Severità info/warning/danger/success, Escape close, focus trap (Radix-backed) |
-| Snackbar | ⏳ | ⏳ | ⏳ | ➖ | ➖ | ⏳ | ➖ | `aria-live="polite"`. Verifica position bottom-right + autoHideMs 0 (sticky) + action button + dedup by id |
-
-## Issue residui scoperti durante validation
-
-> Sezione aggiornata in real-time durante il walkthrough. Ogni issue
-> trovato qui diventa P2-P5 candidate per Sprint 2 (o backlog per
-> Sprint 3+ se non blocking).
-
-### Issue scoperti durante walkthrough 17 maggio (fixati in P1)
-
-1. **🐛 Autocomplete async loader — option click NON committa la selezione**
-   (gravità: alta — bug funzionale visibile a tutti gli utenti con `loadOptions`)
-   - **Sintomo**: utente type nella combobox async-loaded, results appaiono, click su un option → popover si chiude ma input rimane sulla query di ricerca, label dell'option selezionata NON viene scritto.
-   - **Root cause**: `commitSelection` (`Autocomplete.tsx` line 405) cercava il label dentro la prop statica `options` (per il caso async è `[]`) invece che dentro l'effective pool (`asyncOptions` quando `loadOptions` è configured).
-   - **Fix**: lookup nel pool effettivo (`loadOptions && asyncOptions !== null ? asyncOptions : options`) + aggiunto `asyncOptions`/`loadOptions` ai deps del `useCallback`.
-   - **Repro / verify**: nel dash su `/test-tw`, scroll al "User search (async loader)", type "a" → wait 500ms → results "Alice Cooper / Walker / ...". Click "Alice Cooper". Pre-fix: input mostra "a". Post-fix: input mostra "Alice Cooper".
-   - **Test coverage**: i 38 functional Autocomplete test passano (2 perf flake non related — soglia 500ms/100ms su macchina caricata = 665ms/2010ms).
-
-2. **🎨 Autocomplete icons (chip remove ×, clear ×, caret ▾) brutte**
-   (gravità: bassa — cosmetico)
-   - **Sintomo**: chip remove, clear button, dropdown caret renderizzati come glyph Unicode (`×`, `▾`) che escono come font chunky inconsistenti vs il resto del design system.
-   - **Fix**: 2 nuovi componenti inline SVG `CloseIcon` + `ChevronDownIcon` (mirror del CheckIcon di Checkbox per consistenza). `width="1em" height="1em"` per scalare con `font-size` del parent. Stroke `currentColor` per ereditare `text-*` di Tailwind. Bonus: chevron flip animation su `aria-expanded=true` (CSS-only).
-
-### Issue pre-flagged dal docs walkthrough 17 maggio (carryover Sprint 2 P2)
-
-Da chiudere come prossimo step di Sprint 2 (sono nel ROADMAP-SPRINT-2.md):
-1. **LeftNav underline link** — lib variants fix (`no-underline`)
-2. **TopBar underline link** — lib variants fix (`no-underline`)
-3. **Autocomplete preview shell troppo piccola in docs-lab** — solo docs-lab issue, non blocca dash
-
-### Gap noti (non-blocking, da Sprint 2 P5 o backlog)
-
-- **RBAC tw-side non testato esplicitamente in dash**: TestRbac usa `@dashforge/ui` (MUI). RBAC su tw è coperto da unit test (`useAccessState` + per-component) ma manca smoke test in consumer reale. Da aggiungere: `/test-tw-rbac` route con `<TextField access={...}>` esercitando i 3 modes (hide/disable/readonly).
-
-## Summary risultati P1
-
-| Status | Count | Componenti |
-|---|---:|---|
-| ✅ Full pass | **22** | Foundation 8 (Typography, Box, Stack, Grid, Container, Divider, AspectRatio, VisuallyHidden); Tier-1 4 (Button, TextField, Checkbox, Switch); Tier-2/3 5 (RadioGroup, Textarea, NumberField, OTPField, DateTimePicker); Nav 4 (AppShell, TopBar, LeftNav, Breadcrumbs); Providers 2 (ConfirmDialog, Snackbar) |
-| ⚠️ Minor → **fixato in P1** | **1** | Autocomplete (icons cosmetic) |
-| ❌ Blocker → **fixato in P1** | **1** | Autocomplete async-options select bug |
-
-**Sprint 2 quality gate**: ✅ **PASSED** — tutti i 24 verdi dopo P1 fix.
-
-## Outcome aggregato
-
-P1 ha trovato esattamente 2 issue su 24 componenti (~8% catch rate). Entrambi fixabili in lib senza public API change. Tutti gli altri 22 hanno passato i 7-point check al primo giro.
-
-**Pattern interessante**: il bug Autocomplete async-options era **invisibile sia al CI unit test** (test setup usa `options` prop static) **sia al docs lab** (Autocomplete demo è static). **Solo un consumer reale con `loadOptions` configured esponeva il bug** — esattamente il valore di P1 nello Sprint 2.
-
-**Implicazione per Sprint 3+**: aggiungere test unit con `loadOptions` mock al test suite Autocomplete + considerare un demo async nel docs lab per future-proofing.

package/COVERAGE.md

@@ -1,63 +0,0 @@
-# COVERAGE — `@dashforge/tw`
-
-> Test-coverage audit for `@dashforge/tw`. Current numbers, the gap-fill
-> performed, and the tracked debt.
-
-## Current coverage (`vitest --coverage`, v8 provider)
-
-| Metric | Value | Target |
-|--------|-------|--------|
-| Statements | 83.53% | — |
-| **Branches** | **75.87%** | 85% (not met — see Deferred) |
-| Functions | 89.06% | — |
-| **Lines** | **85.78%** | 85% ✅ |
-
-Suite: **1105 tests** across 55 files.
-
-## Filled in Sprint 6 P4 (+62 tests)
-
-P4 targeted the Sprint 4.2 / 4.2-bis additions that shipped with
-integration-only coverage. All are now directly unit-tested:
-
-| Area | Before | After |
-|------|--------|-------|
-| Cell renderer library (`Table/cells/` — RenderText / RenderTwoLine / RenderChip / RenderButton / RowActionsMenu) | ~0% | high (30 tests) |
-| `DataGrid/filters/ColumnFilters.tsx` | 22% branch | covered — every filter type + apply/clear/Enter (17 tests) |
-| `DataGrid/resize/useColumnResize.ts` | 33% | **100%** (8 tests — `nudge` clamp paths + pointer-drag commit) |
-| `DataGrid/reorder/useColumnReorder.ts` | 32% | 93% stmts / 98% lines (14 tests — `moveColumn` + drag handlers) |
-
-## Deferred — pre-Sprint-6 branch-coverage debt
-
-Line coverage met the 85% target. **Branch coverage (75.87%) did
-not.** The shortfall is concentrated in form-input components that
-predate Sprint 6 and shipped with partial branch coverage — their
-validation-state / RBAC / controlled-vs-uncontrolled branches are
-under-exercised:
-
-| Component | Branch % |
-|-----------|----------|
-| `NumberField` | 50.56% |
-| `AppShell` | 55.81% |
-| `Textarea` | 56% |
-| `Switch` | 62.5% |
-| `TextField` | 63.63% |
-| `RadioGroup` | 64.06% |
-| `Checkbox` | 67.5% |
-| `Autocomplete` | 68% |
-| `OTPField` | 69.56% |
-| `Dialog` | 75% |
-| `DataGrid` | 76.15% |
-
-Closing this to 85% overall is a focused **test-debt paydown
-sprint** (~100+ branch-targeted tests across the 11 components) —
-deliberately scoped OUT of Sprint 6, which is a Table/DataGrid +
-theme-core refinement pass. Recommended slot: alongside the
-`1.0.0-rc` hardening sprint.
-
-## CI gate
-
-The catalog-wide regression suite (`nx test @dashforge/tw`) is the
-enforced gate. A hard per-file coverage threshold is **not** wired
-into CI yet — doing so requires first closing the pre-Sprint-6 debt
-above, otherwise the gate fails on day one. Wiring the threshold is
-part of the same `1.0.0-rc` test-debt sprint.