@colixsystems/widget-sdk 0.40.1 → 0.40.2

package/README.md

@@ -47,7 +47,11 @@ See the design reference for the full architecture: [`docs/architecture/widget-m
 
 ## Status
 
-`v0.40.1` — pre-publish. The package surface (types, function names, export paths) is the v1 contract; runtime behaviour for some hooks is stubbed (each hook documents what's wired and what isn't). It is **not yet published to npm**.
+`v0.40.2` — pre-publish. The package surface (types, function names, export paths) is the v1 contract; runtime behaviour for some hooks is stubbed (each hook documents what's wired and what isn't). It is **not yet published to npm**.
+
+### What's new in 0.40.2
+
+**`useI18n().t()` no longer leaks the host's `{{t:key}}` miss placeholder.** Resolution steps 1–2 (per-widget and shared namespaces) already treated a `{{t:…}}` return from the host as a miss, but the final raw-key step did not — on the web Player (whose host resolver returns the placeholder form on a miss and ignores the fallback argument) a key absent from the tenant dictionary rendered as literal `{{t:key}}` text instead of degrading to `fallback ?? key`. The same guard now applies to all three steps. **The public contract is unchanged** — this is the behaviour `useI18n` always documented. `CONTRACT.version` is unchanged.
 
 ### What's new in 0.40.1
 

package/dist/hooks.js

@@ -270,8 +270,17 @@ export function useI18n() {
         }
         // 3) Fall back to the raw key (shared app keys + widgets with no
         //    manifest translations — unchanged from pre-1.10 behaviour).
+        //    The same `{{t:…}}` miss guard as steps 1–2 applies: the Player's
+        //    host t ignores the fallback arg and returns the placeholder on a
+        //    miss, and without the guard that placeholder rendered verbatim
+        //    instead of degrading to `fallback ?? key`.
         const out = hostT(key, fallback);
-        if (typeof out === "string" && out.length > 0 && out !== key) {
+        if (
+          typeof out === "string" &&
+          out.length > 0 &&
+          out !== key &&
+          !out.startsWith("{{t:")
+        ) {
           return out;
         }
         // Host returned the key (unresolved) or nothing usable.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colixsystems/widget-sdk",
-  "version": "0.40.1",
+  "version": "0.40.2",
   "description": "Common widget interface for AppStudio. Implements WidgetManifest, WidgetContext, property schema, and helper hooks.",
   "type": "module",
   "main": "./dist/index.js",