@quazardous/qdadm 2.51.0 → 2.53.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (129) hide show
  1. package/dist/node/cards/tools/cardsTool.d.ts +32 -0
  2. package/dist/node/cards/tools/cardsTool.js +151 -0
  3. package/dist/node/cards/tools/cli.d.ts +2 -0
  4. package/dist/node/cards/tools/cli.js +38 -0
  5. package/dist/node/cards/validate.d.ts +35 -0
  6. package/dist/node/cards/validate.js +94 -0
  7. package/dist/styles/qdadm.css +1 -1
  8. package/package.json +7 -2
  9. package/src/board/QdBoardBlock.vue +67 -0
  10. package/src/board/QdDomainBoard.vue +64 -0
  11. package/src/board/blocks/BreakdownBlock.vue +44 -0
  12. package/src/board/blocks/KpiBlock.vue +31 -0
  13. package/src/board/blocks/TimelineBlock.vue +63 -0
  14. package/src/board/blocks/TopBlock.vue +57 -0
  15. package/src/board/blocks/schemas.ts +107 -0
  16. package/src/board/index.ts +31 -0
  17. package/src/board/registry.ts +33 -0
  18. package/src/board/types.ts +32 -0
  19. package/src/cards/QdCard.vue +175 -0
  20. package/src/cards/QdCardView.vue +53 -0
  21. package/src/cards/QdCardsGallery.vue +103 -0
  22. package/src/cards/QdFavoritesCard.vue +50 -0
  23. package/src/cards/QdRecentCard.vue +44 -0
  24. package/src/cards/builtin/agenda/AgendaCard.vue +37 -0
  25. package/src/cards/builtin/agenda/meta.json +60 -0
  26. package/src/cards/builtin/agenda/schema.json +48 -0
  27. package/src/cards/builtin/bullet/BulletCard.vue +76 -0
  28. package/src/cards/builtin/bullet/meta.json +38 -0
  29. package/src/cards/builtin/bullet/schema.json +18 -0
  30. package/src/cards/builtin/cards-index.json +1694 -0
  31. package/src/cards/builtin/compare/CompareCard.vue +47 -0
  32. package/src/cards/builtin/compare/meta.json +79 -0
  33. package/src/cards/builtin/compare/schema.json +40 -0
  34. package/src/cards/builtin/favorites/FavoritesCard.vue +50 -0
  35. package/src/cards/builtin/favorites/meta.json +33 -0
  36. package/src/cards/builtin/favorites/schema.json +20 -0
  37. package/src/cards/builtin/feed/FeedCard.vue +39 -0
  38. package/src/cards/builtin/feed/meta.json +64 -0
  39. package/src/cards/builtin/feed/schema.json +54 -0
  40. package/src/cards/builtin/funnel/FunnelCard.vue +44 -0
  41. package/src/cards/builtin/funnel/meta.json +53 -0
  42. package/src/cards/builtin/funnel/schema.json +37 -0
  43. package/src/cards/builtin/goal/GoalCard.vue +73 -0
  44. package/src/cards/builtin/goal/meta.json +43 -0
  45. package/src/cards/builtin/goal/schema.json +12 -0
  46. package/src/cards/builtin/heat/HeatCard.vue +46 -0
  47. package/src/cards/builtin/heat/meta.json +101 -0
  48. package/src/cards/builtin/heat/schema.json +39 -0
  49. package/src/cards/builtin/index.ts +71 -0
  50. package/src/cards/builtin/metric/MetricCard.vue +82 -0
  51. package/src/cards/builtin/metric/meta.json +109 -0
  52. package/src/cards/builtin/metric/schema.json +35 -0
  53. package/src/cards/builtin/pills.ts +36 -0
  54. package/src/cards/builtin/queue/QueueCard.vue +65 -0
  55. package/src/cards/builtin/queue/meta.json +47 -0
  56. package/src/cards/builtin/queue/schema.json +32 -0
  57. package/src/cards/builtin/ranking/RankingCard.vue +37 -0
  58. package/src/cards/builtin/ranking/meta.json +71 -0
  59. package/src/cards/builtin/ranking/schema.json +35 -0
  60. package/src/cards/builtin/recent/RecentCard.vue +41 -0
  61. package/src/cards/builtin/recent/meta.json +32 -0
  62. package/src/cards/builtin/recent/schema.json +21 -0
  63. package/src/cards/builtin/shared.ts +83 -0
  64. package/src/cards/builtin/split/SplitCard.vue +52 -0
  65. package/src/cards/builtin/split/meta.json +72 -0
  66. package/src/cards/builtin/split/schema.json +40 -0
  67. package/src/cards/builtin/trend/TrendCard.vue +75 -0
  68. package/src/cards/builtin/trend/meta.json +81 -0
  69. package/src/cards/builtin/trend/schema.json +58 -0
  70. package/src/cards/index.ts +29 -0
  71. package/src/cards/registry.ts +57 -0
  72. package/src/cards/tools/cardsTool.ts +181 -0
  73. package/src/cards/tools/cli.ts +35 -0
  74. package/src/cards/types.ts +111 -0
  75. package/src/cards/validate.ts +111 -0
  76. package/src/components/edit/FormActions.vue +9 -5
  77. package/src/components/edit/FormPage.vue +17 -2
  78. package/src/components/layout/AppLayout.vue +4 -0
  79. package/src/components/layout/BaseLayout.vue +4 -0
  80. package/src/components/layout/CardParamsForm.vue +157 -0
  81. package/src/components/layout/CardsDashboard.vue +276 -57
  82. package/src/components/layout/PageHeader.vue +22 -1
  83. package/src/components/layout/QdFavoriteStar.vue +71 -0
  84. package/src/components/layout/Zone.vue +2 -1
  85. package/src/components/lists/ListPage.vue +9 -1
  86. package/src/components/lists/QdSaveSearch.vue +79 -0
  87. package/src/components/pages/NotFoundPage.vue +5 -2
  88. package/src/components/run/QdRunBar.vue +99 -0
  89. package/src/components/show/ShowPage.vue +10 -1
  90. package/src/composables/useBreadcrumb.ts +1 -1
  91. package/src/composables/useCardsArrangement.ts +297 -27
  92. package/src/composables/useEntityItemFormPage.ts +39 -3
  93. package/src/composables/useEntityItemFormPage.types.ts +8 -0
  94. package/src/composables/useEntityItemShowPage.ts +22 -0
  95. package/src/composables/useListPage.ts +71 -0
  96. package/src/composables/useListPage.types.ts +6 -0
  97. package/src/composables/useUnsavedChangesGuard.ts +17 -1
  98. package/src/domain/QdBadge.vue +36 -0
  99. package/src/domain/QdDomainBar.vue +213 -0
  100. package/src/domain/QdDomainBarZone.vue +19 -0
  101. package/src/domain/index.ts +6 -0
  102. package/src/domain/registry.ts +122 -0
  103. package/src/favorites/index.ts +7 -0
  104. package/src/favorites/store.ts +172 -0
  105. package/src/favorites/useFavorites.ts +217 -0
  106. package/src/i18n/defaults/core.en.generated.ts +132 -0
  107. package/src/i18n/defaults/core.en.yml +132 -0
  108. package/src/i18n/defaults/core.fr.generated.ts +132 -0
  109. package/src/i18n/defaults/core.fr.yml +132 -0
  110. package/src/index.ts +23 -0
  111. package/src/kernel/Kernel.routing.ts +4 -15
  112. package/src/kernel/Kernel.types.ts +5 -1
  113. package/src/kernel/Kernel.vue.ts +2 -2
  114. package/src/kernel/KernelContext.routing.ts +10 -1
  115. package/src/kernel/KernelContext.ts +7 -0
  116. package/src/kernel/KernelContext.types.ts +2 -0
  117. package/src/kernel/homeRoute.ts +45 -0
  118. package/src/module/moduleRegistry.ts +4 -0
  119. package/src/run/index.ts +6 -0
  120. package/src/run/run.ts +162 -0
  121. package/src/run/useRun.ts +207 -0
  122. package/src/styles/_cards-dashboard.scss +190 -0
  123. package/src/styles/_qd-board.scss +359 -0
  124. package/src/styles/_qd-cards.scss +1197 -0
  125. package/src/styles/_qd-domain-bar.scss +159 -0
  126. package/src/styles/_qd-run.scss +135 -0
  127. package/src/styles/index.scss +4 -0
  128. package/src/zones/ZoneRegistry.ts +16 -0
  129. package/src/zones/index.ts +1 -0
@@ -254,6 +254,35 @@ export default `core:
254
254
  trayView: Afficher les cartes masquées en
255
255
  viewCards: Cartes
256
256
  viewCompact: Compact
257
+ # Le catalogue, les cartes à paramètres, les tailles, les sections (#5348)
258
+ addCard: Ajouter une carte
259
+ catalogue: Ajouter une carte
260
+ catalogueEmpty: Toutes les cartes sont déjà sur le tableau
261
+ hiddenNow: "Cachée : elle revient à sa place"
262
+ add: Ajouter
263
+ addOne: "Ajouter {title}"
264
+ added: "{title} ajoutée"
265
+ remove: "Retirer {title}"
266
+ removed: "{title} retirée"
267
+ cardTitle: Titre
268
+ choose: Choisir…
269
+ inSection: Dans la section
270
+ paramRequired: À remplir
271
+ paramInvalid: "Valeur invalide : {problem}"
272
+ size: "Taille de {title}"
273
+ sizeS: Petite
274
+ sizeM: Moyenne
275
+ sizeL: Grande
276
+ resized: "{title} : {size}"
277
+ addSection: Ajouter une section
278
+ firstSection: Principal
279
+ newSection: Nouvelle section
280
+ sectionName: Nom de la section
281
+ sectionAdded: "Section {title} ajoutée"
282
+ removeSection: "Supprimer la section {title}"
283
+ sectionRemoved: "Section {title} supprimée, ses cartes vont dans la première"
284
+ section: "Section de {title}"
285
+ movedToSection: "{title} déplacée dans {section}"
257
286
  # SessionsModule (#4336)
258
287
  sessions:
259
288
  title: Sessions
@@ -365,6 +394,54 @@ export default `core:
365
394
  moreKeys: "+{count} autres"
366
395
  takeTheirs: Charger sa version
367
396
  keepMine: Garder la mienne et l'enregistrer par-dessus
397
+ # Cards (#5339): the envelope's words and the generic cards'
398
+ cards:
399
+ status:
400
+ critical: Critique
401
+ watch: À surveiller
402
+ good: Bon
403
+ info: Info
404
+ loading: Lecture…
405
+ unreachable: Source injoignable
406
+ galleryUnreachable: "La source n'a pas répondu (délai de 10 s dépassé)"
407
+ empty: Rien à signaler
408
+ invalid: Données invalides
409
+ moreProblems: "et {count} de plus"
410
+ overdue: en retard
411
+ compare:
412
+ points: pt
413
+ trend:
414
+ within: Dans la normale
415
+ outside: "{count} point hors de la normale | {count} points hors de la normale"
416
+ split:
417
+ others: Autres
418
+ funnel:
419
+ loss: "−{count} entre {from} et {to}"
420
+ heat:
421
+ low: Moins
422
+ high: "Plus (jusqu'à {max})"
423
+ agenda:
424
+ today: Aujourd'hui
425
+ tomorrow: Demain
426
+ yesterday: Hier
427
+ tomorrowAt: "Demain {time}"
428
+ yesterdayAt: "Hier {time}"
429
+ ageUnit:
430
+ min: min
431
+ h: h
432
+ d: j
433
+ goal:
434
+ of: "sur {target}"
435
+ reached: "{share} de l'objectif"
436
+ pace: "le {date}, le rythme attendu est {share}"
437
+ ahead: en avance
438
+ behind: en retard
439
+ bullet:
440
+ target: "cible {target}"
441
+ aria: "{value} : {range}"
442
+ poor: Mauvais
443
+ fair: Juste
444
+ good: Bon
368
445
  # PermissionEditor (#5333)
369
446
  permissionEditor:
370
447
  placeholder: Saisir un droit…
@@ -390,6 +467,61 @@ export default `core:
390
467
  copied: Copié
391
468
  copyFailed: "Échec de la copie : {error}"
392
469
  confirm: J'ai copié
470
+ # La barre de parcours : traiter des éléments l'un après l'autre (QdRunBar, useRun, #5343)
471
+ run:
472
+ bar: Parcours
473
+ position: "{position} sur {total}"
474
+ order: "triés par {order}"
475
+ filter: "filtre : {filter}"
476
+ doneSince: "{count} traité depuis l'ouverture | {count} traités depuis l'ouverture"
477
+ prev: Précédent
478
+ next: Suivant
479
+ saveAndNext: Enregistrer et passer au suivant
480
+ finished: "L'élément est traité | Les {count} éléments sont traités"
481
+ state:
482
+ current: en cours
483
+ done: traité
484
+ urgent: urgent
485
+ todo: à traiter
486
+ # Favoris et récents : l'étoile, « Enregistrer cette recherche », les deux cartes (#5349)
487
+ favorites:
488
+ add: "Ajouter {label} aux favoris"
489
+ remove: "Retirer {label} des favoris"
490
+ saveSearch: Enregistrer cette recherche
491
+ searchSaved: Recherche enregistrée
492
+ searchName: Nom de la recherche
493
+ save: Enregistrer
494
+ title: Favoris
495
+ none: "Aucun favori : l'étoile à côté du titre d'une page en ajoute un"
496
+ recentTitle: Récents
497
+ noneRecent: Rien d'ouvert pour l'instant
498
+ noEntity: Aucune entité de favoris n'est déclarée
499
+ noRecentsEntity: Aucune entité de récents n'est déclarée
500
+ kind:
501
+ item: Fiches
502
+ list: Listes
503
+ search: Recherches
504
+ board: Tableaux
505
+ # Le tableau d'un domaine (QdDomainBoard, #5352)
506
+ board:
507
+ source: "Source : {source}"
508
+ readAt: "relevé {when}"
509
+ openSource: "ouvrir {source}"
510
+ retry: Réessayer
511
+ change: "{change} sur la période précédente"
512
+ same: Autant que la période précédente
513
+ timelineBars: "Volume du {from} au {to}"
514
+ # Le cartouche de domaine (#5389)
515
+ domainBar:
516
+ label: "{domain} : ses pages et ses indicateurs"
517
+ nav: "Pages de {domain}"
518
+ indicators: "Indicateurs de {domain}"
519
+ compact: Cartouche compact
520
+ expand: Cartouche complet
521
+ badge: "{count} — {title}"
522
+ unreachable: "{title} : injoignable ({error})"
523
+ invalid: "{title} : données qui ne correspondent pas"
524
+ loading: "{title} : chargement"
393
525
  # NotFoundPage
394
526
  notFound:
395
527
  title: Page introuvable
@@ -252,6 +252,35 @@ core:
252
252
  trayView: Afficher les cartes masquées en
253
253
  viewCards: Cartes
254
254
  viewCompact: Compact
255
+ # Le catalogue, les cartes à paramètres, les tailles, les sections (#5348)
256
+ addCard: Ajouter une carte
257
+ catalogue: Ajouter une carte
258
+ catalogueEmpty: Toutes les cartes sont déjà sur le tableau
259
+ hiddenNow: "Cachée : elle revient à sa place"
260
+ add: Ajouter
261
+ addOne: "Ajouter {title}"
262
+ added: "{title} ajoutée"
263
+ remove: "Retirer {title}"
264
+ removed: "{title} retirée"
265
+ cardTitle: Titre
266
+ choose: Choisir…
267
+ inSection: Dans la section
268
+ paramRequired: À remplir
269
+ paramInvalid: "Valeur invalide : {problem}"
270
+ size: "Taille de {title}"
271
+ sizeS: Petite
272
+ sizeM: Moyenne
273
+ sizeL: Grande
274
+ resized: "{title} : {size}"
275
+ addSection: Ajouter une section
276
+ firstSection: Principal
277
+ newSection: Nouvelle section
278
+ sectionName: Nom de la section
279
+ sectionAdded: "Section {title} ajoutée"
280
+ removeSection: "Supprimer la section {title}"
281
+ sectionRemoved: "Section {title} supprimée, ses cartes vont dans la première"
282
+ section: "Section de {title}"
283
+ movedToSection: "{title} déplacée dans {section}"
255
284
  # SessionsModule (#4336)
256
285
  sessions:
257
286
  title: Sessions
@@ -363,6 +392,54 @@ core:
363
392
  moreKeys: "+{count} autres"
364
393
  takeTheirs: Charger sa version
365
394
  keepMine: Garder la mienne et l'enregistrer par-dessus
395
+ # Cards (#5339): the envelope's words and the generic cards'
396
+ cards:
397
+ status:
398
+ critical: Critique
399
+ watch: À surveiller
400
+ good: Bon
401
+ info: Info
402
+ loading: Lecture…
403
+ unreachable: Source injoignable
404
+ galleryUnreachable: "La source n'a pas répondu (délai de 10 s dépassé)"
405
+ empty: Rien à signaler
406
+ invalid: Données invalides
407
+ moreProblems: "et {count} de plus"
408
+ overdue: en retard
409
+ compare:
410
+ points: pt
411
+ trend:
412
+ within: Dans la normale
413
+ outside: "{count} point hors de la normale | {count} points hors de la normale"
414
+ split:
415
+ others: Autres
416
+ funnel:
417
+ loss: "−{count} entre {from} et {to}"
418
+ heat:
419
+ low: Moins
420
+ high: "Plus (jusqu'à {max})"
421
+ agenda:
422
+ today: Aujourd'hui
423
+ tomorrow: Demain
424
+ yesterday: Hier
425
+ tomorrowAt: "Demain {time}"
426
+ yesterdayAt: "Hier {time}"
427
+ ageUnit:
428
+ min: min
429
+ h: h
430
+ d: j
431
+ goal:
432
+ of: "sur {target}"
433
+ reached: "{share} de l'objectif"
434
+ pace: "le {date}, le rythme attendu est {share}"
435
+ ahead: en avance
436
+ behind: en retard
437
+ bullet:
438
+ target: "cible {target}"
439
+ aria: "{value} : {range}"
440
+ poor: Mauvais
441
+ fair: Juste
442
+ good: Bon
366
443
  # PermissionEditor (#5333)
367
444
  permissionEditor:
368
445
  placeholder: Saisir un droit…
@@ -388,6 +465,61 @@ core:
388
465
  copied: Copié
389
466
  copyFailed: "Échec de la copie : {error}"
390
467
  confirm: J'ai copié
468
+ # La barre de parcours : traiter des éléments l'un après l'autre (QdRunBar, useRun, #5343)
469
+ run:
470
+ bar: Parcours
471
+ position: "{position} sur {total}"
472
+ order: "triés par {order}"
473
+ filter: "filtre : {filter}"
474
+ doneSince: "{count} traité depuis l'ouverture | {count} traités depuis l'ouverture"
475
+ prev: Précédent
476
+ next: Suivant
477
+ saveAndNext: Enregistrer et passer au suivant
478
+ finished: "L'élément est traité | Les {count} éléments sont traités"
479
+ state:
480
+ current: en cours
481
+ done: traité
482
+ urgent: urgent
483
+ todo: à traiter
484
+ # Favoris et récents : l'étoile, « Enregistrer cette recherche », les deux cartes (#5349)
485
+ favorites:
486
+ add: "Ajouter {label} aux favoris"
487
+ remove: "Retirer {label} des favoris"
488
+ saveSearch: Enregistrer cette recherche
489
+ searchSaved: Recherche enregistrée
490
+ searchName: Nom de la recherche
491
+ save: Enregistrer
492
+ title: Favoris
493
+ none: "Aucun favori : l'étoile à côté du titre d'une page en ajoute un"
494
+ recentTitle: Récents
495
+ noneRecent: Rien d'ouvert pour l'instant
496
+ noEntity: Aucune entité de favoris n'est déclarée
497
+ noRecentsEntity: Aucune entité de récents n'est déclarée
498
+ kind:
499
+ item: Fiches
500
+ list: Listes
501
+ search: Recherches
502
+ board: Tableaux
503
+ # Le tableau d'un domaine (QdDomainBoard, #5352)
504
+ board:
505
+ source: "Source : {source}"
506
+ readAt: "relevé {when}"
507
+ openSource: "ouvrir {source}"
508
+ retry: Réessayer
509
+ change: "{change} sur la période précédente"
510
+ same: Autant que la période précédente
511
+ timelineBars: "Volume du {from} au {to}"
512
+ # Le cartouche de domaine (#5389)
513
+ domainBar:
514
+ label: "{domain} : ses pages et ses indicateurs"
515
+ nav: "Pages de {domain}"
516
+ indicators: "Indicateurs de {domain}"
517
+ compact: Cartouche compact
518
+ expand: Cartouche complet
519
+ badge: "{count} — {title}"
520
+ unreachable: "{title} : injoignable ({error})"
521
+ invalid: "{title} : données qui ne correspondent pas"
522
+ loading: "{title} : chargement"
391
523
  # NotFoundPage
392
524
  notFound:
393
525
  title: Page introuvable
package/src/index.ts CHANGED
@@ -394,7 +394,21 @@ export {
394
394
  useCardsArrangement,
395
395
  reconcileArrangement,
396
396
  defaultArrangement,
397
+ effectiveCards,
398
+ addInstance,
399
+ removeInstance,
400
+ setSize,
401
+ addSection,
402
+ renameSection,
403
+ removeSection,
404
+ setSection,
405
+ cardSizes,
406
+ cardSpan,
407
+ CARD_SIZES,
397
408
  localArrangementStorage,
409
+ type CardInstance,
410
+ type CardsSection,
411
+ type CardsSectionGroup,
398
412
  type CardsArrangementStorage,
399
413
  type UseCardsArrangementOptions,
400
414
  type CardDef,
@@ -441,6 +455,14 @@ export { useSidebarState, SIDEBAR_COLLAPSED_KEY } from './composables/useSidebar
441
455
  // COMPONENTS
442
456
  // ════════════════════════════════════════════════════════════════════════════
443
457
  export * from './components/index'
458
+
459
+ // Cards (#5339): the envelope, the registration with sheet and schema, the
460
+ // gallery, and the generic cards (metric, queue, goal, bullet)
461
+ export * from './cards/index'
462
+ export * from './run/index'
463
+ export * from './favorites/index'
464
+ export * from './board/index'
465
+ export * from './domain/index'
444
466
  export { useTaskRunner, taskAction } from './tasks/useTaskRunner'
445
467
  export { useTaskNotifications, useTaskTrayVisible, type TasksConfig } from './tasks/useTaskNotifications'
446
468
  export {
@@ -547,6 +569,7 @@ export {
547
569
  type ZoneInspection,
548
570
  type ZoneRegistryOptions,
549
571
  type BlockCard,
572
+ type CardSizeName,
550
573
  // BlockConfig - already exported from kernel
551
574
  } from './zones/ZoneRegistry'
552
575
  export {
@@ -9,6 +9,7 @@ import {
9
9
  import { getRoutes, getItemTabs } from '../module/moduleRegistry'
10
10
  import { nestItemTabs } from './itemTabs'
11
11
  import { installChunkReload } from './chunkReload'
12
+ import { homeRouteRecords } from './homeRoute'
12
13
  import { routeEntity, routePermissions, missingPermission, entityDenial } from '../security/routeAccess'
13
14
  import type { Kernel } from './Kernel'
14
15
  // #1196 Phase B — this-typing against the real Kernel shape (was Self = any)
@@ -59,20 +60,8 @@ export function applyRoutingMethods(KernelClass: { prototype: Kernel }): void {
59
60
  throw new Error('[Kernel] pages.layout is required')
60
61
  }
61
62
 
62
- let homeRouteConfig: RouteRecordRaw
63
- if (typeof homeRoute === 'object' && homeRoute?.component) {
64
- homeRouteConfig = {
65
- path: '',
66
- name: homeRoute.name || '_home',
67
- component: homeRoute.component,
68
- }
69
- } else {
70
- homeRouteConfig = {
71
- path: '',
72
- name: '_home',
73
- redirect: { name: (homeRoute as string) || 'home' },
74
- }
75
- }
63
+ // The home page: on its own path, '/' redirecting to it (#5365)
64
+ const homeRecords = homeRouteRecords(homeRoute)
76
65
 
77
66
  // An entity shown as tabs gets its item's pages nested under one frame route (#4963)
78
67
  const moduleRoutes = nestItemTabs(getRoutes() as RouteRecordRaw[], getItemTabs())
@@ -94,7 +83,7 @@ export function applyRoutingMethods(KernelClass: { prototype: Kernel }): void {
94
83
  }
95
84
 
96
85
  const layoutChildren: RouteRecordRaw[] = [
97
- homeRouteConfig,
86
+ ...homeRecords,
98
87
  ...(coreRoutes || []),
99
88
  ...protectedRoutes,
100
89
  ]
@@ -216,7 +216,11 @@ export interface NotificationsConfig {
216
216
  /**
217
217
  * Home route configuration
218
218
  */
219
- export type HomeRoute = string | { name?: string; component?: Component }
219
+ /**
220
+ * The home page: a route name `/` redirects to, or a page of its own. Give that
221
+ * page a `path` so it keeps an address when the home changes (#5365).
222
+ */
223
+ export type HomeRoute = string | { name?: string; component?: Component; path?: string }
220
224
 
221
225
  /**
222
226
  * Kernel options
@@ -23,6 +23,7 @@ import { warnWithoutQdadmVitePlugin } from './vitePluginCheck'
23
23
  import { currentPageState } from '../composables/usePageState'
24
24
  import { explainGrant } from '../security/explainGrant'
25
25
  import type { Kernel } from './Kernel'
26
+ import { homeRouteName as homeRouteNameOf } from './homeRoute'
26
27
  // #1196 Phase B — this-typing against the real Kernel shape (was Self = any)
27
28
  type Self = Kernel
28
29
 
@@ -263,8 +264,7 @@ export function applyVueMethods(KernelClass: { prototype: Kernel }): void {
263
264
  this._pendingComponents.clear()
264
265
 
265
266
  const { homeRoute } = this.options
266
- const homeRouteName =
267
- typeof homeRoute === 'object' ? homeRoute?.name : homeRoute
267
+ const homeRouteName = homeRouteNameOf(homeRoute)
268
268
 
269
269
  app.provide('qdadmZoneRegistry', this.zoneRegistry)
270
270
  app.provide('qdadmActiveStack', this.activeStack)
@@ -18,6 +18,7 @@ import type { ItemTabsOptions } from '../module/moduleRegistry'
18
18
  import type { RouteRecordRaw } from 'vue-router'
19
19
  import pluralize from '../utils/pluralize'
20
20
  import { registry, getRoutes } from '../module/moduleRegistry'
21
+ import { registerDomain, type DomainConfig } from '../domain/registry'
21
22
  import type {
22
23
  ChildPageOptions,
23
24
  CrudOptions,
@@ -150,7 +151,15 @@ export function applyRoutingMethods(KernelContextClass: { prototype: KernelConte
150
151
  routes: RouteRecordRaw[],
151
152
  opts: RouteOptions = {}
152
153
  ): Self {
153
- registry.addRoutes(basePath, routes, opts)
154
+ // Each route knows its module, so a domain the module declares finds its pages (#5389)
155
+ const module = this._module?.name
156
+ const tagged = module ? routes.map((r) => ({ ...r, meta: { module, ...r.meta } }) as RouteRecordRaw) : routes
157
+ registry.addRoutes(basePath, tagged, opts)
158
+ return this
159
+ }
160
+
161
+ proto.domain = function (this: Self, name: string, config: DomainConfig): Self {
162
+ registerDomain(name, config, this._module?.name ?? null)
154
163
  return this
155
164
  }
156
165
 
@@ -36,6 +36,7 @@
36
36
  */
37
37
 
38
38
  import type { ItemTabsOptions } from '../module/moduleRegistry'
39
+ import type { DomainConfig } from '../domain/registry'
39
40
  import type { App, Component } from 'vue'
40
41
  import type { Router, RouteRecordRaw } from 'vue-router'
41
42
  import type { ListenerOptions } from '@quazardous/quarkernel'
@@ -210,6 +211,12 @@ export interface KernelContext {
210
211
  childPage(parentRouteName: string, pageName: string, options: ChildPageOptions): this
211
212
  /** Show an entity's item as tabs: its header, a tab per page of the item, the page below (#4963) */
212
213
  itemTabs(entity: string, options?: ItemTabsOptions): this
214
+ /**
215
+ * A domain (#5389): a bar on top of each of its pages, with its navigation
216
+ * and its indicators. Its pages: this module's routes, the pages of the
217
+ * entities it lists, and any route whose `meta.domain` names it.
218
+ */
219
+ domain(name: string, config: DomainConfig): this
213
220
 
214
221
  // Zones / Vue (KernelContext.zones.ts)
215
222
  zone(name: string, options?: ZoneOptions): this
@@ -28,6 +28,8 @@ import type { RouteParamResolverContext } from './KernelContext.routing'
28
28
 
29
29
  /** Extended Module interface with internal cleanup method */
30
30
  export interface ModuleWithCleanup {
31
+ /** The module's name (Module.name); routes are tagged with it (#5389) */
32
+ name?: string
31
33
  constructor?: { name?: string }
32
34
  _addSignalCleanup?: (cleanup: () => void) => void
33
35
  }
@@ -0,0 +1,45 @@
1
+ /**
2
+ * The home page (#5365): what `homeRoute` declares, as routes under the layout.
3
+ *
4
+ * - a string names a route a module declares: `/` redirects to it;
5
+ * - `{ name, component, path }` mounts the page on its own `path`, and `/`
6
+ * redirects to it, so the page keeps an address when the home changes;
7
+ * - `{ name, component }` without `path` mounts the page on `/` only: it has
8
+ * no address of its own, and a link to it breaks the day the home changes.
9
+ * Kept as it was, with a warning in development.
10
+ */
11
+ import type { RouteRecordRaw } from 'vue-router'
12
+ import type { HomeRoute } from './Kernel.types'
13
+
14
+ /** The name of the route the home is, whatever form `homeRoute` takes */
15
+ export function homeRouteName(homeRoute: HomeRoute | undefined | null): string {
16
+ if (homeRoute && typeof homeRoute === 'object') {
17
+ if (homeRoute.name) return homeRoute.name
18
+ return homeRoute.component && !homeRoute.path ? '_home' : 'home'
19
+ }
20
+ return homeRoute || 'home'
21
+ }
22
+
23
+ const isDev = (): boolean => (import.meta as unknown as { env?: { DEV?: boolean } }).env?.DEV === true
24
+
25
+ /** The routes, under the layout, that `homeRoute` declares */
26
+ export function homeRouteRecords(homeRoute: HomeRoute | undefined | null, warn: (m: string) => void = console.warn): RouteRecordRaw[] {
27
+ const name = homeRouteName(homeRoute)
28
+ if (homeRoute && typeof homeRoute === 'object' && homeRoute.component) {
29
+ const path = (homeRoute.path ?? '').replace(/^\/+/, '')
30
+ if (!path) {
31
+ if (isDev()) {
32
+ warn(
33
+ `[qdadm] homeRoute { component } has no path: the page '${name}' exists on '/' only, so a link to it breaks the day the home changes. ` +
34
+ `Give it one (homeRoute: { name, component, path: 'welcome' }), or name a module's route (homeRoute: 'books').`
35
+ )
36
+ }
37
+ return [{ path: '', name, component: homeRoute.component }]
38
+ }
39
+ return [
40
+ { path: '', name: '_home', redirect: { name } },
41
+ { path, name, component: homeRoute.component },
42
+ ]
43
+ }
44
+ return [{ path: '', name: '_home', redirect: { name } }]
45
+ }
@@ -52,6 +52,10 @@ export interface ModuleRouteMeta {
52
52
  title?: string
53
53
  /** Who may open the page (#4332): enforced by the router guard; a list needs every entry */
54
54
  permission?: string | string[]
55
+ /** The module that declared the route (#5389), set by ctx.routes() */
56
+ module?: string
57
+ /** The domain whose bar the page shows (#5389); false: none, even its module's */
58
+ domain?: string | false
55
59
  [key: string]: unknown
56
60
  }
57
61
 
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Runs (#5343): walk a set of items one after the other, with the run bar.
3
+ */
4
+ export { useRun, type UseRunReturn } from './useRun'
5
+ export { createRun, saveRun, loadRun, forgetRun, nextPending, runIndexOf, type Run, type RunInit, type RunItem, type RunRoute } from './run'
6
+ export { default as QdRunBar } from '../components/run/QdRunBar.vue'