@snksergio/design-system 0.40.0 → 0.42.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":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,mBAAmB,EACpB,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,4EAA4E;AAC5E,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,aAAa,GAAG;IAE1B,wEAAwE;IACxE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,8EAA8E;IAC9E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,oDAAoD;IACpD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,CACZ,IAAI,EAAE,eAAe,EACrB,KAAK,CAAC,EAAE,UAAU,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,KACtD,IAAI,CAAC;IAEV;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAC;IAEjC,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAG1D,sEAAsE;IACtE,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,kEAAkE;IAClE,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,oCAAoC;IACpC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACnC,6CAA6C;IAC7C,eAAe,CAAC,EAAE,SAAS,CAAC;IAG5B;;;;OAIG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,aAAa,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACvC,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAGtB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAGpD;;iFAE6E;IAC7E,QAAQ,EAAE,SAAS,CAAC;IACpB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAG3B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC"}
+{"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/DataTable/builders/column-builders.d.ts.map

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

package/dist-lib/src/components/ui/DataTable/parts/data-table-actions-cell.d.ts

@@ -6,9 +6,13 @@ export type DataTableActionsCellProps<T> = {
     actions: DataTableActionItem<T>[];
 };
 /**
- * Celula da coluna `type: "actions"` — renderiza icone-buttons inline
- * (items com `showInMenu` false ou undefined) e/ou dropdown 3-pontos
- * (items com `showInMenu: true`).
+ * Celula da coluna `type: "actions"` — renderiza icone-buttons inline e/ou o
+ * dropdown "…". Quem decide o split é `splitActionSlots` (ver `utils/action-slots.ts`
+ * pra a regra e a geometria que a justifica):
+ *
+ *   - algum item com `showInMenu` → o split do consumer manda, sem limite;
+ *   - até 3 itens, nenhum marcado → todos inline, sem "…";
+ *   - mais de 3, nenhum marcado → todos no "…" (4 ícones não cabem na coluna).
  *
  * Items com `hidden(row) === true` somem completamente. Items com
  * `disabled(row) === true` ficam atenuados e sem click.

package/dist-lib/src/components/ui/DataTable/parts/data-table-actions-cell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-table-actions-cell.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/DataTable/parts/data-table-actions-cell.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI;IACzC,0DAA0D;IAC1D,GAAG,EAAE,CAAC,CAAC;IACP,+CAA+C;IAC/C,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,EACtC,GAAG,EACH,OAAO,GACR,EAAE,yBAAyB,CAAC,CAAC,CAAC,kDAyE9B"}
+{"version":3,"file":"data-table-actions-cell.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/DataTable/parts/data-table-actions-cell.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI;IACzC,0DAA0D;IAC1D,GAAG,EAAE,CAAC,CAAC;IACP,+CAA+C;IAC/C,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,EACtC,GAAG,EACH,OAAO,GACR,EAAE,yBAAyB,CAAC,CAAC,CAAC,kDAsE9B"}

package/dist-lib/src/components/ui/DataTable/utils/action-slots.d.ts

@@ -0,0 +1,76 @@
+import { DataTableActionItem } from '../data-table.types';
+/**
+ * Regra de distribuição das ações de uma row entre ícones inline e o menu "…",
+ * e a largura que a coluna `type: "actions"` precisa pra caber o resultado.
+ *
+ * ## Por que isto é um módulo próprio
+ *
+ * A célula (`parts/data-table-actions-cell.tsx`) decide o que renderiza; o
+ * `calculate-column-widths.ts` decide quanto espaço reservar. Se cada um aplicasse a
+ * regra por conta, os dois divergiriam no primeiro ajuste — foi exatamente o defeito da
+ * L-038, onde header e footer liam `col.align` cru e discordavam do body. Aqui a regra
+ * mora num lugar e os dois a chamam.
+ *
+ * ## A geometria, MEDIDA NO BROWSER (e a versão errada que ela substituiu)
+ *
+ * A célula é `flex items-center gap-gp-2xs justify-end` dentro de uma `TableCell` que, na
+ * variante `actions`, usa **`px-pad-md`** — a variante sobrescreve o `px-pad-2xl` default
+ * das outras células (`Table/table.styles.ts`, bloco `variants.actions`). Com os tokens:
+ *
+ *   padding    = `pad-md` × 2    = 16px
+ *   ícone      = `icon-2xs` → `size-form-xs` = 28px
+ *   gap        = `gp-2xs`        = 2px
+ *
+ *   largura(n) = 16 + 28n + 2(n−1) = **30n + 14**
+ *
+ * Donde 1→44, 2→74, 3→104, 4→134.
+ *
+ * ⚠️ A primeira versão deste módulo usava `pad-2xl` (32px de padding) e chegava a
+ * `30n + 30` — 1→60, 3→120 — com a conclusão elegante de que o `ACTIONS_COLUMN_WIDTH`
+ * legado (120) "era exatamente 3 slots". **Falso**: 3 slots são 104, e 120 fica entre 3 e
+ * 4. O teste concordava porque derivava da mesma fórmula errada; quem pegou foi a medição
+ * no browser (`width: 64px` inline, `padding: 8px/8px`, botão 28px, folga 8px). É a L-064
+ * literal — teste escrito do mesmo modelo mental do código concorda por construção.
+ *
+ * ## O limite de 3 não é preferência estética
+ *
+ * É a capacidade da coluna que o componente já usava: dentro dos 120px legados sobram
+ * 104 úteis, e 4 ícones pedem 118. Ou a coluna cresce, ou o excedente vai pro menu. O
+ * default aqui é **mandar tudo pro menu**, porque coluna de ação larga empurra o conteúdo
+ * de dados e derrota o motivo de ela estar ancorada à direita.
+ */
+/** Quantos ícones cabem inline nos 120px que a coluna sempre usou. */
+export declare const ACTIONS_INLINE_MAX = 3;
+/** Largura da coluna pra `n` slots renderizados (ícones + o "…" quando existe). */
+export declare function actionsWidthForSlots(slots: number): number;
+/**
+ * Divide as ações visíveis de uma row entre inline e menu.
+ *
+ * Precedência — e a primeira regra existe pra não passar por cima de decisão explícita:
+ *
+ * 1. **Algum item marca `showInMenu`** → o consumer já decidiu o split; respeitado
+ *    integralmente, sem limite de quantidade. Quem quer 5 ícones inline consegue.
+ * 2. Até `ACTIONS_INLINE_MAX` (3) itens → todos inline, sem "…". Uma ação só = um ícone
+ *    só, que é o caso comum de "editar".
+ * 3. Mais de 3 → **todos** vão pro menu, e a coluna renderiza só o "…".
+ */
+export declare function splitActionSlots<T>(actions: DataTableActionItem<T>[], row: T): {
+    inline: DataTableActionItem<T>[];
+    menu: DataTableActionItem<T>[];
+};
+/** Slots renderizados: um por ícone inline, mais um pro "…" quando há menu. */
+export declare function countActionSlots<T>(split: {
+    inline: DataTableActionItem<T>[];
+    menu: DataTableActionItem<T>[];
+}): number;
+/**
+ * Largura necessária pra uma coluna de ações, olhando as rows amostradas.
+ *
+ * Usa o **máximo** entre as rows: `hidden` pode variar por row (ex.: "cancelar" só em
+ * pedido aberto), e reservar pelo menor cortaria a row mais completa. Sem `getActions`
+ * ou sem rows, devolve `null` — quem chama decide o fallback.
+ */
+export declare function measureActionsWidth<T>(getActions: ((params: {
+    row: T;
+}) => DataTableActionItem<T>[]) | undefined, rows: T[]): number | null;
+//# sourceMappingURL=action-slots.d.ts.map