Validate ICU Message

Overview

You send an ICU message pattern and a locale. We parse it, inventory every argument with its inferred usage, measure nesting, and flag a missing other clause, a conflicting argument type, or a pattern that does not parse. requireOtherClause is true unless you turn it off. maxNesting defaults to 20. We never format, never execute custom functions, and never compare a translation. A successful call costs 1 execution credit.

ICU MessageFormat fails at format time when other is missing or the pattern is ill-formed. Parsing first gives a structural answer without executing it.

When to use it

Scope

Non-goals

• Does not format the message with arguments
• Does not compare a source string to a translation
• Does not validate custom functions beyond the ICU version in use

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"localization.icu_message_validate","input":{"message":"{count, plural, one {# file} other {# files}}","locale":"en-US"}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("localization.icu_message_validate", {"locale":"en-US","message":"{count, plural, one {# file} other {# files}}"});

Errors

Other limits

Limitations

• Does not format the message with arguments
• Does not compare a source string to a translation
• Does not validate custom functions beyond the ICU version in use
• Rendering the greeting with a real name
• Diffing two translations against each other

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "localization.icu_message_validate",
  "input": {
    "locale": "en-US",
    "message": "{count, plural, one {# file} other {# files}}"
  }
}

Examples

{
  "locale": "en-US",
  "message": "{count, plural, one {# file} other {# files}}"
}

{
  "nestingDepth": 1,
  "valid": true,
  "diagnostics": [],
  "truncated": false,
  "argumentCount": 1,
  "_meta": {
    "icuVersion": "76.1",
    "cldrVersion": "46.0"
  },
  "canonicalTag": "en-US",
  "arguments": [
    {
      "name": "count",
      "usage": "PLURAL",
      "occurrences": 1
    }
  ]
}

{
  "locale": "en",
  "message": "{count, plural, one {# file}}"
}

{
  "nestingDepth": 0,
  "valid": false,
  "diagnostics": [
    {
      "code": "MISSING_OTHER_CLAUSE",
      "severity": "ERROR",
      "message": "A plural or select argument is missing the required other clause.",
      "path": "/message",
      "location": {
        "utf16Offset": 0,
        "codePointOffset": 0
      },
      "source": "squillify"
    }
  ],
  "truncated": false,
  "argumentCount": 0,
  "_meta": {
    "icuVersion": "76.1",
    "cldrVersion": "46.0"
  },
  "canonicalTag": "en",
  "arguments": []
}

Recommended use cases

• Rejecting a plural pattern that forgot the other clause
• Inventorying argument names before a translator starts work

Avoid for

• Rendering the greeting with a real name
• Diffing two translations against each other

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags