@cat-factory/app 0.201.0 → 0.202.0

package/app/stores/tutorial.spec.ts

@@ -133,3 +133,95 @@ describe('useTutorialStore tours', () => {
     expect(tutorial.isCompleted('made-up')).toBe(false)
   })
 })
+
+describe('useTutorialStore resuming a broken-off tour', () => {
+  it('offers to resume a tour abandoned part-way', () => {
+    // Esc and Skip are both cheap to hit — one by accident, one to get the overlay out of the
+    // way for a moment — and before this the position they discarded was the whole walkthrough.
+    const tutorial = useTutorialStore()
+    tutorial.startTour('board-basics')
+    tutorial.setStepIndex(3)
+    tutorial.stopTour()
+    expect(tutorial.interruptedAt('board-basics')).toBe(3)
+
+    tutorial.resumeTour('board-basics')
+    expect(tutorial.activeTourId).toBe('board-basics')
+    expect(tutorial.stepIndex).toBe(3)
+    // Consumed: the tour is running again, so there is no longer a position to go back to.
+    expect(tutorial.interruptedAt('board-basics')).toBeNull()
+  })
+
+  it('offers nothing for a tour abandoned on its very first step', () => {
+    // Resuming and starting are the same thing there, so a Resume label would be noise.
+    const tutorial = useTutorialStore()
+    tutorial.startTour('board-basics')
+    tutorial.stopTour()
+    expect(tutorial.interruptedAt('board-basics')).toBeNull()
+  })
+
+  it('keeps the resume point scoped to the tour it belongs to', () => {
+    const tutorial = useTutorialStore()
+    tutorial.startTour('run-task')
+    tutorial.setStepIndex(2)
+    tutorial.stopTour()
+    expect(tutorial.interruptedAt('first-task')).toBeNull()
+    // Resuming a DIFFERENT tour degrades to a plain start rather than resuming the wrong one.
+    tutorial.resumeTour('first-task')
+    expect(tutorial.activeTourId).toBe('first-task')
+    expect(tutorial.stepIndex).toBe(0)
+  })
+
+  it('discards the resume point when the same tour is started from the top', () => {
+    const tutorial = useTutorialStore()
+    tutorial.startTour('board-basics')
+    tutorial.setStepIndex(3)
+    tutorial.stopTour()
+    tutorial.startTour('board-basics')
+    expect(tutorial.stepIndex).toBe(0)
+    expect(tutorial.interruptedAt('board-basics')).toBeNull()
+  })
+
+  it('keeps another tour’s resume point when a different tour is started from the top', () => {
+    // Starting a tour discards ITS own stale position, not somebody else's. Glancing at
+    // another tour and pressing Esc at step 0 must not cost the position you were coming
+    // back to — that one loses the single slot only when this tour is broken off past step 0.
+    const tutorial = useTutorialStore()
+    tutorial.startTour('board-basics')
+    tutorial.setStepIndex(3)
+    tutorial.stopTour()
+
+    tutorial.startTour('run-task')
+    tutorial.stopTour()
+    expect(tutorial.interruptedAt('board-basics')).toBe(3)
+
+    // ...and it does lose it the moment the other tour is broken off past its first step.
+    tutorial.startTour('run-task')
+    tutorial.setStepIndex(1)
+    tutorial.stopTour()
+    expect(tutorial.interruptedAt('board-basics')).toBeNull()
+    expect(tutorial.interruptedAt('run-task')).toBe(1)
+  })
+
+  it('leaves no resume point behind a completed tour', () => {
+    // It would sit beside that tour's own Completed badge, offering to resume what just finished.
+    const tutorial = useTutorialStore()
+    tutorial.startTour('board-basics')
+    tutorial.setStepIndex(3)
+    tutorial.stopTour()
+    tutorial.resumeTour('board-basics')
+    tutorial.setStepIndex(4)
+    tutorial.completeTour()
+    expect(tutorial.interruptedAt('board-basics')).toBeNull()
+    expect(tutorial.isCompleted('board-basics')).toBe(true)
+  })
+
+  it('leaves no resume point when the runtime bails out on an unusable position', () => {
+    // The overlay could not resolve the tour at all; handing that position back would put the
+    // user straight into the same dead overlay.
+    const tutorial = useTutorialStore()
+    tutorial.startTour('gone-away')
+    tutorial.setStepIndex(2)
+    tutorial.stopTour({ resumable: false })
+    expect(tutorial.interruptedAt('gone-away')).toBeNull()
+  })
+})

package/app/stores/tutorial.ts

@@ -38,6 +38,18 @@ export const useTutorialStore = defineStore(
     const promptAutoOpened = ref(false)
     const activeTourId = ref<string | null>(null)
     const stepIndex = ref(0)
+    /**
+     * Where a tour the user broke off was left, so the prompt can offer to RESUME it rather
+     * than only to start it again from step one.
+     *
+     * Session-only for the same reason the cursor is: a tour is anchored to live DOM, and a
+     * position replayed across a reload would point step N at a board that has not reached
+     * that state. Within one session the board is still exactly where the tour left it, so the
+     * position is good — which matters because breaking off is easy and cheap (Esc, or Skip to
+     * get the overlay out of the way for a moment) while the cost of it was the whole
+     * walkthrough.
+     */
+    const interrupted = ref<{ tourId: string; stepIndex: number } | null>(null)
 
     /** A tour is currently running (the overlay mounts off this). */
     const touring = computed(() => activeTourId.value !== null)
@@ -95,6 +107,36 @@ export const useTutorialStore = defineStore(
       promptOpen.value = false
       activeTourId.value = tourId
       stepIndex.value = 0
+      // Starting from the top is an explicit choice to discard THIS tour's old position;
+      // leaving the record in place would offer Resume again the moment this attempt is
+      // broken off at step 0, pointing at a position the user already walked away from.
+      //
+      // A DIFFERENT tour's position is not this action's to discard. It is still exactly what
+      // its own Resume offer needs, and it will lose the single slot soon enough — the moment
+      // this tour is broken off past step 0. Clearing it here instead means glancing at
+      // another tour and pressing Esc silently costs the position you were coming back to.
+      if (interrupted.value?.tourId === tourId) interrupted.value = null
+    }
+
+    /**
+     * Pick a broken-off tour back up where it stopped. Falls back to a plain start when the
+     * saved position is for a DIFFERENT tour (or gone), so a caller never has to check first
+     * and a stale offer degrades to the ordinary behaviour instead of resuming the wrong tour.
+     *
+     * The index is not validated here: the store deliberately knows nothing about which tours
+     * exist or how many steps they have, so the overlay clamps it against the script it holds.
+     */
+    function resumeTour(tourId: string) {
+      const at = interrupted.value
+      if (!at || at.tourId !== tourId) {
+        startTour(tourId)
+        return
+      }
+      decision.value = 'accepted'
+      promptOpen.value = false
+      activeTourId.value = tourId
+      stepIndex.value = at.stepIndex
+      interrupted.value = null
     }
 
     /** Move the step cursor; the overlay owns bounds/skip logic and never goes below 0. */
@@ -102,19 +144,45 @@ export const useTutorialStore = defineStore(
       stepIndex.value = Math.max(0, index)
     }
 
-    /** Abandon the running tour without marking it complete (the Skip action). */
-    function stopTour() {
+    /** Clear the live cursor. Shared by the two ways a tour ends, which differ only in what
+     * they leave behind (a resume point vs. a completion). */
+    function clearCursor() {
       activeTourId.value = null
       stepIndex.value = 0
     }
 
+    /**
+     * Abandon the running tour without marking it complete: Skip, Esc, or a runtime that
+     * could not resolve the tour at all.
+     *
+     * Records where it stopped so the prompt can offer to resume — except from the very first
+     * step, where resuming and starting are the same thing and an offer to "resume" would be
+     * noise. `resumable: false` is for the runtime's own bail-outs, which stop BECAUSE the
+     * position is unusable and must not hand it back.
+     */
+    function stopTour(options?: { resumable?: boolean }) {
+      const id = activeTourId.value
+      if (id !== null && stepIndex.value > 0 && options?.resumable !== false) {
+        interrupted.value = { tourId: id, stepIndex: stepIndex.value }
+      }
+      clearCursor()
+    }
+
     /** Finish the running tour: record completion (idempotent) and clear the cursor. */
     function completeTour() {
       const id = activeTourId.value
       if (id && !completedTourIds.value.includes(id)) {
         completedTourIds.value = [...completedTourIds.value, id]
       }
-      stopTour()
+      // A finished tour has no position left to resume, and an offer to resume the walkthrough
+      // the user just completed would sit beside its own Completed badge.
+      if (id !== null && interrupted.value?.tourId === id) interrupted.value = null
+      clearCursor()
+    }
+
+    /** Where this tour was broken off, if it was; null otherwise (the Resume affordance). */
+    function interruptedAt(tourId: string): number | null {
+      return interrupted.value?.tourId === tourId ? interrupted.value.stepIndex : null
     }
 
     function isCompleted(tourId: string): boolean {
@@ -128,6 +196,7 @@ export const useTutorialStore = defineStore(
       promptAutoOpened,
       activeTourId,
       stepIndex,
+      interrupted,
       touring,
       maybeOfferOnLaunch,
       openPrompt,
@@ -135,10 +204,12 @@ export const useTutorialStore = defineStore(
       deferPrompt,
       decline,
       startTour,
+      resumeTour,
       setStepIndex,
       stopTour,
       completeTour,
       isCompleted,
+      interruptedAt,
     }
   },
   { persist: { pick: ['decision', 'completedTourIds'] } },

package/app/utils/agentOutput.ts

@@ -10,7 +10,10 @@
 // the rendered document at each heading into sections we can collapse
 // independently and link from a ToC. That split is done over the parsed DOM, so
 // it is independent of markdown-it's token internals.
-import MarkdownIt from 'markdown-it'
+// markdown-it 15 ships its own types (the retired `@types/markdown-it` stopped at 14): the
+// default export is the CONSTRUCTOR and the instance type is the same-named type export, so
+// the two need distinct local names where the old merged declaration allowed one.
+import MarkdownIt, { type MarkdownIt as MarkdownItInstance } from 'markdown-it'
 
 /**
  * Stamp every TOP-LEVEL block element with its source line range
@@ -21,7 +24,7 @@ import MarkdownIt from 'markdown-it'
  * tracked over the flat token stream) so a comment targets a whole paragraph/list/
  * heading rather than a nested fragment.
  */
-function sourceLinePlugin(md: MarkdownIt): void {
+function sourceLinePlugin(md: MarkdownItInstance): void {
   md.core.ruler.push('source_lines', (state) => {
     let depth = 0
     for (const token of state.tokens) {

package/app/utils/tutorial.spec.ts

@@ -1,5 +1,11 @@
 import { describe, expect, it } from 'vitest'
-import { computeCoachMarkLayout, resolveTours, sortTours } from '~/utils/tutorial'
+import {
+  computeCoachMarkLayout,
+  needsReveal,
+  resolveTours,
+  sortTours,
+  visibleArea,
+} from '~/utils/tutorial'
 import type { TutorialStep, TutorialTour } from '~/utils/tutorial'
 import type { NavGates } from '~/modular/nav-contributions'
 
@@ -113,3 +119,55 @@ describe('computeCoachMarkLayout', () => {
     expect(layout.left).toBe(10)
   })
 })
+
+describe('needsReveal', () => {
+  const viewport = { width: 1000, height: 800 }
+
+  it('leaves a fully visible anchor alone', () => {
+    expect(needsReveal({ top: 100, left: 100, width: 120, height: 40 }, viewport)).toBe(false)
+  })
+
+  it('reveals an anchor scrolled or panned clean off screen', () => {
+    // The case the runtime could not see: an element off the viewport still has layout boxes,
+    // so it passed the visibility check and the ring was drawn at coordinates nobody can see.
+    expect(needsReveal({ top: -400, left: 100, width: 120, height: 40 }, viewport)).toBe(true)
+    expect(needsReveal({ top: 100, left: 1400, width: 120, height: 40 }, viewport)).toBe(true)
+  })
+
+  it('reveals a small anchor that is only slightly on screen', () => {
+    // 25% of its width inside the right edge: enough to have a rect, not enough to point at.
+    expect(needsReveal({ top: 100, left: 970, width: 120, height: 40 }, viewport)).toBe(true)
+  })
+
+  it('leaves an anchor BIGGER than the viewport alone while it fills the screen', () => {
+    // `board-canvas` and `sidebar` can never clear a fraction of their own area, so measuring
+    // against that would pan the camera on every step that points at one of them.
+    expect(needsReveal({ top: -200, left: -200, width: 2000, height: 1600 }, viewport)).toBe(false)
+  })
+
+  it('reveals an oversized anchor that has left the screen anyway', () => {
+    expect(needsReveal({ top: -1700, left: 0, width: 2000, height: 1600 }, viewport)).toBe(true)
+  })
+
+  it('never reveals a zero-area anchor', () => {
+    // There is no position to bring anywhere, and treating it as off-screen would make every
+    // degenerate rect trigger a camera move.
+    expect(needsReveal({ top: 0, left: 0, width: 0, height: 0 }, viewport)).toBe(false)
+  })
+})
+
+describe('visibleArea', () => {
+  const viewport = { width: 1000, height: 800 }
+
+  it('is the full area when the rect is inside', () => {
+    expect(visibleArea({ top: 10, left: 10, width: 100, height: 50 }, viewport)).toBe(5000)
+  })
+
+  it('is the clipped area when the rect straddles an edge', () => {
+    expect(visibleArea({ top: 10, left: -60, width: 100, height: 50 }, viewport)).toBe(40 * 50)
+  })
+
+  it('is zero for a rect with no overlap at all', () => {
+    expect(visibleArea({ top: 10, left: 2000, width: 100, height: 50 }, viewport)).toBe(0)
+  })
+})

package/app/utils/tutorial.ts

@@ -115,9 +115,38 @@ export interface TutorialTour {
 /** How long the overlay polls for a step's anchor before auto-skipping the step. */
 export const DEFAULT_TARGET_WAIT_MS = 4000
 
-/** How often the overlay re-queries / re-measures its anchor (canvas pans, panels open). */
+/**
+ * How often the overlay re-queries the DOM while it is still HUNTING for a step's anchor.
+ * Fast on purpose — the anchor can appear at any moment (a modal mounting, a live event
+ * landing a card) and every tick spent waiting is time the user stares at a "looking for
+ * it" note — and bounded on purpose, by the step's own {@link DEFAULT_TARGET_WAIT_MS}-ish
+ * budget, after which the step is skipped and the hunt stops.
+ */
 export const TARGET_TRACK_INTERVAL_MS = 150
 
+/**
+ * How often the overlay re-queries once it HAS an anchor.
+ *
+ * Anchored tracking is event-driven (scroll, resize, element resize, canvas pan/zoom), so
+ * this interval is only the backstop for movement nothing reports — and it is the tick that
+ * runs for the whole length of a tour, where the hunting one above is bounded by a step's
+ * wait budget. It also re-RESOLVES the selector rather than re-measuring the cached element,
+ * which is what lets a step re-anchor when the control it names is replaced underneath it.
+ */
+export const TARGET_IDLE_INTERVAL_MS = 400
+
+/**
+ * How much of an anchor has to be on screen before the overlay leaves the viewport alone.
+ *
+ * Measured against `min(anchorArea, viewportArea)`, not against the anchor's own area, because
+ * the catalog points at controls of wildly different sizes: `add-task-submit` is a button that
+ * must be almost wholly visible to be pointed at, while `board-canvas` and `sidebar` are bigger
+ * than the viewport and can NEVER clear a fraction of their own area. Taking the smaller of the
+ * two means "mostly visible" for a small control and "filling a good part of the screen" for a
+ * large one, which is the same judgement in both cases.
+ */
+export const MIN_VISIBLE_RATIO = 0.5
+
 /** Deterministic tour-list order: `order`, then `id`. */
 export function sortTours(tours: readonly TutorialTour[]): TutorialTour[] {
   return [...tours].sort((a, b) => a.order - b.order || a.id.localeCompare(b.id))
@@ -156,6 +185,43 @@ export interface TutorialRect {
   height: number
 }
 
+/**
+ * How much of `rect` lies inside the viewport, in square pixels. Zero when they don't overlap
+ * at all, which is the case that matters: an anchor scrolled or panned off screen.
+ */
+export function visibleArea(
+  rect: TutorialRect,
+  viewport: { width: number; height: number },
+): number {
+  const overlapWidth = Math.min(rect.left + rect.width, viewport.width) - Math.max(rect.left, 0)
+  const overlapHeight = Math.min(rect.top + rect.height, viewport.height) - Math.max(rect.top, 0)
+  return Math.max(0, overlapWidth) * Math.max(0, overlapHeight)
+}
+
+/**
+ * Does the overlay have to bring this anchor into view before the step can read correctly?
+ *
+ * The runtime accepts any element with layout boxes, and an element scrolled out of a panel or
+ * panned off the board canvas still HAS them — so without this check the highlight ring is
+ * drawn at off-screen coordinates while `computeCoachMarkLayout` clamps the tooltip to a
+ * viewport edge, leaving the user reading "click this" beside nothing at all. It bites the
+ * most-travelled steps hardest: the two `task-card` steps anchor whichever card is first in
+ * the DOM, which on a populated board is the one least likely to be the one on screen.
+ *
+ * Pure, so the threshold is pinned by unit tests rather than eyeballed against a real board.
+ * A zero-area anchor never needs revealing: there is no position to bring anywhere, and
+ * treating it as off-screen would make every degenerate rect trigger a canvas pan.
+ */
+export function needsReveal(
+  rect: TutorialRect,
+  viewport: { width: number; height: number },
+): boolean {
+  const area = rect.width * rect.height
+  if (area <= 0) return false
+  const required = MIN_VISIBLE_RATIO * Math.min(area, viewport.width * viewport.height)
+  return visibleArea(rect, viewport) < required
+}
+
 export interface CoachMarkLayout {
   top: number
   left: number

package/i18n/locales/de.json

@@ -6127,6 +6127,7 @@
       "intro": "Geführte Touren zeigen dir die App direkt auf diesem Bildschirm: Sie heben die echten Bedienelemente hervor und sagen dir, was du anklicken sollst.",
       "start": "Starten",
       "restart": "Wiederholen",
+      "resume": "Fortsetzen",
       "completed": "Abgeschlossen",
       "decline": "Nein danke",
       "later": "Vielleicht später",
@@ -6139,6 +6140,7 @@
       "done": "Fertig",
       "progress": "Schritt {current} von {total}",
       "ariaLabel": "Tutorial-Schritt",
+      "announcement": "Schritt {current} von {total}. {title}. {body}",
       "abridged": "1 Schritt wurde übersprungen: dieses Element gehört nicht zu diesem Board. | {count} Schritte wurden übersprungen: diese Elemente gehören nicht zu diesem Board.",
       "searching": "Suche das hervorgehobene Element...",
       "clickHint": "Klicke auf das hervorgehobene Element, um fortzufahren"

package/i18n/locales/en.json

@@ -6331,6 +6331,10 @@
       "intro": "Guided tours walk you through the app right on this screen: they highlight the actual controls and tell you what to click.",
       "start": "Start",
       "restart": "Repeat",
+      "resume": "Resume",
+      "@resume": {
+        "description": "Verb, on a button: pick a guided tour back up from where it was broken off. Not the noun (CV/resume)."
+      },
       "completed": "Completed",
       "decline": "No thanks",
       "later": "Maybe later",
@@ -6343,6 +6347,10 @@
       "done": "Finish",
       "progress": "Step {current} of {total}",
       "ariaLabel": "Tutorial step",
+      "announcement": "Step {current} of {total}. {title}. {body}",
+      "@announcement": {
+        "description": "Screen-reader-only announcement read out on every step change; it is never shown on screen. {title} and {body} are the step's own heading and full sentence, so the separators around them have to be real sentence punctuation in the target language."
+      },
       "abridged": "1 step was skipped: that control is not part of this board. | {count} steps were skipped: those controls are not part of this board.",
       "@abridged": {
         "description": "Shown on a tour's final card when steps were skipped. Needs the plural forms of the target language (pl/uk take three: one | few | many); {count} is the number of skipped steps."

package/i18n/locales/es.json

@@ -6115,6 +6115,7 @@
       "intro": "Los recorridos guiados te muestran la aplicación directamente en esta pantalla: resaltan los controles reales y te dicen dónde hacer clic.",
       "start": "Empezar",
       "restart": "Repetir",
+      "resume": "Reanudar",
       "completed": "Completado",
       "decline": "No, gracias",
       "later": "Quizás más tarde",
@@ -6127,6 +6128,7 @@
       "done": "Finalizar",
       "progress": "Paso {current} de {total}",
       "ariaLabel": "Paso del tutorial",
+      "announcement": "Paso {current} de {total}. {title}. {body}",
       "abridged": "Se omitió 1 paso: ese control no forma parte de este tablero. | Se omitieron {count} pasos: esos controles no forman parte de este tablero.",
       "searching": "Buscando el control resaltado...",
       "clickHint": "Haz clic en el control resaltado para continuar"

package/i18n/locales/fr.json

@@ -6115,6 +6115,7 @@
       "intro": "Les visites guidées vous montrent l'application directement à l'écran : elles mettent en évidence les vrais contrôles et vous indiquent où cliquer.",
       "start": "Commencer",
       "restart": "Refaire",
+      "resume": "Reprendre",
       "completed": "Terminée",
       "decline": "Non merci",
       "later": "Peut-être plus tard",
@@ -6127,6 +6128,7 @@
       "done": "Terminer",
       "progress": "Étape {current} sur {total}",
       "ariaLabel": "Étape du tutoriel",
+      "announcement": "Étape {current} sur {total}. {title}. {body}",
       "abridged": "1 étape a été ignorée : ce contrôle ne fait pas partie de ce tableau. | {count} étapes ont été ignorées : ces contrôles ne font pas partie de ce tableau.",
       "searching": "Recherche du contrôle mis en évidence...",
       "clickHint": "Cliquez sur le contrôle mis en évidence pour continuer"

package/i18n/locales/he.json

@@ -6126,6 +6126,7 @@
       "intro": "סיורים מודרכים מציגים את האפליקציה ישירות על המסך: הם מדגישים את הפקדים האמיתיים ואומרים לך על מה ללחוץ.",
       "start": "התחל",
       "restart": "התחל שוב",
+      "resume": "המשך",
       "completed": "הושלם",
       "decline": "לא תודה",
       "later": "אולי מאוחר יותר",
@@ -6138,6 +6139,7 @@
       "done": "סיום",
       "progress": "שלב {current} מתוך {total}",
       "ariaLabel": "שלב במדריך",
+      "announcement": "שלב {current} מתוך {total}. {title}. {body}",
       "abridged": "דילגנו על שלב אחד: הפקד הזה אינו חלק מהלוח הזה. | דילגנו על {count} שלבים: הפקדים האלה אינם חלק מהלוח הזה.",
       "searching": "מחפש את הפקד המודגש...",
       "clickHint": "לחץ על הפקד המודגש כדי להמשיך"

package/i18n/locales/it.json

@@ -6127,6 +6127,7 @@
       "intro": "I tour guidati ti mostrano l’applicazione direttamente sullo schermo: evidenziano i controlli reali e ti dicono dove cliccare.",
       "start": "Inizia",
       "restart": "Ripeti",
+      "resume": "Riprendi",
       "completed": "Completato",
       "decline": "No grazie",
       "later": "Forse più tardi",
@@ -6139,6 +6140,7 @@
       "done": "Fine",
       "progress": "Passaggio {current} di {total}",
       "ariaLabel": "Passaggio del tutorial",
+      "announcement": "Passaggio {current} di {total}. {title}. {body}",
       "abridged": "1 passaggio è stato saltato: quel controllo non fa parte di questa board. | {count} passaggi sono stati saltati: quei controlli non fanno parte di questa board.",
       "searching": "Ricerca del controllo evidenziato...",
       "clickHint": "Clicca sul controllo evidenziato per continuare"

package/i18n/locales/ja.json

@@ -6127,6 +6127,7 @@
       "intro": "ガイドツアーは、この画面上でアプリの使い方を案内します。実際のコントロールをハイライトし、どこをクリックすればよいかをお知らせします。",
       "start": "開始",
       "restart": "もう一度",
+      "resume": "再開",
       "completed": "完了",
       "decline": "結構です",
       "later": "あとで",
@@ -6139,6 +6140,7 @@
       "done": "完了",
       "progress": "ステップ {current} / {total}",
       "ariaLabel": "チュートリアルのステップ",
+      "announcement": "ステップ {current} / {total}。{title}。{body}",
       "abridged": "1 つのステップをスキップしました。その操作はこのボードにはありません。 | {count} 個のステップをスキップしました。それらの操作はこのボードにはありません。",
       "searching": "ハイライトされたコントロールを探しています...",
       "clickHint": "続行するには、ハイライトされたコントロールをクリックしてください"

package/i18n/locales/pl.json

@@ -6115,6 +6115,7 @@
       "intro": "Interaktywne przewodniki pokazują aplikację bezpośrednio na tym ekranie: podświetlają prawdziwe elementy interfejsu i mówią, co kliknąć.",
       "start": "Rozpocznij",
       "restart": "Powtórz",
+      "resume": "Wznów",
       "completed": "Ukończono",
       "decline": "Nie, dziękuję",
       "later": "Może później",
@@ -6127,6 +6128,7 @@
       "done": "Zakończ",
       "progress": "Krok {current} z {total}",
       "ariaLabel": "Krok samouczka",
+      "announcement": "Krok {current} z {total}. {title}. {body}",
       "abridged": "Pominięto 1 krok: tego elementu nie ma na tej tablicy. | Pominięto {count} kroki: tych elementów nie ma na tej tablicy. | Pominięto {count} kroków: tych elementów nie ma na tej tablicy.",
       "searching": "Szukanie podświetlonego elementu...",
       "clickHint": "Kliknij podświetlony element, aby kontynuować"

package/i18n/locales/tr.json

@@ -6127,6 +6127,7 @@
       "intro": "Rehberli turlar uygulamayı doğrudan bu ekranda gösterir: gerçek denetimleri vurgular ve nereye tıklayacağınızı söyler.",
       "start": "Başla",
       "restart": "Tekrarla",
+      "resume": "Devam et",
       "completed": "Tamamlandı",
       "decline": "Hayır, teşekkürler",
       "later": "Belki daha sonra",
@@ -6139,6 +6140,7 @@
       "done": "Bitir",
       "progress": "Adım {current} / {total}",
       "ariaLabel": "Eğitim adımı",
+      "announcement": "Adım {current} / {total}. {title}. {body}",
       "abridged": "1 adım atlandı: bu denetim bu panonun parçası değil. | {count} adım atlandı: bu denetimler bu panonun parçası değil.",
       "searching": "Vurgulanan denetim aranıyor...",
       "clickHint": "Devam etmek için vurgulanan denetime tıklayın"

package/i18n/locales/uk.json

@@ -6115,6 +6115,7 @@
       "intro": "Інтерактивні тури показують застосунок просто на цьому екрані: вони підсвічують справжні елементи керування й підказують, що натискати.",
       "start": "Почати",
       "restart": "Повторити",
+      "resume": "Продовжити",
       "completed": "Завершено",
       "decline": "Ні, дякую",
       "later": "Можливо, пізніше",
@@ -6127,6 +6128,7 @@
       "done": "Готово",
       "progress": "Крок {current} з {total}",
       "ariaLabel": "Крок навчального туру",
+      "announcement": "Крок {current} з {total}. {title}. {body}",
       "abridged": "Пропущено 1 крок: цього елемента немає на цій дошці. | Пропущено {count} кроки: цих елементів немає на цій дошці. | Пропущено {count} кроків: цих елементів немає на цій дошці.",
       "searching": "Пошук підсвіченого елемента...",
       "clickHint": "Натисніть підсвічений елемент, щоб продовжити"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.201.0",
+  "version": "0.202.0",
   "description": "Reusable Nuxt layer for the Agent Architecture Board SPA (components, stores, composables, pages). Consume it from a thin deployment app via `extends: ['@cat-factory/app']` and point it at your backend with NUXT_PUBLIC_API_BASE. See deploy/frontend for an example.",
   "repository": {
     "type": "git",
@@ -25,7 +25,7 @@
     "@modular-vue/runtime": "^1.4.1",
     "@modular-vue/vue": "^1.4.1",
     "@nuxt/ui": "^4.10.0",
-    "@nuxtjs/i18n": "^10.5.0",
+    "@nuxtjs/i18n": "^10.6.0",
     "@pinia/nuxt": "^1.0.1",
     "@toad-contracts/core": "0.4.0",
     "@toad-contracts/frontend-http-client": "0.3.2",
@@ -33,25 +33,24 @@
     "@vue-flow/background": "^1.3.2",
     "@vue-flow/core": "^1.48.2",
     "@vue-flow/node-resizer": "^1.5.1",
-    "@vueuse/core": "^14.3.0",
-    "markdown-it": "^14.3.0",
+    "@vueuse/core": "^14.4.0",
+    "markdown-it": "^15.0.0",
     "pinia": "^4.0.2",
     "pinia-plugin-persistedstate": "^4.7.1",
     "valibot": "^1.4.2",
     "vue": "3.5.40",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.210.0"
+    "@cat-factory/contracts": "0.210.1"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",
-    "@types/markdown-it": "^14.1.2",
     "happy-dom": "^20.11.1",
     "msw": "^2.15.0",
     "nuxt": "^4.5.1",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "vue-i18n-extract": "^2.0.7",
-    "vue-tsc": "^3.3.8"
+    "vue-tsc": "^3.3.9"
   },
   "peerDependencies": {
     "nuxt": "^4.5.0"