Layered annotations images are not correctly included in PDF and EPUB outputs

[geealbers]

Before proceeding, make sure there isn’t an existing issue for this bug.

• I have searched the existing issues and determined this is a new bug.

Expected Behavior

Given an annotation image with input: radio like the below, I would expect that both annotation items would appear together in the PDF and EPUB, side-by-side in a grid.

  - id: "mother-variants"
    caption: "Alternate versions of Dorothea Lange’s *Migrant Mother*, 1936. Library of Congress Prints and Photographs Division."
    annotations:
      - input: radio
        items:
        - src: figures/lange-mother-b.jpg
          label: "Variant #1"
        - src: figures/lange-mother-c.jpg
          label: "Variant #2

Given an annotation image with input: checkbox like the below, I would expect that all four annotation items would appear layered over the base src image in a single pane, in the order they are listed, in the PDF and EPUB.

  - id: "mother-annotations"
    src: "figures/lange-layers/base.jpg"
    zoom: true
    caption: "This version of the print from the Library of Congress Prints and Photographs Division is mounted on paper board and includes an original FSA label. Note too the thumb seen in the lower right corner. It is also visible in the Getty‘s print, but Lange’s negative was later retouched to remove the thumb and in later prints, it is only a ghostly shadow."
    annotations:
      - input: checkbox
        items:
          - src: "figures/lange-layers/original-label.png"
            selected: true
          - src: "figures/lange-layers/additional-label.png"
          - src: "figures/lange-layers/scratches.png"
          - src: "figures/lange-layers/thumb.png"
            selected: true

Actual Behavior

Instead, in the case of input: radio images no image is include in the PDF or EPUB, and for input: checkbox images, only the src image is included, without any of its annotation layers.

Steps to Reproduce

1. Start a new project
2. Run quire build, quire pdf, and quire epub
3. Look at the resulting PDF and EPUB files

Version Numbers

[test-latest-41]
 quire-cli 1.0.0-rc.33
 quire-11ty 1.0.0-rc.41
 starter https://github.com/thegetty/quire-starter-default@2.10.0
[System]
 quire-cli 1.0.0-rc.33
 node v22.10.0
 npm 10.9.0
 os Darwin 22.6.0

Web Browser

No response

Relevant Terminal/Shell Output

Supporting Information

This issue was originally opened in Jira by @geealbers on 08/Dec/22 as DEV-13815.

[geealbers]

On 08/Dec/22 Greg commented:

I think an MVP version, if we need one, would be just to implement poster handling, which would be consistent for users with the way they need to think about video. And regardless, on the input: radio output, I recognize how difficult it could be for us to try to programatically handle all the variations (What if there are two images, or 5, or 10? What if they're all very vertical, or very horizontal? etc.) So I think we could implement one basic, sane version, and then document it and mostly count on users to fall back on the poster option.

[geealbers]

I made this work for a couple recent Getty books (https://github.com/thegetty/bronze-guidelines/ and https://github.com/thegetty/mummy-portraits-2) by outputting all the annotation images, and then using CSS to either display them inline in a grid for radio images, or stacked on top of one another with position: absolute for checkbox images.