Pseudo Localizer

A tiny utility that brings harmony to content authors and developers.

Why?

Most pseudo localization techniques mangle strings based on their ASCII values which creates two problems:

1. Pseudo localization doesn't work with non-ASCII encodings
2. Fuzzy matching doesn't work (ex: /Hello/.test('Ḥḛḛḽḽṓṓ') vs /Hello/.test('_Hello--_'))

pseudo-localizer works by taking the current string as-is and adds padding around the strings so fuzzy matches still behave properly.

Install

npm i pseudo-localizer

Usage

pseudo-localizer works in the browser, node, and deno. pseudo-localizer exports a single function that takes a string and options.

import { pseudo } from 'pseudo-localizer';

pseudo('Hello'); // Hello--
pseudo('Hello', { prefix: '_' }); // _Hello--
pseudo('Hello', { letterMultiplier: 2 }); // _Hello----

Fixed-Length Expansion

Sometimes you want to expand all strings by a percentage:

import { pseudo } from 'pseudo-localizer';

pseudo('Ahoy, matey!', { mode: 'fixed' }); // Ahoy, matey!---
pseudo('Ahoy, matey!', { mode: 'fixed', fixedMultiplier: 0.75 }); // Ahoy, matey!---------

Options

Name	Type	Default Value	Required	Description
mode	'fixed' \| 'vowels'	'vowels'	No	Set fixed to manually specify the string length multiplier
prefix	string		No	Set a prefix to use before the pseudo string
suffix	string		No	Set a suffix to use after the pseudo string
pad	string	'-'	No	Set the pad character
vowels	string[] \| Set<string>	[a,e,i,o,u,A,E,I,O,U]	No	Override the vowels list for non-English locales
fixedMultiplier	number	0.3	No	In fixed mode, override the fixed multiplier as a percentage of the original string length
letterMultiplier	number	1	No	Specify a custom letter multiplier in vowel mode