Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

docs(core): document Section's paddingBlock prop (#3210)

Durvesh Pilankar810ac7dff8ce
diff --git a/.changeset/section-paddingblock-doc.md b/.changeset/section-paddingblock-doc.md
new file mode 100644
index 0000000000..253837b1aa
--- /dev/null
+++ b/.changeset/section-paddingblock-doc.md
@@ -0,0 +1,6 @@
+---
+'@astryxdesign/core': patch
+---
+
+[docs] Document Section's `paddingBlock` prop (block-axis padding override), which was supported by the component but missing from the docsite properties tab
+@durvesh1992
diff --git a/packages/core/src/Section/Section.doc.mjs b/packages/core/src/Section/Section.doc.mjs
index f4132efaf8..91706c9643 100644
--- a/packages/core/src/Section/Section.doc.mjs
+++ b/packages/core/src/Section/Section.doc.mjs
@@ -53,6 +53,11 @@ export const docs = {
description: 'Internal padding using the spacing scale (0, 0.5, 1, 1.5, 2, 3, 4, 5, 6, 8, 10). Use padding={0} for edge-to-edge content.',
default: '4',
},
+ {
+ name: 'paddingBlock',
+ type: 'SpacingStep',
+ description: 'Block (vertical) padding override. Overrides only the block-axis padding while preserving inline padding from `padding` or the container theme default. Accepts the spacing scale (0, 0.5, 1, 1.5, 2, 3, 4, 5, 6, 8, 10).',
+ },
{
name: 'xstyle',
type: 'StyleXStyles',
@@ -130,6 +135,11 @@ export const docsZh = {
description: '使用间距比例的内部内边距(0, 0.5, 1, 1.5, 2, 3, 4, 5, 6, 8, 10)。使用 padding={0} 实现全宽内容。',
default: '4',
},
+ {
+ name: 'paddingBlock',
+ type: 'SpacingStep',
+ description: '块(垂直)方向内边距覆盖。仅覆盖块轴内边距,同时保留来自 padding 或容器主题默认值的行内内边距。使用间距比例(0, 0.5, 1, 1.5, 2, 3, 4, 5, 6, 8, 10)。',
+ },
{
name: 'xstyle',
type: 'StyleXStyles',
@@ -182,6 +192,7 @@ export const docsDense = {
children: 'Content rendered inside section.',
dividers: 'Which sides of section have divider borders.',
padding: 'Internal padding via spacing scale; 0 for edge-to-edge content.',
+ paddingBlock: 'Block-axis padding override; preserves inline padding from padding/theme.',
xstyle: 'StyleX styles for layout customization; must be stylex.create() value.',
},
};