Roadmap, robust page refs, copy behaviour

README

@@ -1 +1,76 @@
-empty
+# PDF Workbench
+
+Browser-only PDF tools for quick page-level editing. Processing happens completely locally in the browser; files are never uploaded to a server.
+
+## Current features
+
+- load a PDF in the browser
+- generate page thumbnails progressively
+- reorder pages via drag and drop
+- select pages, including Shift range selection
+- rotate pages clockwise/counter-clockwise
+- delete pages from the working document
+- preview pages in an overlay
+- flip through preview pages with buttons or arrow keys
+- merge a second PDF by replacing, appending, or inserting at a chosen position
+- extract selected pages into a new PDF
+- export the current reordered/rotated document
+- split into single-page PDFs
+
+## Keyboard shortcuts
+
+- `CtrlA` / `⌘A`: select all pages
+- `Delete` / `Backspace`: delete selected pages
+- `Esc`: clear the current selection
+- Preview overlay: `←` / `→` flip pages, `Esc` closes the overlay
+
+Keyboard shortcuts are ignored while typing in form fields.
+
+## Current implementation focus
+
+The project is currently optimized around page-level PDF work: split, merge, reorder, rotate, preview, select, delete, extract, and export. Deep content-stream editing is intentionally out of scope for now.
+
+## Roadmap
+
+### Milestone 1: Fast preview and thumbnails
+
+- [x] Remove unused `PageList` component
+- [x] Bound thumbnail generation by width and height
+- [x] Display thumbnails progressively
+- [x] Add preview page flipping
+- [x] Attach preview controls to the modal container
+- [x] Add first keyboard shortcuts
+- [x] Cache thumbnails by page and rotation
+- [x] Regenerate only changed rotated thumbnails
+
+### Milestone 2: Real page workspace
+
+- [x] Introduce stable page references instead of only original page indices
+- [x] Support duplicate selected pages
+- [ ] Extract selection as a new active workspace
+- [ ] Add command history as a foundation for undo/redo
+- [ ] Add undo/redo
+- [ ] Add grid/list view toggle
+
+### Milestone 3: Better merge and mobile handling
+
+- [ ] Add a full multi-file merge queue
+- [ ] Support drag-and-drop of PDFs into the page grid at the hovered position
+- [ ] Add custom long-press drag on mobile
+- [ ] Consolidate actions into a toolbar
+
+### Milestone 4: Structural PDF editing
+
+- [ ] Metadata editing
+- [ ] Crop pages
+- [ ] Add tools directly in the preview overlay
+- [ ] Read/fill/flatten forms
+- [ ] Read bookmarks, then evaluate bookmark editing
+- [ ] Read annotations, then evaluate annotation writing
+
+### Milestone 5: Export and power tools
+
+- [ ] Basic text extraction
+- [ ] ZIP export for split results
+- [ ] Optimize/compress MVP
+- [ ] Carefully scoped encrypted PDF handling