@dani-builder/strapi-client 0.2.0 → 0.3.0

package/docs/block-reference.md

@@ -1,601 +1,194 @@
-# Block Reference
-
-## Quick Reference Table
-
-| Block | `__component` | Variants | Media Policy | Items Type |
-|-------|--------------|----------|-------------|-----------|
-| Hero | `blocks.hero` | `side-by-side`, `media-extending`, `fullscreen-media`, `stacked-media` | heroMedia: images+videos | — |
-| Features | `blocks.features` | `simple-grid`, `dual-column`, `media-aside`, `media-aside-compact` | media: images only | `FeatureItem[]` |
-| CTA | `blocks.cta` | `inline-spread`, `inline-centered`, `inline-stacked`, `card-stacked`, `card-centered`, `card-horizontal` | ctaMedia: images+videos | — |
-| Slider | `blocks.slider` | `cover-flow`, `card-slider` | — | `SliderItem[]` |
-| InquiryForm | `blocks.inquiry-form` | — | — | — |
-| FAQ | `blocks.faq` | — | — | `FaqDocument[]` (relation) |
-| Highlights | `blocks.highlights` | `dual-column`, `triple-column`, `alternating` | media: images+videos | `HighlightItem[]` |
-| BentoGrid | `blocks.bento-grid` | — (layout via `columns` + item spans) | — | `BentoItem[]` |
-| Testimonials | `blocks.testimonials` | `centered`, `side-by-side`, `card-grid`, `subtle-grid` | media: images+videos | `TestimonialItem[]` |
-| LogoCloud | `blocks.logo-cloud` | `inline`, `grid`, `split` | — | `LogoItem[]` |
-| Stats | `blocks.stats` | `simple`, `card-grid`, `split` | media: images+videos | `StatItem[]` |
-| Pricing | `blocks.pricing` | `two-column`, `three-column`, `single`, `with-comparison` | — | `PricingTier[]` |
-| Content | `blocks.content` | `prose`, `wide`, `full-width` | — | — |
-| Team | `blocks.team` | `grid`, `large-image`, `compact` | — | `TeamMember[]` |
-
----
-
-## Media Policy Summary
-
-### Images + Videos
-
-These fields accept both image and video uploads. Render `<video>` or `<img>` based on `asset.mime`.
-
-| Field | Component |
-|-------|-----------|
-| `heroMedia` | `blocks.hero` |
-| `ctaMedia` | `blocks.cta` |
-| `media` | `blocks.highlights` |
-| `media` | `blocks.testimonials` |
-| `media` | `blocks.stats` |
-| `media` | `shared.highlight-item` |
-| `media` | `shared.slider-item` |
-
-### Images Only
-
-These fields reject video uploads. Always render as `<img>`.
-
-| Field | Component |
-|-------|-----------|
-| `media` | `blocks.features` |
-| `backgroundImage` | `elements.section` |
-| `logo` | `elements.footer` |
-| `logo` | `shared.logo-item` |
-| `avatar` | `shared.testimonial-item` |
-| `logo` | `shared.testimonial-item` |
-| `media` | `shared.bento-item` |
-| `photo` | `shared.team-member` |
-| `ogImage` | `shared.seo` |
-| `mainLogo` | Navigation CT |
-| `darkLogo` | Navigation CT |
-| `favicon` | Global CT |
-| `cover` | Article CT |
-| `gallery` | Article CT |
-| `avatar` | Author CT |
-| `cover` | Series CT |
-
----
-
-## Section (`elements.section`)
-
-Every block has an optional `section: Section | null` field. Section provides the heading, theme, and background for the block. It can also appear standalone in `Page.blocks` as a separator.
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `heading` | `string \| null` | Section heading |
-| `subheading` | `string \| null` | Subheading |
-| `kickerText` | `string \| null` | Small text above heading |
-| `anchorId` | `string \| null` | Anchor ID for in-page navigation |
-| `headerAlign` | `'auto' \| 'left' \| 'center' \| 'right' \| null` | Heading alignment |
-| `theme` | `'default' \| 'light' \| 'dark' \| 'accent' \| 'muted' \| 'contrast'` | Tailwind preset key |
-| `backgroundImage` | `StrapiMedia \| null` | Background image (images only) |
-| `backgroundImageOpacity` | `number \| null` | Opacity 0–1 for background image overlay |
-
-**Constraints:**
-- `theme` maps to a Tailwind preset in the frontend theme config. DO NOT use arbitrary CSS colors.
-- `backgroundImage` is images-only. DO NOT attempt to use video backgrounds here.
-
----
-
-## Hero (`blocks.hero`)
-
-**`__component`: `'blocks.hero'`**
-**Used in:** Page.blocks, Global.siteWideBlocks
-
-### Variants
-
-| Value | Layout |
-|-------|--------|
-| `side-by-side` | Text on one side, media on the other — split layout |
-| `media-extending` | Media extends beyond container bounds |
-| `fullscreen-media` | Full-viewport background media with text overlay |
-| `stacked-media` | Media below the text content |
-
-### Fields
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `variant` | enum | Layout variant (see above) |
-| `section` | `Section \| null` | Section wrapper |
-| `heroMedia` | `StrapiMedia \| null` | Hero media — **images+videos** |
-| `ctaText` | `string \| null` | Supplementary CTA text |
-| `ctaLink` | `Link \| null` | Primary CTA link |
-| `secondaryLink` | `Link \| null` | Secondary link |
-| `headerMode` | `'none' \| 'transparent-black' \| 'transparent-white'` | Header overlay mode for navigation |
-
-**Constraints:**
-- `heroMedia` accepts images+videos. Check `mime` to decide between `<img>` and `<video>`.
-- `headerMode` controls how the page header (navigation) renders over this hero. `none` = default header, `transparent-*` = transparent with light/dark text.
-- DO NOT confuse `headerMode` here with `Page.headerMode` (`'overlay' | 'offset'`).
-
----
-
-## Features (`blocks.features`)
-
-**`__component`: `'blocks.features'`**
-**Used in:** Page.blocks, Global.siteWideBlocks
-
-### Variants
-
-| Value | Layout |
-|-------|--------|
-| `simple-grid` | Icon+text items in a uniform grid |
-| `dual-column` | Two-column grid layout |
-| `media-aside` | Items on one side, media image on the other |
-| `media-aside-compact` | Compact version of media-aside |
-
-### Fields
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `string \| null` | Admin label — DO NOT display |
-| `variant` | enum | Layout variant |
-| `section` | `Section \| null` | Section wrapper |
-| `media` | `StrapiMedia \| null` | Supporting image — **images only** |
-| `items` | `FeatureItem[]` | Feature items list |
-
-**Constraints:**
-- `media` is images-only and only relevant for `media-aside` / `media-aside-compact` variants.
-- DO NOT render the `media` field for `simple-grid` or `dual-column` variants.
-
----
-
-## CTA (`blocks.cta`)
-
-**`__component`: `'blocks.cta'`**
-**Used in:** Page.blocks
-
-### Variants
-
-| Value | Layout |
-|-------|--------|
-| `inline-spread` | Text and buttons spread horizontally |
-| `inline-centered` | Centered text with buttons below |
-| `inline-stacked` | Text and buttons stacked vertically |
-| `card-stacked` | Card container with stacked content |
-| `card-centered` | Card container with centered content |
-| `card-horizontal` | Card container with horizontal layout |
-
-### Fields
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `section` | `Section \| null` | Section wrapper |
-| `variant` | enum | Layout variant |
-| `ctaMedia` | `StrapiMedia \| null` | CTA media — **images+videos** |
-| `ctaText` | `string \| null` | Supplementary text |
-| `ctaLink` | `Link \| null` | Primary CTA link |
-| `secondaryLink` | `Link \| null` | Secondary link |
-
-**Constraints:**
-- `ctaMedia` accepts images+videos. Most relevant for `card-*` variants.
-- `inline-*` variants are borderless/background-less; `card-*` variants have a card container.
-
----
-
-## Slider (`blocks.slider`)
-
-**`__component`: `'blocks.slider'`**
-**Used in:** Page.blocks, Global.siteWideBlocks
-
-### Variants
-
-| Value | Layout |
-|-------|--------|
-| `cover-flow` | Cover-flow style with center-focused active slide |
-| `card-slider` | Card-based slider/carousel |
-
-### Fields
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `string \| null` | Admin label — DO NOT display |
-| `variant` | enum | Slider style |
-| `section` | `Section \| null` | Section wrapper |
-| `items` | `SliderItem[]` | Slider items (media required per item) |
-
-**Constraints:**
-- Each `SliderItem.media` is required (images+videos). Always render media for each slide.
-
----
-
-## InquiryForm (`blocks.inquiry-form`)
-
-**`__component`: `'blocks.inquiry-form'`**
-**Used in:** Page.blocks, Global.siteWideBlocks
-
-### Fields
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `section` | `Section \| null` | Section wrapper |
-| `successMessage` | `string \| null` | Message displayed after successful submission |
-
-**Constraints:**
-- The form UI is rendered by the frontend (not from CMS data). Submit to `postInquiry(client, data)`.
-- Form fields: `name` (required), `email`, `phone`, `subject`, `message` — see `InquiryFormData` type.
-
----
-
-## FAQ (`blocks.faq`)
-
-**`__component`: `'blocks.faq'`**
-**Used in:** Page.blocks
-
-### Fields
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `section` | `Section \| null` | Section wrapper |
-| `items` | `FaqDocument[]` | FAQ entries (relation: oneToMany → `api::faq.faq`) |
-
-**Constraints:**
-- `items` are full FAQ documents (with `question`, `answer`, `category`, `sortOrder`).
-- `answer` is `BlocksContent | null` — use a Blocks renderer, not markdown.
-- No variant — use a single accordion/expandable pattern.
-
----
-
-## Highlights (`blocks.highlights`)
-
-**`__component`: `'blocks.highlights'`**
-**Used in:** Page.blocks
-
-### Variants
-
-| Value | Layout |
-|-------|--------|
-| `dual-column` | Two-column image+text grid |
-| `triple-column` | Three-column grid |
-| `alternating` | Zigzag layout — alternating image/text sides |
-
-### Fields
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `string \| null` | Admin label — DO NOT display |
-| `variant` | enum | Layout variant |
-| `media` | `StrapiMedia \| null` | Block-level supporting media — **images+videos** |
-| `section` | `Section \| null` | Section wrapper |
-| `items` | `HighlightItem[]` | Highlight items (each has required media) |
-
-**Constraints:**
-- Block-level `media` is a supporting visual, not per-item media.
-- Each `HighlightItem.media` is required (images+videos).
-- For `alternating` variant, items alternate between text-left/media-right and media-left/text-right.
-
 ---
-
-## BentoGrid (`blocks.bento-grid`)
-
-**`__component`: `'blocks.bento-grid'`**
-**Used in:** Page.blocks
-
-### Fields
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `string \| null` | Admin label — DO NOT display |
-| `section` | `Section \| null` | Section wrapper |
-| `columns` | `number` | Grid columns (2–4, default 3) |
-| `items` | `BentoItem[]` | Grid items with colSpan/rowSpan |
-
-**Constraints:**
-- No variant — layout is controlled by `columns` + each item's `colSpan`/`rowSpan`.
-- Use CSS Grid: `grid-template-columns: repeat(columns, 1fr)`.
-- `BentoItem.media` is images-only.
-- Each item's `colSpan` (1–4) and `rowSpan` (1–3) define its grid area.
-
+type: reference
+status: current
+generated: true
+generator: .claude/skills/docs-steward/scripts/gen-reference.mjs
+sources:
+  - packages/strapi-plugin-builder/server/src/components/blocks/*.json
 ---
 
-## Testimonials (`blocks.testimonials`)
-
-**`__component`: `'blocks.testimonials'`**
-**Used in:** Page.blocks
-
-### Variants
+<!-- DO NOT EDIT. Run `pnpm docs:gen` after changing the schemas. -->
 
-| Value | Layout |
-|-------|--------|
-| `centered` | Single/few quotes centered, large format |
-| `side-by-side` | Quote + supporting media in split layout |
-| `card-grid` | Multiple testimonials as cards in a grid |
-| `subtle-grid` | Multiple testimonials in a minimal grid |
+# Blocks
 
-### Fields
+Top-level components usable in the `Page.blocks` dynamic zone.
+Every block object must carry `__component`. Heading and subheading text
+lives inside the nested `section` component, not at the block root.
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `string \| null` | Admin label — DO NOT display |
-| `variant` | enum | Layout variant |
-| `section` | `Section \| null` | Section wrapper |
-| `media` | `StrapiMedia \| null` | Block-level supporting media — **images+videos** |
-| `items` | `TestimonialItem[]` | Testimonial items |
+## Quick reference
 
-**Constraints:**
-- Block-level `media` is primarily used with `side-by-side` variant.
-- `TestimonialItem.avatar` and `TestimonialItem.logo` are images-only.
-- `TestimonialItem.rating` is 1–5 integer or null. Render as star rating when present.
+| Component | `__component` | Variants |
+|---|---|---|
+| Bento Grid | `blocks.bento-grid` | — |
+| Content | `blocks.content` | `prose`, `wide`, `full-width` |
+| CTA | `blocks.cta` | `inline-spread`, `inline-centered`, `inline-stacked`, `card-stacked`, `card-centered`, `card-horizontal` |
+| FAQ | `blocks.faq` | — |
+| Features | `blocks.features` | `simple-grid`, `dual-column`, `media-aside`, `media-aside-compact` |
+| Hero | `blocks.hero` | `side-by-side`, `media-extending`, `fullscreen-media`, `stacked-media` |
+| Highlights | `blocks.highlights` | `dual-column`, `triple-column`, `alternating` |
+| Inquiry Form | `blocks.inquiry-form` | — |
+| Logo Cloud | `blocks.logo-cloud` | `inline`, `grid`, `split`, `marquee` |
+| Pricing | `blocks.pricing` | `two-column`, `three-column`, `single`, `with-comparison` |
+| Slider | `blocks.slider` | `cover-flow`, `card-slider` |
+| Stats | `blocks.stats` | `simple`, `card-grid`, `split` |
+| Team | `blocks.team` | `grid`, `large-image`, `compact` |
+| Testimonials | `blocks.testimonials` | `centered`, `side-by-side`, `card-grid`, `subtle-grid` |
 
----
-
-## LogoCloud (`blocks.logo-cloud`)
+## Bento Grid
 
-**`__component`: `'blocks.logo-cloud'`**
-**Used in:** Page.blocks
+`blocks.bento-grid` — Asymmetric grid layout with per-item span control
 
-### Variants
+| Attribute | Type | Required | Default | Notes |
+|---|---|---|---|---|
+| `name` | string | — | — | — |
+| `section` | component `elements.section` | — | — | — |
+| `columns` | integer | — | `3` | — |
+| `items` | component `shared.bento-item` (repeatable) | — | — | — |
 
-| Value | Layout |
-|-------|--------|
-| `inline` | Logos in a single horizontal row (4–8 logos) |
-| `grid` | Logos in a grid layout (8+ logos) |
-| `split` | Text on left (section heading/subheading) + logo grid on right |
+## Content
 
-### Fields
+`blocks.content` — Rich text content block using Strapi Blocks editor
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `string \| null` | Admin label — DO NOT display |
-| `variant` | enum | Layout variant |
-| `section` | `Section \| null` | Section wrapper |
-| `items` | `LogoItem[]` | Logo items |
+| Attribute | Type | Required | Default | Notes |
+|---|---|---|---|---|
+| `section` | component `elements.section` | — | — | — |
+| `variant` | enumeration | — | — | `prose`, `wide`, `full-width` |
+| `body` | blocks | yes | — | — |
 
-**Constraints:**
-- No block-level media. `split` variant uses `section.heading`/`subheading` for text.
-- `LogoItem.logo` is required (images only).
+## CTA
 
----
+`blocks.cta` — Call-to-Action block with media and action links
 
-## Stats (`blocks.stats`)
+| Attribute | Type | Required | Default | Notes |
+|---|---|---|---|---|
+| `section` | component `elements.section` | — | — | — |
+| `variant` | enumeration | — | `inline-spread` | `inline-spread`, `inline-centered`, `inline-stacked`, `card-stacked`, `card-centered`, `card-horizontal` |
+| `image` | component `shared.image` | — | — | — |
+| `ctaText` | text | — | — | — |
+| `ctaLink` | component `shared.link` | — | — | — |
+| `secondaryLink` | component `shared.link` | — | — | — |
 
-**`__component`: `'blocks.stats'`**
-**Used in:** Page.blocks
+## FAQ
 
-### Variants
+`blocks.faq` — FAQ list block linked to FAQ content type via relation
 
-| Value | Layout |
-|-------|--------|
-| `simple` | Horizontal row of stats (use section.theme for dark/light) |
-| `card-grid` | Stats displayed as cards in a grid |
-| `split` | Stats on one side + media on the other |
+| Attribute | Type | Required | Default | Notes |
+|---|---|---|---|---|
+| `section` | component `elements.section` | — | — | — |
+| `items` | relation `oneToMany` → `plugin::builder.faq` | — | — | — |
 
-### Fields
+## Features
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `string \| null` | Admin label — DO NOT display |
-| `variant` | enum | Layout variant |
-| `section` | `Section \| null` | Section wrapper |
-| `media` | `StrapiMedia \| null` | Supporting media — **images+videos** |
-| `items` | `StatItem[]` | Stat items |
+`blocks.features` — Feature/service showcase with icon+text items
 
-**Constraints:**
-- `media` is only relevant for `split` variant. DO NOT render it for `simple` or `card-grid`.
-- `StatItem.value` is a string (e.g. `"10,000+"`, `"99.9%"`). DO NOT parse it as a number.
+| Attribute | Type | Required | Default | Notes |
+|---|---|---|---|---|
+| `name` | string | — | — | — |
+| `variant` | enumeration | — | — | `simple-grid`, `dual-column`, `media-aside`, `media-aside-compact` |
+| `section` | component `elements.section` | — | — | — |
+| `image` | component `shared.image` | — | — | — |
+| `items` | component `shared.feature-item` (repeatable) | — | — | — |
 
----
+## Hero
 
-## Pricing (`blocks.pricing`)
+`blocks.hero` — Hero banner with media, CTA links, and layout variants
 
-**`__component`: `'blocks.pricing'`**
-**Used in:** Page.blocks
+| Attribute | Type | Required | Default | Notes |
+|---|---|---|---|---|
+| `variant` | enumeration | — | — | `side-by-side`, `media-extending`, `fullscreen-media`, `stacked-media` |
+| `section` | component `elements.section` | — | — | — |
+| `image` | component `shared.image` | — | — | — |
+| `ctaText` | text | — | — | — |
+| `ctaLink` | component `shared.link` | — | — | — |
+| `secondaryLink` | component `shared.link` | — | — | — |
+| `headerMode` | enumeration | — | `none` | `none`, `transparent-black`, `transparent-white` |
 
-### Variants
+## Highlights
 
-| Value | Layout |
-|-------|--------|
-| `two-column` | Side-by-side comparison of 2 plans |
-| `three-column` | Three plans (Good/Better/Best) |
-| `single` | Single plan detail view |
-| `with-comparison` | Plans + feature comparison table below |
+`blocks.highlights` — Highlight/feature showcase with media+text items
 
-### Fields
+| Attribute | Type | Required | Default | Notes |
+|---|---|---|---|---|
+| `name` | string | — | — | — |
+| `variant` | enumeration | — | — | `dual-column`, `triple-column`, `alternating` |
+| `image` | component `shared.image` | — | — | — |
+| `section` | component `elements.section` | — | — | — |
+| `items` | component `shared.highlight-item` (repeatable) | — | — | — |
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `string \| null` | Admin label — DO NOT display |
-| `variant` | enum | Layout variant |
-| `section` | `Section \| null` | Section wrapper |
-| `items` | `PricingTier[]` | Pricing tiers |
+## Inquiry Form
+
+`blocks.inquiry-form` — Contact form block that submits to Inquiry content type
+
+| Attribute | Type | Required | Default | Notes |
+|---|---|---|---|---|
+| `section` | component `elements.section` | — | — | — |
+| `successMessage` | text | — | — | — |
+| `errorMessage` | text | — | — | — |
 
-**Constraints:**
-- `PricingTier.price` is a string (e.g. `"$29"`, `"Free"`, `"Contact us"`). DO NOT parse as number.
-- `PricingTier.featureList` is richtext (Markdown). Render as a bullet list.
-- `PricingTier.highlighted` marks the recommended plan — apply visual emphasis (ribbon, border, etc.).
+## Logo Cloud
 
----
+`blocks.logo-cloud` — Client/partner logo showcase block
 
-## Content (`blocks.content`)
+| Attribute | Type | Required | Default | Notes |
+|---|---|---|---|---|
+| `name` | string | — | — | — |
+| `variant` | enumeration | — | — | `inline`, `grid`, `split`, `marquee` |
+| `section` | component `elements.section` | — | — | — |
+| `items` | component `shared.logo-item` (repeatable) | — | — | — |
 
-**`__component`: `'blocks.content'`**
-**Used in:** Page.blocks
+## Pricing
 
-### Variants
+`blocks.pricing` — Pricing plans/tiers comparison block
 
-| Value | Layout |
-|-------|--------|
-| `prose` | Reading-optimized width (max-w-prose). For long-form text. |
-| `wide` | Wider container. For content with images/tables. |
-| `full-width` | Full container width. For notices, terms. |
+| Attribute | Type | Required | Default | Notes |
+|---|---|---|---|---|
+| `name` | string | — | — | — |
+| `variant` | enumeration | — | — | `two-column`, `three-column`, `single`, `with-comparison` |
+| `section` | component `elements.section` | — | — | — |
+| `items` | component `shared.pricing-tier` (repeatable) | — | — | — |
 
-### Fields
+## Slider
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `section` | `Section \| null` | Section wrapper |
-| `variant` | enum | Content width variant |
-| `body` | `BlocksContent` | Rich text body — **required** |
+`blocks.slider` — Slider/carousel block with media+text items
 
-**Constraints:**
-- `body` is `BlocksContent` (structured JSON), NOT HTML or Markdown. Use a Blocks renderer.
-- No `name`, no `items`, no `media` — the Blocks editor supports inline images.
+| Attribute | Type | Required | Default | Notes |
+|---|---|---|---|---|
+| `name` | string | — | — | — |
+| `variant` | enumeration | — | — | `cover-flow`, `card-slider` |
+| `section` | component `elements.section` | — | — | — |
+| `items` | component `shared.slider-item` (repeatable) | — | — | — |
 
----
+## Stats
 
-## Team (`blocks.team`)
+`blocks.stats` — Key metrics/numbers showcase block
 
-**`__component`: `'blocks.team'`**
-**Used in:** Page.blocks
+| Attribute | Type | Required | Default | Notes |
+|---|---|---|---|---|
+| `name` | string | — | — | — |
+| `variant` | enumeration | — | — | `simple`, `card-grid`, `split` |
+| `section` | component `elements.section` | — | — | — |
+| `image` | component `shared.image` | — | — | — |
+| `items` | component `shared.stat-item` (repeatable) | — | — | — |
 
-### Variants
+## Team
 
-| Value | Layout |
-|-------|--------|
-| `grid` | Standard grid — circular/square photos + name/role/bio. For 4–12 members. |
-| `large-image` | Large photo emphasis. For leadership/key members. |
-| `compact` | Small photos + minimal info. For large teams (12+). |
+`blocks.team` — Team member showcase block
 
-### Fields
+| Attribute | Type | Required | Default | Notes |
+|---|---|---|---|---|
+| `name` | string | — | — | — |
+| `variant` | enumeration | — | — | `grid`, `large-image`, `compact` |
+| `section` | component `elements.section` | — | — | — |
+| `items` | component `shared.team-member` (repeatable) | — | — | — |
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `string \| null` | Admin label — DO NOT display |
-| `variant` | enum | Layout variant |
-| `section` | `Section \| null` | Section wrapper |
-| `items` | `TeamMember[]` | Team members |
+## Testimonials
 
-**Constraints:**
-- `TeamMember.photo` is images-only.
-- `TeamMember.socialLinks` is `Link[]` — render as icon links.
-
----
-
-## Shared Sub-Components
-
-### FeatureItem (`shared.feature-item`)
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `label` | `string \| null` | Item label |
-| `description` | `string \| null` | Markdown richtext |
-| `icon` | `string \| null` | Icon picker value |
-| `infoText` | `string \| null` | Supplementary info text |
-| `link` | `Link \| null` | Optional link |
-
-### HighlightItem (`shared.highlight-item`)
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `label` | `string \| null` | Item label |
-| `description` | `string \| null` | Markdown richtext |
-| `media` | `StrapiMedia` | **Required** — images+videos |
-| `link` | `Link \| null` | Optional link |
-
-### SliderItem (`shared.slider-item`)
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `label` | `string \| null` | Item label |
-| `description` | `string \| null` | Description text |
-| `link` | `Link \| null` | Optional link |
-| `media` | `StrapiMedia` | **Required** — images+videos |
-
-### BentoItem (`shared.bento-item`)
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `title` | `string \| null` | Item title |
-| `description` | `string \| null` | Description text |
-| `media` | `StrapiMedia \| null` | Screenshot/illustration — images only |
-| `icon` | `string \| null` | Decorative icon |
-| `colSpan` | `number` | Column span (1–4, default 1) |
-| `rowSpan` | `number` | Row span (1–3, default 1) |
-| `link` | `Link \| null` | Optional link |
-
-### TestimonialItem (`shared.testimonial-item`)
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `quote` | `string` | **Required** — testimonial text |
-| `authorName` | `string \| null` | Author name |
-| `authorRole` | `string \| null` | Author title/role |
-| `avatar` | `StrapiMedia \| null` | Profile image — images only |
-| `logo` | `StrapiMedia \| null` | Company logo — images only |
-| `rating` | `number \| null` | Star rating 1–5 |
-
-### LogoItem (`shared.logo-item`)
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `logo` | `StrapiMedia` | **Required** — images only |
-| `companyName` | `string \| null` | Company name (for alt text/accessibility) |
-| `link` | `Link \| null` | Optional link |
-
-### StatItem (`shared.stat-item`)
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `value` | `string` | **Required** — formatted value string |
-| `label` | `string \| null` | Short label |
-| `description` | `string \| null` | Supplementary description |
-
-### PricingTier (`shared.pricing-tier`)
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `planName` | `string` | **Required** — plan name |
-| `price` | `string` | **Required** — formatted price string |
-| `billingPeriod` | `string \| null` | e.g. "/mo", "/year" |
-| `description` | `string \| null` | Plan description |
-| `featureList` | `string \| null` | Markdown bullet list |
-| `ctaLink` | `Link \| null` | CTA link |
-| `highlighted` | `boolean` | Recommended plan flag |
-
-### TeamMember (`shared.team-member`)
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `memberName` | `string` | **Required** — member name |
-| `role` | `string \| null` | Title/role |
-| `bio` | `string \| null` | Short bio |
-| `photo` | `StrapiMedia \| null` | Profile photo — images only |
-| `socialLinks` | `Link[]` | Social media links |
-
-### Link (`shared.link`)
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `label` | `string` | **Required** — link label |
-| `href` | `string` | **Required** — URL |
-| `newWindow` | `boolean` | Open in new window (default false) |
-| `icon` | `string \| null` | Icon picker value |
-
----
+`blocks.testimonials` — Customer testimonials/reviews block
 
-## DZ Discrimination Pattern
-
-```ts
-import type { PageBlocks, SiteWideBlocks } from '@dani-builder/strapi-client/types';
-
-function renderBlock(block: PageBlocks) {
-  switch (block.__component) {
-    case 'blocks.hero':        return <HeroSection block={block} />;
-    case 'blocks.features':    return <FeaturesSection block={block} />;
-    case 'blocks.cta':         return <CtaSection block={block} />;
-    case 'blocks.slider':      return <SliderSection block={block} />;
-    case 'blocks.inquiry-form': return <InquiryFormSection block={block} />;
-    case 'blocks.faq':         return <FaqSection block={block} />;
-    case 'blocks.highlights':  return <HighlightsSection block={block} />;
-    case 'blocks.bento-grid':  return <BentoGridSection block={block} />;
-    case 'blocks.testimonials': return <TestimonialsSection block={block} />;
-    case 'blocks.logo-cloud':  return <LogoCloudSection block={block} />;
-    case 'blocks.stats':       return <StatsSection block={block} />;
-    case 'blocks.pricing':     return <PricingSection block={block} />;
-    case 'blocks.content':     return <ContentSection block={block} />;
-    case 'blocks.team':        return <TeamSection block={block} />;
-    case 'elements.section':   return <SectionDivider section={block} />;
-    default: return null;
-  }
-}
-```
-
-**PageBlocks union** (15 members): `Section | HeroBlock | FeaturesBlock | CtaBlock | SliderBlock | InquiryFormBlock | FaqBlock | HighlightsBlock | BentoGridBlock | TestimonialsBlock | LogoCloudBlock | StatsBlock | PricingBlock | ContentBlock | TeamBlock`
-
-**SiteWideBlocks union** (4 members): `SliderBlock | InquiryFormBlock | HeroBlock | FeaturesBlock`
+| Attribute | Type | Required | Default | Notes |
+|---|---|---|---|---|
+| `name` | string | — | — | — |
+| `variant` | enumeration | — | — | `centered`, `side-by-side`, `card-grid`, `subtle-grid` |
+| `section` | component `elements.section` | — | — | — |
+| `image` | component `shared.image` | — | — | — |
+| `items` | component `shared.testimonial-item` (repeatable) | — | — | — |