@plenustech/design-system 0.2.3 → 0.2.4

package/dist/index.js

@@ -1,193 +1,203 @@
 /* empty css                  */
 /* empty css                */
-import { Accordion as n } from "./components/data-display/Accordion/Accordion.js";
-import { Alert as p } from "./components/feedback/Alert/Alert.js";
+import { Accordion as m } from "./components/data-display/Accordion/Accordion.js";
+import { Alert as a } from "./components/feedback/Alert/Alert.js";
 import { Avatar as f } from "./components/data-display/Avatar/Avatar.js";
 import { Badge as c } from "./components/data-display/Badge/Badge.js";
 import { Breadcrumb as l } from "./components/navigation/Breadcrumb/Breadcrumb.js";
 import { Button as C } from "./components/actions/Button/Button.js";
 import { ButtonIcon as s } from "./components/actions/ButtonIcon/ButtonIcon.js";
 import { ButtonTile as d } from "./components/actions/ButtonTile/ButtonTile.js";
-import { Card as k } from "./components/data-display/Card/Card.js";
-import { ChartArea as S } from "./components/charts/ChartArea/ChartArea.js";
+import { Card as g } from "./components/data-display/Card/Card.js";
+import { ChartArea as b } from "./components/charts/ChartArea/ChartArea.js";
 import { ChartBar as P } from "./components/charts/ChartBar/ChartBar.js";
-import { ChartCombo as D } from "./components/charts/ChartCombo/ChartCombo.js";
-import { ChartDonut as L } from "./components/charts/ChartDonut/ChartDonut.js";
-import { ChartLine as w } from "./components/charts/ChartLine/ChartLine.js";
-import { ChartPie as E } from "./components/charts/ChartPie/ChartPie.js";
-import { ChartRadial as U } from "./components/charts/ChartRadial/ChartRadial.js";
-import { ChartSankey as F } from "./components/charts/ChartSankey/ChartSankey.js";
-import { ChartScatter as H } from "./components/charts/ChartScatter/ChartScatter.js";
-import { ChartSunburst as W } from "./components/charts/ChartSunburst/ChartSunburst.js";
-import { ChartTooltip as Q } from "./components/charts/ChartTooltip/ChartTooltip.js";
-import { ChartTreemap as z } from "./components/charts/ChartTreemap/ChartTreemap.js";
-import { ChartWaterfall as K } from "./components/charts/ChartWaterfall/ChartWaterfall.js";
-import { Checkbox as V } from "./components/forms/Checkbox/Checkbox.js";
-import { CheckboxGroup as Y } from "./components/forms/CheckboxGroup/CheckboxGroup.js";
-import { CodeBlock as _ } from "./components/data-display/CodeBlock/CodeBlock.js";
-import { ColorPicker as oo } from "./components/forms/ColorPicker/ColorPicker.js";
-import { ComboBox as eo } from "./components/forms/ComboBox/ComboBox.js";
-import { DatePicker as no } from "./components/forms/DatePicker/DatePicker.js";
-import { DateTimePicker as po } from "./components/forms/DateTimePicker/DateTimePicker.js";
-import { Dialog as fo } from "./components/overlays/Dialog/Dialog.js";
-import { Drawer as co } from "./components/overlays/Drawer/Drawer.js";
-import { EmptyState as lo } from "./components/feedback/EmptyState/EmptyState.js";
-import { Field as Co } from "./components/forms/Field/Field.js";
-import { FileUpload as so } from "./components/forms/FileUpload/FileUpload.js";
-import { IconAlignCenter as To, IconAlignLeft as ko, IconAlignRight as go, IconArrowDown as So, IconArrowUp as bo, IconBold as Po, IconCalendar as Ao, IconChartBar as Do, IconCheck as Bo, IconCheckCircle as Lo, IconChevronDown as vo, IconChevronExpand as wo, IconChevronLeft as Ro, IconChevronRight as Eo, IconChevronUp as Mo, IconClock as Uo, IconClose as yo, IconDesktop as Fo, IconDragHandle as Go, IconExclamationCircle as Ho, IconExclamationTriangle as No, IconExternalLink as Wo, IconEye as qo, IconFile as Qo, IconFilter as jo, IconInfoCircle as zo, IconItalic as Jo, IconLightning as Ko, IconLink as Oo, IconMinusCircle as Vo, IconMobile as Xo, IconMore as Yo, IconPencil as Zo, IconPlus as _o, IconPlusCircle as $o, IconQuestionCircle as or, IconRedo as rr, IconSearch as er, IconSidebar as tr, IconStructure as nr, IconTablet as mr, IconTrash as pr, IconUndo as ar, IconUpload as fr } from "./components/icons/icons.js";
-import { InputCurrency as cr } from "./components/forms/InputCurrency/InputCurrency.js";
-import { InputNumber as lr } from "./components/forms/InputNumber/InputNumber.js";
-import { InputPassword as Cr } from "./components/forms/InputPassword/InputPassword.js";
-import { InputText as sr } from "./components/forms/InputText/InputText.js";
-import { Label as dr } from "./components/forms/Label/Label.js";
-import { List as kr } from "./components/data-display/List/List.js";
-import { Menu as Sr } from "./components/overlays/Menu/Menu.js";
-import { Pagination as Pr } from "./components/navigation/Pagination/Pagination.js";
-import { Popover as Dr } from "./components/overlays/Popover/Popover.js";
-import { Progress as Lr } from "./components/feedback/Progress/Progress.js";
-import { Radio as wr } from "./components/forms/RadioGroup/Radio.js";
-import { RadioGroup as Er } from "./components/forms/RadioGroup/RadioGroup.js";
-import { SegmentedControl as Ur } from "./components/forms/SegmentedControl/SegmentedControl.js";
-import { Select as Fr } from "./components/forms/Select/Select.js";
-import { Skeleton as Hr } from "./components/feedback/Skeleton/Skeleton.js";
-import { SkipLink as Wr } from "./components/navigation/SkipLink/SkipLink.js";
-import { SortableList as Qr } from "./components/data-display/SortableList/SortableList.js";
-import { Spinner as zr } from "./components/feedback/Spinner/Spinner.js";
-import { Steps as Kr } from "./components/navigation/Steps/Steps.js";
-import { Switch as Vr } from "./components/forms/Switch/Switch.js";
-import { Table as Yr } from "./components/data-display/Table/Table.js";
-import { Tabs as _r } from "./components/navigation/Tabs/Tabs.js";
-import { Tag as oe } from "./components/data-display/Tag/Tag.js";
-import { Textarea as ee } from "./components/forms/Textarea/Textarea.js";
-import { TimePicker as ne } from "./components/forms/TimePicker/TimePicker.js";
-import { Timeline as pe } from "./components/data-display/Timeline/Timeline.js";
-import { ToastRegion as fe } from "./components/feedback/Toast/ToastRegion.js";
-import { Toolbar as ce } from "./components/actions/Toolbar/Toolbar.js";
-import { Tooltip as le } from "./components/overlays/Tooltip/Tooltip.js";
-import { dismissToast as Ce, showToast as he } from "./components/feedback/Toast/toastStore.js";
-import { formatarData as ue, formatarHora as de } from "./utils/formatters/formatarData.js";
-import { formatarMoeda as ke, formatarNumero as ge, formatarPercentual as Se } from "./utils/formatters/formatarNumero.js";
-import { formatarTamanhoDeArquivo as Pe } from "./utils/formatters/formatarTamanhoDeArquivo.js";
-import { paletteWithAccent as De, seriesColors as Be } from "./components/charts/palette/palette.js";
-import { resolveSeriesColors as ve } from "./components/charts/palette/seriesColor.js";
+import { ChartCombo as A } from "./components/charts/ChartCombo/ChartCombo.js";
+import { ChartDonut as B } from "./components/charts/ChartDonut/ChartDonut.js";
+import { ChartGauge as w } from "./components/charts/ChartGauge/ChartGauge.js";
+import { ChartLine as E } from "./components/charts/ChartLine/ChartLine.js";
+import { ChartMap as U } from "./components/charts/ChartMap/ChartMap.js";
+import { ChartPie as F } from "./components/charts/ChartPie/ChartPie.js";
+import { ChartRadial as N } from "./components/charts/ChartRadial/ChartRadial.js";
+import { ChartSankey as W } from "./components/charts/ChartSankey/ChartSankey.js";
+import { ChartScatter as Q } from "./components/charts/ChartScatter/ChartScatter.js";
+import { ChartSunburst as z } from "./components/charts/ChartSunburst/ChartSunburst.js";
+import { ChartTimeline as K } from "./components/charts/ChartTimeline/ChartTimeline.js";
+import { ChartTooltip as V } from "./components/charts/ChartTooltip/ChartTooltip.js";
+import { ChartTreemap as Y } from "./components/charts/ChartTreemap/ChartTreemap.js";
+import { ChartWaterfall as _ } from "./components/charts/ChartWaterfall/ChartWaterfall.js";
+import { Checkbox as oo } from "./components/forms/Checkbox/Checkbox.js";
+import { CheckboxGroup as eo } from "./components/forms/CheckboxGroup/CheckboxGroup.js";
+import { CodeBlock as mo } from "./components/data-display/CodeBlock/CodeBlock.js";
+import { ColorPicker as ao } from "./components/forms/ColorPicker/ColorPicker.js";
+import { ComboBox as fo } from "./components/forms/ComboBox/ComboBox.js";
+import { DatePicker as co } from "./components/forms/DatePicker/DatePicker.js";
+import { DateTimePicker as lo } from "./components/forms/DateTimePicker/DateTimePicker.js";
+import { Dialog as Co } from "./components/overlays/Dialog/Dialog.js";
+import { Drawer as so } from "./components/overlays/Drawer/Drawer.js";
+import { EmptyState as To } from "./components/feedback/EmptyState/EmptyState.js";
+import { Field as ko } from "./components/forms/Field/Field.js";
+import { FileUpload as So } from "./components/forms/FileUpload/FileUpload.js";
+import { IconAlignCenter as Do, IconAlignLeft as Ao, IconAlignRight as vo, IconArrowDown as Bo, IconArrowUp as Lo, IconBold as wo, IconCalendar as Ro, IconChartBar as Eo, IconCheck as Mo, IconCheckCircle as Uo, IconChevronDown as yo, IconChevronExpand as Fo, IconChevronLeft as Go, IconChevronRight as No, IconChevronUp as Ho, IconClock as Wo, IconClose as qo, IconDesktop as Qo, IconDragHandle as jo, IconExclamationCircle as zo, IconExclamationTriangle as Jo, IconExternalLink as Ko, IconEye as Oo, IconFile as Vo, IconFilter as Xo, IconInfoCircle as Yo, IconItalic as Zo, IconLightning as _o, IconLink as $o, IconMinusCircle as or, IconMobile as rr, IconMore as er, IconPencil as tr, IconPlus as mr, IconPlusCircle as nr, IconQuestionCircle as ar, IconRedo as pr, IconSearch as fr, IconSidebar as xr, IconStructure as cr, IconTablet as ir, IconTrash as lr, IconUndo as Ir, IconUpload as Cr } from "./components/icons/icons.js";
+import { InputCurrency as sr } from "./components/forms/InputCurrency/InputCurrency.js";
+import { InputNumber as dr } from "./components/forms/InputNumber/InputNumber.js";
+import { InputPassword as gr } from "./components/forms/InputPassword/InputPassword.js";
+import { InputText as br } from "./components/forms/InputText/InputText.js";
+import { Label as Pr } from "./components/forms/Label/Label.js";
+import { List as Ar } from "./components/data-display/List/List.js";
+import { Menu as Br } from "./components/overlays/Menu/Menu.js";
+import { Pagination as wr } from "./components/navigation/Pagination/Pagination.js";
+import { Popover as Er } from "./components/overlays/Popover/Popover.js";
+import { Progress as Ur } from "./components/feedback/Progress/Progress.js";
+import { Radio as Fr } from "./components/forms/RadioGroup/Radio.js";
+import { RadioGroup as Nr } from "./components/forms/RadioGroup/RadioGroup.js";
+import { SegmentedControl as Wr } from "./components/forms/SegmentedControl/SegmentedControl.js";
+import { Select as Qr } from "./components/forms/Select/Select.js";
+import { Skeleton as zr } from "./components/feedback/Skeleton/Skeleton.js";
+import { SkipLink as Kr } from "./components/navigation/SkipLink/SkipLink.js";
+import { SortableList as Vr } from "./components/data-display/SortableList/SortableList.js";
+import { Spinner as Yr } from "./components/feedback/Spinner/Spinner.js";
+import { Steps as _r } from "./components/navigation/Steps/Steps.js";
+import { Switch as oe } from "./components/forms/Switch/Switch.js";
+import { Table as ee } from "./components/data-display/Table/Table.js";
+import { Tabs as me } from "./components/navigation/Tabs/Tabs.js";
+import { TabsNav as ae } from "./components/navigation/TabsNav/TabsNav.js";
+import { Tag as fe } from "./components/data-display/Tag/Tag.js";
+import { Textarea as ce } from "./components/forms/Textarea/Textarea.js";
+import { TimePicker as le } from "./components/forms/TimePicker/TimePicker.js";
+import { Timeline as Ce } from "./components/data-display/Timeline/Timeline.js";
+import { ToastRegion as se } from "./components/feedback/Toast/ToastRegion.js";
+import { Toolbar as de } from "./components/actions/Toolbar/Toolbar.js";
+import { Tooltip as ge } from "./components/overlays/Tooltip/Tooltip.js";
+import { dismissToast as be, showToast as Se } from "./components/feedback/Toast/toastStore.js";
+import { formatarData as De, formatarHora as Ae } from "./utils/formatters/formatarData.js";
+import { formatarDuracao as Be } from "./utils/formatters/formatarDuracao.js";
+import { formatarMoeda as we, formatarNumero as Re, formatarPercentual as Ee } from "./utils/formatters/formatarNumero.js";
+import { formatarTamanhoDeArquivo as Ue } from "./utils/formatters/formatarTamanhoDeArquivo.js";
+import { paletteWithAccent as Fe, seriesColors as Ge } from "./components/charts/palette/palette.js";
+import { resolveSeriesColors as He } from "./components/charts/palette/seriesColor.js";
 export {
-  n as Accordion,
-  p as Alert,
+  m as Accordion,
+  a as Alert,
   f as Avatar,
   c as Badge,
   l as Breadcrumb,
   C as Button,
   s as ButtonIcon,
   d as ButtonTile,
-  k as Card,
-  S as ChartArea,
+  g as Card,
+  b as ChartArea,
   P as ChartBar,
-  D as ChartCombo,
-  L as ChartDonut,
-  w as ChartLine,
-  E as ChartPie,
-  U as ChartRadial,
-  F as ChartSankey,
-  H as ChartScatter,
-  W as ChartSunburst,
-  Q as ChartTooltip,
-  z as ChartTreemap,
-  K as ChartWaterfall,
-  V as Checkbox,
-  Y as CheckboxGroup,
-  _ as CodeBlock,
-  oo as ColorPicker,
-  eo as ComboBox,
-  no as DatePicker,
-  po as DateTimePicker,
-  fo as Dialog,
-  co as Drawer,
-  lo as EmptyState,
-  Co as Field,
-  so as FileUpload,
-  To as IconAlignCenter,
-  ko as IconAlignLeft,
-  go as IconAlignRight,
-  So as IconArrowDown,
-  bo as IconArrowUp,
-  Po as IconBold,
-  Ao as IconCalendar,
-  Do as IconChartBar,
-  Bo as IconCheck,
-  Lo as IconCheckCircle,
-  vo as IconChevronDown,
-  wo as IconChevronExpand,
-  Ro as IconChevronLeft,
-  Eo as IconChevronRight,
-  Mo as IconChevronUp,
-  Uo as IconClock,
-  yo as IconClose,
-  Fo as IconDesktop,
-  Go as IconDragHandle,
-  Ho as IconExclamationCircle,
-  No as IconExclamationTriangle,
-  Wo as IconExternalLink,
-  qo as IconEye,
-  Qo as IconFile,
-  jo as IconFilter,
-  zo as IconInfoCircle,
-  Jo as IconItalic,
-  Ko as IconLightning,
-  Oo as IconLink,
-  Vo as IconMinusCircle,
-  Xo as IconMobile,
-  Yo as IconMore,
-  Zo as IconPencil,
-  _o as IconPlus,
-  $o as IconPlusCircle,
-  or as IconQuestionCircle,
-  rr as IconRedo,
-  er as IconSearch,
-  tr as IconSidebar,
-  nr as IconStructure,
-  mr as IconTablet,
-  pr as IconTrash,
-  ar as IconUndo,
-  fr as IconUpload,
-  cr as InputCurrency,
-  lr as InputNumber,
-  Cr as InputPassword,
-  sr as InputText,
-  dr as Label,
-  kr as List,
-  Sr as Menu,
-  Pr as Pagination,
-  Dr as Popover,
-  Lr as Progress,
-  wr as Radio,
-  Er as RadioGroup,
-  Ur as SegmentedControl,
-  Fr as Select,
-  Hr as Skeleton,
-  Wr as SkipLink,
-  Qr as SortableList,
-  zr as Spinner,
-  Kr as Steps,
-  Vr as Switch,
-  Yr as Table,
-  _r as Tabs,
-  oe as Tag,
-  ee as Textarea,
-  ne as TimePicker,
-  pe as Timeline,
-  fe as ToastRegion,
-  ce as Toolbar,
-  le as Tooltip,
-  Ce as dismissToast,
-  ue as formatarData,
-  de as formatarHora,
-  ke as formatarMoeda,
-  ge as formatarNumero,
-  Se as formatarPercentual,
-  Pe as formatarTamanhoDeArquivo,
-  De as paletteWithAccent,
-  ve as resolveSeriesColors,
-  Be as seriesColors,
-  he as showToast
+  A as ChartCombo,
+  B as ChartDonut,
+  w as ChartGauge,
+  E as ChartLine,
+  U as ChartMap,
+  F as ChartPie,
+  N as ChartRadial,
+  W as ChartSankey,
+  Q as ChartScatter,
+  z as ChartSunburst,
+  K as ChartTimeline,
+  V as ChartTooltip,
+  Y as ChartTreemap,
+  _ as ChartWaterfall,
+  oo as Checkbox,
+  eo as CheckboxGroup,
+  mo as CodeBlock,
+  ao as ColorPicker,
+  fo as ComboBox,
+  co as DatePicker,
+  lo as DateTimePicker,
+  Co as Dialog,
+  so as Drawer,
+  To as EmptyState,
+  ko as Field,
+  So as FileUpload,
+  Do as IconAlignCenter,
+  Ao as IconAlignLeft,
+  vo as IconAlignRight,
+  Bo as IconArrowDown,
+  Lo as IconArrowUp,
+  wo as IconBold,
+  Ro as IconCalendar,
+  Eo as IconChartBar,
+  Mo as IconCheck,
+  Uo as IconCheckCircle,
+  yo as IconChevronDown,
+  Fo as IconChevronExpand,
+  Go as IconChevronLeft,
+  No as IconChevronRight,
+  Ho as IconChevronUp,
+  Wo as IconClock,
+  qo as IconClose,
+  Qo as IconDesktop,
+  jo as IconDragHandle,
+  zo as IconExclamationCircle,
+  Jo as IconExclamationTriangle,
+  Ko as IconExternalLink,
+  Oo as IconEye,
+  Vo as IconFile,
+  Xo as IconFilter,
+  Yo as IconInfoCircle,
+  Zo as IconItalic,
+  _o as IconLightning,
+  $o as IconLink,
+  or as IconMinusCircle,
+  rr as IconMobile,
+  er as IconMore,
+  tr as IconPencil,
+  mr as IconPlus,
+  nr as IconPlusCircle,
+  ar as IconQuestionCircle,
+  pr as IconRedo,
+  fr as IconSearch,
+  xr as IconSidebar,
+  cr as IconStructure,
+  ir as IconTablet,
+  lr as IconTrash,
+  Ir as IconUndo,
+  Cr as IconUpload,
+  sr as InputCurrency,
+  dr as InputNumber,
+  gr as InputPassword,
+  br as InputText,
+  Pr as Label,
+  Ar as List,
+  Br as Menu,
+  wr as Pagination,
+  Er as Popover,
+  Ur as Progress,
+  Fr as Radio,
+  Nr as RadioGroup,
+  Wr as SegmentedControl,
+  Qr as Select,
+  zr as Skeleton,
+  Kr as SkipLink,
+  Vr as SortableList,
+  Yr as Spinner,
+  _r as Steps,
+  oe as Switch,
+  ee as Table,
+  me as Tabs,
+  ae as TabsNav,
+  fe as Tag,
+  ce as Textarea,
+  le as TimePicker,
+  Ce as Timeline,
+  se as ToastRegion,
+  de as Toolbar,
+  ge as Tooltip,
+  be as dismissToast,
+  De as formatarData,
+  Be as formatarDuracao,
+  Ae as formatarHora,
+  we as formatarMoeda,
+  Re as formatarNumero,
+  Ee as formatarPercentual,
+  Ue as formatarTamanhoDeArquivo,
+  Fe as paletteWithAccent,
+  He as resolveSeriesColors,
+  Ge as seriesColors,
+  Se as showToast
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/types/components/charts/ChartGauge/ChartGauge.d.ts

@@ -0,0 +1,83 @@
+import { type ChartHeight, type ChartLegendPosition, type MarkVisibility } from '../core/index.js';
+import { type SeriesAppearance, type SeriesIntent } from '../palette/index.js';
+/** Uma faixa da escala. A cor segue a regra da família: `color`, depois `intent`, depois a paleta. */
+export interface ChartGaugeSegment extends SeriesAppearance {
+    label?: string;
+    /** Limite superior, na unidade de `segmentUnit`. Omitido na última faixa, vai até `max`. */
+    to?: number;
+}
+export interface ChartGaugeTarget {
+    label?: string;
+    value: number;
+}
+export interface ChartGaugeDelta {
+    /** Formato do módulo da variação; o sinal é do componente. */
+    format?: (delta: number) => string;
+    /** Sem ela, positiva quando sobe e negativa quando desce. */
+    intent?: SeriesIntent;
+    label?: string;
+    value: number;
+}
+export type ChartGaugeIndicator = 'fill' | 'needle' | 'fillAndNeedle';
+export type ChartGaugeSegmentStyle = 'track' | 'rim' | 'hidden';
+export type ChartGaugeScaleLabels = 'hidden' | 'minMax' | 'ticks';
+export type ChartGaugeSize = 'default' | 'compact';
+export type ChartGaugeTicks = 'hidden' | 'major' | 'majorAndMinor';
+/** Leitura contra a meta: a mesma palavra na exibição e na unidade das faixas. */
+export type ChartGaugeValueDisplay = 'value' | 'percentOfTarget';
+export type ChartGaugeSegmentUnit = 'value' | 'percentOfTarget';
+export interface ChartGaugeProps {
+    accent?: string;
+    /** Troca a frase montada do `aria-valuetext`. */
+    ariaValueText?: string;
+    /** Texto sob o valor. Sem ele, na leitura contra a meta, a outra leitura. */
+    centerLabel?: string;
+    /** O arco assume a cor da faixa onde o valor está. */
+    colorBySegment?: boolean;
+    /** Cor do arco fora de `colorBySegment`. Vence `intent`. */
+    color?: string;
+    delta?: ChartGaugeDelta;
+    emptyMessage?: string;
+    /** Ângulo final, em graus a partir do topo. */
+    endAngle?: number;
+    /** Formato exato do balão e, na leitura contra a meta, do `aria-valuetext`. */
+    formatTooltipValue?: (value: number) => string;
+    /** Formato do centro, da escala e da meta. */
+    formatValue?: (value: number) => string;
+    height?: ChartHeight;
+    indicator?: ChartGaugeIndicator;
+    intent?: SeriesIntent;
+    legend?: ChartLegendPosition;
+    loading?: boolean;
+    /** Fim da escala. Omitido com meta, vai a 120% dela. */
+    max?: number;
+    min?: number;
+    /** De onde o arco preenchido parte. Sem ele, o zero quando a escala o cruza; senão, `min`. */
+    origin?: number;
+    scaleLabels?: ChartGaugeScaleLabels;
+    segmentStyle?: ChartGaugeSegmentStyle;
+    segmentUnit?: ChartGaugeSegmentUnit;
+    segments?: readonly ChartGaugeSegment[];
+    showCenter?: boolean;
+    showSegmentLabels?: MarkVisibility;
+    showTooltip?: boolean;
+    size?: ChartGaugeSize;
+    /** Ângulo inicial, em graus a partir do topo. */
+    startAngle?: number;
+    target?: ChartGaugeTarget;
+    /** Espessura do arco, em pixels. No compacto, até 10. */
+    thickness?: number;
+    tickCount?: number;
+    ticks?: ChartGaugeTicks;
+    title: string;
+    /** Raio das pontas, limitado a metade da espessura. Sem valor, o token de raio pequeno. */
+    trackRadius?: number;
+    /** `null` é sem dado. */
+    value: number | null;
+    valueDisplay?: ChartGaugeValueDisplay;
+}
+/**
+ * Medidor de um valor numa escala com faixas de significado. É `role="meter"`: o leitor de tela ouve o valor, a faixa,
+ * a meta e a variação. Carregando ou sem dado, vira `role="img"`.
+ */
+export declare function ChartGauge({ accent, ariaValueText, centerLabel, colorBySegment, color, delta, emptyMessage, endAngle, formatTooltipValue, formatValue, height, indicator, intent, legend, loading, max, min, origin, scaleLabels, segmentStyle, segmentUnit, segments, showCenter, showSegmentLabels, showTooltip, size, startAngle, target, thickness, tickCount, ticks, title, trackRadius, value, valueDisplay, }: ChartGaugeProps): import("react").JSX.Element;

package/dist/types/components/charts/ChartGauge/gaugeLayout.d.ts

@@ -0,0 +1,64 @@
+import { type LabelFont } from '../core/index.js';
+import type { ChartGaugeScaleLabels, ChartGaugeTicks } from './ChartGauge.js';
+import type { CenterLine, GaugeCenter } from './gaugeReading.js';
+export type TextAnchor = 'start' | 'middle' | 'end';
+export interface AngledLabel {
+    angle: number;
+    text: string;
+}
+export interface OutsideLabel extends AngledLabel {
+    kind: 'segment' | 'target';
+}
+export interface PlacedLabel<T extends AngledLabel = AngledLabel> {
+    anchor: TextAnchor;
+    label: T;
+    x: number;
+    y: number;
+}
+export interface GaugeLayoutInput {
+    center: GaugeCenter;
+    compact: boolean;
+    /** Radianos a partir do topo, no sentido horário. */
+    endAngle: number;
+    font: LabelFont;
+    height: number;
+    /** Rótulos de ponta, mínimo e máximo, quando `scaleLabels` é `minMax`. */
+    minMaxLabels: readonly [AngledLabel, AngledLabel];
+    needle: boolean;
+    /** Régua e marca da meta, além do raio externo do arco. */
+    outerBand: number;
+    outsideLabels: readonly OutsideLabel[];
+    scaleLabels: ChartGaugeScaleLabels;
+    startAngle: number;
+    thickness: number;
+    /** Rótulos das marcas principais, na ordem em que disputam espaço. */
+    tickLabels: readonly AngledLabel[];
+    ticks: ChartGaugeTicks;
+    width: number;
+}
+export interface GaugeCenterLayout {
+    height: number;
+    lineHeight: number;
+    lines: readonly CenterLine[];
+    top: number;
+    value?: {
+        family: string;
+        size: number;
+        text: string;
+    };
+    width: number;
+}
+export interface GaugeLayout {
+    center: GaugeCenterLayout;
+    cx: number;
+    cy: number;
+    innerRadius: number;
+    outsideLabels: readonly PlacedLabel<OutsideLabel>[];
+    pinRadius: number;
+    radius: number;
+    scaleLabels: readonly PlacedLabel[];
+    thickness: number;
+}
+export declare function pointAt(angle: number, radius: number): [number, number];
+/** Maior raio em que arco, rótulos e centro cabem na área, e a posição de cada rótulo nele. */
+export declare function layoutGauge(input: GaugeLayoutInput): GaugeLayout;

package/dist/types/components/charts/ChartGauge/gaugeReading.d.ts

@@ -0,0 +1,97 @@
+import type { ChartTooltipRow } from '../ChartTooltip/index.js';
+import type { SeriesIntent } from '../palette/index.js';
+import type { ChartGaugeDelta, ChartGaugeTarget } from './ChartGauge.js';
+import { type GaugeDomain, type GaugeSegment } from './gaugeScale.js';
+/** Como o medidor lê o valor: no formato do consumidor ou contra a meta. */
+export interface GaugeReading {
+    /** Leitura contra a meta: a outra leitura no centro, a linha Atingido no balão e as duas no `aria-valuetext`. */
+    againstTarget: boolean;
+    /** Meta positiva, base do atingimento. */
+    base: number | null;
+    formatExact: (value: number) => string;
+    formatValue: (value: number) => string;
+    /** Centro, escala e intervalos em percentual da meta. */
+    showsPercent: boolean;
+}
+export type CenterLine = {
+    kind: 'text';
+    text: string;
+} | {
+    glyph: string;
+    kind: 'warn';
+    short: string;
+    text: string;
+} | {
+    glyph: string;
+    intent: SeriesIntent;
+    kind: 'delta';
+    label?: string;
+    text: string;
+};
+export interface GaugeCenter {
+    lines: readonly CenterLine[];
+    value?: string;
+}
+export type GaugeStatus = 'loading' | 'empty' | 'value';
+export interface GaugeTooltip {
+    rows: ChartTooltipRow[];
+    subtitle?: string;
+    title?: string;
+}
+/** Quem pede `percentOfTarget`, na exibição ou nas faixas, liga a leitura contra a meta; sem meta, vale o valor. */
+export declare function gaugeReading(options: {
+    base: number | null;
+    formatTooltipValue?: (value: number) => string;
+    formatValue: (value: number) => string;
+    segmentUnit: string;
+    valueDisplay: string;
+}): GaugeReading;
+export declare function formatAttainment(reading: GaugeReading, value: number): string;
+/** O número como a exibição escolhida o mostra. */
+export declare function formatShown(reading: GaugeReading, value: number): string;
+/** A leitura que a exibição não escolheu, como "92% de R$ 2 mi" ou "R$ 1,84 mi de R$ 2 mi". */
+export declare function otherReading(reading: GaugeReading, value: number, format: (value: number) => string): string;
+export declare function rangeText(reading: GaugeReading, segment: GaugeSegment): string;
+export declare function segmentName(segment: GaugeSegment): string;
+/** O sinal é do componente; o `format` recebe o módulo da variação. */
+export declare function deltaText(delta: ChartGaugeDelta): string;
+export declare function hasDelta(delta: ChartGaugeDelta | undefined): delta is ChartGaugeDelta;
+export declare function gaugeCenter(options: {
+    centerLabel?: string;
+    compact: boolean;
+    delta?: ChartGaugeDelta;
+    domain: GaugeDomain;
+    emptyMessage: string;
+    reading: GaugeReading;
+    showCenter: boolean;
+    status: GaugeStatus;
+    value: number;
+}): GaugeCenter;
+/** A frase do `aria-valuetext`: o valor, o que excede a escala, a faixa, a meta e a variação. */
+export declare function gaugeValueText(options: {
+    delta?: ChartGaugeDelta;
+    domain: GaugeDomain;
+    reading: GaugeReading;
+    segment?: GaugeSegment;
+    target?: ChartGaugeTarget;
+    value: number;
+}): string;
+/** Balão do centro ou do arco sem faixas: a faixa do valor, o valor, a meta, o atingido e a variação. */
+export declare function valueTooltip(options: {
+    color: string;
+    delta?: ChartGaugeDelta;
+    domain: GaugeDomain;
+    reading: GaugeReading;
+    segment?: GaugeSegment;
+    target?: ChartGaugeTarget;
+    title: string;
+    value: number;
+}): GaugeTooltip;
+/** Balão de uma faixa: o intervalo dela, o valor atual e se ele está ali. */
+export declare function segmentTooltip(options: {
+    current?: GaugeSegment;
+    reading: GaugeReading;
+    segment: GaugeSegment;
+    target?: ChartGaugeTarget;
+    value: number;
+}): GaugeTooltip;