mirror of
https://gitlab.com/ArkHost/HelixNotes.git
synced 2026-11-21 11:04:56 +01:00
Implements #254. Several images can now sit side by side in a grid or masonry layout with 2 to 4 columns. The syntax is plain Markdown images inside a `:::` container, so other renderers show the images stacked: :::img-grid cols=3 masonry   ::: Parsing is a markdown-it block rule (`helix_img_grid` in markdownParser.ts), not a text pre-pass: - Grid syntax inside code blocks is never converted, because code blocks claim those lines first. - A block converts only if every line is exactly one image (CommonMark image syntax, so titles, parentheses and <angle> destinations parse as for any image). Unknown options, out-of-range columns, captions, linked images, blank lines or a missing closer leave the whole block as ordinary Markdown. - Each grid image is an ordinary inline image token, so it gets the same source resolution, `|size=` handling and title policy as other images. Saving writes the grid as a normal block through joinMarkdownBlocks, with a blank line before it. The images serialize with the same code as images in paragraphs, one per line. The header is written in canonical form. Editor (src/lib/editor/extensions/imageGrid.ts): - `imageGrid` node (`image+`) whose renderHTML includes data-img-grid, so copied grids paste back as grids - header controls: cycle columns, grid/masonry toggle, ungroup - image toolbar: "Grid" groups the image with neighboring image-only blocks; arrow buttons move an image left or right inside its grid - drag-and-drop reorder within and between grids; an emptied grid is removed - `/image-grid` slash command: multi-file picker that inserts a grid, using the origin-guarded asset saving - mobile: 3-4 column grids collapse to 2. Print: compact 2-column rows, controls hidden Tests (tests/image-grid.test.mjs) cover byte-identical round trips, sizes, code-fenced examples, no partial conversion, titles and angle-bracket destinations, repeated saves, trailing closers, nesting, reloading next to other blocks, renderHTML/parseHTML agreement, grouping and reorder targets.