import { useEffect, useReducer, useState, type Dispatch } from 'react' import type { AnatomicalSheetDocument, Annotation, Geometry, } from '@faunosteo/core-wasm/types' import type { CommitContext } from '@/editor/annotations/annotationCommit' import { useAnnotationRequest } from '@/editor/annotations/focusTarget' import { keyboardPending, type NewKind } from '@/editor/annotations/creation' import { parseFrame, type Frame } from '@/editor/annotations/frame' import { newPointSize } from '@/editor/annotations/pointSize' import { guardDrawing } from '@/editor/annotations/drawingGuard' import { usePointEdit } from '@/editor/annotations/usePointEdit' import { useZoneEdit } from '@/editor/annotations/useZoneEdit' import { useRedrawFollowsTracing } from '@/editor/annotations/redraw' import { useDroppedNotice, useModeFollowsSelection, } from '@/editor/annotations/modeEnds' import { handledPoints } from '@/editor/annotations/zoneEdit' import { isEditable } from '@/editor/annotations/geometryEdit' import { useSelectionEscape } from '@/editor/annotations/deselect' import { useLayerFollow, type OpenDialog, } from '@/editor/annotations/dialogOpening' import { usePlacement } from '@/editor/annotations/usePlacement' import { useGestureMessage } from '@/editor/annotations/useGestureMessage' import { initialUi, uiReducer, type ToolId, type UiAction, type UiState, } from '@/editor/annotations/uiState' import type { RootAttributes } from '@/editor/annotations/useCanvasBuild' import { mainViewId, useViewModel, type ViewModel, } from '@/editor/annotations/useViewModel' import type { AnnotationSection } from '@/editor/navigation' import { usePlaceVisible } from '@/lib/placeVisibility' import type { EditorPlaceProps } from '@/editor/tabs' import { useT } from '@/i18n/useT' import { useLocaleStore } from '@/state/localeStore' import AnnotationCanvas from './AnnotationCanvas' import { annotationName } from './AnnotationList' import CreationPanel from './CreationPanel' import GestureMessage from './GestureMessage' import KeyboardAdd from './KeyboardAdd' import OverviewPanel from './OverviewPanel' import SceneStrip from './SceneStrip' import ViewSwitcher from './ViewSwitcher' interface Props { doc: AnatomicalSheetDocument navigate: EditorPlaceProps['navigate'] onOpenSection: (section: AnnotationSection, opener: HTMLElement) => void focus: EditorPlaceProps['focus'] /** Opens the properties dialog (A1); the layer's id, which the selection follows. */ onOpen: OpenDialog layerId: string | null } /** What both columns read: the tab's state, the view, its frame and its selection. */ export interface Scene { doc: AnatomicalSheetDocument ui: UiState dispatch: Dispatch viewId: string model: ViewModel /** F of the current view, only while the core measures it and the build is its own. */ frame: Frame | null selected: Annotation | undefined setRoot: (root: RootAttributes | null) => void navigate: EditorPlaceProps['navigate'] onOpenSection: Props['onOpenSection'] onOpen: OpenDialog } /** * The shown view no longer exists (an undo, a deletion in the views section): the full * reset to the main view drops the pending creation, the tracing and the selection, so * nothing pending is inserted on another view. It fires only for a view absent from the * document, since `view` always returns a new state. */ function useViewFallback( doc: AnatomicalSheetDocument, shown: string | null, dispatch: Dispatch, ) { useEffect(() => { if (shown === null || doc.views.some((view) => view.id === shown)) return const main = mainViewId(doc) if (doc.views.some((view) => view.id === main)) { dispatch({ type: 'view', viewId: main }) } }, [doc, shown, dispatch]) } /** « Aller à » an annotation: the request, with what it needs of the drawing's state. */ function useSceneRequest( { doc, focus, layerId }: Props, ui: UiState, viewId: string, dispatch: Dispatch, ) { useViewFallback(doc, ui.viewId, dispatch) const show = (view: string, id: string) => { if (view !== viewId) dispatch({ type: 'view', viewId: view }) dispatch({ type: 'select', id }) } useAnnotationRequest(focus, doc, { viewId, selectedId: ui.selectedId, busy: ui.pending ? 'creation' : ui.tracing ? 'tracing' : null, show, }) useLayerFollow(layerId, doc, { viewId, selectedId: ui.selectedId, show, clear: () => dispatch({ type: 'select', id: null }), }) } function useScene(props: Props): Scene { const { doc, navigate, onOpenSection, onOpen } = props const [ui, dispatch] = useReducer(uiReducer, initialUi) const [root, setRoot] = useState(null) const viewId = ui.viewId ?? mainViewId(doc) const model = useViewModel(doc, viewId) const own = model.measured && root?.viewId === viewId useSceneRequest(props, ui, viewId, dispatch) return { doc, ui, dispatch, viewId, model, frame: own ? parseFrame(root.viewBox) : null, selected: model.annotations.find((a) => a.id === ui.selectedId), setRoot, navigate, onOpenSection, onOpen, } } function useCommitContext(): CommitContext { const t = useT() const locale = useLocaleStore((s) => s.locale) return { t, locale } } /** * The tab's work: the commit context, the line under the drawing, the placement, the * editing of the movable selection (point handle keys, slider, move mode) and of a * polygon's vertices, the redraw kept in step with its tracing. */ function useWork(scene: Scene) { const context = useCommitContext() const message = useGestureMessage() const placement = usePlacement({ ...scene, context, message }) const target = movableOf(scene.selected, scene.model, scene.ui.tool) const onDrop = placement.onDrop const edit = usePointEdit({ target, frame: scene.frame, onDrop }) const polygon = target?.geometry?.type === 'polygon' ? target : null const zone = useZoneEdit({ ...{ target: polygon, frame: scene.frame, onDrop, message }, t: context.t, confirmMove: edit.confirmMove, }) const [insertsHidden, setInsertsHidden] = useState(false) useModeFollowsSelection(scene.ui.selectedId) useRedrawFollowsTracing(scene.ui.tracing, scene.dispatch) useDroppedNotice(message) return { context, message, placement, edit, zone, target, insertsHidden, setInsertsHidden, } } export type Work = ReturnType export default function EditableAnnotations(props: Props) { const scene = useScene(props) const work = useWork(scene) const { ui, selected } = scene const visible = usePlaceVisible() const { asideRef, byDrawing } = useSelectionEscape( selected?.id ?? null, () => scene.dispatch({ type: 'select', id: null }), // A redraw's Escape cancels it at once (R-12); a new tracing keeps its own keys. visible && selected !== undefined && (ui.tracing === null || ui.tracing.target === 'replace'), { editable: true, creating: ui.pending !== null }, ) return (
) } /** A move that drops the drawing's work asks first (R-12): the action runs once allowed. */ const guarded = (action: () => void) => () => { if (guardDrawing(action)) action() } function CanvasColumn({ scene, work, onDeselect, }: { scene: Scene work: Work onDeselect: () => void }) { const { doc, dispatch, model } = scene const noCategory = doc.categories.length === 0 return (
guarded(() => dispatch({ type: 'view', viewId: id }))() } /> guarded(() => addAtCentre(kind, scene))()} />
) } /** The handle of the movable selected circle, named « Point {nom} » (« Accès {nom} »). */ function useHandle(target: Annotation | null, doc: AnatomicalSheetDocument) { const t = useT() const locale = useLocaleStore((s) => s.locale) if (target?.geometry?.type !== 'circle') return null const name = annotationName(target, doc.views, locale) const kind = t(`editor.annotations.kind.${target.kind}`) const label = t('editor.annotations.handle.shape') .replace('{kind}', () => kind) .replace('{name}', () => name) return { annotationId: target.id, label, stored: target.geometry, } } function CanvasStage({ scene, work, onDeselect, }: { scene: Scene work: Work onDeselect: () => void }) { const locale = useLocaleStore((s) => s.locale) // Hidden (the editor is read-only): no drag in flight survives, none is committed. const shown = usePlaceVisible() const { doc, ui, dispatch, model, frame, selected } = scene const handle = useHandle(shown ? work.target : null, doc) const points = shown ? handledPoints(work.target?.geometry ?? null) : null const zone = points && { annotationId: work.target!.id, points } const view = doc.views.find((v) => v.id === scene.viewId) const blocked = !model.measured || doc.categories.length === 0 if (!view) return null return ( guarded(() => dispatch({ type: 'tool', tool }))(), drawingDisabled: blocked, linkDisabled: model.children.length === 0, }} onRoot={scene.setRoot} onSelect={(id) => dispatch({ type: 'select', id })} onOpen={(id) => scene.onOpen(id, 'drawing')} onPlace={work.placement.onPlace} onDrop={work.placement.onDrop} onHandle={work.zone.onHandle} onDeselect={onDeselect} onTraceKey={work.placement.onTraceKey} /> ) } function addAtCentre( kind: NewKind, { frame, doc, viewId, ui, dispatch }: Scene, ) { if (!frame) return const size = newPointSize(doc.annotations, viewId, frame, ui.size) dispatch({ type: 'pending_new', pending: keyboardPending(kind, frame, size) }) } /** The creation panel while an element is pending, else the overview (A3). */ function SidePanel({ scene, context, }: { scene: Scene context: CommitContext }) { const { doc, ui, dispatch, frame } = scene if (ui.pending) { return ( ) } return ( dispatch({ type: 'filter', term })} // The column stays shown during a selection (A3): a row or a view that would drop // a started move or redraw asks first (R-12). onSelectView={(id) => guarded(() => dispatch({ type: 'view', viewId: id }))() } selectedId={scene.selected?.id ?? null} onSelectAnnotation={(id) => guarded(() => dispatch({ type: 'select', id }))() } onOpenAnnotation={(id) => scene.onOpen(id, 'drawing')} onOpenSection={scene.onOpenSection} /> ) } function moveTargetOf( selected: Annotation | undefined, model: ViewModel, tool: ToolId, ) { if (!selected || !model.measured || tool !== 'select') return null return isEditable(selected.geometry) ? { id: selected.id, kind: selected.kind, geometry: selected.geometry } : null } /** The selection when it can be moved now: a circle (its handle) or a polygon (R-9). */ function movableOf( selected: Annotation | undefined, model: ViewModel, tool: ToolId, ): Annotation | null { return moveTargetOf(selected, model, tool) !== null ? selected! : null } function overlayOf( ui: UiState, selected: Annotation | undefined, frame: Frame | null, refused: Geometry | null | undefined, ) { return { frame, selectedId: selected?.id ?? null, refused: refused ?? null, selected: selected?.geometry ?? null, pending: ui.pending?.geometry ?? null, tracing: ui.tracing?.points ?? null, correction: ui.pending?.correction ?? null, redrawing: ui.tracing?.target === 'replace', } }