franchising 0.4.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -257,8 +257,27 @@ declare const buttonVariants: (props?: ({
257
257
  variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link" | null | undefined;
258
258
  size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
259
259
  } & import("class-variance-authority/types").ClassProp) | undefined) => string;
260
- type ButtonProps = React$1.ComponentProps<'button'> & VariantProps<typeof buttonVariants> & {
261
- /** Renderiza o filho no lugar do `button`, preservando o desenho. Use para transformar um link em botão sem perder a semântica de `a`. */
260
+ /** As variantes do `Button`, com a documentação de cada uma. */
261
+ type ButtonVariantProps = {
262
+ /**
263
+ * O papel do botão na tela: `default` para a ação principal, `outline` e `secondary` para as de apoio, `ghost` para a ação discreta, `link` para navegação e `destructive` para o que não se desfaz.
264
+ *
265
+ * @default 'default'
266
+ */
267
+ variant?: VariantProps<typeof buttonVariants>['variant'];
268
+ /**
269
+ * Altura e respiro. Os `icon-*` são quadrados, para botão só de ícone — e exigem `aria-label`.
270
+ *
271
+ * @default 'default'
272
+ */
273
+ size?: VariantProps<typeof buttonVariants>['size'];
274
+ };
275
+ type ButtonProps = React$1.ComponentProps<'button'> & ButtonVariantProps & {
276
+ /**
277
+ * Renderiza o filho no lugar do `button`, preservando o desenho. Use para transformar um link em botão sem perder a semântica de `a`.
278
+ *
279
+ * @default false
280
+ */
262
281
  asChild?: boolean;
263
282
  };
264
283
  /**
@@ -272,23 +291,50 @@ declare const toggleVariants: (props?: ({
272
291
  variant?: "default" | "outline" | null | undefined;
273
292
  size?: "default" | "sm" | "lg" | null | undefined;
274
293
  } & import("class-variance-authority/types").ClassProp) | undefined) => string;
275
- type ToggleGroupProps = React$1.ComponentProps<typeof ToggleGroup.Root> & VariantProps<typeof toggleVariants> & {
294
+ /** As variantes do `Toggle`, com a documentação de cada uma. */
295
+ type ToggleVariantProps = {
296
+ /**
297
+ * `outline` desenha a borda mesmo desligado; `default` só pinta o fundo quando ativo.
298
+ *
299
+ * @default 'default'
300
+ */
301
+ variant?: VariantProps<typeof toggleVariants>['variant'];
302
+ /**
303
+ * Altura do controle: 32px em `sm`, 36px em `default`, 40px em `lg`.
304
+ *
305
+ * @default 'default'
306
+ */
307
+ size?: VariantProps<typeof toggleVariants>['size'];
308
+ };
309
+ type ToggleGroupProps = React$1.ComponentProps<typeof ToggleGroup.Root> & ToggleVariantProps & {
310
+ /**
311
+ *
312
+ * @default 0
313
+ */
276
314
  spacing?: number;
277
315
  };
278
316
  declare function Button({ className, variant, size, asChild, ...props }: ButtonProps): import("react").JSX.Element;
279
- declare function Toggle$1({ className, variant, size, ...props }: React$1.ComponentProps<typeof Toggle.Root> & VariantProps<typeof toggleVariants>): React$1.JSX.Element;
317
+ declare function Toggle$1({ className, variant, size, ...props }: React$1.ComponentProps<typeof Toggle.Root> & ToggleVariantProps): React$1.JSX.Element;
280
318
  declare function ToggleGroup$1({ className, variant, size, spacing, children, ...props }: ToggleGroupProps): React$1.JSX.Element;
281
- declare function ToggleGroupItem({ className, children, variant, size, ...props }: React$1.ComponentProps<typeof ToggleGroup.Item> & VariantProps<typeof toggleVariants>): React$1.JSX.Element;
319
+ declare function ToggleGroupItem({ className, children, variant, size, ...props }: React$1.ComponentProps<typeof ToggleGroup.Item> & ToggleVariantProps): React$1.JSX.Element;
282
320
  type ImpersonationBannerProps = Omit<React$1.ComponentProps<'div'>, 'children'> & {
283
321
  /** Mensagem no centro da faixa, por exemplo quem está sendo visto e por quem. Sem texto padrão: o produto escreve a própria. */
284
322
  children: React$1.ReactNode;
285
323
  /** Presente: mostra à direita o botão que encerra a impersonificação. No celular a faixa mostra só o texto, sem o botão. Ele só dispara a função; trocar a sessão é do consumidor. */
286
324
  onExit?: () => void;
287
- /** Texto do botão de encerrar. Padrão `Encerrar`. */
325
+ /**
326
+ * Texto do botão de encerrar.
327
+ *
328
+ * @default 'Encerrar'
329
+ */
288
330
  exitLabel?: string;
289
331
  /** Deixa o botão de encerrar ocupado e desabilitado, enquanto o consumidor troca a sessão. */
290
332
  exiting?: boolean;
291
- /** Ícone à esquerda da mensagem. Padrão: usuário com engrenagem. `null` remove. */
333
+ /**
334
+ * Ícone à esquerda da mensagem. Padrão: usuário com engrenagem. `null` remove.
335
+ *
336
+ * @default <UserRoundCog aria-hidden className="size-4" />
337
+ */
292
338
  icon?: React$1.ReactNode;
293
339
  /** Cor de fundo da faixa, qualquer cor CSS (`#0ea5e9`, `oklch(...)`). Padrão: âmbar. `className` com `bg-*` também vale. */
294
340
  color?: string;
@@ -313,7 +359,11 @@ declare const EMAIL_PATTERN: RegExp;
313
359
  type LoginShowcaseProps = React$1.ComponentProps<'aside'> & {
314
360
  /** Caminho da imagem do painel lateral. O asset é do consumidor. */
315
361
  imageSrc: string;
316
- /** Texto alternativo. Vazio quando a imagem é decorativa. */
362
+ /**
363
+ * Texto alternativo. Vazio quando a imagem é decorativa.
364
+ *
365
+ * @default ''
366
+ */
317
367
  imageAlt?: string | undefined;
318
368
  /** Componente de imagem do framework (`next/image`). Padrão `img`. */
319
369
  imageComponent?: React$1.ElementType | undefined;
@@ -356,25 +406,61 @@ type LoginProps = Omit<React$1.ComponentProps<'div'>, 'onSubmit'> & {
356
406
  logo?: React$1.ReactNode;
357
407
  /** Destino do clique na marca. */
358
408
  logoHref?: string;
359
- /** Nome acessível do link da marca. */
409
+ /**
410
+ * Nome acessível do link da marca.
411
+ *
412
+ * @default 'Página inicial'
413
+ */
360
414
  logoLabel?: string;
361
- /** Título do formulário. Padrão `Entrar`. */
415
+ /**
416
+ * Título do formulário.
417
+ *
418
+ * @default 'Acesse sua conta'
419
+ */
362
420
  title?: React$1.ReactNode;
363
421
  /** Linha de apoio sob o título do formulário. */
364
422
  subtitle?: React$1.ReactNode;
365
- /** Rótulo do campo de email. */
423
+ /**
424
+ * Rótulo do campo de email.
425
+ *
426
+ * @default 'Email'
427
+ */
366
428
  emailLabel?: React$1.ReactNode;
367
- /** Texto do campo de email. */
429
+ /**
430
+ * Texto do campo de email.
431
+ *
432
+ * @default 'seu@email.com'
433
+ */
368
434
  emailPlaceholder?: string;
369
- /** Rótulo do campo de senha. */
435
+ /**
436
+ * Rótulo do campo de senha.
437
+ *
438
+ * @default 'Senha'
439
+ */
370
440
  passwordLabel?: React$1.ReactNode;
371
- /** Texto do campo de senha. */
441
+ /**
442
+ * Texto do campo de senha.
443
+ *
444
+ * @default '••••••••'
445
+ */
372
446
  passwordPlaceholder?: string;
373
- /** Texto do botão de envio. Padrão `Entrar`. */
447
+ /**
448
+ * Texto do botão de envio.
449
+ *
450
+ * @default 'Entrar'
451
+ */
374
452
  submitLabel?: React$1.ReactNode;
375
- /** Texto do separador acima dos métodos extras. */
453
+ /**
454
+ * Texto do separador acima dos métodos extras.
455
+ *
456
+ * @default 'ou'
457
+ */
376
458
  methodsLabel?: React$1.ReactNode;
377
- /** Preenche o email no primeiro render. */
459
+ /**
460
+ * Preenche o email no primeiro render.
461
+ *
462
+ * @default ''
463
+ */
378
464
  defaultEmail?: string;
379
465
  /** Recebe os valores do formulário. Se devolver uma Promise, o Login
380
466
  * bloqueia os campos até ela assentar. */
@@ -398,14 +484,22 @@ type LoginProps = Omit<React$1.ComponentProps<'div'>, 'onSubmit'> & {
398
484
  */
399
485
  children?: React$1.ReactNode;
400
486
  };
401
- type LoginWithSSOProps = Omit<React$1.ComponentProps<'button'>, 'onClick'> & Pick<VariantProps<typeof buttonVariants>, 'variant' | 'size'> & {
402
- /** Inicia o login no Accounts. Com o `@rockdev/sso`, é `() => authClient.signIn.rockfeller({ callbackURL })`. Enquanto a promessa não termina, o botão fica ocupado e o globo gira. */
487
+ type LoginWithSSOProps = Omit<React$1.ComponentProps<'button'>, 'onClick'> & Pick<ButtonVariantProps, 'variant' | 'size'> & {
488
+ /** Inicia o login no Accounts. Com o `franchising/sso`, é `() => authClient.signIn.rockfeller({ callbackURL })`. Enquanto a promessa não termina, o botão fica ocupado e o globo gira. */
403
489
  onSignIn: () => unknown;
404
490
  /** Recebe o erro quando `onSignIn` falha, para mostrar uma mensagem. Sem ele, o erro segue adiante como promessa rejeitada. */
405
491
  onError?: (error: unknown) => void;
406
- /** Marca à esquerda do rótulo. Padrão: o globo da Rockfeller, o mesmo do QR code de 2FA do Accounts. `null` remove. */
492
+ /**
493
+ * Marca à esquerda do rótulo. Padrão: o globo da Rockfeller, o mesmo do QR code de 2FA do Accounts. `null` remove.
494
+ *
495
+ * @default <RockfellerMark className="size-5" />
496
+ */
407
497
  icon?: React$1.ReactNode;
408
- /** Texto do botão. Padrão `Entrar com Conta Rockfeller`. */
498
+ /**
499
+ * Texto do botão.
500
+ *
501
+ * @default 'Entrar com Conta Rockfeller'
502
+ */
409
503
  children?: React$1.ReactNode;
410
504
  };
411
505
  type SignUpValues = {
@@ -464,37 +558,97 @@ type SignUpProps = Omit<React$1.ComponentProps<'div'>, 'onSubmit'> & {
464
558
  logo?: React$1.ReactNode;
465
559
  /** Destino do clique na marca. */
466
560
  logoHref?: string;
467
- /** Nome acessível do link da marca. */
561
+ /**
562
+ * Nome acessível do link da marca.
563
+ *
564
+ * @default 'Página inicial'
565
+ */
468
566
  logoLabel?: string;
469
- /** Título do formulário. Padrão `Criar conta`. */
567
+ /**
568
+ * Título do formulário.
569
+ *
570
+ * @default 'Crie sua conta'
571
+ */
470
572
  title?: React$1.ReactNode;
471
573
  /** Linha de apoio sob o título do formulário. */
472
574
  subtitle?: React$1.ReactNode;
473
- /** Rótulo do campo de nome. */
575
+ /**
576
+ * Rótulo do campo de nome.
577
+ *
578
+ * @default 'Nome'
579
+ */
474
580
  nameLabel?: React$1.ReactNode;
475
- /** Texto do campo de nome. */
581
+ /**
582
+ * Texto do campo de nome.
583
+ *
584
+ * @default 'Seu nome completo'
585
+ */
476
586
  namePlaceholder?: string;
477
- /** `false` remove o campo de nome. Email e senha são fixos. */
587
+ /**
588
+ * `false` remove o campo de nome. Email e senha são fixos.
589
+ *
590
+ * @default true
591
+ */
478
592
  showName?: boolean;
479
- /** Campos extras, na ordem em que devem aparecer depois da senha. */
593
+ /**
594
+ * Campos extras, na ordem em que devem aparecer depois da senha.
595
+ *
596
+ * @default []
597
+ */
480
598
  fields?: SignUpField[];
481
- /** Rótulo do campo de email. */
599
+ /**
600
+ * Rótulo do campo de email.
601
+ *
602
+ * @default 'Email'
603
+ */
482
604
  emailLabel?: React$1.ReactNode;
483
- /** Texto do campo de email. */
605
+ /**
606
+ * Texto do campo de email.
607
+ *
608
+ * @default 'seu@email.com'
609
+ */
484
610
  emailPlaceholder?: string;
485
- /** Rótulo do campo de senha. */
611
+ /**
612
+ * Rótulo do campo de senha.
613
+ *
614
+ * @default 'Senha'
615
+ */
486
616
  passwordLabel?: React$1.ReactNode;
487
- /** Texto do campo de senha. */
617
+ /**
618
+ * Texto do campo de senha.
619
+ *
620
+ * @default '••••••••'
621
+ */
488
622
  passwordPlaceholder?: string;
489
- /** Texto do botão de envio. Padrão `Criar conta`. */
623
+ /**
624
+ * Texto do botão de envio.
625
+ *
626
+ * @default 'Criar conta'
627
+ */
490
628
  submitLabel?: React$1.ReactNode;
491
- /** Texto do separador acima dos métodos extras. */
629
+ /**
630
+ * Texto do separador acima dos métodos extras.
631
+ *
632
+ * @default 'ou'
633
+ */
492
634
  methodsLabel?: React$1.ReactNode;
493
- /** Preenche o nome no primeiro render. */
635
+ /**
636
+ * Preenche o nome no primeiro render.
637
+ *
638
+ * @default ''
639
+ */
494
640
  defaultName?: string;
495
- /** Preenche o email no primeiro render. */
641
+ /**
642
+ * Preenche o email no primeiro render.
643
+ *
644
+ * @default ''
645
+ */
496
646
  defaultEmail?: string;
497
- /** Mínimo de caracteres da senha; o texto de apoio acompanha. */
647
+ /**
648
+ * Mínimo de caracteres da senha; o texto de apoio acompanha.
649
+ *
650
+ * @default 8
651
+ */
498
652
  minPasswordLength?: number;
499
653
  /** Presente: mostra a caixa de aceite e o envio depende dela. */
500
654
  termsLabel?: React$1.ReactNode;
@@ -600,7 +754,11 @@ declare const alertVariants: (props?: ({
600
754
  variant?: "default" | "destructive" | null | undefined;
601
755
  } & import("class-variance-authority/types").ClassProp) | undefined) => string;
602
756
  type AvatarProps = React$1.ComponentProps<typeof Avatar.Root> & {
603
- /** Diâmetro: 24px em `sm`, 32px em `default`, 40px em `lg`. */
757
+ /**
758
+ * Diâmetro: 24px em `sm`, 32px em `default`, 40px em `lg`.
759
+ *
760
+ * @default 'default'
761
+ */
604
762
  size?: 'default' | 'sm' | 'lg';
605
763
  };
606
764
  /**
@@ -614,14 +772,41 @@ declare const badgeVariants: (props?: ({
614
772
  variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link" | "positive" | "warning" | "negative" | "info" | "neutral" | "brand" | null | undefined;
615
773
  size?: "default" | "sm" | "lg" | null | undefined;
616
774
  } & import("class-variance-authority/types").ClassProp) | undefined) => string;
617
- type BadgeProps = React$1.ComponentProps<'span'> & VariantProps<typeof badgeVariants> & {
618
- /** Renderiza o filho no lugar do `span`, preservando o desenho. */
775
+ /** As variantes do `Badge`, com a documentação de cada uma. */
776
+ type BadgeVariantProps = {
777
+ /**
778
+ * Os seis primeiros seguem o botão; os tons de status (`positive` a `brand`) já trazem o par texto/superfície legível.
779
+ *
780
+ * @default 'default'
781
+ */
782
+ variant?: VariantProps<typeof badgeVariants>['variant'];
783
+ /**
784
+ * Altura do selo: 16px em `sm`, 22px em `default`, 30px em `lg`.
785
+ *
786
+ * @default 'default'
787
+ */
788
+ size?: VariantProps<typeof badgeVariants>['size'];
789
+ };
790
+ type BadgeProps = React$1.ComponentProps<'span'> & BadgeVariantProps & {
791
+ /**
792
+ * Renderiza o filho no lugar do `span`, preservando o desenho.
793
+ *
794
+ * @default false
795
+ */
619
796
  asChild?: boolean;
620
- /** Ponto antes do conteúdo, para status em listas densas. */
797
+ /**
798
+ * Ponto antes do conteúdo, para status em listas densas.
799
+ *
800
+ * @default false
801
+ */
621
802
  dot?: boolean;
622
803
  /** Presente: mostra o botão de dispensar ao fim do selo. */
623
804
  onDismiss?: () => void;
624
- /** Nome acessível do botão de dispensar. Padrão: `Remover`. */
805
+ /**
806
+ * Nome acessível do botão de dispensar.
807
+ *
808
+ * @default 'Remover'
809
+ */
625
810
  dismissLabel?: string;
626
811
  };
627
812
  type CodeBlockLabels = {
@@ -641,9 +826,17 @@ type CodeBlockProps = Omit<React$1.ComponentProps<'div'>, 'children'> & {
641
826
  filename?: string;
642
827
  /** Linguagem do realce. */
643
828
  language?: LanguageName;
644
- /** Numera as linhas. Padrão `true`. */
829
+ /**
830
+ * Numera as linhas.
831
+ *
832
+ * @default true
833
+ */
645
834
  lineNumbers?: boolean;
646
- /** Começa recolhido, com um botão para abrir. */
835
+ /**
836
+ * Começa recolhido, com um botão para abrir.
837
+ *
838
+ * @default false
839
+ */
647
840
  collapsible?: boolean;
648
841
  /** Textos acessíveis do bloco. */
649
842
  labels?: Partial<CodeBlockLabels>;
@@ -666,9 +859,17 @@ type PackageCommandLabels = {
666
859
  type PackageCommandProps = Omit<React$1.ComponentProps<'div'>, 'children' | 'defaultValue' | 'onChange'> & {
667
860
  /** Os pacotes, ou o comando a executar no modo `exec`. */
668
861
  packages: string;
669
- /** O que o comando faz. Padrão `add`. */
862
+ /**
863
+ * O que o comando faz.
864
+ *
865
+ * @default 'add'
866
+ */
670
867
  mode?: PackageCommandMode;
671
- /** Gerenciadores mostrados, na ordem. */
868
+ /**
869
+ * Gerenciadores mostrados, na ordem.
870
+ *
871
+ * @default ['bun', 'pnpm', 'npm', 'yarn']
872
+ */
672
873
  managers?: PackageManager[];
673
874
  /** Gerenciador selecionado. */
674
875
  manager?: PackageManager;
@@ -680,7 +881,11 @@ type PackageCommandProps = Omit<React$1.ComponentProps<'div'>, 'children' | 'def
680
881
  labels?: Partial<PackageCommandLabels>;
681
882
  };
682
883
  type SeparatorProps = React$1.ComponentProps<typeof Separator.Root> & {
683
- /** Esmaece as pontas: o traço é mais forte no meio e some nas extremidades, em vez de cortar o espaço de uma borda a outra. Na vertical, ocupa a altura do contêiner em vez de `1rem`. Recolora com `via-*`. */
884
+ /**
885
+ * Esmaece as pontas: o traço é mais forte no meio e some nas extremidades, em vez de cortar o espaço de uma borda a outra. Na vertical, ocupa a altura do contêiner em vez de `1rem`. Recolora com `via-*`.
886
+ *
887
+ * @default false
888
+ */
684
889
  fade?: boolean;
685
890
  };
686
891
  declare function Alert({ className, variant, ...props }: React$1.ComponentProps<'div'> & VariantProps<typeof alertVariants>): React$1.JSX.Element;
@@ -725,14 +930,22 @@ declare function ScrollBar({ className, orientation, ...props }: React$1.Compone
725
930
  declare function Separator$1({ className, orientation, decorative, fade, ...props }: SeparatorProps): import("react").JSX.Element;
726
931
  declare function Skeleton({ className, ...props }: React.ComponentProps<'div'>): import("react").JSX.Element;
727
932
  type CalendarProps = React$1.ComponentProps<typeof DayPicker> & {
728
- /** Variante dos botões de navegação entre meses. */
933
+ /**
934
+ * Variante dos botões de navegação entre meses.
935
+ *
936
+ * @default 'ghost'
937
+ */
729
938
  buttonVariant?: React$1.ComponentProps<typeof Button>['variant'];
730
939
  };
731
940
  declare const fieldVariants: (props?: ({
732
941
  orientation?: "vertical" | "horizontal" | "responsive" | null | undefined;
733
942
  } & import("class-variance-authority/types").ClassProp) | undefined) => string;
734
943
  type FieldLegendProps = React.ComponentProps<'legend'> & {
735
- /** `legend` usa o tamanho base; `label` iguala o corpo ao de um rótulo. */
944
+ /**
945
+ * `legend` usa o tamanho base; `label` iguala o corpo ao de um rótulo.
946
+ *
947
+ * @default 'legend'
948
+ */
736
949
  variant?: 'legend' | 'label';
737
950
  };
738
951
  type FieldSeparatorProps = React.ComponentProps<'div'> & {
@@ -779,7 +992,11 @@ type PasswordInputProps = (PasswordInputBase & {
779
992
  onSuggest: (password: string) => void;
780
993
  });
781
994
  type SelectTriggerProps = React$1.ComponentProps<typeof Select.Trigger> & {
782
- /** Altura do gatilho: 32px em `sm`, 36px em `default`. */
995
+ /**
996
+ * Altura do gatilho: 32px em `sm`, 36px em `default`.
997
+ *
998
+ * @default 'default'
999
+ */
783
1000
  size?: 'sm' | 'default';
784
1001
  };
785
1002
  type SliderProps = React$1.ComponentProps<typeof Slider.Root> & {
@@ -791,7 +1008,11 @@ type SliderProps = React$1.ComponentProps<typeof Slider.Root> & {
791
1008
  thumbLabels?: string[];
792
1009
  };
793
1010
  type SwitchProps = React$1.ComponentProps<typeof Switch.Root> & {
794
- /** Altura da trilha: 14px em `sm`, 18,4px em `default`. */
1011
+ /**
1012
+ * Altura da trilha: 14px em `sm`, 18,4px em `default`.
1013
+ *
1014
+ * @default 'default'
1015
+ */
795
1016
  size?: 'sm' | 'default';
796
1017
  };
797
1018
  /**
@@ -887,22 +1108,42 @@ type SidebarNavProps = {
887
1108
  className?: string;
888
1109
  };
889
1110
  type AlertDialogContentProps = React$1.ComponentProps<typeof AlertDialog.Content> & {
890
- /** Largura máxima: 512px em `default`, 320px em `sm`. No `sm` os botões do rodapé ficam lado a lado em duas colunas. */
1111
+ /**
1112
+ * Largura máxima: 512px em `default`, 320px em `sm`. No `sm` os botões do rodapé ficam lado a lado em duas colunas.
1113
+ *
1114
+ * @default 'default'
1115
+ */
891
1116
  size?: 'default' | 'sm';
892
1117
  };
893
1118
  type CommandDialogProps = React$1.ComponentProps<typeof Dialog$1> & {
894
- /** Título anunciado a leitores de tela; fica visualmente escondido. */
1119
+ /**
1120
+ * Título anunciado a leitores de tela; fica visualmente escondido.
1121
+ *
1122
+ * @default 'Command Palette'
1123
+ */
895
1124
  title?: string;
896
- /** Descrição anunciada junto do título, também escondida. */
1125
+ /**
1126
+ * Descrição anunciada junto do título, também escondida.
1127
+ *
1128
+ * @default 'Search for a command to run...'
1129
+ */
897
1130
  description?: string;
898
1131
  className?: string;
899
- /** Mostra o X no canto superior direito. */
1132
+ /**
1133
+ * Mostra o X no canto superior direito.
1134
+ *
1135
+ * @default true
1136
+ */
900
1137
  showCloseButton?: boolean;
901
1138
  };
902
1139
  type ContextMenuItemProps = React$1.ComponentProps<typeof ContextMenu.Item> & {
903
1140
  /** Recua o item, alinhando o texto com quem tem ícone. */
904
1141
  inset?: boolean;
905
- /** O tom destrutivo pinta o item de vermelho, inclusive no foco. */
1142
+ /**
1143
+ * O tom destrutivo pinta o item de vermelho, inclusive no foco.
1144
+ *
1145
+ * @default 'default'
1146
+ */
906
1147
  variant?: 'default' | 'destructive';
907
1148
  };
908
1149
  type ContextMenuLabelProps = React$1.ComponentProps<typeof ContextMenu.Label> & {
@@ -914,17 +1155,29 @@ type ContextMenuSubTriggerProps = React$1.ComponentProps<typeof ContextMenu.SubT
914
1155
  inset?: boolean;
915
1156
  };
916
1157
  type DialogContentProps = React$1.ComponentProps<typeof Dialog.Content> & {
917
- /** Mostra o X no canto superior direito. */
1158
+ /**
1159
+ * Mostra o X no canto superior direito.
1160
+ *
1161
+ * @default true
1162
+ */
918
1163
  showCloseButton?: boolean;
919
1164
  };
920
1165
  type DialogFooterProps = React$1.ComponentProps<'div'> & {
921
- /** Acrescenta um botão de fechar ao rodapé. */
1166
+ /**
1167
+ * Acrescenta um botão de fechar ao rodapé.
1168
+ *
1169
+ * @default false
1170
+ */
922
1171
  showCloseButton?: boolean;
923
1172
  };
924
1173
  type DropdownMenuItemProps = React$1.ComponentProps<typeof DropdownMenu.Item> & {
925
1174
  /** Recua o item, alinhando o texto com quem tem ícone. */
926
1175
  inset?: boolean;
927
- /** O tom destrutivo pinta o item de vermelho, inclusive no foco. */
1176
+ /**
1177
+ * O tom destrutivo pinta o item de vermelho, inclusive no foco.
1178
+ *
1179
+ * @default 'default'
1180
+ */
928
1181
  variant?: 'default' | 'destructive';
929
1182
  };
930
1183
  type DropdownMenuLabelProps = React$1.ComponentProps<typeof DropdownMenu.Label> & {
@@ -936,9 +1189,17 @@ type DropdownMenuSubTriggerProps = React$1.ComponentProps<typeof DropdownMenu.Su
936
1189
  inset?: boolean;
937
1190
  };
938
1191
  type SheetContentProps = React$1.ComponentProps<typeof Dialog.Content> & {
939
- /** De qual borda o painel entra. */
1192
+ /**
1193
+ * De qual borda o painel entra.
1194
+ *
1195
+ * @default 'right'
1196
+ */
940
1197
  side?: 'top' | 'right' | 'bottom' | 'left';
941
- /** Mostra o X no canto superior direito. */
1198
+ /**
1199
+ * Mostra o X no canto superior direito.
1200
+ *
1201
+ * @default true
1202
+ */
942
1203
  showCloseButton?: boolean;
943
1204
  };
944
1205
  declare function AlertDialog$1({ ...props }: React$1.ComponentProps<typeof AlertDialog.Root>): React$1.JSX.Element;
@@ -1046,7 +1307,11 @@ declare const sidebarMenuButtonVariants: (props?: ({
1046
1307
  size?: "default" | "sm" | "lg" | null | undefined;
1047
1308
  } & import("class-variance-authority/types").ClassProp) | undefined) => string;
1048
1309
  type SidebarProviderProps = React$1.ComponentProps<'div'> & {
1049
- /** Estado inicial no modo não-controlado. */
1310
+ /**
1311
+ * Estado inicial no modo não-controlado.
1312
+ *
1313
+ * @default true
1314
+ */
1050
1315
  defaultOpen?: boolean;
1051
1316
  /** Estado controlado; exige `onOpenChange`. */
1052
1317
  open?: boolean;
@@ -1056,45 +1321,97 @@ type SidebarProviderProps = React$1.ComponentProps<'div'> & {
1056
1321
  keyboardShortcut?: string | false;
1057
1322
  };
1058
1323
  type SidebarProps = React$1.ComponentProps<'div'> & {
1059
- /** De que lado a navegação fica. */
1324
+ /**
1325
+ * De que lado a navegação fica.
1326
+ *
1327
+ * @default 'left'
1328
+ */
1060
1329
  side?: 'left' | 'right';
1061
- /** Como a navegação se apoia no layout: colada, flutuando ou embutida num cartão. */
1330
+ /**
1331
+ * Como a navegação se apoia no layout: colada, flutuando ou embutida num cartão.
1332
+ *
1333
+ * @default 'sidebar'
1334
+ */
1062
1335
  variant?: 'sidebar' | 'floating' | 'inset';
1063
- /** O que acontece ao recolher: sai da tela, vira barra de ícones ou nada. */
1336
+ /**
1337
+ * O que acontece ao recolher: sai da tela, vira barra de ícones ou nada.
1338
+ *
1339
+ * @default 'offcanvas'
1340
+ */
1064
1341
  collapsible?: 'offcanvas' | 'icon' | 'none';
1065
1342
  };
1066
1343
  type SidebarGroupLabelProps = React$1.ComponentProps<'div'> & {
1067
- /** Renderiza o filho no lugar do `div` do rótulo. */
1344
+ /**
1345
+ * Renderiza o filho no lugar do `div` do rótulo.
1346
+ *
1347
+ * @default false
1348
+ */
1068
1349
  asChild?: boolean;
1069
1350
  };
1070
1351
  type SidebarGroupActionProps = React$1.ComponentProps<'button'> & {
1071
- /** Renderiza o filho no lugar do botão de ação do grupo. */
1352
+ /**
1353
+ * Renderiza o filho no lugar do botão de ação do grupo.
1354
+ *
1355
+ * @default false
1356
+ */
1072
1357
  asChild?: boolean;
1073
1358
  };
1074
1359
  type SidebarMenuButtonProps = React$1.ComponentProps<'button'> & {
1075
- /** Renderiza o filho no lugar do botão, preservando o desenho. */
1360
+ /**
1361
+ * Renderiza o filho no lugar do botão, preservando o desenho.
1362
+ *
1363
+ * @default false
1364
+ */
1076
1365
  asChild?: boolean;
1077
- /** Marca o item como o da rota atual. */
1366
+ /**
1367
+ * Marca o item como o da rota atual.
1368
+ *
1369
+ * @default false
1370
+ */
1078
1371
  isActive?: boolean;
1079
1372
  /** Texto mostrado quando a navegação está recolhida em ícones. */
1080
1373
  tooltip?: string | React$1.ComponentProps<typeof TooltipContent>;
1081
1374
  } & VariantProps<typeof sidebarMenuButtonVariants>;
1082
1375
  type SidebarMenuActionProps = React$1.ComponentProps<'button'> & {
1083
- /** Renderiza o filho no lugar do botão de ação. */
1376
+ /**
1377
+ * Renderiza o filho no lugar do botão de ação.
1378
+ *
1379
+ * @default false
1380
+ */
1084
1381
  asChild?: boolean;
1085
- /** Esconde a ação até o mouse passar pelo item ou o foco chegar nele. */
1382
+ /**
1383
+ * Esconde a ação até o mouse passar pelo item ou o foco chegar nele.
1384
+ *
1385
+ * @default false
1386
+ */
1086
1387
  showOnHover?: boolean;
1087
1388
  };
1088
1389
  type SidebarMenuSkeletonProps = React$1.ComponentProps<'div'> & {
1089
- /** Inclui um quadrado de ícone no esqueleto. */
1390
+ /**
1391
+ * Inclui um quadrado de ícone no esqueleto.
1392
+ *
1393
+ * @default false
1394
+ */
1090
1395
  showIcon?: boolean;
1091
1396
  };
1092
1397
  type SidebarMenuSubButtonProps = React$1.ComponentProps<'a'> & {
1093
- /** Renderiza o filho no lugar do item de submenu. */
1398
+ /**
1399
+ * Renderiza o filho no lugar do item de submenu.
1400
+ *
1401
+ * @default false
1402
+ */
1094
1403
  asChild?: boolean;
1095
- /** Altura do item de submenu. */
1404
+ /**
1405
+ * Altura do item de submenu.
1406
+ *
1407
+ * @default 'md'
1408
+ */
1096
1409
  size?: 'sm' | 'md';
1097
- /** Marca o item de submenu como o da rota atual. */
1410
+ /**
1411
+ * Marca o item de submenu como o da rota atual.
1412
+ *
1413
+ * @default false
1414
+ */
1098
1415
  isActive?: boolean;
1099
1416
  };
1100
1417
  /**
@@ -1107,6 +1424,15 @@ type SidebarMenuSubButtonProps = React$1.ComponentProps<'a'> & {
1107
1424
  declare const tabsListVariants: (props?: ({
1108
1425
  variant?: "default" | "line" | null | undefined;
1109
1426
  } & import("class-variance-authority/types").ClassProp) | undefined) => string;
1427
+ /** As variantes do `TabsList`, com a documentação de cada uma. */
1428
+ type TabsListVariantProps = {
1429
+ /**
1430
+ * `default` é a lista com fundo e indicador deslizante; `line` remove o fundo e deixa as abas soltas.
1431
+ *
1432
+ * @default 'default'
1433
+ */
1434
+ variant?: VariantProps<typeof tabsListVariants>['variant'];
1435
+ };
1110
1436
  declare function Breadcrumb({ ...props }: React$1.ComponentProps<'nav'>): React$1.JSX.Element;
1111
1437
  declare function BreadcrumbList({ className, ...props }: React$1.ComponentProps<'ol'>): React$1.JSX.Element;
1112
1438
  declare function BreadcrumbItem({ className, ...props }: React$1.ComponentProps<'li'>): React$1.JSX.Element;
@@ -1170,7 +1496,7 @@ declare function SidebarMenuSubButton({ asChild, size, isActive, className, ...p
1170
1496
  */
1171
1497
  declare function SidebarNav({ groups, activeHref, linkComponent, onNavigate, className }: SidebarNavProps): React$1.JSX.Element;
1172
1498
  declare function Tabs$1({ className, orientation, ...props }: React$1.ComponentProps<typeof Tabs.Root>): React$1.JSX.Element;
1173
- declare function TabsList({ className, variant, children, ...props }: React$1.ComponentProps<typeof Tabs.List> & VariantProps<typeof tabsListVariants>): React$1.JSX.Element;
1499
+ declare function TabsList({ className, variant, children, ...props }: React$1.ComponentProps<typeof Tabs.List> & TabsListVariantProps): React$1.JSX.Element;
1174
1500
  declare function TabsTrigger({ className, ...props }: React$1.ComponentProps<typeof Tabs.Trigger>): React$1.JSX.Element;
1175
1501
  declare function TabsContent({ className, ...props }: React$1.ComponentProps<typeof Tabs.Content>): React$1.JSX.Element;
1176
1502
  type Theme = 'light' | 'dark' | 'system';
@@ -1178,7 +1504,11 @@ type ThemeLabels = Record<Theme, string>;
1178
1504
  type ThemeToggleProps = Omit<React$1.ComponentProps<'div'>, 'children' | 'defaultValue' | 'onChange' | 'dir'> & {
1179
1505
  /** Controlado: exige `onValueChange`. */
1180
1506
  value?: Theme;
1181
- /** Valor inicial no modo não-controlado. Padrão `system`. */
1507
+ /**
1508
+ * Valor inicial no modo não-controlado.
1509
+ *
1510
+ * @default 'system'
1511
+ */
1182
1512
  defaultValue?: Theme;
1183
1513
  /**
1184
1514
  * Recebe a escolha. Aplicar o tema é da aplicação: o componente não
@@ -1188,9 +1518,15 @@ type ThemeToggleProps = Omit<React$1.ComponentProps<'div'>, 'children' | 'defaul
1188
1518
  /**
1189
1519
  * `segmented`: os três estados visíveis lado a lado.
1190
1520
  * `menu`: um botão de ícone que abre a lista — ocupa menos espaço.
1521
+ *
1522
+ * @default 'segmented'
1191
1523
  */
1192
1524
  variant?: 'segmented' | 'menu';
1193
- /** Altura dos controles. */
1525
+ /**
1526
+ * Altura dos controles.
1527
+ *
1528
+ * @default 'sm'
1529
+ */
1194
1530
  size?: 'sm' | 'default';
1195
1531
  /** Rótulos acessíveis de cada opção. */
1196
1532
  labels?: Partial<ThemeLabels>;