card-template-format

Define one element in the imageSlots array per day, each with a unique key (d1, d2, ...), label, position (x, y), size (width, height), and optional corner radius. Set the canvas dimensions and baseImagePath, then configure textPositions for nickname, category, and message areas.

A template includes baseImagePath, canvas (width, height, downloadWidth, downloadHeight), upload (maxFileSizeBytes), imageSlots array, titleImage, and textPositions. Optional keys are fontColor for text color override and categorySelection for identity circle-selection boxes.

Images are cover-cropped and clipped to each slot, with optional rounded corners via the radius key. If the image aspect ratio is wider than the slot, height fills and the image centers horizontally with an offset from imageOffsets; otherwise width fills and it centers vertically.

Each imageSlot can have a dateRole box where text renders as '<date> <role name>'. The date uses MM-DD format from dayDetails, and the role comes from the cosrole field; empty values are omitted, and if both are empty nothing displays.

The uploaded base image (baseImageData) takes priority over the template's baseImagePath and is drawn with cover scaling to fill the canvas. If no upload exists, the template's built-in base image is stretched to its original dimensions.