Skip to content
HALOWERK

Textwerk

pseudo localize

Maps A–Z/a–z to fixed accented look-alikes (e.g. Save → Šåṽé), so untranslated or concatenated strings stand out while staying readable. Expansion pads with ~ to the lower bound of the expansion table published by the W3C (“Text size in translation”, figures from IBM): up to 10 characters 200 %, 11–20 180 %, 21–30 160 %, 31–50 140 %, 51–70 151 %, over 70 130 %; or a fixed factor. ICU MessageFormat is parsed so that only message text is changed (selectors, argument names and # stay), and.

POST https://text.halowerk.com/v1/pseudo-localize

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
stringsarrayYesUI strings, plain or as {key, text}.
modestringNoaccented look-alike letters, or bidi (each word wrapped in RLO…PDF).
expansionSee schemaNow3c_ibm, none or a fixed length factor 1–3.
bracketsbooleanNoWrap each result in [ ] to reveal truncation.
syntaxstringNoauto parses ICU MessageFormat when the text contains braces and falls back to protecting {name} tokens.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "strings"
  ],
  "properties": {
    "strings": {
      "type": "array",
      "minItems": 1,
      "maxItems": 2000,
      "description": "UI strings, plain or as {key, text}.",
      "items": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 5000
          },
          {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "text"
            ],
            "properties": {
              "key": {
                "type": "string",
                "maxLength": 300,
                "description": "Resource key, returned unchanged."
              },
              "text": {
                "type": "string",
                "maxLength": 5000,
                "description": "String to pseudo-localize."
              }
            }
          }
        ]
      }
    },
    "mode": {
      "type": "string",
      "enum": [
        "accented",
        "bidi"
      ],
      "default": "accented",
      "description": "accented look-alike letters, or bidi (each word wrapped in RLO…PDF)."
    },
    "expansion": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "w3c_ibm",
            "none"
          ]
        },
        {
          "type": "number",
          "minimum": 1,
          "maximum": 3
        }
      ],
      "default": "w3c_ibm",
      "description": "w3c_ibm, none or a fixed length factor 1–3."
    },
    "brackets": {
      "type": "boolean",
      "default": true,
      "description": "Wrap each result in [ ] to reveal truncation."
    },
    "syntax": {
      "type": "string",
      "enum": [
        "auto",
        "icu",
        "plain"
      ],
      "default": "auto",
      "description": "auto parses ICU MessageFormat when the text contains braces and falls back to protecting {name} tokens."
    }
  }
}

Open original schema

Published input example

{
  "strings": [
    "Save",
    {
      "key": "files",
      "text": "{count, plural, one {# file} other {# files}}"
    }
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →