@quazardous/qdadm 2.31.0 → 2.33.0

package/src/i18n/defaults/core.fr.generated.ts

@@ -71,6 +71,91 @@ export default `core:
     notRegistered: non enregistrée
     remove: Retirer
     via: "via {origin}"
+  # LogStream (#4110)
+  log:
+    streaming: En cours
+    done: Terminé
+    stopped: Arrêté
+    failed: "Échec : {error}"
+    lines: "{count} lignes"
+    search: Chercher dans le log
+    previous: Occurrence précédente
+    next: Occurrence suivante
+    onlyMatches: Seulement les lignes trouvées
+    errors: "{count} erreurs"
+    firstError: Aller à la ligne d'erreur suivante
+    wrap: Couper les lignes longues
+    follow: Suivre la fin du log
+    download: Télécharger le log
+    newLines: "{count} nouvelles lignes, reprendre"
+    empty: Rien pour l'instant
+  # EntityTimeline (#4111)
+  timeline:
+    actors: Filtrer par acteur
+    loading: Chargement…
+    empty: Rien ne s'est encore passé
+    newEvents: "{count} nouveaux événements"
+    oldestFirst: Plus anciens d'abord
+    newestFirst: Plus récents d'abord
+  # PayloadViewer / PayloadDiff (#4112)
+  payload:
+    headers: "En-têtes ({count})"
+    headerRow: La première ligne est un en-tête
+    copy: Copier
+    copied: Copié dans le presse-papiers
+    copyFailed: Copie impossible
+    download: Télécharger
+    showAll: "Afficher les {count} lignes"
+    binary: "Contenu binaire, {size}. Premiers octets :"
+    malformed: "{format} invalide ({error}), affiché comme texte"
+    expected: Attendu
+    captured: Capturé
+    identical: Identiques
+    unchanged: "{count} lignes inchangées"
+    showSame: "Afficher les {count} lignes inchangées"
+    inline: En ligne
+    split: Côte à côte
+  # EmailPreview (#4113)
+  email:
+    from: De
+    to: À
+    cc: Cc
+    replyTo: Répondre à
+    date: Date
+    noSubject: (sans objet)
+    allHeaders: "Tous les en-têtes ({count})"
+    noParser: "Un message brut demande un parser : passer parseMime de @quazardous/qdadm/email. La source est affichée."
+    tab:
+      html: HTML
+      text: Texte
+      source: Source
+    imagesBlocked: "{count} images distantes bloquées"
+    loadImages: Charger les images
+    blockImages: Bloquer les images
+    empty: Ce mail n'a pas de contenu
+    unnamed: (sans nom)
+    inline: intégrée
+    download: Télécharger
+  # TaskRunner (#4114)
+  task:
+    status:
+      starting: Démarrage
+      queued: En attente
+      running: En cours
+      succeeded: Terminée
+      failed: Échouée
+      cancelled: Annulée
+    cancel: Annuler la tâche
+    close: Fermer
+    background: Continuer en arrière-plan
+    open: Ouvrir la tâche
+    readError: "Lecture de la tâche impossible ({error}), nouvel essai"
+    start: Lancer
+    dontStart: Ne pas lancer
+    typeToConfirm: "Taper {value} pour confirmer"
+    tray: "{count} tâches en cours"
+    trayDone: Tâches récentes
+    clear: Effacer les terminées
 # The breadcrumb's View↔Edit toggle (useNavContext).
 breadcrumb:
   view: Voir

package/src/i18n/defaults/core.fr.yml

@@ -69,6 +69,91 @@ core:
     notRegistered: non enregistrée
     remove: Retirer
     via: "via {origin}"
+  # LogStream (#4110)
+  log:
+    streaming: En cours
+    done: Terminé
+    stopped: Arrêté
+    failed: "Échec : {error}"
+    lines: "{count} lignes"
+    search: Chercher dans le log
+    previous: Occurrence précédente
+    next: Occurrence suivante
+    onlyMatches: Seulement les lignes trouvées
+    errors: "{count} erreurs"
+    firstError: Aller à la ligne d'erreur suivante
+    wrap: Couper les lignes longues
+    follow: Suivre la fin du log
+    download: Télécharger le log
+    newLines: "{count} nouvelles lignes, reprendre"
+    empty: Rien pour l'instant
+  # EntityTimeline (#4111)
+  timeline:
+    actors: Filtrer par acteur
+    loading: Chargement…
+    empty: Rien ne s'est encore passé
+    newEvents: "{count} nouveaux événements"
+    oldestFirst: Plus anciens d'abord
+    newestFirst: Plus récents d'abord
+  # PayloadViewer / PayloadDiff (#4112)
+  payload:
+    headers: "En-têtes ({count})"
+    headerRow: La première ligne est un en-tête
+    copy: Copier
+    copied: Copié dans le presse-papiers
+    copyFailed: Copie impossible
+    download: Télécharger
+    showAll: "Afficher les {count} lignes"
+    binary: "Contenu binaire, {size}. Premiers octets :"
+    malformed: "{format} invalide ({error}), affiché comme texte"
+    expected: Attendu
+    captured: Capturé
+    identical: Identiques
+    unchanged: "{count} lignes inchangées"
+    showSame: "Afficher les {count} lignes inchangées"
+    inline: En ligne
+    split: Côte à côte
+  # EmailPreview (#4113)
+  email:
+    from: De
+    to: À
+    cc: Cc
+    replyTo: Répondre à
+    date: Date
+    noSubject: (sans objet)
+    allHeaders: "Tous les en-têtes ({count})"
+    noParser: "Un message brut demande un parser : passer parseMime de @quazardous/qdadm/email. La source est affichée."
+    tab:
+      html: HTML
+      text: Texte
+      source: Source
+    imagesBlocked: "{count} images distantes bloquées"
+    loadImages: Charger les images
+    blockImages: Bloquer les images
+    empty: Ce mail n'a pas de contenu
+    unnamed: (sans nom)
+    inline: intégrée
+    download: Télécharger
+  # TaskRunner (#4114)
+  task:
+    status:
+      starting: Démarrage
+      queued: En attente
+      running: En cours
+      succeeded: Terminée
+      failed: Échouée
+      cancelled: Annulée
+    cancel: Annuler la tâche
+    close: Fermer
+    background: Continuer en arrière-plan
+    open: Ouvrir la tâche
+    readError: "Lecture de la tâche impossible ({error}), nouvel essai"
+    start: Lancer
+    dontStart: Ne pas lancer
+    typeToConfirm: "Taper {value} pour confirmer"
+    tray: "{count} tâches en cours"
+    trayDone: Tâches récentes
+    clear: Effacer les terminées
 # The breadcrumb's View↔Edit toggle (useNavContext).
 breadcrumb:
   view: Voir

package/src/index.ts

@@ -327,6 +327,16 @@ export {
   type LayoutMeta,
 } from './composables/useLayoutResolver'
 export { useSSEBridge, type UseSSEBridgeReturn } from './composables/useSSEBridge'
+export {
+  useLogStream,
+  type LogSource,
+  type LogLine,
+  type LogPollResult,
+  type LogPushApi,
+  type LogStreamStatus,
+  type UseLogStreamOptions,
+  type UseLogStreamReturn,
+} from './composables/useLogStream'
 
 // Route-state persistence (#2146) — where a route remembers what it shows.
 export {
@@ -396,6 +406,17 @@ export { useSidebarState, SIDEBAR_COLLAPSED_KEY } from './composables/useSidebar
 // COMPONENTS
 // ════════════════════════════════════════════════════════════════════════════
 export * from './components/index'
+export { useTaskRunner, taskAction } from './tasks/useTaskRunner'
+export {
+  getTaskStore,
+  registerTaskKind,
+  type TaskRun,
+  type TaskStatus,
+  type TaskKind,
+  type TaskFollow,
+  type TaskConfirm,
+  type RunOptions,
+} from './tasks/taskStore'
 
 // ════════════════════════════════════════════════════════════════════════════
 // MODULE SYSTEM (excluding types that conflict)

package/src/kernel/Kernel.vue.ts

@@ -3,6 +3,8 @@ import {
   h,
   defineComponent,
   ref,
+  shallowRef,
+  markRaw,
   onErrorCaptured,
   type App,
   type Component,
@@ -43,7 +45,10 @@ export function getQdadmDebugBarRef(): Ref<Component | null> {
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   const w = typeof window !== 'undefined' ? (window as any) : null
   if (w && w[QDADM_DEBUG_BAR_GLOBAL_KEY]) return w[QDADM_DEBUG_BAR_GLOBAL_KEY]
-  const r = ref<Component | null>(null)
+  // Shallow (#4117): a deep ref turns the component into a reactive proxy,
+  // and Vue warns "received a Component that was made a reactive object" on
+  // every render of the bar.
+  const r = shallowRef<Component | null>(null)
   if (w) w[QDADM_DEBUG_BAR_GLOBAL_KEY] = r
   return r
 }
@@ -56,7 +61,9 @@ export const qdadmDebugBarRef: Ref<Component | null> = getQdadmDebugBarRef()
  * constructor). Equivalent to `getQdadmDebugBarRef().value = component`.
  */
 export function setQdadmDebugBar(component: Component | null): void {
-  getQdadmDebugBarRef().value = component
+  // markRaw as well: the ref on window may be a deep one left by an older
+  // copy of this module (HMR keeps it across versions).
+  getQdadmDebugBarRef().value = component ? markRaw(component) : null
 }
 
 /**

package/src/kernel/KernelContext.types.ts

@@ -87,7 +87,17 @@ export type DeferredFactory = () => Promise<void>
 /** Navigation item configuration */
 export interface NavItem {
   section: string
-  route: string
+  /** Route name — exactly one of `route` and `href`. */
+  route?: string
+  /**
+   * A link out of the app instead of a route (#3675) — exactly one of `route`
+   * and `href`. An absolute URL opens in a new tab unless `target` says otherwise.
+   */
+  href?: string
+  /** Where an `href` entry opens: default `_blank` for an absolute URL, same tab otherwise. */
+  target?: string
+  /** An `href` entry is shown only to whoever is granted this attribute. */
+  permission?: string
   label: string
   icon?: string
   exact?: boolean

package/src/module/moduleRegistry.ts

@@ -74,7 +74,16 @@ export interface ModuleRoute {
  * Navigation item
  */
 export interface NavItem {
-  route: string
+  route?: string
+  /**
+   * A link out of the app instead of a route (#3675) — exactly one of `route`
+   * and `href`. An absolute URL opens in a new tab unless `target` says otherwise.
+   */
+  href?: string
+  /** Where an `href` entry opens: default `_blank` for an absolute URL, same tab otherwise. */
+  target?: string
+  /** An `href` entry is shown only to whoever is granted this attribute. */
+  permission?: string
   label: string
   icon?: string
   entity?: string
@@ -209,6 +218,13 @@ const registry = {
    * @param item - { section, route, icon, label, exact? }
    */
   addNavItem(item: NavItemWithSection): void {
+    // An entry is a route or a link out, never both, never neither (#3675):
+    // an ambiguous one fails at boot rather than quietly in the menu.
+    if (!item.route === !item.href) {
+      throw new Error(
+        `[qdadm] nav item "${item.label}" in "${item.section}" needs exactly one of route and href`
+      )
+    }
     const { section, ...navItem } = item
     if (!navSections.has(section)) {
       navSections.set(section, [])

package/src/styles/_email.scss

@@ -0,0 +1,188 @@
+/**
+ * EmailPreview (#4113)
+ */
+
+@use 'variables' as *;
+
+.qd-email {
+  border: 1px solid var(--p-surface-200);
+  border-radius: $radius-sm;
+  overflow: hidden;
+  min-width: 0;
+  background: var(--p-surface-0);
+}
+
+.qd-email-head {
+  padding: 0.75rem 1rem 0.5rem;
+  border-bottom: 1px solid var(--p-surface-200);
+}
+
+.qd-email-subject {
+  margin: 0 0 0.5rem;
+  font-size: 1.0625rem;
+  font-weight: 600;
+  overflow-wrap: anywhere;
+}
+
+.qd-email-main {
+  display: grid;
+  grid-template-columns: max-content minmax(0, 1fr);
+  gap: 0.125rem 0.75rem;
+  margin: 0;
+  font-size: $font-size-sm;
+
+  dt {
+    color: var(--p-text-muted-color);
+  }
+
+  dd {
+    margin: 0;
+    overflow-wrap: anywhere;
+  }
+}
+
+.qd-email-headers {
+  margin-top: 0.5rem;
+  font-size: $font-size-xs;
+
+  summary {
+    cursor: pointer;
+    color: var(--p-text-muted-color);
+  }
+
+  table {
+    margin-top: 0.25rem;
+    border-collapse: collapse;
+    font-family: $font-family-mono;
+  }
+
+  th {
+    padding: 0.0625rem 1rem 0.0625rem 0;
+    text-align: left;
+    font-weight: 600;
+    white-space: nowrap;
+    vertical-align: top;
+  }
+
+  td {
+    overflow-wrap: anywhere;
+  }
+}
+
+.qd-email-warning {
+  padding: 0.375rem 1rem;
+  background: var(--p-orange-50);
+  color: var(--p-orange-800);
+  font-size: $font-size-sm;
+}
+
+.qd-email-tabs {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 0.25rem;
+  padding: 0 0.5rem;
+  border-bottom: 1px solid var(--p-surface-200);
+  font-size: $font-size-sm;
+}
+
+.qd-email-tab {
+  padding: 0.5rem 0.75rem;
+  border: none;
+  border-bottom: 2px solid transparent;
+  background: transparent;
+  color: var(--p-text-muted-color);
+  font: inherit;
+  cursor: pointer;
+
+  &--active {
+    border-bottom-color: var(--p-primary-color);
+    color: var(--p-text-color);
+    font-weight: 600;
+  }
+}
+
+.qd-email-spacer {
+  flex: 1;
+}
+
+.qd-email-blocked {
+  color: var(--p-text-muted-color);
+  font-size: $font-size-xs;
+}
+
+.qd-email-frame-wrap {
+  resize: vertical;
+  overflow: hidden;
+  min-height: 8rem;
+  background: #fff;
+}
+
+.qd-email-frame {
+  display: block;
+  width: 100%;
+  height: 100%;
+  border: 0;
+}
+
+.qd-email-text {
+  margin: 0;
+  padding: 0.75rem 1rem;
+  max-height: 32rem;
+  overflow: auto;
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  font-family: $font-family-mono;
+  font-size: 0.8125rem;
+}
+
+.qd-email-source {
+  white-space: pre;
+}
+
+.qd-email-empty {
+  padding: 0.75rem 1rem;
+  color: var(--p-text-muted-color);
+  font-style: italic;
+}
+
+.qd-email-attachments {
+  list-style: none;
+  margin: 0;
+  padding: 0.25rem 0.5rem;
+  border-top: 1px solid var(--p-surface-200);
+}
+
+.qd-email-attachment {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0.25rem;
+  font-size: $font-size-sm;
+  min-width: 0;
+}
+
+.qd-email-thumb {
+  width: 2.5rem;
+  height: 2.5rem;
+  object-fit: cover;
+  border-radius: $radius-sm;
+  border: 1px solid var(--p-surface-200);
+}
+
+.qd-email-clip {
+  width: 2.5rem;
+  text-align: center;
+  color: var(--p-text-muted-color);
+}
+
+.qd-email-att-name {
+  font-weight: 500;
+  overflow-wrap: anywhere;
+}
+
+.qd-email-att-meta {
+  flex: 1;
+  color: var(--p-text-muted-color);
+  font-size: $font-size-xs;
+}

package/src/styles/_log-stream.scss

@@ -0,0 +1,167 @@
+/**
+ * LogStream (#4110)
+ * A terminal-like panel: dark in both themes, as logs are read.
+ */
+
+@use 'variables' as *;
+
+.qd-log-stream {
+  --qd-log-bg: #1e1e1e;
+  --qd-log-fg: #d4d4d4;
+  --qd-log-muted: #858585;
+  --qd-log-mark: rgba(255, 213, 79, 0.45);
+  --qd-log-error-bg: rgba(241, 76, 76, 0.14);
+  --qd-log-current: rgba(59, 142, 234, 0.3);
+
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  border: 1px solid var(--p-surface-300);
+  border-radius: $radius-sm;
+  overflow: hidden;
+  min-width: 0;
+}
+
+.qd-log-toolbar {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 0.25rem 0.5rem;
+  padding: 0.25rem 0.5rem;
+  background: var(--p-surface-50);
+  border-bottom: 1px solid var(--p-surface-200);
+  font-size: $font-size-sm;
+}
+
+.qd-log-spacer-x {
+  flex: 1;
+}
+
+.qd-log-status {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.375rem;
+  font-weight: 500;
+}
+
+.qd-log-status-dot {
+  width: 0.5rem;
+  height: 0.5rem;
+  border-radius: 50%;
+  background: var(--p-surface-400);
+
+  .qd-log-status--streaming & {
+    background: var(--p-green-500);
+    animation: qd-log-pulse 1.2s ease-in-out infinite;
+  }
+  .qd-log-status--done & {
+    background: var(--p-blue-500);
+  }
+  .qd-log-status--error & {
+    background: var(--p-red-500);
+  }
+}
+
+@keyframes qd-log-pulse {
+  50% {
+    opacity: 0.3;
+  }
+}
+
+.qd-log-count,
+.qd-log-search-count {
+  color: var(--p-text-muted-color);
+  font-size: $font-size-xs;
+  font-variant-numeric: tabular-nums;
+}
+
+.qd-log-search {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.125rem;
+
+  .p-inputtext {
+    width: 12rem;
+    max-width: 40vw;
+  }
+}
+
+.qd-log-viewport {
+  overflow: auto;
+  background: var(--qd-log-bg);
+  color: var(--qd-log-fg);
+  font-family: $font-family-mono;
+  font-size: 0.8125rem;
+  line-height: var(--qd-log-line-height, 20px);
+  outline: none;
+}
+
+.qd-log-empty {
+  padding: 0.75rem 1rem;
+  color: var(--qd-log-muted);
+  font-style: italic;
+}
+
+.qd-log-line {
+  display: flex;
+  height: var(--qd-log-line-height, 20px);
+  white-space: pre;
+  padding-right: 0.75rem;
+
+  &--error {
+    background: var(--qd-log-error-bg);
+  }
+  &--current {
+    background: var(--qd-log-current);
+  }
+
+  .qd-log-stream--wrap & {
+    height: auto;
+    min-height: var(--qd-log-line-height, 20px);
+    white-space: pre-wrap;
+    word-break: break-word;
+    content-visibility: auto;
+    contain-intrinsic-size: auto var(--qd-log-line-height, 20px);
+  }
+}
+
+.qd-log-n {
+  flex: none;
+  min-width: 3.5rem;
+  padding: 0 0.75rem 0 0.5rem;
+  text-align: right;
+  color: var(--qd-log-muted);
+  user-select: none;
+}
+
+.qd-log-text {
+  flex: 1;
+  min-width: 0;
+}
+
+.qd-log-ts {
+  color: var(--qd-log-muted);
+}
+
+.qd-log-mark {
+  background: var(--qd-log-mark);
+  border-radius: 2px;
+}
+
+.qd-log-resume {
+  position: absolute;
+  bottom: 0.75rem;
+  left: 50%;
+  transform: translateX(-50%);
+  display: inline-flex;
+  align-items: center;
+  gap: 0.375rem;
+  padding: 0.25rem 0.75rem;
+  border: none;
+  border-radius: 999px;
+  background: var(--p-primary-color);
+  color: var(--p-primary-contrast-color);
+  font-size: $font-size-xs;
+  cursor: pointer;
+  box-shadow: 0 2px 6px rgba(0, 0, 0, 0.3);
+}