@selectwin/kit 0.1.49 → 0.1.50

package/dist/SelectChartCard.d.ts

@@ -3,6 +3,9 @@ type SelectChartCardOwnProps = {
     title?: ReactNode;
     caption?: ReactNode;
     action?: ReactNode;
+    /** Ajuda contextual do card: o que o gráfico mostra / como ler. Vira o "!" ao lado do
+     *  título (SelectInfoTip) — hover no desktop, toque no mobile. */
+    help?: ReactNode;
     loading?: boolean;
     /** Blur the chart body (sensitive amounts) — wire to the hide-values toggle. */
     hideValues?: boolean;

package/dist/SelectDataTable.d.ts

@@ -40,7 +40,7 @@ export interface SelectDataColumn<T> {
  * guards mirror SelectMoney — storage unavailable = in-memory only.
  */
 export declare function useSelectPageSize(key: string, fallback: number, options?: number[]): [number, (size: number) => void];
-export declare function SelectDataTable<T>({ columns, items, getId, loading, empty, pagination, onRowClick, title, action, filters, columnsKey, }: {
+export declare function SelectDataTable<T>({ columns, items, getId, loading, empty, pagination, onRowClick, title, help, action, filters, columnsKey, }: {
     columns: SelectDataColumn<T>[];
     items: T[];
     getId: (item: T) => string;
@@ -87,6 +87,8 @@ export declare function SelectDataTable<T>({ columns, items, getId, loading, emp
     /** Card title in the table's own header bar — renders a self-contained titled card
      *  (don't wrap in SelectSection; the table is already a card). */
     title?: ReactNode;
+    /** Ajuda contextual: vira o "!" ao lado do título (SelectInfoTip). Precisa de `title`. */
+    help?: ReactNode;
     /** Right-aligned header action (e.g. an "Adicionar" button). */
     action?: ReactNode;
     /** Filter controls (e.g. a SelectFilterBar) embedded in the table's header bar, left of

package/dist/SelectInfoTip.d.ts

@@ -0,0 +1,14 @@
+import { ReactNode, ComponentPropsWithoutRef } from 'react';
+import { SelectPlacement } from './positioning';
+type SelectInfoTipOwnProps = {
+    /** O texto de ajuda (uma ou duas frases; o balão tem largura máxima). */
+    content: ReactNode;
+    /** Linha de título em negrito acima do texto. */
+    title?: ReactNode;
+    /** Rótulo acessível do gatilho. Default: "Mais informações". */
+    label?: string;
+    placement?: SelectPlacement;
+};
+export type SelectInfoTipProps = SelectInfoTipOwnProps & Omit<ComponentPropsWithoutRef<'button'>, keyof SelectInfoTipOwnProps>;
+export declare const SelectInfoTip: import('react').ForwardRefExoticComponent<SelectInfoTipOwnProps & Omit<Omit<import('react').DetailedHTMLProps<import('react').ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, keyof SelectInfoTipOwnProps> & import('react').RefAttributes<HTMLButtonElement>>;
+export {};

package/dist/SelectKpiCard.d.ts

@@ -4,6 +4,9 @@ type SelectKpiCardOwnProps = {
     value: ReactNode;
     caption?: ReactNode;
     chart?: ReactNode;
+    /** Ajuda contextual: o que este número significa / como é calculado. Vira o "!" ao lado
+     *  do rótulo (SelectInfoTip) — hover no desktop, toque no mobile. */
+    help?: ReactNode;
     /**
      * Colour the VALUE when the number itself is the alarm — "3 crons parados", "2 DLQs com
      * backlog". Omit for a neutral metric: a KPI that is always red stops meaning anything.

package/dist/SelectSection.d.ts

@@ -1,6 +1,10 @@
 import { ReactNode, ComponentPropsWithoutRef } from 'react';
 type SelectSectionOwnProps = {
     title?: ReactNode;
+    /** Ajuda contextual: vira o "!" ao lado do título (SelectInfoTip). IGNORADA quando
+     *  `collapsible` — ali o head inteiro é um <button>, e botão dentro de botão é DOM
+     *  inválido. */
+    help?: ReactNode;
     /** Subdued line under the title (e.g. the step subtitle of a wizard card). */
     description?: ReactNode;
     /** Right-aligned action in the head (e.g. an "Editar" link). Ignored when collapsible. */

package/dist/SelectTable.d.ts

@@ -17,6 +17,8 @@ type SelectTableOwnProps = {
     /** Card title in the table's own header bar (e.g. "Variantes"). Renders the table as
      *  a self-contained titled card — do NOT wrap it in a SelectSection (card-in-card). */
     title?: ReactNode;
+    /** Ajuda contextual: vira o "!" ao lado do título (SelectInfoTip). Precisa de `title`. */
+    help?: ReactNode;
     /** Right-aligned action in the header bar (e.g. an "Adicionar" button). */
     action?: ReactNode;
     /** Filter controls (e.g. a SelectFilterBar) embedded in the header bar, left of the

package/dist/SelectTooltip.d.ts

@@ -1,8 +1,12 @@
 import { ReactNode } from 'react';
 import { SelectPlacement } from './positioning';
-export declare function SelectTooltip({ content, children, placement, delay, }: {
+export declare function SelectTooltip({ content, children, placement, delay, openOnClick, }: {
     content: ReactNode;
     children: ReactNode;
     placement?: SelectPlacement;
     delay?: number;
+    /** Click/tap pins the tip open (dismiss with an outside click or Escape). Required for
+     *  touch, where hover never happens. While pinned the tip accepts the pointer, so the
+     *  text can be selected. */
+    openOnClick?: boolean;
 }): import("react").JSX.Element;

package/dist/index.d.ts

@@ -72,6 +72,8 @@ export { SelectModal } from './SelectModal';
 export { SelectPopover } from './SelectPopover';
 export { SelectActionList } from './SelectActionList';
 export { SelectTooltip } from './SelectTooltip';
+export { SelectInfoTip } from './SelectInfoTip';
+export type { SelectInfoTipProps } from './SelectInfoTip';
 export { SelectRowActions } from './SelectRowActions';
 export { SelectConfirmModal } from './SelectConfirmModal';
 export { SelectFormModal } from './SelectFormModal';