@nowline/cli 0.8.6 → 0.10.0

package/man/fr/nowline.5

@@ -2,12 +2,19 @@
 .\" prennent la forme de surcouches dans packages/cli/man/<locale>/nowline.5
 .\" lorsqu'elles existent. Voir specs/localization.md.
 .\"
+.\" Empreinte de la page anglaise relue pour cette traduction. Après avoir
+.\" reporté une modification de la page anglaise, remplacez-la par la ligne
+.\" qu'affiche packages/cli/test/man/translation-parity.test.ts.
+.\" translated-from: nowline.5 sha256:a09a86faed775a5d103a5758ccdaa55085238852506ec4c61af0b8a8f991132e
+.\"
 .\" Les mots-clés du DSL (nowline, config, roadmap, swimlane, item, parallel,
-.\" group, person, team, anchor, label, size, status, milestone, footnote,
-.\" include, style, symbol, default, scale, calendar) ainsi que les noms de
+.\" group, person, team, anchor, label, size, status, wave, milestone, footnote,
+.\" include, style, symbol, default, scale, calendar, non-working, working)
+.\" ainsi que les noms de
 .\" propriétés (size:, duration:, after:, before:, on:, owner:, capacity:,
 .\" labels:, link:, style:, status:, etc.) et les valeurs intégrées
-.\" (planned, in-progress, done, at-risk, blocked, business, full, custom)
+.\" (planned, in-progress, active, done, completed, at-risk, blocked,
+.\" business, full, custom)
 .\" restent en anglais : ce sont des éléments de syntaxe acceptés par
 .\" l'analyseur, pas des mots à traduire.
 .Dd $Mdocdate$
@@ -59,13 +66,13 @@ Section
 .Sy config
 (facultative).
 Configuration de production\ : styles, valeurs par défaut, échelle,
-calendrier, symboles.
+calendrier, symboles, jours non ouvrés et ouvrés.
 .It
 Section
 .Sy roadmap
 (obligatoire).
 Contenu\ : personnes, équipes, ancres, étiquettes, tailles, statuts,
-couloirs, éléments, jalons, notes de bas de page.
+vagues, couloirs, éléments, jalons, notes de bas de page.
 .El
 .Pp
 .Sy config
@@ -187,16 +194,18 @@ Les déclarations
 .Sy scale ,
 .Sy style ,
 .Sy symbol ,
-.Sy default
+.Sy default ,
+.Sy calendar ,
+.Sy non-working
 et
-.Sy calendar
+.Sy working
 du fichier inclus.
 .It Sy Roadmap
 La déclaration
 .Sy roadmap
 du fichier inclus, plus tout son contenu (personnes, équipes,
-ancres, étiquettes, tailles, statuts, couloirs, éléments, jalons,
-notes de bas de page).
+ancres, étiquettes, tailles, statuts, vagues, couloirs, éléments,
+jalons, notes de bas de page).
 .El
 .Pp
 Modes
@@ -209,6 +218,13 @@ En cas de collision, le
 .Em parent l'emporte
 et l'analyseur émet un avertissement identifiant la définition
 masquée et son fichier source.
+Une déclaration
+.Sy non-working
+ou
+.Sy working
+n'entre en collision qu'avec une déclaration du parent portant le même
+mot-clé et le même nom\ ; une déclaration sans nom n'entre jamais en
+collision et est toujours fusionnée.
 .It Sy ignore
 La configuration de l'enfant est entièrement abandonnée.
 Si le contenu roadmap de l'enfant est fusionné, il résout les
@@ -297,6 +313,40 @@ de fusion
 parce que
 .Sy start:
 définit la base temporelle commune.
+.Pp
+Les vagues ne fusionnent jamais.
+Pour toute inclusion dont le mode
+.Sy roadmap:
+n'est pas
+.Sy ignore ,
+si le fichier enfant déclare un
+.Sy roadmap ,
+possède des couloirs ou déclare des vagues, le parent et l'enfant
+doivent déclarer les mêmes vagues\ : les mêmes identifiants, dans le
+même ordre, avec les mêmes bornes de départ résolues.
+Les bornes sont comparées par la date qu'elles résolvent, de sorte
+que
+.Sy after:fy-budget
+et
+.Sy after:2026-02-02
+concordent lorsque l'ancre tombe à cette date.
+Une discordance, dans un sens comme dans l'autre, est l'erreur
+.Sy NL.E0202 ,
+signalée sur la ligne
+.Sy include
+du parent\ ; deux fichiers sans vagues passent.
+Les vagues sont des barrières sur tout le canevas\ : une liste de
+vagues masquée en silence déplacerait les colonnes de chaque couloir.
+Lorsque identifiants, ordre et bornes concordent, un titre,
+.Sy style: ,
+.Sy labels: ,
+.Sy link:
+ou une description différents donnent l'avertissement
+.Sy NL.W0701
+et la définition du parent est utilisée.
+Un enfant limité au vocabulaire (personnes, équipes, étiquettes,
+tailles, statuts, ancres\ ; ni roadmap, ni couloirs, ni vagues) ne
+participe pas.
 .Sh SECTION CONFIG
 Le marqueur de section facultatif
 .Sy config
@@ -305,14 +355,16 @@ apparaît avant
 Les mots-clés de configuration se trouvent au plus haut niveau (et
 non indentés sous le marqueur) et définissent vocabulaire de
 production, valeurs par défaut, paramètres d'axe, arithmétique des
-jours et symboles personnalisés.
+jours, jours non ouvrés et symboles personnalisés.
 .Pp
-Cinq mots-clés de configuration\ :
+Sept mots-clés de configuration\ :
 .Sy scale ,
 .Sy style ,
 .Sy symbol ,
 .Sy default ,
-.Sy calendar .
+.Sy calendar ,
+.Sy non-working ,
+.Sy working .
 Toute entrée de configuration est facultative\ ; si
 .Sy config
 est omise, toutes les valeurs intégrées par défaut s'appliquent.
@@ -410,6 +462,14 @@ Interdites, par type d'entité\ :
 .Sy date , link , description .
 .It Sy default footnote
 .Sy on , link , description .
+.It Sy chaque ligne default
+.Sy wave
+\(em le séquencement crée des dépendances invisibles, et il n'existe
+pas de
+.Sy default wave .
+C'est une erreur dans une roadmap avec vagues\ ; dans une roadmap
+sans vagues, la clé est ignorée avec l'avertissement
+.Sy NL.W0702 .
 .El
 .Pp
 Les propriétés de style brutes
@@ -501,7 +561,7 @@ Arithmétique des jours ouvrés d'ingénierie.
 Arithmétique des jours calendaires avec week-ends.
 .Sy days-per-week:7 ,
 .Sy days-per-month:30 ,
-.Sy days-per-quarter:90 ,
+.Sy days-per-quarter:91 ,
 .Sy days-per-year:365 .
 .It Sy calendar:custom
 Valeurs fournies par l'auteur via le bloc de configuration
@@ -543,6 +603,174 @@ C'est pourquoi le mode business donne
 .Sy 1y = 260d
 et non
 .Sy 12 \(mu 22d = 264d .
+.Ss non-working et working \(em déclarations
+Une déclaration
+.Sy non-working
+retire des jours du calendrier d'exécution\ : week-ends, jours fériés,
+fermetures.
+Une déclaration
+.Sy working
+en remet\ : un samedi de rattrapage ou un jour de récupération.
+Les deux sont des mots-clés de configuration et partagent une même
+forme\ :
+.Bd -literal -offset indent
+config
+
+non-working weekend "Weekend" every:[fri, sat]
+non-working new-year "New Year's Day" date:2027-01-01
+non-working summit "Company summit" start:2026-09-14 end:2026-09-16
+non-working fridays every:fri start:2026-07-01 end:2026-08-31
+working crunch "Crunch Saturday" date:2026-01-10
+.Ed
+.Pp
+L'identifiant et le titre sont tous deux facultatifs.
+Les durées ne comptent que les jours ouvrés\ : un élément qui traverse
+un jour non ouvré se termine plus tard, et un élément qui traverse une
+exception ouvrée se termine plus tôt.
+Le graphique étiquette une déclaration datée qui a un titre
+.Po
+.Sy date:
+ou
+.Sy start:
+avec
+.Sy end:
+et sans
+.Sy every:
+.Pc
+avec son titre et le nombre de jours ouvrés qu'elle retire, par exemple
+.Dq Thanksgiving \[u00B7] 2d .
+Sous
+.Sy hide
+l'étiquette est posée sur un trait de coupe à la jointure, et sous
+.Sy show
+au bord gauche de la bande grisée.
+Une déclaration
+.Sy working
+datée qui a un titre est étiquetée aux jours qu'elle rend ouvrés, avec
+son titre et le nombre de jours qu'elle ajoute, par exemple
+.Dq Crunch Saturday \[u00B7] +1d ,
+sans trait de coupe dans aucun des deux affichages\ ; un jour de
+récupération en semaine à l'intérieur d'une fermeture datée compte.
+Un titre sur une récurrence n'est pas dessiné.
+Une déclaration accepte ces propriétés\ :
+.Bl -tag -width "every:"
+.It Sy date:
+Une date ISO ou une liste de dates.
+.It Sy start:
+Une date ISO, incluse\ : le premier jour d'une plage, ou le jour où une
+récurrence commence.
+.It Sy end:
+Une date ISO, incluse\ : le dernier jour d'une plage, ou le jour où une
+récurrence s'arrête.
+Elle ne doit pas précéder
+.Sy start: .
+.It Sy every:
+Un jour de semaine ou une liste de
+.Sy sun , mon , tue , wed , thu , fri , sat .
+Une récurrence hebdomadaire.
+.El
+.Pp
+Une déclaration a exactement l'une de ces trois formes\ :
+.Sy date:
+seul\ ; une plage
+.Sy start:
+et
+.Sy end:
+sans
+.Sy every: \ ;
+ou
+.Sy every:
+avec des bornes
+.Sy start:
+et
+.Sy end:
+facultatives.
+Sans borne, une récurrence est sans fin et vaut chaque semaine.
+.Pp
+Un jour donné, la déclaration la plus précise l'emporte, et
+.Sy working
+l'emporte à égalité\ :
+.Bl -enum -offset indent -compact
+.It
+une déclaration datée, soit une liste
+.Sy date:
+soit une plage\ ;
+.It
+une récurrence bornée\ ;
+.It
+la semaine sans fin.
+.El
+.Pp
+L'ordre n'a jamais d'importance\ : les mêmes déclarations dans un ordre
+quelconque, dans le fichier ou dans des inclusions, donnent le même
+calendrier.
+.Sy calendar:business
+fournit une déclaration
+.Sy non-working weekend
+pour le samedi et le dimanche.
+Une déclaration
+.Sy non-working
+nommée
+.Sy weekend
+la remplace, quel que soit le préréglage, de sorte qu'une semaine
+vendredi-samedi n'exige pas de calendrier personnalisé\ ; tout autre nom
+s'ajoute au préréglage.
+.Pp
+La semaine sans fin doit garder un jour ouvré, et
+.Sy days-per-week
+doit concorder avec les jours de semaine qu'elle laisse ouvrés
+.Pq voir Sx VALIDATION .
+Une déclaration dont une valeur ou la forme est malformée est ignorée
+lors de la construction du calendrier.
+Avec
+.Sy config:isolate ,
+les déclarations de l'enfant restent dans sa région et n'ont pas encore
+d'effet sur le graphique\ : la région est tracée sur le calendrier de
+l'hôte.
+Le validateur ne lit que son propre fichier\ : une déclaration d'une
+inclusion n'est donc pas prise en compte par les vérifications de la
+semaine sans fin.
+.Ss non-working: \(em affichage des jours
+Avec
+.Sy calendar:business ,
+le week-end est non ouvré\ : les durées ne comptent que les jours ouvrés,
+et le graphique masque ces jours ou les dessine.
+L'affichage est une clé de style réservée à
+.Sy roadmap ,
+posée sur la ligne
+.Sy default roadmap
+(les clés de style brutes sont interdites sur la ligne
+.Sy roadmap
+elle-même)\ :
+.Bd -literal -offset indent
+config
+
+default roadmap non-working:show
+.Ed
+.Bl -tag -width "show"
+.It Sy hide Pq par défaut
+Les jours non ouvrés n'occupent aucune largeur\ ; chaque série se réduit à
+une couture.
+.It Sy show
+Les jours non ouvrés sont tracés à pleine largeur et ombrés.
+Une barre traverse un week-end mais s'arrête à la fin de son dernier jour
+ouvré, de sorte que l'écart entre des barres enchaînées reste visible.
+.El
+.Pp
+L'affichage ne modifie jamais le calendrier d'exécution\ : les sorties
+Mermaid, MS Project et XLSX sont identiques dans les deux vues.
+Il peut aussi être choisi au rendu\ ; la première source qui s'applique
+l'emporte\ : l'option
+.Fl -non-working
+(ou l'option équivalente d'une autre surface), la clé
+.Sy default roadmap non-working:
+du fichier, puis
+.Sy hide .
+Avec
+.Sy calendar:full
+et
+.Sy calendar:custom ,
+il n'y a pas de jours non ouvrés et la clé est sans effet.
 .Sh SECTION ROADMAP
 Le marqueur de section
 .Sy roadmap
@@ -593,19 +821,37 @@ résolu relativement au répertoire du fichier
 .Pa .nowline .
 Barres obliques sur toutes les plateformes\ ; seuls les chemins
 locaux sont acceptés.
+Le logo est dessiné à gauche du titre dans la carte d'en-tête,
+centré verticalement, et intégré à la sortie (SVG en ligne, image
+matricielle en URI de données base64).
 La résolution des ressources a lieu au moment du rendu, pas de
 l'analyse \(em un fichier référant un logo absent reste un
 document valide.
+Un logo absent, d'un format non pris en charge ou illisible produit
+un avertissement et le graphique est rendu comme si aucun logo
+n'était déclaré\ ; avec
+.Fl -strict ,
+c'est une erreur.
 .It Sy logo-size:
 Préréglage de taille
 .Pq Sy xs | sm | md | lg | xl ,
 .Sy md
 par défaut.
+Fixe la hauteur du logo dessiné (18, 24, 36, 48 ou 72\ px)\ ; la
+largeur suit les proportions du logo, si bien qu'une source plus
+grande ou plus petite est mise à l'échelle pour remplir le même
+emplacement.
+Un logo plus large que 160\ px à cette hauteur est réduit pour tenir.
+Un logo plus haut que le titre et l'auteur agrandit la carte
+d'en-tête\ ;
+.Sy xl
+agrandit aussi la bande de 72\ px de
+.Sy header-position:above .
 .El
 .Pp
-Douze mots-clés de la section roadmap\ :
+Treize mots-clés de la section roadmap\ :
 .Sy swimlane , item , parallel , group ,
-.Sy person , team , anchor , label , size , status , milestone ,
+.Sy person , team , anchor , label , size , status , wave , milestone ,
 .Sy footnote .
 Chacun suit le modèle universel
 .Sy [id] ["titre"] [clé:valeur...] .
@@ -700,15 +946,25 @@ swimlane platform
 .Pp
 Un
 .Sy group
-avec
-.Sy style: ,
-.Sy labels:
-ou d'autres propriétés visuelles est rendu avec une boîte
-englobante visible et une petite pastille de titre.
+est dessiné au-dessus et autour de ses éléments, jamais à côté\ :
+un en-tête (son titre au-dessus d'un crochet qui couvre exactement
+ses dates) sur un corps teinté de son
+.Sy bg ,
+avec une marge au-dessus et au-dessous.
+.Sy style:
+ne change que les couleurs.
 Un
+.Sy parallel
+est dessiné de la même façon, ses pistes empilées dans son corps.
+Dans une roadmap avec vagues, un
 .Sy group
-sans style est purement structurel \(em il ne régit que le
-séquencement et la croissance interne, sans artefact visible.
+sans titre, sans
+.Sy style:
+et sans
+.Sy labels:
+qui porte
+.Sy wave:
+ne dessine rien\ ; il ne fait qu'attribuer l'appartenance.
 .Ss anchor \(em date nommée sur la chronologie
 .Bd -literal -offset indent
 anchor kickoff date:2026-01-06
@@ -825,6 +1081,127 @@ au niveau de l'entité.
 Les déclarations
 .Sy status
 doivent précéder toute entité qui les référence.
+.Ss wave \(em barrière à travers tous les couloirs
+.Bd -literal -offset indent
+wave id ["titre"] [after:ancre|jalon|date] \e
+    [style:...] [labels:...] [link:...]
+.Ed
+.Pp
+Une
+.Sy wave
+(vague) est une barrière séquentielle stricte qui traverse tous les
+couloirs\ :
+.Em aucun élément de la vague k+1 ne démarre avant que
+.Em tous les éléments de la vague k soient terminés .
+Une vague s'ouvre pour chaque couloir à l'instant où le membre le
+plus lent de la vague précédente se termine\ ; les couloirs qui
+finissent plus tôt attendent à la frontière.
+Les vagues sont déclarées une seule fois, dans l'ordre, dans la
+section roadmap, et l'ordre de déclaration est l'ordre dans le
+temps.
+Le travail rejoint une vague avec la propriété
+.Sy wave:
+sur un
+.Sy item ,
+un
+.Sy group
+ou un
+.Sy parallel .
+.Bd -literal -offset indent
+wave discover "Discover"
+wave build "Build"
+wave launch "Launch" after:fy-budget
+
+swimlane web "Web"
+  item research "UX research" duration:2w wave:discover
+  group wave:build
+    item checkout "Checkout v2" duration:3w
+    item a11y "Accessibility pass" duration:1w
+  item launch-page "Launch page" duration:1w wave:launch
+swimlane ops "Ops"
+  item on-call "On-call and KTLO" duration:10w
+
+milestone beta "Beta" after:build
+.Ed
+.Pp
+Une ligne
+.Sy wave
+accepte\ :
+.Bl -tag -width "style:"
+.It Sy id
+Obligatoire
+.Pq Sy NL.E1100 .
+Rejoint l'espace de noms d'identifiants unique et partagé.
+.It Sy titre
+Facultatif.
+L'étiquette de la bande\ ; à défaut, l'identifiant.
+.It Sy after:
+Borne de départ facultative.
+La vague ne peut pas s'ouvrir avant le plus tardif de ses éléments.
+Chaque élément doit être un identifiant d'ancre, l'identifiant d'un
+jalon qui possède
+.Sy date: ,
+ou une date ISO (au plus une date)\ ; tout autre type d'entité est
+.Sy NL.E1106 .
+Un écart entre la fin d'une vague et la borne de la suivante est
+permis.
+.It Sy style:
+Couleurs de la vague\ : le
+.Sy bg
+du style teinte la colonne de la vague,
+.Sy fg
+colore sa ligne de frontière,
+.Sy text
+son étiquette de bande et
+.Sy border
+fixe le tracé de la frontière.
+.It Sy labels: , link: , description
+Conservées dans le modèle, l'export JSON et XLSX et l'infobulle
+LSP\ ; non dessinées.
+.El
+.Pp
+Clés non autorisées sur une
+.Sy wave\ :
+.Sy before: , date: , start: , length: , duration: , size: ,
+.Sy capacity: , remaining: , wave:
+.Pq Sy NL.E1105 .
+L'étendue d'une vague provient de ses éléments.
+Pour donner une échéance à une vague, ajoutez un jalon daté
+.Sy after:<vague>\ ;
+il devient rouge lorsque la vague prend du retard.
+.Pp
+Les éléments sans vague effective sont du
+.Em travail de fond
+\(em astreinte, support, maintenance continue.
+Une barrière ne retient jamais le travail de fond et sa propre fin
+n'allonge jamais une vague, mais il suit toujours l'ordre du couloir
+et son propre
+.Sy after: .
+Le travail de fond est dessiné hachuré.
+.Pp
+Un identifiant de vague est une cible valide pour
+.Sy after: ,
+.Sy before:
+et
+.Sy on: .
+.Sy after:<vague>
+démarre au plus tôt à la fin de cette vague, et un
+.Sy milestone after:<vague>
+flottant se place sur la frontière de clôture de la vague.
+.Sy before:<vague>
+doit se terminer avant le début de la vague (souple, comme tout
+.Sy before: ) .
+.Sy on:<vague>
+rattache une note de bas de page à la vague.
+Les références à une vague ne tracent aucune flèche de dépendance.
+.Pp
+Une roadmap
+.Qq a des vagues
+lorsqu'elle déclare au moins une vague avec un identifiant valide.
+Dans une roadmap sans vagues, toute clé
+.Sy wave:
+est ignorée avec l'avertissement
+.Sy NL.W0702 .
 .Ss milestone \(em marqueur de réussite
 .Bd -literal -offset indent
 milestone v1-ga "v1 GA" date:2026-06-30
@@ -854,7 +1231,7 @@ footnote capacity-risk "Team capacity risk" on:[mobile, platform]
 .Pp
 .Sy on:
 est obligatoire et référence un ou plusieurs identifiants
-(élément, couloir, ancre, jalon, personne, équipe).
+(élément, couloir, ancre, jalon, vague, personne, équipe).
 Pour plusieurs cibles, utilisez la notation entre crochets\ :
 .Sy on:[id1, id2] .
 Les notes de bas de page sont numérotées séquentiellement par
@@ -918,8 +1295,8 @@ et la sous-directive
 .Sh PROPRIÉTÉS UNIVERSELLES
 Ces propriétés sont valides sur tous les types d'entités\ :
 éléments, couloirs, blocs parallèles, groupes, jalons, ancres,
-personnes, équipes, étiquettes, tailles, statuts, notes de bas de
-page.
+vagues, personnes, équipes, étiquettes, tailles, statuts, notes de
+bas de page.
 .Bl -tag -width "description"
 .It Sy labels:
 Liste.
@@ -955,7 +1332,8 @@ Les propriétés de style brutes
 .Sy bg , Sy fg , Sy text , Sy border , Sy icon , Sy shadow ,
 .Sy font , Sy weight , Sy italic , Sy text-size , Sy padding ,
 .Sy spacing , Sy header-height , Sy corner-radius , Sy bracket ,
-.Sy capacity-icon , Sy timeline-position , Sy minor-grid
+.Sy header-position , Sy capacity-icon , Sy timeline-position ,
+.Sy minor-grid , Sy non-working
 .Pc
 ne peuvent apparaître que dans des blocs
 .Sy style
@@ -968,6 +1346,9 @@ qui vivent toutes deux dans
 et
 .Sy before
 sont aussi valides sur les couloirs, blocs parallèles et groupes.
+.Sy wave
+est aussi valide sur les blocs parallèles et les groupes, mais pas
+sur les couloirs.
 Les autres sont réservées aux éléments.
 .Bl -tag -width "remaining"
 .It Sy status:
@@ -991,13 +1372,34 @@ Identifiant ou liste entre crochets.
 L'entité démarre après la fin de l'entité référencée.
 .Sy after:[a, b]
 démarre après le dernier des terminaux.
-Accepte des identifiants d'élément, jalon, ancre, parallel ou
-group.
+Accepte des identifiants d'élément, jalon, ancre, parallel, group
+ou vague.
 .It Sy before:
 Identifiant ou liste entre crochets.
 L'entité doit se terminer avant le début de l'entité référencée.
 .Sy before:[a, b]
 se termine avant le premier des démarrants.
+.It Sy wave:
+Identifiant de vague.
+Exactement une
+.Sy wave
+déclarée
+.Po Sy wave:build Pc Ns \ ;
+un élément appartient à une seule vague au plus.
+La vague effective d'un élément est sa propre valeur, sinon celle
+du
+.Sy group
+ou du
+.Sy parallel
+englobant le plus proche qui en porte une\ ; un couloir n'en
+transmet jamais.
+Un descendant peut répéter la valeur de son conteneur mais pas en
+changer
+.Pq Sy NL.E1102 .
+Un bloc sans
+.Sy wave:
+peut contenir des enfants de vagues différentes.
+Significative seulement dans une roadmap avec vagues.
 .It Sy size:
 Alias de taille.
 .Sy size:l
@@ -1255,12 +1657,34 @@ La valeur par défaut varie selon l'entité.
 .Sy none | xs | sm | md Pq par défaut | lg | xl .
 Réservée à
 .Sy roadmap .
+Hauteur du bandeau des dates de la frise : 16, 20, 24, 32 ou 40 px de
+.Sy xs
+à
+.Sy xl ,
+les libellés restant centrés verticalement.
+Elle s'applique au bandeau du haut comme au bandeau miroir du bas.
+.Sy none
+supprime tous les bandeaux de dates, y compris ceux que demande
+.Sy timeline-position\ ;
+avec
+.Sy bottom
+ou
+.Sy both ,
+cela déclenche l'avertissement
+.Sy NL.W0704 .
 .It Sy corner-radius
 .Sy none | xs | sm | md | lg | xl | full .
 .It Sy bracket
-.Sy none Pq par défaut | solid | dashed .
-Réservée à
-.Sy parallel .
+.Sy none | solid | dashed .
+Le crochet d'en-tête au-dessus des dates d'un groupe ou d'un
+parallèle\ :
+.Sy solid
+par défaut sur un groupe,
+.Sy dashed
+sur un parallèle\ ;
+.Sy none
+le masque.
+Réservée aux conteneurs.
 .It Sy capacity-icon
 Glyphe utilisé comme suffixe des nombres de capacité.
 Identifiants intégrés\ :
@@ -1276,6 +1700,17 @@ Identifiants intégrés\ :
 Personnalisé\ : tout identifiant
 .Sy symbol \ ;
 en ligne\ : un littéral Unicode entre guillemets doubles.
+.It Sy header-position
+.Sy beside Pq par défaut | above .
+Réservée à
+.Sy roadmap .
+Emplacement de la carte d'en-tête de la roadmap (titre et auteur)\ :
+.Sy beside
+la place dans une colonne à gauche du graphique, large de 120 à 240 px,
+le titre passant à la ligne pour tenir\ ;
+.Sy above
+la place dans un bandeau pleine largeur de 72 px de haut au-dessus du
+graphique, qui s'étend alors sur toute la largeur du canevas.
 .It Sy timeline-position
 .Sy top Pq par défaut | bottom | both .
 Réservée à
@@ -1290,6 +1725,24 @@ Lorsque
 .Sy true ,
 trace de fines lignes de grille pointillées à chaque frontière de
 graduation.
+.It Sy non-working
+.Sy hide Pq par défaut | show .
+Réservée à
+.Sy roadmap ;
+à placer sur
+.Sy default roadmap .
+Avec un calendrier qui comporte des jours non ouvrés
+.Pq Sy calendar:business ,
+.Sy hide
+les réduit à une couture et
+.Sy show
+trace chaque série à pleine largeur sous forme de bande ombrée que les
+barres traversent.
+L'option
+.Fl -non-working
+de
+.Xr nowline 1
+et son équivalent sur chaque autre surface la remplacent.
 .El
 .Pp
 Les noms d'icône intégrés sont rendus à partir d'une bibliothèque
@@ -1341,8 +1794,8 @@ lettres, chiffres, tirets bas et tirets, commençant par une
 lettre ou un tiret bas.
 Ils doivent être uniques sur le résultat fusionné (le fichier et
 toutes ses inclusions)\ ; éléments, blocs parallèles, groupes,
-ancres, personnes, équipes, jalons et notes de bas de page
-partagent un seul espace de noms.
+ancres, vagues, personnes, équipes, jalons et notes de bas de
+page partagent un seul espace de noms.
 .Pp
 La forme idiomatique de Nowline utilise le kebab-case, mais
 .Sy authRefactor ,
@@ -1372,7 +1825,7 @@ et
 .Sy before:
 acceptent chacune un seul identifiant ou une liste entre crochets.
 Les références peuvent viser des éléments, jalons, ancres, blocs
-parallèles ou groupes.
+parallèles, groupes ou vagues.
 .Bl -bullet -offset indent -compact
 .It
 .Sy after:id
@@ -1393,6 +1846,17 @@ référencée (ou avant la date de l'ancre référencée).
 \(em se termine avant le début
 .Em du plus tôt
 des entités référencées.
+.It
+.Sy after:vague
+\(em démarre au plus tôt à la
+.Em fin
+de la vague.
+.Sy before:vague
+\(em doit se terminer avant le
+.Em début
+de la vague.
+.Sy on:vague
+\(em rattache une note de bas de page à la vague.
 .El
 .Pp
 Les dépendances cycliques à travers le graphe complet (y compris
@@ -1439,7 +1903,9 @@ par fichier (sous réserve du mode
 .Sy roadmap: ) .
 .It
 Tous les identifiants sont uniques sur le résultat fusionné.
-Le parent l'emporte en cas de collision, avec un avertissement.
+Le parent l'emporte en cas de collision, avec un avertissement
+(sauf les vagues\ ; voir
+.Sx INCLUSIONS ) .
 .It
 Toute entité doit avoir au moins un identifiant ou un titre (ou
 les deux).
@@ -1469,9 +1935,10 @@ première ligne fautive.
 .It
 Les déclarations
 .Sy label ,
-.Sy size
-et
+.Sy size ,
 .Sy status
+et
+.Sy wave
 doivent apparaître dans la section roadmap.
 Les placer avant
 .Sy roadmap
@@ -1489,12 +1956,14 @@ doivent résoudre vers des identifiants déclarés dans la portée
 fusionnée.
 .It
 Une référence
-.Sy size:
-ou
+.Sy size: ,
 .Sy status:
+ou
+.Sy wave:
 doit résoudre vers une déclaration apparaissant
 .Em plus tôt dans le fichier
-(ou dans une inclusion antérieure).
+(ou dans une inclusion antérieure\ ; les inclusions ne fournissent
+jamais de vagues).
 Les références anticipées sont une erreur.
 .It
 Pas de dépendances cycliques dans les chaînes
@@ -1554,6 +2023,39 @@ fraction décimale positive, ou
 Lorsque les deux seuils numériques sont définis,
 .Sy warn-at \(<= over-at .
 .It
+Valeurs de style, dans un bloc
+.Sy style
+ou sur une ligne
+.Sy default ,
+les clés
+.Sy bg: , fg:
+et
+.Sy text:
+prennent une couleur nommée, une valeur hexadécimale ou
+.Sy none
+.Pq Sy NL.E0801 ;
+une clé à ensemble de valeurs fixe, comme
+.Sy border: , shadow:
+ou
+.Sy font: ,
+prend l'une de ces valeurs
+.Pq Sy NL.E0802 .
+Une clé d'un bloc
+.Sy style
+qui n'est pas une propriété de style est
+.Sy NL.E0803 .
+.It
+Une propriété de style brute
+.Pq Sy bg: , Sy icon: , Sy capacity-icon: , No ...
+sur une entité de la section roadmap est
+.Sy NL.E0804 ;
+déclarez un
+.Sy style
+nommé dans
+.Sy config
+et référencez-le avec
+.Sy style:id .
+.It
 La valeur de
 .Sy capacity-icon:
 doit être un identifiant intégré
@@ -1566,6 +2068,57 @@ en portée, ou un littéral Unicode entre guillemets doubles.
 Même contrat pour
 .Sy icon: .
 .It
+La valeur de
+.Sy non-working:
+doit être
+.Sy hide
+ou
+.Sy show ,
+sur
+.Sy default roadmap
+et dans un bloc
+.Sy style .
+Toute autre valeur est
+.Sy NL.E0800
+(une erreur par valeur).
+.It
+Les clés de style propres à la roadmap
+.Sy header-height , header-position , timeline-position ,
+.Sy minor-grid
+et
+.Sy non-working
+ne s'appliquent que sur
+.Sy default roadmap
+(ou dans un bloc
+.Sy style
+référencé par la roadmap).
+Sur toute autre ligne
+.Sy default ,
+elles sont ignorées avec l'avertissement
+.Sy NL.W0703 .
+Les blocs
+.Sy style
+ne sont pas vérifiés.
+.It
+Lorsque le style de la roadmap définit
+.Sy header-height:none
+avec
+.Sy timeline-position:bottom
+ou
+.Sy both ,
+aucun bandeau de dates n'est dessiné, ce qui déclenche l'avertissement
+.Sy NL.W0704 .
+Le style se résout à partir de
+.Sy default roadmap ,
+puis du style de chaque label de la ligne
+.Sy roadmap
+(le premier label l'emportant), puis de son propre
+.Sy style: ,
+la dernière clé l'emportant.
+Seuls les styles et labels déclarés dans le même fichier sont lus\ ; un
+.Sy style:
+ou un label venant d'un include laisse la vérification silencieuse.
+.It
 .Sy remaining:
 est soit un pourcentage
 .Pq Sy 0% \(en Sy 100%
@@ -1594,6 +2147,65 @@ Lorsque
 les quatre entrées
 .Sy days-per-*
 sont obligatoires et doivent être des entiers positifs.
+.It
+Une déclaration
+.Sy non-working
+ou
+.Sy working
+a l'une de trois formes\ : un
+.Sy date:
+seul\ ;
+.Sy start:
+et
+.Sy end:
+sans
+.Sy every: \ ;
+ou
+.Sy every:
+avec des bornes facultatives
+.Pq Sy NL.E0900 .
+Ses seules clés sont
+.Sy date: , start: , end:
+et
+.Sy every:
+.Pq Sy NL.E0901 ,
+et
+.Sy start:
+et
+.Sy end:
+prennent chacun une seule date
+.Pq Sy NL.E0902 .
+.It
+Chaque date d'une déclaration de calendrier est un jour réel du
+calendrier
+.Pq Sy NL.E0405 ,
+et
+.Sy end:
+ne précède pas
+.Sy start:
+.Pq Sy NL.E0903 .
+.It
+Les valeurs de
+.Sy every:
+sont des noms de jours de semaine
+.Pq Sy NL.E0904
+et chacune apparaît au plus une fois
+.Pq Sy NL.E0905 .
+.It
+La semaine sans fin garde au moins un jour ouvré
+.Pq Sy NL.E0906 .
+.Sy days-per-week
+concorde avec les jours de semaine qu'elle laisse ouvrés\ ; un écart
+donne l'avertissement
+.Sy NL.W0705 .
+.It
+Un identifiant de déclaration est unique pour son mot-clé dans un
+fichier
+.Pq Sy NL.E0907 .
+.Sy non-working
+et
+.Sy working
+ne partagent pas d'espace de noms.
 .El
 .Ss Propriété roadmap start
 .Bl -bullet -offset indent -compact
@@ -1691,7 +2303,113 @@ identiques.
 Une discordance est une erreur signalée sur la ligne
 .Sy include
 du parent.
+.It
+Pour toute inclusion dont le mode
+.Sy roadmap:
+n'est pas
+.Sy ignore ,
+un enfant participant (qui déclare une roadmap, des couloirs ou des
+vagues) doit déclarer les mêmes vagues, dans le même ordre, avec les
+mêmes bornes de départ résolues, que le parent
+.Pq Sy NL.E0202 .
+Un titre ou une autre présentation différents donnent
+l'avertissement
+.Sy NL.W0701 .
+.It
+Avec
+.Sy config:merge ,
+une déclaration
+.Sy non-working
+ou
+.Sy working
+n'entre en collision qu'avec une déclaration du parent portant le même
+mot-clé et le même nom, et le parent l'emporte avec un avertissement\ ;
+les déclarations sans nom n'entrent jamais en collision.
+.El
+.Ss Vagues
+Ces règles s'appliquent aux fichiers qui utilisent
+.Sy wave
+ou
+.Sy wave: .
+Chacune a un code de diagnostic stable.
+.Bl -tag -width "NL.E1100" -offset indent -compact
+.It Sy NL.E1100
+Une déclaration
+.Sy wave
+sans identifiant.
+.It Sy NL.E1101
+Une valeur
+.Sy wave:
+qui n'est pas exactement une vague déclarée plus tôt\ : liste de
+deux ou plus, identifiant non déclaré, référence anticipée ou
+identifiant d'un autre type.
+.It Sy NL.E1102
+Le
+.Sy wave:
+d'un descendant diffère de celui de son conteneur.
+.It Sy NL.E1103
+L'ordre des vagues ne peut pas être réalisé\ : du travail devrait
+démarrer à la fin de sa propre vague ou après, à cause de l'ordre du
+couloir, d'une jointure
+.Sy parallel
+ou d'un
+.Sy after:
+qui désigne la propre vague de l'élément, une vague
+ultérieure ou du travail d'une vague ultérieure
+(directement ou par une chaîne d'autres travaux).
+.It Sy NL.E1104
+.Sy wave:
+sur un couloir, un jalon ou toute entité autre qu'item, group ou
+parallel.
+.It Sy NL.E1105
+Une clé non autorisée sur une vague
+.Po
+.Sy before: , date: , start: , length: , duration: , size: ,
+.Sy capacity: , remaining: , wave:
+.Pc .
+.It Sy NL.E1106
+Le
+.Sy after:
+d'une vague désigne autre chose qu'une ancre, un jalon daté ou une
+date ISO unique.
+.It Sy NL.W1100
+Un
+.Sy before:
+que la structure des vagues rend impossible à respecter.
+.It Sy NL.W1101
+Un
+.Sy after:
+ou
+.Sy before:
+que la mise en page ignore dans une roadmap avec vagues\ : référence
+anticipée, référence au group ou parallel englobant, ou référence à
+un jalon flottant.
+.It Sy NL.W0702
+.Sy wave:
+(y compris sur une ligne
+.Sy default )
+dans une roadmap sans vagues\ ; la clé est ignorée.
 .El
+.Pp
+L'accord des inclusions relève de
+.Sy NL.E0202
+et
+.Sy NL.W0701
+(voir
+.Sx INCLUSIONS ) .
+La mise en page ajoute quatre constats\ :
+.Sy NL.W1002
+(le solveur de barrières ne s'est pas stabilisé),
+.Sy NL.I1006
+(vagues sans éléments),
+.Sy NL.I1007
+(une vague dépasse un jalon daté dont le
+.Sy after:
+la désigne) et
+.Sy NL.I1008
+(un élément dont la date
+.Sy after:
+tombe un jour non ouvré démarre le jour ouvré suivant).
 .Ss parallel et group
 .Bl -bullet -offset indent -compact
 .It
@@ -1735,6 +2453,13 @@ Une déclaration
 qui définit une propriété interdite
 .Pq voir Sx SECTION CONFIG
 est une erreur.
+.It
+.Sy wave
+est interdite sur toute ligne
+.Sy default <entité>\ :
+erreur lorsque la roadmap a des vagues, avertissement
+.Sy NL.W0702
+lorsqu'elle n'en a pas.
 .El
 .Ss Symboles
 .Bl -bullet -offset indent -compact
@@ -1743,23 +2468,40 @@ Toute déclaration
 .Sy symbol
 doit spécifier une valeur
 .Sy unicode:"<chaîne>"
-non vide.
+.Pq Sy NL.E0806 ,
+non vide
+.Pq Sy NL.E0807 .
 .It
 .Sy ascii: ,
 si présente, doit être une chaîne entre guillemets de longueur
-\(<= 3 caractères ASCII.
+\(<= 3 caractères ASCII
+.Pq Sy NL.E0808 .
+.It
+Un
+.Sy symbol
+n'accepte que
+.Sy unicode: , ascii: , link:
+et
+.Sy description: ;
+toute autre propriété est
+.Sy NL.E0809 .
 .It
 Un identifiant de
 .Sy symbol
-ne doit pas masquer un nom d'icône intégré.
+ne doit pas masquer un nom d'icône intégré
+.Pq Sy NL.E0805
+et doit être unique dans le fichier
+.Pq Sy NL.E0810 .
 .It
 Une référence
 .Sy symbol
 .Pq Sy icon:NOM ou Sy capacity-icon:NOM
 doit résoudre vers un nom intégré ou vers une déclaration
 .Sy symbol
-antérieure.
-Les références anticipées sont une erreur.
+antérieure
+.Pq Sy NL.E0811 .
+Les références anticipées sont une erreur
+.Pq Sy NL.E0812 .
 .El
 .Sh EXEMPLES
 Un fichier
@@ -1846,6 +2588,38 @@ footnote "Vendor dependency" on:audit-log
 footnote capacity-risk "Team capacity risk" on:[mobile, platform]
   description "Mobile team is down to 2 engineers through Q2."
 .Ed
+.Pp
+Une roadmap compacte avec vagues\ :
+.Bd -literal -offset indent
+nowline v1
+
+roadmap checkout-relaunch "Checkout relaunch" \e
+    start:2026-01-05 scale:1w calendar:full
+
+wave foundations "Foundations"
+wave build "Build"
+wave launch "Launch"
+
+swimlane platform "Platform"
+  item auth "Auth service split" duration:4w wave:foundations
+  item payments-api "Payments API v2" duration:8w wave:build
+  item rate-limits "Rate limits" duration:2w wave:launch
+
+swimlane web "Web"
+  item ux-research "Checkout UX research" duration:2w \e
+    wave:foundations
+  group wave:build
+    item checkout-v2 "Checkout v2" duration:4w
+    item a11y "Accessibility pass" duration:2w
+  item launch-page "Launch page" duration:2w wave:launch
+
+// Sans wave : travail de fond, jamais retenu par une barrière.
+swimlane ops "Ops"
+  item on-call "On-call and KTLO" duration:18w
+
+milestone beta "Beta" after:build
+milestone ga "GA" after:launch
+.Ed
 .Sh VOIR AUSSI
 .Xr nowline 1
 .Pq Sy man 1 nowline