be51105aaa
Adds the breadcrumb anchoring the user across modes on the doc workspace. Empty / hidden on routes that don't opt in. Components - shared/breadcrumb/AppBreadcrumb.vue: data-driven, accessible (<nav aria-label>, <ol>, aria-current=page on the leaf). Renders nothing when crumbs.length === 0. - shared/breadcrumb/types.ts: Crumb = LinkCrumb | LeafCrumb discriminated union. - shared/breadcrumb/store.ts: Pinia store + useCrumbs(source) composable that auto-clears on unmount. Accepts a static array OR a reactive ref/computed so pages with async doc fetches can rebuild crumbs as data lands. - shared/breadcrumb/text.ts: truncate(text, max) helper. Wiring - App.vue main outlet now sits below <AppBreadcrumb>; the shell reads from useBreadcrumbStore so pages don't need teleports. - DocWorkspacePage provides Studio > <id-truncated> > <mode-label>; once the doc is fetched (#216 / E4), the id placeholder will swap for the truncated filename. i18n - breadcrumb.aria, breadcrumb.studio, breadcrumb.mode.{ask,inspect, chunks} added in fr + en. Tests - shared/breadcrumb/text.test.ts: 5 cases on truncate. - shared/breadcrumb/store.test.ts: store actions + useCrumbs reactive/ static seeding (the lifecycle-clear path is covered end-to-end by the integration tests landing in #211 / #216 — the project doesn't use @vue/test-utils so a unit test for onBeforeUnmount is overkill). Refs #208
14 lines
620 B
TypeScript
14 lines
620 B
TypeScript
/**
|
|
* Truncate `text` to at most `max` characters, replacing the tail with
|
|
* an ellipsis when shortened. Returns the original string if it
|
|
* already fits.
|
|
*
|
|
* Used by the breadcrumb to keep the topbar tidy when document
|
|
* filenames are long. The full title stays available via the `title`
|
|
* attribute on the segment so the user can hover to read it whole.
|
|
*/
|
|
export function truncate(text: string, max: number): string {
|
|
if (max <= 0 || text.length <= max) return text
|
|
// Reserve one character for the ellipsis so the visible length is `max`.
|
|
return text.slice(0, Math.max(0, max - 1)).trimEnd() + '…'
|
|
}
|