@iclips/ui 2.0.0 → 2.0.2

package/dist/index.d.cts

@@ -839,11 +839,15 @@ export declare const DatePicker: React_2.ForwardRefExoticComponent<DatePickerPro
 
 export declare interface DatePickerProps {
     /**
-     * Data selecionada
+     * Data selecionada (modo controlado). Omita para o modo não-controlado.
      */
     value?: Date;
     /**
-     * Callback quando a data muda
+     * Valor inicial no modo não-controlado (quando `value` não é passado).
+     */
+    defaultValue?: Date;
+    /**
+     * Callback quando a data muda. Chamado nos dois modos.
      */
     onChange?: (date: Date | undefined) => void;
     /**
@@ -947,11 +951,15 @@ export declare const DateRangePicker: React_2.ForwardRefExoticComponent<DateRang
 
 export declare interface DateRangePickerProps {
     /**
-     * Intervalo de datas selecionado
+     * Intervalo de datas selecionado (modo controlado). Omita para o modo não-controlado.
      */
     value?: DateRange;
     /**
-     * Callback quando o intervalo muda
+     * Valor inicial no modo não-controlado (quando `value` não é passado).
+     */
+    defaultValue?: DateRange;
+    /**
+     * Callback quando o intervalo muda. Chamado nos dois modos.
      */
     onChange?: (range: DateRange | undefined) => void;
     /**
@@ -1748,19 +1756,27 @@ export declare interface InputValidationProps extends React_2.ComponentProps<"in
     validate?: (value: string) => boolean | null;
 }
 
+/**
+ * KPICard — card de métrica com título, valor em destaque, tendência e texto
+ * secundário. O estado de `isLoading` reserva exatamente a mesma altura do
+ * estado final (mesma árvore de layout, só troca o conteúdo por `Skeleton`),
+ * então não há salto quando os dados chegam. Título, valor e texto secundário
+ * ficam sempre em uma linha.
+ */
 export declare const KPICard: React_2.ForwardRefExoticComponent<KPICardProps & React_2.RefAttributes<HTMLDivElement>>;
 
 export declare interface KPICardProps {
     /**
-     * Título do KPI (ex: "Receita Mensal")
+     * Título do KPI (ex: "Receita Mensal"). Fica em uma linha (trunca com "…").
      */
     title: string;
     /**
-     * Valor principal em destaque (ex: "R$ 127.361,23")
+     * Valor principal em destaque (ex: "R$ 127.361,23"). Fica em uma linha
+     * (trunca com "…"; o valor completo aparece no `title` nativo ao passar o mouse).
      */
     primaryContent: string;
     /**
-     * Texto secundário descritivo (ex: "vs. mês anterior")
+     * Texto secundário descritivo (ex: "vs. mês anterior"). Uma linha.
      */
     secondaryContent?: string;
     /**
@@ -1780,7 +1796,7 @@ export declare interface KPICardProps {
         className?: string;
     }>;
     /**
-     * Estado de loading - exibe skeleton
+     * Estado de loading - exibe skeleton com a mesma altura do estado final.
      */
     isLoading?: boolean;
     /**
@@ -1853,11 +1869,16 @@ export declare const MonthRangePicker: React_2.ForwardRefExoticComponent<MonthRa
 
 export declare interface MonthRangePickerProps {
     /**
-     * Intervalo de meses selecionado. `from`/`to` representam o 1º dia do mês.
+     * Intervalo de meses selecionado (modo controlado). `from`/`to` representam o
+     * 1º dia do mês. Omita para o modo não-controlado.
      */
     value?: MonthYearRange;
     /**
-     * Callback quando o intervalo muda
+     * Valor inicial no modo não-controlado (quando `value` não é passado).
+     */
+    defaultValue?: MonthYearRange;
+    /**
+     * Callback quando o intervalo muda. Chamado nos dois modos.
      */
     onChange?: (range: MonthYearRange | undefined) => void;
     /**

package/dist/index.d.ts

@@ -839,11 +839,15 @@ export declare const DatePicker: React_2.ForwardRefExoticComponent<DatePickerPro
 
 export declare interface DatePickerProps {
     /**
-     * Data selecionada
+     * Data selecionada (modo controlado). Omita para o modo não-controlado.
      */
     value?: Date;
     /**
-     * Callback quando a data muda
+     * Valor inicial no modo não-controlado (quando `value` não é passado).
+     */
+    defaultValue?: Date;
+    /**
+     * Callback quando a data muda. Chamado nos dois modos.
      */
     onChange?: (date: Date | undefined) => void;
     /**
@@ -947,11 +951,15 @@ export declare const DateRangePicker: React_2.ForwardRefExoticComponent<DateRang
 
 export declare interface DateRangePickerProps {
     /**
-     * Intervalo de datas selecionado
+     * Intervalo de datas selecionado (modo controlado). Omita para o modo não-controlado.
      */
     value?: DateRange;
     /**
-     * Callback quando o intervalo muda
+     * Valor inicial no modo não-controlado (quando `value` não é passado).
+     */
+    defaultValue?: DateRange;
+    /**
+     * Callback quando o intervalo muda. Chamado nos dois modos.
      */
     onChange?: (range: DateRange | undefined) => void;
     /**
@@ -1748,19 +1756,27 @@ export declare interface InputValidationProps extends React_2.ComponentProps<"in
     validate?: (value: string) => boolean | null;
 }
 
+/**
+ * KPICard — card de métrica com título, valor em destaque, tendência e texto
+ * secundário. O estado de `isLoading` reserva exatamente a mesma altura do
+ * estado final (mesma árvore de layout, só troca o conteúdo por `Skeleton`),
+ * então não há salto quando os dados chegam. Título, valor e texto secundário
+ * ficam sempre em uma linha.
+ */
 export declare const KPICard: React_2.ForwardRefExoticComponent<KPICardProps & React_2.RefAttributes<HTMLDivElement>>;
 
 export declare interface KPICardProps {
     /**
-     * Título do KPI (ex: "Receita Mensal")
+     * Título do KPI (ex: "Receita Mensal"). Fica em uma linha (trunca com "…").
      */
     title: string;
     /**
-     * Valor principal em destaque (ex: "R$ 127.361,23")
+     * Valor principal em destaque (ex: "R$ 127.361,23"). Fica em uma linha
+     * (trunca com "…"; o valor completo aparece no `title` nativo ao passar o mouse).
      */
     primaryContent: string;
     /**
-     * Texto secundário descritivo (ex: "vs. mês anterior")
+     * Texto secundário descritivo (ex: "vs. mês anterior"). Uma linha.
      */
     secondaryContent?: string;
     /**
@@ -1780,7 +1796,7 @@ export declare interface KPICardProps {
         className?: string;
     }>;
     /**
-     * Estado de loading - exibe skeleton
+     * Estado de loading - exibe skeleton com a mesma altura do estado final.
      */
     isLoading?: boolean;
     /**
@@ -1853,11 +1869,16 @@ export declare const MonthRangePicker: React_2.ForwardRefExoticComponent<MonthRa
 
 export declare interface MonthRangePickerProps {
     /**
-     * Intervalo de meses selecionado. `from`/`to` representam o 1º dia do mês.
+     * Intervalo de meses selecionado (modo controlado). `from`/`to` representam o
+     * 1º dia do mês. Omita para o modo não-controlado.
      */
     value?: MonthYearRange;
     /**
-     * Callback quando o intervalo muda
+     * Valor inicial no modo não-controlado (quando `value` não é passado).
+     */
+    defaultValue?: MonthYearRange;
+    /**
+     * Callback quando o intervalo muda. Chamado nos dois modos.
      */
     onChange?: (range: MonthYearRange | undefined) => void;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iclips/ui",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Design system da iClips — componentes React sobre Radix UI + Tailwind v4, paleta #7F26BF",
   "author": "iclipsbr",
   "license": "MIT",
@@ -179,7 +179,6 @@
     "prepublishOnly": "npm run build:lib",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build -o storybook-static",
-    "test:visual": "playwright test tests/visual.spec.ts",
     "test:a11y": "playwright test --config playwright.a11y.config.ts",
     "test:a11y:baseline": "node scripts/a11y-baseline.mjs",
     "size": "size-limit"