feat(shared,localizations): Add flatLocalization utility

.changeset/thirty-breads-strive.md

@@ -0,0 +1,24 @@
+---
+'@clerk/localizations': patch
+'@clerk/shared': patch
+---
+
+A utility function that converts flattened localization objects (with dot-notation keys) to nested `LocalizationResource` objects for use with Clerk's `localization` prop.
+
+```typescript
+import { ClerkProvider } from '@clerk/nextjs';
+import { flatLocalization } from '@clerk/localizations/utils';
+
+const localization = flatLocalization({
+  'formFieldLabel__emailAddress': 'Email address',
+  'unstable__errors.passwordComplexity.maximumLength': 'Password is too long',
+});
+
+export default function App() {
+  return (
+    <ClerkProvider localization={localization}>
+      {/* Your app */}
+    </ClerkProvider>
+  );
+}
+```

packages/localizations/package.json

@@ -36,6 +36,16 @@
         "default": "./dist/index.js"
       }
     },
+    "./utils": {
+      "import": {
+        "types": "./dist/utils/index.d.mts",
+        "default": "./dist/utils/index.mjs"
+      },
+      "require": {
+        "types": "./dist/utils/index.d.ts",
+        "default": "./dist/utils/index.js"
+      }
+    },
     "./*": {
       "import": {
         "types": "./dist/*.d.mts",
@@ -61,12 +71,16 @@
     "format:check": "node ../../scripts/format-package.mjs --check",
     "generate": "tsc src/utils/generate.ts && node src/utils/generate.js && prettier --write src/*.ts",
     "lint": "eslint src",
-    "lint:attw": "attw --pack . --profile node16"
+    "lint:attw": "attw --pack . --profile node16",
+    "test": "vitest --run"
   },
   "dependencies": {
     "@clerk/shared": "workspace:^"
   },
-  "devDependencies": {},
+  "devDependencies": {
+    "@vitest/ui": "3.2.4",
+    "vitest": "3.2.4"
+  },
   "engines": {
     "node": ">=20.9.0"
   },