@plenustech/design-system 0.1.1 → 0.2.1

package/dist/types/components/navigation/Pagination/Pagination.d.ts

@@ -1,5 +1,7 @@
 import { type ComponentPropsWithRef } from 'react';
 export interface PaginationProps extends ComponentPropsWithRef<'nav'> {
+    /** Suspende a troca de pagina, como enquanto a pagina pedida carrega. Os botoes continuam focaveis. */
+    disabled?: boolean;
     label?: string;
     onPageChange: (page: number) => void;
     page: number;
@@ -7,5 +9,9 @@ export interface PaginationProps extends ComponentPropsWithRef<'nav'> {
     /** Quantidade de paginas mostradas de cada lado da atual. */
     siblings?: number;
 }
-export declare function Pagination({ className, label, onPageChange, page, pageCount, siblings, ...props }: PaginationProps): import("react").JSX.Element | null;
+export declare function Pagination({ className, disabled, label, onPageChange, page, pageCount, siblings, ...props }: PaginationProps): import("react").JSX.Element | null;
+/**
+ * Primeira e ultima pagina sempre visiveis; null representa a reticencia. A faixa tem sempre as mesmas vagas: perto
+ * da ponta a janela encosta nela em vez de encolher, e reticencia nunca esconde uma pagina so.
+ */
 export declare function montarFaixa(atual: number, total: number, vizinhos: number): (number | null)[];

package/dist/types/components/overlays/Dialog/Dialog.d.ts

@@ -1,12 +1,16 @@
-import { type ReactNode } from 'react';
+import { type ComponentPropsWithRef, type ReactNode } from 'react';
 export type DialogSize = 'sm' | 'md' | 'lg';
-export interface DialogProps {
+export type DialogRole = 'dialog' | 'alertdialog';
+/** As propriedades nativas vao ao elemento do dialogo; o `className` soma ao do sistema. */
+export interface DialogProps extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'role' | 'title'> {
     children?: ReactNode;
     description?: string;
     dismissable?: boolean;
     footer?: ReactNode;
     onClose: () => void;
     open: boolean;
+    /** `alertdialog` para a confirmacao que interrompe e exige resposta, como a de uma acao destrutiva. */
+    role?: DialogRole;
     size?: DialogSize;
     title: string;
 }

package/dist/types/components/overlays/Dialog/index.d.ts

@@ -1,2 +1,2 @@
 export { Dialog } from './Dialog.js';
-export type { DialogProps, DialogSize } from './Dialog.js';
+export type { DialogProps, DialogRole, DialogSize } from './Dialog.js';

package/dist/types/components/overlays/Menu/Menu.d.ts

@@ -7,7 +7,13 @@ export interface MenuItem {
 }
 export interface MenuProps {
     children: ReactElement<Record<string, unknown>>;
+    /** Abertura inicial no modo nao controlado. */
+    defaultOpen?: boolean;
     items: readonly MenuItem[];
     label: string;
+    /** Avisa cada abertura e fechamento pedidos pelo gatilho, pelo teclado, pela opcao ou pelo clique fora. */
+    onOpenChange?: (open: boolean) => void;
+    /** Controla a abertura; sem ele, o menu guarda o proprio estado. */
+    open?: boolean;
 }
-export declare function Menu({ children, items, label }: MenuProps): import("react").JSX.Element;
+export declare function Menu({ children, defaultOpen, items, label, onOpenChange, open: controlledOpen }: MenuProps): import("react").JSX.Element;

package/dist/types/components/overlays/Popover/Popover.d.ts

@@ -1,8 +1,7 @@
-import { type ReactNode, type RefObject } from 'react';
+import { type ComponentPropsWithRef, type ReactNode, type RefObject } from 'react';
 export type PopoverPlacement = 'top' | 'top start' | 'top end' | 'bottom' | 'bottom start' | 'bottom end' | 'left' | 'right';
-export interface PopoverProps {
-    'aria-label'?: string;
-    'aria-labelledby'?: string;
+/** As propriedades nativas vao ao elemento do painel; o `className` soma ao do sistema. */
+export interface PopoverProps extends Omit<ComponentPropsWithRef<'div'>, 'children'> {
     children: ReactNode;
     offset?: number;
     onClose: () => void;

package/dist/types/hooks/useDecimalInput.d.ts

@@ -0,0 +1,19 @@
+import { type ChangeEvent } from 'react';
+interface DecimalInputOptions {
+    decimalScale: number;
+    defaultValue: string | number;
+    onValueChange?: (value: string) => void;
+    value?: string | number;
+}
+/**
+ * Estado dos campos decimais: o valor, controlado ou nao, e o texto que a
+ * pessoa esta digitando, que pode ainda guardar um ponto sem papel decidido.
+ */
+export declare function useDecimalInput({ decimalScale, defaultValue, onValueChange, value }: DecimalInputOptions): {
+    ref: import("react").RefObject<HTMLInputElement | null>;
+    value: string;
+    text: string;
+    handleChange: (event: ChangeEvent<HTMLInputElement>) => void;
+    endEditing: () => void;
+};
+export {};

package/dist/types/hooks/useMergedRefs.d.ts

@@ -0,0 +1,6 @@
+import { type Ref } from 'react';
+/**
+ * Junta o ref interno ao que veio de fora numa funcao estavel, que devolve a limpeza do React 19.
+ * Nova a cada render, ela desligava e religava o elemento em todo render.
+ */
+export declare function useMergedRefs<T>(...refs: readonly (Ref<T> | undefined)[]): (node: T | null) => () => void;

package/dist/types/hooks/useSelection/useSelection.d.ts

@@ -17,6 +17,7 @@ export interface UseSelectionResult extends SelectionState {
     focusLast: (extend?: boolean) => void;
     focusNext: (extend?: boolean) => void;
     focusPrevious: (extend?: boolean) => void;
+    reset: () => void;
     search: (character: string) => void;
     select: (key: string) => void;
     selectRange: (key: string) => void;

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export { IconArrowDown, IconArrowUp, IconCalendar, IconChevronDown, IconChevronLeft, IconChevronRight, IconChevronUp, IconClock, IconClose, IconMinusCircle, IconPlusCircle, } from './components/icons/index.js';
+export { IconArrowDown, IconArrowUp, IconCalendar, IconChevronDown, IconChevronExpand, IconChevronLeft, IconChevronRight, IconChevronUp, IconClock, IconClose, IconMinusCircle, IconPlusCircle, IconQuestionCircle, } from './components/icons/index.js';
 export type { IconProps } from './components/icons/index.js';
 export { Button } from './components/actions/Button/index.js';
 export type { ButtonProps, ButtonSize, ButtonVariant } from './components/actions/Button/index.js';
@@ -41,13 +41,13 @@ export type { AccordionProps, AccordionItem, AccordionIconPosition } from './com
 export { Select } from './components/forms/Select/index.js';
 export type { SelectProps, SelectOption, SelectSize } from './components/forms/Select/index.js';
 export { ComboBox } from './components/forms/ComboBox/index.js';
-export type { ComboBoxProps, ComboBoxOption, ComboBoxSize } from './components/forms/ComboBox/index.js';
+export type { ComboBoxMultipleProps, ComboBoxOption, ComboBoxProps, ComboBoxSingleProps, ComboBoxSize, } from './components/forms/ComboBox/index.js';
 export { Menu } from './components/overlays/Menu/index.js';
 export type { MenuProps, MenuItem } from './components/overlays/Menu/index.js';
 export { Tooltip } from './components/overlays/Tooltip/index.js';
 export type { TooltipProps, TooltipPlacement } from './components/overlays/Tooltip/index.js';
 export { Dialog } from './components/overlays/Dialog/index.js';
-export type { DialogProps, DialogSize } from './components/overlays/Dialog/index.js';
+export type { DialogProps, DialogRole, DialogSize } from './components/overlays/Dialog/index.js';
 export { Badge } from './components/data-display/Badge/index.js';
 export type { BadgeProps, BadgeTone } from './components/data-display/Badge/index.js';
 export { Avatar } from './components/data-display/Avatar/index.js';

package/dist/types/utils/formatters/formatarEntradaDecimal.d.ts

@@ -1 +1,6 @@
 export declare function formatarEntradaDecimal(valor: string | number, casasDecimais?: number): string;
+/**
+ * O texto do campo enquanto se digita: o ponto que ainda pode virar milhar na proxima tecla fica como foi digitado, e
+ * o valor o le como decimal ate la. Decidido na hora, `1.234` virava `1,23`.
+ */
+export declare function formatarEdicaoDecimal(texto: string, casasDecimais?: number): string;

package/dist/types/utils/formatters/formatarEntradaHora.d.ts

@@ -0,0 +1,7 @@
+import { CalendarDateTime, Time } from '@internationalized/date';
+/** Aplica a mascara hora:minuto conforme o usuario digita. */
+export declare function formatarEntradaHora(valor: string): string;
+export declare function lerEntradaHora(valor: string): Time | undefined;
+/** Aplica a mascara dia/mes/ano hora:minuto conforme o usuario digita. */
+export declare function formatarEntradaDataHora(valor: string): string;
+export declare function lerEntradaDataHora(valor: string): CalendarDateTime | undefined;

package/dist/types/utils/formatters/index.d.ts

@@ -1,7 +1,8 @@
-export { formatarEntradaDecimal } from './formatarEntradaDecimal.js';
+export { formatarEdicaoDecimal, formatarEntradaDecimal } from './formatarEntradaDecimal.js';
 export { formatarEntradaMonetaria } from './formatarEntradaMonetaria.js';
 export { formatarData, formatarHora } from './formatarData.js';
 export type { OpcoesDeData, OpcoesDeHora } from './formatarData.js';
 export { formatarMoeda, formatarNumero, formatarPercentual } from './formatarNumero.js';
 export type { OpcoesDeMoeda, OpcoesDeNumero, OpcoesDePercentual } from './formatarNumero.js';
 export { formatarEntradaData, lerEntradaData } from './formatarEntradaData.js';
+export { formatarEntradaDataHora, formatarEntradaHora, lerEntradaDataHora, lerEntradaHora } from './formatarEntradaHora.js';

package/dist/types/utils/formatters/mascararPartes.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Mascara de partes com limite de digitos, como dia/mes/ano. O separador digitado fecha a parte antes
+ * de encher, e ninguem empurra digito para a vizinha; sem ele, o excesso passa para a parte seguinte.
+ */
+export declare function mascararPartes(valor: string, limites: readonly number[], separadores: readonly string[]): string;

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@plenustech/design-system",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Design System centralizado para os produtos web da Plenustech.",
+  "license": "UNLICENSED",
   "publishConfig": {
     "access": "public"
   },
@@ -42,7 +43,7 @@
     "check:pacote": "node scripts/check-pacote.mjs",
     "check:contraste": "node scripts/check-contraste.mjs",
     "prepare": "npm run build:pacote",
-    "build:showcase": "vite build --config showcase/vite.config.ts",
+    "build:showcase": "npm run build:pacote && vite build --config showcase/vite.config.ts",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",

package/dist/types/utils/mergeRefs.d.ts

@@ -1,7 +0,0 @@
-import type { Ref } from 'react';
-/**
- * Junta o ref interno do componente ao que veio de fora. Sem isto, um dos dois
- * se perde: o interno, porque `{...props}` o sobrescreve, ou o de fora, porque
- * o componente aplica o seu depois.
- */
-export declare function mergeRefs<T>(...refs: readonly (Ref<T> | undefined)[]): (node: T | null) => void;