@softize/opus 13.1.0 → 15.0.0

package/src/ui/react.tsx

@@ -18,7 +18,12 @@ export type {
   ButtonVariant,
   ButtonSize,
 } from "./components/primitives/button.tsx";
-export type { ControlShape } from "./components/primitives/control.ts";
+export type {
+  ControlShape,
+  ControlSize,
+  ControlIconSize,
+  ControlScale,
+} from "./components/primitives/control.ts";
 
 export { Input } from "./components/primitives/input.tsx";
 
@@ -358,6 +363,7 @@ export { useOverflowing } from "./lib/overflow.ts";
 export {
   ActionForm,
   ActionFormField,
+  LabelHelp,
   useActionFormContext,
 } from "./components/patterns/form.tsx";
 export type {
@@ -395,12 +401,7 @@ export { ActionView } from "./components/patterns/view.tsx";
 export type { ActionViewProps } from "./components/patterns/view.tsx";
 
 export { ActionTrigger } from "./components/patterns/trigger.tsx";
-export {
-  dialog,
-  DialogHost,
-  confirm,
-  ConfirmHost,
-} from "./components/patterns/confirm.tsx";
+export { dialog, DialogHost } from "./components/patterns/confirm.tsx";
 export type {
   AlertOptions,
   ChooseOptions,
@@ -422,14 +423,20 @@ export type { DataStateProps } from "./components/patterns/data-state.tsx";
 export {
   Page,
   PageHeader,
+  PageNavigation,
+  PageBack,
   PageTitle,
   PageDescription,
-  PageMeta,
   PageActions,
   PageActionsTarget,
   PageBody,
 } from "./components/patterns/page.tsx";
-export type { PageProps } from "./components/patterns/page.tsx";
+export type {
+  PageProps,
+  PageBackProps,
+  PageHeaderProps,
+  PageHeaderVariant,
+} from "./components/patterns/page.tsx";
 
 // Estado integral do conteúdo de Page (loading/error/empty/ready), sem acoplar Page a dados.
 export { PageState } from "./components/patterns/page-state.tsx";
@@ -499,15 +506,6 @@ export type {
   SidebarNavItem,
 } from "./components/patterns/sidebar.tsx";
 
-// O menu como primitivo pivotável: recolhe quando composto dentro de Sidebar.
-export { ShellNav, ShellNavHeading } from "./components/patterns/shell-nav.tsx";
-export type {
-  ShellNavProps,
-  ShellNavGroup,
-  ShellNavItem,
-  ShellNavHeadingProps,
-} from "./components/patterns/shell-nav.tsx";
-
 // Roteamento history-based (o pathname É o estado). Escopo pequeno de propósito: leitura
 // reativa da URL + navigate — sem tabela de rotas. Ver src/ui/router.ts.
 export {

package/src/ui/components/patterns/shell-nav.tsx

@@ -1,154 +0,0 @@
-/**
- * <ShellNav /> — o menu como primitivo PIVOTÁVEL. Um nav (grupos → itens, com heading e
- * âncora inferior) que serve os DOIS lares do chrome sem flag:
- *
- *   - dentro de <Sidebar> → recolhe pra ícone-só (com tooltip) junto com a coluna;
- *   - fora de <Sidebar> → permanece expandido.
- *
- * "Tanto faz onde": o componente se adapta ao lugar, sem "modo" configurado.
- *
- * Presentacional e CONTROLADO — o app é dono do `activeId`, do clique e do roteamento.
- * v1 PLANA (grupos → itens); aninhamento (accordion/pasta) e DnD COMPOSTO entram quando o
- * primeiro consumidor de árvore migrar — ver `docs/shellnav.md`.
- */
-
-import type { ReactNode } from 'react'
-import { cn } from '../../lib/cn.ts'
-import { focusRing } from '../primitives/control.ts'
-import { useSidebarCollapsed } from './sidebar.tsx'
-import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from '../primitives/tooltip.tsx'
-
-/** @deprecated Use `SidebarNav` (ver sidebar.md); mantido por compatibilidade. */
-export interface ShellNavItem {
-  /** Coordenada estável — volta em `onSelect` e casa com `activeId`. Único em toda a nav. */
-  id: string
-  label: string
-  /** Ícone à esquerda (é o que sobra no modo recolhido — vira o alvo, com o label no tooltip). */
-  icon?: ReactNode
-  /** Selo à direita (contagem, `beta`). Some no recolhido. */
-  badge?: ReactNode
-  /** Visível mas inerte. */
-  disabled?: boolean
-}
-
-/** @deprecated Use `SidebarNav` (ver sidebar.md); mantido por compatibilidade. */
-export interface ShellNavGroup {
-  /** Cabeçalho do grupo. Ausente/vazio = itens soltos, sem rótulo. Some no recolhido. */
-  label?: string
-  items: ShellNavItem[]
-}
-
-/** @deprecated Use `SidebarNav` (ver sidebar.md); mantido por compatibilidade. */
-export interface ShellNavProps {
-  groups: ShellNavGroup[]
-  /** `id` do item ativo. Ausente = nenhum destacado. */
-  activeId?: string
-  onSelect: (id: string) => void
-  /** Topo do nav — título, busca, botão (ex.: o "+" do Relatórios). Some no recolhido. Ver <ShellNavHeading>. */
-  heading?: ReactNode
-  /** Grupos ANCORADOS embaixo (ex.: Configurações no app), mesmo renderer, separados por filete. */
-  footer?: ShellNavGroup[]
-  /** Rótulo da landmark `<nav>`. */
-  navLabel?: string
-  /** Classes da raiz (a coluna). A largura vem do pane/sidebar que a contém. */
-  className?: string
-}
-
-/** Rótulo só existe se tiver texto — vazio não vira cabeçalho fantasma. */
-const titled = (label?: string): boolean => (label ?? '').trim() !== ''
-
-/** Selo vazio não vira pílula sem texto. `0` conta (contagem legítima). */
-const shown = (badge: ReactNode): boolean => {
-  if (badge === undefined || badge === null || badge === false || badge === '') return false
-  if (typeof badge === 'number' && Number.isNaN(badge)) return false
-  return !(Array.isArray(badge) && badge.length === 0)
-}
-
-/** Grupo sem item não abre buraco no `space-y` nem deixa rótulo pairando sobre nada. */
-const filled = (group: ShellNavGroup): boolean => group.items.length > 0
-
-function renderItem(item: ShellNavItem, activeId: string | undefined, onSelect: (id: string) => void, railed: boolean): React.ReactElement {
-  const active = item.id === activeId
-  const button = (
-    <button
-      type="button"
-      disabled={item.disabled}
-      aria-current={active ? 'page' : undefined}
-      onClick={() => onSelect(item.id)}
-      className={cn(
-        'flex w-full items-center gap-2.5 rounded-md py-1.5 text-left text-sm transition-colors',
-        'disabled:pointer-events-none disabled:opacity-40',
-        'outline-none',
-        focusRing,
-        railed ? 'justify-center px-0' : 'px-2.5',
-        active ? 'bg-muted font-medium text-foreground' : 'text-foreground/80 hover:bg-muted/60',
-      )}
-    >
-      {item.icon !== undefined && <span className="flex shrink-0">{item.icon}</span>}
-      {!railed && <span className="min-w-0 flex-1 truncate">{item.label}</span>}
-      {!railed && shown(item.badge) && <span className="shrink-0">{item.badge}</span>}
-    </button>
-  )
-  if (!railed) return <div key={item.id}>{button}</div>
-  // Recolhido: o label migra pro tooltip (à direita) — sem ele, a coluna vira ícones adivinháveis.
-  return (
-    <Tooltip key={item.id}>
-      <TooltipTrigger asChild>{button}</TooltipTrigger>
-      <TooltipContent side="right">{item.label}</TooltipContent>
-    </Tooltip>
-  )
-}
-
-function renderGroup(group: ShellNavGroup, gi: number, activeId: string | undefined, onSelect: (id: string) => void, railed: boolean): React.ReactElement | null {
-  if (!filled(group)) return null
-  return (
-    <div key={gi} className="space-y-0.5">
-      {!railed && titled(group.label) && (
-        <div className="px-2.5 pb-1 text-xs font-medium text-muted-foreground/70">{group.label}</div>
-      )}
-      {group.items.map((item) => renderItem(item, activeId, onSelect, railed))}
-    </div>
-  )
-}
-
-/** @deprecated Use `SidebarNav`: mesma navegação, integrada à `Sidebar`. Mantido por compatibilidade. */
-export function ShellNav({ groups, activeId, onSelect, heading, footer, navLabel = 'Navegação', className }: ShellNavProps): React.ReactElement {
-  const railed = useSidebarCollapsed()
-
-  const body = (
-    <div data-slot="shell-nav" className={cn('flex h-full min-h-0 flex-col', className)}>
-      {!railed && heading}
-      <nav aria-label={navLabel} className={cn('min-h-0 flex-1 space-y-4 overflow-y-auto p-2', railed && 'px-1.5')}>
-        {groups.map((group, gi) => renderGroup(group, gi, activeId, onSelect, railed))}
-      </nav>
-      {footer !== undefined && footer.some(filled) && (
-        <div className={cn('space-y-4 border-t border-border p-2', railed && 'px-1.5')}>
-          {footer.map((group, gi) => renderGroup(group, gi, activeId, onSelect, railed))}
-        </div>
-      )}
-    </div>
-  )
-
-  // Recolhido usa tooltips — garante um provider (nested é ok se o app já tem um).
-  return railed ? <TooltipProvider delayDuration={200}>{body}</TooltipProvider> : body
-}
-
-/** @deprecated Use `SidebarNav` (ver sidebar.md); mantido por compatibilidade. */
-export interface ShellNavHeadingProps {
-  /** Título da seção. */
-  title: ReactNode
-  /** Ação à direita — em geral um botão (o "+" de criar). */
-  action?: ReactNode
-  className?: string
-}
-
-/** @deprecated Use `SidebarHeader` com `SidebarNav`. Cabeçalho do ShellNav: título + espaço
- *  pra um botão. Mantido por compatibilidade. */
-export function ShellNavHeading({ title, action, className }: ShellNavHeadingProps): React.ReactElement {
-  return (
-    <div className={cn('flex h-12 shrink-0 items-center gap-1.5 border-b border-border px-4', className)}>
-      <span className="min-w-0 flex-1 truncate text-sm font-semibold">{title}</span>
-      {action !== undefined && <span className="shrink-0">{action}</span>}
-    </div>
-  )
-}