@contentrain/astro-kit 0.16.0 → 0.18.0

package/catalog.json

@@ -2229,6 +2229,22 @@
           ],
           "default": "vertical",
           "description": "Image on top, image beside the text, or text only with a divider."
+        },
+        "surface": {
+          "options": [
+            "plain",
+            "card"
+          ],
+          "default": "plain",
+          "description": "plain: no surface. card: its own background (--color-card), radius and shadow (--shadow-card), the text padded (--spacing-card) and the image flush at the edge, as theme cards are drawn on a tinted page."
+        },
+        "byline": {
+          "options": [
+            "inline",
+            "below"
+          ],
+          "default": "inline",
+          "description": "inline: category · date above the title. below: the category above the title and author / date under it, both in the accent colour, small and semibold."
         }
       },
       "props": {
@@ -3416,6 +3432,14 @@
           ],
           "default": "auto",
           "description": "The quote's text size. auto: the layout's own (body size in a grid, 2xl–3xl for a single quote). base, lg, xl: that size on every width."
+        },
+        "frame": {
+          "options": [
+            "card",
+            "plain"
+          ],
+          "default": "card",
+          "description": "card: each quote in its box (a bordered, padded card in the grid; the surface colour in a muted section). plain: the quote and who said it straight on the section, across the column, with no box, as Elementor's testimonial widget draws them."
         }
       },
       "props": {

package/components/faq/Faq.astro

@@ -29,8 +29,10 @@ const faq = tv({
       plain: { list: 'gap-2', summary: 'list-item list-[revert] py-1 text-[length:var(--text-body,1rem)] [font-weight:inherit] [&::-webkit-details-marker]:inline', marker: 'hidden', answer: 'pt-2 ps-5' },
     },
     tone: { default: {}, muted: { item: 'bg-surface' }, inverse: { answer: 'prose-invert' }, accent: { answer: 'prose-invert' } },
-    // heading: the question as a small heading. bold: body size in bold, as accordion and toggle titles often are.
-    questionStyle: { heading: {}, bold: { summary: 'text-[length:var(--text-body,1rem)] font-bold' } },
+    // heading: the question as a small heading. bold: body size in bold, as accordion and toggle titles often are. The
+    // weight is an arbitrary property like the summary's own: twMerge replaces one only with another, and a `font-bold`
+    // beside it lost in the CSS (IP-4 elementor G9: the question stayed at the heading weight).
+    questionStyle: { heading: {}, bold: { summary: 'text-[length:var(--text-body,1rem)] [font-weight:700]' } },
   },
   compoundVariants: [
     { style: 'cards', tone: 'muted', class: { item: 'border-transparent' } },

package/components/post-card/PostCard.astro

@@ -1,6 +1,9 @@
 ---
 // One post in a list: image, category, date, title, excerpt and author. The
-// whole card is clickable through its title link.
+// whole card is clickable through its title link. `surface: card` makes it a
+// card of its own (background, radius, shadow, padded text, image flush);
+// `byline: below` prints the category above the title and `author / date`
+// under it, as card themes do.
 import { tv } from 'tailwind-variants'
 import KitImage from '../_shared/KitImage.astro'
 import type { ImageInput, LinkInput } from '../_shared/types'
@@ -20,8 +23,16 @@ const card = tv({
       horizontal: { root: 'flex-col sm:flex-row sm:items-start', media: 'w-full sm:w-64', title: 'text-xl', excerpt: 'line-clamp-2' },
       minimal: { root: 'flex-col border-b border-line pb-5', media: 'hidden', title: 'text-lg', excerpt: 'line-clamp-2' },
     },
+    surface: {
+      plain: {},
+      card: { root: 'gap-0 overflow-hidden rounded-[var(--radius-card)] bg-card shadow-[var(--shadow-card,none)]', media: 'rounded-none', body: 'gap-3 p-[var(--spacing-card,1.5rem)]' },
+    },
+    byline: {
+      inline: {},
+      below: { meta: 'text-xs font-semibold text-accent' },
+    },
   },
-  defaultVariants: { layout: 'vertical' },
+  defaultVariants: { layout: 'vertical', surface: 'plain', byline: 'inline' },
 })
 
 interface Props {
@@ -37,13 +48,17 @@ interface Props {
   author?: string | undefined
   headingLevel?: 2 | 3 | undefined
   layout?: 'vertical' | 'horizontal' | 'minimal' | undefined
+  surface?: 'plain' | 'card' | undefined
+  byline?: 'inline' | 'below' | undefined
   /** The title in the site's link colour, as themes that colour every link do (Hello Elementor). */
   linkTitle?: boolean | undefined
 }
 
-const { title, href, excerpt, date: rawDate, locale = 'en', image, category, author, headingLevel = 2, layout, linkTitle } = Astro.props
+const { title, href, excerpt, date: rawDate, locale = 'en', image, category, author, headingLevel = 2, layout, surface, byline, linkTitle } = Astro.props
 const date = rawDate === undefined ? undefined : new Date(rawDate)
-const slots = card({ layout })
+const slots = card({ layout, surface, byline })
+const below = byline === 'below'
+const shown = date?.toLocaleDateString(locale, { dateStyle: 'long', timeZone: 'UTC' })
 const Heading = `h${headingLevel}` as 'h2' | 'h3'
 ---
 <article class={slots.root()}>
@@ -53,17 +68,29 @@ const Heading = `h${headingLevel}` as 'h2' | 'h3'
     </div>
   )}
   <div class={slots.body()}>
-    {(category || date) && (
+    {below && category && (
+      <p class={slots.meta()}>
+        <a href={category.href} class="relative z-10 no-underline hover:underline">{category.label}</a>
+      </p>
+    )}
+    {!below && (category || date) && (
       <p class={slots.meta()}>
         {category && <a href={category.href} class="relative z-10 font-medium text-accent no-underline hover:underline">{category.label}</a>}
         {category && date && <span aria-hidden="true">·</span>}
-        {date && <time datetime={date.toISOString()}>{date.toLocaleDateString(locale, { dateStyle: 'long', timeZone: 'UTC' })}</time>}
+        {date && <time datetime={date.toISOString()}>{shown}</time>}
       </p>
     )}
     <Heading class={slots.title({ class: linkTitle ? 'text-[color:var(--color-link,var(--color-accent))]' : undefined })}>
       <a href={href} class="text-current no-underline after:absolute after:inset-0 after:content-[''] hover:text-accent">{title}</a>
     </Heading>
+    {below && (author || date) && (
+      <p class={slots.meta()}>
+        {author && <span>{author}</span>}
+        {author && date && <span aria-hidden="true">/</span>}
+        {date && <time datetime={date.toISOString()}>{shown}</time>}
+      </p>
+    )}
     {excerpt && <p class={slots.excerpt()}>{excerpt}</p>}
-    {author && <p class="text-sm text-ink-muted">{author}</p>}
+    {!below && author && <p class="text-sm text-ink-muted">{author}</p>}
   </div>
 </article>

package/components/post-card/fixtures.json

@@ -50,5 +50,28 @@
         "href": "/category/news/"
       }
     }
+  },
+  {
+    "name": "card-byline",
+    "props": {
+      "surface": "card",
+      "byline": "below",
+      "title": "Laminating dough without a sheeter",
+      "href": "/recipes/laminating/",
+      "excerpt": "Laminating dough without a sheeter — the short version first.",
+      "date": "2026-02-10T09:00:00Z",
+      "category": {
+        "label": "Recipes",
+        "href": "/category/recipes/"
+      },
+      "author": "admin",
+      "image": {
+        "src": "/kit-fixtures/photo-1.svg",
+        "alt": "",
+        "width": 1200,
+        "height": 800
+      }
+    },
+    "frame": "narrow"
   }
 ]

package/components/post-card/meta.json

@@ -6,7 +6,9 @@
   "uses": [],
   "shared": ["KitImage.astro", "types.ts"],
   "variants": {
-    "layout": { "options": ["vertical", "horizontal", "minimal"], "default": "vertical", "description": "Image on top, image beside the text, or text only with a divider." }
+    "layout": { "options": ["vertical", "horizontal", "minimal"], "default": "vertical", "description": "Image on top, image beside the text, or text only with a divider." },
+    "surface": { "options": ["plain", "card"], "default": "plain", "description": "plain: no surface. card: its own background (--color-card), radius and shadow (--shadow-card), the text padded (--spacing-card) and the image flush at the edge, as theme cards are drawn on a tinted page." },
+    "byline": { "options": ["inline", "below"], "default": "inline", "description": "inline: category · date above the title. below: the category above the title and author / date under it, both in the accent colour, small and semibold." }
   },
   "props": {
     "title": { "type": "string", "required": true, "description": "Post title (posts.title)." },

package/components/testimonial/Testimonial.astro

@@ -39,11 +39,15 @@ const testimonial = tv({
       lg: { quote: 'text-lg leading-relaxed md:text-lg' },
       xl: { quote: 'text-xl leading-snug md:text-xl' },
     },
+    // card: a quote in its box (the grid's border and padding, a muted section's surface). plain: the quote and who said
+    // it on the section itself, across the column, as Elementor's testimonial widget draws them.
+    frame: { card: {}, plain: {} },
   },
   compoundVariants: [
     { layout: 'grid', tone: 'muted', class: { card: 'border-transparent text-ink' } },
+    { frame: 'plain', class: { card: 'rounded-none border-0 bg-transparent p-0' } },
   ],
-  defaultVariants: { layout: 'grid', tone: 'default', quoteSize: 'auto' },
+  defaultVariants: { layout: 'grid', tone: 'default', quoteSize: 'auto', frame: 'card' },
 })
 
 interface Props {
@@ -51,13 +55,16 @@ interface Props {
   heading?: string | undefined
   layout?: 'single' | 'grid' | undefined
   quoteSize?: 'auto' | 'base' | 'lg' | 'xl' | undefined
+  frame?: 'card' | 'plain' | undefined
   tone?: 'default' | 'muted' | 'inverse' | 'accent' | undefined
   id?: string | undefined
 }
 
-const { items, heading, layout, quoteSize, tone, id } = Astro.props
-const s = testimonial({ layout, quoteSize, tone })
+const { items, heading, layout, quoteSize, frame, tone, id } = Astro.props
+const s = testimonial({ layout, quoteSize, frame, tone })
 const headingId = heading && id ? `${id}-title` : undefined
+// Two quotes share the row: a third column would stand empty beside them and narrow both (IP-4 elementor launch G9).
+const list = s.list(items.length === 2 && (layout ?? 'grid') === 'grid' ? { class: 'lg:grid-cols-2' } : {})
 // The quotation marks are drawn, not written: the quote's text is the source's words, read once. A quote the source
 // already wrote inside marks keeps its own.
 const quoted = (text: string) => /^\s*["'“‘„«‹「『]/.test(text)
@@ -65,7 +72,7 @@ const quoted = (text: string) => /^\s*["'“‘„«‹「『]/.test(text)
 {items.length > 0 && (
   <Section tone={tone} spacing="md" id={id} aria-labelledby={headingId}>
     {heading && <h2 id={headingId} class={s.heading()}>{heading}</h2>}
-    <div class={s.list()}>
+    <div class={list}>
       {items.map(item => (
         <figure class={s.card()}>
           <blockquote class={s.quote()}><p class:list={[!quoted(item.quote) && "before:content-[open-quote] after:content-[close-quote]"]}>{item.quote}</p></blockquote>

package/components/testimonial/fixtures.json

@@ -35,6 +35,14 @@
     "name": "single-quote-lg",
     "props": { "layout": "single", "quoteSize": "lg", "items": [{ "quote": "We planned less and saw more.", "name": "Jonas Weber", "role": "Reader" }] }
   },
+  {
+    "name": "grid-plain",
+    "props": { "frame": "plain", "quoteSize": "xl", "items": [{ "quote": "We sold out our first kiln batch on launch day.", "name": "Ruth Adeyemi", "role": "Potter" }, { "quote": "Six weeks, one price, and they answered every email.", "name": "Daniel Okafor", "role": "Leatherworker" }] }
+  },
+  {
+    "name": "single-plain-muted",
+    "props": { "layout": "single", "frame": "plain", "tone": "muted", "items": [{ "quote": "Calm pages and a fast checkout.", "name": "Ruth Adeyemi" }] }
+  },
   {
     "name": "grid-source-quoted",
     "props": { "items": [{ "quote": "“We set it up before lunch.”", "name": "Grace Lin", "role": "Head of Support, Fernhill" }, { "quote": "People just read the page.", "name": "Omar Haddad", "role": "Support lead" }] }

package/components/testimonial/meta.json

@@ -38,6 +38,14 @@
       ],
       "default": "auto",
       "description": "The quote's text size. auto: the layout's own (body size in a grid, 2xl–3xl for a single quote). base, lg, xl: that size on every width."
+    },
+    "frame": {
+      "options": [
+        "card",
+        "plain"
+      ],
+      "default": "card",
+      "description": "card: each quote in its box (a bordered, padded card in the grid; the surface colour in a muted section). plain: the quote and who said it straight on the section, across the column, with no box, as Elementor's testimonial widget draws them."
     }
   },
   "props": {

package/mapping/elementor.json

@@ -1,7 +1,7 @@
 {
   "format": "astro-kit-mapping@1",
   "builder": "elementor",
-  "version": "9",
+  "version": "11",
   "fallback": "prose",
   "defaults": {
     "elementor/video": {
@@ -276,6 +276,9 @@
     {
       "match": "elementor/testimonial",
       "component": "testimonial",
+      "variant": {
+        "frame": "plain"
+      },
       "group": "siblings",
       "into": "items",
       "item": {
@@ -605,6 +608,9 @@
     {
       "id": "team.columns",
       "component": "team",
+      "variant": {
+        "roleStyle": "plain"
+      },
       "when": {
         "columns": [
           2,
@@ -761,6 +767,9 @@
     {
       "id": "stats.counter",
       "component": "stats",
+      "variant": {
+        "labelSize": "lg"
+      },
       "slots": {
         "title": {
           "match": "elementor/heading",
@@ -848,6 +857,10 @@
     {
       "id": "testimonial.quotes",
       "component": "testimonial",
+      "variant": {
+        "quoteSize": "xl",
+        "frame": "plain"
+      },
       "slots": {
         "title": {
           "match": "elementor/heading",
@@ -874,6 +887,9 @@
     {
       "id": "faq.accordion",
       "component": "faq",
+      "variant": {
+        "questionStyle": "bold"
+      },
       "slots": {
         "title": {
           "match": "elementor/heading",
@@ -898,6 +914,9 @@
     {
       "id": "faq.toggle",
       "component": "faq",
+      "variant": {
+        "questionStyle": "bold"
+      },
       "slots": {
         "title": {
           "match": "elementor/heading",
@@ -1103,7 +1122,7 @@
       "id": "feature-list.icon-list",
       "component": "feature-list",
       "variant": {
-        "style": "icon"
+        "style": "list"
       },
       "slots": {
         "title": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentrain/astro-kit",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "license": "MIT",
   "description": "Copy-in Astro components for Contentrain sites (shadcn model): typed props, tailwind-variants, zero JavaScript by default — with a machine-readable catalog",
   "type": "module",
@@ -42,7 +42,7 @@
     "mapping"
   ],
   "dependencies": {
-    "@contentrain/types": "1.35.0"
+    "@contentrain/types": "1.36.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",