@warlock.js/core 5.12.0 → 5.13.0

package/package.json

@@ -25,13 +25,12 @@
     "@mongez/slug": "^1.0.7",
     "@mongez/supportive-is": "^2.1.4",
     "@mongez/time-wizard": "^1.0.6",
-    "@warlock.js/auth": "5.12.0",
-    "@warlock.js/cache": "5.12.0",
-    "@warlock.js/cascade": "5.12.0",
-    "@warlock.js/context": "5.12.0",
-    "@warlock.js/logger": "5.12.0",
-    "@warlock.js/seal": "5.12.0",
-    "@warlock.js/fs": "5.12.0",
+    "@warlock.js/cache": "5.13.0",
+    "@warlock.js/cascade": "5.13.0",
+    "@warlock.js/context": "5.13.0",
+    "@warlock.js/logger": "5.13.0",
+    "@warlock.js/seal": "5.13.0",
+    "@warlock.js/fs": "5.13.0",
     "chokidar": "^5.0.0",
     "dayjs": "^1.11.19",
     "es-module-lexer": "^2.0.0",
@@ -57,10 +56,10 @@
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
     "@react-email/render": "^2.0.5",
-    "@warlock.js/herald": "5.12.0",
-    "@warlock.js/ai": "5.12.0",
-    "@warlock.js/access": "5.12.0",
-    "@warlock.js/notifications": "5.12.0"
+    "@warlock.js/herald": "5.13.0",
+    "@warlock.js/ai": "5.13.0",
+    "@warlock.js/access": "5.13.0",
+    "@warlock.js/notifications": "5.13.0"
   },
   "peerDependenciesMeta": {
     "sharp": {
@@ -123,7 +122,7 @@
   ],
   "author": "hassanzohdy",
   "license": "MIT",
-  "version": "5.12.0",
+  "version": "5.13.0",
   "type": "module",
   "main": "./esm/index.mjs",
   "module": "./esm/index.mjs",

package/skills/use-localization/SKILL.md

@@ -20,7 +20,7 @@ import { groupedTranslations } from "@mongez/localization";
 
 groupedTranslations("products", {
   notFound: { en: "Product not found", ar: "المنتج غير موجود" },
-  created:  { en: "Product created",  ar: "تم إنشاء المنتج" },
+  created: { en: "Product created", ar: "تم إنشاء المنتج" },
 });
 
 // 2. Look up in a controller / service
@@ -45,11 +45,11 @@ Every module owns its translation namespace under `src/app/<module>/utils/locale
 import { groupedTranslations } from "@mongez/localization";
 
 groupedTranslations("products", {
-  notFound:    { en: "Product not found",      ar: "المنتج غير موجود" },
-  outOfStock:  { en: "Product out of stock",   ar: "المنتج غير متوفر" },
-  created:     { en: "Product created",         ar: "تم إنشاء المنتج" },
-  updated:     { en: "Product updated",         ar: "تم تحديث المنتج" },
-  deleted:     { en: "Product deleted",         ar: "تم حذف المنتج" },
+  notFound: { en: "Product not found", ar: "المنتج غير موجود" },
+  outOfStock: { en: "Product out of stock", ar: "المنتج غير متوفر" },
+  created: { en: "Product created", ar: "تم إنشاء المنتج" },
+  updated: { en: "Product updated", ar: "تم تحديث المنتج" },
+  deleted: { en: "Product deleted", ar: "تم حذف المنتج" },
 });
 ```
 
@@ -96,6 +96,10 @@ request.trans("products.notFound");
 
 All three lookups go through `@mongez/localization`'s `trans()` under the hood, with the locale pulled from the request context (or the global default).
 
+### Web `useTrans()` key checking
+
+When an app uses `@warlock.js/web`, `warlock dev` writes `.warlock/typings/translations.d.ts` from literal `groupedTranslations("group", { key: ... })` registrations. It augments web's `TranslationKeyRegistry`, so `useTrans()("products.notFound")` is checked against registered keys and a typo fails TypeScript. Before the generated file exists, `useTrans()` accepts `string` for a non-breaking first boot. Dynamic groups/keys and placeholders are not inferred.
+
 ### Locale on a specific lookup
 
 ```ts
@@ -123,7 +127,7 @@ Configure the default:
 
 ```ts title="src/config/app.ts"
 export default {
-  localeCode: "en",                       // app-wide default
+  localeCode: "en", // app-wide default
   // ...
 };
 ```
@@ -142,20 +146,19 @@ When a column stores per-locale values as an array:
 
 ```ts
 // Schema (Seal):
-name_translations: v.array(
+name_translations: (v.array(
   v.object({
-    localeCode: v.string(),  // "en", "ar", ...
+    localeCode: v.string(), // "en", "ar", ...
     value: v.string(),
-  })
+  }),
 ),
-
-// Stored row (DB):
-{
-  name_translations: [
-    { localeCode: "en", value: "Hello World" },
-    { localeCode: "ar", value: "مرحبا" },
-  ],
-}
+  // Stored row (DB):
+  {
+    name_translations: [
+      { localeCode: "en", value: "Hello World" },
+      { localeCode: "ar", value: "مرحبا" },
+    ],
+  });
 ```
 
 Pick the right one for the current request:
@@ -179,12 +182,12 @@ getLocalized(
 ```
 
 - **`values`** — the localized-array column.
-- **`localeCode`** *(optional)* — pin to a specific locale. Defaults to the current request's locale (reads via `useRequestStore()`).
-- **`key`** *(default `"value"`)* — which property of the matched entry to return. Use a different key if your localized objects store the value under a different name.
+- **`localeCode`** _(optional)_ — pin to a specific locale. Defaults to the current request's locale (reads via `useRequestStore()`).
+- **`key`** _(default `"value"`)_ — which property of the matched entry to return. Use a different key if your localized objects store the value under a different name.
 
 ```ts
 const slug = getLocalized(product.get("slug_translations"), undefined, "value");
-const tagline = getLocalized(product.get("name_translations"), "fr");  // force French
+const tagline = getLocalized(product.get("name_translations"), "fr"); // force French
 ```
 
 ### Use inside a resource for clean per-locale responses