@refy-design/mobile 0.0.0-stage → 1.2.0

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.
Files changed (194) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +32 -0
  3. package/README.md +61 -2
  4. package/dist/index.js +10322 -0
  5. package/dist/types/_contracts/accordion.d.ts +34 -0
  6. package/dist/types/_contracts/account.d.ts +113 -0
  7. package/dist/types/_contracts/activity-item.d.ts +23 -0
  8. package/dist/types/_contracts/aspect-ratio.d.ts +5 -0
  9. package/dist/types/_contracts/avatar-group.d.ts +20 -0
  10. package/dist/types/_contracts/avatar.d.ts +23 -0
  11. package/dist/types/_contracts/badge.d.ts +9 -0
  12. package/dist/types/_contracts/boards.d.ts +42 -0
  13. package/dist/types/_contracts/brand-logo.d.ts +16 -0
  14. package/dist/types/_contracts/bubble.d.ts +5 -0
  15. package/dist/types/_contracts/button-group.d.ts +12 -0
  16. package/dist/types/_contracts/button.d.ts +27 -0
  17. package/dist/types/_contracts/calendar.d.ts +33 -0
  18. package/dist/types/_contracts/callout.d.ts +19 -0
  19. package/dist/types/_contracts/capture.d.ts +29 -0
  20. package/dist/types/_contracts/card.d.ts +26 -0
  21. package/dist/types/_contracts/charts.d.ts +79 -0
  22. package/dist/types/_contracts/checkbox.d.ts +17 -0
  23. package/dist/types/_contracts/chip.d.ts +23 -0
  24. package/dist/types/_contracts/choice-card.d.ts +34 -0
  25. package/dist/types/_contracts/combobox.d.ts +57 -0
  26. package/dist/types/_contracts/connector-card.d.ts +26 -0
  27. package/dist/types/_contracts/content.d.ts +87 -0
  28. package/dist/types/_contracts/divider.d.ts +12 -0
  29. package/dist/types/_contracts/empty-state.d.ts +13 -0
  30. package/dist/types/_contracts/fab.d.ts +13 -0
  31. package/dist/types/_contracts/form-fields.d.ts +41 -0
  32. package/dist/types/_contracts/guided.d.ts +67 -0
  33. package/dist/types/_contracts/icon-button.d.ts +9 -0
  34. package/dist/types/_contracts/index.d.ts +62 -0
  35. package/dist/types/_contracts/input.d.ts +15 -0
  36. package/dist/types/_contracts/item.d.ts +11 -0
  37. package/dist/types/_contracts/modal.d.ts +18 -0
  38. package/dist/types/_contracts/nav-card.d.ts +12 -0
  39. package/dist/types/_contracts/oauth-button.d.ts +8 -0
  40. package/dist/types/_contracts/organisms.d.ts +133 -0
  41. package/dist/types/_contracts/otp.d.ts +23 -0
  42. package/dist/types/_contracts/overlay.d.ts +118 -0
  43. package/dist/types/_contracts/page-header.d.ts +14 -0
  44. package/dist/types/_contracts/pagination.d.ts +10 -0
  45. package/dist/types/_contracts/person-cell.d.ts +9 -0
  46. package/dist/types/_contracts/progress-bar.d.ts +19 -0
  47. package/dist/types/_contracts/radio-group.d.ts +15 -0
  48. package/dist/types/_contracts/score-gauge.d.ts +15 -0
  49. package/dist/types/_contracts/scroll-area.d.ts +3 -0
  50. package/dist/types/_contracts/section-header.d.ts +13 -0
  51. package/dist/types/_contracts/segmented.d.ts +22 -0
  52. package/dist/types/_contracts/select.d.ts +7 -0
  53. package/dist/types/_contracts/setting-row.d.ts +27 -0
  54. package/dist/types/_contracts/skeleton.d.ts +9 -0
  55. package/dist/types/_contracts/slider.d.ts +45 -0
  56. package/dist/types/_contracts/stat.d.ts +37 -0
  57. package/dist/types/_contracts/status-dot.d.ts +11 -0
  58. package/dist/types/_contracts/sticky.d.ts +14 -0
  59. package/dist/types/_contracts/switch.d.ts +10 -0
  60. package/dist/types/_contracts/table.d.ts +33 -0
  61. package/dist/types/_contracts/tabs.d.ts +23 -0
  62. package/dist/types/_contracts/textarea.d.ts +7 -0
  63. package/dist/types/_contracts/toast.d.ts +28 -0
  64. package/dist/types/_contracts/toggle-group.d.ts +19 -0
  65. package/dist/types/_contracts/usage-meter.d.ts +19 -0
  66. package/dist/types/_contracts/wizard-stepper.d.ts +21 -0
  67. package/dist/types/_contracts/workflow.d.ts +103 -0
  68. package/dist/types/_tokens/index.d.ts +423 -0
  69. package/dist/types/chart/Charts.d.ts +77 -0
  70. package/dist/types/chart/D3Chart.d.ts +11 -0
  71. package/dist/types/chart/SceneChart.d.ts +19 -0
  72. package/dist/types/chart/d3/cartesian.d.ts +4 -0
  73. package/dist/types/chart/d3/hierarchy.d.ts +3 -0
  74. package/dist/types/chart/d3/radial.d.ts +3 -0
  75. package/dist/types/chart/d3/relations.d.ts +3 -0
  76. package/dist/types/chart/d3/shared.d.ts +21 -0
  77. package/dist/types/chart/d3/styles.d.ts +10 -0
  78. package/dist/types/chart/d3/svg.d.ts +6 -0
  79. package/dist/types/chart/d3/types.d.ts +228 -0
  80. package/dist/types/chart/scales.d.ts +17 -0
  81. package/dist/types/chart/scene.d.ts +32 -0
  82. package/dist/types/chart/types.d.ts +92 -0
  83. package/dist/types/components/Accordion.d.ts +10 -0
  84. package/dist/types/components/ActivityItem.d.ts +7 -0
  85. package/dist/types/components/AlertDialog.d.ts +8 -0
  86. package/dist/types/components/ApprovalWorkbench.d.ts +11 -0
  87. package/dist/types/components/AspectRatio.d.ts +6 -0
  88. package/dist/types/components/Avatar.d.ts +9 -0
  89. package/dist/types/components/AvatarGroup.d.ts +9 -0
  90. package/dist/types/components/Badge.d.ts +7 -0
  91. package/dist/types/components/BillingCard.d.ts +6 -0
  92. package/dist/types/components/BrandLogo.d.ts +7 -0
  93. package/dist/types/components/Bubble.d.ts +6 -0
  94. package/dist/types/components/Button.d.ts +13 -0
  95. package/dist/types/components/ButtonGroup.d.ts +6 -0
  96. package/dist/types/components/Calendar.d.ts +17 -0
  97. package/dist/types/components/Callout.d.ts +7 -0
  98. package/dist/types/components/Card.d.ts +10 -0
  99. package/dist/types/components/Carousel.d.ts +11 -0
  100. package/dist/types/components/Checkbox.d.ts +10 -0
  101. package/dist/types/components/Chip.d.ts +9 -0
  102. package/dist/types/components/ChoiceCard.d.ts +14 -0
  103. package/dist/types/components/CodeBlock.d.ts +22 -0
  104. package/dist/types/components/Collapsible.d.ts +6 -0
  105. package/dist/types/components/Combobox.d.ts +32 -0
  106. package/dist/types/components/ConnectorCard.d.ts +6 -0
  107. package/dist/types/components/ContextMenu.d.ts +10 -0
  108. package/dist/types/components/Coverflow.d.ts +12 -0
  109. package/dist/types/components/DangerZone.d.ts +10 -0
  110. package/dist/types/components/DatePicker.d.ts +7 -0
  111. package/dist/types/components/Divider.d.ts +7 -0
  112. package/dist/types/components/Drawer.d.ts +23 -0
  113. package/dist/types/components/EmptyState.d.ts +6 -0
  114. package/dist/types/components/EventTimeline.d.ts +15 -0
  115. package/dist/types/components/Fab.d.ts +8 -0
  116. package/dist/types/components/FabMenu.d.ts +11 -0
  117. package/dist/types/components/Field.d.ts +24 -0
  118. package/dist/types/components/FileUpload.d.ts +37 -0
  119. package/dist/types/components/GeoAreaPicker.d.ts +17 -0
  120. package/dist/types/components/GoogleButton.d.ts +5 -0
  121. package/dist/types/components/GuidedTour.d.ts +15 -0
  122. package/dist/types/components/HelpField.d.ts +11 -0
  123. package/dist/types/components/HelpMenu.d.ts +7 -0
  124. package/dist/types/components/IconButton.d.ts +10 -0
  125. package/dist/types/components/Input.d.ts +9 -0
  126. package/dist/types/components/IntentComposer.d.ts +14 -0
  127. package/dist/types/components/Item.d.ts +6 -0
  128. package/dist/types/components/KanbanBoard.d.ts +15 -0
  129. package/dist/types/components/KanbanCard.d.ts +8 -0
  130. package/dist/types/components/Marker.d.ts +4 -0
  131. package/dist/types/components/Matrix2x2.d.ts +15 -0
  132. package/dist/types/components/Menu.d.ts +15 -0
  133. package/dist/types/components/Message.d.ts +14 -0
  134. package/dist/types/components/Modal.d.ts +9 -0
  135. package/dist/types/components/Multiselect.d.ts +18 -0
  136. package/dist/types/components/NavCard.d.ts +8 -0
  137. package/dist/types/components/NotificationBell.d.ts +11 -0
  138. package/dist/types/components/OAuthButton.d.ts +8 -0
  139. package/dist/types/components/Otp.d.ts +10 -0
  140. package/dist/types/components/PageHeader.d.ts +6 -0
  141. package/dist/types/components/Pagination.d.ts +8 -0
  142. package/dist/types/components/PersonCell.d.ts +6 -0
  143. package/dist/types/components/PhoneInput.d.ts +13 -0
  144. package/dist/types/components/PlanCard.d.ts +6 -0
  145. package/dist/types/components/Popover.d.ts +12 -0
  146. package/dist/types/components/PostalCodeInput.d.ts +12 -0
  147. package/dist/types/components/ProgressBar.d.ts +7 -0
  148. package/dist/types/components/PropertyActionGroup.d.ts +11 -0
  149. package/dist/types/components/PropertyCard.d.ts +15 -0
  150. package/dist/types/components/PropertyMedia.d.ts +15 -0
  151. package/dist/types/components/Questionnaire.d.ts +8 -0
  152. package/dist/types/components/RadioGroup.d.ts +7 -0
  153. package/dist/types/components/Range.d.ts +10 -0
  154. package/dist/types/components/ScoreGauge.d.ts +8 -0
  155. package/dist/types/components/ScrollArea.d.ts +9 -0
  156. package/dist/types/components/SectionHeader.d.ts +6 -0
  157. package/dist/types/components/Segmented.d.ts +10 -0
  158. package/dist/types/components/Select.d.ts +16 -0
  159. package/dist/types/components/SettingRow.d.ts +14 -0
  160. package/dist/types/components/SettingsSubnav.d.ts +12 -0
  161. package/dist/types/components/Skeleton.d.ts +6 -0
  162. package/dist/types/components/Slider.d.ts +9 -0
  163. package/dist/types/components/Snackbar.d.ts +6 -0
  164. package/dist/types/components/Spinner.d.ts +7 -0
  165. package/dist/types/components/SplitButton.d.ts +8 -0
  166. package/dist/types/components/Stat.d.ts +13 -0
  167. package/dist/types/components/StatusDot.d.ts +7 -0
  168. package/dist/types/components/Sticky.d.ts +15 -0
  169. package/dist/types/components/SwipeDeck.d.ts +18 -0
  170. package/dist/types/components/Switch.d.ts +10 -0
  171. package/dist/types/components/Table.d.ts +28 -0
  172. package/dist/types/components/Tabs.d.ts +7 -0
  173. package/dist/types/components/Textarea.d.ts +11 -0
  174. package/dist/types/components/Timeline.d.ts +18 -0
  175. package/dist/types/components/Toast.d.ts +20 -0
  176. package/dist/types/components/ToggleGroup.d.ts +7 -0
  177. package/dist/types/components/Tooltip.d.ts +9 -0
  178. package/dist/types/components/Trace.d.ts +11 -0
  179. package/dist/types/components/Track.d.ts +53 -0
  180. package/dist/types/components/UsageMeter.d.ts +12 -0
  181. package/dist/types/components/UserMenu.d.ts +11 -0
  182. package/dist/types/components/VisitSchedulePicker.d.ts +12 -0
  183. package/dist/types/components/VoiceRecorder.d.ts +13 -0
  184. package/dist/types/components/WizardStepper.d.ts +7 -0
  185. package/dist/types/components/WorkspaceSwitcher.d.ts +11 -0
  186. package/dist/types/components/providerIcons.d.ts +9 -0
  187. package/dist/types/hooks.d.ts +4 -0
  188. package/dist/types/icon.d.ts +14 -0
  189. package/dist/types/index.d.ts +114 -0
  190. package/dist/types/messages/en.d.ts +523 -0
  191. package/dist/types/overlay.d.ts +69 -0
  192. package/dist/types/primitives.d.ts +41 -0
  193. package/dist/types/theme.d.ts +37 -0
  194. package/package.json +109 -4
@@ -0,0 +1,118 @@
1
+ import type { ReactNode } from "react";
2
+ export type PopoverSide = "top" | "bottom" | "left" | "right";
3
+ export type PopoverAlign = "start" | "center" | "end";
4
+ /** Props for the Popover component. */
5
+ export interface PopoverCoreProps {
6
+ open: boolean;
7
+ onOpenChange: (open: boolean) => void;
8
+ content: ReactNode;
9
+ children: ReactNode;
10
+ side?: PopoverSide;
11
+ align?: PopoverAlign;
12
+ /** Nome acessível do painel. */
13
+ label?: string;
14
+ }
15
+ /** Props for the Tooltip component. `shortcut`, `delayMs` e `portalled` são de teclado e mouse e ficam só na web. */
16
+ export interface TooltipCoreProps {
17
+ label: string;
18
+ description?: string;
19
+ side?: "top" | "bottom" | "left" | "right";
20
+ open?: boolean;
21
+ defaultOpen?: boolean;
22
+ onOpenChange?: (open: boolean) => void;
23
+ children: ReactNode;
24
+ }
25
+ export type MenuEntry = {
26
+ type?: "item";
27
+ id: string;
28
+ label: ReactNode;
29
+ icon?: ReactNode;
30
+ shortcut?: string;
31
+ meta?: ReactNode;
32
+ danger?: boolean;
33
+ disabled?: boolean;
34
+ onSelect?: () => void;
35
+ } | {
36
+ type: "separator";
37
+ } | {
38
+ type: "label";
39
+ label: ReactNode;
40
+ };
41
+ /** Props for the Menu component. */
42
+ export interface MenuCoreProps {
43
+ /** Ponto da tela onde o menu abre (menu de contexto). */
44
+ anchorPoint?: {
45
+ x: number;
46
+ y: number;
47
+ };
48
+ /** Menu com a largura do gatilho. */
49
+ matchWidth?: boolean;
50
+ open: boolean;
51
+ onOpenChange: (open: boolean) => void;
52
+ entries: MenuEntry[];
53
+ onSelect?: (id: string) => void;
54
+ children: ReactNode;
55
+ align?: "start" | "end";
56
+ side?: "top" | "bottom";
57
+ ariaLabel?: string;
58
+ }
59
+ /** Props for the ContextMenu component. */
60
+ export interface ContextMenuCoreProps {
61
+ children: ReactNode;
62
+ entries: MenuEntry[];
63
+ label?: string;
64
+ onSelect?: (id: string) => void;
65
+ }
66
+ /** Props for the Snackbar component. */
67
+ export interface SnackbarCoreProps {
68
+ children: ReactNode;
69
+ action?: {
70
+ label: string;
71
+ onClick: () => void;
72
+ };
73
+ }
74
+ export interface SplitButtonOption {
75
+ id?: string;
76
+ label: string;
77
+ hint?: string;
78
+ disabled?: boolean;
79
+ danger?: boolean;
80
+ onSelect?: () => void;
81
+ }
82
+ export type SplitButtonVariant = "primary" | "secondary";
83
+ /** Props for the SplitButton component. */
84
+ export interface SplitButtonCoreProps {
85
+ label: string;
86
+ variant?: SplitButtonVariant;
87
+ menuAlign?: "start" | "end";
88
+ leadingIcon?: ReactNode;
89
+ onClick?: () => void;
90
+ onSelect?: (id: string) => void;
91
+ options: SplitButtonOption[];
92
+ size?: "sm" | "md";
93
+ disabled?: boolean;
94
+ loading?: boolean;
95
+ loadingLabel?: ReactNode;
96
+ open?: boolean;
97
+ defaultOpen?: boolean;
98
+ onOpenChange?: (open: boolean) => void;
99
+ defaultOptionId?: string;
100
+ }
101
+ export interface FabMenuAction {
102
+ id: string;
103
+ label: string;
104
+ icon?: ReactNode;
105
+ disabled?: boolean;
106
+ danger?: boolean;
107
+ onSelect?: () => void;
108
+ }
109
+ /** Props for the FabMenu component. */
110
+ export interface FabMenuCoreProps {
111
+ actions: FabMenuAction[];
112
+ label?: string;
113
+ open?: boolean;
114
+ defaultOpen?: boolean;
115
+ onOpenChange?: (open: boolean) => void;
116
+ onSelect?: (id: string) => void;
117
+ align?: "start" | "end";
118
+ }
@@ -0,0 +1,14 @@
1
+ import type { ReactNode } from "react";
2
+ /** Props for the PageHeader page hero. */
3
+ export interface PageHeaderCoreProps {
4
+ /** Eyebrow mono uppercase acima do título (ex.: "Workspace · Equipe Exemplo"). */
5
+ eyebrow?: ReactNode;
6
+ /** Título da página (vira o `<h1>` — só existe um por página). */
7
+ title: ReactNode;
8
+ /** Lead/descrição sob o título (máx. 62ch, cor secundária). */
9
+ lead?: ReactNode;
10
+ /** Ações à direita (`Button`/`SplitButton`), alinhadas à base do bloco de texto. */
11
+ actions?: ReactNode;
12
+ /** Slot de trilha acima do eyebrow — passe o átomo `Breadcrumb`. Regra do PO: breadcrumb sempre com volta ao pai. */
13
+ breadcrumb?: ReactNode;
14
+ }
@@ -0,0 +1,10 @@
1
+ /** Props for the Pagination control. */
2
+ export interface PaginationCoreProps {
3
+ /** Página atual (começa em 1, controlada). */
4
+ page: number;
5
+ /** Total de páginas. */
6
+ pageCount: number;
7
+ onPageChange: (page: number) => void;
8
+ /** Vizinhos visíveis de cada lado da página atual. Padrão 1. */
9
+ siblingCount?: number;
10
+ }
@@ -0,0 +1,9 @@
1
+ import type { ReactNode } from "react";
2
+ /** Props for the PersonCell component. */
3
+ export interface PersonCellCoreProps {
4
+ avatar?: ReactNode;
5
+ name: ReactNode;
6
+ tag?: ReactNode;
7
+ secondary?: ReactNode;
8
+ size?: "sm" | "md";
9
+ }
@@ -0,0 +1,19 @@
1
+ export type ProgressTone = "primary" | "neutral" | "warn" | "critical";
2
+ /** Props for the ProgressBar component. */
3
+ export interface ProgressBarCoreProps {
4
+ /** 0–100. Ignorado (e opcional) quando `indeterminate`. */
5
+ value?: number;
6
+ /**
7
+ * Cor do preenchimento. `neutral` (tinta/ink) é o tom das barras de cota
8
+ * das telas de settings — informativo, sem julgamento de estado.
9
+ */
10
+ tone?: ProgressTone;
11
+ /** Altura da trilha. */
12
+ size?: "sm" | "md";
13
+ /**
14
+ * Carregando sem progresso conhecido: o preenchimento desliza em loop.
15
+ * Expõe `aria-busy` e omite `aria-valuenow`. Com `prefers-reduced-motion`
16
+ * a animação para (trilha preenchida a meia opacidade).
17
+ */
18
+ indeterminate?: boolean;
19
+ }
@@ -0,0 +1,15 @@
1
+ export interface RadioOption {
2
+ value: string;
3
+ label: string;
4
+ hint?: string;
5
+ disabled?: boolean;
6
+ }
7
+ /** Props for the RadioGroup control. */
8
+ export interface RadioGroupCoreProps {
9
+ options: RadioOption[];
10
+ value?: string;
11
+ defaultValue?: string;
12
+ onChange?: (value: string) => void;
13
+ /** Rótulo mono em caixa alta acima do grupo. */
14
+ label?: string;
15
+ }
@@ -0,0 +1,15 @@
1
+ import type { ReactNode } from "react";
2
+ export type ScoreGaugeSize = "sm" | "md" | "lg";
3
+ export type ScoreBand = "ok" | "warn" | "critical";
4
+ /** Props for the ScoreGauge component. */
5
+ export interface ScoreGaugeCoreProps {
6
+ /** 0 a 100. */
7
+ value: number;
8
+ label?: ReactNode;
9
+ size?: ScoreGaugeSize;
10
+ /** A partir daqui a faixa é boa. Padrão 70. */
11
+ okAt?: number;
12
+ /** A partir daqui a faixa é aviso; abaixo, crítica. Padrão 40. */
13
+ warnAt?: number;
14
+ formatValue?: (value: number) => ReactNode;
15
+ }
@@ -0,0 +1,3 @@
1
+ export interface ScrollAreaCoreProps {
2
+ maxHeight?: number | string;
3
+ }
@@ -0,0 +1,13 @@
1
+ import type { ReactNode } from "react";
2
+ /** Props for the SectionHeader section title. */
3
+ export interface SectionHeaderCoreProps {
4
+ title: ReactNode;
5
+ /** Descrição sob o título. */
6
+ sub?: ReactNode;
7
+ /** Contador da seção, num Badge neutro. */
8
+ count?: ReactNode;
9
+ /** Ação à direita. */
10
+ action?: ReactNode;
11
+ /** Título compacto em caixa alta com régua até a borda. */
12
+ rule?: boolean;
13
+ }
@@ -0,0 +1,22 @@
1
+ import type { ReactNode } from "react";
2
+ export interface SegmentedOption {
3
+ value: string;
4
+ label: ReactNode;
5
+ icon?: ReactNode;
6
+ disabled?: boolean;
7
+ }
8
+ /** Props for the single-select segmented control. */
9
+ export interface SegmentedCoreProps {
10
+ options: SegmentedOption[];
11
+ /** Valor selecionado (controlado). */
12
+ value?: string;
13
+ /** Seleção inicial (não-controlado). Padrão: primeira opção. */
14
+ defaultValue?: string;
15
+ onChange?: (value: string) => void;
16
+ /** Rótulo acessível do grupo. */
17
+ label?: string;
18
+ disabled?: boolean;
19
+ sliding?: boolean;
20
+ /** Só ícones; rótulos textuais viram nomes acessíveis e tooltips. */
21
+ iconOnly?: boolean;
22
+ }
@@ -0,0 +1,7 @@
1
+ /** Props for the Select field. */
2
+ export interface SelectCoreProps {
3
+ label?: string;
4
+ hint?: string;
5
+ error?: string;
6
+ block?: boolean;
7
+ }
@@ -0,0 +1,27 @@
1
+ import type { ReactNode } from "react";
2
+ /** Props for the SettingRow list/settings line. */
3
+ export interface SettingRowCoreProps {
4
+ /** Título da linha. Cabem `Badge`/`Chip` inline (ex.: status "Conectado"). */
5
+ title: ReactNode;
6
+ /** Descrição em texto corrido sob o título. */
7
+ description?: ReactNode;
8
+ /** Meta mono sob a descrição (e-mail, IP, data, chave mascarada…). */
9
+ meta?: ReactNode;
10
+ /** Slot inicial — ícone ou `Avatar`. */
11
+ leading?: ReactNode;
12
+ /** Moldura 36px em volta do `leading` (padrão `.oauth-icon` — logos de provedor/bandeira). */
13
+ leadingFrame?: boolean;
14
+ /** Ações à direita (`Button`/`IconButton`/`Badge`/texto mono). Em linha clicável use só conteúdo NÃO interativo. */
15
+ actions?: ReactNode;
16
+ /** Desabilita a linha clicável (sem clique, sem foco por Tab no link). */
17
+ disabled?: boolean;
18
+ /** Chevron ">" à direita nas linhas clicáveis. Padrão `true`. */
19
+ showChevron?: boolean;
20
+ }
21
+ /** Props for the SettingRowGroup list wrapper. */
22
+ export interface SettingRowGroupCoreProps {
23
+ /** `SettingRow`s (ou qualquer linha) — cada filho vira um `listitem` com divisor. */
24
+ children: ReactNode;
25
+ /** Rótulo acessível da lista (ex.: "Sessões ativas"). */
26
+ "aria-label"?: string;
27
+ }
@@ -0,0 +1,9 @@
1
+ /** Props for the Skeleton loading placeholder. */
2
+ export interface SkeletonCoreProps {
3
+ /** Largura (número = px). Padrão 100%. */
4
+ width?: number | string;
5
+ /** Altura (número = px). Padrão 14px (linha de texto). */
6
+ height?: number | string;
7
+ /** Círculo (avatar). Usa `width` como diâmetro. */
8
+ circle?: boolean;
9
+ }
@@ -0,0 +1,45 @@
1
+ /** Props for the Slider control. */
2
+ export interface SliderCoreProps {
3
+ min?: number;
4
+ max?: number;
5
+ /** Incremento por passo. Padrão 1. */
6
+ step?: number;
7
+ value?: number;
8
+ defaultValue?: number;
9
+ onChange?: (value: number) => void;
10
+ /** Nome do controle, exibido acima da trilha. */
11
+ label?: string;
12
+ /** Mantém `label` como nome acessível sem exibi-lo. */
13
+ hideLabel?: boolean;
14
+ /** Formata o valor no mostrador e no texto lido pelo leitor de tela. */
15
+ formatValue?: (value: number) => string;
16
+ /** Pílula mono com o valor atual. */
17
+ showValue?: boolean;
18
+ /** Legendas nas extremidades da trilha. */
19
+ ticks?: [string, string];
20
+ /** Slider discreto: um rótulo por passo. */
21
+ marks?: string[];
22
+ disabled?: boolean;
23
+ }
24
+ /** Intervalo selecionado: [mínimo, máximo]. */
25
+ export type RangeValue = [number, number];
26
+ /** Props for the dual-value range slider. */
27
+ export interface RangeCoreProps {
28
+ min?: number;
29
+ max?: number;
30
+ step?: number;
31
+ value?: RangeValue;
32
+ defaultValue?: RangeValue;
33
+ onChange?: (value: RangeValue) => void;
34
+ label?: string;
35
+ formatValue?: (value: number) => string;
36
+ /** Pílula mono "lo — hi". Padrão `true`. */
37
+ showValue?: boolean;
38
+ /** Fixa o mínimo e expõe só o controle do máximo. */
39
+ fixedMinimum?: boolean;
40
+ /** Legendas distribuídas sob a trilha. */
41
+ ticks?: string[];
42
+ /** Mini-distribuição acima da trilha; barras dentro do intervalo acendem. */
43
+ histogram?: number[];
44
+ disabled?: boolean;
45
+ }
@@ -0,0 +1,37 @@
1
+ import type { ReactNode } from "react";
2
+ export type StatSize = "sm" | "md" | "lg";
3
+ export type StatTrend = "up" | "down";
4
+ export type StatDeltaSentiment = "positive" | "negative" | "neutral";
5
+ /** Delta/variação exibida ao lado do valor. */
6
+ export interface StatDelta {
7
+ /** Texto do delta. Ex.: "+12%" ou "-3 pts". */
8
+ value: ReactNode;
9
+ /** Direção da seta. */
10
+ trend: StatTrend;
11
+ /**
12
+ * Cor semântica. Padrão derivado da direção: up → positive, down → negative.
13
+ * Use "neutral" (ou inverta) quando subir NÃO é bom (ex.: custo).
14
+ */
15
+ sentiment?: StatDeltaSentiment;
16
+ }
17
+ /** Props for the Stat component. */
18
+ export interface StatCoreProps {
19
+ /** Rótulo mono uppercase acima do número. Ex.: "Rate limit". */
20
+ label: ReactNode;
21
+ /** Valor principal (número grande tabular). Ex.: "3.700" ou "60 req/min". */
22
+ value: ReactNode;
23
+ /** Sufixo menor ao lado do valor. Ex.: "créditos", "/ 2.500". */
24
+ unit?: ReactNode;
25
+ /** Linha secundária sob o valor. Ex.: "por API key, 429 após exceder". */
26
+ description?: ReactNode;
27
+ /** Variação com seta up/down e cor semântica. */
28
+ delta?: StatDelta;
29
+ /** Slot de mini-gráfico (ex.: `<Sparkline />` do Charts) sob o conteúdo. */
30
+ chart?: ReactNode;
31
+ /** Escala do valor (padrão: "md"). */
32
+ size?: StatSize;
33
+ }
34
+ /** Props for the StatGroup grid wrapper. */
35
+ export interface StatGroupCoreProps {
36
+ children: ReactNode;
37
+ }
@@ -0,0 +1,11 @@
1
+ import type { ReactNode } from "react";
2
+ export type StatusDotTone = "good" | "ok" | "warn" | "critical" | "info" | "neutral";
3
+ /** Props for the StatusDot indicator. */
4
+ export interface StatusDotCoreProps {
5
+ /** Tom semântico do estado. Default `good`. */
6
+ tone?: StatusDotTone;
7
+ /** Pulso "ao vivo" (halo animado). Desligado com movimento reduzido. */
8
+ pulse?: boolean;
9
+ /** Rótulo mono em caixa alta à direita do ponto. */
10
+ children?: ReactNode;
11
+ }
@@ -0,0 +1,14 @@
1
+ import type { ReactNode } from "react";
2
+ /** Props for the StickyBar component. */
3
+ export interface StickyBarCoreProps {
4
+ title: ReactNode;
5
+ meta?: ReactNode;
6
+ status?: ReactNode;
7
+ actions?: ReactNode;
8
+ visible?: boolean;
9
+ }
10
+ /** Props for the StickyFooter component. */
11
+ export interface StickyFooterCoreProps {
12
+ start?: ReactNode;
13
+ children?: ReactNode;
14
+ }
@@ -0,0 +1,10 @@
1
+ import type { ReactNode } from "react";
2
+ /** Props for the Switch control. */
3
+ export interface SwitchCoreProps {
4
+ label?: ReactNode;
5
+ icon?: ReactNode;
6
+ appearance?: "plain" | "control";
7
+ checked?: boolean;
8
+ defaultChecked?: boolean;
9
+ disabled?: boolean;
10
+ }
@@ -0,0 +1,33 @@
1
+ import type { ReactNode } from "react";
2
+ export interface TableColumnCore<Row> {
3
+ key: string;
4
+ header: ReactNode;
5
+ cell: (row: Row) => ReactNode;
6
+ align?: "left" | "right" | "num";
7
+ sortable?: boolean;
8
+ sortValue?: (row: Row) => string | number | null;
9
+ filterable?: boolean;
10
+ filterValue?: (row: Row) => string | string[];
11
+ }
12
+ export interface TablePagination {
13
+ pageSize: number;
14
+ pageSizeOptions?: number[];
15
+ page?: number;
16
+ defaultPage?: number;
17
+ onPageChange?: (page: number) => void;
18
+ }
19
+ /** Props for the Table component, sem `columns` (tipo da coluna muda em `width`). */
20
+ export interface TableCoreProps<Row> {
21
+ rows: Row[];
22
+ rowKey: (row: Row, index: number) => string;
23
+ onRowClick?: (row: Row) => void;
24
+ rowLabel?: (row: Row) => string;
25
+ caption?: string;
26
+ empty?: ReactNode;
27
+ searchable?: boolean;
28
+ searchPlaceholder?: string;
29
+ searchMatch?: (row: Row, query: string) => boolean;
30
+ loading?: boolean;
31
+ error?: ReactNode;
32
+ pagination?: TablePagination;
33
+ }
@@ -0,0 +1,23 @@
1
+ import type { ReactNode } from "react";
2
+ export interface TabItem {
3
+ id: string;
4
+ label: string;
5
+ badge?: string | number;
6
+ /** Estado da parte representada pela aba. */
7
+ status?: "complete" | "warning";
8
+ content?: ReactNode;
9
+ disabled?: boolean;
10
+ }
11
+ /** Props for the Tabs component. */
12
+ export interface TabsCoreProps {
13
+ items: TabItem[];
14
+ /** Aba ativa controlada. */
15
+ value?: string;
16
+ defaultValue?: string;
17
+ onChange?: (id: string) => void;
18
+ /** underline (padrão) ou pill. */
19
+ variant?: "underline" | "pill";
20
+ orientation?: "horizontal" | "vertical";
21
+ /** Permite quebrar as abas em linhas quando não há largura suficiente. */
22
+ wrap?: boolean;
23
+ }
@@ -0,0 +1,7 @@
1
+ /** Props for the Textarea field. */
2
+ export interface TextareaCoreProps {
3
+ label?: string;
4
+ hint?: string;
5
+ error?: string;
6
+ block?: boolean;
7
+ }
@@ -0,0 +1,28 @@
1
+ export type ToastTone = "default" | "success" | "danger";
2
+ /** Dados de um toast na pilha. */
3
+ export interface ToastData {
4
+ id: string;
5
+ title: string;
6
+ description?: string;
7
+ tone?: ToastTone;
8
+ /** Ação inline (ex.: Desfazer). */
9
+ action?: {
10
+ label: string;
11
+ onClick: () => void;
12
+ };
13
+ /** ms até auto-dispensar. `null` = fica até fechar. Padrão 5000. */
14
+ duration?: number | null;
15
+ }
16
+ /** Props for a single Toast notification. */
17
+ export interface ToastCoreProps extends ToastData {
18
+ onDismiss?: (id: string) => void;
19
+ }
20
+ /** Props for the ToastRegion stack. */
21
+ export interface ToastRegionCoreProps {
22
+ /** Pilha de toasts (controlada — o app é dono da lista). */
23
+ toasts: ToastData[];
24
+ /** Remove um toast da lista (auto-dismiss, ×, ou após a ação). */
25
+ onDismiss: (id: string) => void;
26
+ /** Canto da tela. Padrão `bottom-right`. */
27
+ position?: "bottom-right" | "bottom-left" | "top-right";
28
+ }
@@ -0,0 +1,19 @@
1
+ import type { ReactNode } from "react";
2
+ export interface ToggleOption {
3
+ value: string;
4
+ label: ReactNode;
5
+ icon?: ReactNode;
6
+ disabled?: boolean;
7
+ }
8
+ /** Props for the multi-select ToggleGroup. */
9
+ export interface ToggleGroupCoreProps {
10
+ options: ToggleOption[];
11
+ /** Valores ligados (controlado). */
12
+ value?: string[];
13
+ /** Estado inicial (não-controlado). */
14
+ defaultValue?: string[];
15
+ onChange?: (values: string[]) => void;
16
+ /** Rótulo acessível do grupo. */
17
+ label?: string;
18
+ disabled?: boolean;
19
+ }
@@ -0,0 +1,19 @@
1
+ import type { ReactNode } from "react";
2
+ /** Props for the UsageMeter component. */
3
+ export interface UsageMeterCoreProps {
4
+ label: ReactNode;
5
+ used: number;
6
+ limit: number;
7
+ unit?: ReactNode;
8
+ meta?: ReactNode;
9
+ formatValue?: (value: number) => string;
10
+ /** Percentual a partir do qual o tom vira aviso. Padrão 80. */
11
+ warnAt?: number;
12
+ /** Percentual a partir do qual o tom vira crítico. Padrão 100. */
13
+ criticalAt?: number;
14
+ size?: "sm" | "md";
15
+ }
16
+ /** Props for the UsageMeterGroup list. */
17
+ export interface UsageMeterGroupCoreProps {
18
+ children: ReactNode;
19
+ }
@@ -0,0 +1,21 @@
1
+ export interface WizardStep {
2
+ id: string;
3
+ label: string;
4
+ /** Impede retorno/navegação direta para esta etapa. */
5
+ disabled?: boolean;
6
+ }
7
+ export interface WizardStepperCoreProps {
8
+ steps: WizardStep[];
9
+ /** ID da etapa atual. */
10
+ current: string;
11
+ /** Título da jornada, anunciado junto do progresso. */
12
+ label?: string;
13
+ /** `auto` fica compacto por container query; as outras opções forçam o layout. */
14
+ variant?: "auto" | "horizontal" | "compact";
15
+ /** Por padrão só etapas concluídas e a atual podem ser abertas. */
16
+ allowFutureNavigation?: boolean;
17
+ onStepChange?: (id: string) => void;
18
+ /** Ação de retorno; usa o IconButton canônico. */
19
+ onBack?: () => void;
20
+ backLabel?: string;
21
+ }