@plenustech/design-system 0.2.4 → 0.2.5

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

@@ -1,15 +1,27 @@
 import { type ComponentPropsWithRef } from 'react';
+/** Posições, contadas de 1, do primeiro e do último item da página, e o total de itens. */
+export interface PaginationRange {
+    end: number;
+    start: number;
+    total: number;
+}
 export interface PaginationProps extends ComponentPropsWithRef<'nav'> {
     /** Suspende a troca de pagina, como enquanto a pagina pedida carrega. Os botoes continuam focaveis. */
     disabled?: boolean;
+    /** Troca o texto do intervalo, que por padrão é `1.201–1.250 de 4.380`. */
+    formatRange?: (range: PaginationRange) => string;
     label?: string;
     onPageChange: (page: number) => void;
     page: number;
     pageCount: number;
+    /** Itens por página. Com `totalItems`, mostra o intervalo da página atual. */
+    pageSize?: number;
     /** Quantidade de paginas mostradas de cada lado da atual. */
     siblings?: number;
+    /** Total de itens. Com `pageSize`, mostra o intervalo da página atual. */
+    totalItems?: number;
 }
-export declare function Pagination({ className, disabled, label, onPageChange, page, pageCount, siblings, ...props }: PaginationProps): import("react").JSX.Element | null;
+export declare function Pagination({ className, disabled, formatRange, label, onPageChange, page, pageCount, pageSize, siblings, totalItems, ...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.

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

@@ -1,2 +1,2 @@
 export { Pagination } from './Pagination.js';
-export type { PaginationProps } from './Pagination.js';
+export type { PaginationProps, PaginationRange } from './Pagination.js';

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

@@ -8,8 +8,10 @@ export interface MenuItem {
     key: string;
     label: string;
     onSelect?: () => void;
-    /** Atalho escrito a direita, como `Ctrl+D`, e anunciado em `aria-keyshortcuts`. */
+    /** Atalho escrito à direita, como `Ctrl+D` ou `⌘⇧D`; convertido nos nomes de tecla de `aria-keyshortcuts`. */
     shortcut?: string;
+    /** Valor de `aria-keyshortcuts` quando a conversão do `shortcut` não basta, como `Control+Shift+D Meta+Shift+D`. */
+    shortcutKeys?: string;
     /** `danger` para a acao que destroi, como remover. */
     tone?: 'danger';
 }

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

@@ -0,0 +1,2 @@
+/** Converte o atalho escrito, como `Ctrl+Shift+D` ou `⌘K, Ctrl+K`, no valor de `aria-keyshortcuts`. */
+export declare function toAriaKeyShortcuts(shortcut: string): string;

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

@@ -1,9 +1,30 @@
-import { type ReactElement, type ReactNode } from 'react';
+import { type ReactElement, type ReactNode, type RefObject } from 'react';
 export type TooltipPlacement = 'top' | 'bottom' | 'left' | 'right';
-export interface TooltipProps {
-    children: ReactElement<Record<string, unknown>>;
+interface TooltipCommonProps {
     content: ReactNode;
-    delay?: number;
+    /** Avisa cada pedido de abrir ou fechar: ponteiro, foco, blur e Escape. */
+    onOpenChange?: (open: boolean) => void;
     placement?: TooltipPlacement;
 }
-export declare function Tooltip({ children, content, delay, placement }: TooltipProps): import("react").JSX.Element;
+interface TooltipOnChildProps extends TooltipCommonProps {
+    anchorRef?: never;
+    /** O gatilho: o Tooltip o clona, soma os manipuladores e liga a descrição por `aria-describedby`. */
+    children: ReactElement<Record<string, unknown>>;
+    delay?: number;
+    id?: never;
+    /** Controla a abertura; sem ele, o Tooltip guarda o próprio estado. */
+    open?: boolean;
+}
+interface TooltipOnAnchorProps extends TooltipCommonProps {
+    /** Âncora que não é filho do Tooltip, como um elemento que precisa da própria referência e não pode ser clonado. */
+    anchorRef: RefObject<HTMLElement | null>;
+    children?: never;
+    delay?: never;
+    /** Id do balão. O produto o põe no `aria-describedby` da âncora enquanto `open`. */
+    id: string;
+    /** Com âncora externa, a abertura é sempre do produto. */
+    open: boolean;
+}
+export type TooltipProps = TooltipOnChildProps | TooltipOnAnchorProps;
+export declare function Tooltip(props: TooltipProps): import("react").JSX.Element;
+export {};

package/dist/types/icons.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Suite completa do Bootstrap Icons, pelo nome do desenho: `@plenustech/design-system/icons`. Fica fora do ponto de
+ * entrada principal para o autocompletar e as declaracoes dele continuarem leves; o bundle leva so os importados.
+ */
+export * from './components/icons/suite.js';
+export type { IconProps } from './components/icons/Icon.js';

package/dist/types/index.d.ts

@@ -57,7 +57,7 @@ export type { TabsNavItem, TabsNavProps } from './components/navigation/TabsNav/
 export { Breadcrumb } from './components/navigation/Breadcrumb/index.js';
 export type { BreadcrumbProps, BreadcrumbItem } from './components/navigation/Breadcrumb/index.js';
 export { Pagination } from './components/navigation/Pagination/index.js';
-export type { PaginationProps } from './components/navigation/Pagination/index.js';
+export type { PaginationProps, PaginationRange } from './components/navigation/Pagination/index.js';
 export { SkipLink } from './components/navigation/SkipLink/index.js';
 export type { SkipLinkProps } from './components/navigation/SkipLink/index.js';
 export { Steps } from './components/navigation/Steps/index.js';
@@ -90,7 +90,7 @@ export { CodeBlock } from './components/data-display/CodeBlock/index.js';
 export { SortableList } from './components/data-display/SortableList/index.js';
 export type { SortableListItem, SortableListProps } from './components/data-display/SortableList/index.js';
 export { Timeline } from './components/data-display/Timeline/index.js';
-export type { TimelineItem, TimelineProps } from './components/data-display/Timeline/index.js';
+export type { TimelineItem, TimelineProps, TimelineSize } from './components/data-display/Timeline/index.js';
 export type { CodeBlockProps, CodeSyntax } from './components/data-display/CodeBlock/index.js';
 export { Table } from './components/data-display/Table/index.js';
 export type { SortDirection, TableAlign, TableBodyProps, TableBreakpoint, TableCellProps, TableColumnProps, TableHeaderProps, TableProps, TableRowItem, TableRowProps, TableSelectionControl, TableSelectionMode, TableSize, TableSort, } from './components/data-display/Table/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plenustech/design-system",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Design System centralizado para os produtos web da Plenustech.",
   "license": "UNLICENSED",
   "publishConfig": {
@@ -20,6 +20,11 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./icons": {
+      "types": "./dist/types/icons.d.ts",
+      "import": "./dist/icons.js",
+      "require": "./dist/icons.cjs"
+    },
     "./styles.css": {
       "types": "./dist/folha.d.ts",
       "default": "./dist/design-system.css"
@@ -41,6 +46,7 @@
     "dev:showcase": "vite --config showcase/vite.config.ts",
     "build": "tsc -b && vite build && tsc -p tsconfig.build.json && node scripts/finaliza-pacote.mjs",
     "check:pacote": "node scripts/check-pacote.mjs",
+    "gerar:icones": "node scripts/gerar-icones.mjs",
     "check:contraste": "node scripts/check-contraste.mjs",
     "prepare": "npm run build:pacote",
     "build:showcase": "npm run build:pacote && vite build --config showcase/vite.config.ts",
@@ -79,6 +85,7 @@
     "@types/react": "^19.1.2",
     "@types/react-dom": "^19.1.2",
     "@vitejs/plugin-react": "^4.4.1",
+    "bootstrap-icons": "1.11.3",
     "jsdom": "^26.1.0",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",