@gravity-ui/page-constructor 8.14.2 → 8.16.0

package/build/docs/blocks/Hero.md

@@ -0,0 +1,67 @@
+# Hero
+
+Renders a modern, content-driven hero block: an overtitle, a rich content column (title, body text, list, links, buttons) and a media column (image/video/iframe) that adapts to its intrinsic aspect ratio. Use it as the primary landing block when you want more layout flexibility than the classic Header provides.
+
+## Block type
+
+`type: 'hero-block'`
+
+## When to use
+
+- Top-of-page hero with a richer content column (lists, additional info, links).
+- When media should intelligently switch between horizontal and vertical orientation based on its aspect ratio.
+- When you need a colored or media background that can be full-width or contained.
+
+## Example
+
+```json
+{
+  "type": "hero-block",
+  "overtitle": "Overtitle",
+  "title": "Lorem ipsum dolor",
+  "text": "**Ut enim ad minim veniam** [quis nostrud](https://example.com) exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.",
+  "additionalInfo": "Duis aute irure dolor in reprehenderit in voluptate velit esse.",
+  "buttons": [
+    {"text": "Primary", "theme": "action", "url": "https://example.com"},
+    {"text": "Secondary", "theme": "outlined", "url": "https://example.com"}
+  ],
+  "media": {
+    "light": {"image": "/images/hero-light.png"},
+    "dark": {"image": "/images/hero-dark.png"}
+  }
+}
+```
+
+## Properties
+
+| Property           | Type                                                     | Default     | Description                                                                                                 |
+| ------------------ | -------------------------------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------- |
+| `title` _required_ | `string \| TitleProps`                                   | —           | Main heading. A string or a `TitleProps` object (`text`, `textSize`, `url`, `urlTitle`, `analyticsEvents`). |
+| `text`             | `string`                                                 | —           | YFM body content rendered below the title.                                                                  |
+| `additionalInfo`   | `string`                                                 | —           | YFM supplementary text under the body.                                                                      |
+| `links`            | `LinkProps[]`                                            | —           | Inline text links rendered below the content.                                                               |
+| `list`             | `ContentItem[]`                                          | —           | Bullet-style list; each item has `title`, `text`, and an `icon`/`gravityIcon`.                              |
+| `theme`            | `'default' \| 'light' \| 'dark'`                         | `'default'` | Color theme; `default` follows the runtime theme, `light`/`dark` force a monochrome scheme.                 |
+| `overtitle`        | `string`                                                 | —           | Small label rendered above the title.                                                                       |
+| `buttons`          | `HeroButton[] \| {light, dark}[]`                        | —           | CTA buttons. Each requires `text` + `url` and supports `theme`, `primary`, `size`, `extraProps`.            |
+| `media`            | `MediaProps & {roundCorners?: boolean} \| {light, dark}` | —           | Media column (image/video/youtube/iframe/dataLens). `roundCorners` defaults to `true`.                      |
+| `fullWidth`        | `boolean`                                                | `false`     | Extends the background to the full viewport width.                                                          |
+| `verticalOffset`   | `'s' \| 'm' \| 'l' \| 'xl'`                              | `'m'`       | Vertical spacing around the content.                                                                        |
+| `background`       | `HeroBackground \| {light, dark}`                        | —           | Background color and/or media behind the block.                                                             |
+| `breadcrumbs`      | `{items: {url, text}[], theme?}`                         | —           | Breadcrumb navigation rendered above the content.                                                           |
+
+`HeroBackground` accepts `image`, `video`, `parallax`, `height`, `ratio`, `previewImg` (from `MediaProps`) plus `color`.
+
+`ContentItem` requires either `icon` or `gravityIcon` and supports `title`/`text`.
+
+### Common properties
+
+Inherits common block properties: `anchor`, `visible`, `indent` (`{top?, bottom?}`), `qa`, `className`, `animated`, `theme` (`'light' | 'dark'`), `when`, `context`. See the root README for details.
+
+## Themed values
+
+`buttons`, `media`, and `background` each accept either a plain value or a `{light, dark}` object resolved against the active runtime theme.
+
+## Storybook
+
+[Hero](https://preview.gravity-ui.com/page-constructor/?path=/docs/blocks-hero--docs)

package/build/docs/blocks/Icons.md

@@ -0,0 +1,61 @@
+# Icons
+
+Renders a responsive grid of small icon items, each consisting of an image and a caption. Items can optionally be wrapped in links, turning the grid into a navigable set of icon links.
+
+## Block type
+
+`type: 'icons-block'`
+
+## When to use
+
+- Compact grids of icon + label pairs (e.g. feature highlights, category links, value props).
+- Quick-link hubs where each entry is a small graphic and a short caption.
+- Sections that need a plain title/description header followed by an icon row.
+
+## Example
+
+```json
+{
+  "type": "icons-block",
+  "title": "Icons block title",
+  "description": "**Ut enim ad minim veniam** [quis nostrud](https://example.com) exercitation.",
+  "size": "s",
+  "items": [
+    {"src": "/images/icon-1.svg", "text": "Lorem ipsum dolor sit amet", "url": "#"},
+    {"src": "/images/icon-2.svg", "text": "Lorem ipsum dolor sit amet", "url": "#"},
+    {"src": "/images/icon-3.svg", "text": "Lorem ipsum dolor sit amet", "url": "#"}
+  ]
+}
+```
+
+## Properties
+
+| Property           | Type                         | Default     | Description                                            |
+| ------------------ | ---------------------------- | ----------- | ------------------------------------------------------ |
+| `items` _required_ | `IconsBlockItem[]`           | —           | Array of icon items. See below.                        |
+| `size` _required_  | `'s' \| 'm' \| 'l'`          | `'s'`       | Controls the rendered item/grid scale.                 |
+| `title`            | `string`                     | —           | Optional section heading (plain text).                 |
+| `description`      | `string`                     | —           | Optional plain-text subtitle rendered under the title. |
+| `colSizes`         | `{sm?, md?, lg?, xl?, all?}` | `{all: 12}` | Grid column sizes for the optional header.             |
+| `animated`         | `boolean`                    | —           | Enables an entrance animation.                         |
+
+### `items[]`
+
+| Property          | Type                                 | Default | Description                                                                  |
+| ----------------- | ------------------------------------ | ------- | ---------------------------------------------------------------------------- |
+| `url` _required_  | `string`                             | —       | If present, the item is rendered as a link wrapping the icon and text.       |
+| `text` _required_ | `string`                             | —       | Caption rendered under the icon; also used as the link `aria-label`/`title`. |
+| `src` _required_  | `string \| {light, dark}`            | —       | Icon image URL.                                                              |
+| `analyticsEvents` | `AnalyticsEvent \| AnalyticsEvent[]` | —       | Analytics events fired when the item link is clicked.                        |
+
+### Common properties
+
+Inherits: `anchor`, `visible`, `indent` (`{top?, bottom?}`), `qa`, `className`, `animated`, `when`, `context`. See the root README for details.
+
+## Themed values
+
+Each item's `src` accepts either a plain URL string or a `{light, dark}` object resolved against the active runtime theme.
+
+## Storybook
+
+[Icons](https://preview.gravity-ui.com/page-constructor/?path=/docs/blocks-icons--docs)

package/build/docs/blocks/Info.md

@@ -0,0 +1,73 @@
+# Info
+
+Renders a two-column information section: a left content column and a right content column, each with its own title, text, lists, buttons, and links, placed inside an optional themed background container.
+
+## Block type
+
+`type: 'info-block'`
+
+## When to use
+
+- Side-by-side information panels that share a background but present distinct content (e.g. summary vs. details).
+- Sections needing a colored/themed container wrapping two `Content`-style columns.
+- When you want independent buttons, links, and bullet lists per column.
+
+## Example
+
+```json
+{
+  "type": "info-block",
+  "theme": "dark",
+  "backgroundColor": {"light": "#eef3fe", "dark": "#000000"},
+  "leftContent": {
+    "title": "Lorem ipsum dolor sit amet",
+    "text": "**Ut enim ad minim veniam** [quis nostrud](https://example.com) exercitation.",
+    "buttons": [
+      {"text": "Button", "theme": "raised", "url": "#"},
+      {"text": "Button", "theme": "outlined-contrast", "url": "#"}
+    ]
+  },
+  "rightContent": {
+    "title": "Lorem ipsum dolor sit amet",
+    "text": "**Ut enim ad minim veniam** [quis nostrud](https://example.com) exercitation.",
+    "links": [{"url": "#", "text": "Link", "theme": "normal", "arrow": true}]
+  }
+}
+```
+
+## Properties
+
+| Property                     | Type                      | Default  | Description                                                                                       |
+| ---------------------------- | ------------------------- | -------- | ------------------------------------------------------------------------------------------------- |
+| `leftContent`                | `ContentProps`            | —        | Left column content. See below.                                                                   |
+| `rightContent`               | `ContentProps`            | —        | Right column content. See below.                                                                  |
+| `backgroundColor`            | `string \| {light, dark}` | —        | Background color of the container.                                                                |
+| `theme`                      | `'light' \| 'dark'`       | `'dark'` | Text/content theme used inside the columns.                                                       |
+| `title` _deprecated_         | `string`                  | —        | Legacy left-column title; prefer `leftContent.title`.                                             |
+| `sectionsTitle` _deprecated_ | `string`                  | —        | Legacy right-column title; prefer `rightContent.title`.                                           |
+| `buttons` _deprecated_       | `ButtonBlock[]`           | `[]`     | Legacy buttons appended to the left column; prefer `leftContent.buttons`.                         |
+| `links` _deprecated_         | `LinkProps[]`             | `[]`     | Legacy links appended to the right column (rendered as arrow links); prefer `rightContent.links`. |
+
+### `leftContent` / `rightContent` (`ContentProps`)
+
+| Property          | Type                    | Default | Description                                                                                    |
+| ----------------- | ----------------------- | ------- | ---------------------------------------------------------------------------------------------- |
+| `title`           | `string \| TitleProps`  | —       | Column heading.                                                                                |
+| `text`            | `string`                | —       | YFM body text.                                                                                 |
+| `additionalInfo`  | `string`                | —       | YFM supplementary text below the body.                                                         |
+| `links`           | `LinkProps[]`           | —       | Inline text links.                                                                             |
+| `buttons`         | `ButtonBlock[]`         | —       | CTA buttons.                                                                                   |
+| `list`            | `ContentItem[]`         | —       | Bullet-style list with optional icons per item (`icon` or `gravityIcon`, plus `title`/`text`). |
+| `controlPosition` | `'default' \| 'bottom'` | —       | Vertical placement of buttons/links.                                                           |
+
+### Common properties
+
+Inherits: `when`. See the root README for details. (This block does not expose `anchor`, `visible`, `indent`, `animated`, or `context`.)
+
+## Themed values
+
+`backgroundColor` accepts either a plain color string or a `{light, dark}` object resolved against the active runtime theme.
+
+## Storybook
+
+[Info](https://preview.gravity-ui.com/page-constructor/?path=/docs/blocks-info--docs)

package/build/docs/blocks/Map.md

@@ -0,0 +1,81 @@
+# Map
+
+A media-and-content block that embeds an interactive Yandex Map inside a card, paired with an optional title, description, links, and buttons.
+
+## Block type
+
+`type: 'map-block'`
+
+## When to use
+
+- You need to show one or more geographic points with an interactive map.
+- You want a titled, bordered map card next to marketing copy and CTAs.
+- You want a responsive `media-content` / `content-media` layout.
+
+## Example
+
+```json
+{
+  "type": "map-block",
+  "title": "Our office",
+  "description": "**Ut enim ad minim veniam** [quis nostrud](https://example.com) exercitation ullamco laboris.",
+  "direction": "content-media",
+  "map": {
+    "zoom": 9,
+    "id": "common-places",
+    "markers": [
+      {
+        "address": "Moscow Arbat",
+        "coordinate": [55.753994, 37.622093]
+      }
+    ]
+  }
+}
+```
+
+## Properties
+
+| Property            | Type                                 | Default | Description                                                                |
+| ------------------- | ------------------------------------ | ------- | -------------------------------------------------------------------------- |
+| `title` _required_  | `string \| TitleProps`               | —       | Block title (plain string or options object with `textSize`, `url`, etc.). |
+| `map` _required_    | `MapProps`                           | —       | Map configuration. See below.                                              |
+| `description`       | `string` (YFM)                       | —       | Block description.                                                         |
+| `direction`         | `'media-content' \| 'content-media'` | —       | Relative position of map and content.                                      |
+| `mobileDirection`   | `'media-content' \| 'content-media'` | —       | Direction on touch devices.                                                |
+| `largeMedia`        | `boolean`                            | —       | When `true`, the map takes 8 of 12 columns.                                |
+| `border`            | `'shadow' \| 'line' \| 'none'`       | —       | Map card border.                                                           |
+| `disableShadow`     | `boolean` (deprecated)               | —       | Use `border: 'none'` instead.                                              |
+| `mediaOnly`         | `boolean`                            | —       | Renders only the map, without content.                                     |
+| `mediaOnlyColSizes` | `{sm?, md?, lg?, xl?, all?}`         | —       | Column sizes when `mediaOnly` is `true`.                                   |
+| `additionalInfo`    | `string` (YFM)                       | —       | Gray supplementary text.                                                   |
+| `links`             | `LinkProps[]`                        | —       | Array of link objects.                                                     |
+| `buttons`           | `ButtonProps[]`                      | —       | Array of button objects.                                                   |
+| `theme`             | `'default' \| 'dark' \| 'light'`     | —       | Content theme.                                                             |
+| `controlPosition`   | `'default' \| 'bottom'`              | —       | Vertical position of links/buttons.                                        |
+
+### `map` (MapProps)
+
+| Property          | Type                                    | Default | Description                                                |
+| ----------------- | --------------------------------------- | ------- | ---------------------------------------------------------- |
+| `zoom`            | `number`                                | —       | Initial map zoom level.                                    |
+| `address`         | `string`                                | —       | Address string used for geocoding / balloons.              |
+| `id`              | `string`                                | —       | Map instance id.                                           |
+| `markers`         | `Array<{coordinate, address?, label?}>` | —       | Markers to place on the map. `coordinate` is `[lat, lng]`. |
+| `disableControls` | `boolean`                               | —       | Hides map controls.                                        |
+| `disableBalloons` | `boolean`                               | —       | Disables marker balloons.                                  |
+
+### Common properties
+
+Inherits: `anchor`, `visible`, `indent`, `qa`, `className`, `animated`, `theme`, `when`, `context`. See root README.
+
+## Setup notes
+
+The Map block requires the maps provider. Pass `mapsContext` (with `apikey`, map `type`, and `scriptSrc`) to `PageConstructorProvider`, otherwise the map cannot be loaded.
+
+## Themed values
+
+`map` is not themed itself, but the surrounding media block supports themed media; pass `{light, dark}` where a themed media value is expected.
+
+## Storybook
+
+[Map](https://preview.gravity-ui.com/page-constructor/?path=/docs/blocks-map--docs)

package/build/docs/blocks/Media.md

@@ -0,0 +1,63 @@
+# Media
+
+Renders a two-column layout that pairs a content column (title, body, list, links, button) with a media column (image, video, YouTube, iframe, or DataLens embed). Use it for feature or explainer sections where text and a rich media asset need to sit side by side.
+
+## Block type
+
+`type: 'media-block'`
+
+## When to use
+
+- Feature or "how it works" sections with text on one side and media on the other.
+- When you need an image gallery (array of images becomes a slider), video player, YouTube embed, iframe, or DataLens visualization in the same block.
+- When you want to control media-vs-content order, sizing, or border treatment.
+
+## Example
+
+```json
+{
+  "type": "media-block",
+  "title": "Lorem ipsum dolor sit",
+  "description": "**Ut enim ad minim veniam** [quis nostrud](https://example.com) exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.",
+  "size": "l",
+  "direction": "media-content",
+  "media": {
+    "light": {"image": "/images/media-light.png"},
+    "dark": {"image": "/images/media-dark.png"}
+  }
+}
+```
+
+## Properties
+
+| Property             | Type                                 | Default | Description                                                                                                                                                                                            |
+| -------------------- | ------------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `title` _required_   | `string \| TitleProps`               | —       | Section heading. String or `TitleProps` (`text`, `textSize`, `url`, `urlTitle`, `analyticsEvents`).                                                                                                    |
+| `media` _required_   | `MediaProps \| {light, dark}`        | —       | Media column: `image` (single or array → slider), `video`, `youtube`, `videoIframe`, `iframe`, `dataLens`, plus `previewImg`, `autoplay`, `parallax`, `height`, `ratio`, `fullscreen`, `margins`, etc. |
+| `description`        | `string`                             | —       | YFM body text rendered under the title.                                                                                                                                                                |
+| `additionalInfo`     | `string`                             | —       | YFM supplementary text below the body.                                                                                                                                                                 |
+| `size`               | `'s' \| 'm' \| 'l' \| 'xl'`          | —       | Overall content/media scale.                                                                                                                                                                           |
+| `links`              | `LinkProps[]`                        | —       | Inline text links rendered under the content.                                                                                                                                                          |
+| `buttons` / `button` | `ButtonBlock[]` / `ButtonBlock`      | —       | CTA button(s) attached to the content column.                                                                                                                                                          |
+| `list`               | `ContentItem[]`                      | —       | Bullet-style list with optional icons per item.                                                                                                                                                        |
+| `controlPosition`    | `'default' \| 'bottom'`              | —       | Vertical placement of the buttons/links.                                                                                                                                                               |
+| `direction`          | `'media-content' \| 'content-media'` | —       | Column order on desktop.                                                                                                                                                                               |
+| `mobileDirection`    | `'media-content' \| 'content-media'` | —       | Column order on mobile.                                                                                                                                                                                |
+| `largeMedia`         | `boolean`                            | —       | Gives the media column a wider share of the grid.                                                                                                                                                      |
+| `mediaOnly`          | `boolean`                            | —       | Renders only the media column, hiding the content.                                                                                                                                                     |
+| `mediaOnlyColSizes`  | `{sm?, md?, lg?, xl?, all?}`         | —       | Column sizes used when `mediaOnly` is `true`.                                                                                                                                                          |
+| `border`             | `'shadow' \| 'line' \| 'none'`       | —       | Border/shadow treatment around the media.                                                                                                                                                              |
+| `disableShadow`      | `boolean` (deprecated)               | —       | Legacy flag; use `border: 'none'` instead.                                                                                                                                                             |
+| `animated`           | `boolean`                            | —       | Enables an entrance animation.                                                                                                                                                                         |
+
+### Common properties
+
+Inherits common block properties: `anchor`, `visible`, `indent` (`{top?, bottom?}`), `qa`, `className`, `animated`, `theme` (`'light' | 'dark'`), `when`, `context`. See the root README for details.
+
+## Themed values
+
+`media` accepts either a plain value or a `{light, dark}` object resolved against the active runtime theme.
+
+## Storybook
+
+[Media](https://preview.gravity-ui.com/page-constructor/?path=/docs/blocks-media--docs)

package/build/docs/blocks/PromoFeaturesBlock.md

@@ -0,0 +1,74 @@
+# PromoFeaturesBlock
+
+Renders a masonry layout of promotional feature cards, each pairing a title, YFM text, and an optional media asset, displayed against a full-width background. Use it for marketing sections that showcase several value propositions with rich imagery in a non-uniform grid.
+
+## Block type
+
+`type: 'promo-features-block'`
+
+## When to use
+
+- Marketing sections that mix feature cards with media (image/video) of varying heights.
+- When you want an accent/primary card theme to draw attention to specific items.
+- Promo landing sections where a full-width background tone (default or grey) is desired.
+
+## Example
+
+```json
+{
+  "type": "promo-features-block",
+  "title": "Lorem ipsum dolor sit amet",
+  "description": "**Ut enim ad minim veniam** [quis nostrud](https://example.com) exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.",
+  "theme": "grey",
+  "items": [
+    {
+      "title": "Lorem ipsum dolor sit amet",
+      "text": "**Ut enim ad minim veniam** [quis nostrud](https://example.com) exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.",
+      "media": {"image": "/story-assets/img-mini_4-12_dark.png"}
+    },
+    {
+      "title": "Lorem ipsum dolor sit amet",
+      "text": "**Ut enim ad minim veniam** [quis nostrud](https://example.com) exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.",
+      "theme": "accent",
+      "media": {"image": "/story-assets/img-mini_4-12_dark.png"}
+    },
+    {
+      "title": "Lorem ipsum dolor sit amet",
+      "text": "**Ut enim ad minim veniam** [quis nostrud](https://example.com) exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.",
+      "theme": "primary",
+      "media": {"image": "/story-assets/img-mini_4-12_white.png"}
+    }
+  ]
+}
+```
+
+## Properties
+
+| Property           | Type                   | Default     | Description                                                                                         |
+| ------------------ | ---------------------- | ----------- | --------------------------------------------------------------------------------------------------- |
+| `title`            | `string \| TitleProps` | —           | Block heading (string or Title options). |
+| `description`      | `string`               | —           | YFM subtitle shown under the title.                                                                 |
+| `theme`            | `'grey' \| 'default'`  | `'default'` | Full-width background tone for the block.                                                           |
+| `items` _required_ | `PromoFeaturesItem[]`  | —           | Array of promo feature cards (see below).                                                           |
+| `animated`         | `boolean`              | `true`      | Enables entrance animation for the block.                                                           |
+
+### `PromoFeaturesItem`
+
+| Property           | Type                                      | Default                  | Description                                                                                    |
+| ------------------ | ----------------------------------------- | ------------------------ | ---------------------------------------------------------------------------------------------- |
+| `title` _required_ | `string`                                  | —                        | Card title (rendered as `<h3>`).                                                               |
+| `text` _required_  | `string`                                  | —                        | YFM card body text.                                                                            |
+| `theme`            | `'accent' \| 'accent-light' \| 'primary'` | derived from block theme | Card color treatment.                                                                          |
+| `media`            | `MediaProps \| {light, dark}`             | —                        | Media (image/video) attached to the card. When omitted, the card renders without a media area. |
+
+### Common properties
+
+Inherits common block properties: `anchor`, `visible`, `indent` (`{top?, bottom?}`), `qa`, `className`, `animated`, `theme` (`'light' | 'dark'`), `when`, `context`. See the root README for details.
+
+## Themed values
+
+`media` accepts either a plain value or a `{light, dark}` object resolved against the active runtime theme.
+
+## Storybook
+
+[PromoFeaturesBlock](https://preview.gravity-ui.com/page-constructor/?path=/docs/blocks-promofeaturesblock--docs)

package/build/docs/blocks/Questions.md

@@ -0,0 +1,78 @@
+# Questions
+
+Renders an FAQ block: a left content panel (title, text, links, buttons) and a list of expandable question/answer rows on the right. Automatically emits `FAQPage` JSON-LD microdata so search engines can index the answers as rich results.
+
+## Block type
+
+`type: 'questions-block'`
+
+## When to use
+
+- FAQ sections that benefit from search-engine rich results (JSON-LD `FAQPage`).
+- Q&A lists where each answer should expand/collapse.
+- When you need an intro panel (title, description, CTA) next to the questions.
+
+## Example
+
+```json
+{
+  "type": "questions-block",
+  "title": "Lorem ipsum",
+  "text": "Dolor sit amet, consectetur adipiscing elit [sed do eiusmod](https://example.com) tempor incididunt ut labore et dolore magna aliqua.",
+  "additionalInfo": "Dolor sit amet [consectetur adipiscing](https://example.com) Duis aute irure dolor in reprehenderit.",
+  "links": [{"url": "/security", "text": "Learn more", "theme": "normal", "arrow": true}],
+  "buttons": [{"text": "Button", "theme": "action", "url": "https://example.com"}],
+  "items": [
+    {
+      "title": "Lorem ipsum dolor sit amet 0",
+      "text": "Consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
+      "link": {"url": "#", "text": "Documentation", "theme": "normal", "arrow": true}
+    },
+    {
+      "title": "Ut enim ad minim veniam, quis nostrud exercitation ullamco? 1",
+      "text": "laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.",
+      "link": {"url": "#", "text": "Documentation", "theme": "normal", "arrow": true}
+    },
+    {
+      "title": "1. Lorem ipsum",
+      "text": "Lorem ipsum dolor sit amet:\n- Lorem ipsum\n- Lorem ipsum\n- Lorem ipsum",
+      "link": {"url": "#", "text": "Documentation", "theme": "normal", "arrow": true},
+      "listStyle": "disk"
+    }
+  ]
+}
+```
+
+## Properties
+
+| Property           | Type                    | Default | Description                                                                                              |
+| ------------------ | ----------------------- | ------- | -------------------------------------------------------------------------------------------------------- |
+| `title` _required_ | `string \| TitleProps`  | —       | Left-panel heading (string or Title options). |
+| `text`             | `string`                | —       | YFM body text in the left panel.                                                                         |
+| `additionalInfo`   | `string`                | —       | YFM supplementary text in the left panel.                                                                |
+| `links`            | `LinkProps[]`           | —       | Array of links rendered in the left panel.                                                               |
+| `buttons`          | `ButtonBlock[]`         | —       | Array of buttons rendered in the left panel.                                                             |
+| `list`             | `ContentItem[]`         | —       | Icon + title + text list rendered in the left panel. Each item requires an `icon` or `gravityIcon`.      |
+| `controlPosition`  | `'default' \| 'bottom'` | —       | Position of the link/button controls in the left panel.                                                  |
+| `items` _required_ | `QuestionItem[]`        | —       | Collapsible question rows on the right (see below).                                                      |
+
+### `QuestionItem`
+
+| Property           | Type               | Default  | Description                                                                             |
+| ------------------ | ------------------ | -------- | --------------------------------------------------------------------------------------- |
+| `title` _required_ | `string`           | —        | Question text (always visible). Also used as the JSON-LD `Question.name`.               |
+| `text` _required_  | `string`           | —        | YFM answer text revealed when expanded. Also used as the JSON-LD `acceptedAnswer.text`. |
+| `link`             | `LinkProps`        | —        | Link rendered below the answer.                                                         |
+| `listStyle`        | `'dash' \| 'disk'` | `'dash'` | Marker style for lists inside the answer.                                               |
+
+### Common properties
+
+Inherits common block properties: `anchor`, `visible`, `indent` (`{top?, bottom?}`), `qa`, `className`, `animated`, `theme` (`'light' | 'dark'`), `when`, `context`. See the root README for details.
+
+## Themed values
+
+No dedicated themed props; the block follows the runtime `theme` for text/background coloring.
+
+## Storybook
+
+[Questions](https://preview.gravity-ui.com/page-constructor/?path=/docs/blocks-questions--docs)

package/build/docs/blocks/Share.md

@@ -0,0 +1,45 @@
+# Share
+
+Renders a row of social-network share buttons that share the current page URL.
+
+## Block type
+
+`type: 'share-block'`
+
+## When to use
+
+- You want to let visitors share the current page on social networks.
+- You need a compact, localized share strip with analytics events on click.
+
+## Example
+
+```json
+{
+  "type": "share-block",
+  "title": "Share on social networks",
+  "items": ["facebook", "vk", "telegram", "twitter", "linkedin"]
+}
+```
+
+## Properties
+
+| Property           | Type                                                                 | Default                  | Description                                                                  |
+| ------------------ | -------------------------------------------------------------------- | ------------------------ | ---------------------------------------------------------------------------- |
+| `items` _required_ | `Array<'telegram' \| 'facebook' \| 'twitter' \| 'vk' \| 'linkedin'>` | —                        | Social networks to render, in order.                                         |
+| `title`            | `string` (YFM)                                                       | localized "Share" string | Heading above the buttons. When omitted, a localized default title is shown. |
+
+### Common properties
+
+Inherits: `anchor`, `visible`, `indent`, `qa`, `className`, `animated`, `theme`, `when`, `context`. See root README.
+
+## Notes
+
+The shared URL is derived from the `LocationContext` (hostname + pathname) provided by `PageConstructorProvider`. Click events are reported through the analytics handler under the `shareButton` event name.
+
+## Themed values
+
+This block has no themed-value properties.
+
+## Storybook
+
+[Share](https://preview.gravity-ui.com/page-constructor/?path=/docs/blocks-share--docs)