{
  "version": 1,
  "availability": "Requires an installed plugin offering the requested action; choose from its Quick Actions list",
  "docsUrl": "https://docs.hypermatic.com/hypercrop/automation/parameters",
  "inputLimits": {
    "quickActionsPasteMaxCharacters": 149,
    "maxSelectedLayers": 100,
    "rejectedAmbiguousLength": 150
  },
  "settingsPolicy": {
    "omitted": "inherit saved settings, then normal settings or documented fallback",
    "explicit": "override for this run only",
    "persistExportOverrides": false,
    "unsupportedSavedFormat": "choose an explicit supported format or use the normal panel"
  },
  "optionDefinitionFormat": "Hypermatic parameter fields v1; not JSON Schema",
  "plugin": "hypercrop",
  "parameters": [
    "command",
    "parameters"
  ],
  "contextMenu": [
    {
      "name": "Crop Selected Images",
      "menu": [
        {
          "name": "Crop to Fill…",
          "command": "menu-crop-fill-cover",
          "parameterOnly": true,
          "parameters": [
            {
              "name": "Name",
              "key": "name",
              "allowFreeform": true,
              "optional": false
            },
            {
              "name": "Width (px)",
              "key": "width",
              "allowFreeform": true,
              "optional": false
            },
            {
              "name": "Height (px)",
              "key": "height",
              "allowFreeform": true,
              "optional": false
            }
          ]
        },
        {
          "name": "Fit Inside…",
          "command": "menu-crop-fill-contain",
          "parameterOnly": true,
          "parameters": [
            {
              "name": "Name",
              "key": "name",
              "allowFreeform": true,
              "optional": false
            },
            {
              "name": "Width (px)",
              "key": "width",
              "allowFreeform": true,
              "optional": false
            },
            {
              "name": "Height (px)",
              "key": "height",
              "allowFreeform": true,
              "optional": false
            }
          ]
        },
        {
          "name": "Content-aware Crop…",
          "command": "menu-crop-smart-true",
          "parameterOnly": true,
          "parameters": [
            {
              "name": "Name",
              "key": "name",
              "allowFreeform": true,
              "optional": false
            },
            {
              "name": "Width (px)",
              "key": "width",
              "allowFreeform": true,
              "optional": false
            },
            {
              "name": "Height (px)",
              "key": "height",
              "allowFreeform": true,
              "optional": false
            }
          ]
        },
        {
          "name": "Crop Selected Images (Custom Settings…)",
          "command": "shortcut-crop",
          "parameterOnly": true,
          "parameters": [
            {
              "name": "Name",
              "key": "name",
              "allowFreeform": true,
              "optional": false
            },
            {
              "name": "Width (px)",
              "key": "width",
              "allowFreeform": true,
              "optional": false
            },
            {
              "name": "Height (px)",
              "key": "height",
              "allowFreeform": true,
              "optional": false
            },
            {
              "name": "Format",
              "key": "format",
              "allowFreeform": false,
              "optional": true
            },
            {
              "name": "Image fit",
              "key": "fill",
              "allowFreeform": false,
              "optional": true
            },
            {
              "name": "Horizontal alignment",
              "key": "horizontal",
              "allowFreeform": false,
              "optional": true
            },
            {
              "name": "Vertical alignment",
              "key": "vertical",
              "allowFreeform": false,
              "optional": true
            },
            {
              "name": "Content-aware cropping",
              "key": "smart",
              "allowFreeform": false,
              "optional": true
            }
          ]
        }
      ]
    }
  ],
  "contextPresets": [
    {
      "command": "menu-crop-fill-cover",
      "name": "Crop to Fill…",
      "action": "crop",
      "preset": {
        "fill": "cover",
        "smart": false
      },
      "parameters": [
        {
          "name": "Name",
          "key": "name",
          "allowFreeform": true,
          "optional": false
        },
        {
          "name": "Width (px)",
          "key": "width",
          "allowFreeform": true,
          "optional": false
        },
        {
          "name": "Height (px)",
          "key": "height",
          "allowFreeform": true,
          "optional": false
        }
      ]
    },
    {
      "command": "menu-crop-fill-contain",
      "name": "Fit Inside…",
      "action": "crop",
      "preset": {
        "fill": "contain",
        "smart": false
      },
      "parameters": [
        {
          "name": "Name",
          "key": "name",
          "allowFreeform": true,
          "optional": false
        },
        {
          "name": "Width (px)",
          "key": "width",
          "allowFreeform": true,
          "optional": false
        },
        {
          "name": "Height (px)",
          "key": "height",
          "allowFreeform": true,
          "optional": false
        }
      ]
    },
    {
      "command": "menu-crop-smart-true",
      "name": "Content-aware Crop…",
      "action": "crop",
      "preset": {
        "fill": "cover",
        "smart": true
      },
      "parameters": [
        {
          "name": "Name",
          "key": "name",
          "allowFreeform": true,
          "optional": false
        },
        {
          "name": "Width (px)",
          "key": "width",
          "allowFreeform": true,
          "optional": false
        },
        {
          "name": "Height (px)",
          "key": "height",
          "allowFreeform": true,
          "optional": false
        }
      ]
    }
  ],
  "shortcuts": [
    {
      "command": "open",
      "name": "Open HyperCrop",
      "action": "open",
      "advanced": false,
      "parameters": [],
      "target": "none"
    },
    {
      "command": "shortcut-crop",
      "name": "Crop Selected Images (Custom Settings…)",
      "action": "crop",
      "advanced": false,
      "parameters": [
        {
          "name": "Name",
          "key": "name",
          "allowFreeform": true,
          "optional": false
        },
        {
          "name": "Width (px)",
          "key": "width",
          "allowFreeform": true,
          "optional": false
        },
        {
          "name": "Height (px)",
          "key": "height",
          "allowFreeform": true,
          "optional": false
        },
        {
          "name": "Format",
          "key": "format",
          "allowFreeform": false,
          "optional": true
        },
        {
          "name": "Image fit",
          "key": "fill",
          "allowFreeform": false,
          "optional": true
        },
        {
          "name": "Horizontal alignment",
          "key": "horizontal",
          "allowFreeform": false,
          "optional": true
        },
        {
          "name": "Vertical alignment",
          "key": "vertical",
          "allowFreeform": false,
          "optional": true
        },
        {
          "name": "Content-aware cropping",
          "key": "smart",
          "allowFreeform": false,
          "optional": true
        }
      ],
      "mapping": "name, width and height form one sizes item",
      "target": "current selection"
    }
  ],
  "actions": {
    "open": {
      "description": "Open the normal interactive plugin",
      "fields": {},
      "target": "none",
      "execution": "builtin"
    },
    "crop": {
      "description": "Crop selected layers to named sizes and download a ZIP",
      "fields": {
        "name": {
          "type": "string",
          "min": 1,
          "max": 120,
          "required": true,
          "description": "Name of the new item"
        },
        "width": {
          "type": "number",
          "min": 1,
          "max": 8192,
          "required": true,
          "description": "Width in pixels"
        },
        "height": {
          "type": "number",
          "min": 1,
          "max": 8192,
          "required": true,
          "description": "Height in pixels"
        },
        "format": {
          "type": "string",
          "values": [
            "jpg",
            "png"
          ],
          "default": "jpg",
          "description": "Image format"
        },
        "fill": {
          "type": "string",
          "values": [
            "cover",
            "contain"
          ],
          "default": "cover",
          "description": "Crop or contain the source"
        },
        "horizontal": {
          "type": "string",
          "values": [
            "left",
            "center",
            "right"
          ],
          "default": "center",
          "description": "Horizontal alignment"
        },
        "vertical": {
          "type": "string",
          "values": [
            "top",
            "center",
            "bottom"
          ],
          "default": "center",
          "description": "Vertical alignment"
        },
        "smart": {
          "type": "boolean",
          "default": false,
          "description": "Use content-aware cropping without face detection"
        }
      },
      "target": "many",
      "execution": "worker"
    }
  },
  "examples": {
    "crop": {
      "name": "Square",
      "width": "1080",
      "height": "1080",
      "format": "jpg",
      "fill": "cover",
      "horizontal": "center",
      "vertical": "center",
      "smart": "false"
    }
  },
  "limitsAndBehavior": "Crop shortcuts export selected images at one named size. Format, alignment and other detailed choices use Custom Settings; save reusable crop sizes in the normal panel.",
  "entitlement": {
    "verificationRequired": true,
    "validLicenseOrRemainingTrials": true,
    "openPanelExempt": true
  },
  "completion": {
    "deadlineMs": 300000,
    "visibleNotifications": true,
    "nativeSaveDialog": true,
    "verifySavedArtifact": true
  },
  "invocation": "Figma Quick Actions or a verified host launcher; no REST/MCP launcher is provided",
  "results": "Normal Figma success/error notifications, document changes, native file downloads and published pages"
}
