From c1d44c25b4beb53f0ef63db2cad43660f7feb692 Mon Sep 17 00:00:00 2001
From: codebude <netblognet@googlemail.com>
Date: Fri, 11 Sep 2026 13:56:17 +0200
Subject: [PATCH 1/3] Added basket functionality

---
 frontend/package-lock.json                    |  15 ++
 frontend/package.json                         |   1 +
 .../src/lib/components/AddBookModal.svelte    | 100 +++++++++-
 .../src/lib/components/AddBookModal.test.ts   | 172 +++++++++++++++++-
 .../src/lib/components/BasketPanel.svelte     | 103 +++++++++++
 .../src/lib/components/ImportSearch.svelte    |  37 +++-
 .../src/lib/components/ImportSearch.test.ts   | 170 ++++++++++++++++-
 frontend/src/lib/i18n/locales/de.json         |  13 +-
 frontend/src/lib/i18n/locales/en.json         |  13 +-
 frontend/src/lib/i18n/locales/es.json         |  13 +-
 frontend/src/lib/i18n/locales/fr.json         |  13 +-
 frontend/src/lib/i18n/locales/zh.json         |  13 +-
 frontend/src/lib/types.ts                     |   8 +
 frontend/src/lib/utils/importSearch.test.ts   |  26 +++
 frontend/src/lib/utils/importSearch.ts        |   7 +
 15 files changed, 686 insertions(+), 18 deletions(-)
 create mode 100644 frontend/src/lib/components/BasketPanel.svelte

diff --git a/frontend/package-lock.json b/frontend/package-lock.json
index ecb65371..2a7e478b 100644
--- a/frontend/package-lock.json
+++ b/frontend/package-lock.json
@@ -31,6 +31,7 @@
 				"@sveltejs/vite-plugin-svelte": "^7.0.0",
 				"@testing-library/jest-dom": "^7.0.1",
 				"@testing-library/svelte": "^5.3.1",
+				"@testing-library/user-event": "^14.6.7",
 				"@types/hammerjs": "^2.0.46",
 				"@types/node": "^26.2.0",
 				"@vitest/coverage-v8": "^4.1.7",
@@ -1033,6 +1034,20 @@
 				"svelte": "^3 || ^4 || ^5 || ^5.0.0-next.0"
 			}
 		},
+		"node_modules/@testing-library/user-event": {
+			"version": "14.6.7",
+			"resolved": "https://registry.npmjs.org/@testing-library/user-event/-/user-event-14.6.7.tgz",
+			"integrity": "sha512-MPCpX8bxe8zS+JmmTwLp8jd0dy1rAm60Te/SL8JrQM3qvQJcBOs1d7IefJMyZzqM3EWBrDn/LWDt1BCGu4ASfg==",
+			"dev": true,
+			"license": "MIT",
+			"engines": {
+				"node": ">=12",
+				"npm": ">=6"
+			},
+			"peerDependencies": {
+				"@testing-library/dom": ">=7.21.4"
+			}
+		},
 		"node_modules/@types/aria-query": {
 			"version": "5.0.4",
 			"resolved": "https://registry.npmjs.org/@types/aria-query/-/aria-query-5.0.4.tgz",
diff --git a/frontend/package.json b/frontend/package.json
index 16116bc9..27ad7106 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -23,6 +23,7 @@
 		"@sveltejs/vite-plugin-svelte": "^7.0.0",
 		"@testing-library/jest-dom": "^7.0.1",
 		"@testing-library/svelte": "^5.3.1",
+		"@testing-library/user-event": "^14.6.7",
 		"@types/hammerjs": "^2.0.46",
 		"@types/node": "^26.2.0",
 		"@vitest/coverage-v8": "^4.1.7",
diff --git a/frontend/src/lib/components/AddBookModal.svelte b/frontend/src/lib/components/AddBookModal.svelte
index 5493de08..7314431f 100644
--- a/frontend/src/lib/components/AddBookModal.svelte
+++ b/frontend/src/lib/components/AddBookModal.svelte
@@ -1,14 +1,15 @@
 	<script lang="ts">
-	import type { AcquisitionStatus, Book, Medium, ReadingStatus } from '$lib/types';
+	import type { AcquisitionStatus, BasketItem, Book, Medium, ReadingStatus } from '$lib/types';
 	import { api } from '$lib/api';
 	import { _ } from '$lib/i18n';
 	import { toasts } from '$lib/toasts';
 	import ImportSearch from './ImportSearch.svelte';
+	import BasketPanel from './BasketPanel.svelte';
 	import BarcodeScanner from './BarcodeScanner.svelte';
 	import CoverPicker from './CoverPicker.svelte';
 	import TagInput from './TagInput.svelte';
 	import SuggestionInput from './SuggestionInput.svelte';
-	import { ScanBarcode, X } from '@lucide/svelte';
+	import { ScanBarcode, ShoppingBasket, X } from '@lucide/svelte';
 
 	let {
 		open = $bindable(false),
@@ -20,10 +21,12 @@
 		onAdded?: (book: Book) => void;
 	} = $props();
 
-	let activeTab = $state<'manual' | 'import'>('manual');
+	let activeTab = $state<'manual' | 'import' | 'basket'>('manual');
 	let submitting = $state(false);
 	let scannerOpen = $state(false);
 	let scannedIsbn = $state<string | null>(null);
+	let basket = $state<BasketItem[]>([]);
+	let basketImporting = $state(false);
 
 	// Manual form state
 	let title = $state('');
@@ -74,6 +77,72 @@
 		medium = '';
 		cover_url = null;
 		activeTab = 'manual';
+		basket = [];
+	}
+
+	function addToBasket(item: BasketItem) {
+		basket = [...basket, item];
+	}
+
+	function removeFromBasket(id: string) {
+		basket = basket.filter((item) => item.id !== id);
+	}
+
+	async function importBasket() {
+		if (basket.length === 0 || basketImporting) return;
+		basketImporting = true;
+		const items = basket;
+		const remaining: BasketItem[] = [];
+		const imported: Book[] = [];
+		let success = 0;
+		let failed = 0;
+
+		try {
+			for (const item of items) {
+				try {
+					const book = await api.import.importBook(
+						item.candidate,
+						item.readingStatus,
+						item.acquisitionStatus,
+						item.medium
+					);
+					imported.push(book);
+					success++;
+				} catch (e: unknown) {
+					remaining.push(item);
+					failed++;
+					const message =
+						e instanceof Error && e.message === 'error.isbnAlreadyExists'
+							? $_('error.isbnAlreadyExists')
+							: e instanceof Error
+								? e.message
+								: $_('import.importFailed');
+					toasts.add(message, 'error');
+				}
+			}
+
+			// Keep items added to the basket while the import was in flight.
+			basket = [...remaining, ...basket.filter((item) => !items.includes(item))];
+
+			// Notify the parent only after the whole run so a single-book
+			// import or a parent that closes the dialog on onAdded cannot
+			// interrupt the remaining items.
+			for (const book of imported) {
+				onAdded?.(book);
+			}
+
+			if (success > 0) {
+				toasts.add($_('import.basketImportSuccess', { values: { count: success } }), 'success');
+			}
+			if (failed === 0 && success > 0) {
+				open = false;
+				reset();
+			} else if (failed > 0) {
+				activeTab = 'basket';
+			}
+		} finally {
+			basketImporting = false;
+		}
 	}
 
 	async function submitManual() {
@@ -158,6 +227,19 @@
 					class="tab {activeTab === 'import' ? 'tab-active' : ''}"
 					onclick={() => (activeTab = 'import')}
 				>{$_('addModal.searchImport')}</button>
+				<button
+					role="tab"
+					class="tab {activeTab === 'basket' ? 'tab-active' : ''}"
+					onclick={() => (activeTab = 'basket')}
+				>
+					<span class="flex items-center gap-1">
+						<ShoppingBasket class="w-4 h-4" />
+						{$_('addModal.basket')}
+						{#if basket.length > 0}
+							<span class="badge badge-sm badge-primary ml-0.5">{basket.length}</span>
+						{/if}
+					</span>
+				</button>
 			</div>
 
 			{#if activeTab === 'manual'}
@@ -272,8 +354,11 @@
 					</button>
 				</div>
 				</form>
-			{:else}
+			{:else if activeTab === 'import'}
 			<ImportSearch
+				defaultStatus={defaultStatus}
+				basket={basket}
+				onAddToBasket={addToBasket}
 				onOpenScanner={() => {
 					scannerOpen = true;
 				}}
@@ -290,6 +375,13 @@
 			<div class="mt-3 text-center">
 				<a href="/data?tab=import" class="link link-primary text-sm">{$_('addModal.importFromFile')}</a>
 			</div>
+		{:else}
+			<BasketPanel
+				basket={basket}
+				importing={basketImporting}
+				onRemove={removeFromBasket}
+				onImport={importBasket}
+			/>
 		{/if}
 		</div>
 	<BarcodeScanner
diff --git a/frontend/src/lib/components/AddBookModal.test.ts b/frontend/src/lib/components/AddBookModal.test.ts
index 698eff31..e1b089f9 100644
--- a/frontend/src/lib/components/AddBookModal.test.ts
+++ b/frontend/src/lib/components/AddBookModal.test.ts
@@ -2,16 +2,23 @@ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
 import { render, screen, fireEvent, waitFor, cleanup } from '@testing-library/svelte';
 import { writable } from 'svelte/store';
 import AddBookModal from './AddBookModal.svelte';
+import type { BookImportCandidate, SearchStage } from '$lib/types';
 
 // Mock api
 const mockBooksCreate = vi.fn();
-const mockBooksList = vi.fn(async () => []);
+const mockBooksList = vi.fn(async () => ({ books: [], total: 0 }));
+const mockSearchStream = vi.fn();
+const mockImportBook = vi.fn();
 
 vi.mock('$lib/api', () => ({
 	api: {
 		books: {
 			create: (...args: unknown[]) => mockBooksCreate(...args),
 			list: () => mockBooksList()
+		},
+		import: {
+			searchStream: (...args: unknown[]) => mockSearchStream(...args),
+			importBook: (...args: unknown[]) => mockImportBook(...args)
 		}
 	}
 }));
@@ -277,4 +284,167 @@ describe('AddBookModal', () => {
 
 		expect(titleInput).toHaveValue('');
 	});
+
+	describe('basket', () => {
+		function candidate(
+			id: number,
+			title: string,
+			options: Partial<BookImportCandidate> = {}
+		): BookImportCandidate {
+			return {
+				title,
+				subtitle: null,
+				author: options.author ?? null,
+				authors: options.authors ?? [],
+				isbn: options.isbn ?? `978000000000${id}`,
+				cover_url: null,
+				publisher: null,
+				published_year: options.published_year ?? null,
+				page_count: null,
+				language: null,
+				tags: null,
+				blurb: null,
+				source: options.source ?? 'open_library'
+			};
+		}
+
+		async function searchAndAddToBasket(title: string, id: number, expectedCount: number) {
+			const book = candidate(id, title);
+			mockSearchStream.mockImplementation(async function* () {
+				yield { stage: 'complete', results: [book] } as SearchStage;
+			});
+			const importTab = screen.getByRole('tab', { name: 'Search & Import' });
+			await fireEvent.click(importTab);
+			const input = screen.getByPlaceholderText(/Search by title or author/);
+			await fireEvent.input(input, { target: { value: title } });
+			await fireEvent.click(screen.getByRole('button', { name: 'Search' }));
+			await waitFor(() => {
+				expect(screen.getByText(title)).toBeInTheDocument();
+			});
+			const acquisitionSelect = screen.getByRole('combobox', { name: /Possession/i });
+			// happy-dom does not implement :checked for <option>, so Svelte 5's
+			// bind_select_value cannot react to fireEvent.change on selects here.
+			// We still drive the acquisitionStatus wiring; the metadata override
+			// is verified via Playwright E2E, not unit tests.
+			await fireEvent.change(acquisitionSelect, { target: { value: 'owned' } });
+			await fireEvent.click(screen.getByRole('button', { name: 'Add to Basket' }));
+			await waitFor(() => {
+				expect(screen.getByRole('tab', { name: /Basket/ }).textContent).toContain(String(expectedCount));
+			});
+		}
+
+		beforeEach(() => {
+			vi.clearAllMocks();
+			mockBooksList.mockResolvedValue({ books: [], total: 0 });
+			mockImportBook.mockResolvedValue({ id: 1, title: 'Test' });
+		});
+
+		it('shows a Basket tab with the added item count', async () => {
+			render(AddBookModal, { props: { open: true, defaultStatus: 'want_to_read' } });
+			await searchAndAddToBasket('Dune', 1, 1);
+
+			const basketTab = screen.getByRole('tab', { name: /Basket/ });
+			expect(basketTab.textContent).toContain('1');
+		});
+
+		it('does not show a badge when the basket is empty', () => {
+			render(AddBookModal, { props: { open: true } });
+			const basketTab = screen.getByRole('tab', { name: /Basket/ });
+			expect(basketTab.querySelector('.badge')).toBeNull();
+		});
+
+		it('switches to the Basket tab and lists basket items', async () => {
+			render(AddBookModal, { props: { open: true } });
+			await searchAndAddToBasket('Dune', 1, 1);
+
+			const basketTab = screen.getByRole('tab', { name: /Basket/ });
+			await fireEvent.click(basketTab);
+
+			expect(screen.getByText('Dune')).toBeInTheDocument();
+			expect(screen.getByRole('button', { name: 'Import Basket' })).toBeInTheDocument();
+		});
+
+		it('removes an item from the basket', async () => {
+			render(AddBookModal, { props: { open: true } });
+			await searchAndAddToBasket('Dune', 1, 1);
+
+			const basketTab = screen.getByRole('tab', { name: /Basket/ });
+			await fireEvent.click(basketTab);
+
+			const removeBtn = screen.getByRole('button', { name: /remove/i });
+			await fireEvent.click(removeBtn);
+
+			await waitFor(() => {
+				expect(screen.getByRole('tab', { name: /Basket/ }).querySelector('.badge')).toBeNull();
+			});
+			expect(screen.queryByText('Dune')).not.toBeInTheDocument();
+			expect(screen.getByText(/basket is empty/i)).toBeInTheDocument();
+		});
+
+		it('imports each basket item via api.import.importBook', async () => {
+			const onAdded = vi.fn();
+			render(AddBookModal, { props: { open: true, onAdded } });
+
+			await searchAndAddToBasket('Dune', 1, 1);
+			await searchAndAddToBasket('Dune Messiah', 2, 2);
+
+			const basketTab = screen.getByRole('tab', { name: /Basket/ });
+			await fireEvent.click(basketTab);
+			await fireEvent.click(screen.getByRole('button', { name: 'Import Basket' }));
+
+			await waitFor(() => {
+				expect(mockImportBook).toHaveBeenCalledTimes(2);
+			});
+			const firstCall = mockImportBook.mock.calls[0];
+			expect(firstCall[0]).toMatchObject({ title: 'Dune' });
+			expect(firstCall[1]).toBe('want_to_read');
+			expect(firstCall[2]).toBe('owned');
+
+			await waitFor(() => {
+				expect(onAdded).toHaveBeenCalledTimes(2);
+			});
+		});
+
+		it('keeps failed items in the basket on partial failure', async () => {
+			mockImportBook
+				.mockResolvedValueOnce({ id: 1, title: 'Dune' })
+				.mockRejectedValueOnce(new Error('error.isbnAlreadyExists'));
+
+			const onAdded = vi.fn();
+			render(AddBookModal, { props: { open: true, onAdded } });
+
+			await searchAndAddToBasket('Dune', 1, 1);
+			await searchAndAddToBasket('Dune Messiah', 2, 2);
+
+			const basketTab = screen.getByRole('tab', { name: /Basket/ });
+			await fireEvent.click(basketTab);
+			await fireEvent.click(screen.getByRole('button', { name: 'Import Basket' }));
+
+			await waitFor(() => {
+				expect(onAdded).toHaveBeenCalledTimes(1);
+			});
+			await waitFor(() => {
+				expect(screen.getByText('Dune Messiah')).toBeInTheDocument();
+			});
+			expect(screen.queryByText('Dune')).not.toBeInTheDocument();
+		});
+
+		it('closes the dialog on full basket import success', async () => {
+			const onAdded = vi.fn();
+			render(AddBookModal, { props: { open: true, onAdded } });
+
+			await searchAndAddToBasket('Dune', 1, 1);
+
+			const basketTab = screen.getByRole('tab', { name: /Basket/ });
+			await fireEvent.click(basketTab);
+			await fireEvent.click(screen.getByRole('button', { name: 'Import Basket' }));
+
+			await waitFor(() => {
+				expect(onAdded).toHaveBeenCalledTimes(1);
+			});
+			await waitFor(() => {
+				expect(screen.queryByRole('heading', { name: 'Add Book' })).not.toBeInTheDocument();
+			});
+		});
+	});
 });
diff --git a/frontend/src/lib/components/BasketPanel.svelte b/frontend/src/lib/components/BasketPanel.svelte
new file mode 100644
index 00000000..8e8e3ea4
--- /dev/null
+++ b/frontend/src/lib/components/BasketPanel.svelte
@@ -0,0 +1,103 @@
+<script lang="ts">
+	import type { BasketItem } from '$lib/types';
+	import { _ } from '$lib/i18n';
+	import { X, ShoppingBasket } from '@lucide/svelte';
+	import { formatAuthors } from '$lib/utils/authors';
+
+	let {
+		basket,
+		importing,
+		onRemove,
+		onImport
+	}: {
+		basket: BasketItem[];
+		importing: boolean;
+		onRemove: (id: string) => void;
+		onImport: () => void;
+	} = $props();
+
+	function acquisitionLabel(status: string): string {
+		return $_(`acquisition.${status}` as never) as unknown as string;
+	}
+
+	function mediumLabel(medium: string | null): string | null {
+		if (!medium) return null;
+		return $_(`medium.${mediumToKey(medium)}` as never) as unknown as string;
+	}
+
+	function mediumToKey(medium: string): string {
+		switch (medium) {
+			case 'Print':
+				return 'print';
+			case 'eBook':
+				return 'ebook';
+			case 'Audiobook':
+				return 'audiobook';
+			case 'Comic / Graphic Novel':
+				return 'comic_graphic_novel';
+			case 'Magazine / Newspaper':
+				return 'magazine_newspaper';
+			default:
+				return 'print';
+		}
+	}
+</script>
+
+<div class="flex flex-col gap-3 sm:pr-4">
+	{#if basket.length === 0}
+		<div class="flex flex-col items-center gap-2 text-center py-8">
+			<ShoppingBasket class="w-8 h-8 text-base-content/30" />
+			<p class="text-base-content/60 text-sm">{$_('import.basketEmpty')}</p>
+		</div>
+	{:else}
+		<ul class="flex flex-col gap-2 max-h-80 overflow-y-auto">
+			{#each basket as item}
+				<li class="flex gap-3 items-start p-2 rounded-lg border border-base-200">
+					{#if item.candidate.cover_url}
+						<img
+							src={item.candidate.cover_url}
+							alt={$_('book.cover')}
+							class="w-10 rounded flex-shrink-0 object-cover"
+						/>
+					{:else}
+						<div class="w-10 h-14 bg-base-200 rounded flex-shrink-0"></div>
+					{/if}
+					<div class="flex-1 min-w-0">
+						<p class="font-medium text-sm line-clamp-2">{item.candidate.title}</p>
+						{#if item.candidate.authors?.length}
+							<p class="text-xs text-base-content/60">{formatAuthors(item.candidate.authors, item.candidate.author)}</p>
+						{/if}
+						<div class="flex flex-wrap items-center gap-1.5 text-xs text-base-content/40">
+							<span>{item.candidate.source}</span>
+							{#if item.candidate.published_year}
+								<span>·</span>
+								<span>{item.candidate.published_year}</span>
+							{/if}
+							<span class="badge badge-ghost badge-xs">{acquisitionLabel(item.acquisitionStatus)}</span>
+							{#if item.medium}
+								<span class="badge badge-ghost badge-xs">{mediumLabel(item.medium)}</span>
+							{/if}
+						</div>
+					</div>
+					<button
+						class="btn btn-ghost btn-xs btn-circle shrink-0"
+						aria-label={$_('import.basketRemove')}
+						title={$_('import.basketRemove')}
+						disabled={importing}
+						onclick={() => onRemove(item.id)}
+					>
+						<X class="w-4 h-4" />
+					</button>
+				</li>
+			{/each}
+		</ul>
+		<div class="flex items-center justify-between gap-2 pt-2">
+			<span class="text-sm text-base-content/70">
+				{$_('import.basketCount', { values: { count: basket.length } })}
+			</span>
+			<button class="btn btn-primary btn-sm" onclick={onImport} disabled={importing || basket.length === 0}>
+				{importing ? $_('import.importingBasket') : $_('import.importBasket')}
+			</button>
+		</div>
+	{/if}
+</div>
\ No newline at end of file
diff --git a/frontend/src/lib/components/ImportSearch.svelte b/frontend/src/lib/components/ImportSearch.svelte
index 9f3d37d1..fffbf97c 100644
--- a/frontend/src/lib/components/ImportSearch.svelte
+++ b/frontend/src/lib/components/ImportSearch.svelte
@@ -1,5 +1,5 @@
 <script lang="ts">
-	import type { AcquisitionStatus, Book, BookImportCandidate, BookImportCandidateGroup, Medium, ReadingStatus, SearchStage } from '$lib/types';
+	import type { AcquisitionStatus, BasketItem, Book, BookImportCandidate, BookImportCandidateGroup, Medium, ReadingStatus, SearchStage } from '$lib/types';
 	import { onDestroy, onMount } from 'svelte';
 	import { api } from '$lib/api';
 	import { _ } from '$lib/i18n';
@@ -8,17 +8,24 @@
 	import { formatAuthors } from '$lib/utils/authors';
 	import { isSecureContext, SECURE_CONTEXT_DOCS_URL } from '$lib/utils/secureContext';
 	import {
+		basketCandidateKey,
 		canonicalIsbn,
 		groupCandidates,
 		titleAuthorKey
 	} from '$lib/utils/importSearch';
 
 	let {
+		defaultStatus = 'want_to_read',
+		basket = [],
+		onAddToBasket,
 		onImport,
 		onOpenScanner,
 		scannedIsbn = null,
 		onScannedHandled
 	}: {
+		defaultStatus?: ReadingStatus;
+		basket?: BasketItem[];
+		onAddToBasket?: (item: BasketItem) => void;
 		onImport?: (book: Book) => void;
 		onOpenScanner?: () => void;
 		scannedIsbn?: string | null;
@@ -288,6 +295,23 @@
 			importing = null;
 		}
 	}
+
+	function isInBasket(candidate: BookImportCandidate): boolean {
+		const key = basketCandidateKey(candidate);
+		return basket.some((item) => basketCandidateKey(item.candidate) === key);
+	}
+
+	function addSelectedToBasket(group: BookImportCandidateGroup) {
+		if (!acquisitionStatus || isInBasket(selectedCandidate(group))) return;
+		const item: BasketItem = {
+			id: `${basketCandidateKey(selectedCandidate(group))}:${Date.now()}`,
+			candidate: selectedCandidate(group),
+			readingStatus: defaultStatus,
+			acquisitionStatus,
+			medium: medium || null
+		};
+		onAddToBasket?.(item);
+	}
 </script>
 
 <div class="flex flex-col gap-3 sm:pr-4">
@@ -399,6 +423,7 @@
 			{@const selected = selectedCandidate(group)}
 			{@const groupImported = isGroupAlreadyImported(group)}
 			{@const importingKey = `${group.key}:${group.variants.indexOf(selected)}`}
+			{@const inBasket = isInBasket(selected)}
 			<li class="flex flex-col gap-2 p-2 rounded-lg border {groupImported ? 'border-success/40 bg-success/5' : 'border-base-200'}">
 				<div class="flex gap-3 items-start">
 					{#if group.coverUrl}
@@ -444,7 +469,7 @@
 							class="btn btn-xs {groupImported ? 'btn-success btn-outline' : 'btn-primary'}"
 							disabled={groupImported || importing === importingKey || !acquisitionStatus}
 							title={groupImported ? $_('import.alreadyImported') : ''}
-							onclick={() => importBook(group, 'want_to_read')}
+							onclick={() => importBook(group, defaultStatus)}
 						>
 							{importing === importingKey
 								? $_('common.loadingEllipsis')
@@ -452,6 +477,14 @@
 									? $_('import.imported')
 									: $_('app.add')}
 						</button>
+						<button
+							class="btn btn-xs btn-outline"
+							disabled={groupImported || inBasket || !acquisitionStatus}
+							title={groupImported ? $_('import.alreadyImported') : inBasket ? $_('import.inBasket') : ''}
+							onclick={() => addSelectedToBasket(group)}
+						>
+							{inBasket ? $_('import.inBasket') : $_('import.addToBasket')}
+						</button>
 						{#if group.variants.length > 1}
 							<button
 								class="btn btn-xs btn-ghost"
diff --git a/frontend/src/lib/components/ImportSearch.test.ts b/frontend/src/lib/components/ImportSearch.test.ts
index 2560e797..b7dcba61 100644
--- a/frontend/src/lib/components/ImportSearch.test.ts
+++ b/frontend/src/lib/components/ImportSearch.test.ts
@@ -2,7 +2,7 @@ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
 import { render, screen, fireEvent, waitFor, cleanup } from '@testing-library/svelte';
 import ImportSearch from './ImportSearch.svelte';
 import { api } from '$lib/api';
-import type { BookImportCandidate, SearchStage } from '$lib/types';
+import type { BasketItem, BookImportCandidate, SearchStage } from '$lib/types';
 
 const mockSearchStream = vi.fn();
 const mockImportBook = vi.fn();
@@ -589,4 +589,172 @@ describe('ImportSearch', () => {
 			expect(screen.queryByText('Dune')).not.toBeInTheDocument();
 		});
 	});
+
+	describe('basket', () => {
+		const onAddToBasket = vi.fn();
+
+		beforeEach(() => {
+			onAddToBasket.mockClear();
+		});
+
+		function renderWithBasket(basket: BasketItem[] = []) {
+			return render(ImportSearch, { props: { basket, onAddToBasket } });
+		}
+
+		it('shows an Add to Basket button per result group', async () => {
+			const dune = candidate(1, 'Dune', {
+				isbn: '9780441013593',
+				authors: ['Frank Herbert'],
+				source: 'open_library'
+			});
+			mockSearchStream.mockImplementation(makeStreamFinishing([dune]));
+
+			renderWithBasket();
+			await typeQueryAndSearch();
+
+			await waitFor(() => {
+				expect(screen.getByText('Dune')).toBeInTheDocument();
+			});
+			expect(screen.getAllByRole('button', { name: 'Add to Basket' })).toHaveLength(1);
+		});
+
+		it('adds the selected variant to the basket', async () => {
+			const ol = candidate(1, 'Dune', {
+				isbn: '9780441013593',
+				authors: ['Frank Herbert'],
+				source: 'open_library'
+			});
+			const hc = candidate(2, 'Dune', {
+				isbn: '9780441013593',
+				authors: ['Frank Herbert'],
+				source: 'hardcover',
+				page_count: 464,
+				published_year: 1965
+			});
+			mockSearchStream.mockImplementation(makeStreamFinishing([ol, hc]));
+
+			renderWithBasket();
+			await typeQueryAndSearch();
+
+			await waitFor(() => {
+				expect(screen.getByText('Dune')).toBeInTheDocument();
+			});
+
+			// Select the hardcover variant.
+			await fireEvent.click(screen.getByRole('button', { name: 'Show editions' }));
+			await waitFor(() => {
+				expect(screen.getByRole('button', { name: /^hardcover/ })).toBeInTheDocument();
+			});
+			await fireEvent.click(screen.getByRole('button', { name: /^hardcover/ }));
+
+			// Set acquisition status to enable the Add to Basket button.
+			// happy-dom's :checked fallback always resolves to the first
+			// non-disabled option (here 'owned'), so we trigger that path.
+			// Select metadata override is verified via E2E tests.
+			const acquisitionSelect = screen.getByRole('combobox', { name: /Possession/i });
+			await fireEvent.change(acquisitionSelect, { target: { value: 'owned' } });
+
+			await fireEvent.click(screen.getByRole('button', { name: 'Add to Basket' }));
+
+			await waitFor(() => {
+				expect(onAddToBasket).toHaveBeenCalledTimes(1);
+			});
+			const item = onAddToBasket.mock.calls[0][0] as BasketItem;
+			expect(item.candidate.source).toBe('hardcover');
+			expect(item.readingStatus).toBe('want_to_read');
+			expect(item.acquisitionStatus).toBe('owned');
+		});
+
+		it('disables Add to Basket when no acquisition status is selected', async () => {
+			const dune = candidate(1, 'Dune', {
+				isbn: '9780441013593',
+				authors: ['Frank Herbert'],
+				source: 'open_library'
+			});
+			mockSearchStream.mockImplementation(makeStreamFinishing([dune]));
+
+			renderWithBasket();
+			await typeQueryAndSearch();
+
+			await waitFor(() => {
+				expect(screen.getByText('Dune')).toBeInTheDocument();
+			});
+			expect(screen.getByRole('button', { name: 'Add to Basket' })).toBeDisabled();
+		});
+
+		it('uses defaultStatus prop for reading status', async () => {
+			const dune = candidate(1, 'Dune', {
+				isbn: '9780441013593',
+				authors: ['Frank Herbert'],
+				source: 'open_library'
+			});
+			mockSearchStream.mockImplementation(makeStreamFinishing([dune]));
+
+			render(ImportSearch, { props: { defaultStatus: 'currently_reading', basket: [], onAddToBasket } });
+			await typeQueryAndSearch();
+
+			await waitFor(() => {
+				expect(screen.getByText('Dune')).toBeInTheDocument();
+			});
+			const acquisitionSelect = screen.getByRole('combobox', { name: /Possession/i });
+			await fireEvent.change(acquisitionSelect, { target: { value: 'owned' } });
+			await fireEvent.click(screen.getByRole('button', { name: 'Add to Basket' }));
+
+			await waitFor(() => {
+				expect(onAddToBasket).toHaveBeenCalledTimes(1);
+			});
+			const item = onAddToBasket.mock.calls[0][0] as BasketItem;
+			expect(item.readingStatus).toBe('currently_reading');
+		});
+
+		it('shows In basket and disables the button when already in basket', async () => {
+			const dune = candidate(1, 'Dune', {
+				isbn: '9780441013593',
+				authors: ['Frank Herbert'],
+				source: 'open_library'
+			});
+			mockSearchStream.mockImplementation(makeStreamFinishing([dune]));
+
+			const existingItem: BasketItem = {
+				id: 'x',
+				candidate: dune,
+				readingStatus: 'want_to_read',
+				acquisitionStatus: 'owned',
+				medium: null
+			};
+			renderWithBasket([existingItem]);
+			await typeQueryAndSearch();
+
+			await waitFor(() => {
+				expect(screen.getByText('Dune')).toBeInTheDocument();
+			});
+			const btn = screen.getByRole('button', { name: 'In basket' });
+			expect(btn).toBeDisabled();
+		});
+
+		it('still allows direct Add to import and close the dialog', async () => {
+			const dune = candidate(1, 'Dune', {
+				isbn: '9780441013593',
+				authors: ['Frank Herbert'],
+				source: 'open_library'
+			});
+			mockImportBook.mockResolvedValue({ id: 1, title: 'Dune' });
+			mockSearchStream.mockImplementation(makeStreamFinishing([dune]));
+			const onImport = vi.fn();
+
+			render(ImportSearch, { props: { basket: [], onImport } });
+			await typeQueryAndSearch();
+
+			await waitFor(() => {
+				expect(screen.getByText('Dune')).toBeInTheDocument();
+			});
+			const acquisitionSelect = screen.getByRole('combobox', { name: /Possession/i });
+			await fireEvent.change(acquisitionSelect, { target: { value: 'owned' } });
+			await fireEvent.click(screen.getByRole('button', { name: 'Add' }));
+
+			await waitFor(() => {
+				expect(onImport).toHaveBeenCalledTimes(1);
+			});
+		});
+	});
 });
diff --git a/frontend/src/lib/i18n/locales/de.json b/frontend/src/lib/i18n/locales/de.json
index b9d018f2..6835fc1c 100644
--- a/frontend/src/lib/i18n/locales/de.json
+++ b/frontend/src/lib/i18n/locales/de.json
@@ -221,7 +221,8 @@
     "searchImport": "Suchen & Importieren",
     "adding": "Füge hinzu...",
     "failedAdd": "Buch konnte nicht hinzugefügt werden",
-    "importFromFile": "Aus Datei importieren"
+    "importFromFile": "Aus Datei importieren",
+    "basket": "Warenkorb"
   },
   "import": {
     "searchByTitleOrAuthor": "Nach Titel oder Autor suchen...",
@@ -252,7 +253,15 @@
     "groupResultPlural": "Ergebnisse",
     "groupExpand": "Ausgaben anzeigen",
     "groupCollapse": "Ausgaben ausblenden",
-    "groupChooseEdition": "Ausgabe wählen"
+    "groupChooseEdition": "Ausgabe wählen",
+    "addToBasket": "Zum Warenkorb hinzufügen",
+    "inBasket": "Im Warenkorb",
+    "basketEmpty": "Dein Warenkorb ist leer. Suche nach Büchern, um sie hinzuzufügen.",
+    "basketCount": "{count} {count, plural, one {Buch} other {Bücher}}",
+    "importBasket": "Warenkorb importieren",
+    "importingBasket": "Importiere...",
+    "basketRemove": "Aus dem Warenkorb entfernen",
+    "basketImportSuccess": "{count} Bücher erfolgreich importiert."
   },
   "scanner": {
     "title": "ISBN-Barcode scannen",
diff --git a/frontend/src/lib/i18n/locales/en.json b/frontend/src/lib/i18n/locales/en.json
index 860f29ca..5e87a6b2 100644
--- a/frontend/src/lib/i18n/locales/en.json
+++ b/frontend/src/lib/i18n/locales/en.json
@@ -221,7 +221,8 @@
     "searchImport": "Search & Import",
     "adding": "Adding...",
     "failedAdd": "Failed to add book",
-    "importFromFile": "Import from file"
+    "importFromFile": "Import from file",
+    "basket": "Basket"
   },
   "import": {
     "searchByTitleOrAuthor": "Search by title or author...",
@@ -252,7 +253,15 @@
     "groupResultPlural": "results",
     "groupExpand": "Show editions",
     "groupCollapse": "Hide editions",
-    "groupChooseEdition": "Choose edition"
+    "groupChooseEdition": "Choose edition",
+    "addToBasket": "Add to Basket",
+    "inBasket": "In basket",
+    "basketEmpty": "Your basket is empty. Search for books to add.",
+    "basketCount": "{count} {count, plural, one {book} other {books}}",
+    "importBasket": "Import Basket",
+    "importingBasket": "Importing...",
+    "basketRemove": "Remove from basket",
+    "basketImportSuccess": "Imported {count} books successfully."
   },
   "scanner": {
     "title": "Scan ISBN Barcode",
diff --git a/frontend/src/lib/i18n/locales/es.json b/frontend/src/lib/i18n/locales/es.json
index 18f1057f..55cba34c 100644
--- a/frontend/src/lib/i18n/locales/es.json
+++ b/frontend/src/lib/i18n/locales/es.json
@@ -221,7 +221,8 @@
     "searchImport": "Buscar e importar",
     "adding": "Añadiendo...",
     "failedAdd": "Error al añadir libro",
-    "importFromFile": "Importar desde archivo"
+    "importFromFile": "Importar desde archivo",
+    "basket": "Cesta"
   },
   "import": {
     "searchByTitleOrAuthor": "Buscar por título o autor...",
@@ -252,7 +253,15 @@
     "groupResultPlural": "resultados",
     "groupExpand": "Mostrar ediciones",
     "groupCollapse": "Ocultar ediciones",
-    "groupChooseEdition": "Elegir edición"
+    "groupChooseEdition": "Elegir edición",
+    "addToBasket": "Añadir a la cesta",
+    "inBasket": "En la cesta",
+    "basketEmpty": "Tu cesta está vacía. Busca libros para añadirlos.",
+    "basketCount": "{count} {count, plural, one {libro} other {libros}}",
+    "importBasket": "Importar cesta",
+    "importingBasket": "Importando...",
+    "basketRemove": "Quitar de la cesta",
+    "basketImportSuccess": "{count} libros importados correctamente."
   },
   "scanner": {
     "title": "Escanear código de barras ISBN",
diff --git a/frontend/src/lib/i18n/locales/fr.json b/frontend/src/lib/i18n/locales/fr.json
index 0c5b76f4..9f17f4f1 100644
--- a/frontend/src/lib/i18n/locales/fr.json
+++ b/frontend/src/lib/i18n/locales/fr.json
@@ -221,7 +221,8 @@
     "searchImport": "Rechercher et importer",
     "adding": "Ajout...",
     "failedAdd": "Échec de l'ajout du livre",
-    "importFromFile": "Importer depuis un fichier"
+    "importFromFile": "Importer depuis un fichier",
+    "basket": "Panier"
   },
   "import": {
     "searchByTitleOrAuthor": "Rechercher par titre ou auteur...",
@@ -252,7 +253,15 @@
     "groupResultPlural": "résultats",
     "groupExpand": "Afficher les éditions",
     "groupCollapse": "Masquer les éditions",
-    "groupChooseEdition": "Choisir l'édition"
+    "groupChooseEdition": "Choisir l'édition",
+    "addToBasket": "Ajouter au panier",
+    "inBasket": "Dans le panier",
+    "basketEmpty": "Votre panier est vide. Recherchez des livres à ajouter.",
+    "basketCount": "{count} {count, plural, one {livre} other {livres}}",
+    "importBasket": "Importer le panier",
+    "importingBasket": "Importation...",
+    "basketRemove": "Retirer du panier",
+    "basketImportSuccess": "{count} livres importés avec succès."
   },
   "scanner": {
     "title": "Scanner un code-barres ISBN",
diff --git a/frontend/src/lib/i18n/locales/zh.json b/frontend/src/lib/i18n/locales/zh.json
index 136244b8..d01629a7 100644
--- a/frontend/src/lib/i18n/locales/zh.json
+++ b/frontend/src/lib/i18n/locales/zh.json
@@ -221,7 +221,8 @@
     "searchImport": "搜索并导入",
     "adding": "添加中...",
     "failedAdd": "添加图书失败",
-    "importFromFile": "从文件导入"
+    "importFromFile": "从文件导入",
+    "basket": "购物篮"
   },
   "import": {
     "searchByTitleOrAuthor": "按标题或作者搜索...",
@@ -252,7 +253,15 @@
     "groupResultPlural": "个结果",
     "groupExpand": "显示版本",
     "groupCollapse": "隐藏版本",
-    "groupChooseEdition": "选择版本"
+    "groupChooseEdition": "选择版本",
+    "addToBasket": "添加到购物篮",
+    "inBasket": "已在购物篮",
+    "basketEmpty": "购物篮为空。搜索图书以添加。",
+    "basketCount": "{count} 本图书",
+    "importBasket": "导入购物篮",
+    "importingBasket": "导入中...",
+    "basketRemove": "从购物篮中移除",
+    "basketImportSuccess": "成功导入 {count} 本图书。"
   },
   "scanner": {
     "title": "扫描 ISBN 条码",
diff --git a/frontend/src/lib/types.ts b/frontend/src/lib/types.ts
index 740832d6..2a03e1a0 100644
--- a/frontend/src/lib/types.ts
+++ b/frontend/src/lib/types.ts
@@ -55,6 +55,14 @@ export interface BookImportCandidateGroup {
 	variants: BookImportCandidate[];
 }
 
+export interface BasketItem {
+	id: string;
+	candidate: BookImportCandidate;
+	readingStatus: ReadingStatus;
+	acquisitionStatus: AcquisitionStatus;
+	medium: Medium | null;
+}
+
 export interface CoverCandidate {
 	source: 'abebooks' | 'openlibrary' | 'amazon' | 'hardcover' | 'thalia';
 	url: string;
diff --git a/frontend/src/lib/utils/importSearch.test.ts b/frontend/src/lib/utils/importSearch.test.ts
index fa0c6dbe..9b261f9a 100644
--- a/frontend/src/lib/utils/importSearch.test.ts
+++ b/frontend/src/lib/utils/importSearch.test.ts
@@ -1,6 +1,7 @@
 import { describe, it, expect } from 'vitest';
 import {
 	authorKey,
+	basketCandidateKey,
 	candidateKey,
 	groupCandidates,
 	normalize,
@@ -94,6 +95,31 @@ describe('candidateKey', () => {
 	});
 });
 
+describe('basketCandidateKey', () => {
+	it('does not distinguish variants by source', () => {
+		const ol = makeCandidate('Dune', { isbn: '9780441013593', source: 'open_library' });
+		const hc = makeCandidate('Dune', { isbn: '9780441013593', source: 'hardcover' });
+		const gb = makeCandidate('Dune', { isbn: '9780441013593', source: 'google_books' });
+
+		expect(basketCandidateKey(ol)).toBe(basketCandidateKey(hc));
+		expect(basketCandidateKey(ol)).toBe(basketCandidateKey(gb));
+	});
+
+	it('treats identical candidates as equal', () => {
+		const a = makeCandidate('Dune', { isbn: '9780441013593', source: 'open_library' });
+		const b = makeCandidate('Dune', { isbn: '9780441013593', source: 'open_library' });
+
+		expect(basketCandidateKey(a)).toBe(basketCandidateKey(b));
+	});
+
+	it('canonicalizes ISBN-10 and ISBN-13 variants from the same source as equal', () => {
+		const a = makeCandidate('Dune', { isbn: '0441013597', source: 'open_library' });
+		const b = makeCandidate('Dune', { isbn: '9780441013593', source: 'open_library' });
+
+		expect(basketCandidateKey(a)).toBe(basketCandidateKey(b));
+	});
+});
+
 describe('groupCandidates', () => {
 	it('groups same-ISBN candidates into one group', () => {
 		const ol = makeCandidate('Dune', { isbn: '9780441013593', source: 'open_library' });
diff --git a/frontend/src/lib/utils/importSearch.ts b/frontend/src/lib/utils/importSearch.ts
index 9a6de62a..a7346631 100644
--- a/frontend/src/lib/utils/importSearch.ts
+++ b/frontend/src/lib/utils/importSearch.ts
@@ -49,6 +49,13 @@ export function candidateKey(candidate: BookImportCandidate): string {
 	return `ta:${normalize(candidate.title)}|${authorKey(candidate.authors)}`;
 }
 
+// Same-ISBN (or title+author) editions share one basket key regardless of
+// source so the same book from two providers cannot be added twice, which
+// would always fail on import with isbnAlreadyExists.
+export function basketCandidateKey(candidate: BookImportCandidate): string {
+	return candidateKey(candidate);
+}
+
 export function groupCandidates(candidates: BookImportCandidate[]): BookImportCandidateGroup[] {
 	const map = new Map<string, BookImportCandidate[]>();
 	for (const candidate of candidates) {

From 7455a7bef366c01fce06a4cac211fef27fcfb24f Mon Sep 17 00:00:00 2001
From: codebude <netblognet@googlemail.com>
Date: Fri, 11 Sep 2026 14:12:27 +0200
Subject: [PATCH 2/3] Highlight the selected edition in import search

---
 frontend/src/lib/components/ImportSearch.svelte  | 8 ++++++--
 frontend/src/lib/components/ImportSearch.test.ts | 6 +++++-
 frontend/src/lib/i18n/locales/de.json            | 1 +
 frontend/src/lib/i18n/locales/en.json            | 1 +
 frontend/src/lib/i18n/locales/es.json            | 1 +
 frontend/src/lib/i18n/locales/fr.json            | 1 +
 frontend/src/lib/i18n/locales/zh.json            | 1 +
 7 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/frontend/src/lib/components/ImportSearch.svelte b/frontend/src/lib/components/ImportSearch.svelte
index fffbf97c..c446161b 100644
--- a/frontend/src/lib/components/ImportSearch.svelte
+++ b/frontend/src/lib/components/ImportSearch.svelte
@@ -504,8 +504,9 @@
 							{@const variantImported = isAlreadyImported(variant)}
 							{@const isSelected = selectedIndex(group) === idx}
 							<button
-								class="flex gap-2 items-start p-1 rounded text-left {isSelected ? 'bg-base-200' : 'hover:bg-base-100'}"
+								class="group flex gap-2 items-start p-2 rounded-lg border-2 text-left cursor-pointer transition-all focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary focus-visible:ring-offset-1 {isSelected ? 'border-primary bg-primary/10 shadow-sm' : 'border-base-200 bg-base-100 hover:border-primary/60 hover:bg-primary/5 hover:shadow-sm'}"
 								aria-pressed={isSelected}
+								aria-label={`${variant.source}${isSelected ? `, ${$_('import.editionSelected')}` : ''}`}
 								onclick={() => selectedVariantByGroup[group.key] = idx}
 							>
 								{#if variant.cover_url}
@@ -525,9 +526,12 @@
 											variant.language,
 											variant.page_count ? `${variant.page_count} ${$_('book.pages').toLowerCase()}` : null,
 											variant.isbn
-										].filter(Boolean).join(' · ')}
+									].filter(Boolean).join(' · ')}
 									</p>
 								</div>
+								{#if isSelected}
+									<span class="badge badge-primary badge-sm shrink-0">✓ {$_('import.editionSelected')}</span>
+								{/if}
 								{#if variantImported}
 									<span class="badge badge-success badge-outline badge-xs">{$_('import.alreadyImported')}</span>
 								{/if}
diff --git a/frontend/src/lib/components/ImportSearch.test.ts b/frontend/src/lib/components/ImportSearch.test.ts
index b7dcba61..6a4f7c9e 100644
--- a/frontend/src/lib/components/ImportSearch.test.ts
+++ b/frontend/src/lib/components/ImportSearch.test.ts
@@ -532,7 +532,11 @@ describe('ImportSearch', () => {
 			await waitFor(() => {
 				expect(screen.getByRole('button', { name: /^hardcover/ })).toBeInTheDocument();
 			});
-			await fireEvent.click(screen.getByRole('button', { name: /^hardcover/ }));
+			const hardcoverButton = screen.getByRole('button', { name: /^hardcover/ });
+			await fireEvent.click(hardcoverButton);
+			expect(hardcoverButton).toHaveAttribute('aria-pressed', 'true');
+			expect(hardcoverButton).toHaveClass('border-primary', 'bg-primary/10', 'cursor-pointer');
+			expect(hardcoverButton).toHaveTextContent('Selected');
 
 			// Google supplement appends a third variant.
 			await fireEvent.click(screen.getByRole('button', { name: 'Search Google Books too' }));
diff --git a/frontend/src/lib/i18n/locales/de.json b/frontend/src/lib/i18n/locales/de.json
index 6835fc1c..91b12dd2 100644
--- a/frontend/src/lib/i18n/locales/de.json
+++ b/frontend/src/lib/i18n/locales/de.json
@@ -254,6 +254,7 @@
     "groupExpand": "Ausgaben anzeigen",
     "groupCollapse": "Ausgaben ausblenden",
     "groupChooseEdition": "Ausgabe wählen",
+    "editionSelected": "Ausgewählt",
     "addToBasket": "Zum Warenkorb hinzufügen",
     "inBasket": "Im Warenkorb",
     "basketEmpty": "Dein Warenkorb ist leer. Suche nach Büchern, um sie hinzuzufügen.",
diff --git a/frontend/src/lib/i18n/locales/en.json b/frontend/src/lib/i18n/locales/en.json
index 5e87a6b2..bdd88a9b 100644
--- a/frontend/src/lib/i18n/locales/en.json
+++ b/frontend/src/lib/i18n/locales/en.json
@@ -254,6 +254,7 @@
     "groupExpand": "Show editions",
     "groupCollapse": "Hide editions",
     "groupChooseEdition": "Choose edition",
+    "editionSelected": "Selected",
     "addToBasket": "Add to Basket",
     "inBasket": "In basket",
     "basketEmpty": "Your basket is empty. Search for books to add.",
diff --git a/frontend/src/lib/i18n/locales/es.json b/frontend/src/lib/i18n/locales/es.json
index 55cba34c..8d74fe30 100644
--- a/frontend/src/lib/i18n/locales/es.json
+++ b/frontend/src/lib/i18n/locales/es.json
@@ -254,6 +254,7 @@
     "groupExpand": "Mostrar ediciones",
     "groupCollapse": "Ocultar ediciones",
     "groupChooseEdition": "Elegir edición",
+    "editionSelected": "Seleccionada",
     "addToBasket": "Añadir a la cesta",
     "inBasket": "En la cesta",
     "basketEmpty": "Tu cesta está vacía. Busca libros para añadirlos.",
diff --git a/frontend/src/lib/i18n/locales/fr.json b/frontend/src/lib/i18n/locales/fr.json
index 9f17f4f1..cdb6a4ef 100644
--- a/frontend/src/lib/i18n/locales/fr.json
+++ b/frontend/src/lib/i18n/locales/fr.json
@@ -254,6 +254,7 @@
     "groupExpand": "Afficher les éditions",
     "groupCollapse": "Masquer les éditions",
     "groupChooseEdition": "Choisir l'édition",
+    "editionSelected": "Sélectionnée",
     "addToBasket": "Ajouter au panier",
     "inBasket": "Dans le panier",
     "basketEmpty": "Votre panier est vide. Recherchez des livres à ajouter.",
diff --git a/frontend/src/lib/i18n/locales/zh.json b/frontend/src/lib/i18n/locales/zh.json
index d01629a7..81980c4f 100644
--- a/frontend/src/lib/i18n/locales/zh.json
+++ b/frontend/src/lib/i18n/locales/zh.json
@@ -254,6 +254,7 @@
     "groupExpand": "显示版本",
     "groupCollapse": "隐藏版本",
     "groupChooseEdition": "选择版本",
+    "editionSelected": "已选择",
     "addToBasket": "添加到购物篮",
     "inBasket": "已在购物篮",
     "basketEmpty": "购物篮为空。搜索图书以添加。",

From c26e235786e1c4fa65b2b163090418936615dd3c Mon Sep 17 00:00:00 2001
From: codebude <netblognet@googlemail.com>
Date: Fri, 11 Sep 2026 14:41:32 +0200
Subject: [PATCH 3/3] Document import basket and selected edition highlight in
 release notes

---
 docs/releases.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/releases.md b/docs/releases.md
index 1aa433e9..2079cac6 100644
--- a/docs/releases.md
+++ b/docs/releases.md
@@ -39,10 +39,10 @@ LibrisLog v1.8.0 brings camera selection and zoom control to the barcode scanner
 
 <Badge type="warning" text="Unreleased" /> <Badge type="tip" text="Feature release" />
 
-**Summary:** Adds shareable read-only public profile pages with configurable access and content, groups duplicate import-search results into expandable edition groups, makes running searches cancelable, introduces an adaptive date input with a native picker, adds optional book media and medium statistics, supports localized medium and possession searches, detects insecure camera contexts, and fixes timezone handling in the daily page statistics and progress log editing.
+**Summary:** Adds shareable read-only public profile pages with configurable access and content, groups duplicate import-search results into expandable edition groups, lets you collect search results in an import basket and import them all at once, makes running searches cancelable, introduces an adaptive date input with a native picker, adds optional book media and medium statistics, supports localized medium and possession searches, detects insecure camera contexts, and fixes timezone handling in the daily page statistics and progress log editing.
 
 **Features**
-- 📚 **Edition groups in the import search**: results from different providers that describe the same book (same ISBN, or same title and authors) are now grouped into expandable entries with an "N results" badge. Compare the variants side by side and import the one you want; no result is dropped anymore. See the [Library guide](/guide/using-librislog/library#how-results-are-grouped) for the exact grouping rules
+- 📚 **Edition groups in the import search**: results from different providers that describe the same book (same ISBN, or same title and authors) are now grouped into expandable entries with an "N results" badge. Compare the variants side by side and import the one you want; no result is dropped anymore. The selected edition is highlighted with a border and a "Selected" badge, and every edition row shows a pointer cursor, hover feedback, and a keyboard focus ring. See the [Library guide](/guide/using-librislog/library#how-results-are-grouped) for the exact grouping rules
 - 🗂️ **Optional book medium**: classify books as Print, eBook, Audiobook, Comic / Graphic Novel, or Magazine / Newspaper from manual entry, search import, and book editing. Mediums can be filtered in the library, searched with `medium:`, imported/exported, and reviewed in the statistics distribution
 - 🌍 **Localized search values**: `medium:` and `possession:` searches accept both their original enum keys and localized display values, such as `medium:Hörbuch` and `possession:Im Besitz`
 - 🛑 **Cancelable book search**: while an import search is running, the Search button becomes a Cancel button, so you can stop the request and refine your query
@@ -53,6 +53,7 @@ LibrisLog v1.8.0 brings camera selection and zoom control to the barcode scanner
 - 🎥 **Active camera name in the scanner**: the barcode scanner now shows the name of the active camera in a badge next to the switch button, so you always know which lens is being used
 - 🔗 **Heimdall dashboard integration**: new documentation for the LibrisLog enhanced app, which shows your reading statistics directly on [Heimdall](https://github.com/linuxserver/Heimdall) tiles
 - 🔗 **Shareable public profile pages**: create named, read-only profile URLs from the Profile page. Configure each link independently for public or logged-in-only access, selected profile sections and statistics, language, and an optional expiration date. Shared pages include responsive book cards, a mobile-safe reading timeline with incremental loading and hidden-book hints, full-library search with incremental loading, selectable 12-month/3-year/all-time trend ranges with value tooltips, distribution and rating panels, and the owner's generated avatar. Existing links can be copied, opened, edited, or revoked. The full URL token is only revealed on demand and is shown once after creation. See the [Profile guide](/guide/using-librislog/profile#urlprofile-sharing) for setup and security details
+- 🧺 **Import basket**: search results now offer an **Add to Basket** action next to the existing **Add** button. Collected books appear in a new **Basket** tab with a live count badge, where you can review them, remove individual entries, and import everything in one go. Each entry remembers the reading status, possession status, and medium that were selected when it was added. If some books fail during a basket import, the successful ones are imported and the failed ones stay in the basket so you can retry or remove them. The same book cannot be added twice
 
 **Bug fixes**
 - 🗓️ **Timezone-correct daily page statistics**: pages read between two progress updates are now attributed to calendar days in the user's timezone instead of fixed 24h slots, so the pages-per-day view matches your local days. Your heatmap may shift slightly after the upgrade