@contentrain/astro-kit 0.31.0 → 0.32.0

package/components/post-list/fixtures.json

@@ -0,0 +1,387 @@
+[
+  {
+    "name": "grid-3",
+    "props": {
+      "id": "posts",
+      "heading": "Latest posts",
+      "posts": [
+        {
+          "title": "What a careful migration keeps",
+          "href": "/blog/post-1/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-21T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-1.svg",
+            "alt": "Photo 1",
+            "width": 1200,
+            "height": 800
+          }
+        },
+        {
+          "title": "Designing for a hundred pages",
+          "href": "/blog/post-2/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-22T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-2.svg",
+            "alt": "Photo 2",
+            "width": 1200,
+            "height": 800
+          }
+        },
+        {
+          "title": "Redirects, one by one",
+          "href": "/blog/post-3/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-23T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-3.svg",
+            "alt": "Photo 3",
+            "width": 1200,
+            "height": 800
+          }
+        }
+      ]
+    }
+  },
+  {
+    "name": "list",
+    "props": {
+      "layout": "list",
+      "posts": [
+        {
+          "title": "What a careful migration keeps",
+          "href": "/blog/post-1/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-21T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-1.svg",
+            "alt": "Photo 1",
+            "width": 1200,
+            "height": 800
+          }
+        },
+        {
+          "title": "Designing for a hundred pages",
+          "href": "/blog/post-2/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-22T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-2.svg",
+            "alt": "Photo 2",
+            "width": 1200,
+            "height": 800
+          }
+        },
+        {
+          "title": "Redirects, one by one",
+          "href": "/blog/post-3/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-23T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-3.svg",
+            "alt": "Photo 3",
+            "width": 1200,
+            "height": 800
+          }
+        }
+      ],
+      "excerptLines": 2
+    }
+  },
+  {
+    "name": "featured-4",
+    "props": {
+      "layout": "featured",
+      "columns": "4",
+      "heading": "Journal",
+      "intro": "Notes from the studio.",
+      "posts": [
+        {
+          "title": "What a careful migration keeps",
+          "href": "/blog/post-1/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-21T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-1.svg",
+            "alt": "Photo 1",
+            "width": 1200,
+            "height": 800
+          }
+        },
+        {
+          "title": "Designing for a hundred pages",
+          "href": "/blog/post-2/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-22T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-2.svg",
+            "alt": "Photo 2",
+            "width": 1200,
+            "height": 800
+          }
+        },
+        {
+          "title": "Redirects, one by one",
+          "href": "/blog/post-3/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-23T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-3.svg",
+            "alt": "Photo 3",
+            "width": 1200,
+            "height": 800
+          }
+        },
+        {
+          "title": "A very long title that keeps going well past one line to prove the card wraps it without clipping",
+          "href": "/blog/post-4/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-24T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-4.svg",
+            "alt": "Photo 4",
+            "width": 1200,
+            "height": 800
+          }
+        }
+      ]
+    }
+  },
+  {
+    "name": "compact",
+    "props": {
+      "layout": "compact",
+      "heading": "Recent",
+      "posts": [
+        {
+          "title": "What a careful migration keeps",
+          "href": "/blog/post-1/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-21T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-1.svg",
+            "alt": "Photo 1",
+            "width": 1200,
+            "height": 800
+          }
+        },
+        {
+          "title": "Designing for a hundred pages",
+          "href": "/blog/post-2/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-22T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-2.svg",
+            "alt": "Photo 2",
+            "width": 1200,
+            "height": 800
+          }
+        },
+        {
+          "title": "Redirects, one by one",
+          "href": "/blog/post-3/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-23T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-3.svg",
+            "alt": "Photo 3",
+            "width": 1200,
+            "height": 800
+          }
+        },
+        {
+          "title": "A very long title that keeps going well past one line to prove the card wraps it without clipping",
+          "href": "/blog/post-4/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-24T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-4.svg",
+            "alt": "Photo 4",
+            "width": 1200,
+            "height": 800
+          }
+        }
+      ],
+      "moreHref": "/blog/",
+      "moreLabel": "All posts"
+    }
+  },
+  {
+    "name": "grid-2-no-parts",
+    "props": {
+      "columns": "2",
+      "showImage": false,
+      "showAuthor": false,
+      "showCategory": false,
+      "posts": [
+        {
+          "title": "What a careful migration keeps",
+          "href": "/blog/post-1/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-21T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-1.svg",
+            "alt": "Photo 1",
+            "width": 1200,
+            "height": 800
+          }
+        },
+        {
+          "title": "Designing for a hundred pages",
+          "href": "/blog/post-2/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-22T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-2.svg",
+            "alt": "Photo 2",
+            "width": 1200,
+            "height": 800
+          }
+        }
+      ]
+    }
+  },
+  {
+    "name": "missing-image-excerpt",
+    "props": {
+      "surface": "card",
+      "posts": [
+        {
+          "title": "What a careful migration keeps",
+          "href": "/blog/post-1/",
+          "date": "2026-09-21T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač"
+        },
+        {
+          "title": "Designing for a hundred pages",
+          "href": "/blog/post-2/",
+          "date": "2026-09-22T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač"
+        },
+        {
+          "title": "Redirects, one by one",
+          "href": "/blog/post-3/",
+          "date": "2026-09-23T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač"
+        }
+      ]
+    }
+  },
+  {
+    "name": "single-post",
+    "props": {
+      "posts": [
+        {
+          "title": "What a careful migration keeps",
+          "href": "/blog/post-1/",
+          "excerpt": "What a careful migration keeps: addresses, formatting and rankings, block by block.",
+          "date": "2026-09-21T09:00:00Z",
+          "category": {
+            "label": "Guides",
+            "href": "/category/guides/"
+          },
+          "author": "Mira Kovač",
+          "image": {
+            "src": "/kit-fixtures/photo-1.svg",
+            "alt": "Photo 1",
+            "width": 1200,
+            "height": 800
+          }
+        }
+      ]
+    }
+  }
+]

package/components/post-list/meta.json

@@ -0,0 +1,308 @@
+{
+  "id": "post-list",
+  "name": "Post list",
+  "description": "A list of posts as cards: a grid, stacked rows, a featured first post over a grid, or a compact title-and-date list. The posts come from the site's own collection; the switches decide which parts of a card show.",
+  "category": "section",
+  "uses": [
+    "post-card"
+  ],
+  "shared": [
+    "Section.astro",
+    "measured.ts",
+    "types.ts"
+  ],
+  "variants": {
+    "layout": {
+      "options": [
+        "grid",
+        "list",
+        "featured",
+        "compact"
+      ],
+      "default": "grid",
+      "description": "grid: cards in columns. list: stacked horizontal cards. featured: the first post large over a grid. compact: title and date only."
+    },
+    "columns": {
+      "options": [
+        "2",
+        "3",
+        "4"
+      ],
+      "default": "3",
+      "description": "Cards per row on wide screens (grid and featured)."
+    }
+  },
+  "props": {
+    "heading": {
+      "type": "string",
+      "label": "Heading",
+      "description": "Section heading above the posts."
+    },
+    "intro": {
+      "type": "text",
+      "label": "Intro",
+      "description": "A line or two under the heading."
+    },
+    "posts": {
+      "type": "array",
+      "label": "Posts",
+      "required": true,
+      "content": false,
+      "description": "The posts to show, newest first: from the posts collection (the query SDK), never copied from a page.",
+      "items": {
+        "type": "object",
+        "fields": {
+          "title": {
+            "type": "string",
+            "required": true
+          },
+          "href": {
+            "type": "url",
+            "required": true
+          },
+          "excerpt": {
+            "type": "text"
+          },
+          "date": {
+            "type": "datetime"
+          },
+          "image": {
+            "type": "object",
+            "fields": {
+              "src": {
+                "type": "image",
+                "required": true
+              },
+              "alt": {
+                "type": "string",
+                "required": true
+              },
+              "width": {
+                "type": "integer"
+              },
+              "height": {
+                "type": "integer"
+              }
+            }
+          },
+          "category": {
+            "type": "object",
+            "fields": {
+              "label": {
+                "type": "string",
+                "required": true
+              },
+              "href": {
+                "type": "url",
+                "required": true
+              }
+            }
+          },
+          "author": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "showImage": {
+      "type": "boolean",
+      "default": true,
+      "content": false,
+      "description": "Show each post's cover."
+    },
+    "showExcerpt": {
+      "type": "boolean",
+      "default": true,
+      "content": false,
+      "description": "Show each post's excerpt."
+    },
+    "showAuthor": {
+      "type": "boolean",
+      "default": true,
+      "content": false,
+      "description": "Show each post's author."
+    },
+    "showCategory": {
+      "type": "boolean",
+      "default": true,
+      "content": false,
+      "description": "Show each post's category."
+    },
+    "excerptLines": {
+      "type": "integer",
+      "min": 2,
+      "max": 4,
+      "content": false,
+      "description": "Clamp each excerpt to this many lines."
+    },
+    "locale": {
+      "type": "string",
+      "content": false,
+      "description": "BCP 47 locale the dates are written in (site.language)."
+    },
+    "surface": {
+      "type": "string",
+      "content": false,
+      "description": "plain or card: whether each post is a card of its own (post-card surface)."
+    },
+    "moreHref": {
+      "type": "url",
+      "content": false,
+      "description": "Where the full archive lives; with moreLabel a link follows the list."
+    },
+    "moreLabel": {
+      "type": "string",
+      "content": false,
+      "description": "Text of the archive link."
+    },
+    "tone": {
+      "type": "string",
+      "content": false,
+      "description": "Section background: default, muted, inverse or accent."
+    },
+    "id": {
+      "type": "string",
+      "content": false,
+      "description": "Anchor id of the section; the heading gets `<id>-title`."
+    },
+    "measured": {
+      "type": "object",
+      "content": false,
+      "description": "The source section's measured style (MeasuredStyle): frame width, padding, fill, image, columns per width, gap, text tone, radius, minimum height — all in pixels. Absent, the site's tokens; present, it wins over tone and columns. Values that are not a number, a colour or a known keyword are dropped.",
+      "fields": {
+        "containerPx": {
+          "type": "integer",
+          "min": 0,
+          "max": 2560,
+          "description": "The frame's content width."
+        },
+        "padY": {
+          "type": "integer",
+          "min": 0,
+          "max": 400,
+          "description": "Top and bottom padding."
+        },
+        "padX": {
+          "type": "integer",
+          "min": 0,
+          "max": 200,
+          "description": "The frame's side padding (gutter)."
+        },
+        "bg": {
+          "type": "object",
+          "description": "The section's background.",
+          "fields": {
+            "color": {
+              "type": "string",
+              "description": "Fill colour: hex, rgb(a) or hsl(a)."
+            },
+            "image": {
+              "type": "string",
+              "description": "Background image address (http(s) or root-relative), drawn behind the content."
+            },
+            "overlay": {
+              "type": "string",
+              "description": "Colour or linear/radial gradient laid over the image or the fill."
+            },
+            "size": {
+              "type": "string",
+              "description": "cover, contain or auto; anything else draws as cover."
+            },
+            "position": {
+              "type": "string",
+              "description": "One or two of center/top/bottom/left/right or percentages."
+            }
+          }
+        },
+        "columns": {
+          "type": "object",
+          "description": "Item columns at 390 (base), 768 (md) and 1280 (lg) px; a missing width follows the narrower one.",
+          "fields": {
+            "390": {
+              "type": "integer",
+              "min": 1,
+              "max": 6,
+              "description": "Phone."
+            },
+            "768": {
+              "type": "integer",
+              "min": 1,
+              "max": 6,
+              "description": "Tablet."
+            },
+            "1280": {
+              "type": "integer",
+              "min": 1,
+              "max": 6,
+              "description": "Desktop."
+            }
+          }
+        },
+        "gap": {
+          "type": "integer",
+          "min": 0,
+          "max": 200,
+          "description": "Gap between items."
+        },
+        "tone": {
+          "type": "select",
+          "options": [
+            "light",
+            "dark"
+          ],
+          "description": "What the text is set for: dark = light text on a dark band. Without it, a fill's own lightness decides."
+        },
+        "align": {
+          "type": "select",
+          "options": [
+            "start",
+            "center",
+            "end"
+          ],
+          "description": "Where the heading and lead sit; read by a component whose own align is not set."
+        },
+        "radius": {
+          "type": "integer",
+          "min": 0,
+          "max": 200,
+          "description": "Card and item corner radius."
+        },
+        "minHeight": {
+          "type": "integer",
+          "min": 0,
+          "max": 2000,
+          "description": "The section's minimum height."
+        }
+      }
+    }
+  },
+  "slots": {},
+  "js": "none",
+  "dependencies": {},
+  "sources": {
+    "gutenberg": [
+      "core/query",
+      "core/latest-posts"
+    ],
+    "elementor": [
+      "elementor/posts",
+      "elementor/archive-posts"
+    ],
+    "divi": [
+      "divi/et_pb_blog"
+    ],
+    "classic": [
+      "classic/archive-item"
+    ]
+  },
+  "a11y": "A <ul> of cards, each an <article> with one link (the title, stretched over the card) and a <time datetime>. Cards sit one heading level under the section heading, or at h2 when there is none. Images are decorative next to their title; the featured card keeps reading order.",
+  "pattern": {
+    "summary": "a repeated post card: image + title + excerpt + date, as a grid, rows or a featured first post",
+    "signals": [
+      "2-4 columns",
+      "date text",
+      "one link per card",
+      "repeated card structure"
+    ]
+  }
+}