@starterlib/ui 0.4.0 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starterlib/ui",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Bibliotheque de composants st-* du socle frontal starter, sur CDK et Aria.",
   "license": "UNLICENSED",
   "sideEffects": false,
@@ -25,8 +25,8 @@
     "@angular/forms": "^22.1.0",
     "@angular/cdk": "^22.1.0",
     "@angular/aria": "^22.1.0",
-    "@starterlib/tokens": "^0.4.0",
-    "@starterlib/util": "^0.4.0"
+    "@starterlib/tokens": "^0.5.0",
+    "@starterlib/util": "^0.5.0"
   },
   "peerDependenciesMeta": {
     "@angular/cdk": {

package/types/starterlib-ui-interactions.d.ts

@@ -265,5 +265,52 @@ declare class StMultiselect extends ContratDeChamp implements FormValueControl<r
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StMultiselect, "st-multiselect", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": true; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
-export { StCombobox, StMultiselect, StSidenav, StSidenavToggle, StTabContent, StTabPanel, StTabs };
-export type { ActivationDOnglet, FiltrageDeListe, ModeDeNavigation, Onglet, OrientationDOnglets };
+/** Un noeud, decrit en donnees. */
+interface NoeudDArbre {
+    /** Identifiant stable : il porte la selection et le depliage. */
+    readonly valeur: string;
+    readonly libelle: string;
+    readonly enfants?: readonly NoeudDArbre[];
+    readonly desactive?: boolean;
+}
+/**
+ * Arbre de donnees hierarchiques, sur `@angular/aria/tree` : dossiers, plan
+ * comptable, organisation.
+ *
+ * ```html
+ * <st-tree etiquette="Plan comptable" [noeuds]="comptes" [(selection)]="compte" [(deplies)]="ouverts" />
+ * ```
+ *
+ * ⚠️ **Jamais pour la navigation du site** (UX-17) : une navigation est une liste
+ * de liens, que le lecteur d'ecran liste et parcourt comme telle. Un arbre se
+ * parcourt aux fleches, un element a la fois, et ses elements ne sont pas des
+ * liens. Le mode « navigation » de la primitive n'est donc pas expose.
+ *
+ * ⚠️ **Les noeuds sont rendus par le composant, a partir de donnees** (FE-6) : la
+ * primitive relie un element a son arbre par injection, et un contenu projete
+ * garde l'injecteur de l'endroit ou il est ecrit — lecon de `st-menu`.
+ *
+ * Clavier de la primitive : fleches haut et bas entre les elements visibles,
+ * droite pour deplier ou entrer, gauche pour replier ou remonter, Debut et Fin,
+ * recherche a la frappe ; Espace ou Entree choisit. Selection et depliage sont des
+ * listes de VALEURS, lisibles et restaurables par l'application.
+ */
+declare class StTree {
+    /** Nom de l'arbre, lu a l'entree. Obligatoire. */
+    readonly etiquette: _angular_core.InputSignal<string>;
+    readonly noeuds: _angular_core.InputSignal<readonly NoeudDArbre[]>;
+    readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly selection: _angular_core.ModelSignal<readonly string[]>;
+    readonly deplies: _angular_core.ModelSignal<readonly string[]>;
+    /** La primitive attend un tableau modifiable ; le modele est en lecture seule. */
+    protected readonly valeursChoisies: _angular_core.Signal<string[]>;
+    private readonly ensembleDeplie;
+    protected estDeplie(noeud: NoeudDArbre): boolean;
+    protected surDepliage(noeud: NoeudDArbre, deplie: boolean): void;
+    protected surSelection(valeurs: readonly string[]): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StTree, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StTree, "st-tree", never, { "etiquette": { "alias": "etiquette"; "required": true; "isSignal": true; }; "noeuds": { "alias": "noeuds"; "required": true; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "deplies": { "alias": "deplies"; "required": false; "isSignal": true; }; }, { "selection": "selectionChange"; "deplies": "depliesChange"; }, never, never, true, never>;
+}
+
+export { StCombobox, StMultiselect, StSidenav, StSidenavToggle, StTabContent, StTabPanel, StTabs, StTree };
+export type { ActivationDOnglet, FiltrageDeListe, ModeDeNavigation, NoeudDArbre, Onglet, OrientationDOnglets };

package/types/starterlib-ui-surfaces.d.ts

@@ -82,7 +82,7 @@ type TonDElementDeMenu = Extract<Ton, 'neutre' | 'danger'>;
  * actions par leur libelle, donc par leur traduction.
  */
 declare class StMenuItem {
-    readonly icone: i0.InputSignal<"boite-vide" | "calendrier" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "fichier" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "televerser" | "triangle-alerte" | "utilisateur" | null>;
+    readonly icone: i0.InputSignal<"boite-vide" | "calendrier" | "cercle" | "cercle-coche" | "cercle-croix" | "cercle-info" | "chevron-bas" | "chevron-droite" | "chevron-gauche" | "chevron-haut" | "coche" | "copie" | "corbeille" | "croix" | "fichier" | "hors-ligne" | "lien-externe" | "menu" | "oeil" | "oeil-barre" | "plus" | "rafraichir" | "recherche" | "serveur" | "televerser" | "tri" | "triangle-alerte" | "utilisateur" | null>;
     readonly ton: i0.InputSignal<TonDElementDeMenu>;
     static ɵfac: i0.ɵɵFactoryDeclaration<StMenuItem, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<StMenuItem, "button[stMenuItem]", never, { "icone": { "alias": "icone"; "required": false; "isSignal": true; }; "ton": { "alias": "ton"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, [{ directive: typeof i1.MenuItem; inputs: { "value": "valeur"; "disabled": "desactive"; "role": "role"; }; outputs: {}; }]>;