') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); })(); feat(localizations): Add en-XA locale by dstaley · Pull Request #7979 · clerk/javascript · GitHub
Skip to content

feat(localizations): Add en-XA locale - #7979

Merged
dstaley merged 1 commit into
mainfrom
ds.feat/gibberish-locale
Mar 5, 2026
Merged

feat(localizations): Add en-XA locale#7979
dstaley merged 1 commit into
mainfrom
ds.feat/gibberish-locale

Conversation

@dstaley

@dstaleydstaley commented Mar 4, 2026•
edited by coderabbitai Bot
Loading

Copy link
Copy Markdown
Member

Description

This PR introduces a en-XA locale which is derived from our en-US locale. Each string is transformed to use a different character in a deterministic way to help highlight portions of the UI that are not using our localization system.

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
    • Introduced a new en-XA pseudo-localization locale to the localizations package. This specialized locale visually highlights untranslated and unlocalized strings within the application, enabling translators and developers to quickly identify content requiring localization attention and improving overall localization workflows.

@vercel

vercelBot commented Mar 4, 2026•
edited
Loading

Copy link
Copy Markdown

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

ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxReadyReadyPreview, CommentMar 4, 2026 8:37pm

Request Review

@changeset-bot

changeset-botBot commented Mar 4, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 779aaa3

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

This PR includes changesets to release 3 packages
NameType
@clerk/localizationsMinor
@clerk/uiPatch
@clerk/chrome-extensionPatch

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

@pkg-pr-new

pkg-pr-newBot commented Mar 4, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/agent-toolkit

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

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@7979

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@7979

@clerk/upgrade

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

@clerk/vue

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

commit: 779aaa3

@coderabbitai

coderabbitaiBot commented Mar 4, 2026

Copy link
Copy Markdown
Contributor

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

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

Review profile: CHILL

Plan: Pro

Run ID: 091c3582-0582-4f33-81c9-fe6e40268285

📥 Commits

Reviewing files that changed from the base of the PR and between b94a271 and 779aaa3.

📒 Files selected for processing (3)
  • .changeset/flat-pets-taste.md
  • packages/localizations/src/en-XA.ts
  • packages/localizations/src/index.ts
📝 Walkthrough

Walkthrough

This change adds a new pseudo-localization locale (en-XA) to the '@clerk/localizations' package. The implementation includes a new module that imports the base en-US localization and applies character obfuscation to strings while preserving template tokens and placeholders. The localization resource is created by recursively transforming all string values in the base localization. The new locale is exported through the package's index file, expanding the available localization options. A corresponding changeset entry documents this as a minor version update.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately and concisely describes the main change: adding a new en-XA locale to the localizations package, which is fully supported by the changeset contents.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

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

@dstaley
dstaley merged commit de089c5 into mainMar 5, 2026
41 checks passed
@dstaley
dstaley deleted the ds.feat/gibberish-locale branch March 5, 2026 21:10
@clerk-cookieclerk-cookie mentioned this pull request Mar 5, 2026
Merged
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@wobsorianowobsorianowobsoriano approved these changes

Assignees

No one assigned

Labels

localizations

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@dstaley@wobsoriano