@adabit/iu-kit

Libreria UI Angular per i componenti IU.

Prerequisiti obbligatori

• Angular 17.x
• peer deps installate:
  • @angular/cdk@^17.2.0
  • @fortawesome/angular-fontawesome@^0.15.0
  • @fortawesome/fontawesome-svg-core@^6.5.2
  • @ngx-translate/core@^17.0.0
• CSS globale libreria importato nel progetto host

Quick start (5 minuti)

1. Installa il pacchetto:

pnpm add @adabit/iu-kit

2. Verifica peer deps (se mancanti):

pnpm add @angular/cdk @fortawesome/angular-fontawesome @fortawesome/fontawesome-svg-core @ngx-translate/core

3. Aggiungi il CSS globale in angular.json:

{
  "projects": {
    "your-app": {
      "architect": {
        "build": {
          "options": {
            "styles": [
              "src/styles.scss",
              "node_modules/@adabit/iu-kit/styles/iu-theme.css"
            ]
          }
        }
      }
    }
  }
}

Nota: evita di copiare iu-theme.css in src/styles/. Importalo dal pacchetto per restare allineato agli aggiornamenti.

4. Importa il componente in una pagina standalone:

import { Component } from '@angular/core';
import { IuPasswordInputComponent } from '@adabit/iu-kit';

@Component({
  standalone: true,
  selector: 'app-login',
  imports: [IuPasswordInputComponent],
  template: `<iu-password-input [(model)]="password"></iu-password-input>`
})
export class LoginComponent {
  password = '';
}

Compatibilita ufficiale

| iu-kit | Angular | Note | |---|---|---| | 0.3.1 | 17.x | Baseline ufficiale |

Dettaglio completo: docs/compatibility-matrix.md (nel repository monorepo).

Changelog actionable

0.3.1

• Allineamento versioni monorepo per libreria, showcase e MCP.
• Aggiornati riferimenti pubblici alla release corrente.

0.2.3

• Fix packaging tema: styles/iu-theme.css incluso nel pacchetto npm.
• Allineamento integrazione: path ufficiale node_modules/@adabit/iu-kit/styles/iu-theme.css.

0.2.4

• Fix iu-select: freccia resa con CSS puro e clear button separato dal trigger.
• Fix demo file-uploader: import esplicito di CommonModule per *ngIf.
• Pulizia tecnica: rimossa la dashboard duplicata/non pubblica e i placeholder iu-kit.module.ts.
• Aggiornati documenti e template starter alla nuova baseline del pacchetto.

0.2.2

• Fix regressione iu-select overlay: apertura/chiusura stabile, niente click intercettati dal backdrop.
• Fix markup iu-select: rimossa annidazione button dentro button sul clear.
• Fix iu-theme-customizer: persistenza nativa opzioni (localStorage) con persistState e storageKey.
• Fix iu-toolbar: slot start/center/end shrink-safe su viewport strette.
• Fix iu-table: ridotto overflow orizzontale spurio e resize handle non debordante.

0.2.1

• Fix layout iu-password-input:
  • host-safe sizing (display:block, width:100%, min-width:0)
  • miglior gestione box model in contesti con layout vincolato
• Fix iu-public-layout:
  • rimosso overflow verticale indesiderato (box-sizing:border-box, 100dvh)
  • hardening min-width:0 su shell/card
• Fix iu-theme-customizer:
  • drawer body scrollabile con contenuto lungo
  • comportamento viewport-safe mobile/desktop
• Fix iu-menu:
  • separatori non piu tagliati quando non c'e scrollbar
• Fix iu-select:
  • dropdown panel reso via overlay (non clippato da overflow:hidden di card/container)
  • hardening search input/panel su box model per evitare overflow orizzontale
• Documentazione:
  • aggiunta guida esplicita su wiring del iu-theme-customizer
  • aggiunta matrice compatibilita e starter template Angular 17
• Packaging:
  • esportato styles/iu-theme.css nel pacchetto npm (node_modules/@adabit/iu-kit/styles/iu-theme.css)

0.2.0

• Introduzione del componente iu-public-layout.
• Introduzione del componente iu-password-input.
• Per integrazione corretta:
  • importa iu-theme.css negli stili globali
  • verifica peer deps allineate ad Angular 17

Theme Customizer Contract

iu-theme-customizer e un controller UI: emette eventi ma non applica automaticamente stato globale al DOM host.

• themeMode / density: richiedono wiring su attributi globali (data-iu-theme, data-iu-density, data-iu-theme-mode)
• flushLayout: richiede wiring sul tuo layout host ([flush] o classe CSS host)
• colori/font/fontSize: richiedono wiring su CSS variables globali

Recipe completa: docs/theme-customizer-wiring.md.

Sviluppo libreria

pnpm run build:lib
pnpm test

Starter consigliato: templates/angular17-starter (nel repository monorepo).