@snksergio/design-system 0.40.0 → 0.41.0

package/dist-lib/shadcn.mjs

@@ -1,9 +1,9 @@
-import { A, a, b, c, d, e, f, B, g, h, i, j, k, l, m, C, n, o, p, q, r, s, t, u, v, w, x, y, z, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z, _, $, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, aa, ab, ac, ad, ae, af, ag, ah, ai, aj, ak, al, am, an, ao, ap, aq, ar, as, at, au, av, aw, ax, ay, az, aA, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK, aL, aM, aN, aO, aP, aQ, aR } from "./chunks/tooltip-mMF4YHZg.mjs";
-import { A as A2, a as a10, b as b2, c as c2, d as d2, e as e2, f as f2, g as g2, h as h2, i as i2, j as j2, C as C2, k as k2, l as l2, P as P2, m as m2, n as n2, o as o2, p as p2, q as q2, r as r2, s as s2, t as t2, S as S2, u as u2, v as v2, w as w2, x as x2, y as y2, z as z2, B as B2, D as D2, E as E2, F as F2, G as G2, H as H2, I as I2, J as J2, K as K2, L as L2, M as M2, N as N2, O as O2, Q as Q2, T as T2, R as R2, U as U2, V as V2, W as W2 } from "./chunks/textarea-DivoQmJw.mjs";
+import { A, a, b, c, d, e, f, B, g, h, i, j, k, l, m, C, n, o, p, q, r, s, t, u, v, w, x, y, z, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z, _, $, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, aa, ab, ac, ad, ae, af, ag, ah, ai, aj, ak, al, am, an, ao, ap, aq, ar, as, at, au, av, aw, ax, ay, az, aA, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK } from "./chunks/toggle-group-XMO6ReVo.mjs";
+import { A as A2, a as a10, b as b2, c as c2, d as d2, e as e2, f as f2, g as g2, h as h2, i as i2, j as j2, C as C2, k as k2, l as l2, P as P2, m as m2, n as n2, o as o2, p as p2, q as q2, r as r2, s as s2, t as t2, S as S2, u as u2, v as v2, w as w2, x as x2, y as y2, z as z2, B as B2, D as D2, E as E2, F as F2, G as G2, H as H2, I as I2, J as J2, K as K2, L as L2, M as M2, N as N2, O as O2, Q as Q2, T as T2, R as R2, U as U2, V as V2, W as W2 } from "./chunks/textarea-BPRIHZVd.mjs";
 import * as AspectRatioPrimitive from "@radix-ui/react-aspect-ratio";
-import { c as cn } from "./chunks/avatar-DQYiVRlE.mjs";
-import { A as A3, a as a11, b as b3, C as C3, d as d3, e as e3, f as f3, g as g3, h as h3, i as i3, j as j3, k as k3, D as D3, l as l3, m as m3, n as n3, o as o3, p as p3, q as q3, r as r3, s as s3, u as u3, v as v3, w as w3, x as x3, y as y3, z as z3, E as E3, F as F3, G as G3, H as H3, I as I3, J as J3, K as K3, L as L3, M as M3, N as N3, O as O3, P as P3, Q as Q3, R as R3, S as S3, T as T3, U as U3, V as V3, W as W3, X as X2, Y as Y2, Z as Z2, _ as _2, $ as $2, a0 as a02, a1 as a12 } from "./chunks/avatar-DQYiVRlE.mjs";
-import { I as I4, i as i4 } from "./chunks/input-CaC0B-_v.mjs";
+import { c as cn } from "./chunks/avatar-DFWEwBKu.mjs";
+import { A as A3, a as a11, b as b3, C as C3, d as d3, e as e3, f as f3, g as g3, h as h3, i as i3, j as j3, k as k3, l as l3, m as m3, n as n3, D as D3, o as o3, p as p3, q as q3, r as r3, s as s3, u as u3, v as v3, w as w3, x as x3, y as y3, z as z3, E as E3, F as F3, G as G3, H as H3, I as I3, J as J3, K as K3, L as L3, M as M3, N as N3, O as O3, P as P3, Q as Q3, R as R3, S as S3, T as T3, U as U3, V as V3, W as W3, X as X2, Y as Y2, Z as Z2, _ as _2, $ as $2, a0 as a02, a1 as a12, a2 as a22, a3 as a32, a4 as a42, a5 as a52, a6 as a62, a7 as a72, a8 as a82 } from "./chunks/avatar-DFWEwBKu.mjs";
+import { I as I4, i as i4 } from "./chunks/input-CfmzMYtd.mjs";
 import { jsx } from "react/jsx-runtime";
 import * as React from "react";
 import { LoaderCircle, OctagonX, TriangleAlert, Info, CircleCheck } from "lucide-react";
@@ -102,107 +102,107 @@ export {
   v as CarouselNext,
   w as CarouselPrevious,
   l2 as Checkbox,
-  x as Collapsible,
-  y as CollapsibleContent,
-  z as CollapsibleTrigger,
-  C3 as Command,
-  d3 as CommandDialog,
-  e3 as CommandEmpty,
-  f3 as CommandGroup,
-  g3 as CommandInput,
-  h3 as CommandItem,
-  i3 as CommandList,
-  j3 as CommandSeparator,
-  k3 as CommandShortcut,
-  D as ContextMenu,
-  E as ContextMenuCheckboxItem,
-  F as ContextMenuContent,
-  G as ContextMenuGroup,
-  H as ContextMenuItem,
-  I as ContextMenuLabel,
-  J as ContextMenuPortal,
-  K as ContextMenuRadioGroup,
-  L as ContextMenuRadioItem,
-  M as ContextMenuSeparator,
-  N as ContextMenuShortcut,
-  O as ContextMenuSub,
-  P as ContextMenuSubContent,
-  Q as ContextMenuSubTrigger,
-  R as ContextMenuTrigger,
+  C3 as Collapsible,
+  d3 as CollapsibleContent,
+  e3 as CollapsibleTrigger,
+  f3 as Command,
+  g3 as CommandDialog,
+  h3 as CommandEmpty,
+  i3 as CommandGroup,
+  j3 as CommandInput,
+  k3 as CommandItem,
+  l3 as CommandList,
+  m3 as CommandSeparator,
+  n3 as CommandShortcut,
+  x as ContextMenu,
+  y as ContextMenuCheckboxItem,
+  z as ContextMenuContent,
+  D as ContextMenuGroup,
+  E as ContextMenuItem,
+  F as ContextMenuLabel,
+  G as ContextMenuPortal,
+  H as ContextMenuRadioGroup,
+  I as ContextMenuRadioItem,
+  J as ContextMenuSeparator,
+  K as ContextMenuShortcut,
+  L as ContextMenuSub,
+  M as ContextMenuSubContent,
+  N as ContextMenuSubTrigger,
+  O as ContextMenuTrigger,
   D3 as Dialog,
-  l3 as DialogClose,
-  m3 as DialogContent,
-  n3 as DialogDescription,
-  o3 as DialogFooter,
-  p3 as DialogHeader,
-  q3 as DialogOverlay,
-  r3 as DialogPortal,
-  s3 as DialogTitle,
-  u3 as DialogTrigger,
-  S as Drawer,
-  T as DrawerClose,
-  U as DrawerContent,
-  V as DrawerDescription,
-  W as DrawerFooter,
-  X as DrawerHeader,
-  Y as DrawerOverlay,
-  Z as DrawerPortal,
-  _ as DrawerTitle,
-  $ as DrawerTrigger,
-  v3 as DropdownMenu,
-  w3 as DropdownMenuCheckboxItem,
-  x3 as DropdownMenuContent,
-  y3 as DropdownMenuGroup,
-  z3 as DropdownMenuItem,
-  E3 as DropdownMenuLabel,
-  F3 as DropdownMenuPortal,
-  G3 as DropdownMenuRadioGroup,
-  H3 as DropdownMenuRadioItem,
-  I3 as DropdownMenuSeparator,
-  J3 as DropdownMenuShortcut,
-  K3 as DropdownMenuSub,
-  L3 as DropdownMenuSubContent,
-  M3 as DropdownMenuSubTrigger,
-  N3 as DropdownMenuTrigger,
-  a0 as HoverCard,
-  a1 as HoverCardContent,
-  a2 as HoverCardTrigger,
+  o3 as DialogClose,
+  p3 as DialogContent,
+  q3 as DialogDescription,
+  r3 as DialogFooter,
+  s3 as DialogHeader,
+  u3 as DialogOverlay,
+  v3 as DialogPortal,
+  w3 as DialogTitle,
+  x3 as DialogTrigger,
+  P as Drawer,
+  Q as DrawerClose,
+  R as DrawerContent,
+  S as DrawerDescription,
+  T as DrawerFooter,
+  U as DrawerHeader,
+  V as DrawerOverlay,
+  W as DrawerPortal,
+  X as DrawerTitle,
+  Y as DrawerTrigger,
+  y3 as DropdownMenu,
+  z3 as DropdownMenuCheckboxItem,
+  E3 as DropdownMenuContent,
+  F3 as DropdownMenuGroup,
+  G3 as DropdownMenuItem,
+  H3 as DropdownMenuLabel,
+  I3 as DropdownMenuPortal,
+  J3 as DropdownMenuRadioGroup,
+  K3 as DropdownMenuRadioItem,
+  L3 as DropdownMenuSeparator,
+  M3 as DropdownMenuShortcut,
+  N3 as DropdownMenuSub,
+  O3 as DropdownMenuSubContent,
+  P3 as DropdownMenuSubTrigger,
+  Q3 as DropdownMenuTrigger,
+  Z as HoverCard,
+  _ as HoverCardContent,
+  $ as HoverCardTrigger,
   I4 as Input,
-  O3 as InputGroup,
-  P3 as InputGroupAddon,
-  Q3 as InputGroupButton,
-  R3 as InputGroupInput,
-  S3 as InputGroupText,
-  T3 as InputGroupTextarea,
-  a3 as InputOTP,
-  a4 as InputOTPGroup,
-  a5 as InputOTPSeparator,
-  a6 as InputOTPSlot,
-  a7 as Label,
-  a8 as Menubar,
-  a9 as MenubarCheckboxItem,
-  aa as MenubarContent,
-  ab as MenubarGroup,
-  ac as MenubarItem,
-  ad as MenubarLabel,
-  ae as MenubarMenu,
-  af as MenubarPortal,
-  ag as MenubarRadioGroup,
-  ah as MenubarRadioItem,
-  ai as MenubarSeparator,
-  aj as MenubarShortcut,
-  ak as MenubarSub,
-  al as MenubarSubContent,
-  am as MenubarSubTrigger,
-  an as MenubarTrigger,
-  ao as NavigationMenu,
-  ap as NavigationMenuContent,
-  aq as NavigationMenuIndicator,
-  ar as NavigationMenuItem,
-  as as NavigationMenuLink,
-  at as NavigationMenuList,
-  au as NavigationMenuTrigger,
-  av as NavigationMenuViewport,
+  R3 as InputGroup,
+  S3 as InputGroupAddon,
+  T3 as InputGroupButton,
+  U3 as InputGroupInput,
+  V3 as InputGroupText,
+  W3 as InputGroupTextarea,
+  a0 as InputOTP,
+  a1 as InputOTPGroup,
+  a2 as InputOTPSeparator,
+  a3 as InputOTPSlot,
+  a4 as Label,
+  a5 as Menubar,
+  a6 as MenubarCheckboxItem,
+  a7 as MenubarContent,
+  a8 as MenubarGroup,
+  a9 as MenubarItem,
+  aa as MenubarLabel,
+  ab as MenubarMenu,
+  ac as MenubarPortal,
+  ad as MenubarRadioGroup,
+  ae as MenubarRadioItem,
+  af as MenubarSeparator,
+  ag as MenubarShortcut,
+  ah as MenubarSub,
+  ai as MenubarSubContent,
+  aj as MenubarSubTrigger,
+  ak as MenubarTrigger,
+  al as NavigationMenu,
+  am as NavigationMenuContent,
+  an as NavigationMenuIndicator,
+  ao as NavigationMenuItem,
+  ap as NavigationMenuLink,
+  aq as NavigationMenuList,
+  ar as NavigationMenuTrigger,
+  as as NavigationMenuViewport,
   P2 as Pagination,
   m2 as PaginationContent,
   n2 as PaginationEllipsis,
@@ -212,16 +212,16 @@ export {
   r2 as PaginationLink,
   s2 as PaginationNext,
   t2 as PaginationPrevious,
-  U3 as Popover,
-  V3 as PopoverAnchor,
-  W3 as PopoverClose,
-  X2 as PopoverContent,
-  Y2 as PopoverTrigger,
-  aw as Progress,
-  ax as RadioGroup,
-  ay as RadioGroupItem,
-  az as ScrollArea,
-  aA as ScrollBar,
+  X2 as Popover,
+  Y2 as PopoverAnchor,
+  Z2 as PopoverClose,
+  _2 as PopoverContent,
+  $2 as PopoverTrigger,
+  at as Progress,
+  au as RadioGroup,
+  av as RadioGroupItem,
+  aw as ScrollArea,
+  ax as ScrollBar,
   S2 as Select,
   u2 as SelectContent,
   v2 as SelectGroup,
@@ -232,7 +232,7 @@ export {
   B2 as SelectSeparator,
   D2 as SelectTrigger,
   E2 as SelectValue,
-  aB as Separator,
+  ay as Separator,
   F2 as Sheet,
   G2 as SheetClose,
   H2 as SheetContent,
@@ -244,34 +244,34 @@ export {
   N2 as SheetTitle,
   O2 as SheetTrigger,
   Skeleton,
-  aC as Slider,
+  az as Slider,
   Q2 as Switch,
-  aD as Tabs,
-  aE as TabsContent,
-  aF as TabsList,
-  aG as TabsTrigger,
+  aA as Tabs,
+  aB as TabsContent,
+  aC as TabsList,
+  aD as TabsTrigger,
   T2 as Textarea,
   Toaster,
-  aH as Toggle,
-  aI as ToggleGroup,
-  aJ as ToggleGroupItem,
-  aK as Tooltip,
-  aL as TooltipContent,
-  aM as TooltipProvider,
-  aN as TooltipTrigger,
-  aO as badgeVariants,
+  aE as Toggle,
+  aF as ToggleGroup,
+  aG as ToggleGroupItem,
+  a02 as Tooltip,
+  a12 as TooltipContent,
+  a22 as TooltipProvider,
+  a32 as TooltipTrigger,
+  aH as badgeVariants,
   R2 as getPaginationRange,
-  Z2 as inputGroupAddonVariants,
-  _2 as inputGroupButtonVariants,
-  $2 as inputGroupInputVariants,
-  a02 as inputGroupTextareaVariants,
-  a12 as inputGroupVariants,
+  a42 as inputGroupAddonVariants,
+  a52 as inputGroupButtonVariants,
+  a62 as inputGroupInputVariants,
+  a72 as inputGroupTextareaVariants,
+  a82 as inputGroupVariants,
   i4 as inputVariants,
-  aP as navigationMenuTriggerStyle,
+  aI as navigationMenuTriggerStyle,
   U2 as paginationLinkVariants,
   V2 as paginationNavVariants,
-  aQ as slotVariants,
+  aJ as slotVariants,
   W2 as textareaVariants,
-  aR as toggleVariants
+  aK as toggleVariants
 };
 //# sourceMappingURL=shadcn.mjs.map

package/dist-lib/src/components/ui/AppShell/app-shell.d.ts

@@ -20,7 +20,7 @@ import { AppShellProps } from './app-shell.types';
  * Pra uso real: declare um `MOCK_CONTEXTS`, `MOCK_COMMANDS`, etc compartilhados
  * num arquivo da app (ex: `src/config/app-shell-mocks.ts`) e passe nas pages.
  */
-export declare function AppShell({ contexts, defaultActiveContextId, activeContextId, onContextChange, defaultActiveItemHref, activeItemHref, onItemClick, renderLink, brandHref, onBrandClick, breadcrumb, commandGroups, commandPlaceholder, commandEmptyMessage, searchPlaceholder, notifications, messages, theme, onThemeChange, themeOptions, headerRightSlot, user, layout, onLayoutChange, layoutOptions, onSettings, onLogout, menuCollapsed: controlledCollapsed, defaultMenuCollapsed, onMenuCollapseChange, children, bodyClassName, mobileEdgeToEdge, className, }: AppShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function AppShell(props: AppShellProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace AppShell {
     var displayName: string;
 }

package/dist-lib/src/components/ui/AppShell/app-shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/AppShell/app-shell.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,EAEvB,QAAQ,EACR,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,EAEZ,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,QAAQ,EACR,KAAK,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EAEf,IAAI,EACJ,MAAM,EACN,cAAc,EACd,aAAa,EACb,UAAU,EACV,QAAQ,EAER,aAAa,EAAE,mBAAmB,EAClC,oBAAoB,EACpB,oBAAoB,EAEpB,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,SAAS,GACV,EAAE,aAAa,2CAmHf;yBA3Je,QAAQ"}
+{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/AppShell/app-shell.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAyB,MAAM,mBAAmB,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,2CA4Q5C;yBA5Qe,QAAQ"}

package/dist-lib/src/components/ui/AppShell/app-shell.styles.d.ts

@@ -8,7 +8,51 @@
  * (18 / 24 / 32px — ver `bodyInner`) por design — slot "padronizado" pra todas
  * as telas. Consumer customiza só os filhos.
  */
-export declare const root: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+/**
+ * Raiz do shell. A altura é o ponto sensível aqui.
+ *
+ * ## Por que `fillHeight` existe (medido em 2026-08-18)
+ *
+ * `h-screen` é 100vh **sempre**, ignorando a altura do container pai. Consequência
+ * medida na própria página de doc do AppShell, que o renderiza dentro de
+ * `<div class="h-[640px] … overflow-hidden">`:
+ *
+ *   container do exemplo   640px
+ *   <main> do shell        660px  (60 do header + 660 = 720 = 100vh)
+ *   → o shell termina 56px ABAIXO da borda, e o overflow-hidden do wrapper
+ *     corta esse pedaço — levando os 24px de padding-bottom do body junto
+ *
+ * O sintoma que aparece é "o conteúdo está colado na borda de baixo", e a leitura
+ * natural é "falta padding-bottom". **Não falta**: o padding existe e é simétrico
+ * (medido: 24px em cima e 24px embaixo). Ele está sendo *clipado*. Acrescentar mais
+ * padding não consertaria nada — só mudaria o quanto se perde.
+ *
+ * Vale para qualquer consumidor que embuta o shell em algo com altura definida:
+ * um layout com footer próprio, um painel de aba, um card de preview.
+ *
+ *   fillHeight=false (default)  h-screen  — o shell É a página. Comportamento atual,
+ *                                           preservado pra não mexer em quem já usa.
+ *   fillHeight=true             h-full    — o shell obedece o pai. **Exige que o pai
+ *                                           tenha altura**: `h-full` sem pai medido
+ *                                           colapsa pra zero, que é o modo de falhar
+ *                                           deste modo.
+ */
+export declare const root: import('tailwind-variants').TVReturnType<{
+    fillHeight: {
+        false: string;
+        true: string;
+    };
+}, undefined, string[], {
+    fillHeight: {
+        false: string;
+        true: string;
+    };
+}, undefined, import('tailwind-variants').TVReturnType<{
+    fillHeight: {
+        false: string;
+        true: string;
+    };
+}, undefined, string[], unknown, unknown, undefined>>;
 /** Wrapper da área principal (Header + Body). Ocupa o resto do flex row. */
 export declare const main: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
 /**

package/dist-lib/src/components/ui/AppShell/app-shell.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.styles.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/AppShell/app-shell.styles.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,eAAO,MAAM,IAAI,sMAKf,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,IAAI,sMAKf,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,sMAKf,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,SAAS;;;;;IAUlB;;;;;;;OAOG;;;;;;;;;;IAPH;;;;;;;OAOG;;;;;;;;;;IAPH;;;;;;;OAOG;;;;;qDAUL,CAAC"}
+{"version":3,"file":"app-shell.styles.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/AppShell/app-shell.styles.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;qDAYf,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,IAAI,sMAKf,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,sMAKf,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,SAAS;;;;;IAUlB;;;;;;;OAOG;;;;;;;;;;IAPH;;;;;;;OAOG;;;;;;;;;;IAPH;;;;;;;OAOG;;;;;qDAUL,CAAC"}

package/dist-lib/src/components/ui/AppShell/app-shell.types.d.ts

@@ -1,5 +1,6 @@
 import { ReactNode, MouseEvent } from 'react';
 import { LucideIcon } from '../../../lib/lucide-types';
+import { SingleMenuCategory, SingleMenuModuleConfig } from '../SingleMenuSidebar';
 import { HeaderBreadcrumbItem, HeaderCommandGroup, HeaderMessagesConfig, HeaderNotificationsConfig, HeaderThemeOption } from '../Header';
 import { SidebarContext, SidebarMenuItem, SidebarLinkRenderer } from '../MenuSidebar';
 /**
@@ -43,9 +44,7 @@ export type AppShellLayoutOption = {
  * - `theme` idem
  * - `children` é o body — gap 16px + padding 32px aplicados no slot
  */
-export type AppShellProps = {
-    /** Contextos do MenuSidebar (rail + panel data-driven). Obrigatório. */
-    contexts: SidebarContext[];
+type AppShellBaseProps = {
     /** Contexto inicialmente ativo (uncontrolled). Default: primeiro do array. */
     defaultActiveContextId?: string;
     /** Contexto ativo (controlled). */
@@ -135,7 +134,111 @@ export type AppShellProps = {
      * Default: false (18px mobile · 24px notebook · 32px desktop).
      */
     mobileEdgeToEdge?: boolean;
+    /**
+     * Qual menu lateral o shell monta.
+     *
+     *   "menu"   (default) `MenuSidebar` — rail de MÓDULOS + painel. Para apps com áreas
+     *                      distintas (Comercial, Financeiro…), cada uma com menu próprio.
+     *   "single"           `SingleMenuSidebar` — nível único, sem módulos. Para sistema
+     *                      único, com busca opcional.
+     *
+     * Default preservado em `menu` de propósito: não muda nada de quem já usa.
+     *
+     * O shell coordena o colapso e o hamburger do Header nos DOIS casos. O mapeamento é
+     * diferente porque os componentes modelam o estado de formas diferentes:
+     *
+     *   MenuSidebar   desktop → panelCollapsed · mobile → drawer (mobileOpen + backdrop)
+     *   Single        desktop → expanded (invertido) · mobile → expanded É a visibilidade
+     *                 (< md: expandida ocupa 100% da largura; recolhida some)
+     */
+    /**
+     * O shell obedece a altura do CONTAINER PAI em vez de ocupar 100vh.
+     *
+     * Default `false` = comportamento histórico (`h-screen`), preservado.
+     *
+     * Ligue quando o AppShell estiver embutido em algo com altura definida — um layout
+     * com footer próprio, um painel de aba, um preview. Sem isso o shell mede 100vh,
+     * transborda o container e o `overflow-hidden` corta o rodapé do body junto com o
+     * padding — o sintoma é "conteúdo colado na borda", e não é falta de padding.
+     *
+     * ⚠️ Exige que o pai tenha altura. `h-full` sem pai medido colapsa pra zero.
+     */
+    fillHeight?: boolean;
     /** ClassName extra no root da AppShell (afeta toda a tela). */
     className?: string;
 };
+/**
+ * Qual menu lateral o shell monta — e **o que cada escolha exige**.
+ *
+ *   "menu"   (default) `MenuSidebar` — rail de MÓDULOS + painel. Para apps com áreas
+ *                      distintas (Comercial, Financeiro…), cada uma com menu próprio.
+ *   "single"           `SingleMenuSidebar` — nível único, sem módulos. Para sistema
+ *                      único, com busca opcional.
+ *
+ * Default preservado em `menu`: quem já usa não muda nada, e continua obrigado a passar
+ * `contexts` como antes.
+ *
+ * ## Por que UNIÃO DISCRIMINADA e não props opcionais
+ *
+ * A alternativa era deixar `contexts` opcional e documentar "obrigatório quando
+ * sidebar='menu'". Isso trocaria um erro de compilação por uma **falha silenciosa**:
+ * `contexts` ausente com a sidebar de menu renderiza um rail vazio, sem erro nenhum. Com a
+ * união, o TS exige exatamente o conjunto certo pra cada escolha — e o consumidor descobre
+ * no editor, não olhando a tela.
+ *
+ * ## O que o shell coordena nos dois casos
+ *
+ * O toggle do Header funciona igual pras duas, sem o consumidor cabear nada. O mapeamento
+ * interno difere porque os componentes modelam o estado de formas diferentes:
+ *
+ *   MenuSidebar   desktop → panelCollapsed · mobile → drawer (mobileOpen + backdrop)
+ *   Single        desktop → expanded (invertido) · mobile → expanded É a visibilidade
+ *                 (< md: expandida ocupa 100% da largura; recolhida some)
+ */
+type AppShellMenuSidebarProps = {
+    sidebar?: "menu";
+    /** Contextos do MenuSidebar (rail + panel data-driven). Obrigatório nesta variante. */
+    contexts: SidebarContext[];
+};
+type AppShellSingleSidebarProps = {
+    sidebar: "single";
+    /** Categorias do menu de nível único. */
+    categories: SingleMenuCategory[];
+    /** Logo no header da sidebar. */
+    sidebarLogo: ReactNode;
+    /** Título ao lado do logo. */
+    sidebarTitle: string;
+    /** Item ativo (a variante `menu` usa `activeItemHref`). */
+    activeItemId?: string;
+    /**
+     * Clique em item. Prop SEPARADA do `onItemClick` de propósito: os dois modelos de dados
+     * são diferentes — o MenuSidebar entrega o ITEM (`SidebarMenuItem`), a single entrega o
+     * `id`. Reaproveitar o mesmo nome faria o consumidor receber um tipo e escrever pro outro.
+     */
+    onSidebarItemClick?: (id: string) => void;
+    /** Módulos com menu próprio — o seletor troca o conjunto de categorias. */
+    sidebarModules?: SingleMenuModuleConfig[];
+    /** Mostra a busca no topo da sidebar. */
+    sidebarShowSearch?: boolean;
+    /**
+     * Placeholder da busca DA SIDEBAR — separado do `searchPlaceholder`, que é do Header.
+     * Nomes distintos de propósito: são dois campos de busca diferentes na mesma tela.
+     */
+    sidebarSearchPlaceholder?: string;
+};
+export type AppShellProps = AppShellBaseProps & (AppShellMenuSidebarProps | AppShellSingleSidebarProps);
+/**
+ * Uso **interno** do `app-shell.tsx`, não da API pública.
+ *
+ * Destruturar uma união não dá acesso a membro que existe em só um dos ramos (TS2339), e
+ * fazer `if (props.sidebar === "single")` antes de cada acesso espalharia narrowing por
+ * todo o componente. Então a fronteira pública é a união — é ela que guia o consumidor no
+ * editor — e a implementação lê deste shape relaxado, onde tudo é opcional.
+ *
+ * A correção de verdade fica no render: o ramo `sidebar === "single"` só usa as props da
+ * single, e o outro só as de menu. O `as` abaixo não esconde nada que a união já não
+ * garanta na entrada.
+ */
+export type AppShellInternalProps = AppShellBaseProps & Partial<AppShellMenuSidebarProps> & Partial<AppShellSingleSidebarProps>;
+export {};
 //# sourceMappingURL=app-shell.types.d.ts.map

package/dist-lib/src/components/ui/AppShell/app-shell.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/AppShell/app-shell.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app-shell.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/AppShell/app-shell.types.ts"],"names":[],"mappings":"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"}

package/dist-lib/src/components/ui/MenuSidebar/index.d.ts

@@ -12,7 +12,7 @@ export type { SidebarSectionProps } from './sidebar-section';
 export { SidebarBrandIcon } from './sidebar-brand';
 export { useControllable } from './use-sidebar-state';
 export { useMediaQuery } from './use-media-query';
-export { shouldPreventNavigation, isExternalHref, isHashHref, isModifiedClick, } from './nav-link';
-export type { PreventNavigationInput } from './nav-link';
+export { shouldPreventNavigation, isExternalHref, isHashHref, isModifiedClick, } from '../../../utils/nav-link';
+export type { PreventNavigationInput } from '../../../utils/nav-link';
 export type { SidebarProps, SidebarContext, SidebarMenuItem, SidebarSection as SidebarSectionData, SidebarBookmarkItem, SidebarChatItem, SidebarBadgeKind, SidebarLinkRenderer, SidebarLinkRenderProps, } from './sidebar.types';
 //# sourceMappingURL=index.d.ts.map

package/dist-lib/src/components/ui/MenuSidebar/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/MenuSidebar/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKlD,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGzD,YAAY,EACV,YAAY,EACZ,cAAc,EACd,eAAe,EACf,cAAc,IAAI,kBAAkB,EACpC,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/MenuSidebar/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKlD,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,UAAU,EACV,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG/D,YAAY,EACV,YAAY,EACZ,cAAc,EACd,eAAe,EACf,cAAc,IAAI,kBAAkB,EACpC,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC"}

package/dist-lib/src/components/ui/SingleMenuSidebar/category.d.ts

@@ -1,5 +1,5 @@
 import { SingleMenuCategoryProps } from './single-menu-sidebar.types';
-export declare function SingleMenuCategory({ id, icon, label, active, items, activeItemId, onItemClick, onCategoryClick, }: SingleMenuCategoryProps): import("react/jsx-runtime").JSX.Element;
+export declare function SingleMenuCategory({ id, icon, label, active, items, activeItemId, onItemClick, onCategoryClick, href, renderLink, }: SingleMenuCategoryProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace SingleMenuCategory {
     var displayName: string;
 }

package/dist-lib/src/components/ui/SingleMenuSidebar/category.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"category.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/SingleMenuSidebar/category.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAE3E,wBAAgB,kBAAkB,CAAC,EACjC,EAAE,EACF,IAAI,EACJ,KAAK,EACL,MAAc,EACd,KAAK,EACL,YAAY,EACZ,WAAW,EACX,eAAe,GAChB,EAAE,uBAAuB,2CAyGzB;yBAlHe,kBAAkB"}
+{"version":3,"file":"category.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/SingleMenuSidebar/category.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAE3E,wBAAgB,kBAAkB,CAAC,EACjC,EAAE,EACF,IAAI,EACJ,KAAK,EACL,MAAc,EACd,KAAK,EACL,YAAY,EACZ,WAAW,EACX,eAAe,EACf,IAAI,EACJ,UAAU,GACX,EAAE,uBAAuB,2CA2IzB;yBAtJe,kBAAkB"}

package/dist-lib/src/components/ui/SingleMenuSidebar/menu-item.d.ts

@@ -1,5 +1,29 @@
 import { SingleMenuItemProps } from './single-menu-sidebar.types';
-export declare function SingleMenuItem({ label, selected, onClick, }: SingleMenuItemProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Item de menu do `SingleMenuSidebar`.
+ *
+ * ## O defeito que isto corrige (medido em 2026-08-18)
+ *
+ * Até aqui este componente renderizava **sempre** `<button type="button" onClick>` — e o
+ * tipo `SingleMenuSubItem` declarava `href?: string`, e o `USAGE.md` documentava
+ * `{ id, label, href? }`. Ou seja: o consumidor declarava o destino, o TypeScript aceitava,
+ * e **nada lia**. `href` era prop morta.
+ *
+ * O que se perdia com isso — tudo silenciosamente, sem erro nenhum:
+ *
+ *   · ctrl/cmd+clique e botão do meio não abriam em nova aba
+ *   · "copiar endereço do link" não existia no menu de contexto
+ *   · leitor de tela anunciava "botão", não "link"
+ *   · nenhum router do consumidor podia ser integrado
+ *
+ * ⚠️ **Não era o mesmo defeito do `MenuSidebar`.** Lá o `<a href>` existia e navegava
+ * nativamente **junto** do handler, recarregando a página inteira a cada clique. Aqui o
+ * problema é o oposto: não havia `<a>` nenhum. O conserto, porém, usa a mesma regra —
+ * `@/utils/nav-link`, movido pra util compartilhada nesta mesma mudança justamente pra
+ * não haver duas cópias divergindo (e pra o `single-menu-sidebar` não precisar depender
+ * do item de registry do `menu-sidebar` inteiro só pra reaproveitar 60 linhas puras).
+ */
+export declare function SingleMenuItem({ label, selected, href, target, onClick, renderLink, interceptNavigation, }: SingleMenuItemProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace SingleMenuItem {
     var displayName: string;
 }

package/dist-lib/src/components/ui/SingleMenuSidebar/menu-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu-item.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/SingleMenuSidebar/menu-item.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,QAAgB,EAChB,OAAO,GACR,EAAE,mBAAmB,2CASrB;yBAbe,cAAc"}
+{"version":3,"file":"menu-item.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/SingleMenuSidebar/menu-item.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,QAAgB,EAChB,IAAI,EACJ,MAAM,EACN,OAAO,EACP,UAAU,EACV,mBAAmB,GACpB,EAAE,mBAAmB,2CAkDrB;yBA1De,cAAc"}

package/dist-lib/src/components/ui/SingleMenuSidebar/single-menu-sidebar.d.ts

@@ -1,5 +1,5 @@
 import { SingleMenuSidebarProps } from './single-menu-sidebar.types';
-export declare function SingleMenuSidebar({ logo, title, module, modules, activeModuleId, defaultModuleId, onModuleChange, showSearch, searchPlaceholder, searchCommand, categories, activeItemId, onItemClick, user, defaultExpanded, expanded: controlledExpanded, onExpandedChange, showToggleIndicator, className, ...props }: SingleMenuSidebarProps): import("react/jsx-runtime").JSX.Element;
+export declare function SingleMenuSidebar({ logo, title, module, modules, activeModuleId, defaultModuleId, onModuleChange, showSearch, searchPlaceholder, searchCommand, categories, activeItemId, onItemClick, renderLink, user, defaultExpanded, expanded: controlledExpanded, onExpandedChange, showToggleIndicator, className, ...props }: SingleMenuSidebarProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace SingleMenuSidebar {
     var displayName: string;
 }

package/dist-lib/src/components/ui/SingleMenuSidebar/single-menu-sidebar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"single-menu-sidebar.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/SingleMenuSidebar/single-menu-sidebar.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AAiBrC,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,KAAK,EACL,MAAM,EACN,OAAO,EACP,cAAc,EACd,eAAe,EACf,cAAc,EACd,UAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,WAAW,EACX,IAAI,EACJ,eAAsB,EACtB,QAAQ,EAAE,kBAAkB,EAC5B,gBAAgB,EAChB,mBAA2B,EAC3B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,sBAAsB,2CAkKxB;yBAvLe,iBAAiB"}
+{"version":3,"file":"single-menu-sidebar.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/SingleMenuSidebar/single-menu-sidebar.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AAiBrC,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,KAAK,EACL,MAAM,EACN,OAAO,EACP,cAAc,EACd,eAAe,EACf,cAAc,EACd,UAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,IAAI,EACJ,eAAsB,EACtB,QAAQ,EAAE,kBAAkB,EAC5B,gBAAgB,EAChB,mBAA2B,EAC3B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,sBAAsB,2CAmKxB;yBAzLe,iBAAiB"}