Skip to content

armgit / Filee

Public Imported from GitHub
0

Free, open-source file converter. Convert 263 formats offline by drag & drop — images, PDF, Word, Excel, PowerPoint, HWP/HWPX, video, audio, e-books and archives. No upload, no Office needed.

docs(i18n): record editorial checks and partial Windows validation

Blackspirits987c03f7eb3a
diff --git a/docs/PORTUGUESE-LOCALIZATION.md b/docs/PORTUGUESE-LOCALIZATION.md
index c3cbb4c7..ed8a72db 100644
--- a/docs/PORTUGUESE-LOCALIZATION.md
+++ b/docs/PORTUGUESE-LOCALIZATION.md
@@ -103,6 +103,17 @@ titles and explanations are localized. The multilingual language showcase also r
ignored. App and Setup refresh the selected media on a language change without resetting the current slide.
Every file stays under 400 KiB, each pack under 2 MiB and all shared/Portuguese media under 6 MiB.
+## Approved editorial follow-up — 23 October 2026
+
+`about.sponsor` is now `Apoiar` and `sponsor.title` is `Apoiar o Filee` in pt-PT. `Página inicial` and the
+acknowledgement `patrocinadores` remain unchanged; no pt-BR or other JSON catalog was edited in this follow-up.
+The existing glossary and sponsor-window render cases cover both variants. pt-PT theme/history clips and the
+shared language showcase were regenerated; App and Setup were rebuilt afterwards.
+
+The [current validation report](PORTUGUESE-NATIVE-VALIDATION.md#editorial-follow-up--23-october-2026) separates
+local automated results, headless PNGs and partial real Windows interaction. It also links the new CI run;
+the historical successful run below must not be treated as validation of the new head. The PR remains a draft.
+
## Validation and remaining checks
[Independent-review follow-up](PORTUGUESE-REVIEW-FOLLOWUP.md) records current commands, results and the disposition
diff --git a/docs/PORTUGUESE-NATIVE-VALIDATION.md b/docs/PORTUGUESE-NATIVE-VALIDATION.md
index ec10160e..504ba341 100644
--- a/docs/PORTUGUESE-NATIVE-VALIDATION.md
+++ b/docs/PORTUGUESE-NATIVE-VALIDATION.md
@@ -1,6 +1,6 @@
# Portuguese native validation
-Validated code commit: `9d357e7bcb6fd389d2fa8e48faa1ba3f8c39b13d`.
+Historical CI-validated code commit: `9d357e7bcb6fd389d2fa8e48faa1ba3f8c39b13d`.
Baseline: `a121a3c9e3254918f8b171bb7f675b0bdc532244`.
CI completed on 22 October 2026; report consolidated on 23 October. Only Blackspirits/Filee is changed.
@@ -8,7 +8,94 @@ CI completed on 22 October 2026; report consolidated on 23 October. Only Blacksp
all nine jobs passed. This closes the previously pending automated CI and full-formatter checks. It does not
certify an interactive installation, OS-language session, permission dialog or screen reader.
-## Native test evidence
+## Editorial follow-up — 23 October 2026
+
+Current application/resource commit: `ff7b349e79e95edf6f97c2223408b70667a91553`.
+The remote branch and draft PR #1 were confirmed at `484d6fb` before editing; no older snapshot was restored.
+Only Blackspirits/Filee is changed. Phase 2 has not started.
+
+Commit `91174f2` changes only two pt-PT catalog values: `about.sponsor` → `Apoiar` and `sponsor.title` →
+`Apoiar o Filee`. `Página inicial`, `patrocinadores`, AO90 and informal `tu` are retained. Both catalogs still
+have 911 entries. pt-BR and all other JSON catalogs are byte-for-byte unchanged from `484d6fb`.
+The contextual glossary now checks these choices and the existing sponsor-window render fixture includes both
+Portuguese variants.
+
+Commit `ff7b349` regenerates pt-PT `theme.webp` and `more.webp`, plus the shared `languages.webp`, whose pt-PT
+frame also shows the action. The theme poster moves from frame 28 to 29. No pt-BR recording or browser/flip clip
+was replaced. The fifteen WebP assets total 4,106,272 bytes; every file remains below 400 KiB, every pack below
+2 MiB and the total below 6 MiB. The generated theme/history posters and the showcase's pt-PT frame were inspected. All fifteen media/poster
+entries decoded with valid poster indices; the three regenerated clips are 768 × 432. Shared desktop recordings
+retain their existing resolution.
+
+### Automated checks on local Windows
+
+Environment: Windows x64 build 26300.9711 (26H2), .NET SDK 10.0.204/runtime 10.0.8, with all fifteen pinned,
+SHA-256-verified Noto fonts. The final Release solution build, after restoring the original test helpers and
+rebuilding App/Setup's embedded resources, passed with zero errors and eleven existing warnings.
+
+| Check | Passed | Failed | Skipped |
+| --- | ---: | ---: | ---: |
+| Focused App suite, including Portuguese pages, glossary and sponsor windows | 339 | 0 | 0 |
+| Setup, complete suite after redirecting PNG output | 168 | 0 | 0 |
+| Core, complete suite | 457 | 0 | 3 |
+| CLI, complete suite | 27 | 0 | 1 |
+| Platform, complete suite | 50 | 0 | 3 |
+| App localization/resource/media checks after the final embedded-resource rebuild | 155 | 0 | 0 |
+
+The last row overlaps the 339 cases and is not an additional unique-test count. The broader capture run preceded
+the final media embedding; the 155-case run checked the final rebuilt assemblies with the original test helpers.
+The two explicit media-generation runs also passed and are excluded from the test counts. Platform/dependency
+skips are recorded in the TRX files; no failing test was excluded.
+
+This environment initially refused ImageMagick output in the checkout and PNG creation under the test binaries.
+The first Setup run had 150 passes and 18 screenshot-write failures. Output-only, temporary changes routed the
+existing media generator and App/Setup screenshot helpers to temporary folders; all assertions remained active.
+Those helper changes were restored exactly before the final build and are absent from the commits. Intermediate
+build attempts also encountered locks while Filee/the App runner was open; the final build succeeded after both
+had exited. The final tests do not depend on the temporary output adapters.
+
+Full local `dotnet format` exits 2 with whitespace diagnostics in seventeen files unchanged from `484d6fb`.
+Changed-file formatting and `git diff --check` pass. The new native CI's complete formatter step has passed;
+the local SDK differs from the SDK used by CI, so the local full-format result is not reported as green.
+
+[New CI run 39985961697](https://github.com/Blackspirits/Filee/actions/runs/39985961697) tests `ff7b349`.
+At this update it is still in progress: formatting and both Linux native-dependency jobs have passed.
+The historical nine-job success on `9d357e7` below is not certification of the editorial head.
+
+Local logs, TRX and headless captures are kept in ignored `artifacts/portuguese-phase1/`, including
+`build-final.log`, `Filee.App.Tests.log`, `Filee.App.Tests-final-resources.log`, `Filee.Setup.Tests-retry.log`,
+`headless-app/` and `headless-setup/`. These files are not published to the repository.
+
+### Interactive Windows evidence
+
+Computer Use was checked before UI work. The real Release development app ran in its existing isolated
+`FILEE_DATA_DIR` mode, preserving the user's normal settings and system registrations. OS display language and
+number/date region were both pt-PT; only pt-PT is installed in the session's user language list. The native window
+capture was 1082 × 792 pixels; desktop scale was not independently measured. Automated 1x/2x geometry checks
+are separate evidence and do not establish the native desktop scale.
+
+The initial native launch used the editorial assets matching `91174f2`; the restart used the rebuilt media head
+`ff7b349`. Observed using native UI snapshots/accessibility trees in this session:
+
+- Automatic language opened in pt-PT with `Página inicial` and `Apoiar`.
+- Choosing Português (Brasil) live changed the interface to `Início`, `Patrocinar`, `Ligado` and `Desligado`.
+- Alt+F4 opened the Brazilian close dialog; choosing `Sair` ended the process with exit code 0. Reopening the same
+ profile without `--language` retained pt-BR, including in the General picker. Its saved JSON also contained pt-BR.
+- Opening the picker, pressing Home and Enter returned to automatic and restored pt-PT; saved JSON contained `auto`.
+- Tab/Shift+Tab showed visible focus and scrolled a General-page action into view. A Down arrow in the preset list
+ selected JPG and updated the editor. The native tree exposed the localized `Duplicar` and `Eliminar` button names.
+- The real `Apoiar o Filee` window displayed the new title and complete support rows; About also displayed `Apoiar`.
+ The native slideshow opened with its Portuguese title, caption and `Seguinte` action.
+- The isolated native `--quit` command completed with exit code 0.
+
+These native captures are distinct from the Skia PNG files. Modal keyboard checks could not be completed reliably:
+the helper enumerated the owner window and key input refocused that owner, so Right in the slideshow and Escape in
+the close dialog are not certified. No screen-reader result is inferred from an accessibility tree. No claim is made
+for a pt-BR Windows display session, a mismatched native numeric region, real installation/update/uninstall,
+Explorer registration, UAC, macOS/Finder, permissions, NVDA or VoiceOver. W1 and A1 therefore remain only partial.
+The full remaining checklist below still gates leaving draft status.
+
+## Native test evidence (historical CI)
The numbers below are passing tests, taken from each job's final test summaries. No cross-platform sum is
presented as a unique-test count. Platform/dependency skips remain visible in the linked logs; the portable
@@ -67,16 +154,17 @@ VoiceOver or the system's permission prompts.
## Remaining interactive checks
-These cases are **pending**, not failed and not claimed as tested. Record the tested commit, OS/version,
+These cases remain open. W1 and A1 have only the partial evidence recorded above; no row is fully certified.
+Record the tested commit, OS/version,
display language, regional format, scale, result and evidence for each language.
| ID | Environment and action | Expected result | Status |
| --- | --- | --- | --- |
-| W1 | Windows with pt-PT display language: start with automatic language, choose pt-BR manually, quit and restart; return to automatic. Repeat with the two display languages exchanged. | Automatic follows the OS display language; a saved explicit variant survives restart; returning to automatic selects the OS variant again. | Pending |
-| W2 | Repeat each Portuguese UI with a different number/date region; edit a fractional playback value and save/reopen the preset. | Display uses the selected regional separator and the saved numeric value is unchanged. | Pending |
-| W3 | Install the real app in each variant, launch it, update and uninstall; exercise per-user/system installation and an optional engine. | Installer text stays in the chosen variant, the launched app receives the explicit choice, and UAC/Explorer integration behaves normally. | Pending |
-| M1 | macOS with each Portuguese preferred language: launch from Finder and use the conversion service and the normal permissions flow. | Finder's service title and permission explanations use the OS-selected Portuguese variant; the app's automatic language and numeric region remain correct. | Pending |
-| A1 | Navigate the language picker, preset editor, close dialog and slideshow using Tab/Shift+Tab, arrows, Enter and Escape; repeat with NVDA on Windows and VoiceOver on macOS. | All actions are reachable, focus remains visible, names/roles identify their purpose, and no dialog traps focus. | Pending |
+| W1 | Windows with pt-PT display language: start with automatic language, choose pt-BR manually, quit and restart; return to automatic. Repeat with the two display languages exchanged. | Automatic follows the OS display language; a saved explicit variant survives restart; returning to automatic selects the OS variant again. | Partial: pt-PT session → explicit pt-BR → full restart → automatic passed; reverse OS-language session pending. |
+| W2 | Repeat each Portuguese UI with a different number/date region; edit a fractional playback value and save/reopen the preset. | Display uses the selected regional separator and the saved numeric value is unchanged. | Pending: native session uses matching pt-PT region; mismatched regions are covered only automatically. |
+| W3 | Install the real app in each variant, launch it, update and uninstall; exercise per-user/system installation and an optional engine. | Installer text stays in the chosen variant, the launched app receives the explicit choice, and UAC/Explorer integration behaves normally. | Pending: development copy was isolated; real release installation, Explorer and UAC were not exercised. |
+| M1 | macOS with each Portuguese preferred language: launch from Finder and use the conversion service and the normal permissions flow. | Finder's service title and permission explanations use the OS-selected Portuguese variant; the app's automatic language and numeric region remain correct. | Pending: no macOS interactive host in this session. |
+| A1 | Navigate the language picker, preset editor, close dialog and slideshow using Tab/Shift+Tab, arrows, Enter and Escape; repeat with NVDA on Windows and VoiceOver on macOS. | All actions are reachable, focus remains visible, names/roles identify their purpose, and no dialog traps focus. | Partial native picker/preset/focus evidence; modal keyboard helper limitation, NVDA and VoiceOver remain open. |
Do not infer these results from successful headless tests. Keep the localization PR in draft until this final
interactive verification is recorded. No merge, upstream PR or Phase 2 code changes are included in this update.
diff --git a/docs/PORTUGUESE-REVIEW-FOLLOWUP.md b/docs/PORTUGUESE-REVIEW-FOLLOWUP.md
index 016e31b4..cb2defac 100644
--- a/docs/PORTUGUESE-REVIEW-FOLLOWUP.md
+++ b/docs/PORTUGUESE-REVIEW-FOLLOWUP.md
@@ -82,6 +82,59 @@ and keyboard/NVDA/VoiceOver checks remain required. Complete native CI has since
[native validation report](PORTUGUESE-NATIVE-VALIDATION.md) records the evidence and interactive checklist.
The PR stays a draft pending those interactive checks.
+## Approved Phase 1 follow-up — 23 October 2026
+
+The remote contribution branch was confirmed at `484d6fb`, then advanced by the small editorial commit
+`91174f2` and generated-media commit `ff7b349`. Only pt-PT's sponsor action/title changed to `Apoiar` /
+`Apoiar o Filee`. `Página inicial`, `patrocinadores`, all 911 keys, variables and formatting remain intact;
+pt-BR and the other JSON catalogs are unchanged. The glossary has five additional existing-fixture cases and
+the sponsor-window render fixture now includes both Portuguese variants.
+
+[The updated native report](PORTUGUESE-NATIVE-VALIDATION.md#editorial-follow-up--23-october-2026) records the
+339 focused App passes, 168 Setup passes after repairing the environment's screenshot output, full Core/CLI/Platform
+results and the separate 155-case check after the final resource rebuild. It distinguishes transient output adapters
+from committed code, and local full-format diagnostics from the successful formatter step in the new native CI.
+
+The real isolated Windows app passed the pt-PT automatic → explicit pt-BR → full exit/restart → automatic sequence.
+Selected native focus/preset keyboard checks and the new support title were observed. Reverse OS-language,
+mismatched native numeric region, modal keyboard, real release installation/UAC/Explorer, macOS/Finder/permissions
+and NVDA/VoiceOver checks remain open. The PR stays a draft and Phase 2 has not started.
+
+Commands used for this follow-up (PowerShell, Release):
+
+```powershell
+dotnet restore Filee.slnx --disable-parallel
+./build/fetch-fonts.ps1
+dotnet build Filee.slnx -m:1 -c Release --no-restore
+dotnet format Filee.slnx --verify-no-changes --no-restore --severity warn
+dotnet format Filee.slnx --verify-no-changes --no-restore --severity warn --include tests/Filee.App.Tests/PortugueseLocalizationTests.cs tests/Filee.App.Tests/RenderTests.cs
+
+$env:FILEE_WHATSNEW_LANGUAGE = 'pt-PT'
+$env:FILEE_WHATSNEW_ONLY = 'theme,more'
+./tests/Filee.App.Tests/bin/Release/net10.0/Filee.App.Tests.exe -method Filee.App.Tests.WhatsNewMedia.Generate_2_0_0 -explicit only
+$env:FILEE_WHATSNEW_LANGUAGE = 'en'
+$env:FILEE_WHATSNEW_ONLY = 'languages'
+./tests/Filee.App.Tests/bin/Release/net10.0/Filee.App.Tests.exe -method Filee.App.Tests.WhatsNewMedia.Generate_2_0_0 -explicit only
+
+$env:FILEE_LOCALIZATION_SCREENSHOTS = '1'
+$appFilter = 'FullyQualifiedName~Localization|FullyQualifiedName~Portuguese|FullyQualifiedName~DonutLabelPlacement|FullyQualifiedName~ToolbarEditorTests|FullyQualifiedName~WhatsNewTests|FullyQualifiedName~InstallerTests|FullyQualifiedName~SupportersTests|FullyQualifiedName~ReleaseNotesTests|FullyQualifiedName~Live_photo_options_render_for_jpg_and_heic_and_save_only_there|FullyQualifiedName~Sponsor_window_renders'
+dotnet test tests/Filee.App.Tests -c Release --no-build --no-restore --filter $appFilter --logger trx
+dotnet test tests/Filee.Setup.Tests -c Release --no-build --no-restore --logger trx
+dotnet test tests/Filee.Core.Tests -c Release --no-build --no-restore --logger trx
+dotnet test tests/Filee.Cli.Tests -c Release --no-build --no-restore --logger trx
+dotnet test tests/Filee.Platform.Tests -c Release --no-build --no-restore --logger trx
+
+# After restoring the original helpers and rebuilding all embedded assets:
+dotnet build Filee.slnx -m:1 -c Release --no-restore
+$resourceFilter = 'FullyQualifiedName~Localization|FullyQualifiedName~The_2_0_0_deck_ships_with_its_media_and_texts|FullyQualifiedName~Slide_media_stay_small|FullyQualifiedName~Portuguese_recordings_preserve_the_desktop_context_and_localize_the_other_slides|FullyQualifiedName~Changing_language_refreshes_the_current_recording_without_resetting_the_slide'
+dotnet test tests/Filee.App.Tests -c Release --no-build --no-restore --filter $resourceFilter --logger trx
+```
+
+The successful media/capture commands used temporary output-folder adapters as documented in the native report;
+those adapters are not repository features or committed changes. The local logs retain failed attempts as well as
+final successes. Local commits were created without SSH signatures because the configured signing key required an
+unavailable passphrase; the user's signing configuration was not changed.
+
## References
- [Apple pt-PT automation permissions](https://support.apple.com/pt-pt/guide/mac-help/mchl108e1718/mac)