Files
faunosteo/apps/app/src/editor/annotations/useCanvasBuild.ts
T
bchanot 6689827a8d feat(editor): kept-mounted tabs, sections and references panel
Each visited tab, Annotations section and the references panel stay
mounted in a KeptPlace (hidden, nested visibility). Composed canvases
detach while hidden. One JSON.parse per document text. Focus requests
reach only their owning place.

Rewritten assertions (R-24):
- editor-route.test.tsx:127: annotations testid toBeNull -> not.toBeVisible
- editor-sections.test.tsx: place('annotations.drawing') toBeNull -> not.toBeVisible
- editor-journey.spec.ts:311: page-wide getByLabel('Nom (FR)') -> scoped to place 'general'
- editor-tabs-lists.test.tsx: ReferencesPanel `open` prop dropped (the wrapper hides it)
- editor-annotations-tab, editor-focus-request, editor-sections tests: props gain `visited`
No assertion removed.
2026-11-06 20:50:40 +01:00

92 lines
3.1 KiB
TypeScript

import { useCallback, useEffect, useRef, useState } from 'react'
import { buildView } from '@/components/catalogue/CatalogueCanvas'
import { usePlaceVisible } from '@/components/editor/KeptPlace'
import { coreRuntime } from '@/core/runtime'
import { useEditorStore } from '../state/editorStore'
/** The composed root's own attributes, read as text (never `baseVal`), and its view. */
export interface RootAttributes {
/** The view this build was made for: a frame is never paired with another view's. */
viewId: string
viewBox: string | null
ratio: string
}
export type CanvasFailure = 'engine' | 'view'
interface Built {
root: RootAttributes | null
failure: CanvasFailure | null
}
const ANNOTATED = '[data-anno-id]'
function rootOf(viewId: string, svg: Element): RootAttributes {
return {
viewId,
viewBox: svg.getAttribute('viewBox'),
ratio: svg.getAttribute('preserveAspectRatio') ?? 'xMidYMid meet',
}
}
/** What the canvas rebuilds on: the handle, its version counter and its place shown. */
function useHandle() {
const preview = useEditorStore((s) => s.preview)
const version = useEditorStore((s) => s.handleVersion)
return { preview, version, visible: usePlaceVisible() }
}
/**
* Builds the core's composed view into `host`, again on every accepted handle change or
* retry (plan « Rendering and canvas »): the edit canvas follows the handle. Root and
* failure come from the same build; a failure is the engine notice (retry) or the view
* notice.
*/
export function useCanvasBuild(viewId: string) {
const handle = useHandle()
const host = useRef<HTMLDivElement | null>(null)
const [attempt, setAttempt] = useState(0)
const [built, setBuilt] = useState<Built>({ root: null, failure: null })
useEffect(() => {
const element = host.current
if (!element || !handle.preview) return
// One composed copy of a view in the page: the ids repeat otherwise.
if (!handle.visible) return element.replaceChildren()
const result = buildView(handle.preview, viewId)
element.replaceChildren(...(result.ok ? [result.svg] : []))
setBuilt(
result.ok
? { root: rootOf(viewId, result.svg), failure: null }
: { root: null, failure: result.failure },
)
}, [handle.preview, viewId, handle.version, attempt, handle.visible])
const retry = useCallback(() => {
void coreRuntime()
.retry()
.finally(() => setAttempt((n) => n + 1))
}, [])
return { host, ...built, retry }
}
/** The selected annotation's markers wear `data-state="current"`, restyled in place. */
export function useSelectionMark(
host: React.RefObject<HTMLDivElement | null>,
selectedId: string | null,
rebuilt: unknown,
): void {
useEffect(() => {
host.current?.querySelectorAll<Element>(ANNOTATED).forEach((el) => {
if (el.getAttribute('data-anno-id') === selectedId) {
el.setAttribute('data-state', 'current')
} else el.removeAttribute('data-state')
})
}, [host, selectedId, rebuilt])
}
export const annotationIdOf = (target: EventTarget | null): string | null =>
target instanceof Element
? (target.closest(ANNOTATED)?.getAttribute('data-anno-id') ?? null)
: null