Group Actions & Sub-Menus

Group Manifest Declaration

Organize related tools into an expandable menu container using "type": "group":

{
  "identifier": "com.example.casetools",
  "name": "Case Converters",
  "actions": [
    {
      "id": "group",
      "title": "Case Tools",
      "type": "group",
      "icon": "symbol(textformat)",
      "subActions": [
        {
          "id": "upper",
          "title": "UPPERCASE",
          "type": "javascript",
          "script": "upper.js"
        },
        {
          "id": "lower",
          "title": "lowercase",
          "type": "javascript",
          "script": "lower.js"
        }
      ]
    }
  ]
}

Uniform ID Prefix Convention

OpenClip automatically namespace-prefixes sub-actions based on the parent group ID:

• Group Action ID: com.example.casetools.group
• Child Sub-Action IDs: com.example.casetools.group.upper and com.example.casetools.group.lower
• Sub-actions automatically inherit the parent group icon if not explicitly set.

Sub-Menu Relevance Filtering

Sub-actions can declare "menuRelevance": "<regex>". If the current selection fails to match the regular expression, the sub-action is automatically hidden from the sub-menu to avoid redundant options.