feat(reader): add document mode to the PDF viewer, overhaul PDF viewer, add different modes to CBX viewer

booklore-api/src/main/java/org/booklore/config/security/filter/SharedArrayBufferHeaderFilter.java

@@ -0,0 +1,29 @@
+package org.booklore.config.security.filter;
+
+import jakarta.servlet.FilterChain;
+import jakarta.servlet.ServletException;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.servlet.http.HttpServletResponse;
+import org.springframework.core.annotation.Order;
+import org.springframework.stereotype.Component;
+import org.springframework.web.filter.OncePerRequestFilter;
+
+import java.io.IOException;
+
+/**
+ * Enables SharedArrayBuffer by setting Cross-Origin isolation headers.
+ * Required by pdfium WASM (Emscripten-compiled with thread support) used by EmbedPDF.
+ * Without these headers the WASM module stalls on instantiation.
+ */
+@Component
+@Order(1)
+public class SharedArrayBufferHeaderFilter extends OncePerRequestFilter {
+
+    @Override
+    protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)
+            throws ServletException, IOException {
+        response.setHeader("Cross-Origin-Opener-Policy", "same-origin");
+        response.setHeader("Cross-Origin-Embedder-Policy", "credentialless");
+        filterChain.doFilter(request, response);
+    }
+}

booklore-api/src/main/java/org/booklore/controller/BookController.java

@@ -153,6 +153,21 @@ public void getBookContent(
         bookService.streamBookContent(bookId, bookType, request, response);
     }
 
+    @Operation(summary = "Replace book content", description = "Overwrite the primary PDF file for a book with the uploaded content. Used by the document viewer to persist annotation changes.")
+    @ApiResponses({
+            @ApiResponse(responseCode = "204", description = "Book content replaced successfully"),
+            @ApiResponse(responseCode = "404", description = "Book not found")
+    })
+    @PutMapping("/{bookId}/content")
+    @CheckBookAccess(bookIdParam = "bookId")
+    public ResponseEntity<Void> replaceBookContent(
+            @Parameter(description = "ID of the book") @PathVariable long bookId,
+            @Parameter(description = "Optional book type for alternative format") @RequestParam(required = false) String bookType,
+            HttpServletRequest request) throws java.io.IOException {
+        bookService.replaceBookContent(bookId, bookType, request.getInputStream());
+        return ResponseEntity.noContent().build();
+    }
+
     @Operation(summary = "Download book", description = "Download the book file. Requires download permission or admin.")
     @ApiResponses({
             @ApiResponse(responseCode = "200", description = "Book downloaded successfully"),

booklore-api/src/main/java/org/booklore/controller/CbxReaderController.java

@@ -1,5 +1,6 @@
 package org.booklore.controller;
 
+import org.booklore.model.dto.response.CbxPageDimension;
 import org.booklore.model.dto.response.CbxPageInfo;
 import org.booklore.service.reader.CbxReaderService;
 import io.swagger.v3.oas.annotations.Operation;
@@ -36,4 +37,13 @@ public List<CbxPageInfo> getPageInfo(
             @Parameter(description = "Optional book type for alternative format (e.g., PDF, CBX)") @RequestParam(required = false) String bookType) {
         return cbxReaderService.getPageInfo(bookId, bookType);
     }
+
+    @Operation(summary = "Get page dimensions for a CBX book", description = "Retrieve width, height, and wide flag for each page in a CBX book.")
+    @ApiResponse(responseCode = "200", description = "Page dimensions returned successfully")
+    @GetMapping("/{bookId}/page-dimensions")
+    public List<CbxPageDimension> getPageDimensions(
+            @Parameter(description = "ID of the book") @PathVariable Long bookId,
+            @Parameter(description = "Optional book type for alternative format (e.g., PDF, CBX)") @RequestParam(required = false) String bookType) {
+        return cbxReaderService.getPageDimensions(bookId, bookType);
+    }
 }

booklore-api/src/main/java/org/booklore/model/dto/PdfViewerPreferences.java

@@ -13,4 +13,5 @@ public class PdfViewerPreferences {
     private Long bookId;
     private String zoom;
     private String spread;
+    private Boolean isDarkTheme;
 }

booklore-api/src/main/java/org/booklore/model/dto/response/CbxPageDimension.java

@@ -0,0 +1,17 @@
+package org.booklore.model.dto.response;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class CbxPageDimension {
+    private int pageNumber;
+    private int width;
+    private int height;
+    private boolean wide;
+}

booklore-api/src/main/java/org/booklore/model/entity/PdfViewerPreferencesEntity.java

@@ -29,4 +29,7 @@ public class PdfViewerPreferencesEntity {
 
     @Column(name = "spread")
     private String spread;
+
+    @Column(name = "is_dark_theme")
+    private Boolean isDarkTheme;
 }

booklore-api/src/main/java/org/booklore/model/enums/CbxPageScrollMode.java

@@ -2,5 +2,6 @@
 
 public enum CbxPageScrollMode {
     PAGINATED,
-    INFINITE
+    INFINITE,
+    LONG_STRIP
 }

booklore-api/src/main/java/org/booklore/service/book/BookService.java

@@ -43,6 +43,7 @@
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;
+import java.nio.file.StandardCopyOption;
 import java.util.*;
 import java.util.stream.Collectors;
 
@@ -205,6 +206,7 @@ public BookViewerSettings getBookViewerSetting(long bookId, long bookFileId) {
                             .bookId(bookId)
                             .zoom(pdfPref.getZoom())
                             .spread(pdfPref.getSpread())
+                            .isDarkTheme(pdfPref.getIsDarkTheme())
                             .build()));
             newPdfViewerPreferencesRepository.findByBookIdAndUserId(bookId, user.getId())
                     .ifPresent(pdfPref -> settingsBuilder.newPdfSettings(NewPdfViewerPreferences.builder()
@@ -382,6 +384,25 @@ public void streamBookContent(long bookId, String bookType, HttpServletRequest r
         fileStreamingService.streamWithRangeSupport(path, contentType, request, response);
     }
 
+    public void replaceBookContent(long bookId, String bookType, java.io.InputStream content) throws IOException {
+        BookEntity bookEntity = bookRepository.findByIdWithBookFiles(bookId)
+                .orElseThrow(() -> ApiError.BOOK_NOT_FOUND.createException(bookId));
+
+        Path filePath;
+        if (bookType != null) {
+            BookFileType requestedType = BookFileType.valueOf(bookType.toUpperCase());
+            BookFileEntity bookFile = bookEntity.getBookFiles().stream()
+                    .filter(bf -> bf.getBookType() == requestedType)
+                    .findFirst()
+                    .orElseThrow(() -> ApiError.FILE_NOT_FOUND.createException("No file of type " + bookType + " found for book"));
+            filePath = bookFile.getFullFilePath();
+        } else {
+            filePath = FileUtils.getBookFullPath(bookEntity);
+        }
+
+        Files.copy(content, filePath, StandardCopyOption.REPLACE_EXISTING);
+    }
+
     @Transactional
     public ResponseEntity<BookDeletionResponse> deleteBooks(Set<Long> ids) {
         BookLoreUser user = authenticationService.getAuthenticatedUser();

booklore-api/src/main/java/org/booklore/service/book/BookUpdateService.java

@@ -120,6 +120,7 @@ private void updatePdfViewerSettings(long bookId, Long userId, BookViewerSetting
             PdfViewerPreferences pdfSettings = settings.getPdfSettings();
             prefs.setZoom(pdfSettings.getZoom());
             prefs.setSpread(pdfSettings.getSpread());
+            prefs.setIsDarkTheme(pdfSettings.getIsDarkTheme());
             pdfViewerPreferencesRepository.save(prefs);
         }
 

booklore-api/src/main/java/org/booklore/service/reader/CbxReaderService.java

@@ -9,6 +9,7 @@
 import org.apache.commons.compress.archivers.zip.ZipArchiveEntry;
 import org.apache.pdfbox.io.IOUtils;
 import org.booklore.exception.ApiError;
+import org.booklore.model.dto.response.CbxPageDimension;
 import org.booklore.model.dto.response.CbxPageInfo;
 import org.booklore.model.entity.BookEntity;
 import org.booklore.model.entity.BookFileEntity;
@@ -19,6 +20,11 @@
 import org.booklore.util.UnrarHelper;
 import org.springframework.stereotype.Service;
 
+import javax.imageio.ImageIO;
+import javax.imageio.ImageReader;
+import javax.imageio.stream.ImageInputStream;
+import java.io.ByteArrayInputStream;
+import java.io.ByteArrayOutputStream;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.io.InputStream;
@@ -113,6 +119,63 @@ public List<CbxPageInfo> getPageInfo(Long bookId, String bookType) {
         }
     }
 
+    public List<CbxPageDimension> getPageDimensions(Long bookId) {
+        return getPageDimensions(bookId, null);
+    }
+
+    public List<CbxPageDimension> getPageDimensions(Long bookId, String bookType) {
+        Path cbxPath = getBookPath(bookId, bookType);
+        try {
+            CachedArchiveMetadata metadata = getCachedMetadata(cbxPath);
+            List<String> imageEntries = metadata.imageEntries;
+            List<CbxPageDimension> dimensions = new ArrayList<>();
+            for (int i = 0; i < imageEntries.size(); i++) {
+                String entryName = imageEntries.get(i);
+                CbxPageDimension dim = readEntryDimension(cbxPath, entryName, metadata, i + 1);
+                dimensions.add(dim);
+            }
+            return dimensions;
+        } catch (IOException e) {
+            log.error("Failed to read page dimensions for book {}", bookId, e);
+            throw ApiError.FILE_READ_ERROR.createException("Failed to read page dimensions: " + e.getMessage());
+        }
+    }
+
+    private CbxPageDimension readEntryDimension(Path cbxPath, String entryName, CachedArchiveMetadata metadata, int pageNumber) {
+        try {
+            ByteArrayOutputStream baos = new ByteArrayOutputStream();
+            streamEntryFromArchive(cbxPath, entryName, baos, metadata);
+            byte[] imageBytes = baos.toByteArray();
+            try (ImageInputStream iis = ImageIO.createImageInputStream(new ByteArrayInputStream(imageBytes))) {
+                Iterator<ImageReader> readers = ImageIO.getImageReaders(iis);
+                if (readers.hasNext()) {
+                    ImageReader reader = readers.next();
+                    try {
+                        reader.setInput(iis);
+                        int width = reader.getWidth(0);
+                        int height = reader.getHeight(0);
+                        return CbxPageDimension.builder()
+                                .pageNumber(pageNumber)
+                                .width(width)
+                                .height(height)
+                                .wide(width > height)
+                                .build();
+                    } finally {
+                        reader.dispose();
+                    }
+                }
+            }
+        } catch (IOException e) {
+            log.warn("Failed to read dimensions for page {} (entry: {}): {}", pageNumber, entryName, e.getMessage());
+        }
+        return CbxPageDimension.builder()
+                .pageNumber(pageNumber)
+                .width(0)
+                .height(0)
+                .wide(false)
+                .build();
+    }
+
     private String extractDisplayName(String entryPath) {
         String fileName = baseName(entryPath);
         int lastDotIndex = fileName.lastIndexOf('.');

booklore-api/src/main/java/org/booklore/service/user/DefaultUserSettingsProvider.java

@@ -60,7 +60,7 @@ private BookLoreUser.UserSettings.PerBookSetting buildDefaultPerBookSetting() {
 
     private BookLoreUser.UserSettings.PdfReaderSetting buildDefaultPdfReaderSetting() {
         return BookLoreUser.UserSettings.PdfReaderSetting.builder()
-                .pageSpread("odd")
+                .pageSpread("off")
                 .pageZoom("page-fit")
                 .build();
     }

booklore-api/src/main/resources/db/migration/V134__Add_is_dark_theme_to_pdf_viewer_preference.sql

@@ -0,0 +1 @@
+ALTER TABLE pdf_viewer_preference ADD COLUMN is_dark_theme BOOLEAN DEFAULT TRUE;

booklore-api/src/main/resources/db/migration/V135__Change_pdf_default_spread_to_off.sql

@@ -0,0 +1,10 @@
+-- Change default PDF page spread from 'odd' to 'off' (single page view)
+UPDATE user_settings
+SET setting_value = REPLACE(setting_value, '"pageSpread":"odd"', '"pageSpread":"off"')
+WHERE setting_key = 'PDF_READER_SETTING'
+  AND setting_value LIKE '%"pageSpread":"odd"%';
+
+-- Update existing per-book PDF viewer preferences
+UPDATE pdf_viewer_preference
+SET spread = 'off'
+WHERE spread = 'odd';

frontend/.yarnrc.yml

@@ -0,0 +1,4 @@
+nodeLinker: node-modules
+nmMode: hardlinks-local
+enableGlobalCache: false
+cacheFolder: .yarn/cache

frontend/angular.json

@@ -47,6 +47,16 @@
                 "glob": "**/*",
                 "input": "libs/foliate-js",
                 "output": "/assets/foliate/"
+              },
+              {
+                "glob": "**/*",
+                "input": "node_modules/@embedpdf/pdfium/dist/",
+                "output": "/assets/pdfium/"
+              },
+              {
+                "glob": "**/*",
+                "input": "node_modules/@embedpdf/snippet/dist/",
+                "output": "/assets/embedpdf/"
               }
             ],
             "styles": [
@@ -98,6 +108,12 @@
         },
         "serve": {
           "builder": "@angular/build:dev-server",
+          "options": {
+            "headers": {
+              "Cross-Origin-Opener-Policy": "same-origin",
+              "Cross-Origin-Embedder-Policy": "credentialless"
+            }
+          },
           "configurations": {
             "production": {
               "buildTarget": "grimmory:build:production"
@@ -135,4 +151,4 @@
     ],
     "analytics": false
   }
-}
+}

frontend/package.json

@@ -32,6 +32,8 @@
     "@angular/platform-browser-dynamic": "^21.2.6",
     "@angular/router": "^21.2.6",
     "@angular/service-worker": "^21.2.6",
+    "@embedpdf/pdfium": "^2.11.1",
+    "@embedpdf/snippet": "^2.11.1",
     "@iharbeck/ngx-virtual-scroller": "^20.0.0",
     "@jsverse/transloco": "^8.2.1",
     "@primeuix/themes": "^2.0.3",

frontend/src/app/features/book/components/book-browser/book-filter/book-filter.component.ts

@@ -73,6 +73,13 @@ export class BookFilterComponent implements OnInit, OnDestroy {
 
   readonly filterLabelKeys = FILTER_LABEL_KEYS;
 
+  private readonly userSettingsEffect = effect(() => {
+    const user = this.userService.currentUser();
+    if (!user) return;
+    this._visibleFilters = user.userSettings.visibleFilters ?? [...DEFAULT_VISIBLE_FILTERS];
+    this.updateVisibleFilterTypes();
+  });
+
   getFilterLabel(type: FilterType): string {
     const key = this.filterLabelKeys[type];
     return key ? this.t.translate(key) : type;
@@ -99,7 +106,6 @@ export class BookFilterComponent implements OnInit, OnDestroy {
   ngOnInit(): void {
     this.updateVisibleFilterTypes();
     this.updateExpandedPanels();
-    this.subscribeToUserSettings();
     this.subscribeToReset();
   }
 
@@ -164,15 +170,6 @@ export class BookFilterComponent implements OnInit, OnDestroy {
     return String(value ?? '');
   }
 
-  private subscribeToUserSettings(): void {
-    effect(() => {
-      const user = this.userService.currentUser();
-      if (!user) return;
-      this._visibleFilters = user.userSettings.visibleFilters ?? [...DEFAULT_VISIBLE_FILTERS];
-      this.updateVisibleFilterTypes();
-    });
-  }
-
   private updateVisibleFilterTypes(): void {
     this.visibleFilterTypes = this._visibleFilters.filter(
       vf => this.filterTypes.includes(vf as FilterType)

frontend/src/app/features/book/model/book.model.ts

@@ -1,5 +1,5 @@
 import {Shelf} from './shelf.model';
-import {CbxBackgroundColor, CbxFitMode, CbxPageSpread, CbxPageViewMode, CbxScrollMode, NewPdfReaderSetting} from '../../settings/user-management/user.service';
+import {CbxBackgroundColor, CbxFitMode, CbxPageSpread, CbxPageSplitOption, CbxPageViewMode, CbxScrollMode, NewPdfReaderSetting} from '../../settings/user-management/user.service';
 import {BookReview} from '../components/book-reviews/book-review-service';
 import {ZoomType} from 'ngx-extended-pdf-viewer';
 
@@ -305,6 +305,7 @@ export interface MetadataUpdateWrapper {
 export interface PdfViewerSetting {
   zoom: ZoomType;
   spread: 'off' | 'even' | 'odd';
+  isDarkTheme?: boolean;
 }
 
 export interface EpubViewerSetting {
@@ -339,6 +340,11 @@ export interface CbxViewerSetting {
   fitMode: CbxFitMode;
   scrollMode?: CbxScrollMode;
   backgroundColor?: CbxBackgroundColor;
+  pageSplitOption?: CbxPageSplitOption;
+  brightness?: number;
+  emulateBook?: boolean;
+  clickToPaginate?: boolean;
+  autoCloseMenu?: boolean;
 }
 
 export interface BookSetting {