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.
C# audio-converteravaloniabatch-conversionconvertercsharpdocument-converterdocx-to-pdfdotnetdrag-and-dropfile-conversionfile-converterheic-converterhwphwpximage-converterlinuxmacospdf-convertervideo-converterwindows
docs(i18n): record integrated Phase 1 validation and submission limits
Blackspirits6ddc1c1a5474
diff --git a/docs/PORTUGUESE-LOCALIZATION.md b/docs/PORTUGUESE-LOCALIZATION.mdindex ed8a72db..ddd00af8 100644--- a/docs/PORTUGUESE-LOCALIZATION.md+++ b/docs/PORTUGUESE-LOCALIZATION.md@@ -1,20 +1,21 @@# Portuguese localizationPhase 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 retainEnglish 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 aloneis 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 rignored. 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 theacknowledgement `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 theshared 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) separateslocal 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 dispositionof 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 thevalidated 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 witha different number/date region.diff --git a/docs/PORTUGUESE-NATIVE-VALIDATION.md b/docs/PORTUGUESE-NATIVE-VALIDATION.mdindex 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 Blackspall nine jobs passed. This closes the previously pending automated CI and full-formatter checks. It does notcertify 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 fhad 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 Rithe close dialog are not certified. No screen-reader result is inferred from an accessibility tree. No claim is madefor 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.mdindex 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 "FullyQualifiedNameInspected fresh Skia captures include pt-PT and French default toolbars, Portuguese theme/history recordings, andthe corrected complete action buttons and compact preview labels. The automated suite additionally captures thePortuguese 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 formaThe 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 logsfinal successes. Local commits were created without SSH signatures because the configured signing key required anunavailable 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)