locale layout risk audit derived

{
  "input": {
    "body": {
      "locales": [
        {
          "base": true,
          "locale": "en",
          "messages": {
            "nav": {
              "settings": "Settings",
              "notifications": "Notifications"
            },
            "errors": {
              "generic": "Something went wrong while loading your data"
            }
          }
        },
        {
          "locale": "de",
          "messages": {
            "nav": {
              "settings": "Einstellungen",
              "notifications": "Benachrichtigungen"
            },
            "errors": {
              "generic": "Beim Laden Ihrer Daten ist ein Fehler aufgetreten"
            }
          }
        },
        {
          "locale": "ja",
          "messages": {
            "nav": {
              "settings": "設定",
              "notifications": "通知"
            },
            "errors": {
              "generic": "読み込みエラー"
            }
          }
        }
      ],
      "max_characters": {
        "nav.settings": 12
      },
      "longer_tolerance": 1.5,
      "shorter_tolerance": 0.5
    },
    "type": "http",
    "method": "POST",
    "bodyType": "json"
  },
  "output": {
    "type": "json",
    "example": {
      "limits": {
        "maxKeys": 50000,
        "maxLocales": 60,
        "maxFindings": 500,
        "maxFileBytes": 2097152,
        "maxValueLength": 32768
      },
      "passed": false,
      "locales": [
        {
          "base": true,
          "locale": "en",
          "longer": 0,
          "shorter": 0,
          "compared": 0,
          "mean_ratio": 1
        },
        {
          "base": false,
          "locale": "de",
          "longer": 1,
          "shorter": 0,
          "compared": 3,
          "mean_ratio": 1.374
        },
        {
          "base": false,
          "locale": "ja",
          "longer": 0,
          "shorter": 3,
          "compared": 3,
          "mean_ratio": 0.188
        }
      ],
      "complete": true,
      "findings": [
        {
          "key": "nav.settings",
          "code": "TRANSLATION_MUCH_LONGER",
          "detail": "de nav.settings is 13 characters against 8 in the base, a ratio of 1.63. A layout built to the base length overflows or truncates here.",
          "locale": "de"
        },
        {
          "key": "nav.settings",
          "code": "OVER_DECLARED_CHARACTER_LIMIT",
          "detail": "de nav.settings is 13 characters and the declared limit is 12. Whatever enforces that limit truncates or refuses it.",
          "locale": "de"
        },
        {
          "key": "nav.settings",
          "code": "TRANSLATION_MUCH_SHORTER",
          "detail": "ja nav.settings is 2 characters against 8, a ratio of 0.25. That is usually content that did not make it across rather than a more concise language.",
          "locale": "ja"
        }
      ],
      "request_id": "example-request",
      "service_id": "locale_layout_risk_audit",
      "assumptions": [
        "Length is counted in code points rather than UTF-16 units, so an emoji or a combined character is not counted twice against a layout budget.",
        "A short absolute difference is not reported however large the ratio, because a two-character string becoming four is a ratio of two and breaks no layout.",
        "The mean ratio per locale is published, since it is the figure that tells a designer how much slack a layout needs rather than which single string is worst."
      ],
      "base_locale": "en",
      "limitations": [
        "Character counts in the files supplied. Rendered width depends on the font, the script and the layout, none of which is visible here, so a ratio is an indicator rather than a measurement of overflow.",
        "within_tolerance is true only when every compared message sat inside the stated ratios and every declared limit."
      ],
      "observed_at": "2026-10-02T00:00:00.000Z",
      "locale_count": 3,
      "not_examined": [],
      "finding_count": 5,
      "service_version": "1.0.0",
      "findings_by_code": {
        "TRANSLATION_MUCH_LONGER": 1,
        "TRANSLATION_MUCH_SHORTER": 3,
        "OVER_DECLARED_CHARACTER_LIMIT": 1
      },
      "longer_tolerance": 1.5,
      "within_tolerance": false,
      "shorter_tolerance": 0.5,
      "declared_limit_count": 1
    }
  }
}