Typescript

Primitive Types

Tipi primitivi di @pzeta/vue-components — Severity, Size, SizeExtended, FormVariant, OptionValue.

Severity

export type Severity = 'primary' | 'secondary' | 'success' | 'info' | 'warn' | 'danger' | 'contrast' | 'help';

Determina il colore e lo stile visivo di un componente. Usato da Button, Badge, Tag, Toast, Message e tutti i componenti con varianti di colore.

Valore	Colore base	Uso tipico
`primary`	Blu	Azione principale del tema
`secondary`	Slate/grigio	Azione secondaria, colore neutro
`success`	Verde	Stato di successo, conferma operazione
`info`	Cyan	Informazione, notifica neutra
`warn`	Amber/arancione	Avvertimento, attenzione richiesta
`danger`	Rosso	Errore, azione distruttiva
`contrast`	Zinc	Alto contrasto, invertito rispetto al tema
`help`	Viola	Aiuto o suggerimento

Size

export type Size = 'small' | 'medium' | 'large';

Dimensione standard a tre livelli, usata dalla maggior parte dei componenti interattivi.

Valore	Descrizione
`small`	Dimensione ridotta per contesti compatti
`medium`	Dimensione standard (default nella maggior parte dei componenti)
`large`	Dimensione maggiore per enfasi visiva

SizeExtended

export type SizeExtended = Size | 'xlarge';

Estende Size con un quarto livello. Usata da componenti che richiedono una dimensione extra-large (es. Avatar, titoli grandi).

Valore	Descrizione
`small`	Compatto
`medium`	Standard
`large`	Maggiore
`xlarge`	Extra grande

FormVariant

export type FormVariant = 'outlined' | 'filled';

Variante visiva per i form control. Determina lo stile del bordo e dello sfondo dei campi di input.

Valore	Descrizione
`outlined`	Bordo visibile, sfondo trasparente (default)
`filled`	Sfondo riempito (`--color-surface-secondary`), bordo sottile

FormVariantExtended

export type FormVariantExtended = FormVariant | 'default';

Aggiunge il valore default per lasciare lo stile non definito esplicitamente, utile per componenti che ereditano la variante dal contesto.

OptionValue

export type OptionValue = string | number | boolean | Record<string, unknown> | null;

Tipo union per i valori delle opzioni nei componenti di selezione (Select, MultiSelect, Listbox, TreeSelect). Accetta qualsiasi tipo scalare o oggetto arbitrario, incluso null per rappresentare l'assenza di selezione.

IconPosition

export type IconPosition = 'left' | 'right' | 'top' | 'bottom';

Posizione di un'icona relativa al contenuto del componente.

DropdownFilterMatchMode

export type DropdownFilterMatchMode = 'startsWith' | 'contains' | 'endsWith';

Modalità di corrispondenza del filtro nei componenti dropdown con funzionalità di ricerca.

Valore	Descrizione
`startsWith`	Filtra le opzioni che iniziano con il testo inserito
`contains`	Filtra le opzioni che contengono il testo inserito
`endsWith`	Filtra le opzioni che terminano con il testo inserito

useTableStatePersistence

Composable interno per la persistenza dello stato della tabella in sessionStorage o localStorage con restore automatico al mount.

Base Props

Interfacce base riutilizzabili per componenti form e display — BaseFormControlProps, BaseStyledProps, BaseDropdownProps e altre.