Skip to content

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

TypeScript

docs(storybook): fix @example blocks for Storybook autodocs compat (#1811)

Joeyc66b40b03100
diff --git a/packages/core/src/Layout/XDSLayoutPanel.tsx b/packages/core/src/Layout/XDSLayoutPanel.tsx
index f54d5a175d..d67f98a6ed 100644
--- a/packages/core/src/Layout/XDSLayoutPanel.tsx
+++ b/packages/core/src/Layout/XDSLayoutPanel.tsx
@@ -163,7 +163,7 @@ export interface XDSLayoutPanelProps extends XDSBaseProps<HTMLDivElement> {
* to this panel.
*
* @example
- * ```tsx
+ * ```
* const sidebar = useXDSResizable({ defaultSize: 250, minSizePx: 200 });
* <XDSLayoutPanel resizable={sidebar.props}>
* <Navigation />
diff --git a/packages/core/src/Resizable/XDSResizeHandle.tsx b/packages/core/src/Resizable/XDSResizeHandle.tsx
index fb1508f13b..a4171815a4 100644
--- a/packages/core/src/Resizable/XDSResizeHandle.tsx
+++ b/packages/core/src/Resizable/XDSResizeHandle.tsx
@@ -193,6 +193,19 @@ export interface XDSResizeHandleProps extends Omit<
xstyle?: stylex.StyleXStyles;
}
+/**
+ * Draggable resize handle placed between resizable panels. Renders as a thin
+ * divider line with a wider invisible hit area and optional pill grip indicator.
+ * Supports keyboard resizing via arrow keys and WAI-ARIA separator role.
+ *
+ * @example
+ * ```
+ * <XDSResizeHandle
+ * resizable={sidebar.props}
+ * direction="horizontal"
+ * hasDivider />
+ * ```
+ */
export function XDSResizeHandle({
direction = 'horizontal',
isReversed = false,
diff --git a/packages/core/src/SelectableCard/XDSSelectableCard.tsx b/packages/core/src/SelectableCard/XDSSelectableCard.tsx
index 2723654089..89767eb0ef 100644
--- a/packages/core/src/SelectableCard/XDSSelectableCard.tsx
+++ b/packages/core/src/SelectableCard/XDSSelectableCard.tsx
@@ -228,7 +228,6 @@ export interface XDSSelectableCardProps extends Omit<XDSBaseProps, 'onChange'> {
/** Maximum width of the card. */
maxWidth?: SizeValue;
-
}
// =============================================================================
@@ -253,42 +252,12 @@ export interface XDSSelectableCardProps extends Omit<XDSBaseProps, 'onChange'> {
*
* @example
* ```
- * // Single select (radio behavior)
- * const [selected, setSelected] = useState<string | null>(null);
- *
- * {plans.map(plan => (
- * <XDSSelectableCard
- * key={plan.id}
- * label={plan.name}
- * isSelected={selected === plan.id}
- * onChange={() => setSelected(plan.id)}
- * >
- * <XDSText type="body" weight="bold">{plan.name}</XDSText>
- * </XDSSelectableCard>
- * ))}
- * ```
- *
- * @example
- * ```
- * // Multi-select (checkbox behavior)
- * const [selected, setSelected] = useState(new Set<string>());
- *
- * {filters.map(filter => (
- * <XDSSelectableCard
- * key={filter.id}
- * label={filter.name}
- * isSelected={selected.has(filter.id)}
- * onChange={(isNowSelected) => {
- * setSelected(prev => {
- * const next = new Set(prev);
- * isNowSelected ? next.add(filter.id) : next.delete(filter.id);
- * return next;
- * });
- * }}
- * >
- * <XDSText type="body">{filter.name}</XDSText>
- * </XDSSelectableCard>
- * ))}
+ * <XDSSelectableCard
+ * label="Option A"
+ * isSelected={selected === 'a'}
+ * onChange={() => setSelected('a')}>
+ * <XDSText type="body" weight="bold">Option A</XDSText>
+ * </XDSSelectableCard>
* ```
*/
export function XDSSelectableCard({
@@ -341,14 +310,16 @@ export function XDSSelectableCard({
variant,
selected: isSelected ? 'true' : 'false',
})}
- xstyle={[
- styles.interactive,
- styles.focusWithin,
- isSelected && selectedStyleForVariant(variant),
- !isDisabled && styles.overlay,
- !isDisabled && styles.hoverOnPointer,
- isDisabled && styles.disabled,
- ] as unknown as StyleXStyles}
+ xstyle={
+ [
+ styles.interactive,
+ styles.focusWithin,
+ isSelected && selectedStyleForVariant(variant),
+ !isDisabled && styles.overlay,
+ !isDisabled && styles.hoverOnPointer,
+ isDisabled && styles.disabled,
+ ] as unknown as StyleXStyles
+ }
onClick={!isDisabled ? onClick : undefined}
onMouseUp={!isDisabled ? onMouseUp : undefined}
{...props}>