Phase-1 migration docs (JIRA basis — draft, do not merge)

The WinForms->Avalonia per-screen migration catalog: one Docs/migration/<screen>.md
per legacy surface (primitive, legacy PNG captured from live FLEx, parity checklist,
gotchas) plus their images. This branch is the standalone basis for authoring the
JIRA migration tickets after the four Phase-1 code PRs (base + interlinear + rule +
table) land. It is intentionally NEVER MERGED — open as a draft PR for reference only.

402 files (235 docs + 167 screenshots).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: johnml1135

Docs/migration/CONTEXT.md

@@ -0,0 +1,38 @@
+# Migration-doc capture — shared language
+
+Scoped context for the legacy-screenshot capture work that feeds `Docs/migration/`.
+Extends the root [`CONTEXT.md`](../../CONTEXT.md); only adds terms specific to this bounded context.
+
+## Terms
+- **Legacy truth PNG**: a screenshot of a *legacy WinForms* FLEx surface (UIMode=Legacy),
+  captured as the visual parity baseline for its migration doc. Stored in
+  `Docs/migration/**/images/<screen>-NN.png`. NOT an Avalonia screenshot.
+- **Capture target**: a screen that needs a legacy truth PNG — a **tool** (Area/Tool screen),
+  a **list editor**, or a **dialog**. Tracked in `INVENTORY.md`.
+- **Launch-per-tool capture** (option 2): drive FLEx to a **tool** by launching
+  `FieldWorks.exe -db "<language project>" "<silfw link>"` where the link
+  (`silfw://localhost/link?app=flex&database=<db>&tool=<toolId>&guid=<guid>`, see
+  `FwLinkArgs.kFwUrlPrefix`) makes the shell open that tool at startup
+  (`FieldWorks.cs` → `FwAppArgs` → `HasLinkInformation`). Then screenshot the main window.
+- **Dialog screenshot harness** (option 3): a standalone WinForms host that opens a
+  **language project** `LcmCache` (the `LCMBrowser` pattern), constructs a legacy dialog
+  (`new XDlg()` + `SetDlgInfo(cache, …)` — FLEx's two-phase dialog init), shows it with
+  seeded data, and renders it to a PNG. Reaches dialogs that navigation can't (conditional
+  delete/restore/warning dialogs) and doubles as the future legacy↔Avalonia parity rig.
+- **Reachable set**: capture targets achievable by option 2 or 3. EXCLUDES Views/Gecko-coupled
+  dialogs (need a live `IVwRootBox`/`IVwSelection`, e.g. `RelatedWords`) and the 12 non-visual
+  Phase-2 internals — those stay **on-pickup**.
+- **Capture manifest**: machine-readable list (toolId / dialog factory → target doc + image
+  path) the script and harness iterate over; derived from `INVENTORY.md`.
+
+## Invariants
+- Capture in **UIMode=Legacy** only (this is the legacy baseline). The Avalonia surface has a
+  separate headless path.
+- Data source for representative states: the **Sena 3** language project.
+- A capture writes to the image path its doc already references; capturing never edits the
+  language project (open read-only / discard; close with Cancel/Escape).
+
+## Open questions
+- Headless rendering: `Control.DrawToBitmap` works for ordinary dialogs but not for embedded
+  native **Views** content — confirm per-dialog during the harness build; fall back to a
+  visible/VDD desktop + window screenshot where DrawToBitmap is blank.

Docs/migration/INVENTORY.md

@@ -0,0 +1,266 @@
+# WinForms → Avalonia migration inventory (master index)
+
+Auto-generated index of every in-scope WinForms component with a migration doc.
+Goal: **100% coverage — no in-scope component without a tracked doc.** Each entry is a
+lightweight stub (`_STUB_TEMPLATE.md`); deepen to the full format (`_TEMPLATE.md`) +
+capture legacy PNGs (`fieldworks-winapp` skill) when its JIRA ticket is picked up.
+See [README.md](./README.md) for the canonical-screen map and Phase-1 strategy.
+
+**Total components tracked: 227.**
+
+> Already migrated / kept canonical (not stubbed here — see README canonical-screen map):
+> Lexicon Browse pane, Lexicon Edit entry pane (+ notebookEdit/posEdit), ChooserDialog,
+> OptionsDialog, InsertEntryDialog, EntryGoDialog. Split to own follow-up PRs: the Words
+> interlinear `Analyses` editor and the 6 Grammar rule tools (their tool stubs note this).
+
+## Phase 1 — user-facing surfaces
+
+### Deferred dialogs (detailed docs) (13)
+
+- [Add New Sense](./add-new-sense.md)
+- [Configure Columns](./configure-columns.md)
+- [Create Feature](./create-feature.md)
+- [Date Range Filter](./date-range-filter.md)
+- [Delete Confirmation](./delete-confirmation.md)
+- [Feature Chooser](./feature-chooser.md)
+- [Filter For](./filter-for.md)
+- [Find Replace](./find-replace.md)
+- [Lex Reference Details](./lex-reference-details.md)
+- [Msa Creator](./msa-creator.md)
+- [Picture Properties](./picture-properties.md)
+- [Special Character](./special-character.md)
+- [Writing System Properties](./writing-system-properties.md)
+
+### Dialogs (107)
+
+- [Add Allomorph Dlg](./dialogs/add-allomorph-dlg.md)
+- [Add Converter](./dialogs/add-converter.md)
+- [Add Custom Field](./dialogs/add-custom-field.md)
+- [Add List](./dialogs/add-list.md)
+- [Add New User](./dialogs/add-new-user.md)
+- [Add New Vern Lang Warning](./dialogs/add-new-vern-lang-warning.md)
+- [Advanced Mt Dialog](./dialogs/advanced-mt-dialog.md)
+- [Anthro Field Mapping Dlg](./dialogs/anthro-field-mapping-dlg.md)
+- [Apply Style](./dialogs/apply-style.md)
+- [Archive With Ramp](./dialogs/archive-with-ramp.md)
+- [Backup Project](./dialogs/backup-project.md)
+- [Basic Find](./dialogs/basic-find.md)
+- [Cant Restore Linked Files To Original Location](./dialogs/cant-restore-linked-files-to-original-location.md)
+- [Change Default Backup Dir](./dialogs/change-default-backup-dir.md)
+- [Choose Lang Project](./dialogs/choose-lang-project.md)
+- [Choose Text Writing System Dlg](./dialogs/choose-text-writing-system-dlg.md)
+- [Chooser](./dialogs/chooser.md)
+- [Combine Import Dlg](./dialogs/combine-import-dlg.md)
+- [Complex Conc Morph Dlg](./dialogs/complex-conc-morph-dlg.md)
+- [Complex Conc Tag Dlg](./dialogs/complex-conc-tag-dlg.md)
+- [Complex Conc Word Dlg](./dialogs/complex-conc-word-dlg.md)
+- [Concordance Dlg](./dialogs/concordance-dlg.md)
+- [Configure Interlin Dialog](./dialogs/configure-interlin-dialog.md)
+- [Configure List](./dialogs/configure-list.md)
+- [Conflicting Save](./dialogs/conflicting-save.md)
+- [Create Allomorph Type Mismatch Dlg](./dialogs/create-allomorph-type-mismatch-dlg.md)
+- [Delete Project](./dialogs/delete-project.md)
+- [Delete Writing System Warning](./dialogs/delete-writing-system-warning.md)
+- [Dictionary Config Mgr](./dialogs/dictionary-config-mgr.md)
+- [Dictionary Configuration Import](./dialogs/dictionary-configuration-import.md)
+- [Dictionary Configuration Manager](./dialogs/dictionary-configuration-manager.md)
+- [Dictionary Configuration Node Rename](./dialogs/dictionary-configuration-node-rename.md)
+- [Dictionary Configuration](./dialogs/dictionary-configuration.md)
+- [Discourse Export Dialog](./dialogs/discourse-export-dialog.md)
+- [Edit Morph Breaks Dlg](./dialogs/edit-morph-breaks-dlg.md)
+- [Export Dialog](./dialogs/export-dialog.md)
+- [Export Semantic Domains](./dialogs/export-semantic-domains.md)
+- [Export Translated Lists](./dialogs/export-translated-lists.md)
+- [Files To Restore Are Older](./dialogs/files-to-restore-are-older.md)
+- [Filter Texts Dialog](./dialogs/filter-texts-dialog.md)
+- [Find Example Sentence Dlg](./dialogs/find-example-sentence-dlg.md)
+- [Flexbridge First Send Receive Instructions Dlg](./dialogs/flexbridge-first-send-receive-instructions-dlg.md)
+- [Font](./dialogs/font.md)
+- [Hc Max Compound Rules Dlg](./dialogs/hc-max-compound-rules-dlg.md)
+- [Headword Numbers](./dialogs/headword-numbers.md)
+- [Help About](./dialogs/help-about.md)
+- [Import Char Mapping Dlg](./dialogs/import-char-mapping-dlg.md)
+- [Import Date Format Dlg](./dialogs/import-date-format-dlg.md)
+- [Import Enc Cvtr Dlg](./dialogs/import-enc-cvtr-dlg.md)
+- [Import Match Replace Dlg](./dialogs/import-match-replace-dlg.md)
+- [Import Word Set Dlg](./dialogs/import-word-set-dlg.md)
+- [Insert Record Dlg](./dialogs/insert-record-dlg.md)
+- [Insert Variant Dlg](./dialogs/insert-variant-dlg.md)
+- [Interlinear Export Dialog](./dialogs/interlinear-export-dialog.md)
+- [Interlinear Import Dlg](./dialogs/interlinear-import-dlg.md)
+- [Lex Import Wizard Char Marker Dlg](./dialogs/lex-import-wizard-char-marker-dlg.md)
+- [Lex Import Wizard Language](./dialogs/lex-import-wizard-language.md)
+- [Lex Import Wizard Marker](./dialogs/lex-import-wizard-marker.md)
+- [Lift Export Message](./dialogs/lift-export-message.md)
+- [Lift Import Dlg](./dialogs/lift-import-dlg.md)
+- [Lingua Links Import Dlg](./dialogs/lingua-links-import-dlg.md)
+- [Link Allomorph Dlg](./dialogs/link-allomorph-dlg.md)
+- [Link Entry Or Sense Dlg](./dialogs/link-entry-or-sense-dlg.md)
+- [Link Msa Dlg](./dialogs/link-msa-dlg.md)
+- [Link Variant To Entry Or Sense](./dialogs/link-variant-to-entry-or-sense.md)
+- [Master Category List Dlg](./dialogs/master-category-list-dlg.md)
+- [Master Inflection Feature List Dlg](./dialogs/master-inflection-feature-list-dlg.md)
+- [Master Phonological Feature List Dlg](./dialogs/master-phonological-feature-list-dlg.md)
+- [Merge Entry Dlg](./dialogs/merge-entry-dlg.md)
+- [Merge Object](./dialogs/merge-object.md)
+- [Merge Writing System](./dialogs/merge-writing-system.md)
+- [Mga Dialog](./dialogs/mga-dialog.md)
+- [Mga Html Help Dialog](./dialogs/mga-html-help-dialog.md)
+- [Missing Old Fieldworks](./dialogs/missing-old-fieldworks.md)
+- [Move Or Copy Files](./dialogs/move-or-copy-files.md)
+- [New Lang Project](./dialogs/new-lang-project.md)
+- [Notebook Export](./dialogs/notebook-export.md)
+- [Occurrence Dlg](./dialogs/occurrence-dlg.md)
+- [Overwrite Existing Project](./dialogs/overwrite-existing-project.md)
+- [Parser Parameters Dlg](./dialogs/parser-parameters-dlg.md)
+- [Project Location](./dialogs/project-location.md)
+- [Project Properties](./dialogs/project-properties.md)
+- [Record Go Dlg](./dialogs/record-go-dlg.md)
+- [Related Words](./dialogs/related-words.md)
+- [Respeller Dlg](./dialogs/respeller-dlg.md)
+- [Restore Defaults Dlg](./dialogs/restore-defaults-dlg.md)
+- [Restore Linked Files To Projects Folder](./dialogs/restore-linked-files-to-projects-folder.md)
+- [Restore Project](./dialogs/restore-project.md)
+- [Reversal Entry Go Dlg](./dialogs/reversal-entry-go-dlg.md)
+- [Select Clauses Dialog](./dialogs/select-clauses-dialog.md)
+- [Sfm To Texts And Words Mapping Dlg](./dialogs/sfm-to-texts-and-words-mapping-dlg.md)
+- [Splash Screen](./dialogs/splash-screen.md)
+- [Styles Modified](./dialogs/styles-modified.md)
+- [Styles](./dialogs/styles.md)
+- [Summary Dialog Form](./dialogs/summary-dialog-form.md)
+- [Swap Lexeme With Allomorph Dlg](./dialogs/swap-lexeme-with-allomorph-dlg.md)
+- [Try A Word Dlg](./dialogs/try-a-word-dlg.md)
+- [Update Report](./dialogs/update-report.md)
+- [Upload To Webonary](./dialogs/upload-to-webonary.md)
+- [User Properties](./dialogs/user-properties.md)
+- [Utility](./dialogs/utility.md)
+- [Valid Characters](./dialogs/valid-characters.md)
+- [View Hidden Writing Systems](./dialogs/view-hidden-writing-systems.md)
+- [Warning Not Using Default Linked Files Location](./dialogs/warning-not-using-default-linked-files-location.md)
+- [Webonary Log Viewer](./dialogs/webonary-log-viewer.md)
+- [Xml Diagnostics](./dialogs/xml-diagnostics.md)
+- [Xml Doc Configure](./dialogs/xml-doc-configure.md)
+
+### Choosers & launchers (28)
+
+- [Atomic Reference Launcher](./choosers-launchers/atomic-reference-launcher.md)
+- [Audio Visual Launcher](./choosers-launchers/audio-visual-launcher.md)
+- [Configure Writing Systems Dlg](./choosers-launchers/configure-writing-systems-dlg.md)
+- [Entry Sequence Reference Launcher](./choosers-launchers/entry-sequence-reference-launcher.md)
+- [Gen Date Chooser Dlg](./choosers-launchers/gen-date-chooser-dlg.md)
+- [Gen Date Launcher](./choosers-launchers/gen-date-launcher.md)
+- [Ghost Lex Ref Launcher](./choosers-launchers/ghost-lex-ref-launcher.md)
+- [Ghost Reference Vector Launcher](./choosers-launchers/ghost-reference-vector-launcher.md)
+- [Lex Reference Collection Launcher](./choosers-launchers/lex-reference-collection-launcher.md)
+- [Lex Reference Pair Launcher](./choosers-launchers/lex-reference-pair-launcher.md)
+- [Lex Reference Sequence Launcher](./choosers-launchers/lex-reference-sequence-launcher.md)
+- [Lex Reference Tree Branches Launcher](./choosers-launchers/lex-reference-tree-branches-launcher.md)
+- [Lex Reference Tree Root Launcher](./choosers-launchers/lex-reference-tree-root-launcher.md)
+- [Lex Reference Unidirectional Launcher](./choosers-launchers/lex-reference-unidirectional-launcher.md)
+- [Master Category List Chooser Launcher](./choosers-launchers/master-category-list-chooser-launcher.md)
+- [Morph Type Atomic Launcher](./choosers-launchers/morph-type-atomic-launcher.md)
+- [Morph Type Chooser](./choosers-launchers/morph-type-chooser.md)
+- [Msa Dlg Launcher](./choosers-launchers/msa-dlg-launcher.md)
+- [Phone Env Reference Launcher](./choosers-launchers/phone-env-reference-launcher.md)
+- [Possibility Atomic Reference Launcher](./choosers-launchers/possibility-atomic-reference-launcher.md)
+- [Possibility Vector Reference Launcher](./choosers-launchers/possibility-vector-reference-launcher.md)
+- [Record Reference Vector Launcher](./choosers-launchers/record-reference-vector-launcher.md)
+- [Rev Entry Senses Collection Reference Launcher](./choosers-launchers/rev-entry-senses-collection-reference-launcher.md)
+- [Semantic Domain Reference Launcher](./choosers-launchers/semantic-domain-reference-launcher.md)
+- [Semantic Domains Chooser](./choosers-launchers/semantic-domains-chooser.md)
+- [Simple Integer Match Dlg](./choosers-launchers/simple-integer-match-dlg.md)
+- [User Interface Chooser](./choosers-launchers/user-interface-chooser.md)
+- [Vector Reference Launcher](./choosers-launchers/vector-reference-launcher.md)
+
+### Tool screens (34)
+
+- [Adhoc Coprohib Edit](./tools/adhoc-coprohib-edit.md)
+- [Analyses](./tools/analyses.md)
+- [Bulk Edit Entries Or Senses](./tools/bulk-edit-entries-or-senses.md)
+- [Category Browse](./tools/category-browse.md)
+- [Complex Concordance](./tools/complex-concordance.md)
+- [Compound Rule Advanced Edit](./tools/compound-rule-advanced-edit.md)
+- [Concordance](./tools/concordance.md)
+- [Corpus Statistics](./tools/corpus-statistics.md)
+- [Environment Edit](./tools/environment-edit.md)
+- [Features Advanced Edit](./tools/features-advanced-edit.md)
+- [Grammar Sketch](./tools/grammar-sketch.md)
+- [Interlinear Edit](./tools/interlinear-edit.md)
+- [Lexicon Browse](./tools/lexicon-browse.md)
+- [Lexicon Classified Dictionary](./tools/lexicon-classified-dictionary.md)
+- [Lexicon Dictionary](./tools/lexicon-dictionary.md)
+- [Lexicon Edit Popup](./tools/lexicon-edit-popup.md)
+- [Lexicon Edit](./tools/lexicon-edit.md)
+- [Lexicon Problems](./tools/lexicon-problems.md)
+- [Natural Classedit](./tools/natural-classedit.md)
+- [Notebook Browse](./tools/notebook-browse.md)
+- [Notebook Document](./tools/notebook-document.md)
+- [Notebook Edit](./tools/notebook-edit.md)
+- [Phoneme Edit](./tools/phoneme-edit.md)
+- [Phonological Features Advanced Edit](./tools/phonological-features-advanced-edit.md)
+- [Phonological Rule Edit](./tools/phonological-rule-edit.md)
+- [Pos Edit](./tools/pos-edit.md)
+- [Prod Restrict Edit](./tools/prod-restrict-edit.md)
+- [Rapid Data Entry](./tools/rapid-data-entry.md)
+- [Reversal Tool Bulk Edit Reversal Entries](./tools/reversal-tool-bulk-edit-reversal-entries.md)
+- [Reversal Tool Edit Complete](./tools/reversal-tool-edit-complete.md)
+- [Spelling](./tools/spelling.md)
+- [Tool Bulk Edit Phonemes](./tools/tool-bulk-edit-phonemes.md)
+- [Tool Bulk Edit Wordforms](./tools/tool-bulk-edit-wordforms.md)
+- [Word List Concordance](./tools/word-list-concordance.md)
+
+### List editors (CmPossibility) (33)
+
+- [Affix Category Edit](./lists/affix-category-edit.md)
+- [Annotation Def Edit](./lists/annotation-def-edit.md)
+- [Anthro Edit](./lists/anthro-edit.md)
+- [Chartmark Edit](./lists/chartmark-edit.md)
+- [Charttemp Edit](./lists/charttemp-edit.md)
+- [Complex Entry Type Edit](./lists/complex-entry-type-edit.md)
+- [Confidence Edit](./lists/confidence-edit.md)
+- [Dialects List Edit](./lists/dialects-list-edit.md)
+- [Domain Type Edit](./lists/domain-type-edit.md)
+- [Education Edit](./lists/education-edit.md)
+- [Ext Note Type Edit](./lists/ext-note-type-edit.md)
+- [Feature Types Advanced Edit](./lists/feature-types-advanced-edit.md)
+- [Genres Edit](./lists/genres-edit.md)
+- [Languages List Edit](./lists/languages-list-edit.md)
+- [Lex Ref Edit](./lists/lex-ref-edit.md)
+- [Locations Edit](./lists/locations-edit.md)
+- [Morph Type Edit](./lists/morph-type-edit.md)
+- [People Edit](./lists/people-edit.md)
+- [Positions Edit](./lists/positions-edit.md)
+- [Publications Edit](./lists/publications-edit.md)
+- [Rec Type Edit](./lists/rec-type-edit.md)
+- [Restrictions Edit](./lists/restrictions-edit.md)
+- [Reversal Tool Reversal Index Pos](./lists/reversal-tool-reversal-index-pos.md)
+- [Role Edit](./lists/role-edit.md)
+- [Semantic Domain Edit](./lists/semantic-domain-edit.md)
+- [Sense Status Edit](./lists/sense-status-edit.md)
+- [Sense Type Edit](./lists/sense-type-edit.md)
+- [Status Edit](./lists/status-edit.md)
+- [Text Markup Tags Edit](./lists/text-markup-tags-edit.md)
+- [Time Of Day Edit](./lists/time-of-day-edit.md)
+- [Translation Type Edit](./lists/translation-type-edit.md)
+- [Usage Type Edit](./lists/usage-type-edit.md)
+- [Variant Entry Type Edit](./lists/variant-entry-type-edit.md)
+
+## Phase 2 — shell / framework / native rendering (net10 + cross-platform)
+
+### Shell & framework (6)
+
+- [App Lifetime Startup](./phase2/shell/app-lifetime-startup.md)
+- [Main Window](./phase2/shell/main-window.md)
+- [Mediator Propertytable](./phase2/shell/mediator-propertytable.md)
+- [Menus Toolbars Statusbar](./phase2/shell/menus-toolbars-statusbar.md)
+- [Panes Splitters](./phase2/shell/panes-splitters.md)
+- [Sidebar Navigation](./phase2/shell/sidebar-navigation.md)
+
+### Native rendering (decommission targets) (6)
+
+- [Buffered Draw](./phase2/native-render/buffered-draw.md)
+- [Datatree Slice Framework](./phase2/native-render/datatree-slice-framework.md)
+- [Gecko Pdf Preview](./phase2/native-render/gecko-pdf-preview.md)
+- [Graphite Engine](./phase2/native-render/graphite-engine.md)
+- [Managed Views Host](./phase2/native-render/managed-views-host.md)
+- [Views Engine](./phase2/native-render/views-engine.md)