From 21ff32f97cf37138287b2923762ff9eefac82526 Mon Sep 17 00:00:00 2001
From: Liu Liu <liuliu-dev@github.com>
Date: Mon, 20 Apr 2026 14:48:19 -0700
Subject: [PATCH] variant and shape in docs and storybook

---
 packages/react/src/AvatarStack/AvatarStack.docs.json | 12 ++++++++++++
 .../react/src/AvatarStack/AvatarStack.stories.tsx    |  8 +++++++-
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/packages/react/src/AvatarStack/AvatarStack.docs.json b/packages/react/src/AvatarStack/AvatarStack.docs.json
index f9d40605ca8..044b0849f6e 100644
--- a/packages/react/src/AvatarStack/AvatarStack.docs.json
+++ b/packages/react/src/AvatarStack/AvatarStack.docs.json
@@ -52,6 +52,18 @@
       "defaultValue": "false",
       "description": "Do not spread the avatars on hover"
     },
+    {
+      "name": "variant",
+      "type": "'cascade' | 'stack'",
+      "defaultValue": "'cascade'",
+      "description": "The style of overlapping avatars. 'cascade' increases the overlap for 3rd+ avatars, while 'stack' uses a uniform overlap."
+    },
+    {
+      "name": "shape",
+      "type": "'circle' | 'square'",
+      "defaultValue": "'circle'",
+      "description": "The shape of the avatars."
+    },
     {
       "name": "size",
       "type": "number | { narrow?: number; regular?: number; wide?: number; }",
diff --git a/packages/react/src/AvatarStack/AvatarStack.stories.tsx b/packages/react/src/AvatarStack/AvatarStack.stories.tsx
index bfb32a7fed0..ce5b64fe15f 100644
--- a/packages/react/src/AvatarStack/AvatarStack.stories.tsx
+++ b/packages/react/src/AvatarStack/AvatarStack.stories.tsx
@@ -26,7 +26,13 @@ export const Default = () => (
 )
 
 export const Playground: StoryFn<Args> = args => (
-  <AvatarStack size={parseSizeFromArgs(args)} alignRight={args.alignRight} disableExpand={args.disableExpand}>
+  <AvatarStack
+    size={parseSizeFromArgs(args)}
+    alignRight={args.alignRight}
+    disableExpand={args.disableExpand}
+    variant={args.variant}
+    shape={args.shape}
+  >
     <Avatar alt="Primer logo" src="https://avatars.githubusercontent.com/primer" />
     <Avatar alt="GitHub logo" src="https://avatars.githubusercontent.com/github" />
     <Avatar alt="Atom logo" src="https://avatars.githubusercontent.com/atom" />