paraglide js version 2.6.0

.changeset/incremental-lix-sync.md

@@ -1,6 +1,5 @@
 ---
 "@inlang/sdk": major
-"@inlang/paraglide-js": minor
 "@inlang/cli": minor
 ---
 

inlang/packages/paraglide/paraglide-js/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @inlang/paraglide-js
 
+## 2.6.0
+
+### Minor Changes
+
+- 3d6259c: Add `LocalizedString` branded type for compile-time i18n safety.
+
+  Message functions now return `LocalizedString` instead of `string`, enabling TypeScript users to distinguish between translated and untranslated strings at compile time. This is fully backward compatible since branded types are assignable to their base type.
+
+  ```typescript
+  import { m } from "./paraglide/messages.js";
+  import type { LocalizedString } from "@inlang/paraglide-js";
+
+  const greeting: LocalizedString = m.hello(); // ✓ Type-safe
+  const raw: LocalizedString = "Hello"; // ✗ Type error
+  ```
+
+- 4bde3eb: Add optional chaining to compiled message inputs so missing inputs no longer throw at runtime; include tests covering single- and multi-variant messages.
+
+  Closes https://github.com/opral/inlang-paraglide-js/issues/568
+
+  Example:
+
+  ```js
+  // compiled translation
+  export const greeting = (i) => `Hello ${i?.name}`;
+
+  // TypeScript still enforces the input shape; this is purely runtime safety (handy in dev).
+  greeting(); // no throw, returns "Hello undefined"
+  greeting({ name: "Ada" }); // "Hello Ada"
+
+  // previously (boom 💥)
+  export const greetingOld = (i) => `Hello ${i.name}`;
+  greetingOld(); // TypeError: Cannot read properties of undefined (reading 'name')
+  ```
+
 ## 2.5.0
 
 - 72d1c53: Ensure the CLI honours allowJs flags defined in extended or referenced tsconfig files instead of prompting unnecessarily.

inlang/packages/paraglide/paraglide-js/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@inlang/paraglide-js",
 	"type": "module",
-	"version": "2.5.0",
+	"version": "2.6.0",
 	"license": "MIT",
 	"publishConfig": {
 		"access": "public",

inlang/packages/paraglide/paraglide-js/src/compiler/compile-bundle.ts

@@ -107,7 +107,9 @@ ${isSafeBundleId ? "export " : ""}const ${safeBundleId} = (inputs${hasInputs ? "
 			(locale, index) =>
 				`${index > 0 ? "	" : ""}${!isFullyTranslated || index < args.availableLocales.length - 1 ? `if (locale === "${locale}") ` : ""}return ${args.messageReferenceExpression(locale, args.bundle.id)}(inputs)`
 		)
-		.join("\n")}${!isFullyTranslated ? `\n	return /** @type {LocalizedString} */ ("${args.bundle.id}")` : ""}
+		.join(
+			"\n"
+		)}${!isFullyTranslated ? `\n	return /** @type {LocalizedString} */ ("${args.bundle.id}")` : ""}
 };`;
 
 	if (isSafeBundleId === false) {