#129 US-YW11: Preview Before Import

[Anonymous]

Originally created by: smith-and-web

User Story

As a writer importing a yWriter project,
I want to preview what will be imported before confirming,
So that I can verify the import will meet my needs.

Parent Epic: [#123]

Preview Dialog Design

┌─────────────────────────────────────────────────────────────────┐
│  Import yWriter Project                                         │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Project: "The Jade Dragon Mystery"                             │
│  Author: Sarah Chen                                             │
│                                                                 │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │  Summary                                                 │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │  Chapters:     24                                        │   │
│  │  Scenes:       87                                        │   │
│  │  Characters:   12 (4 major, 8 minor)                     │   │
│  │  Locations:    8                                         │   │
│  │  Items:        5                                         │   │
│  │                                                          │   │
│  │  Scenes with prose:     62 (71%)                         │   │
│  │  Scenes with GCO:       74 (85%)                         │   │
│  │  Estimated word count:  45,230                           │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │  Preview                                                 │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │  Chapter 1: The Letter                                   │   │
│  │    └ Scene 1: Sarah Receives the Package                 │   │
│  │    └ Scene 2: Opening Grandmother's Box                  │   │
│  │  Chapter 2: Old Chinatown                                │   │
│  │    └ Scene 3: The Golden Dragon Cafe                     │   │
│  │    └ Scene 4: Mrs. Liu's Warning                         │   │
│  │  ...                                                     │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  ⚠ Warnings                                                     │
│  • 3 scenes have no chapter assignment (will create "Orphaned") │
│  • 2 character references point to missing characters           │
│                                                                 │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │  Import Options                                          │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │  ☑ Import Goal/Conflict/Outcome as beats                 │   │
│  │  ☑ Import scene descriptions as beats                    │   │
│  │  ☑ Import existing prose                                 │   │
│  │  ☑ Import characters                                     │   │
│  │  ☑ Import locations                                      │   │
│  │  ☐ Import items                                          │   │
│  │  ☐ Import Notes/ToDo scenes                              │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│                              [Cancel]  [Import]                 │
└─────────────────────────────────────────────────────────────────┘

Statistics to Display

Counts

• Total chapters
• Total scenes
• Total characters (major/minor breakdown)
• Total locations
• Total items

Content Analysis

• Scenes with prose content (count and percentage)
• Scenes with GCO fields populated (count and percentage)
• Estimated total word count
• Notes/ToDo scenes count (if any)

Warnings

• Orphaned scenes (not assigned to any chapter)
• Missing references (scene points to non-existent character/location)
• Encoding issues detected
• Very large project warning (500+ scenes)

Acceptance Criteria

• [ ] After selecting .yw7 file, shows preview dialog before import
• [ ] Preview displays project title and author
• [ ] Preview displays chapter count
• [ ] Preview displays scene count
• [ ] Preview displays character count with major/minor breakdown
• [ ] Preview displays location count
• [ ] Preview displays item count
• [ ] Shows percentage of scenes with prose content
• [ ] Shows percentage of scenes with GCO populated
• [ ] Shows estimated word count
• [ ] Shows sample of first few chapters/scenes (expandable tree)
• [ ] Displays warnings for any issues detected
• [ ] Provides import options checkboxes
• [ ] "Import" button proceeds with configured options
• [ ] "Cancel" button returns to previous state
• [ ] Preview loads quickly (< 1 second for typical project)

Implementation Notes

The preview should do a lightweight parse of the XML to gather statistics without fully loading all content into memory. This enables fast preview even for large projects.

[Anonymous]

Originally posted by: smith-and-web

Not implemented in PR [#140]: Import proceeds directly without a preview step. This feature would allow users to see what will be imported and selectively include/exclude items. Keeping open for future enhancement.