@adabit/iu-kit

Libreria UI Angular per i componenti IU.

Prerequisiti obbligatori

• Angular 20.x
• peer deps installate:
  • @angular/cdk@^20.0.0
  • @fortawesome/angular-fontawesome@^2.0.0
  • @fortawesome/fontawesome-svg-core@^6.5.2
  • @ngx-translate/core@^18.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.5.0 | 20.x | Gantt, theme system e showcase HUD | | 0.4.0 | 20.x | Angular 20 baseline | | 0.3.1 | 17.x | Baseline precedente |

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

Theme System

La libreria supporta una strategia temi strutturata basata su:

• token CSS globali --iu-*
• attributi root data-iu-theme, data-iu-theme-mode, data-iu-density, data-iu-theme-name
• preset esportati dalla public API

Temi built-in attualmente inclusi:

• base
• windows-95
• iron-man

Oggetti esportati:

import { IU_THEME_PRESETS, getIuThemePreset, IuThemeDefinition } from '@adabit/iu-kit';

Guida completa: docs/theme-system.md.

Changelog

0.5.0

• Added the IuGanttComponent with daily timeline, collapsible groups, milestones, progress, and dependencies.
• Added a structured theme system based on exported presets, root theme attributes, and global CSS tokens.
• Added the base, windows-95, and blue/cyan iron-man theme presets.
• Added the theme customizer showcase and documented the theme extension contract.
• Improved Iron Man styling across buttons, cards, layout panels, menus, form controls, overlays, and number inputs.
• Fixed corrupted UTF-8 separator text in the date range showcase.
• Updated the TagBox showcase mode controls to use IuButtonComponent.

0.4.0

• Updated the official baseline to Angular 20.
• Aligned peer dependencies with the supported major versions for internal library usage.
• Updated the toolchain to Angular CLI/build 20, ng-packagr 20, and TypeScript 5.8.

0.3.1

• Aligned monorepo versions for the library, showcase, and MCP.
• Updated public references to the current release.

0.2.3

• Fixed theme packaging: styles/iu-theme.css is included in the npm package.
• Aligned integration: the official path is node_modules/@adabit/iu-kit/styles/iu-theme.css.

0.2.4

• Fixed iu-select: rendered the arrow with pure CSS and separated the clear button from the trigger.
• Fixed the file-uploader demo: added an explicit CommonModule import for *ngIf.
• Technical cleanup: removed the duplicated/non-public dashboard and iu-kit.module.ts placeholders.
• Updated documentation and starter templates to the new package baseline.

0.2.2

• Fixed the iu-select overlay regression: stable open/close behavior with no clicks intercepted by the backdrop.
• Fixed iu-select markup: removed the nested button inside button for the clear action.
• Fixed iu-theme-customizer: native option persistence with persistState and storageKey.
• Fixed iu-toolbar: shrink-safe start/center/end slots on narrow viewports.
• Fixed iu-table: reduced spurious horizontal overflow and contained the resize handle.

0.2.1

• Fixed iu-password-input layout:
  • host-safe sizing (display:block, width:100%, min-width:0)
  • miglior gestione box model in contesti con layout vincolato
• Fixed iu-public-layout:
  • rimosso overflow verticale indesiderato (box-sizing:border-box, 100dvh)
  • hardening min-width:0 su shell/card
• Fixed iu-theme-customizer:
  • drawer body scrollabile con contenuto lungo
  • comportamento viewport-safe mobile/desktop
• Fixed iu-menu:
  • separatori non piu tagliati quando non c'e scrollbar
• Fixed 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
• Documentation:
  • 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

• Introduced the iu-public-layout component.
• Introduced the iu-password-input component.
• For correct integration:
  • import iu-theme.css in the global styles
  • verify that peer dependencies are aligned with 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)
• themeName: richiede wiring su data-iu-theme-name
• 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).