@dashforge/tw 1.0.0 → 1.1.0

package/src/components/_shared/severity/severityVariants.ts

@@ -0,0 +1,115 @@
+import type { Severity, SeverityClasses, SeverityVariant } from './severity.types.js';
+
+/**
+ * The 3×4 severity color matrix.
+ *
+ * Every class is a Tailwind utility that resolves through
+ * `dashforgePreset()` to a CSS variable on the host — patchable at
+ * runtime via `patchTheme({ <severity>: { …scale } })` without
+ * recompiling. **Zero hardcoded hex values, zero `dark:` variants**:
+ * the dashforge preset auto-inverts the neutral surface ladder via CSS
+ * variable swap; the severity scales themselves do NOT auto-invert
+ * (they read the same scale in light + dark, which is the desired
+ * behaviour for semantic colors).
+ *
+ * The matrix is indexed `[variant][severity]` so a consumer-facing
+ * `<Alert variant="filled" severity="warning">` resolves with a single
+ * lookup.
+ */
+const SEVERITY_MATRIX: Record<SeverityVariant, Record<Severity, SeverityClasses>> = {
+  standard: {
+    info: {
+      surface: 'bg-info-50 text-info-900',
+      border: 'border-info-100',
+      icon: 'text-info-600',
+    },
+    success: {
+      surface: 'bg-success-50 text-success-900',
+      border: 'border-success-100',
+      icon: 'text-success-600',
+    },
+    warning: {
+      surface: 'bg-warning-50 text-warning-900',
+      border: 'border-warning-100',
+      icon: 'text-warning-600',
+    },
+    danger: {
+      surface: 'bg-danger-50 text-danger-900',
+      border: 'border-danger-100',
+      icon: 'text-danger-600',
+    },
+  },
+  filled: {
+    info: {
+      surface: 'bg-info-600 text-info-50',
+      border: 'border-info-700',
+      icon: 'text-info-50',
+    },
+    success: {
+      surface: 'bg-success-600 text-success-50',
+      border: 'border-success-700',
+      icon: 'text-success-50',
+    },
+    warning: {
+      surface: 'bg-warning-600 text-warning-50',
+      border: 'border-warning-700',
+      icon: 'text-warning-50',
+    },
+    danger: {
+      surface: 'bg-danger-600 text-danger-50',
+      border: 'border-danger-700',
+      icon: 'text-danger-50',
+    },
+  },
+  outlined: {
+    info: {
+      surface: 'bg-transparent text-info-700',
+      border: 'border-info-300',
+      icon: 'text-info-600',
+    },
+    success: {
+      surface: 'bg-transparent text-success-700',
+      border: 'border-success-300',
+      icon: 'text-success-600',
+    },
+    warning: {
+      surface: 'bg-transparent text-warning-700',
+      border: 'border-warning-300',
+      icon: 'text-warning-600',
+    },
+    danger: {
+      surface: 'bg-transparent text-danger-700',
+      border: 'border-danger-300',
+      icon: 'text-danger-600',
+    },
+  },
+};
+
+/**
+ * Resolve the Tailwind classes for one (variant, severity) pair.
+ *
+ * @example
+ * const { surface, border, icon } = getSeverityClasses('standard', 'warning');
+ * // surface: 'bg-warning-50 text-warning-900'
+ * // border:  'border-warning-100'
+ * // icon:    'text-warning-600'
+ */
+export function getSeverityClasses(
+  variant: SeverityVariant,
+  severity: Severity
+): SeverityClasses {
+  return SEVERITY_MATRIX[variant][severity];
+}
+
+/**
+ * ARIA role for a severity. Follows the W3C WAI-ARIA spec:
+ * - `alert` for assertive states (warning / danger) — interrupts the
+ *   screen-reader announcement queue.
+ * - `status` for polite states (info / success) — queued behind other
+ *   announcements.
+ *
+ * Consumers can override via an explicit `role` prop.
+ */
+export function getSeverityRole(severity: Severity): 'alert' | 'status' {
+  return severity === 'warning' || severity === 'danger' ? 'alert' : 'status';
+}

package/src/index.ts

@@ -201,11 +201,173 @@ export type {
   SnackbarOptions,
   SnackbarRecord,
   SnackbarSeverity,
+  SnackbarVariant,
   SnackbarPosition,
   SnackbarSlotProps,
 } from './components/Snackbar/snackbar.types.js';
 export { snackbarVariants } from './components/Snackbar/snackbar.variants.js';
 
+// Alert — inline persistent status surface (companion to Snackbar's
+// transient toast). Full MUI Alert API parity (`severity`, `variant`,
+// `icon`, `onClose`, `action`, `role`, `<AlertTitle>` sub-component);
+// `severity="danger"` (not MUI `"error"`) for token-palette alignment.
+// Shares the 3×4 color matrix in `_shared/severity/` with the
+// refactored Snackbar (Sprint 4.4).
+export { Alert, AlertTitle } from './components/Alert/Alert.js';
+export type {
+  AlertProps,
+  AlertTitleProps,
+  AlertSlotProps,
+} from './components/Alert/alert.types.js';
+export { alertVariants } from './components/Alert/alert.variants.js';
+
+// IconButton — square, icon-only variant of <Button>. Reuses
+// `buttonVariants` 1:1 (variant × color × size × loading); adds square
+// geometry (w-N + px-0 + aspect-square) and a TS-enforced `aria-label`.
+// access RBAC integration mirrors <Button>; no `visibleWhen` /
+// `slotProps` by design (icon-only buttons are single-DOM-element
+// action triggers, not content surfaces).
+export { IconButton } from './components/IconButton/IconButton.js';
+export type { IconButtonProps } from './components/IconButton/iconButton.types.js';
+export {
+  ICON_BUTTON_BASE,
+  ICON_BUTTON_SIZE_OVERRIDES,
+} from './components/IconButton/iconButton.variants.js';
+
+// Menu family — compound action menu built on
+// `@radix-ui/react-dropdown-menu` (purpose-built menu primitive
+// with full WAI-ARIA menu pattern + keyboard nav + type-ahead +
+// lazy portal mount). Atlaskit-inspired: item-level memo, lazy
+// portal mount, MenuSkeleton for fetch-while-open patterns.
+//   • <Menu>           — root provider (open state, closeOnItemClick)
+//   • <MenuTrigger>    — asChild trigger wrapper
+//   • <MenuContent>    — floating panel (portal, lazy mount)
+//   • <MenuItem>       — clickable row (memoized, access + visibleWhen)
+//   • <MenuLabel>      — non-interactive section heading
+//   • <MenuSeparator>  — divider
+//   • <MenuSkeleton>   — Atlaskit-style loading placeholder
+// Sub-menus + controlled selection mode are out of scope for v1.
+export {
+  Menu,
+  MenuTrigger,
+  MenuContent,
+  MenuItem,
+  MenuLabel,
+  MenuSeparator,
+  MenuSkeleton,
+} from './components/Menu/Menu.js';
+export type {
+  MenuProps,
+  MenuTriggerProps,
+  MenuContentProps,
+  MenuItemProps,
+  MenuLabelProps,
+  MenuSeparatorProps,
+  MenuSkeletonProps,
+  MenuPlacement,
+  MenuItemColor,
+} from './components/Menu/menu.types.js';
+export { menuVariants } from './components/Menu/menu.variants.js';
+
+// Badge — anchored indicator (count / dot / short text overlay).
+// Wrapper-only mode: <Badge>{anchor}</Badge>. For standalone inline
+// pills (status labels, removable tags), use <Chip> — Badge and Chip
+// are complementary. content + max overflow ("99+"), showZero gate,
+// dot mode, invisible toggle. placement 4 corners + overlap
+// rectangular/circular for round anchors (Avatar). withRing default
+// for visual separation. access + visibleWhen — gate the badge
+// (anchor always renders).
+export { Badge } from './components/Badge/Badge.js';
+export type {
+  BadgeProps,
+  BadgeColor,
+  BadgePlacement,
+  BadgeOverlap,
+  BadgeSlotProps,
+} from './components/Badge/badge.types.js';
+export { badgeVariants } from './components/Badge/badge.variants.js';
+export type { BadgeVariants } from './components/Badge/badge.variants.js';
+
+// Spinner — rotating-arc loading indicator. SVG + animate-spin
+// (pure CSS, GPU-accelerated, motion-reduce-safe). Color via
+// currentColor by default (inherits parent text color — works inside
+// any container), or explicit 7-intent color. Optional `withTrack`
+// renders a ghost ring behind the arc (Stripe / Vercel / Linear
+// premium look). `delay` prop suppresses the spinner for the first
+// N ms (Atlassian-style anti-flash for sub-N-ms operations).
+// visibleWhen bridge integration; no access (display only). Refactor:
+// Button + IconButton internal loading state now reuse this Spinner
+// (single source of truth).
+export { Spinner } from './components/Spinner/Spinner.js';
+export type {
+  SpinnerProps,
+  SpinnerSize,
+  SpinnerColor,
+  SpinnerThickness,
+} from './components/Spinner/spinner.types.js';
+export {
+  spinnerVariants,
+  SPINNER_STROKE_WIDTH,
+  SPINNER_TRACK_OPACITY,
+  SPINNER_COLORS,
+} from './components/Spinner/spinner.variants.js';
+
+// Avatar — image / initials / icon visual identity.
+//   • <Avatar>       — single avatar, src + auto-initials from name
+//                      (Mantine-style), shape + radius (Box token
+//                      scale), size enum xs/sm/md/lg/xl, color × tone
+//                      (TS-safe palette access), fallbackIcon escape.
+//   • <AvatarGroup>  — thin horizontal wrapper with negative-margin
+//                      overlap, max + overflow indicator, optional
+//                      ring halo. Size propagates to children.
+// No access / visibleWhen — Avatar is display-only by category.
+// Wrap in <Box> if visibility gating is needed.
+export { Avatar, AvatarGroup } from './components/Avatar/Avatar.js';
+export type {
+  AvatarProps,
+  AvatarGroupProps,
+  AvatarSize,
+  AvatarShape,
+  AvatarColor,
+  AvatarTone,
+} from './components/Avatar/avatar.types.js';
+export {
+  avatarVariants,
+  AVATAR_SOFT_FALLBACK,
+  AVATAR_TONE_FALLBACK,
+} from './components/Avatar/avatar.variants.js';
+
+// Card family — opinionated surface preset over <Box>.
+//   • <Card>           — thin Box alias with card-shaped defaults
+//                        (variant=outlined, rounded=lg, elevation=1,
+//                        no padding). Inherits access + visibleWhen
+//                        from Box (Sprint 4.4 surface alignment).
+//   • <CardContent>    — padded inner section (semantic alias for
+//                        Box with default p=4).
+//   • <CardActionArea> — clickable wrapper with focus ring + hover +
+//                        asChild polymorphism (router Link patterns).
+//                        Carries access + visibleWhen + selected
+//                        (for option-card / filter-card toggle).
+export { Card, CardContent, CardActionArea } from './components/Card/Card.js';
+export type {
+  CardProps,
+  CardContentProps,
+  CardActionAreaProps,
+} from './components/Card/card.types.js';
+
+// Chip — status / filter / tag pill. Promoted from the internal
+// `Table/cells/RenderChip` (Sprint 4.4): the 3 × 7 (variant × color)
+// matrix is now the single source of truth, consumed by both the
+// public <Chip> and (via thin wrapper) the legacy RenderChip.
+// Variant axis: `soft | solid | outline` (Dashforge chip vocabulary —
+// distinct from Button's and Alert's by design, see CHANGELOG).
+// access RBAC integration; selected for filter-pill patterns;
+// onDelete for removable tags.
+export { Chip } from './components/Chip/Chip.js';
+export type { ChipProps } from './components/Chip/chip.types.js';
+export { chipVariants } from './components/Chip/chip.variants.js';
+export type { ChipVariants } from './components/Chip/chip.variants.js';
+
 // F9 foundation: typography + layout primitives. These sit BENEATH
 // every other component (Button's label, TextField's helper text, the
 // surface of an AppShell card) and are what app-level code reaches for
@@ -385,4 +547,4 @@ export type { VariantProps } from 'tailwind-variants';
 /**
  * Package version (synced with `package.json` at publish time).
  */
-export const VERSION = '0.11.0-beta';
+export const VERSION = '1.1.0';

package/LICENSE

@@ -1,21 +0,0 @@
-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/dist/components/Accordion/Accordion.d.ts

@@ -1,21 +0,0 @@
-import type { AccordionProps } from './accordion.types.js';
-/**
- * Dashforge TW `<Accordion>` — collapsible section list.
- *
- * Built on `@radix-ui/react-accordion`:
- *  - APG accordion pattern: `role="region"` on content, header
- *    button with `aria-expanded` and `aria-controls` linked to
- *    the panel.
- *  - Keyboard support: Space / Enter toggle, ArrowDown / ArrowUp
- *    move focus between triggers, Home / End to extremes.
- *  - Two modes:
- *    - `type="single"` — at most one section open at a time;
- *      `collapsible` allows clicking the open section to close it
- *      (default true).
- *    - `type="multiple"` — multiple sections open simultaneously.
- *
- * The trigger renders a chevron that flips 180° via CSS
- * (`data-state=open` selector) — no React state, no JS animation.
- */
-export declare function Accordion(props: AccordionProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=Accordion.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Accordion.d.ts","sourceRoot":"","sources":["../../../src/components/Accordion/Accordion.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,2CAqE9C"}

package/dist/components/Accordion/accordion.types.d.ts

@@ -1,74 +0,0 @@
-import type { ReactNode } from 'react';
-export interface AccordionSlotProps {
-    root?: {
-        className?: string;
-    };
-    item?: {
-        className?: string;
-    };
-    header?: {
-        className?: string;
-    };
-    trigger?: {
-        className?: string;
-    };
-    content?: {
-        className?: string;
-    };
-    chevron?: {
-        className?: string;
-    };
-}
-/**
- * Single accordion section — paired `{ value, header, content }`.
- * The `value` is the canonical id (used in `value` / `defaultValue`
- * to control which sections are expanded).
- */
-export interface AccordionItem {
-    value: string;
-    /** Trigger label (clickable to expand / collapse). */
-    header: ReactNode;
-    /** Section body, revealed when this item is expanded. */
-    content: ReactNode;
-    /** Per-item disabled flag. */
-    disabled?: boolean;
-}
-interface AccordionBaseProps {
-    items: AccordionItem[];
-    /** Root className shortcut. */
-    sx?: string;
-    /** Per-slot overrides. */
-    slotProps?: AccordionSlotProps;
-}
-/**
- * Single-mode props — at most one section open at a time.
- * `collapsible: true` (default) lets the user close the open
- * section by clicking it again.
- */
-export interface AccordionSingleProps extends AccordionBaseProps {
-    type?: 'single';
-    value?: string;
-    defaultValue?: string;
-    onValueChange?: (value: string) => void;
-    /** @default true */
-    collapsible?: boolean;
-}
-/**
- * Multiple-mode props — any number of sections open simultaneously.
- */
-export interface AccordionMultipleProps extends AccordionBaseProps {
-    type: 'multiple';
-    value?: string[];
-    defaultValue?: string[];
-    onValueChange?: (value: string[]) => void;
-}
-/**
- * Props for `<Accordion>`.
- *
- * Built on `@radix-ui/react-accordion`. Discriminated by `type`:
- *  - `type="single"` (default) — `value` is `string`.
- *  - `type="multiple"` — `value` is `string[]`.
- */
-export type AccordionProps = AccordionSingleProps | AccordionMultipleProps;
-export {};
-//# sourceMappingURL=accordion.types.d.ts.map

package/dist/components/Accordion/accordion.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"accordion.types.d.ts","sourceRoot":"","sources":["../../../src/components/Accordion/accordion.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,MAAM,EAAE,SAAS,CAAC;IAClB,yDAAyD;IACzD,OAAO,EAAE,SAAS,CAAC;IACnB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,+BAA+B;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,oBAAoB;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB;IAChE,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG,sBAAsB,CAAC"}

package/dist/components/Accordion/accordion.variants.d.ts

@@ -1,58 +0,0 @@
-import { type VariantProps } from 'tailwind-variants';
-export declare const accordionVariants: import("tailwind-variants").TVReturnType<{
-    [key: string]: {
-        [key: string]: import("tailwind-merge").ClassNameValue | {
-            content?: import("tailwind-merge").ClassNameValue;
-            root?: import("tailwind-merge").ClassNameValue;
-            header?: import("tailwind-merge").ClassNameValue;
-            trigger?: import("tailwind-merge").ClassNameValue;
-            item?: import("tailwind-merge").ClassNameValue;
-            chevron?: import("tailwind-merge").ClassNameValue;
-        };
-    };
-} | {
-    [x: string]: {
-        [x: string]: import("tailwind-merge").ClassNameValue | {
-            content?: import("tailwind-merge").ClassNameValue;
-            root?: import("tailwind-merge").ClassNameValue;
-            header?: import("tailwind-merge").ClassNameValue;
-            trigger?: import("tailwind-merge").ClassNameValue;
-            item?: import("tailwind-merge").ClassNameValue;
-            chevron?: import("tailwind-merge").ClassNameValue;
-        };
-    };
-} | {}, {
-    root: string;
-    item: string;
-    header: string;
-    trigger: string[];
-    content: string[];
-    chevron: string[];
-}, undefined, {
-    [key: string]: {
-        [key: string]: import("tailwind-merge").ClassNameValue | {
-            content?: import("tailwind-merge").ClassNameValue;
-            root?: import("tailwind-merge").ClassNameValue;
-            header?: import("tailwind-merge").ClassNameValue;
-            trigger?: import("tailwind-merge").ClassNameValue;
-            item?: import("tailwind-merge").ClassNameValue;
-            chevron?: import("tailwind-merge").ClassNameValue;
-        };
-    };
-} | {}, {
-    root: string;
-    item: string;
-    header: string;
-    trigger: string[];
-    content: string[];
-    chevron: string[];
-}, import("tailwind-variants").TVReturnType<unknown, {
-    root: string;
-    item: string;
-    header: string;
-    trigger: string[];
-    content: string[];
-    chevron: string[];
-}, undefined, unknown, unknown, undefined>>;
-export type AccordionVariants = VariantProps<typeof accordionVariants>;
-//# sourceMappingURL=accordion.variants.d.ts.map

package/dist/components/Accordion/accordion.variants.d.ts.map

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

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

@@ -1,46 +0,0 @@
-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).
- *   - **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 declare function AppShell(props: AppShellProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=AppShell.d.ts.map

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

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

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

@@ -1,62 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,65 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAoC3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,gBAAgB,CAAC,CAAC"}