docling-studio/frontend/src/shared/routing/names.ts
Pier-Jean Malandrino f10cd01594 feat(#207): document-centric routing skeleton
Adds the routing scaffold for the doc-centric pivot. Each new route
renders a placeholder page until E3/E4/E5 implement them; legacy
routes (/studio, /documents, /history, /search, /reasoning) keep
working in parallel.

New routes (Vue Router, history mode):
  /docs                   library (placeholder, #211)
  /docs/new               import (placeholder, #214)
  /docs/:id?mode=         workspace (placeholder, #216)
  /index                  stores list (placeholder, 0.7.0)
  /index/:store           store detail (placeholder)
  /index/:store/query     RAG playground (placeholder)
  /runs                   run history (placeholder)
  /runs/:id               run detail (placeholder)

Mode parsing
- shared/routing/modes.ts: DocMode union ('ask'|'inspect'|'chunks'),
  parseMode() returns the default ('ask') for missing or unknown
  values. #210 will layer feature-flag-aware redirection on top.

Route names
- shared/routing/names.ts: ROUTES typed const so callers do
  router.push({ name: ROUTES.DOC_WORKSPACE, ... }) instead of
  stringly-typed names.

Pages
- ComingSoonShell shared component: card + back-home link, themed
  with existing CSS tokens.
- 8 thin placeholder pages (one per new route) that compose the shell
  and forward route params.
- i18n keys under comingSoon.* added in fr + en.

Tests
- shared/routing/modes.test.ts (10 cases): isDocMode + parseMode +
  ALL_MODES invariants.
- app/router/router.test.ts (5 cases): every doc-centric route
  resolves to a component, legacy routes still work, doc workspace
  receives id and parsed mode as props, unknown mode falls back to
  ask, unknown path redirects to home.

Routes table extracted to routes.ts so tests build a router with
createMemoryHistory() (no window required) instead of needing the
production createWebHistory() router.

Refs #207
2026-04-29 17:38:19 +02:00

35 lines
939 B
TypeScript

/**
* Canonical route name constants — typed to keep callers honest.
*
* Use:
*
* router.push({ name: ROUTES.DOC_WORKSPACE, params: { id } })
*
* instead of stringly-typed names. Adding a route requires touching
* exactly two places: the router definition and this file.
*/
export const ROUTES = {
// Existing legacy routes — kept until E3/E4/E5 replace them.
HOME: 'home',
STUDIO: 'studio',
HISTORY: 'history',
DOCUMENTS: 'documents',
SEARCH: 'search',
REASONING: 'reasoning',
REASONING_DOC: 'reasoning-doc',
SETTINGS: 'settings',
NOT_FOUND: 'not-found',
// 0.6.0 — Document-centric routes (#207).
DOCS_LIBRARY: 'docs-library',
DOCS_NEW: 'docs-new',
DOC_WORKSPACE: 'doc-workspace',
STORES_LIST: 'stores-list',
STORE_DETAIL: 'store-detail',
STORE_QUERY: 'store-query',
RUNS: 'runs',
RUN_DETAIL: 'run-detail',
} as const
export type RouteName = (typeof ROUTES)[keyof typeof ROUTES]