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 integrated Phase 1 validation and submission limits

Blackspirits6ddc1c1a5474
diff --git a/docs/PORTUGUESE-LOCALIZATION.md b/docs/PORTUGUESE-LOCALIZATION.md
index ed8a72db..ddd00af8 100644
--- a/docs/PORTUGUESE-LOCALIZATION.md
+++ b/docs/PORTUGUESE-LOCALIZATION.md
@@ -1,20 +1,21 @@
# Portuguese localization
Phase 1 adds European Portuguese and refines regional integration with the Brazilian translation already merged
-in #322. The current baseline is upstream `a121a3c9e3254918f8b171bb7f675b0bdc532244` (22 October 2026).
-French, Traditional Chinese, Nepali, KWin, caption wrapping and the other merged upstream fixes are retained.
+in #322. The current baseline is upstream `4c3a3e1cbedec48c3033c68fd0da161977e7afdf` (23 October 2026).
+French, Traditional Chinese, Nepali, Thai, Material You, OCR, palette tabs and the other merged upstream changes
+are retained.
Phase 2 has not started.
## Coverage and wording
-Both Portuguese catalogs contain all **911 English keys**, in English key order: 889 existing entries,
+Both Portuguese catalogs contain all **978 English keys**, in English key order: 956 upstream entries,
18 descriptive engine names and four compact donut labels. Three native macOS strings per variant are additional
-to those JSON entries. There are fourteen registered languages. The eleven non-Portuguese translations retain
+to those JSON entries. There are fifteen registered languages. The twelve non-Portuguese translations retain
English for the new engine names pending maintainer review; compact labels reuse their existing full translations.
This preserves their earlier metadata-based display rather than claiming unreviewed native translations.
European Portuguese follows AO90 and informal `tu`. Brazilian Portuguese preserves the community wording from
-#322; only seven of its 889 existing entries change, correcting count agreement and an ambiguous pointer reference.
+#322; only seven existing upstream entries change, correcting count agreement and an ambiguous pointer reference.
Earlier broad Brazilian editorial changes are superseded. Valid Brazilian wording includes `no Dock`, `Gravar`,
`Redefinir` versus `Restaurar`, `Relatar`, `E-books`, `Ligado` and curly quotes. Similarity between variants alone
is not evidence of an error.
@@ -35,14 +36,15 @@ is not evidence of an error.
| Home | Página inicial | Início |
| Sponsor action | Apoiar | Patrocinar |
| Sponsor dialog | Apoiar o Filee | Patrocinar o Filee |
-| Supporter acknowledgements | patrocinadores | patrocinadores |
+| Supporter acknowledgements | Obrigado a quem apoia o Filee | Obrigado aos nossos patrocinadores |
| Percent | Percentagem | Porcentagem |
| Mixed files | Ficheiros mistos | Arquivos mistos |
Glossary checks are contextual: `arquivo` is appropriate pt-PT when describing PDF/A archiving, for example.
Tests preserve placeholder multiplicity, numeric format specifiers, newlines and NFC. Actual folder names,
regexes, replacement references and command switches stay unchanged. Quotation style and descriptions such as
-`<pasta>` in command examples are translatable; `filee watch` and `--to` are literal syntax.
+`<pasta>` in command examples are translatable; `filee watch` and `--to` are literal syntax. For this contribution,
+the approved CLI hint keeps `<folder>` and `<format>` unchanged.
## Language and region policy
@@ -103,27 +105,48 @@ 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
+## Earlier 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
+The [earlier 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.
+the historical successful run below must not be treated as validation of the new head. The earlier head remained
+a draft. See the current integration report for readiness.
+
+## Current integration and approved final wording — 23 October 2026
+
+Merge `47616f7` integrates upstream `4c3a3e1` without rewriting published history. All seventeen conflicts are
+resolved; the current upstream translations are retained key by key. pt-PT gains 67 translations and updates the
+three messages whose English sources changed. Thai receives the same 22 contribution-specific fallback/compact
+keys as the other catalogs; its upstream translations are preserved.
+
+The contributor approved `Obrigado a quem apoia o Filee` for `sponsor.thanks` and a clearer `merge.order_hint`
+explaining that files are combined from top to bottom. `about.sponsor` / `sponsor.title` remain `Apoiar` /
+`Apoiar o Filee`, and Home remains `Página inicial`. The glossary case follows the new acknowledgement. pt-BR has
+no new editorial rewrite. The eight Portuguese recordings and shared language showcase are regenerated against
+the integrated UI, and App/Setup resources are rebuilt afterwards.
+
+The [latest validation report](PORTUGUESE-NATIVE-VALIDATION.md#current-upstream-integration--23-october-2026)
+records the current tests, real Windows interaction and the earlier CI timing failure that is fixed separately.
+The unavailable OS-language, installation/UAC, Finder/permission and screen-reader sessions remain disclosed
+follow-ups for maintainer review. At the contributor's request they do not indefinitely prevent submission of
+Phase 1; the release-package manual matrix in CONTRIBUTING.md is separate from an ordinary translation PR.
+Draft status remains appropriate while current automated checks or concrete integration defects are unresolved.
## Validation and remaining checks
[Independent-review follow-up](PORTUGUESE-REVIEW-FOLLOWUP.md) records current commands, results and the disposition
of each finding. Earlier test counts describe previous snapshots and must not be used as certification of this head.
Set FILEE_LOCALIZATION_SCREENSHOTS=1 for PNG captures in PortugueseRenderTests; geometry assertions always run.
-All fifteen pinned Noto font files are used for the visual checks.
+All eighteen pinned Noto font files, including the new upstream Thai fonts, are used for the visual checks.
[Native CI validation](PORTUGUESE-NATIVE-VALIDATION.md) records run 39800321618: all nine jobs passed on the
validated code commit 9d357e7, including full formatting, the Windows installer suite, portable packages and
-native startup checks. The following interactive checks remain open; the PR stays a draft until they are recorded:
+native startup checks. The following interactive checks remain open and must not be reported as passed:
- Windows pt-PT/pt-BR display language with automatic selection, explicit opposite choice and restart; repeat with
a different number/date region.
diff --git a/docs/PORTUGUESE-NATIVE-VALIDATION.md b/docs/PORTUGUESE-NATIVE-VALIDATION.md
index 504ba341..98774d22 100644
--- a/docs/PORTUGUESE-NATIVE-VALIDATION.md
+++ b/docs/PORTUGUESE-NATIVE-VALIDATION.md
@@ -8,9 +8,87 @@ 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.
+## Current upstream integration — 23 October 2026
+
+UI/media snapshot: `c59c394`; catalog layout preservation: `4fefecf`. The final acknowledgement fixture is
+validated separately below; later report-only edits do not change production code or resources.
+Upstream `main` was checked again at `4c3a3e1cbedec48c3033c68fd0da161977e7afdf` before publication; the fork's
+remote contribution head was `987c03f`, and its main remained `a121a3c`. Published history was preserved by merge
+`47616f7`; all seventeen conflicts are resolved. Each of the fifteen catalogs has 978 keys. pt-PT adds 67 new
+upstream strings, updates three changed source messages and applies the two approved editorial suggestions.
+`<folder>` / `<format>` remain unchanged. pt-BR retains all newer upstream translations and the seven existing
+contribution corrections; no further Brazilian editorial changes were introduced.
+
+The previous [CI run 39987984354](https://github.com/Blackspirits/Filee/actions/runs/39987984354) passed formatting,
+build and the App suite, but its Windows job failed one Setup assertion: zh-CN expected browser.webp and saw
+flip.webp after the six-second slide timer elapsed. Commit `fea4fa0` freezes automatic advance and selects slide
+zero before checking its localized media. The assertion is retained, and the separate automatic-advance test
+still checks the six-second interval and slide sequence. That old run is not an all-green result. Current CI
+must be read from this fork PR's Checks tab for the published head, not inferred from historical runs.
+
+### Current automatic checks
+
+Windows x64 build 26300.9711, SDK 10.0.204/runtime 10.0.8, eighteen pinned SHA-256-verified Noto fonts.
+The checkout refused compiler XML output and the native app's temporary settings write. A faithful copy of the
+current branch's tracked files and fonts in the host temporary directory was therefore used for builds, tests,
+media generation and the isolated app profile. No security settings, assertions or output helpers were modified.
+App/Setup were rebuilt after the nine clips and manifest were regenerated. The final incremental Release build
+has zero errors and five existing obsolete-API warnings (the initial clean build reported thirteen warnings).
+The temporary sources and final resources are compared byte-for-byte with the contribution before publication.
+The six later catalog-format edits preserve values exactly and restore each upstream language's own layout/order;
+App/Setup were rebuilt again, then the 162 affected resource checks passed.
+
+| Check | Passed | Failed | Skipped |
+| --- | ---: | ---: | ---: |
+| Focused App localization/layout/theme/palette/slideshow contracts | 373 | 0 | 0 |
+| Additional supporter acknowledgement renders (en / pt-PT / pt-BR) | 3 | 0 | 0 |
+| Complete Setup suite after final resource embedding | 170 | 0 | 0 |
+| Complete Core suite | 532 | 0 | 3 |
+| Complete CLI suite | 27 | 0 | 1 |
+| Complete Platform suite | 60 | 0 | 5 |
+
+The 373-case App run took 8 minutes 29 seconds. The three additional supporter cases assert that the title
+fits in both the support window and About with fixture data, and save separate Portuguese captures. A final
+162-case localization/resource/media run passed after preserving per-language catalog whitespace/order and
+rebuilding; it overlaps the 373 cases and is not counted again. The preliminary 152 localization passes also
+overlap the final App selection. Setup also
+passed all 170 cases before the final media rebuild; only the final run is counted above. All three explicit
+media-generation runs passed and are excluded from the test total. Platform/dependency skips remain visible in
+TRX. This is a focused App selection, not a local full-solution test result; the Engines suite is delegated to CI.
+Changed-file formatting (including the acknowledgement fixture) and `git diff --check` pass. Full local formatting exits 2 with whitespace diagnostics in
+seventeen files under SDK 10.0.204; fifteen are byte-for-byte upstream files, and the diagnosed lines in the two
+localization files are also unchanged upstream text. The current CI formatter remains the separate check.
+
+### Current captures and interaction
+
+All fifteen shared/Portuguese WebP files decode with valid poster indices. The nine regenerated clips are
+768 × 432; browser/flip retain their complete shared 640 × 360 desktop recordings. The full media set totals
+3,882,212 bytes; every file is below 400 KiB, each pack below 2 MiB and the total below 6 MiB. Both theme posters
+are frame 24. The shared language showcase contains all fifteen registered languages. Headless PNGs and decoded
+posters are separate from native Computer Use snapshots.
+
+Native Computer Use was available and used with the isolated development profile. The current integrated app
+opened automatically in pt-PT, displayed `Apoiar o Filee`, the new Theme descriptions/pastel names and complete
+palette tabs/actions. Choosing pt-BR live, Alt+F4 → `Sair`, full process exit 0 and restart without a language
+argument retained pt-BR; the General picker and saved JSON agreed. Home/Enter in the picker restored automatic
+pt-PT, and JSON contained `auto`. The final isolated `--quit` also exited 0. The restart used the rebuilt final
+resources. The acknowledgement is conditional on supporter data and was not visible in this isolated native
+session; its wording is verified by glossary and headless supporter fixtures.
+
+The OS session still has pt-PT display and numeric region; native scale was not independently measured. The older
+Tab/Shift+Tab/preset-arrow evidence below remains historical, while picker Home/Enter was repeated now. No reverse
+pt-BR OS session, mismatched native numeric region, real install/update/uninstall, Explorer/UAC, macOS Finder,
+permissions, NVDA or VoiceOver result is claimed. Modal keyboard limitations of the helper remain disclosed.
+Per the contributor's decision, unavailable sessions are follow-ups for maintainer review, rather than an
+indefinite submission gate. Keep draft while current automated checks or concrete integration defects remain.
+Phase 2 has not started, no PR has been merged and no code has been pushed to the original repository.
+
+Logs/TRX/PNG files are retained under the temporary build root recorded in ignored
+`artifacts/portuguese-phase1/merged-build-root.txt`; copied evidence is kept in `artifacts/portuguese-phase1/`.
+
## Editorial follow-up — 23 October 2026
-Current application/resource commit: `ff7b349e79e95edf6f97c2223408b70667a91553`.
+Earlier 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.
@@ -55,7 +133,7 @@ build attempts also encountered locks while Filee/the App runner was open; the f
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;
+Changed-file formatting (including the acknowledgement fixture) 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`.
@@ -93,7 +171,7 @@ the helper enumerated the owner window and key input refocused that owner, so Ri
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.
+These limitations remain disclosed; the current submission policy is recorded above.
## Native test evidence (historical CI)
@@ -166,6 +244,7 @@ display language, regional format, scale, result and evidence for each language.
| 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.
+Do not infer these results from successful headless tests. Unavailable native sessions are documented follow-ups
+for maintainer review; they do not certify a release-package manual matrix. No upstream write or Phase 2 code
+changes are included in this update.
Portuguese browser/flip desktop recordings remain an explicitly documented media follow-up.
diff --git a/docs/PORTUGUESE-REVIEW-FOLLOWUP.md b/docs/PORTUGUESE-REVIEW-FOLLOWUP.md
index cb2defac..a82bd60e 100644
--- a/docs/PORTUGUESE-REVIEW-FOLLOWUP.md
+++ b/docs/PORTUGUESE-REVIEW-FOLLOWUP.md
@@ -1,7 +1,8 @@
# Independent Portuguese review: follow-up
-The independent review examined b694dad, based on Filee 2.0.0 at 799e394. This follow-up integrates current upstream
-a121a3c9e3254918f8b171bb7f675b0bdc532244, verified on 22 October 2026. Only Blackspirits/Filee is changed.
+The independent review examined b694dad, based on Filee 2.0.0 at 799e394. The first follow-up integrated upstream
+a121a3c9e3254918f8b171bb7f675b0bdc532244 on 22 October. The current integration is
+4c3a3e1cbedec48c3033c68fd0da161977e7afdf, verified on 23 October 2026. Only Blackspirits/Filee is changed.
## Findings and responses
@@ -78,9 +79,9 @@ dotnet test tests/Filee.Setup.Tests -m:1 -c Release --filter "FullyQualifiedName
Inspected fresh Skia captures include pt-PT and French default toolbars, Portuguese theme/history recordings, and
the corrected complete action buttons and compact preview labels. The automated suite additionally captures the
Portuguese pages/dialogs and installer states. Real installation/UAC, Finder and permission-prompt display,
-and keyboard/NVDA/VoiceOver checks remain required. Complete native CI has since passed all nine jobs; the
+and keyboard/NVDA/VoiceOver checks remained open at that snapshot. Historical native CI passed all nine jobs; the
[native validation report](PORTUGUESE-NATIVE-VALIDATION.md) records the evidence and interactive checklist.
-The PR stays a draft pending those interactive checks.
+That historical head stayed a draft; current readiness and native limitations are recorded below.
## Approved Phase 1 follow-up — 23 October 2026
@@ -98,7 +99,7 @@ from committed code, and local full-format diagnostics from the successful forma
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.
+and NVDA/VoiceOver checks remained open. That earlier head stayed a draft; current readiness is recorded below.
Commands used for this follow-up (PowerShell, Release):
@@ -135,6 +136,54 @@ those adapters are not repository features or committed changes. The local logs
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.
+## Current upstream integration and final review — 23 October 2026
+
+The remote was checked before editing and again before publication. Merge `47616f7` brings upstream `4c3a3e1`
+into the contribution without resetting or rewriting published history. Seventeen merge conflicts were resolved;
+there were no competing value changes in the three-way JSON merge. Material You, OCR, palette tabs, Thai and all
+other upstream changes are retained. All fifteen catalogs have 978 keys; the 67 missing pt-PT translations and
+three changed-source messages are complete. Upstream Brazilian wording is retained key by key. Catalog section
+spacing is preserved. Thai receives English engine-name fallbacks and its own existing full compact-label values,
+following the existing contribution policy; no new native-language review is claimed for it.
+
+Approved final pt-PT edits: `sponsor.thanks` is `Obrigado a quem apoia o Filee`; `merge.order_hint` explains that
+files are combined from the top of the list to the bottom. The CLI hint keeps `<folder>` and `<format>` at the
+contributor's request; they are argument descriptions, while `filee watch` / `--to` remain literal syntax.
+`Página inicial`, `Apoiar` and `Apoiar o Filee` remain. The contextual glossary follows the approved acknowledgement.
+
+Commit `fea4fa0` fixes the old CI's Setup slide-timer race without changing production behavior or dropping an
+assertion. The media commit regenerates all eight Portuguese clips and the shared multilingual showcase; complete
+browser/flip desktop recordings remain. Both App and Setup embed the regenerated files after the final build. The existing supporter render fixture
+also covers en, pt-PT and pt-BR and asserts that the acknowledgement fits in both windows.
+
+See the [current native report](PORTUGUESE-NATIVE-VALIDATION.md#current-upstream-integration--23-october-2026)
+for final counts, the temporary build-copy workaround and separate headless/native evidence. The contributor has
+accepted unavailable native sessions as explicit follow-ups for maintainer review. The full port-package release
+matrix in CONTRIBUTING.md is not an indefinite gate for submitting this translation PR. Actual current CI and
+concrete integration failures still gate readiness. The fork PR remains the coordination point; no upstream code
+write, PR merge or Phase 2 work is included.
+
+Commands for the integrated snapshot (run from the temporary copy when checkout output is refused):
+
+```powershell
+./build/fetch-fonts.ps1
+dotnet restore Filee.slnx --disable-parallel
+dotnet build Filee.slnx -m:1 -c Release --no-restore -p:UseSharedCompilation=false
+# FILEE_WHATSNEW_LANGUAGE=pt-PT, then pt-BR; FILEE_WHATSNEW_ONLY=formats,crop,theme,more
+# Then en with FILEE_WHATSNEW_ONLY=languages. Rebuild App/Setup afterwards.
+./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~ToolbarPaletteViewTests|FullyQualifiedName~ThemePageTests|FullyQualifiedName~MaterialYouThemeTests|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 --filter $appFilter --logger trx
+dotnet test tests/Filee.Setup.Tests -c Release --no-build --logger trx
+dotnet test tests/Filee.Core.Tests -c Release --no-build --logger trx
+dotnet test tests/Filee.Cli.Tests -c Release --no-build --logger trx
+dotnet test tests/Filee.Platform.Tests -c Release --no-build --logger trx
+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.Setup.Tests/SetupWindowTests.cs tests/Filee.App.Tests/RenderTests.cs
+git diff --check
+```
+
## References
- [Apple pt-PT automation permissions](https://support.apple.com/pt-pt/guide/mac-help/mchl108e1718/mac)