@dashforge/tw 0.1.0-beta

package/.swcrc

@@ -0,0 +1,29 @@
+{
+  "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/CHANGELOG.md

@@ -0,0 +1,131 @@
+# Changelog — @dashforge/tw
+
+All notable changes to `@dashforge/tw` are documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+> This package is part of the **`@dashforge/tw-*` Tailwind ecosystem**, built
+> as a fully isolated stack sharing only the bridge layer
+> (`@dashforge/forms` + `@dashforge/ui-core` + `@dashforge/rbac`) with the
+> MUI side of Dashforge. Tokens, theme runtime, and components are
+> duplicated intentionally — no shared "lowest common denominator" headless
+> layer.
+
+## [0.1.0-beta] — 2026-05-16
+
+First public beta. Sixteen components shipped across forms, layout, and
+providers — every component is bridge-integrated, RBAC-aware,
+StrictMode-safe, and covered by unit + perf + re-render budget tests.
+
+### Added — Form components (10)
+
+- **`Button`** (F3) — variant + size + color matrix, polymorphic
+  `asChild` slot, RBAC `access` prop, loading/disabled states.
+- **`TextField`** (F3) — bridge-integrated single-line input with
+  7-slot taxonomy, stacked/inline layouts, error gating via Form
+  Closure v1.
+- **`Checkbox`** (F3) — Radix Checkbox primitive, bridge wiring,
+  RBAC + visibility.
+- **`Switch`** (F3) — Radix Switch primitive, same contract as Checkbox.
+- **`RadioGroup`** (F4) — Radix RadioGroup with row/stacked layouts.
+- **`Textarea`** (F4) — multi-line variant of TextField, vertical
+  resize support.
+- **`NumberField`** (F4) — locale-aware number input, optional
+  stepper buttons, min/max/step constraints.
+- **`OTPField`** (F4) — segmented one-time-code input (numeric /
+  alphanumeric), sanitized paste.
+- **`Autocomplete`** (F5-A → F5-A-bis) — single + multi-select
+  combobox; generic option shape via `getOptionValue` /
+  `getOptionLabel`; free-solo (Enter / blur commits typed text);
+  async runtime via `loadOptions(query)` with debounce + loading
+  row + race-safe fetch generation. **Custom pure-React
+  implementation** (no react-aria-components) for deterministic
+  state ownership — the F5-A clear-button regression was the
+  motivating lesson.
+- **`DateTimePicker`** (F5-B) — native HTML5 inputs (`date` /
+  `time` / `datetime-local`), `min` / `max` / `step` forwarded,
+  ISO 8601 ⇔ native input value conversion, `color-scheme: light
+  dark` for OS-icon legibility in dark mode.
+
+### Added — Layout components (4)
+
+- **`Breadcrumbs`** (F6) — router-agnostic crumb trail with
+  middle-collapse (`maxItems`, `itemsBeforeCollapse`,
+  `itemsAfterCollapse`), polymorphic `linkComponent`,
+  `aria-current="page"` on the active crumb.
+- **`LeftNav`** (F6) — sidebar with flat items + collapsible
+  groups; rail mode (`collapsed` + `sr-only` labels + tooltips);
+  per-row RBAC; controlled / uncontrolled group expansion;
+  brand + footer slots.
+- **`TopBar`** (F6) — sticky `<header>` with `start` / `center` /
+  `end` slots; renders as `<header>` (banner landmark) or `<div>`
+  via `asDiv`.
+- **`AppShell`** (F6) — top-level orchestrator wiring `header` +
+  `nav` (desktop inline + mobile drawer) + `main` + `footer`;
+  body scroll-lock + Escape close + backdrop click; responsive
+  switch at the `md` breakpoint.
+
+### Added — Providers (2)
+
+- **`ConfirmDialogProvider`** + **`useConfirm()`** (F7) —
+  imperative `Promise<boolean>` confirmation modal on the native
+  `<dialog>` element + `showModal()` (AAA-grade a11y + focus
+  trap + Escape free from the browser); FIFO request queue;
+  4 severities; `disableBackdropClose` / `disableEscapeClose`
+  per-invocation.
+- **`SnackbarProvider`** + **`useSnackbar()`** (F7) — transient
+  toast notifications, 6 corner positions, `maxVisible` cap with
+  FIFO promotion, de-dup by `id` (re-enqueueing replaces in
+  place + resets timer), action buttons, persistent mode
+  (`autoHideMs: 0`), `aria-live="polite"` region for AT.
+
+### Added — Tooling
+
+- **`flat-dts.cjs`** post-build script (also added to `@dashforge/forms`,
+  `@dashforge/ui-core`, `@dashforge/rbac`) — rewrites the Rollup-emitted
+  `dist/index.d.ts` `export * from "./src/index"` wrapper with explicit
+  re-exports. Works around a TypeScript bundler-resolution bug where
+  `export *` in a dist wrapper drops re-exports under project references.
+- **`eslint-plugin-react-hooks`** scoped to this package — exposes real
+  `rules-of-hooks` and `exhaustive-deps` violations that were previously
+  hidden.
+
+### Quality
+
+- **317 tests passing** (≈90 unit, the rest perf + re-render budgets).
+- Strict re-render guardrails: typing into a field never re-renders an
+  unrelated sibling; `confirm()` and `useSnackbar()` return identities
+  are stable across provider re-renders.
+- Perf budgets pinned for mount cost (e.g. `<LeftNav>` 300-row mount
+  under 250 ms, `<Autocomplete>` 1000-option mount under 500 ms).
+- Lint + typecheck + build all green workspace-wide.
+
+### Architecture notes
+
+- **`peerDependencies`**: `react ^18 || ^19`, plus
+  `@dashforge/tw-tokens` and `@dashforge/tw-theme` (CSS variable provider
+  + Tailwind preset must be wired by the consumer).
+- **`dependencies`**: `@dashforge/forms`, `@dashforge/rbac`,
+  `@dashforge/ui-core`, `@radix-ui/react-{checkbox,radio-group,slot,switch}`,
+  `clsx`, `tailwind-merge`, `tailwind-variants`. No `react-aria-components`
+  (the Autocomplete rewrite dropped the dep).
+
+## [0.0.1] — 2026-05-15
+
+### Added
+
+- **Initial scaffolding (F1 of the *dashforge-tw* roadmap).** Empty
+  components surface; package exports the cross-cutting utilities the
+  later component code will rely on:
+  - `cn()` — `clsx` + `tailwind-merge` wrapper for safe class
+    concatenation with last-wins conflict resolution.
+  - `tv` — re-export of `tailwind-variants` so consumers (and the
+    forthcoming F3 components) have a single canonical import path.
+- Rollup build (CJS + ESM + .d.ts). `types` path corrected from the Nx
+  generator default (`./dist/index.esm.d.ts`) to `./dist/index.d.ts`.
+- `tailwind-merge` added as a regular dependency (peer-required by
+  `tailwind-variants`; consumers shouldn't have to know that detail).
+- Smoke-tested in `~/projects/web/learn/dash` via `pnpm link` together
+  with `@dashforge/tw-tokens` and `@dashforge/tw-theme`. Browser build
+  green.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dashforge
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,244 @@
+# @dashforge/tw
+
+> **Status**: `0.1.0-beta` — first public beta. Sixteen components
+> shipped across forms, layout, and providers. The MUI side of
+> Dashforge (`@dashforge/ui`, `@dashforge/theme-mui`,
+> `@dashforge/theme-core`) is **fully isolated** from this package —
+> the two ecosystems share only the bridge layer (`@dashforge/forms` +
+> `@dashforge/ui-core` + `@dashforge/rbac`).
+
+Tailwind-rendered UI components for the Dashforge ecosystem.
+
+Components are **props-driven** (every Tailwind utility that matters
+for the public API becomes a typed prop — `size`, `color`, `variant`,
+`layout`, …). Raw `className` / `sx` / `slotProps` exist as escape
+hatches for the cases the prop surface doesn't cover.
+
+## Component catalog
+
+### Form components (10)
+
+`Button` · `TextField` · `Checkbox` · `Switch` · `RadioGroup` ·
+`Textarea` · `NumberField` · `OTPField` · `Autocomplete` ·
+`DateTimePicker`
+
+All bridge-integrated, RBAC-aware (`access` prop), Form Closure v1
+error gating, StrictMode-safe.
+
+### Layout components (4)
+
+`Breadcrumbs` · `LeftNav` · `TopBar` · `AppShell`
+
+Router-agnostic — pass a `linkComponent` prop for SPA navigation
+(React Router, Next, TanStack Router, …). Mobile-responsive shell
+with drawer + body scroll lock.
+
+### Providers (2)
+
+`ConfirmDialogProvider` + `useConfirm()` · `SnackbarProvider` +
+`useSnackbar()`
+
+Imperative APIs (`await confirm({...})`, `enqueue({...})`) backed by
+queues, FIFO ordering, and dedup. Built on native `<dialog>` for AAA
+a11y where possible.
+
+## Quick start
+
+Install the three TW packages alongside the shared bridge layer:
+
+```bash
+pnpm add @dashforge/tw @dashforge/tw-theme @dashforge/tw-tokens \
+        @dashforge/forms @dashforge/ui-core @dashforge/rbac \
+        react react-dom tailwindcss
+```
+
+Wire the Tailwind preset + theme provider as described in
+[`@dashforge/tw-theme`](../tw-theme/README.md), then mount components
+inside a `DashFormProvider`:
+
+```tsx
+import { DashForm } from '@dashforge/forms';
+import { Button, TextField, Checkbox, Switch } from '@dashforge/tw';
+
+export function SignUp() {
+  return (
+    <DashForm defaultValues={{ email: '', terms: false, newsletter: true }}>
+      <TextField
+        name="email"
+        label="Email"
+        type="email"
+        rules={{ required: 'Email is required' }}
+        required
+        fullWidth
+      />
+      <Checkbox name="terms" label="I accept the Terms & Conditions" />
+      <Switch name="newsletter" label="Subscribe to the newsletter" />
+      <Button type="submit" variant="solid" color="primary">Sign up</Button>
+    </DashForm>
+  );
+}
+```
+
+## F3 surface (tier-1)
+
+| Component | Bridge integration | Notes |
+|---|---|---|
+| `<Button>` | RBAC-only (action, no form state) | `variant` × `color` × `size`, `loading`, `fullWidth`, `asChild` (Radix Slot polymorphism). |
+| `<TextField>` | Full form bridge | 7-slot TV recipe (root/label/requiredMark/inputWrapper/input/helperText/errorText). Layouts: `stacked` (default), `inline`. Floating label deferred. |
+| `<Checkbox>` | Full form bridge | Radix `Checkbox.Root` + `Indicator`. Inline `<CheckIcon>` SVG, no icon dep. |
+| `<Switch>` | Full form bridge | Radix `Switch.Root` + `Thumb`, translate-x animated. |
+
+All four components mirror the MUI-side semantics at the bridge level:
+same `name` / `rules` / `visibleWhen` / `access` props, same StrictMode-
+safe unregister pattern, same per-field re-render isolation via
+`useDashFieldMeta`.
+
+## Override system
+
+```tsx
+<TextField
+  name="email"
+  label="Email"
+  // root override (raw classes — last wins via tailwind-merge)
+  sx="md:w-1/2"
+  // per-slot override (typed)
+  slotProps={{
+    input: { className: 'font-mono tracking-wide' },
+    label: { className: 'uppercase text-secondary-700' },
+  }}
+/>
+```
+
+`sx` is a `className` shortcut for the root slot (string or
+`ClassValue` accepted by `clsx`). `slotProps` is the canonical
+per-slot override path. Both go through the package's `cn()` (wraps
+`clsx` + `tailwind-merge`) so override classes reliably beat the
+variant defaults regardless of stylesheet order.
+
+---
+
+## Common consumer pitfalls
+
+The following are **not library bugs** — they're use-time issues that
+emerge from how the host application is set up. Documented here so you
+can avoid them or recognise the symptom quickly.
+
+### 1. Labels / helper text appear centered
+
+**Symptom.** Form labels and the `helperText` / `errorText` lines of
+`<TextField>`, `<Checkbox>`, `<Switch>` render center-aligned, even
+though the variants emit no `text-center` class.
+
+**Root cause.** A parent element (typically `#root`, often a residue
+of the Vite React template — `text-align: center` is set in the
+default `src/index.css`) imposes a global text-align, and the
+component's `<label>` / `<p>` inherit it because the variants do not
+declare an explicit `text-align: left`.
+
+**Fix.** In your application's global stylesheet, remove or scope down
+the inherited centering:
+
+```css
+/* Before — Vite React template default */
+#root {
+  text-align: center;   /* leaks into every form component below */
+}
+
+/* After — restrict centering to the placeholder hero only */
+#root {
+  /* nothing here */
+}
+.hero-section {
+  text-align: center;
+}
+```
+
+The library does **not** add `text-left` defensively to its variants:
+this is a deliberate choice — components inherit normal text-align,
+which is what a neutral parent provides.
+
+### 2. Dark mode looks broken — surface ladder mismatch
+
+**Symptom.** You call `setMode('dark')` (or `toggleMode()`) from
+`@dashforge/tw-theme`, the `data-dash-tw-theme="dark"` attribute flips
+on `<html>`, but the form looks washed-out — labels are barely visible
+on the card, or the card itself stays bright white while everything
+around it goes dark.
+
+**Root cause.** This is a **page-level setup problem**, not a library
+bug. All `@dashforge/tw` components use neutral-scale tokens
+(`bg-neutral-50` for input surfaces, `text-neutral-900` for text)
+which the `@dashforge/tw-tokens` dark theme inverts automatically
+(`neutral-50` ↔ `neutral-950`, `neutral-100` ↔ `neutral-900`, etc.).
+The library is fully dark-aware out of the box.
+
+What goes wrong: the host page (or card container) uses literal
+classes like `bg-white` or `text-black` that **don't** invert. The
+ladder then breaks — components swap but the surrounding container
+doesn't.
+
+**Fix — use a 3-level elevation ladder of inverting neutral tokens
+for page, card, and inputs.** All `bg-neutral-*` classes invert
+automatically through the dashforge preset, so the same JSX produces
+a coherent light AND dark layout without any `dark:` variant:
+
+```tsx
+<DashforgeTailwindProvider>
+  {/* page = neutral-200  → #e5e5e5 light  /  #262626 dark */}
+  <main className="min-h-screen bg-neutral-200 p-8">
+    {/* card = neutral-100 → #f5f5f5 light  /  #171717 dark */}
+    <div className="rounded-lg bg-neutral-100 p-8 shadow-md border border-neutral-200">
+      {/* inputs = neutral-50 (built into the component variants)
+          → #fafafa light  /  #0a0a0a dark */}
+      <TextField name="email" label="Email" />
+      <Checkbox name="terms" label="Accept" />
+    </div>
+  </main>
+</DashforgeTailwindProvider>
+```
+
+The same JSX renders correctly in light AND dark mode. In light the
+ladder goes outer-grayer → inner-brighter (standard elevation, "higher
+surface = brighter"). In dark the ladder inverts to outer-lighter →
+inner-darker ("inset feel"), which is the macOS Big Sur / modern dark-UI
+convention.
+
+**Anti-pattern to AVOID**: do NOT mix literal `bg-white` / `text-black`
+into the elevation ladder, and do NOT use Tailwind's `dark:` variant
+in your page — the dashforge preset handles dark mode through CSS
+variable inversion, not through the standard Tailwind dark selector.
+Adding `dark:bg-neutral-900` actually picks the WRONG end of the
+inversion in dark mode (`neutral-900` inverts to `neutral-100` =
+light grey) and breaks the layout.
+
+**Alternative override (advanced):** if you need a specific input
+on a non-standard surface, use `slotProps` to override that single
+slot:
+
+```tsx
+<TextField
+  name="email"
+  slotProps={{ inputWrapper: { className: 'bg-neutral-100' } }}
+/>
+```
+
+---
+
+## Building + testing
+
+```bash
+nx build @dashforge/tw      # rollup ESM + d.ts
+nx test @dashforge/tw       # vitest
+nx typecheck @dashforge/tw  # tsc --noEmit on tsconfig.lib.json
+```
+
+See the workspace root README for monorepo-wide commands.
+
+## See also
+
+- [`@dashforge/tw-theme`](../tw-theme/README.md) — Tailwind preset +
+  reactive theme provider + SSR helper.
+- [`@dashforge/tw-tokens`](../tw-tokens/README.md) — token type
+  contracts + default light / dark themes.
+- [`@dashforge/forms`](../forms/README.md) — form bridge consumed by
+  both ecosystems (MUI + TW).

package/dist/components/AppShell/AppShell.d.ts

@@ -0,0 +1,32 @@
+import type { AppShellProps } from './appShell.types.js';
+/**
+ * Dashforge TW AppShell — top-level layout orchestrator.
+ *
+ *   ┌──────────────────────────────────────────┐
+ *   │              header                      │  ← `header` slot
+ *   ├────────┬─────────────────────────────────┤
+ *   │        │                                 │
+ *   │  nav   │           main                  │  ← `nav` + `children`
+ *   │        │                                 │
+ *   ├────────┴─────────────────────────────────┤
+ *   │              footer                      │  ← `footer` slot
+ *   └──────────────────────────────────────────┘
+ *
+ * **Responsive**:
+ *   - `≥ md`: nav stays in the inline slot at the left.
+ *   - `< md`: nav becomes a slide-in drawer toggled by `navOpen`.
+ *     A backdrop closes the drawer on click (mirrors `<Dialog>` UX).
+ *
+ * **Body scroll lock**: when the mobile drawer is open we add
+ * `overflow-hidden` to `<body>` to prevent dual-scroll wobble. The
+ * effect cleans up on close + on unmount.
+ *
+ * **A11y**:
+ *   - `<main>` landmark wraps the content area.
+ *   - `<header>` / `<footer>` come for free from their HTML tags.
+ *   - The mobile drawer + backdrop participate in the standard
+ *     "click outside to close" pattern — `Escape` closes the drawer
+ *     too (added via global keydown).
+ */
+export declare function AppShell(props: AppShellProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AppShell.d.ts.map

package/dist/components/AppShell/AppShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../../src/components/AppShell/AppShell.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,2CA+E5C"}

package/dist/components/AppShell/appShell.types.d.ts

@@ -0,0 +1,62 @@
+import type { ReactNode } from 'react';
+import type { AppShellVariants } from './appShell.variants.js';
+export interface AppShellSlotProps {
+    root?: {
+        className?: string;
+    };
+    header?: {
+        className?: string;
+    };
+    nav?: {
+        className?: string;
+    };
+    navMobile?: {
+        className?: string;
+    };
+    main?: {
+        className?: string;
+    };
+    footer?: {
+        className?: string;
+    };
+    backdrop?: {
+        className?: string;
+    };
+}
+/**
+ * Props for `<AppShell>`.
+ *
+ * Top-level layout orchestrator with 4 named slots:
+ *
+ *   - `header` (top, sticky)
+ *   - `nav`    (left side, fixed-width on desktop, drawer on mobile)
+ *   - `footer` (bottom, non-sticky)
+ *   - `children` (main content, scrolls independently)
+ *
+ * Responsive behavior:
+ *   - **≥ md (768px)**: nav is rendered inline at the left.
+ *   - **< md**:        nav slides in as an overlay drawer when
+ *                      `navOpen={true}` (controlled).
+ *
+ * The shell is router-agnostic — pass any nav/header content. Typical
+ * pairing is `<LeftNav>` + `<TopBar>` (with a hamburger button in
+ * `TopBar.start` that flips `navOpen`).
+ */
+export interface AppShellProps extends AppShellVariants {
+    header?: ReactNode;
+    nav?: ReactNode;
+    footer?: ReactNode;
+    children?: ReactNode;
+    /**
+     * Mobile drawer open state. Controlled — provide
+     * `onNavOpenChange` to update. When `undefined`, the mobile drawer
+     * is always closed (consumer hasn't wired up the toggle yet).
+     */
+    navOpen?: boolean;
+    onNavOpenChange?: (open: boolean) => void;
+    /** Root className shortcut. */
+    sx?: string;
+    /** Per-slot className overrides. */
+    slotProps?: AppShellSlotProps;
+}
+//# sourceMappingURL=appShell.types.d.ts.map

package/dist/components/AppShell/appShell.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appShell.types.d.ts","sourceRoot":"","sources":["../../../src/components/AppShell/appShell.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,GAAG,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7B,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1C,+BAA+B;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B"}

package/dist/components/AppShell/appShell.variants.d.ts

@@ -0,0 +1,65 @@
+import { type VariantProps } from 'tailwind-variants';
+/**
+ * Tailwind-variants recipe for `<AppShell>`.
+ *
+ * Slots:
+ *   - `root`      — outer flex column (full viewport)
+ *   - `header`    — top region
+ *   - `body`      — flex row holding nav + main
+ *   - `nav`       — desktop nav rail (md+)
+ *   - `navMobile` — mobile drawer (slide-in)
+ *   - `main`      — scrollable content area
+ *   - `footer`    — bottom region
+ *   - `backdrop`  — semi-opaque overlay behind the mobile drawer
+ */
+export declare const appShellVariants: import("tailwind-variants").TVReturnType<{
+    navOpen: {
+        true: {
+            navMobile: string;
+            backdrop: string;
+        };
+    };
+}, {
+    root: string;
+    header: string;
+    body: string;
+    nav: string;
+    navMobile: string[];
+    main: string;
+    footer: string;
+    backdrop: string[];
+}, undefined, {
+    navOpen: {
+        true: {
+            navMobile: string;
+            backdrop: string;
+        };
+    };
+}, {
+    root: string;
+    header: string;
+    body: string;
+    nav: string;
+    navMobile: string[];
+    main: string;
+    footer: string;
+    backdrop: string[];
+}, import("tailwind-variants").TVReturnType<{
+    navOpen: {
+        true: {
+            navMobile: string;
+            backdrop: string;
+        };
+    };
+}, {
+    root: string;
+    header: string;
+    body: string;
+    nav: string;
+    navMobile: string[];
+    main: string;
+    footer: string;
+    backdrop: string[];
+}, undefined, unknown, unknown, undefined>>;
+export type AppShellVariants = VariantProps<typeof appShellVariants>;
+//# sourceMappingURL=appShell.variants.d.ts.map

package/dist/components/AppShell/appShell.variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appShell.variants.d.ts","sourceRoot":"","sources":["../../../src/components/AppShell/appShell.variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CA8B3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/components/Autocomplete/Autocomplete.d.ts

@@ -0,0 +1,32 @@
+import type { AutocompleteOption, AutocompleteProps } from './autocomplete.types.js';
+/**
+ * Dashforge TW Autocomplete — bridge-integrated single-select combobox.
+ *
+ * **Implementation note (F5-A, rev. 2)**
+ *
+ * The first revision wrapped `react-aria-components`' `<ComboBox>` to get
+ * AAA-grade a11y for free. In practice React Aria's internal state
+ * machine fought every controlled-state pattern we tried (the input text
+ * would not clear when `selectedKey` went to `null`, even with a forced
+ * remount via `key` bumping). To get deterministic behaviour we own all
+ * of the state ourselves:
+ *
+ *   - `inputValue`       — the visible text in the `<input>`
+ *   - `isOpen`           — popover visibility
+ *   - `highlightedIndex` — keyboard navigation cursor
+ *
+ * A11y is still solid:
+ *   - `role="combobox"` + `aria-autocomplete="list"` on the input
+ *   - `aria-expanded`, `aria-controls`, `aria-activedescendant`
+ *   - `role="listbox"` / `role="option"` with `aria-selected`
+ *   - Full keyboard nav (↑/↓ navigate, Enter selects, Escape closes,
+ *     Home/End jump, Tab closes, click-outside closes)
+ *   - Required field gets `aria-required="true"`
+ *
+ * F5-A scope: single-select, static options, contains-substring filter
+ * (case-insensitive). Multi-select, free-solo text, generic option
+ * shapes, and async runtime options (`optionsFromFieldData`) are
+ * deferred to F5-A-bis.
+ */
+export declare function Autocomplete<TOption = AutocompleteOption>(props: AutocompleteProps<TOption>): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=Autocomplete.d.ts.map

package/dist/components/Autocomplete/Autocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Autocomplete.d.ts","sourceRoot":"","sources":["../../../src/components/Autocomplete/Autocomplete.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EAElB,MAAM,yBAAyB,CAAC;AAuCjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAG,kBAAkB,EACvD,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,kDAu4BlC"}