feat(localizations, shared, clerk-js): Add missing username form error localization key

[guilherme6191]

Description

https://linear.app/clerk/issue/USER-4094/missing-localization-key-for-username-must-contain-one-non-number

This api error was not included in the localization keys for overriding.

• Left undefined in en-US since it'll fallback to the english message from the API.
• Took the chance and added a ptBR translation.

Checklist

• pnpm test runs as expected.
• pnpm build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated

Type of change

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

Summary by CodeRabbit

• New Features

  • Username validation now requires at least one non-numeric character.

• Localization

  • Added a new username error message key across many locales (English, pt-BR and numerous others) to surface the new message.

• Chores

  • Bumped package versions to publish the updated localization key.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 3bee34a

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

This PR includes changesets to release 22 packages

Name	Type
@clerk/localizations	Patch
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/clerk-react	Patch
@clerk/chrome-extension	Patch
@clerk/clerk-expo	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/elements	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/remix	Patch
@clerk/tanstack-react-start	Patch
@clerk/testing	Patch
@clerk/themes	Patch
@clerk/types	Patch
@clerk/vue	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]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
clerk-js-sandbox	Ready	Preview	Comment	Nov 26, 2025 5:46pm

[coderabbitai]

Walkthrough

Adds a new username validation error code NEEDS_NON_NUMBER_CHAR, maps it to the localization key unstable__errors.form_username_needs_non_number_char in username utilities, extends localization types, and populates that key across localization resources plus a changeset.

Changes

Cohort / File(s)	Summary
Core validation logic packages/clerk-js/src/ui/utils/usernameUtils.ts	Introduces NEEDS_NON_NUMBER_CHAR error code and maps it in createUsernameError to unstable__errors.form_username_needs_non_number_char.
Type definitions packages/shared/src/types/localization.ts	Adds form_username_needs_non_number_char: LocalizationValue to UnstableErrors type.
Primary locale entries packages/localizations/src/en-US.ts, packages/localizations/src/pt-BR.ts	Adds concrete translations for unstable__errors.form_username_needs_non_number_char (English and Portuguese).
Other locale resources packages/localizations/src/*.ts (e.g., ar-SA.ts, bg-BG.ts, de-DE.ts, fr-FR.ts, ja-JP.ts, zh-CN.ts, ... )	Adds the new form_username_needs_non_number_char key to many locale files (placed under unstable__errors or apiKeys as appropriate), often as translated strings or placeholders.
Changeset .changeset/nasty-sloths-stare.md	Adds changeset bumping patch versions for affected packages with note about the new localization key.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant UI as UI (username input)
participant Validator as UsernameValidator
participant I18n as LocalizationService
participant User as End user
UI->>Validator: submit username
alt invalid length
Validator-->>UI: error code INVALID_LENGTH
else needs non-number char
Validator-->>UI: error code NEEDS_NON_NUMBER_CHAR
else invalid characters
Validator-->>UI: error code INVALID_CHARACTER
else valid
Validator-->>UI: success
end
Note over UI,I18n: UI maps validator code to i18n key
UI->>I18n: lookup unstable__errors.form_username_needs_non_number_char (or other key)
I18n-->>UI: localized message (or undefined fallback)
UI-->>User: display message / success

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Pay attention to:
  • packages/clerk-js/src/ui/utils/usernameUtils.ts — confirm correct error-code constant name and no regressions in existing branches.
  • packages/shared/src/types/localization.ts — ensure added type aligns with export shape and build passes.
  • Spot-check a sample of locale files (e.g., en-US.ts, pt-BR.ts, zh-CN.ts) to verify key placement (unstable__errors vs apiKeys) and string correctness.

Poem

🐰
I nudged a tiny key in place,
One non-number saves the race,
Translations bloom from near to far,
Validator nods — names raise the bar,
A crunchy carrot for the chase! 🥕

Pre-merge checks and finishing touches

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title accurately describes the main change: adding a missing username form error localization key across multiple packages.
Linked Issues check	✅ Passed	The PR implementation meets all acceptance criteria from USER-4094: the localization key is available for overrides via the localization system, type definitions have been updated to support the new key, and the key is implemented across all localization files.
Out of Scope Changes check	✅ Passed	All changes are directly related to adding the missing localization key. The PR includes the error handling in clerk-js, type definitions in shared, localization entries across all language files, and a changeset file—all aligned with the stated objectives.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch guilherme/localization-add-username-validation-key

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pkg-pr-new]

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7320

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@7320

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@7320

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@7320

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@7320

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@7320

@clerk/elements

npm i https://pkg.pr.new/@clerk/elements@7320

@clerk/clerk-expo

npm i https://pkg.pr.new/@clerk/clerk-expo@7320

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@7320

@clerk/express

npm i https://pkg.pr.new/@clerk/express@7320

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@7320

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@7320

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@7320

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@7320

@clerk/clerk-react

npm i https://pkg.pr.new/@clerk/clerk-react@7320

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@7320

@clerk/remix

npm i https://pkg.pr.new/@clerk/remix@7320

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@7320

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@7320

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@7320

@clerk/themes

npm i https://pkg.pr.new/@clerk/themes@7320

@clerk/types

npm i https://pkg.pr.new/@clerk/types@7320

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@7320

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@7320

commit: 3bee34a

[tmilewski]

🙃 This looks good! Though can we add the en-US version, and expand it out to the other locale files?

pnpm run generate in the localizations package is your friend here. Cursor should be able to help fill out the undefinedform_username_needs_non_number_char localization keys.

[guilherme6191]

Thanks @tmilewski. Ready again. Lmk if you see anything I might have missed.

[guilherme6191]

Description

https://linear.app/clerk/issue/USER-4094/missing-localization-key-for-username-must-contain-one-non-number

This api error was not included in the localization keys for overriding.

• Left undefined in en-US since it'll fallback to the english message from the API.
• Took the chance and added a ptBR translation.

Checklist

• pnpm test runs as expected.
• pnpm build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated

Type of change

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

Summary by CodeRabbit

• New Features

  • Username validation now requires at least one non-numeric character.

• Localization

  • Added a new username error message key across many locales (English, pt-BR and numerous others) to surface the new message.

• Chores

  • Bumped package versions to publish the updated localization key.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 3bee34a

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

This PR includes changesets to release 22 packages

Name	Type
@clerk/localizations	Patch
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/clerk-react	Patch
@clerk/chrome-extension	Patch
@clerk/clerk-expo	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/elements	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/remix	Patch
@clerk/tanstack-react-start	Patch
@clerk/testing	Patch
@clerk/themes	Patch
@clerk/types	Patch
@clerk/vue	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]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
clerk-js-sandbox	Ready	Preview	Comment	Nov 26, 2025 5:46pm

[coderabbitai]

Walkthrough

Adds a new username validation error code NEEDS_NON_NUMBER_CHAR, maps it to the localization key unstable__errors.form_username_needs_non_number_char in username utilities, extends localization types, and populates that key across localization resources plus a changeset.

Changes

Cohort / File(s)	Summary
Core validation logic packages/clerk-js/src/ui/utils/usernameUtils.ts	Introduces NEEDS_NON_NUMBER_CHAR error code and maps it in createUsernameError to unstable__errors.form_username_needs_non_number_char.
Type definitions packages/shared/src/types/localization.ts	Adds form_username_needs_non_number_char: LocalizationValue to UnstableErrors type.
Primary locale entries packages/localizations/src/en-US.ts, packages/localizations/src/pt-BR.ts	Adds concrete translations for unstable__errors.form_username_needs_non_number_char (English and Portuguese).
Other locale resources packages/localizations/src/*.ts (e.g., ar-SA.ts, bg-BG.ts, de-DE.ts, fr-FR.ts, ja-JP.ts, zh-CN.ts, ... )	Adds the new form_username_needs_non_number_char key to many locale files (placed under unstable__errors or apiKeys as appropriate), often as translated strings or placeholders.
Changeset .changeset/nasty-sloths-stare.md	Adds changeset bumping patch versions for affected packages with note about the new localization key.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant UI as UI (username input)
participant Validator as UsernameValidator
participant I18n as LocalizationService
participant User as End user
UI->>Validator: submit username
alt invalid length
Validator-->>UI: error code INVALID_LENGTH
else needs non-number char
Validator-->>UI: error code NEEDS_NON_NUMBER_CHAR
else invalid characters
Validator-->>UI: error code INVALID_CHARACTER
else valid
Validator-->>UI: success
end
Note over UI,I18n: UI maps validator code to i18n key
UI->>I18n: lookup unstable__errors.form_username_needs_non_number_char (or other key)
I18n-->>UI: localized message (or undefined fallback)
UI-->>User: display message / success

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Pay attention to:
  • packages/clerk-js/src/ui/utils/usernameUtils.ts — confirm correct error-code constant name and no regressions in existing branches.
  • packages/shared/src/types/localization.ts — ensure added type aligns with export shape and build passes.
  • Spot-check a sample of locale files (e.g., en-US.ts, pt-BR.ts, zh-CN.ts) to verify key placement (unstable__errors vs apiKeys) and string correctness.

Poem

🐰
I nudged a tiny key in place,
One non-number saves the race,
Translations bloom from near to far,
Validator nods — names raise the bar,
A crunchy carrot for the chase! 🥕

Pre-merge checks and finishing touches

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title accurately describes the main change: adding a missing username form error localization key across multiple packages.
Linked Issues check	✅ Passed	The PR implementation meets all acceptance criteria from USER-4094: the localization key is available for overrides via the localization system, type definitions have been updated to support the new key, and the key is implemented across all localization files.
Out of Scope Changes check	✅ Passed	All changes are directly related to adding the missing localization key. The PR includes the error handling in clerk-js, type definitions in shared, localization entries across all language files, and a changeset file—all aligned with the stated objectives.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch guilherme/localization-add-username-validation-key

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pkg-pr-new]

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7320

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@7320

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@7320

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@7320

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@7320

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@7320

@clerk/elements

npm i https://pkg.pr.new/@clerk/elements@7320

@clerk/clerk-expo

npm i https://pkg.pr.new/@clerk/clerk-expo@7320

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@7320

@clerk/express

npm i https://pkg.pr.new/@clerk/express@7320

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@7320

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@7320

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@7320

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@7320

@clerk/clerk-react

npm i https://pkg.pr.new/@clerk/clerk-react@7320

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@7320

@clerk/remix

npm i https://pkg.pr.new/@clerk/remix@7320

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@7320

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@7320

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@7320

@clerk/themes

npm i https://pkg.pr.new/@clerk/themes@7320

@clerk/types

npm i https://pkg.pr.new/@clerk/types@7320

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@7320

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@7320

commit: 3bee34a

[tmilewski]

🙃 This looks good! Though can we add the en-US version, and expand it out to the other locale files?

pnpm run generate in the localizations package is your friend here. Cursor should be able to help fill out the undefinedform_username_needs_non_number_char localization keys.

[guilherme6191]

Thanks @tmilewski. Ready again. Lmk if you see anything I might have missed.

[guilherme6191]

Description

https://linear.app/clerk/issue/USER-4094/missing-localization-key-for-username-must-contain-one-non-number

This api error was not included in the localization keys for overriding.

• Left undefined in en-US since it'll fallback to the english message from the API.
• Took the chance and added a ptBR translation.

Checklist

• pnpm test runs as expected.
• pnpm build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated

Type of change

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

Summary by CodeRabbit

• New Features

  • Username validation now requires at least one non-numeric character.

• Localization

  • Added a new username error message key across many locales (English, pt-BR and numerous others) to surface the new message.

• Chores

  • Bumped package versions to publish the updated localization key.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 3bee34a

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

This PR includes changesets to release 22 packages

Name	Type
@clerk/localizations	Patch
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/clerk-react	Patch
@clerk/chrome-extension	Patch
@clerk/clerk-expo	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/elements	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/remix	Patch
@clerk/tanstack-react-start	Patch
@clerk/testing	Patch
@clerk/themes	Patch
@clerk/types	Patch
@clerk/vue	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]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
clerk-js-sandbox	Ready	Preview	Comment	Nov 26, 2025 5:46pm

[coderabbitai]

Walkthrough

Adds a new username validation error code NEEDS_NON_NUMBER_CHAR, maps it to the localization key unstable__errors.form_username_needs_non_number_char in username utilities, extends localization types, and populates that key across localization resources plus a changeset.

Changes

Cohort / File(s)	Summary
Core validation logic packages/clerk-js/src/ui/utils/usernameUtils.ts	Introduces NEEDS_NON_NUMBER_CHAR error code and maps it in createUsernameError to unstable__errors.form_username_needs_non_number_char.
Type definitions packages/shared/src/types/localization.ts	Adds form_username_needs_non_number_char: LocalizationValue to UnstableErrors type.
Primary locale entries packages/localizations/src/en-US.ts, packages/localizations/src/pt-BR.ts	Adds concrete translations for unstable__errors.form_username_needs_non_number_char (English and Portuguese).
Other locale resources packages/localizations/src/*.ts (e.g., ar-SA.ts, bg-BG.ts, de-DE.ts, fr-FR.ts, ja-JP.ts, zh-CN.ts, ... )	Adds the new form_username_needs_non_number_char key to many locale files (placed under unstable__errors or apiKeys as appropriate), often as translated strings or placeholders.
Changeset .changeset/nasty-sloths-stare.md	Adds changeset bumping patch versions for affected packages with note about the new localization key.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant UI as UI (username input)
participant Validator as UsernameValidator
participant I18n as LocalizationService
participant User as End user
UI->>Validator: submit username
alt invalid length
Validator-->>UI: error code INVALID_LENGTH
else needs non-number char
Validator-->>UI: error code NEEDS_NON_NUMBER_CHAR
else invalid characters
Validator-->>UI: error code INVALID_CHARACTER
else valid
Validator-->>UI: success
end
Note over UI,I18n: UI maps validator code to i18n key
UI->>I18n: lookup unstable__errors.form_username_needs_non_number_char (or other key)
I18n-->>UI: localized message (or undefined fallback)
UI-->>User: display message / success

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Pay attention to:
  • packages/clerk-js/src/ui/utils/usernameUtils.ts — confirm correct error-code constant name and no regressions in existing branches.
  • packages/shared/src/types/localization.ts — ensure added type aligns with export shape and build passes.
  • Spot-check a sample of locale files (e.g., en-US.ts, pt-BR.ts, zh-CN.ts) to verify key placement (unstable__errors vs apiKeys) and string correctness.

Poem

🐰
I nudged a tiny key in place,
One non-number saves the race,
Translations bloom from near to far,
Validator nods — names raise the bar,
A crunchy carrot for the chase! 🥕

Pre-merge checks and finishing touches

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title accurately describes the main change: adding a missing username form error localization key across multiple packages.
Linked Issues check	✅ Passed	The PR implementation meets all acceptance criteria from USER-4094: the localization key is available for overrides via the localization system, type definitions have been updated to support the new key, and the key is implemented across all localization files.
Out of Scope Changes check	✅ Passed	All changes are directly related to adding the missing localization key. The PR includes the error handling in clerk-js, type definitions in shared, localization entries across all language files, and a changeset file—all aligned with the stated objectives.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch guilherme/localization-add-username-validation-key

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pkg-pr-new]

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7320

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@7320

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@7320

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@7320

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@7320

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@7320

@clerk/elements

npm i https://pkg.pr.new/@clerk/elements@7320

@clerk/clerk-expo

npm i https://pkg.pr.new/@clerk/clerk-expo@7320

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@7320

@clerk/express

npm i https://pkg.pr.new/@clerk/express@7320

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@7320

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@7320

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@7320

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@7320

@clerk/clerk-react

npm i https://pkg.pr.new/@clerk/clerk-react@7320

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@7320

@clerk/remix

npm i https://pkg.pr.new/@clerk/remix@7320

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@7320

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@7320

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@7320

@clerk/themes

npm i https://pkg.pr.new/@clerk/themes@7320

@clerk/types

npm i https://pkg.pr.new/@clerk/types@7320

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@7320

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@7320

commit: 3bee34a

[tmilewski]

🙃 This looks good! Though can we add the en-US version, and expand it out to the other locale files?

pnpm run generate in the localizations package is your friend here. Cursor should be able to help fill out the undefinedform_username_needs_non_number_char localization keys.

[guilherme6191]

Thanks @tmilewski. Ready again. Lmk if you see anything I might have missed.

[guilherme6191]

Description

https://linear.app/clerk/issue/USER-4094/missing-localization-key-for-username-must-contain-one-non-number

This api error was not included in the localization keys for overriding.

• Left undefined in en-US since it'll fallback to the english message from the API.
• Took the chance and added a ptBR translation.

Checklist

• pnpm test runs as expected.
• pnpm build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated

Type of change

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

Summary by CodeRabbit

• New Features

  • Username validation now requires at least one non-numeric character.

• Localization

  • Added a new username error message key across many locales (English, pt-BR and numerous others) to surface the new message.

• Chores

  • Bumped package versions to publish the updated localization key.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 3bee34a

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

This PR includes changesets to release 22 packages

Name	Type
@clerk/localizations	Patch
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/clerk-react	Patch
@clerk/chrome-extension	Patch
@clerk/clerk-expo	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/elements	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/remix	Patch
@clerk/tanstack-react-start	Patch
@clerk/testing	Patch
@clerk/themes	Patch
@clerk/types	Patch
@clerk/vue	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]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
clerk-js-sandbox	Ready	Preview	Comment	Nov 26, 2025 5:46pm

[coderabbitai]

Walkthrough

Adds a new username validation error code NEEDS_NON_NUMBER_CHAR, maps it to the localization key unstable__errors.form_username_needs_non_number_char in username utilities, extends localization types, and populates that key across localization resources plus a changeset.

Changes

Cohort / File(s)	Summary
Core validation logic packages/clerk-js/src/ui/utils/usernameUtils.ts	Introduces NEEDS_NON_NUMBER_CHAR error code and maps it in createUsernameError to unstable__errors.form_username_needs_non_number_char.
Type definitions packages/shared/src/types/localization.ts	Adds form_username_needs_non_number_char: LocalizationValue to UnstableErrors type.
Primary locale entries packages/localizations/src/en-US.ts, packages/localizations/src/pt-BR.ts	Adds concrete translations for unstable__errors.form_username_needs_non_number_char (English and Portuguese).
Other locale resources packages/localizations/src/*.ts (e.g., ar-SA.ts, bg-BG.ts, de-DE.ts, fr-FR.ts, ja-JP.ts, zh-CN.ts, ... )	Adds the new form_username_needs_non_number_char key to many locale files (placed under unstable__errors or apiKeys as appropriate), often as translated strings or placeholders.
Changeset .changeset/nasty-sloths-stare.md	Adds changeset bumping patch versions for affected packages with note about the new localization key.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant UI as UI (username input)
participant Validator as UsernameValidator
participant I18n as LocalizationService
participant User as End user
UI->>Validator: submit username
alt invalid length
Validator-->>UI: error code INVALID_LENGTH
else needs non-number char
Validator-->>UI: error code NEEDS_NON_NUMBER_CHAR
else invalid characters
Validator-->>UI: error code INVALID_CHARACTER
else valid
Validator-->>UI: success
end
Note over UI,I18n: UI maps validator code to i18n key
UI->>I18n: lookup unstable__errors.form_username_needs_non_number_char (or other key)
I18n-->>UI: localized message (or undefined fallback)
UI-->>User: display message / success

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Pay attention to:
  • packages/clerk-js/src/ui/utils/usernameUtils.ts — confirm correct error-code constant name and no regressions in existing branches.
  • packages/shared/src/types/localization.ts — ensure added type aligns with export shape and build passes.
  • Spot-check a sample of locale files (e.g., en-US.ts, pt-BR.ts, zh-CN.ts) to verify key placement (unstable__errors vs apiKeys) and string correctness.

Poem

🐰
I nudged a tiny key in place,
One non-number saves the race,
Translations bloom from near to far,
Validator nods — names raise the bar,
A crunchy carrot for the chase! 🥕

Pre-merge checks and finishing touches

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title accurately describes the main change: adding a missing username form error localization key across multiple packages.
Linked Issues check	✅ Passed	The PR implementation meets all acceptance criteria from USER-4094: the localization key is available for overrides via the localization system, type definitions have been updated to support the new key, and the key is implemented across all localization files.
Out of Scope Changes check	✅ Passed	All changes are directly related to adding the missing localization key. The PR includes the error handling in clerk-js, type definitions in shared, localization entries across all language files, and a changeset file—all aligned with the stated objectives.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch guilherme/localization-add-username-validation-key

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pkg-pr-new]

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7320

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@7320

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@7320

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@7320

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@7320

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@7320

@clerk/elements

npm i https://pkg.pr.new/@clerk/elements@7320

@clerk/clerk-expo

npm i https://pkg.pr.new/@clerk/clerk-expo@7320

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@7320

@clerk/express

npm i https://pkg.pr.new/@clerk/express@7320

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@7320

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@7320

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@7320

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@7320

@clerk/clerk-react

npm i https://pkg.pr.new/@clerk/clerk-react@7320

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@7320

@clerk/remix

npm i https://pkg.pr.new/@clerk/remix@7320

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@7320

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@7320

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@7320

@clerk/themes

npm i https://pkg.pr.new/@clerk/themes@7320

@clerk/types

npm i https://pkg.pr.new/@clerk/types@7320

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@7320

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@7320

commit: 3bee34a

[tmilewski]

🙃 This looks good! Though can we add the en-US version, and expand it out to the other locale files?

pnpm run generate in the localizations package is your friend here. Cursor should be able to help fill out the undefinedform_username_needs_non_number_char localization keys.

[guilherme6191]

Thanks @tmilewski. Ready again. Lmk if you see anything I might have missed.

[guilherme6191]

Description

https://linear.app/clerk/issue/USER-4094/missing-localization-key-for-username-must-contain-one-non-number

This api error was not included in the localization keys for overriding.

• Left undefined in en-US since it'll fallback to the english message from the API.
• Took the chance and added a ptBR translation.

Checklist

• pnpm test runs as expected.
• pnpm build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated

Type of change

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

Summary by CodeRabbit

• New Features

  • Username validation now requires at least one non-numeric character.

• Localization

  • Added a new username error message key across many locales (English, pt-BR and numerous others) to surface the new message.

• Chores

  • Bumped package versions to publish the updated localization key.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 3bee34a

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

This PR includes changesets to release 22 packages

Name	Type
@clerk/localizations	Patch
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/clerk-react	Patch
@clerk/chrome-extension	Patch
@clerk/clerk-expo	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/elements	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/remix	Patch
@clerk/tanstack-react-start	Patch
@clerk/testing	Patch
@clerk/themes	Patch
@clerk/types	Patch
@clerk/vue	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]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
clerk-js-sandbox	Ready	Preview	Comment	Nov 26, 2025 5:46pm

[coderabbitai]

Walkthrough

Adds a new username validation error code NEEDS_NON_NUMBER_CHAR, maps it to the localization key unstable__errors.form_username_needs_non_number_char in username utilities, extends localization types, and populates that key across localization resources plus a changeset.

Changes

Cohort / File(s)	Summary
Core validation logic packages/clerk-js/src/ui/utils/usernameUtils.ts	Introduces NEEDS_NON_NUMBER_CHAR error code and maps it in createUsernameError to unstable__errors.form_username_needs_non_number_char.
Type definitions packages/shared/src/types/localization.ts	Adds form_username_needs_non_number_char: LocalizationValue to UnstableErrors type.
Primary locale entries packages/localizations/src/en-US.ts, packages/localizations/src/pt-BR.ts	Adds concrete translations for unstable__errors.form_username_needs_non_number_char (English and Portuguese).
Other locale resources packages/localizations/src/*.ts (e.g., ar-SA.ts, bg-BG.ts, de-DE.ts, fr-FR.ts, ja-JP.ts, zh-CN.ts, ... )	Adds the new form_username_needs_non_number_char key to many locale files (placed under unstable__errors or apiKeys as appropriate), often as translated strings or placeholders.
Changeset .changeset/nasty-sloths-stare.md	Adds changeset bumping patch versions for affected packages with note about the new localization key.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant UI as UI (username input)
participant Validator as UsernameValidator
participant I18n as LocalizationService
participant User as End user
UI->>Validator: submit username
alt invalid length
Validator-->>UI: error code INVALID_LENGTH
else needs non-number char
Validator-->>UI: error code NEEDS_NON_NUMBER_CHAR
else invalid characters
Validator-->>UI: error code INVALID_CHARACTER
else valid
Validator-->>UI: success
end
Note over UI,I18n: UI maps validator code to i18n key
UI->>I18n: lookup unstable__errors.form_username_needs_non_number_char (or other key)
I18n-->>UI: localized message (or undefined fallback)
UI-->>User: display message / success

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Pay attention to:
  • packages/clerk-js/src/ui/utils/usernameUtils.ts — confirm correct error-code constant name and no regressions in existing branches.
  • packages/shared/src/types/localization.ts — ensure added type aligns with export shape and build passes.
  • Spot-check a sample of locale files (e.g., en-US.ts, pt-BR.ts, zh-CN.ts) to verify key placement (unstable__errors vs apiKeys) and string correctness.

Poem

🐰
I nudged a tiny key in place,
One non-number saves the race,
Translations bloom from near to far,
Validator nods — names raise the bar,
A crunchy carrot for the chase! 🥕

Pre-merge checks and finishing touches

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title accurately describes the main change: adding a missing username form error localization key across multiple packages.
Linked Issues check	✅ Passed	The PR implementation meets all acceptance criteria from USER-4094: the localization key is available for overrides via the localization system, type definitions have been updated to support the new key, and the key is implemented across all localization files.
Out of Scope Changes check	✅ Passed	All changes are directly related to adding the missing localization key. The PR includes the error handling in clerk-js, type definitions in shared, localization entries across all language files, and a changeset file—all aligned with the stated objectives.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch guilherme/localization-add-username-validation-key

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pkg-pr-new]

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7320

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@7320

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@7320

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@7320

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@7320

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@7320

@clerk/elements

npm i https://pkg.pr.new/@clerk/elements@7320

@clerk/clerk-expo

npm i https://pkg.pr.new/@clerk/clerk-expo@7320

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@7320

@clerk/express

npm i https://pkg.pr.new/@clerk/express@7320

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@7320

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@7320

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@7320

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@7320

@clerk/clerk-react

npm i https://pkg.pr.new/@clerk/clerk-react@7320

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@7320

@clerk/remix

npm i https://pkg.pr.new/@clerk/remix@7320

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@7320

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@7320

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@7320

@clerk/themes

npm i https://pkg.pr.new/@clerk/themes@7320

@clerk/types

npm i https://pkg.pr.new/@clerk/types@7320

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@7320

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@7320

commit: 3bee34a

[tmilewski]

🙃 This looks good! Though can we add the en-US version, and expand it out to the other locale files?

pnpm run generate in the localizations package is your friend here. Cursor should be able to help fill out the undefinedform_username_needs_non_number_char localization keys.

[guilherme6191]

Thanks @tmilewski. Ready again. Lmk if you see anything I might have missed.

[guilherme6191]

Description

https://linear.app/clerk/issue/USER-4094/missing-localization-key-for-username-must-contain-one-non-number

This api error was not included in the localization keys for overriding.

• Left undefined in en-US since it'll fallback to the english message from the API.
• Took the chance and added a ptBR translation.

Checklist

• pnpm test runs as expected.
• pnpm build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated

Type of change

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

Summary by CodeRabbit

• New Features

  • Username validation now requires at least one non-numeric character.

• Localization

  • Added a new username error message key across many locales (English, pt-BR and numerous others) to surface the new message.

• Chores

  • Bumped package versions to publish the updated localization key.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 3bee34a

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

This PR includes changesets to release 22 packages

Name	Type
@clerk/localizations	Patch
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/clerk-react	Patch
@clerk/chrome-extension	Patch
@clerk/clerk-expo	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/elements	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/remix	Patch
@clerk/tanstack-react-start	Patch
@clerk/testing	Patch
@clerk/themes	Patch
@clerk/types	Patch
@clerk/vue	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]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
clerk-js-sandbox	Ready	Preview	Comment	Nov 26, 2025 5:46pm

[coderabbitai]

Walkthrough

Adds a new username validation error code NEEDS_NON_NUMBER_CHAR, maps it to the localization key unstable__errors.form_username_needs_non_number_char in username utilities, extends localization types, and populates that key across localization resources plus a changeset.

Changes

Cohort / File(s)	Summary
Core validation logic packages/clerk-js/src/ui/utils/usernameUtils.ts	Introduces NEEDS_NON_NUMBER_CHAR error code and maps it in createUsernameError to unstable__errors.form_username_needs_non_number_char.
Type definitions packages/shared/src/types/localization.ts	Adds form_username_needs_non_number_char: LocalizationValue to UnstableErrors type.
Primary locale entries packages/localizations/src/en-US.ts, packages/localizations/src/pt-BR.ts	Adds concrete translations for unstable__errors.form_username_needs_non_number_char (English and Portuguese).
Other locale resources packages/localizations/src/*.ts (e.g., ar-SA.ts, bg-BG.ts, de-DE.ts, fr-FR.ts, ja-JP.ts, zh-CN.ts, ... )	Adds the new form_username_needs_non_number_char key to many locale files (placed under unstable__errors or apiKeys as appropriate), often as translated strings or placeholders.
Changeset .changeset/nasty-sloths-stare.md	Adds changeset bumping patch versions for affected packages with note about the new localization key.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant UI as UI (username input)
participant Validator as UsernameValidator
participant I18n as LocalizationService
participant User as End user
UI->>Validator: submit username
alt invalid length
Validator-->>UI: error code INVALID_LENGTH
else needs non-number char
Validator-->>UI: error code NEEDS_NON_NUMBER_CHAR
else invalid characters
Validator-->>UI: error code INVALID_CHARACTER
else valid
Validator-->>UI: success
end
Note over UI,I18n: UI maps validator code to i18n key
UI->>I18n: lookup unstable__errors.form_username_needs_non_number_char (or other key)
I18n-->>UI: localized message (or undefined fallback)
UI-->>User: display message / success

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Pay attention to:
  • packages/clerk-js/src/ui/utils/usernameUtils.ts — confirm correct error-code constant name and no regressions in existing branches.
  • packages/shared/src/types/localization.ts — ensure added type aligns with export shape and build passes.
  • Spot-check a sample of locale files (e.g., en-US.ts, pt-BR.ts, zh-CN.ts) to verify key placement (unstable__errors vs apiKeys) and string correctness.

Poem

🐰
I nudged a tiny key in place,
One non-number saves the race,
Translations bloom from near to far,
Validator nods — names raise the bar,
A crunchy carrot for the chase! 🥕

Pre-merge checks and finishing touches

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title accurately describes the main change: adding a missing username form error localization key across multiple packages.
Linked Issues check	✅ Passed	The PR implementation meets all acceptance criteria from USER-4094: the localization key is available for overrides via the localization system, type definitions have been updated to support the new key, and the key is implemented across all localization files.
Out of Scope Changes check	✅ Passed	All changes are directly related to adding the missing localization key. The PR includes the error handling in clerk-js, type definitions in shared, localization entries across all language files, and a changeset file—all aligned with the stated objectives.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch guilherme/localization-add-username-validation-key

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pkg-pr-new]

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7320

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@7320

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@7320

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@7320

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@7320

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@7320

@clerk/elements

npm i https://pkg.pr.new/@clerk/elements@7320

@clerk/clerk-expo

npm i https://pkg.pr.new/@clerk/clerk-expo@7320

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@7320

@clerk/express

npm i https://pkg.pr.new/@clerk/express@7320

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@7320

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@7320

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@7320

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@7320

@clerk/clerk-react

npm i https://pkg.pr.new/@clerk/clerk-react@7320

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@7320

@clerk/remix

npm i https://pkg.pr.new/@clerk/remix@7320

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@7320

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@7320

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@7320

@clerk/themes

npm i https://pkg.pr.new/@clerk/themes@7320

@clerk/types

npm i https://pkg.pr.new/@clerk/types@7320

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@7320

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@7320

commit: 3bee34a

[tmilewski]

🙃 This looks good! Though can we add the en-US version, and expand it out to the other locale files?

pnpm run generate in the localizations package is your friend here. Cursor should be able to help fill out the undefinedform_username_needs_non_number_char localization keys.

[guilherme6191]

Thanks @tmilewski. Ready again. Lmk if you see anything I might have missed.

[guilherme6191]

Description

https://linear.app/clerk/issue/USER-4094/missing-localization-key-for-username-must-contain-one-non-number

This api error was not included in the localization keys for overriding.

• Left undefined in en-US since it'll fallback to the english message from the API.
• Took the chance and added a ptBR translation.

Checklist

• pnpm test runs as expected.
• pnpm build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated

Type of change

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

Summary by CodeRabbit

• New Features

  • Username validation now requires at least one non-numeric character.

• Localization

  • Added a new username error message key across many locales (English, pt-BR and numerous others) to surface the new message.

• Chores

  • Bumped package versions to publish the updated localization key.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 3bee34a

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

This PR includes changesets to release 22 packages

Name	Type
@clerk/localizations	Patch
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/clerk-react	Patch
@clerk/chrome-extension	Patch
@clerk/clerk-expo	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/elements	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/remix	Patch
@clerk/tanstack-react-start	Patch
@clerk/testing	Patch
@clerk/themes	Patch
@clerk/types	Patch
@clerk/vue	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]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
clerk-js-sandbox	Ready	Preview	Comment	Nov 26, 2025 5:46pm

[coderabbitai]

Walkthrough

Adds a new username validation error code NEEDS_NON_NUMBER_CHAR, maps it to the localization key unstable__errors.form_username_needs_non_number_char in username utilities, extends localization types, and populates that key across localization resources plus a changeset.

Changes

Cohort / File(s)	Summary
Core validation logic packages/clerk-js/src/ui/utils/usernameUtils.ts	Introduces NEEDS_NON_NUMBER_CHAR error code and maps it in createUsernameError to unstable__errors.form_username_needs_non_number_char.
Type definitions packages/shared/src/types/localization.ts	Adds form_username_needs_non_number_char: LocalizationValue to UnstableErrors type.
Primary locale entries packages/localizations/src/en-US.ts, packages/localizations/src/pt-BR.ts	Adds concrete translations for unstable__errors.form_username_needs_non_number_char (English and Portuguese).
Other locale resources packages/localizations/src/*.ts (e.g., ar-SA.ts, bg-BG.ts, de-DE.ts, fr-FR.ts, ja-JP.ts, zh-CN.ts, ... )	Adds the new form_username_needs_non_number_char key to many locale files (placed under unstable__errors or apiKeys as appropriate), often as translated strings or placeholders.
Changeset .changeset/nasty-sloths-stare.md	Adds changeset bumping patch versions for affected packages with note about the new localization key.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant UI as UI (username input)
participant Validator as UsernameValidator
participant I18n as LocalizationService
participant User as End user
UI->>Validator: submit username
alt invalid length
Validator-->>UI: error code INVALID_LENGTH
else needs non-number char
Validator-->>UI: error code NEEDS_NON_NUMBER_CHAR
else invalid characters
Validator-->>UI: error code INVALID_CHARACTER
else valid
Validator-->>UI: success
end
Note over UI,I18n: UI maps validator code to i18n key
UI->>I18n: lookup unstable__errors.form_username_needs_non_number_char (or other key)
I18n-->>UI: localized message (or undefined fallback)
UI-->>User: display message / success

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Pay attention to:
  • packages/clerk-js/src/ui/utils/usernameUtils.ts — confirm correct error-code constant name and no regressions in existing branches.
  • packages/shared/src/types/localization.ts — ensure added type aligns with export shape and build passes.
  • Spot-check a sample of locale files (e.g., en-US.ts, pt-BR.ts, zh-CN.ts) to verify key placement (unstable__errors vs apiKeys) and string correctness.

Poem

🐰
I nudged a tiny key in place,
One non-number saves the race,
Translations bloom from near to far,
Validator nods — names raise the bar,
A crunchy carrot for the chase! 🥕

Pre-merge checks and finishing touches

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title accurately describes the main change: adding a missing username form error localization key across multiple packages.
Linked Issues check	✅ Passed	The PR implementation meets all acceptance criteria from USER-4094: the localization key is available for overrides via the localization system, type definitions have been updated to support the new key, and the key is implemented across all localization files.
Out of Scope Changes check	✅ Passed	All changes are directly related to adding the missing localization key. The PR includes the error handling in clerk-js, type definitions in shared, localization entries across all language files, and a changeset file—all aligned with the stated objectives.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch guilherme/localization-add-username-validation-key

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pkg-pr-new]

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7320

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@7320

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@7320

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@7320

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@7320

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@7320

@clerk/elements

npm i https://pkg.pr.new/@clerk/elements@7320

@clerk/clerk-expo

npm i https://pkg.pr.new/@clerk/clerk-expo@7320

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@7320

@clerk/express

npm i https://pkg.pr.new/@clerk/express@7320

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@7320

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@7320

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@7320

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@7320

@clerk/clerk-react

npm i https://pkg.pr.new/@clerk/clerk-react@7320

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@7320

@clerk/remix

npm i https://pkg.pr.new/@clerk/remix@7320

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@7320

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@7320

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@7320

@clerk/themes

npm i https://pkg.pr.new/@clerk/themes@7320

@clerk/types

npm i https://pkg.pr.new/@clerk/types@7320

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@7320

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@7320

commit: 3bee34a

[tmilewski]

🙃 This looks good! Though can we add the en-US version, and expand it out to the other locale files?

pnpm run generate in the localizations package is your friend here. Cursor should be able to help fill out the undefinedform_username_needs_non_number_char localization keys.

[guilherme6191]

Thanks @tmilewski. Ready again. Lmk if you see anything I might have missed.

[guilherme6191]

Description

https://linear.app/clerk/issue/USER-4094/missing-localization-key-for-username-must-contain-one-non-number

This api error was not included in the localization keys for overriding.

• Left undefined in en-US since it'll fallback to the english message from the API.
• Took the chance and added a ptBR translation.

Checklist

• pnpm test runs as expected.
• pnpm build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated

Type of change

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

Summary by CodeRabbit

• New Features

  • Username validation now requires at least one non-numeric character.

• Localization

  • Added a new username error message key across many locales (English, pt-BR and numerous others) to surface the new message.

• Chores

  • Bumped package versions to publish the updated localization key.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 3bee34a

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

This PR includes changesets to release 22 packages

Name	Type
@clerk/localizations	Patch
@clerk/clerk-js	Patch
@clerk/shared	Patch
@clerk/clerk-react	Patch
@clerk/chrome-extension	Patch
@clerk/clerk-expo	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/elements	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/remix	Patch
@clerk/tanstack-react-start	Patch
@clerk/testing	Patch
@clerk/themes	Patch
@clerk/types	Patch
@clerk/vue	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]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
clerk-js-sandbox	Ready	Preview	Comment	Nov 26, 2025 5:46pm

[coderabbitai]

Walkthrough

Adds a new username validation error code NEEDS_NON_NUMBER_CHAR, maps it to the localization key unstable__errors.form_username_needs_non_number_char in username utilities, extends localization types, and populates that key across localization resources plus a changeset.

Changes

Cohort / File(s)	Summary
Core validation logic packages/clerk-js/src/ui/utils/usernameUtils.ts	Introduces NEEDS_NON_NUMBER_CHAR error code and maps it in createUsernameError to unstable__errors.form_username_needs_non_number_char.
Type definitions packages/shared/src/types/localization.ts	Adds form_username_needs_non_number_char: LocalizationValue to UnstableErrors type.
Primary locale entries packages/localizations/src/en-US.ts, packages/localizations/src/pt-BR.ts	Adds concrete translations for unstable__errors.form_username_needs_non_number_char (English and Portuguese).
Other locale resources packages/localizations/src/*.ts (e.g., ar-SA.ts, bg-BG.ts, de-DE.ts, fr-FR.ts, ja-JP.ts, zh-CN.ts, ... )	Adds the new form_username_needs_non_number_char key to many locale files (placed under unstable__errors or apiKeys as appropriate), often as translated strings or placeholders.
Changeset .changeset/nasty-sloths-stare.md	Adds changeset bumping patch versions for affected packages with note about the new localization key.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant UI as UI (username input)
participant Validator as UsernameValidator
participant I18n as LocalizationService
participant User as End user
UI->>Validator: submit username
alt invalid length
Validator-->>UI: error code INVALID_LENGTH
else needs non-number char
Validator-->>UI: error code NEEDS_NON_NUMBER_CHAR
else invalid characters
Validator-->>UI: error code INVALID_CHARACTER
else valid
Validator-->>UI: success
end
Note over UI,I18n: UI maps validator code to i18n key
UI->>I18n: lookup unstable__errors.form_username_needs_non_number_char (or other key)
I18n-->>UI: localized message (or undefined fallback)
UI-->>User: display message / success

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Pay attention to:
  • packages/clerk-js/src/ui/utils/usernameUtils.ts — confirm correct error-code constant name and no regressions in existing branches.
  • packages/shared/src/types/localization.ts — ensure added type aligns with export shape and build passes.
  • Spot-check a sample of locale files (e.g., en-US.ts, pt-BR.ts, zh-CN.ts) to verify key placement (unstable__errors vs apiKeys) and string correctness.

Poem

🐰
I nudged a tiny key in place,
One non-number saves the race,
Translations bloom from near to far,
Validator nods — names raise the bar,
A crunchy carrot for the chase! 🥕

Pre-merge checks and finishing touches

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title accurately describes the main change: adding a missing username form error localization key across multiple packages.
Linked Issues check	✅ Passed	The PR implementation meets all acceptance criteria from USER-4094: the localization key is available for overrides via the localization system, type definitions have been updated to support the new key, and the key is implemented across all localization files.
Out of Scope Changes check	✅ Passed	All changes are directly related to adding the missing localization key. The PR includes the error handling in clerk-js, type definitions in shared, localization entries across all language files, and a changeset file—all aligned with the stated objectives.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch guilherme/localization-add-username-validation-key

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pkg-pr-new]

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7320

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@7320

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@7320

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@7320

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@7320

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@7320

@clerk/elements

npm i https://pkg.pr.new/@clerk/elements@7320

@clerk/clerk-expo

npm i https://pkg.pr.new/@clerk/clerk-expo@7320

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@7320

@clerk/express

npm i https://pkg.pr.new/@clerk/express@7320

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@7320

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@7320

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@7320

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@7320

@clerk/clerk-react

npm i https://pkg.pr.new/@clerk/clerk-react@7320

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@7320

@clerk/remix

npm i https://pkg.pr.new/@clerk/remix@7320

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@7320

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@7320

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@7320

@clerk/themes

npm i https://pkg.pr.new/@clerk/themes@7320

@clerk/types

npm i https://pkg.pr.new/@clerk/types@7320

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@7320

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@7320

commit: 3bee34a

[tmilewski]

🙃 This looks good! Though can we add the en-US version, and expand it out to the other locale files?

pnpm run generate in the localizations package is your friend here. Cursor should be able to help fill out the undefinedform_username_needs_non_number_char localization keys.

[guilherme6191]

Thanks @tmilewski. Ready again. Lmk if you see anything I might have missed.