@gravity-ui/page-constructor 8.15.0 → 8.17.0

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)

package/build/docs/blocks/Slider.md

@@ -0,0 +1,89 @@
+# Slider
+
+A carousel block that renders any number of child cards as swipeable slides, with optional title, description, dots, arrows, autoplay, and per-breakpoint slide counts. Built on top of Swiper.
+
+## Block type
+
+`type: 'slider-block'`
+
+## When to use
+
+- You need to display a sequence of cards (basic cards, quote cards, image cards, etc.) in a carousel.
+- You need responsive control over how many slides are visible at each breakpoint.
+- You want autoplay, pagination dots, and navigation arrows.
+
+## Example
+
+```json
+{
+  "type": "slider-block",
+  "title": {"text": "QuoteCards", "url": "https://example.com"},
+  "description": "Lorem ipsum dolor sit amet",
+  "dots": true,
+  "arrows": true,
+  "slidesToShow": 1,
+  "children": [
+    {
+      "type": "quote",
+      "text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
+      "image": {
+        "light": "/images/quote-light.png",
+        "dark": "/images/quote-dark.png"
+      },
+      "logo": "/images/company-logo.svg",
+      "author": {
+        "firstName": "Lorem",
+        "secondName": "ipsum",
+        "description": "Lorem ipsum",
+        "avatar": "/story-assets/img_6-12_light.png"
+      }
+    },
+    {
+      "type": "basic-card",
+      "title": "Basic card",
+      "text": "Ut enim ad minim veniam.",
+      "icon": "/story-assets/icon_1_light.svg"
+    }
+  ]
+}
+```
+
+Responsive `slidesToShow`:
+
+```json
+"slidesToShow": {"sm": 1, "md": 2, "lg": 3, "xl": 4}
+```
+
+## Properties
+
+| Property       | Type                                                   | Default | Description                                                                                                                   |
+| -------------- | ------------------------------------------------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| `title`        | `string \| TitleProps`                                 | —       | Block title (plain string or options object).                                                                                 |
+| `description`  | `string` (YFM)                                         | —       | Block description under the title.                                                                                            |
+| `children`     | `Card[]`                                               | —       | Array of child card blocks rendered as slides. Any registered card type is allowed.                                           |
+| `slidesToShow` | `number \| {sm?, md?, lg?, xl?}`                       | —       | Number of slides to show. A number applies to all breakpoints; an object sets per-breakpoint counts (`sm`, `md`, `lg`, `xl`). |
+| `dots`         | `boolean`                                              | `true`  | Show pagination dots.                                                                                                         |
+| `arrows`       | `boolean`                                              | `true`  | Show prev/next navigation arrows.                                                                                             |
+| `arrowSize`    | `number`                                               | —       | Size of the navigation arrows in pixels.                                                                                      |
+| `autoplay`     | `number`                                               | —       | Autoplay interval in milliseconds. When set and positive, dots are hidden from the accessibility tab order.                   |
+| `adaptive`     | `boolean`                                              | —       | Adaptive slide height.                                                                                                        |
+| `randomOrder`  | `boolean`                                              | —       | Shuffle slides on render.                                                                                                     |
+| `type`         | `string`                                               | —       | Logical slider type, used for grouping / loadable sources.                                                                    |
+| `disclaimer`   | `{text *required*, size?}`                             | —       | Disclaimer text under the slider. `size` is one of `'xs' \| 's' \| 'sm' \| 'm' \| 'l'`.                                       |
+| `loadable`     | `{source *required*, params?, minCount? (deprecated)}` | —       | Disabled in the default schema. Used by projects that wire up a custom loadable source for slides.                            |
+
+### Common properties
+
+Inherits: `anchor`, `visible`, `indent`, `qa`, `className`, `animated`, `theme`, `when`, `context`. See root README.
+
+## Notes
+
+`children` accepts any block registered as a "card" in the schema. Common examples include `basic-card`, `quote`, image cards, and other content cards. A slider with a single child automatically renders without dots and arrows.
+
+## Themed values
+
+Child cards may individually use themed values (e.g. `{light, dark}` images); the block itself does not theme its scalar properties.
+
+## Storybook
+
+[Slider](https://preview.gravity-ui.com/page-constructor/?path=/docs/blocks-slider--docs)

package/build/docs/blocks/SliderOld.md

@@ -0,0 +1,63 @@
+# SliderOld
+
+> ⚠️ **Deprecated.** `slider-old-block` is deprecated and will be removed in a future major release. Use [`slider-block`](./Slider.md) (the `Slider` block, built on Swiper) for new and existing pages.
+
+The legacy carousel block, built on top of `react-slick`. Renders child cards as slides with optional title, description, dots, arrows, autoplay, and per-breakpoint slide counts.
+
+## Block type
+
+`type: 'slider-old-block'`
+
+## When to use
+
+- Only for backward compatibility with existing JSON that already uses `slider-old-block`.
+- For anything new, use `slider-block`.
+
+## Example
+
+```json
+{
+  "type": "slider-old-block",
+  "title": {"text": "Slider", "url": "https://example.com"},
+  "description": "Lorem ipsum dolor sit amet",
+  "dots": true,
+  "arrows": true,
+  "animated": true,
+  "children": [
+    {
+      "type": "basic-card",
+      "url": "https://example.com",
+      "title": "Lorem ipsum dolor sit amet",
+      "text": "Ut enim ad minim veniam.",
+      "icon": "/story-assets/icon_1_light.svg"
+    }
+  ]
+}
+```
+
+## Properties
+
+| Property       | Type                                                   | Default | Description                                                                             |
+| -------------- | ------------------------------------------------------ | ------- | --------------------------------------------------------------------------------------- |
+| `title`        | `string \| TitleProps`                                 | —       | Block title (plain string or options object).                                           |
+| `description`  | `string` (YFM)                                         | —       | Block description under the title.                                                      |
+| `children`     | `Card[]`                                               | —       | Array of child card blocks rendered as slides.                                          |
+| `slidesToShow` | `number \| {sm?, md?, lg?, xl?}`                       | —       | Number of slides to show, constant or per-breakpoint.                                   |
+| `dots`         | `boolean`                                              | `true`  | Show pagination dots.                                                                   |
+| `arrows`       | `boolean`                                              | `true`  | Show prev/next navigation arrows.                                                       |
+| `autoplay`     | `number`                                               | —       | Autoplay speed in milliseconds.                                                         |
+| `randomOrder`  | `boolean`                                              | —       | Shuffle slides on render.                                                               |
+| `disclaimer`   | `{text *required*, size?}`                             | —       | Disclaimer text under the slider. `size` is one of `'xs' \| 's' \| 'sm' \| 'm' \| 'l'`. |
+| `loadable`     | `{source *required*, params?, minCount? (deprecated)}` | —       | Disabled in the default schema; used by projects that wire up a custom loadable source. |
+
+### Common properties
+
+Inherits: `anchor`, `visible`, `indent`, `qa`, `className`, `animated`, `theme`, `when`, `context`. See root README.
+
+## Themed values
+
+Child cards may individually use themed values; the block itself does not theme its scalar properties.
+
+## Storybook
+
+[SliderOld](https://preview.gravity-ui.com/page-constructor/?path=/docs/blocks-sliderold-deprecated--docs)

package/build/docs/blocks/Table.md

@@ -0,0 +1,64 @@
+# Table
+
+Renders a title followed by a comparison-style table whose cells are plain strings or numbers. A legend column can be marked with `disk` or `tick` markers, and an optional legend list explains the marked columns.
+
+## Block type
+
+`type: 'table-block'`
+
+## When to use
+
+- Side-by-side feature/plan comparison tables.
+- Dense matrices of boolean-style checks ("0"/"1") with a legend.
+- Tabular reference data that needs per-column text alignment control.
+
+## Example
+
+```json
+{
+  "type": "table-block",
+  "title": "Lorem ipsum dolor sit amet",
+  "table": {
+    "content": [
+      ["Lorem", "ipsum 1", "dolor 2", "sit 3"],
+      ["Lorem 1", "0", "0", "0"],
+      ["Lorem 2", "0", "0", "1"],
+      ["Lorem 3", "1", "1", "1"]
+    ],
+    "legend": ["ipsum 1", "ipsum 2"],
+    "marker": "tick",
+    "justify": ["start", "center", "center", "center"],
+    "caption": "Comparison of features"
+  }
+}
+```
+
+## Properties
+
+| Property           | Type         | Default | Description                   |
+| ------------------ | ------------ | ------- | ----------------------------- |
+| `title` _required_ | `string`     | —       | Section heading (plain text). |
+| `table` _required_ | `TableProps` | —       | Table definition. See below.  |
+
+### `table`
+
+| Property             | Type                               | Default | Description                                                                                   |
+| -------------------- | ---------------------------------- | ------- | --------------------------------------------------------------------------------------------- |
+| `content` _required_ | `(string \| number)[][]`           | —       | Rows of cells. The first row is treated as the header row. Each cell is a string or a number. |
+| `legend`             | `string[]`                         | —       | YFM captions describing the marked columns; rendered as a legend list.                        |
+| `hideLegend`         | `boolean`                          | —       | Hides the rendered legend list while keeping markers in the table.                            |
+| `marker`             | `'disk' \| 'tick'`                 | —       | Marker style applied to legend cells. When omitted, no marker is rendered.                    |
+| `justify`            | `('start' \| 'center' \| 'end')[]` | —       | Per-column horizontal alignment. Values map to columns by index.                              |
+| `caption`            | `string`                           | —       | Accessible name for the table (not displayed visually).                                       |
+
+### Common properties
+
+Inherits: `anchor`, `visible`, `indent` (`{top?, bottom?}`), `qa`, `className`, `when`, `context`. See the root README for details.
+
+## Themed values
+
+This block does not introduce theme-aware properties of its own.
+
+## Storybook
+
+[Table](https://preview.gravity-ui.com/page-constructor/?path=/docs/blocks-table--docs)