@cityway/bo-ui 1.1.0-beta010 → 1.1.0-beta013

package/docs/components/drag-n-drop-nested-list.md

@@ -29,11 +29,11 @@ Liste hiérarchique réordonnable par glisser-déposer (CDK drag-drop), pilotée
 | Input | Type | Défaut | Description |
 |-------|------|--------|-------------|
 | `items` | `DragItem[]` | `[]` | Arbre des items à afficher. Le composant en fait une **copie interne mutable** sur laquelle le CDK opère. Voir §3. |
-| `itemTemplate` | `TemplateRef<any> \| undefined` | `undefined` | Template du **corps** de carte (slot). Reçoit `$implicit = item` et `depth`. Si absent, fallback interne (label + code). |
+| `itemTemplate` | `TemplateRef<any> \| undefined` | `undefined` | Template du **corps** de carte (slot). Reçoit `$implicit = item` et `depth`. Si absent, **aucun corps n'est rendu** — sauf `item.code`, affiché seul (le titre de l'en-tête porte déjà `title ?? label`). |
 | `column` | `DragListColumn \| undefined` | `undefined` | Configuration de la colonne : titre, défauts de visibilité des actions, libellés, plafonds. Voir §3. |
 | `reorderOnDrop` | `boolean` | `true` | Renumérote `order` (1..n par niveau) récursivement à chaque drop. `false` = déplacement visuel seul, `order` intact. |
 | `maxDepth` | `number \| undefined` | `undefined` | Profondeur max (0-based, racine = 0). Une carte à `depth < maxDepth` peut recevoir des enfants ; `>= maxDepth` est terminale. `undefined` = imbrication infinie. Ex. `maxDepth = 1` → 2 niveaux. |
-| `selectedId` | `number \| string \| undefined` | `undefined` | Sélection **exclusive** gérée par la lib : la carte dont `id === selectedId` reçoit la classe `ddn-list-card-selected`. Une seule carte à la fois, tout niveau confondu. Le flag `DragItem.selected` reste supporté en parallèle. |
+| `selectedId` | `number \| string \| undefined` | `undefined` | Sélection **exclusive** gérée par la lib : la carte dont `id === selectedId` reçoit la classe `ddn-list-card-selected` — **elle seule**, jamais ses parents (voir §5, « Rendu de la sélection en profondeur »). Le flag `DragItem.selected` reste supporté en parallèle. ⚠️ Les `id` doivent être uniques **sur tout l'arbre**, pas seulement par niveau. |
 
 ### Outputs
 
@@ -60,6 +60,8 @@ Le **corps** de chaque carte est fourni par un `TemplateRef` passé à `[itemTem
 
 > L'en-tête (titre, sous-titre, badge, compteur, actions, poignée) reste **toujours** data-driven ; seul le corps est personnalisable.
 
+Sans `[itemTemplate]`, la carte se réduit à son en-tête : le composant ne réaffiche pas le label, qui est déjà le titre. Seul `item.code`, s'il est renseigné, est rendu dans le corps. C'est le mode à privilégier quand l'en-tête suffit — chaque corps redondant coûte une hauteur de carte à tous les niveaux de l'arbre.
+
 ---
 
 ## 3. Modèles & types
@@ -67,8 +69,8 @@ Le **corps** de chaque carte est fourni par un `TemplateRef` passé à `[itemTem
 ```ts
 interface DragItem {
   id: number | string;            // clé de tri (trackBy) — unique
-  label: string;                  // libellé (fallback de title, corps par défaut)
-  code?: string;                  // affiché dans le corps par défaut
+  label: string;                  // libellé (fallback de title dans l'en-tête)
+  code?: string;                  // affiché seul dans le corps quand il n'y a pas d'itemTemplate
   order?: number;                 // position 1..n (renumérotée si reorderOnDrop)
   disabled?: boolean;             // verrouille le drag de CETTE carte (poignée inactive)
   children?: DragItem[];          // sous-arbre
@@ -101,8 +103,8 @@ interface DragItemActions {       // chaque champ = visibilité (booléen). unde
 
 interface DragListColumn {
   title: string;                  // titre de colonne (clé i18n) — affiché « Titre (count) » / « (count/max) »
-  description?: string;
-  descriptionRwd?: string;
+  description?: string;           // IGNORÉ par ce composant (n'existe que pour cw-drag-n-drop-list)
+  descriptionRwd?: string;        // idem
   cssClass?: string;              // classe sur chaque <ul> de niveau
 
   collapsible?: boolean;          // cartes pliables (défaut true) ; false désactive globalement
@@ -256,6 +258,10 @@ restore(t: DragItem) {
 onReorder(items: DragItem[]) { this.items = items; }
 ```
 
+**Rendu en profondeur.** Une seule carte est peinte à l'écran, jamais toute une branche. La carte sélectionnée porte `ddn-list-card-selected` ; un parent qui la contient ne porte `ddn-list-card-has-selection` que **s'il est replié** — la carte sélectionnée n'étant alors pas rendue (`destroyOnHide` de `cw-card`), le parent en reprend le rendu et signale « un élément actif est là-dedans ». Déplié, il redevient neutre. La lib suit le pliage réel de chaque carte via `(collapseClicked)`, pas seulement l'état initial.
+
+⚠️ **Unicité des `id`.** La correspondance se fait sur `id === selectedId` à tous les niveaux. Si un item de niveau 1 et un item de niveau 2 partagent le même `id` (typique quand chaque niveau vient d'une table différente : thème `1`, fichier `1`), **les deux cartes s'allument**. Préfixer côté hôte (`` `theme-${t.id}` ``, `` `file-${f.id}` ``) ou utiliser une clé composite.
+
 ### Corps de carte custom (`itemTemplate`)
 
 ```html
@@ -272,12 +278,12 @@ onReorder(items: DragItem[]) { this.items = items; }
 
 ## 5. Notes d'intégration
 
-- **CDK drag-drop** : repose sur `@angular/cdk/drag-drop` (`DragDropModule`). Chaque niveau est un `cdkDropList` **isolé** (pas de `cdkDropListConnectedTo`) → le tri est **intra-liste à chaque niveau**, jamais entre niveaux ni entre listes. Le drag ne démarre que depuis la **poignée** (`cdkDragHandle`).
+- **CDK drag-drop** : repose sur `@angular/cdk/drag-drop` (`DragDropModule`). Chaque niveau est un `cdkDropList` **isolé** (pas de `cdkDropListConnectedTo`) → le tri est **intra-liste à chaque niveau**, jamais entre niveaux ni entre listes. Le drag ne démarre que depuis la **poignée** (`cdkDragHandle`). Poignée inactive (carte `disabled` ou `pendingDelete`) : elle garde son rendu normal, seule l'interaction disparaît — le rendu `disabled` du `.btn` (aplat plein `base-disabled`) est neutralisé sur `.ddn-list-handle`, sinon une poignée morte est plus voyante qu'une poignée active.
 - **Source de vérité** : le composant clone `items` dans une copie interne mutable (`_items`) à chaque changement (effect). C'est cette copie que le CDK déplace ; l'arbre réordonné est émis via `itemsChange`. **Persister** ce payload côté hôte (sinon un re-rendu ultérieur repart de l'ordre périmé).
 - **Imbrication & `maxDepth`** : `maxDepth` est 0-based (racine = 0). `maxDepth = 1` ⇒ 2 niveaux. `undefined` ⇒ imbrication infinie (ajout possible partout).
 - **Type de carte alterné** : la lib alterne `CardTypeEnum.default` (profondeur paire) / `light` (impaire).
 - **i18n** : tous les libellés (`column.title`, `addLabel`, `maxReachedLabel`, `restoreBlockedLabel`, libellés de badge…) passent par `translate` → fournir des **clés**, pas du texte en dur.
-- **États & styles** : la lib **lit** `selected` / `selectedId` / `pendingDelete` et pose les classes DS (`ddn-list-card-selected`, `ddn-list-card-deleting`) ; elle ne mute pas les flags. C'est l'hôte qui les flippe et re-passe `items`. Préférer `selectedId` (exclusif, sans parcours d'arbre) au flag `selected` (multi-sélection non garantie).
+- **États & styles** : la lib **lit** `selected` / `selectedId` / `pendingDelete` et pose les classes DS (`ddn-list-card-selected`, `ddn-list-card-has-selection`, `ddn-list-card-deleting`) ; elle ne mute pas les flags. C'est l'hôte qui les flippe et re-passe `items`. Préférer `selectedId` (exclusif, sans parcours d'arbre) au flag `selected` (multi-sélection non garantie).
 - **Soft-delete** : sur une carte `pendingDelete`, le corps est masqué (carte compacte, non pliable, non déplaçable) et la corbeille devient « Restaurer » (émet `restore`, pas `delete`). En mode `excludePendingDeleteFromMax`, restaurer peut être **bloqué** si le niveau est entre-temps redevenu plein.
 
 ---

package/docs/components/import-wizard.md

@@ -109,7 +109,7 @@ interface ImportWizardConfig {
   modes: readonly [ImportModeOption, ...ImportModeOption[]];  // jamais vide ; 1 élément = imposé
   interruption: ImportInterruption;  // requis : ce qui se passe vraiment à l'arrêt
   showErrorDetails?: boolean;        // [Option]
-  scope?: ImportScopeEnum;           // défaut list
+  scope: ImportScope;                // requis — voir ci-dessous
 }
 ```
 
@@ -139,6 +139,26 @@ Aucune de ces situations n'est rattrapée à l'exécution : elles ne compilent p
 
 ---
 
+### `scope` — et le nom de l'objet importé
+
+`scope` est un type discriminé : le libellé de l'objet **voyage avec la portée qui l'affiche**, comme `keyFieldHint` voyage avec son mode. Indéclarable en `singleConfig` (aucun compteur n'y est rendu), inoubliable en `list`.
+
+```ts
+scope: { kind: ImportScopeEnum.list, objectLabel: i18nKey('DOMAIN.USER') }
+// ou
+scope: { kind: ImportScopeEnum.singleConfig }
+```
+
+`objectLabel` est une clé **racine**, suffixée par le composant de la catégorie de pluriel de la langue active — exactement comme les libellés de compteur. Le bundle de l'application doit donc déclarer les trois catégories :
+
+```jsonc
+"DOMAIN": { "USER": { "one": "utilisateur", "many": "utilisateurs", "other": "utilisateurs" } }
+```
+
+Rendu : « **2 431** utilisateurs à ajouter ».
+
+> ⚠️ **Accord.** Les libellés du *rapport* sont des participes passés accordés au masculin pluriel (« … ajoutés », « … supprimés »). Un nom féminin (« lignes ») donnerait « lignes ajoutés ». Le cas échéant, surcharger `_COMMON._IMPORT._COUNTS.REPORT_*` dans le bundle de l'application — le deepmerge du loader donne le dernier mot à l'application.
+
 ## 4. Exemples
 
 ### Import d'une liste, ouvert depuis le bouton *Importer* de l'en-tête
@@ -270,7 +290,7 @@ readonly configImport: ImportWizardConfig = {
   accept: '.json',
   acceptLabel: 'JSON',
   modes: [{ mode: ImportModeEnum.replaceAll }],  // un seul mode => imposé, lecture seule
-  scope: ImportScopeEnum.singleConfig,           // pas de compteurs, message de conformité
+  scope: { kind: ImportScopeEnum.singleConfig }, // pas de compteurs, message de conformité
   interruption: { kind: ImportInterruptionEnum.atomic },   // back-end transactionnel
   source: { analyze: …, execute: … },
 };