refactor: move document transcription, annotation, viewer sub-packages

- transcription/: TranscriptionBlock, Column, EditView, PanelHeader, ReadView,
  Section + transcriptionMarkers, blockConflictMerge, saveBlockWithConflictRetry
  + useBlockAutoSave, useBlockDragDrop hooks
- annotation/: AnnotationLayer, AnnotationShape, AnnotationEditOverlay
- viewer/: PdfViewer, PdfControls + useFileLoader, usePdfRenderer hooks

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

frontend/src/lib/components/MissionControlStrip.svelte

@@ -2,7 +2,7 @@
 import * as m from '$lib/paraglide/messages.js';
 import type { components } from '$lib/generated/api';
 import SegmentationColumn from '$lib/document/SegmentationColumn.svelte';
-import TranscriptionColumn from './TranscriptionColumn.svelte';
+import TranscriptionColumn from '$lib/document/transcription/TranscriptionColumn.svelte';
 import ReadyColumn from '$lib/document/ReadyColumn.svelte';
 
 type TranscriptionQueueItemDTO = components['schemas']['TranscriptionQueueItemDTO'];

frontend/src/lib/document/BulkDocumentEditLayout.svelte

@@ -13,7 +13,7 @@ import ScopeCard from './ScopeCard.svelte';
 import UploadSaveBar from './UploadSaveBar.svelte';
 import WhoWhenSection from './WhoWhenSection.svelte';
 import DescriptionSection from './DescriptionSection.svelte';
-import PdfViewer from '$lib/components/PdfViewer.svelte';
+import PdfViewer from '$lib/document/viewer/PdfViewer.svelte';
 import { bulkTitleFromFilename } from '$lib/document/filename';
 import type { Tag } from '$lib/components/TagInput.svelte';
 import type { components } from '$lib/generated/api';

frontend/src/lib/document/DocumentEditLayout.svelte

@@ -3,7 +3,7 @@ import { enhance } from '$app/forms';
 import { invalidate } from '$app/navigation';
 import { onMount, onDestroy, untrack } from 'svelte';
 import type { Snippet } from 'svelte';
-import { createFileLoader } from '$lib/hooks/useFileLoader.svelte';
+import { createFileLoader } from '$lib/document/viewer/useFileLoader.svelte';
 import { m } from '$lib/paraglide/messages.js';
 import { countRequiredFilled } from '$lib/utils/requiredFields';
 import { validateFile } from '$lib/document/validateFile';

frontend/src/lib/document/DocumentViewer.svelte

@@ -1,6 +1,6 @@
 <script lang="ts">
 import { m } from '$lib/paraglide/messages.js';
-import PdfViewer from '$lib/components/PdfViewer.svelte';
+import PdfViewer from '$lib/document/viewer/PdfViewer.svelte';
 
 type Doc = {
 	id: string;

frontend/src/lib/document/transcription/TranscriptionBlock.svelte

@@ -1,8 +1,8 @@
 <script lang="ts">
 import { m } from '$lib/paraglide/messages.js';
 import { getConfirmService } from '$lib/services/confirm.svelte.js';
-import CommentThread from './CommentThread.svelte';
-import PersonMentionEditor from './PersonMentionEditor.svelte';
+import CommentThread from '$lib/components/CommentThread.svelte';
+import PersonMentionEditor from '$lib/components/PersonMentionEditor.svelte';
 import type { PersonMention } from '$lib/types';
 
 const { confirm } = getConfirmService();

frontend/src/lib/document/transcription/TranscriptionColumn.svelte

@@ -3,7 +3,7 @@ import * as m from '$lib/paraglide/messages.js';
 import { getLocale } from '$lib/paraglide/runtime.js';
 import { formatMCDate } from '$lib/utils/date.js';
 import type { components } from '$lib/generated/api';
-import ContributorStack from './ContributorStack.svelte';
+import ContributorStack from '$lib/components/ContributorStack.svelte';
 
 type TranscriptionQueueItemDTO = components['schemas']['TranscriptionQueueItemDTO'];
 

frontend/src/lib/document/transcription/TranscriptionEditView.svelte

@@ -1,11 +1,11 @@
 <script lang="ts">
 import { m } from '$lib/paraglide/messages.js';
 import TranscriptionBlock from './TranscriptionBlock.svelte';
-import OcrTrigger from './OcrTrigger.svelte';
-import TranscribeCoachEmptyState from './TranscribeCoachEmptyState.svelte';
+import OcrTrigger from '$lib/components/OcrTrigger.svelte';
+import TranscribeCoachEmptyState from '$lib/components/TranscribeCoachEmptyState.svelte';
 import type { PersonMention, TranscriptionBlockData } from '$lib/types';
-import { createBlockAutoSave } from '$lib/hooks/useBlockAutoSave.svelte';
-import { createBlockDragDrop } from '$lib/hooks/useBlockDragDrop.svelte';
+import { createBlockAutoSave } from '$lib/document/transcription/useBlockAutoSave.svelte';
+import { createBlockDragDrop } from '$lib/document/transcription/useBlockDragDrop.svelte';
 
 type Props = {
 	documentId: string;

frontend/src/lib/document/transcription/TranscriptionPanelHeader.svelte

@@ -1,7 +1,7 @@
 <script lang="ts">
 import { m } from '$lib/paraglide/messages.js';
 import { getLocale } from '$lib/paraglide/runtime.js';
-import HelpPopover from './HelpPopover.svelte';
+import HelpPopover from '$lib/components/HelpPopover.svelte';
 
 type Props = {
 	mode: 'read' | 'edit';

frontend/src/lib/document/transcription/TranscriptionReadView.svelte

@@ -1,14 +1,14 @@
 <script lang="ts">
 import type { TranscriptionBlockData } from '$lib/types';
 import type { components } from '$lib/generated/api';
-import { splitByMarkers } from '$lib/utils/transcriptionMarkers';
+import { splitByMarkers } from '$lib/document/transcription/transcriptionMarkers';
 import {
 	renderTranscriptionBody,
 	type SafeHtml,
 	PERSON_MENTION_SELECTOR
 } from '$lib/utils/mention';
 import { computeHoverCardPosition } from '$lib/utils/hoverCardPosition';
-import PersonHoverCard from './PersonHoverCard.svelte';
+import PersonHoverCard from '$lib/components/PersonHoverCard.svelte';
 import type { HoverData, LoadState } from '$lib/types/personHoverCard';
 import { goto } from '$app/navigation';
 import { SvelteMap, SvelteSet } from 'svelte/reactivity';

frontend/src/lib/document/transcription/saveBlockWithConflictRetry.ts

@@ -1,5 +1,8 @@
 import type { PersonMention, TranscriptionBlockData } from '$lib/types';
-import { BlockConflictResolvedError, mergeBlockOnConflict } from '$lib/utils/blockConflictMerge';
+import {
+	BlockConflictResolvedError,
+	mergeBlockOnConflict
+} from '$lib/document/transcription/blockConflictMerge';
 
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 

frontend/src/lib/document/transcription/useBlockAutoSave.svelte.test.ts

@@ -6,7 +6,7 @@ const mockSaveFn =
 
 const NO_MENTIONS: PersonMention[] = [];
 
-const { createBlockAutoSave } = await import('../useBlockAutoSave.svelte');
+const { createBlockAutoSave } = await import('./useBlockAutoSave.svelte');
 
 describe('createBlockAutoSave', () => {
 	beforeEach(() => {

frontend/src/lib/document/transcription/useBlockDragDrop.svelte.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect, vi } from 'vitest';
-import { createBlockDragDrop } from '../useBlockDragDrop.svelte';
+import { createBlockDragDrop } from './useBlockDragDrop.svelte';
 import type { TranscriptionBlockData } from '$lib/types';
 
 function makeBlock(id: string, sortOrder: number): TranscriptionBlockData {

frontend/src/lib/document/viewer/PdfViewer.svelte

@@ -1,8 +1,8 @@
 <script lang="ts">
 import { onMount, setContext } from 'svelte';
-import { createPdfRenderer } from '$lib/hooks/usePdfRenderer.svelte';
+import { createPdfRenderer } from '$lib/document/viewer/usePdfRenderer.svelte';
 import PdfControls from './PdfControls.svelte';
-import AnnotationLayer from './AnnotationLayer.svelte';
+import AnnotationLayer from '$lib/document/annotation/AnnotationLayer.svelte';
 import type { Annotation } from '$lib/types';
 import { m } from '$lib/paraglide/messages.js';
 import { parseBackendError, getErrorMessage } from '$lib/errors';

frontend/src/lib/document/viewer/useFileLoader.svelte.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect, vi, afterEach } from 'vitest';
-import { createFileLoader } from '../useFileLoader.svelte';
+import { createFileLoader } from './useFileLoader.svelte';
 
 const FAKE_URL = 'blob:fake-url';
 

frontend/src/lib/document/viewer/usePdfRenderer.svelte.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { createPdfRenderer } from '../usePdfRenderer.svelte';
+import { createPdfRenderer } from './usePdfRenderer.svelte';
 
 // Note: init() and loadDocument() require pdfjsLib (browser module).
 // These tests cover pure state logic only — bounds clamping and zoom limits.

frontend/src/routes/documents/[id]/+page.svelte

@@ -5,13 +5,13 @@ import { page } from '$app/state';
 import { replaceState } from '$app/navigation';
 import DocumentTopBar from '$lib/document/DocumentTopBar.svelte';
 import DocumentViewer from '$lib/document/DocumentViewer.svelte';
-import TranscriptionEditView from '$lib/components/TranscriptionEditView.svelte';
-import TranscriptionReadView from '$lib/components/TranscriptionReadView.svelte';
-import TranscriptionPanelHeader from '$lib/components/TranscriptionPanelHeader.svelte';
+import TranscriptionEditView from '$lib/document/transcription/TranscriptionEditView.svelte';
+import TranscriptionReadView from '$lib/document/transcription/TranscriptionReadView.svelte';
+import TranscriptionPanelHeader from '$lib/document/transcription/TranscriptionPanelHeader.svelte';
 import type { TranscriptionBlockData } from '$lib/types';
 import { getErrorMessage } from '$lib/errors';
 import { translateOcrProgress } from '$lib/ocr/translateOcrProgress';
-import { createFileLoader } from '$lib/hooks/useFileLoader.svelte';
+import { createFileLoader } from '$lib/document/viewer/useFileLoader.svelte';
 import { scrollToCommentFromQuery } from '$lib/utils/deepLinkScroll';
 import { getConfirmService } from '$lib/services/confirm.svelte.js';
 
@@ -93,8 +93,10 @@ async function saveBlock(
 	text: string,
 	mentionedPersons: import('$lib/types').PersonMention[]
 ) {
-	const { saveBlockWithConflictRetry } = await import('$lib/utils/saveBlockWithConflictRetry');
-	const { BlockConflictResolvedError } = await import('$lib/utils/blockConflictMerge');
+	const { saveBlockWithConflictRetry } =
+		await import('$lib/document/transcription/saveBlockWithConflictRetry');
+	const { BlockConflictResolvedError } =
+		await import('$lib/document/transcription/blockConflictMerge');
 	try {
 		const updated = await saveBlockWithConflictRetry({
 			fetchImpl: fetch,