@selectwin/kit 0.1.120 → 0.1.121

package/dist/SelectButton.d.ts

@@ -12,6 +12,10 @@ export interface SelectButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonE
     trailingIcon?: ReactNode;
     /** Size to content instead of filling the width (toolbars, inline actions). */
     inline?: boolean;
+    /** `critical` on a `secondary` button: the outlined button with red ink — the quiet
+     *  destructive action at the foot of a page ("Excluir produto"), where the solid `danger`
+     *  would shout louder than the page's own save. */
+    tone?: 'critical';
     children: ReactNode;
 }
 export declare const SelectButton: import('react').ForwardRefExoticComponent<SelectButtonProps & import('react').RefAttributes<HTMLButtonElement>>;

package/dist/SelectCombobox.d.ts

@@ -29,6 +29,11 @@ type SelectComboboxOwnProps = {
     /** Show the in-list search box (default true). Set false for a plain styled picker — the
      *  portal dropdown of SelectSelect without a search field (short option lists). */
     searchable?: boolean;
+    /** Aceita um valor que não está nas opções: o que foi digitado na busca vira a linha
+     *  `Usar "…"` (e o Enter escolhe). O valor livre continua aparecendo no gatilho. */
+    allowCustom?: boolean;
+    /** Rótulo da linha do valor livre. Padrão: `Usar "…"`. */
+    customLabel?: (query: string) => ReactNode;
 };
 export type SelectComboboxProps = SelectComboboxOwnProps & Omit<ComponentPropsWithoutRef<'div'>, keyof SelectComboboxOwnProps>;
 export declare const SelectCombobox: import('react').ForwardRefExoticComponent<SelectComboboxOwnProps & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, keyof SelectComboboxOwnProps> & import('react').RefAttributes<HTMLDivElement>>;

package/dist/SelectCopyableId.d.ts

@@ -16,5 +16,8 @@ export interface SelectCopyableIdProps {
      *  tabela. 'always' mantém o botão sempre visível: use fora de tabelas (menus,
      *  mastheads), onde não há hover de linha para revelar o affordance. */
     reveal?: 'hover' | 'always';
+    /** 'inline' (padrão) é o id discreto de tabela. 'code' é o chip tracejado de um código que a
+     *  pessoa digita (cupom): monoespaçado, com o botão de copiar sempre visível. */
+    variant?: 'inline' | 'code';
 }
-export declare function SelectCopyableId({ value, children, truncate, label, fallback, to, reveal, }: SelectCopyableIdProps): import("react").JSX.Element;
+export declare function SelectCopyableId({ value, children, truncate, label, fallback, to, reveal, variant, }: SelectCopyableIdProps): import("react").JSX.Element;

package/dist/SelectField.d.ts

@@ -11,6 +11,10 @@ type SelectLabelRowOwnProps = {
 };
 export type SelectLabelRowProps = SelectLabelRowOwnProps & Omit<ComponentPropsWithoutRef<'div'>, keyof SelectLabelRowOwnProps>;
 export declare const SelectLabelRow: import('react').ForwardRefExoticComponent<SelectLabelRowOwnProps & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, keyof SelectLabelRowOwnProps> & import('react').RefAttributes<HTMLDivElement>>;
+/** O contador "24/40" da linha do rótulo (`showCount`). Sem teto não há o que contar. */
+export declare function charCount(value: string, maxLength: number | undefined): ReactNode;
+/** Junta o contador à ação do rótulo — os dois cabem na mesma ponta da linha. */
+export declare function withCount(action: ReactNode, count: ReactNode): ReactNode;
 export interface SelectFieldProps {
     /** Field label. Omit when an outer row already labels the field. */
     label?: string;
@@ -55,6 +59,9 @@ export interface SelectFieldProps {
     id?: string;
     minLength?: number;
     maxLength?: number;
+    /** Contador "24/40" na linha do rótulo (exige `maxLength`). Para textos com teto que a pessoa
+     *  escreve — nome, título —, onde descobrir o limite pelo corte do teclado é pior que vê-lo chegar. */
+    showCount?: boolean;
     /** Numeric bounds (type="number"). */
     min?: number | string;
     max?: number | string;

package/dist/SelectImageGalleryField.d.ts

@@ -0,0 +1,40 @@
+import { ReactNode, ComponentPropsWithoutRef } from 'react';
+export interface SelectGalleryItem {
+    /** Chave estável: a própria url de uma imagem hospedada, um id gerado para um arquivo. */
+    key: string;
+    /** Imagem já hospedada (https://…). */
+    url?: string;
+    /** Arquivo escolhido agora — sobe no salvar; a prévia é um object URL. */
+    file?: File;
+}
+/** Item de galeria para um arquivo recém-escolhido (chave única, estável enquanto ele existir). */
+export declare function galleryItemFromFile(file: File): SelectGalleryItem;
+/** Item de galeria para uma imagem que já está hospedada. */
+export declare function galleryItemFromUrl(url: string): SelectGalleryItem;
+type SelectImageGalleryFieldOwnProps = {
+    label?: ReactNode;
+    /** Ajuda contextual: o "!" ao lado do rótulo. */
+    help?: ReactNode;
+    items: SelectGalleryItem[];
+    onChange: (items: SelectGalleryItem[]) => void;
+    /** Teto de fotos (o botão de adicionar some ao chegar). Padrão 10. */
+    max?: number;
+    /** Tipos aceitos, ex. '.jpg,.jpeg,.png,.webp'. */
+    accept?: string;
+    /** Teto por arquivo, em MB. */
+    maxSizeMB?: number;
+    hint?: ReactNode;
+    error?: string;
+    /** Oferece "Colar link de imagem" (padrão true). */
+    allowUrl?: boolean;
+    /** Lado do quadrado de cada foto, em px (padrão 88). */
+    tileSize?: number;
+    /** Rótulo do quadrado de adicionar (padrão "Adicionar"). */
+    addLabel?: string;
+    /** Selo da primeira foto (padrão "Capa"); `null` tira o selo e o "Tornar capa" (foto única). */
+    coverLabel?: string | null;
+    disabled?: boolean;
+};
+export type SelectImageGalleryFieldProps = SelectImageGalleryFieldOwnProps & Omit<ComponentPropsWithoutRef<'div'>, keyof SelectImageGalleryFieldOwnProps>;
+export declare const SelectImageGalleryField: import('react').ForwardRefExoticComponent<SelectImageGalleryFieldOwnProps & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, keyof SelectImageGalleryFieldOwnProps> & import('react').RefAttributes<HTMLDivElement>>;
+export {};

package/dist/SelectOfferPrice.d.ts

@@ -11,6 +11,11 @@ type SelectOfferPriceOwnProps = {
     zeroLabel?: ReactNode;
     /** Nota discreta ao lado do preço (o prazo de entrega, por exemplo). */
     note?: ReactNode;
+    /** Texto miúdo ANTES do preço — "a partir de", quando o card resume vários preços pelo menor. */
+    prefix?: ReactNode;
+    /** Texto miúdo colado DEPOIS do preço — a cadência de uma assinatura ("/mês", "a cada 3 meses").
+     *  Fica antes do "de" riscado: é parte do preço, não do desconto. */
+    suffix?: ReactNode;
 };
 export type SelectOfferPriceProps = SelectOfferPriceOwnProps & Omit<ComponentPropsWithoutRef<'div'>, keyof SelectOfferPriceOwnProps>;
 export declare const SelectOfferPrice: import('react').ForwardRefExoticComponent<SelectOfferPriceOwnProps & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, keyof SelectOfferPriceOwnProps> & import('react').RefAttributes<HTMLDivElement>>;

package/dist/SelectSegmented.d.ts

@@ -13,6 +13,12 @@ type SelectSegmentedOwnProps = {
     ariaLabel?: string;
     /** Stretch to 100% width with equal-width segments (forms/tabs). Default: hugs labels. */
     fullWidth?: boolean;
+    /** Form label above the track (wraps the control in the field shell). */
+    label?: ReactNode;
+    /** Helper line under the track (only with `label`). */
+    hint?: ReactNode;
+    /** Freeze the choice: segments don't respond and the track dims. */
+    disabled?: boolean;
 };
 export type SelectSegmentedProps = SelectSegmentedOwnProps & Omit<ComponentPropsWithoutRef<'div'>, keyof SelectSegmentedOwnProps>;
 export declare const SelectSegmented: import('react').ForwardRefExoticComponent<SelectSegmentedOwnProps & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, keyof SelectSegmentedOwnProps> & import('react').RefAttributes<HTMLDivElement>>;

package/dist/SelectTextarea.d.ts

@@ -20,6 +20,8 @@ type SelectTextareaOwnProps = {
     required?: boolean;
     disabled?: boolean;
     maxLength?: number;
+    /** Contador "96/400" na linha do rótulo (exige `maxLength`). */
+    showCount?: boolean;
     onBlur?: () => void;
     /** Control density. Default `md`; use `sm` in dense surfaces and modal/card forms. */
     size?: 'sm' | 'md';

package/dist/SelectToggle.d.ts

@@ -2,6 +2,8 @@ import { ReactNode, ComponentPropsWithoutRef } from 'react';
 type SelectToggleListOwnProps = {
     children: ReactNode;
     scroll?: boolean;
+    /** Hairline ABOVE the first row too — for a list that follows other fields in a form. */
+    bordered?: boolean;
 };
 export type SelectToggleListProps = SelectToggleListOwnProps & Omit<ComponentPropsWithoutRef<'div'>, keyof SelectToggleListOwnProps>;
 export declare const SelectToggleList: import('react').ForwardRefExoticComponent<SelectToggleListOwnProps & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, keyof SelectToggleListOwnProps> & import('react').RefAttributes<HTMLDivElement>>;
@@ -11,6 +13,10 @@ type SelectToggleRowOwnProps = {
     checked: boolean;
     onChange: (checked: boolean) => void;
     disabled?: boolean;
+    /** Quiet line under the label — what turning it on DOES. */
+    description?: ReactNode;
+    /** Revealed under the row while `checked` (the fields the switch turns on). */
+    children?: ReactNode;
 };
 export type SelectToggleRowProps = SelectToggleRowOwnProps & Omit<ComponentPropsWithoutRef<'div'>, keyof SelectToggleRowOwnProps>;
 export declare const SelectToggleRow: import('react').ForwardRefExoticComponent<SelectToggleRowOwnProps & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, keyof SelectToggleRowOwnProps> & import('react').RefAttributes<HTMLDivElement>>;

package/dist/icons.d.ts

@@ -106,6 +106,12 @@ export declare function MoneyReceiveIcon(): import("react").JSX.Element;
 export declare function ClipboardIcon(): import("react").JSX.Element;
 export declare function NoteIcon(): import("react").JSX.Element;
 export declare function DiscountIcon(): import("react").JSX.Element;
+/**
+ * Bilhete com o "%" — o glifo de UM cupom (o card da lista, a prévia do formulário). O
+ * `DiscountIcon` (o selo) continua sendo a SEÇÃO Cupons no menu: o recurso e o item dele
+ * não usam o mesmo desenho. Iconsax Linear "ticket-discount".
+ */
+export declare function TicketDiscountIcon(): import("react").JSX.Element;
 /**
  * Sinal saindo de um ponto — o glifo do RASTREIO (pixels do checkout). Não reaproveitar
  * `ChartLineIcon` aqui: aquele é o glifo do **Analytics** (item do menu lateral e empty

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export { SelectDocumentField } from './SelectDocumentField';
 export { SelectFileDropzone } from './SelectFileDropzone';
 export { SelectImageUrlsField } from './SelectImageUrlsField';
 export { SelectImageUploadField } from './SelectImageUploadField';
+export { SelectImageGalleryField, galleryItemFromFile, galleryItemFromUrl } from './SelectImageGalleryField';
 export { SelectBankAccountField } from './SelectBankAccountField';
 export { SelectFieldGrid } from './SelectFieldGrid';
 export { SelectToggleList, SelectToggleRow } from './SelectToggle';
@@ -214,6 +215,7 @@ export type { SelectDateRangeFieldProps, SelectDateRangeValue } from './SelectDa
 export type { SelectFileDropzoneProps } from './SelectFileDropzone';
 export type { SelectImageUrlsFieldProps } from './SelectImageUrlsField';
 export type { SelectImageUploadFieldProps, SelectImageUploadMode } from './SelectImageUploadField';
+export type { SelectImageGalleryFieldProps, SelectGalleryItem } from './SelectImageGalleryField';
 export type { SelectFileTileProps } from './SelectFileTile';
 export type { SelectKeyValuePair, SelectKeyValueEditorProps } from './SelectKeyValueEditor';
 export type { SelectBankAccount, SelectBankOption } from './SelectBankAccountField';