@worldware/msg 0.6.3 → 0.7.0

package/README.md

@@ -8,6 +8,7 @@ A TypeScript library for managing internationalization (i18n) messages with supp
 
 - **Message Management**: Organize messages into resources with keys and values
 - **Translation Loading**: Load translations from external sources via customizable loaders
+- **Pseudo Localization**: Request a pseudolocalized resource for UI testing via `getTranslation(pseudoLocale)`
 - **Message Formatting**: Format messages with parameters using MessageFormat 2 (MF2) syntax
 - **Attributes & Notes**: Attach metadata (language, direction, do-not-translate flags) and notes to messages
 - **Project Configuration**: Configure projects with locale settings and translation loaders
@@ -25,6 +26,7 @@ npm install @worldware/msg
 A project configuration that defines:
 - Project name and version
 - Source and target locales (with language fallback chains)
+- Pseudo locale (for pseudolocalized output via `getTranslation`)
 - A translation loader function
 
 ### MsgResource
@@ -89,7 +91,7 @@ const resource = MsgResource.create({
   messages: [
     {
       key: 'greeting',
-      value: 'Hello, {name}!'
+      value: 'Hello, {$name}!'
     },
     {
       key: 'welcome',
@@ -99,7 +101,7 @@ const resource = MsgResource.create({
 }, project);
 
 // Or add messages programmatically
-resource.add('goodbye', 'Goodbye, {name}!', {
+resource.add('goodbye', 'Goodbye, {$name}!', {
   lang: 'en',
   dir: 'ltr'
 });
@@ -124,11 +126,25 @@ const spanishResource = await resource.getTranslation('es');
 // falling back to the source messages for missing translations
 ```
 
+### Pseudo Localization
+
+When `getTranslation` is called with the project's `pseudoLocale` (e.g. `en-XA`), it returns a new resource with pseudolocalized message values—useful for testing UI layout and finding hardcoded strings without loading translation files:
+
+```typescript
+// Request pseudolocalized messages (project locales.pseudoLocale is 'en-XA')
+const pseudoResource = await resource.getTranslation('en-XA');
+
+// Message values are transformed: "Hello, {$name}!" → "Ħḗḗŀŀǿǿ, {$name}!"
+// Variables and MF2 syntax are preserved; only literal text is pseudolocalized
+const greeting = pseudoResource.get('greeting')?.format({ name: 'Alice' });
+// Result: "Ħḗḗŀŀǿǿ, Alice!"
+```
+
 ### Working with Attributes and Notes
 
 ```typescript
 // Add notes to messages
-resource.add('complex-message', 'This is a complex message', {
+resource.add('complex-message', 'You have {$count} items', {
   lang: 'en',
   dir: 'ltr',
   dnt: false // do-not-translate flag
@@ -188,7 +204,7 @@ const data = resource.getData();
 **Methods:**
 - `add(key: string, value: string, attributes?: MsgAttributes, notes?: MsgNote[]): MsgResource` - Add a message
 - `translate(data: MsgResourceData): MsgResource` - Create a translated version
-- `getTranslation(lang: string): Promise<MsgResource>` - Load and apply translations
+- `getTranslation(lang: string): Promise<MsgResource>` - Load and apply translations. When `lang` matches the project's `pseudoLocale`, returns a resource with pseudolocalized message values instead of loading from the loader.
 - `getProject(): MsgProject` - Returns the project instance associated with the resource
 - `getData(stripNotes?: boolean): MsgResourceData` - Get resource data. Message objects in the output omit `attributes` when they match the resource's attributes (to avoid redundancy)
 - `toJSON(stripNotes?: boolean): string` - Serialize to JSON

package/dist/{chunk-7LI2M4JY.mjs → chunk-2QUOYESW.mjs}

@@ -6,6 +6,8 @@ import {
 } from "./chunk-QWBDIKQK.mjs";
 
 // src/classes/MsgResource/MsgResource.ts
+import { parseMessage, stringifyMessage, visit } from "messageformat";
+import { localize } from "pseudo-localization";
 var MsgResource = class _MsgResource extends Map {
   _attributes = {};
   _notes = [];
@@ -38,6 +40,20 @@ var MsgResource = class _MsgResource extends Map {
     const msg = message.attributes;
     return res.lang === msg.lang && res.dir === msg.dir && res.dnt === msg.dnt;
   }
+  pseudoLocalizeMF2(source, options) {
+    const msg = parseMessage(source);
+    visit(msg, {
+      pattern: (pattern) => {
+        for (let i = 0; i < pattern.length; i++) {
+          const part = pattern[i];
+          if (typeof part === "string") {
+            pattern[i] = localize(part, options);
+          }
+        }
+      }
+    });
+    return stringifyMessage(msg);
+  }
   get attributes() {
     return this._attributes;
   }
@@ -104,6 +120,23 @@ var MsgResource = class _MsgResource extends Map {
   }
   async getTranslation(lang) {
     const project = this._project;
+    const pseudoLocale = project.locales.pseudoLocale;
+    if (lang === pseudoLocale) {
+      const pseudolocalizedData = {
+        title: this.title,
+        attributes: { ...this.attributes, lang: pseudoLocale },
+        notes: this.notes.length > 0 ? this.notes : void 0,
+        messages: []
+      };
+      this.forEach((msg) => {
+        pseudolocalizedData.messages.push({
+          key: msg.key,
+          value: this.pseudoLocalizeMF2(msg.value),
+          attributes: { ...this.attributes, lang: pseudoLocale }
+        });
+      });
+      return this.translate(pseudolocalizedData);
+    }
     const languageChain = project.getTargetLocale(lang);
     if (!languageChain) {
       throw new Error("Unsupported locale for resource.");
@@ -124,7 +157,12 @@ var MsgResource = class _MsgResource extends Map {
     const messages = [];
     this.forEach((msg) => {
       if (this.hasMatchingAttributes(msg)) {
-        messages.push({ key: msg.key, value: msg.value });
+        const data = {
+          key: msg.key,
+          value: msg.value,
+          notes: !stripNotes && msg.notes.length > 0 ? msg.notes : void 0
+        };
+        messages.push(data);
       } else {
         messages.push(msg.getData(stripNotes));
       }

package/dist/classes/MsgProject/MsgProject.d.cts

@@ -46,6 +46,7 @@ declare class MsgResource extends Map<string, MsgMessage> implements MsgInterfac
     static create(data: MsgResourceData, project: MsgProject): MsgResource;
     private constructor();
     private hasMatchingAttributes;
+    private pseudoLocalizeMF2;
     get attributes(): MsgAttributes;
     set attributes(attributes: MsgAttributes);
     get notes(): MsgNote[];

package/dist/classes/MsgProject/MsgProject.d.ts

@@ -46,6 +46,7 @@ declare class MsgResource extends Map<string, MsgMessage> implements MsgInterfac
     static create(data: MsgResourceData, project: MsgProject): MsgResource;
     private constructor();
     private hasMatchingAttributes;
+    private pseudoLocalizeMF2;
     get attributes(): MsgAttributes;
     set attributes(attributes: MsgAttributes);
     get notes(): MsgNote[];

package/dist/classes/MsgResource/MsgResource.cjs

@@ -23,6 +23,8 @@ __export(MsgResource_exports, {
   MsgResource: () => MsgResource
 });
 module.exports = __toCommonJS(MsgResource_exports);
+var import_messageformat2 = require("messageformat");
+var import_pseudo_localization = require("pseudo-localization");
 
 // src/classes/MsgMessage/MsgMessage.ts
 var import_messageformat = require("messageformat");
@@ -130,6 +132,20 @@ var MsgResource = class _MsgResource extends Map {
     const msg = message.attributes;
     return res.lang === msg.lang && res.dir === msg.dir && res.dnt === msg.dnt;
   }
+  pseudoLocalizeMF2(source, options) {
+    const msg = (0, import_messageformat2.parseMessage)(source);
+    (0, import_messageformat2.visit)(msg, {
+      pattern: (pattern) => {
+        for (let i = 0; i < pattern.length; i++) {
+          const part = pattern[i];
+          if (typeof part === "string") {
+            pattern[i] = (0, import_pseudo_localization.localize)(part, options);
+          }
+        }
+      }
+    });
+    return (0, import_messageformat2.stringifyMessage)(msg);
+  }
   get attributes() {
     return this._attributes;
   }
@@ -196,6 +212,23 @@ var MsgResource = class _MsgResource extends Map {
   }
   async getTranslation(lang) {
     const project = this._project;
+    const pseudoLocale = project.locales.pseudoLocale;
+    if (lang === pseudoLocale) {
+      const pseudolocalizedData = {
+        title: this.title,
+        attributes: { ...this.attributes, lang: pseudoLocale },
+        notes: this.notes.length > 0 ? this.notes : void 0,
+        messages: []
+      };
+      this.forEach((msg) => {
+        pseudolocalizedData.messages.push({
+          key: msg.key,
+          value: this.pseudoLocalizeMF2(msg.value),
+          attributes: { ...this.attributes, lang: pseudoLocale }
+        });
+      });
+      return this.translate(pseudolocalizedData);
+    }
     const languageChain = project.getTargetLocale(lang);
     if (!languageChain) {
       throw new Error("Unsupported locale for resource.");
@@ -216,7 +249,12 @@ var MsgResource = class _MsgResource extends Map {
     const messages = [];
     this.forEach((msg) => {
       if (this.hasMatchingAttributes(msg)) {
-        messages.push({ key: msg.key, value: msg.value });
+        const data = {
+          key: msg.key,
+          value: msg.value,
+          notes: !stripNotes && msg.notes.length > 0 ? msg.notes : void 0
+        };
+        messages.push(data);
       } else {
         messages.push(msg.getData(stripNotes));
       }

package/dist/classes/MsgResource/MsgResource.mjs

@@ -1,6 +1,6 @@
 import {
   MsgResource
-} from "../../chunk-7LI2M4JY.mjs";
+} from "../../chunk-2QUOYESW.mjs";
 import "../../chunk-WUDKNZV2.mjs";
 import "../../chunk-QWBDIKQK.mjs";
 export {

package/dist/classes/index.cjs

@@ -100,6 +100,8 @@ var MsgMessage = class _MsgMessage {
 };
 
 // src/classes/MsgResource/MsgResource.ts
+var import_messageformat2 = require("messageformat");
+var import_pseudo_localization = require("pseudo-localization");
 var MsgResource = class _MsgResource extends Map {
   _attributes = {};
   _notes = [];
@@ -132,6 +134,20 @@ var MsgResource = class _MsgResource extends Map {
     const msg = message.attributes;
     return res.lang === msg.lang && res.dir === msg.dir && res.dnt === msg.dnt;
   }
+  pseudoLocalizeMF2(source, options) {
+    const msg = (0, import_messageformat2.parseMessage)(source);
+    (0, import_messageformat2.visit)(msg, {
+      pattern: (pattern) => {
+        for (let i = 0; i < pattern.length; i++) {
+          const part = pattern[i];
+          if (typeof part === "string") {
+            pattern[i] = (0, import_pseudo_localization.localize)(part, options);
+          }
+        }
+      }
+    });
+    return (0, import_messageformat2.stringifyMessage)(msg);
+  }
   get attributes() {
     return this._attributes;
   }
@@ -198,6 +214,23 @@ var MsgResource = class _MsgResource extends Map {
   }
   async getTranslation(lang) {
     const project = this._project;
+    const pseudoLocale = project.locales.pseudoLocale;
+    if (lang === pseudoLocale) {
+      const pseudolocalizedData = {
+        title: this.title,
+        attributes: { ...this.attributes, lang: pseudoLocale },
+        notes: this.notes.length > 0 ? this.notes : void 0,
+        messages: []
+      };
+      this.forEach((msg) => {
+        pseudolocalizedData.messages.push({
+          key: msg.key,
+          value: this.pseudoLocalizeMF2(msg.value),
+          attributes: { ...this.attributes, lang: pseudoLocale }
+        });
+      });
+      return this.translate(pseudolocalizedData);
+    }
     const languageChain = project.getTargetLocale(lang);
     if (!languageChain) {
       throw new Error("Unsupported locale for resource.");
@@ -218,7 +251,12 @@ var MsgResource = class _MsgResource extends Map {
     const messages = [];
     this.forEach((msg) => {
       if (this.hasMatchingAttributes(msg)) {
-        messages.push({ key: msg.key, value: msg.value });
+        const data = {
+          key: msg.key,
+          value: msg.value,
+          notes: !stripNotes && msg.notes.length > 0 ? msg.notes : void 0
+        };
+        messages.push(data);
       } else {
         messages.push(msg.getData(stripNotes));
       }

package/dist/classes/index.mjs

@@ -4,7 +4,7 @@ import {
 } from "../chunk-XS43NAP2.mjs";
 import {
   MsgResource
-} from "../chunk-7LI2M4JY.mjs";
+} from "../chunk-2QUOYESW.mjs";
 import {
   MsgMessage
 } from "../chunk-WUDKNZV2.mjs";

package/dist/index.cjs

@@ -100,6 +100,8 @@ var MsgMessage = class _MsgMessage {
 };
 
 // src/classes/MsgResource/MsgResource.ts
+var import_messageformat2 = require("messageformat");
+var import_pseudo_localization = require("pseudo-localization");
 var MsgResource = class _MsgResource extends Map {
   _attributes = {};
   _notes = [];
@@ -132,6 +134,20 @@ var MsgResource = class _MsgResource extends Map {
     const msg = message.attributes;
     return res.lang === msg.lang && res.dir === msg.dir && res.dnt === msg.dnt;
   }
+  pseudoLocalizeMF2(source, options) {
+    const msg = (0, import_messageformat2.parseMessage)(source);
+    (0, import_messageformat2.visit)(msg, {
+      pattern: (pattern) => {
+        for (let i = 0; i < pattern.length; i++) {
+          const part = pattern[i];
+          if (typeof part === "string") {
+            pattern[i] = (0, import_pseudo_localization.localize)(part, options);
+          }
+        }
+      }
+    });
+    return (0, import_messageformat2.stringifyMessage)(msg);
+  }
   get attributes() {
     return this._attributes;
   }
@@ -198,6 +214,23 @@ var MsgResource = class _MsgResource extends Map {
   }
   async getTranslation(lang) {
     const project = this._project;
+    const pseudoLocale = project.locales.pseudoLocale;
+    if (lang === pseudoLocale) {
+      const pseudolocalizedData = {
+        title: this.title,
+        attributes: { ...this.attributes, lang: pseudoLocale },
+        notes: this.notes.length > 0 ? this.notes : void 0,
+        messages: []
+      };
+      this.forEach((msg) => {
+        pseudolocalizedData.messages.push({
+          key: msg.key,
+          value: this.pseudoLocalizeMF2(msg.value),
+          attributes: { ...this.attributes, lang: pseudoLocale }
+        });
+      });
+      return this.translate(pseudolocalizedData);
+    }
     const languageChain = project.getTargetLocale(lang);
     if (!languageChain) {
       throw new Error("Unsupported locale for resource.");
@@ -218,7 +251,12 @@ var MsgResource = class _MsgResource extends Map {
     const messages = [];
     this.forEach((msg) => {
       if (this.hasMatchingAttributes(msg)) {
-        messages.push({ key: msg.key, value: msg.value });
+        const data = {
+          key: msg.key,
+          value: msg.value,
+          notes: !stripNotes && msg.notes.length > 0 ? msg.notes : void 0
+        };
+        messages.push(data);
       } else {
         messages.push(msg.getData(stripNotes));
       }

package/dist/index.mjs

@@ -4,7 +4,7 @@ import {
 } from "./chunk-XS43NAP2.mjs";
 import {
   MsgResource
-} from "./chunk-7LI2M4JY.mjs";
+} from "./chunk-2QUOYESW.mjs";
 import {
   MsgMessage
 } from "./chunk-WUDKNZV2.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@worldware/msg",
-  "version": "0.6.3",
+  "version": "0.7.0",
   "description": "Message localization tooling",
   "license": "MIT",
   "author": "Joel Sahleen",
@@ -38,7 +38,8 @@
     "vitest": "^4.0.15"
   },
   "dependencies": {
-    "messageformat": "4.0.0-10"
+    "messageformat": "4.0.0-10",
+    "pseudo-localization": "^2.4.0"
   },
   "scripts": {
     "build": "tsup",