Skip to content

feat(localizations): complete uk-UA (Ukrainian) translations - #9344

Open
ex-vi wants to merge 2 commits into
clerk:mainfrom
ex-vi:feat/localizations-uk-ua-complete
Open

feat(localizations): complete uk-UA (Ukrainian) translations#9344
ex-vi wants to merge 2 commits into
clerk:mainfrom
ex-vi:feat/localizations-uk-ua-complete

Conversation

@ex-vi

@ex-vi ex-vi commented Aug 5, 2026

Copy link
Copy Markdown

Description

Completes the Ukrainian (uk-UA) localization: fills all 825 keys that were undefined in uk-UA.ts, bringing it to full parity with en-US.ts (1433/1433 keys). The only values left undefined are those that are undefined in en-US itself (server-fallback unstable__errors entries and signIn.start.subtitleCombined), so Clerk's fallback behavior is preserved.

Covered areas: configureSSO (full wizard, incl. Okta / Entra / Google / custom OIDC+SAML steps), billing (checkout, subscription details, pricing table, payment methods), organizationProfile (billing + security pages), userProfile (billing page), unstable__errors, reverification, taskSetupMfa, taskResetPassword, apiKeys, signIn / signUp, oauthConsent, and the remaining top-level keys.

Conventions used:

  • Terminology and tone follow the pre-existing uk-UA translations (formal «ви»), 2019 Ukrainian orthography («автентифікація»).
  • All {{placeholders}} and markup are preserved verbatim, verified per key against en-US.
  • Third-party admin-console labels (Okta/Entra/Google UI steps) and technical IdP field names (Entity ID, SSO URL, Audience URI…) stay in English, matching what users see in those dashboards.
  • Date-filter locale arguments use 'uk-UA', following the cs-CZ / pl-PL precedent.
  • No previously-translated values are changed; key order is untouched.
  • Seat-breakdown strings avoid inflecting the noun after a variable count. Ukrainian uses one form for 2-4 and another for 5+, and a single plural key cannot serve both.

pnpm --filter @clerk/localizations generate is idempotent on this branch, and the community-contribution disclaimer comment is intact.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments — n/a
  • (If applicable) Documentation — n/a

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation

@changeset-bot

changeset-bot Bot commented Aug 5, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: aba4f07

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 4 packages
Name Type
@clerk/localizations Patch
@clerk/ui Patch
@clerk/chrome-extension Patch
@clerk/swingset Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel

vercel Bot commented Aug 5, 2026

Copy link
Copy Markdown

@ex-vi is attempting to deploy a commit to the Clerk Production Team on Vercel.

A member of the Team first needs to authorize it.

@ex-vi
ex-vi marked this pull request as ready for review August 5, 2026 21:47
@coderabbitai

coderabbitai Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

Completes Ukrainian translations in packages/localizations/src/uk-UA.ts across administrative, authentication, billing, organization, profile, security, passkey, Web3-wallet, and error-message areas. Existing English strings remain unchanged. Adds a patch Changeset for @clerk/localizations.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

Suggested reviewers: laurabeatris, alexcarpenter, nicolaslopes7

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly and concisely describes the completion of Ukrainian localization translations.
Description check ✅ Passed The description directly explains the Ukrainian localization changes, covered areas, validation, and preserved fallback behavior.
✨ Finishing Touches 💡 1
🛠️ Fix failing CI checks 💡
  • Create stacked PR
  • Commit on current branch

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@packages/localizations/src/uk-UA.ts`:
- Line 896: Update the footerActionLink__alternativePhoneCodeProvider
translation to explicitly convey “instead” by using the specified Ukrainian
wording, and validate it against the current en-US base localization entry.
- Around line 184-187: Update the Ukrainian seatBreakdownIncludedPlural and
seatBreakdownPlural translations to avoid inflecting “місце” based on the
variable chargeable count, using wording that is grammatically valid for both
2–4 and 5+ seats while preserving the existing rate and total/included context.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: e5a8041c-f37a-4f25-ac42-1ab55ee60ce5

📥 Commits

Reviewing files that changed from the base of the PR and between f38cf02 and 892d3c0.

📒 Files selected for processing (2)
  • .changeset/uk-ua-complete-translations.md
  • packages/localizations/src/uk-UA.ts
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go (manual)
  • clerk/dashboard (manual)
  • clerk/accounts (manual)
  • clerk/backoffice (manual)
  • clerk/clerk (manual)
  • clerk/clerk-docs (manual)
  • clerk/cloudflare-workers (manual)

Comment thread packages/localizations/src/uk-UA.ts Outdated
Comment thread packages/localizations/src/uk-UA.ts Outdated
…instead sense

Ukrainian inflects the noun after a number: 2-4 takes one form and 5+
takes another. One plural key cannot serve both, so the seat breakdown
now uses a count and a rate without the noun.

Five action links dropped the word instead from the base string. They
now keep that sense.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant