The panel opens only from a finding's « {n} références » trigger: 34 rem
at most, never wider than the room, a scrim, slide in 180 ms and out
140 ms (motion/react; none under reduced motion, callbacks still fire).
It lists the finding's references as tiles with « Modifier », « Retirer
de ce constat » (one « Défaire » restores it and the review status) and
« Aller à »; dangling ids read « Référence introuvable »; zero left
reads « Ce constat ne cite plus aucune référence. ». « Tout afficher
dans l'onglet Références » resets search and sort, keeps open tiles and
edits. Every close (✕, Escape outside fields, scrim, tab, « Aller à »,
« Tout afficher », element gone) records one pending move applied
after the exit, page inert until then; focus back to the trigger, else
the active tab button. A refused draft cancels a user close; a forced
close drops it and announces « Saisie non appliquée : {field} ». Places
keeps a permanent dvh min-height; the panel fits the visible viewport
at every scroll position, document size unchanged.
Gates: typecheck, lint, test:run (app 1488), build, e2e:ui 251;
e2e:shell 16 specs on db:sandbox (admin and editor-equine excluded):
117 passed / 107 skipped / 0 failed, rerun after the fix rounds: 118
passed / 108 skipped / 0 failed; layout spec 13 passed after round 2;
full-row guard: no pre-existing row changed in any table. Known limit:
landscape 667 x 375 at scroll 0 leaves ~13 px of panel (the trigger is
below the fold there).
## R-24 (removed or rewritten assertions)
| file | old | new |
|---|---|---|
| editor-references-panel.test.tsx (whole file) | R2.1 interim-panel tests, synchronous closes | rewritten: 39 tests (opening, motion, close matrix in both modes, exit, Retirer, P22'', library + history) |
| same, opening | heading `Références` focused right after the click | heading `Références citées` focused after the enter (`waitFor`), `aria-expanded` only after click |
| same | chip `references-filter-chip` « Citées par « Node A » (2) » | REMOVED (REVUE: path line + count line « 2 références citées par ce constat ») |
| same | `listitem` cards « Citée 2 fois » | tiles (`ul > li`) with the same counts, in the finding's order |
| same | field id `#panel-reference-0-ref-a-citation` present at once | tile opened + « Modifier » first (tiles since R2.2) |
| same | « Tout afficher (3) », sync | « Tout afficher dans l'onglet Références », after exit, heading focus asserted |
| same | Escape / ✕ / scrim / tab / vanish: sync null panel | all `await closed()` + `document.activeElement` checks, `describe.each` normal / reduced motion |
| same | « makes the tab panels inert while open, header usable » | split: inert page + inert panel until the exit ends then lifted; « Défaire / Refaire usable »; the `Enregistrer` enabled check dropped (covered by the focus-moved-off test) |
| same | Ctrl+Z test on an always-open field | open tile + Modifier first |
| same | read-only: no Supprimer, no textbox | open tile: no Modifier, no Retirer, no textbox |
| same | P6 under « Plus »: sync | in the close matrix, awaited |
| editor-escape.test.tsx (2 tests) | `expect(citations()).toBeNull()` right after Escape | `await waitFor(...)`; trigger `aria-expanded` false after exit |
| editor-keep-alive.test.tsx | « Escape in a citations panel field commits the text before the panel closes » | REPLACED by « Escape in a field of a panel tile neither closes nor commits » (A5, P27) |
| same | scrim click closes the panel after committing, sync, id on a closed tile | tile opened in edit first, close awaited, commit asserted before the exit |
| editor-focus-request.test.tsx | `ReferenceLibrary` with `resetSignal`; `ownedBy(ref,'citations')` undefined | `ReferencesTab` (+ `reloadSheet`); the `'citations'` assertion removed with the type |
| editor-references-tab / -view.test.tsx | `ReferenceLibrary`, `resetSignal` | `ReferencesTab`, `libraryReset` (+ `reloadSheet`) |
| e2e support `openCitations` | waited for the panel visible | also waits for the heading focus (slide over) |
New unit coverage: editor-citations-exit.test.tsx (hook, fake timers), editor-findings (aria-expanded per finding),
`useDecisionsOpen` gate, panel file (Retirer + status + one undo, P20 chain, zero state, dangling id, P4 reset, P6 after undo,
P22'' four paths, reduced motion, inert/exit, second close, tab replace, focus-moved-off).
## i18n (FR / EN)
Added: `editor.references.panel_title` Références citées / Cited references; `panel_count_one|other` « {count} référence citée par
ce constat » / « {count} références citées par ce constat » and « {count} reference cited by this finding » / « … references … »;
`panel_show_all` Tout afficher dans l'onglet Références / Show all in the References tab; `panel_empty` Ce constat ne cite plus
aucune référence. / This finding no longer cites any reference.; `remove_citation` Retirer de ce constat / Remove from this finding;
`this_finding` ce constat / this finding; `missing` Référence introuvable / Reference not found; `draft_dropped`
Saisie non appliquée : {field} / Entry not applied: {field}.
Changed: none. Removed: `editor.references.cited_by` (« Citées par « {name} » ({count}) » / « Cited by « {name} » ({count}) »),
`editor.references.show_all` (« Tout afficher ({count}) » / « Show all ({count}) »). R10 grep over src, tests and e2e including
editor-equine: no reader left. `editor-equine` has no panel reference: « updated, not run » (nothing to update). The three
provisional FR labels are exactly as listed in the brief; `…` = the refused field's label.
62 lines
2.1 KiB
TypeScript
62 lines
2.1 KiB
TypeScript
import { useCallback, useEffect, useRef, useState } from 'react'
|
|
import type { NavigationAction } from './navigation'
|
|
|
|
/** Panel motion (board 25): enter decelerates, the shorter exit accelerates (P9). */
|
|
export const PANEL_ENTER_S = 0.18
|
|
export const PANEL_EXIT_S = 0.14
|
|
|
|
/** The exit plus a margin: past it, a callback that never came is applied by the timer. */
|
|
const FALLBACK_MS = PANEL_EXIT_S * 1000 + 100
|
|
|
|
export type PendingKind =
|
|
| 'go_to'
|
|
| 'citations_closed'
|
|
| 'show_all'
|
|
| 'tab_selected'
|
|
|
|
/** The one move a close records: applied when the exit is over (P9). */
|
|
export interface PendingClose {
|
|
action: NavigationAction
|
|
kind: PendingKind
|
|
text: string
|
|
/** Said before `text`: a draft dropped by a forced close. It survives a replacement. */
|
|
note?: string
|
|
}
|
|
|
|
/**
|
|
* The close of the citations panel as a two-step move (P9, P28): `record` starts the exit
|
|
* (the page stays inert, the panel is inert too); `complete` runs once, from the panel's
|
|
* `onExitComplete` or from a one-shot timer when that never fires, and hands the pending
|
|
* move to `apply`. A second close is a no-op; a tab choice replaces the pending move.
|
|
*/
|
|
export function useCitationsExit(apply: (move: PendingClose) => void) {
|
|
const [exiting, setExiting] = useState(false)
|
|
const pending = useRef<PendingClose | null>(null)
|
|
const timer = useRef<number | undefined>(undefined)
|
|
const complete = useCallback(() => {
|
|
const move = pending.current
|
|
if (move === null) return
|
|
pending.current = null
|
|
window.clearTimeout(timer.current)
|
|
setExiting(false)
|
|
apply(move)
|
|
}, [apply])
|
|
const record = useCallback(
|
|
(move: PendingClose) => {
|
|
if (pending.current !== null) {
|
|
if (move.kind !== 'tab_selected') return
|
|
const note = pending.current.note ?? move.note
|
|
pending.current = note ? { ...move, note } : move
|
|
return
|
|
}
|
|
pending.current = move
|
|
setExiting(true)
|
|
timer.current = window.setTimeout(complete, FALLBACK_MS)
|
|
},
|
|
[complete],
|
|
)
|
|
const busy = useCallback(() => pending.current !== null, [])
|
|
useEffect(() => () => window.clearTimeout(timer.current), [])
|
|
return { exiting, record, complete, busy }
|
|
}
|