@contentrain/astro-kit 0.15.0 → 0.16.0

package/catalog.json

@@ -657,6 +657,14 @@
           ],
           "default": "accent",
           "description": "Background. On accent, primary buttons are drawn in the secondary style so they stay visible. none: no fill of its own; the page background shows through (a source colour the palette does not have)."
+        },
+        "actionsAlign": {
+          "options": [
+            "inherit",
+            "start"
+          ],
+          "default": "inherit",
+          "description": "The buttons' alignment. inherit: as the layout sets it. start: at the start edge under centred heading and text (layout centered; a WordPress buttons block with no justification in a centred group). inline and stacked ignore it."
         }
       },
       "props": {

package/components/cta/Cta.astro

@@ -28,6 +28,11 @@ const cta = tv({
     // accent/accent-ink is only ~5:1 — dimming text on it drops body copy under 4.5:1 (WCAG 1.4.3), so accent keeps it at full strength.
     // none: no fill of its own — the page background and text colour show through.
     tone: { default: {}, muted: {}, inverse: {}, accent: { body: 'opacity-100' }, none: {} },
+    // The buttons' own alignment: `start` keeps them at the start edge under centred text (a WordPress buttons block
+    // with no justification sits left in a group whose heading and paragraph are centred). The row is the text's
+    // column, as WordPress's content width is, not the whole section. Only centred needs it: inline and stacked
+    // already start them there.
+    actionsAlign: { inherit: {}, start: {} },
   },
   compoundVariants: [
     // A card carries the tone itself, on a plain section; a plain card still needs a surface to read as one.
@@ -35,8 +40,9 @@ const cta = tv({
     { frame: 'card', tone: 'muted', class: { box: 'border-transparent bg-surface-muted text-ink' } },
     { frame: 'card', tone: 'inverse', class: { box: 'border-transparent bg-ink text-surface' } },
     { frame: 'card', tone: 'accent', class: { box: 'border-transparent bg-accent text-accent-ink' } },
+    { layout: 'centered', actionsAlign: 'start', class: { actions: 'w-full max-w-2xl justify-start' } },
   ],
-  defaultVariants: { layout: 'inline', frame: 'full', tone: 'accent' },
+  defaultVariants: { layout: 'inline', frame: 'full', tone: 'accent', actionsAlign: 'inherit' },
 })
 
 interface Props {
@@ -46,11 +52,13 @@ interface Props {
   layout?: 'inline' | 'centered' | 'stacked' | undefined
   frame?: 'full' | 'card' | undefined
   tone?: 'default' | 'muted' | 'inverse' | 'accent' | 'none' | undefined
+  /** The buttons' alignment: as the layout sets it, or at the start edge under centred text (layout centered). */
+  actionsAlign?: 'inherit' | 'start' | undefined
   id?: string | undefined
 }
 
-const { heading, body, actions, layout, frame, tone = 'accent', id } = Astro.props
-const s = cta({ layout, frame, tone })
+const { heading, body, actions, layout, frame, tone = 'accent', actionsAlign, id } = Astro.props
+const s = cta({ layout, frame, tone, actionsAlign })
 const headingId = id ? `${id}-title` : undefined
 // On the accent background the primary button (accent) would vanish: it is drawn as the secondary style there.
 const onAccent = (action: ActionInput): ActionInput => ({ label: action.label, href: action.href, newTab: action.newTab, style: 'secondary' })

package/components/cta/fixtures.json

@@ -3,5 +3,6 @@
   { "name": "centered-inverse", "props": { "heading": "Planning a trip?", "body": "Start with the guides readers use most.", "layout": "centered", "tone": "inverse", "actions": [{ "label": "Popular guides", "href": "/guides/" }, { "label": "Ask a question", "href": "/contact/", "style": "ghost" }] } },
   { "name": "card-default", "props": { "heading": "Write for the journal", "body": "We publish reader essays every season.", "frame": "card", "tone": "default", "actions": [{ "label": "Pitch an essay", "href": "/pitch/" }] } },
   { "name": "card-muted", "props": { "heading": "Support independent travel writing", "frame": "card", "tone": "muted", "layout": "centered", "actions": [{ "label": "Become a member", "href": "/members/" }] } },
-  { "name": "stacked-none", "props": { "heading": "Ready when you are", "body": "Tell us where you want to go and we will send a first plan within a week.", "layout": "stacked", "tone": "none", "actions": [{ "label": "Start planning", "href": "/contact/" }] } }
+  { "name": "stacked-none", "props": { "heading": "Ready when you are", "body": "Tell us where you want to go and we will send a first plan within a week.", "layout": "stacked", "tone": "none", "actions": [{ "label": "Start planning", "href": "/contact/" }] } },
+  { "name": "centered-actions-start", "props": { "heading": "See what is on this week", "body": "New films every Thursday, and a late show on Saturdays.", "layout": "centered", "tone": "inverse", "actionsAlign": "start", "actions": [{ "label": "Programme", "href": "/programme/" }] } }
 ]

package/components/cta/meta.json

@@ -8,7 +8,8 @@
   "variants": {
     "layout": { "options": ["inline", "centered", "stacked"], "default": "inline", "description": "inline: text left, buttons right on wide screens. centered: everything centred. stacked: heading, text and buttons in one column at the start edge on every width." },
     "frame": { "options": ["full", "card"], "default": "full", "description": "full: the tone fills the section. card: a rounded box in a plain section carries the tone." },
-    "tone": { "options": ["default", "muted", "inverse", "accent", "none"], "default": "accent", "description": "Background. On accent, primary buttons are drawn in the secondary style so they stay visible. none: no fill of its own; the page background shows through (a source colour the palette does not have)." }
+    "tone": { "options": ["default", "muted", "inverse", "accent", "none"], "default": "accent", "description": "Background. On accent, primary buttons are drawn in the secondary style so they stay visible. none: no fill of its own; the page background shows through (a source colour the palette does not have)." },
+    "actionsAlign": { "options": ["inherit", "start"], "default": "inherit", "description": "The buttons' alignment. inherit: as the layout sets it. start: at the start edge under centred heading and text (layout centered; a WordPress buttons block with no justification in a centred group). inline and stacked ignore it." }
   },
   "props": {
     "heading": { "type": "string", "label": "Heading", "required": true, "description": "The call's heading (Divi CTA title, Elementor call-to-action title)." },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentrain/astro-kit",
-  "version": "0.15.0",
+  "version": "0.16.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",