@sakaniui/react 0.8.10 → 0.8.12

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
-  "schemaVersion": 4,
+  "schemaVersion": 6,
   "name": "@sakaniui/react",
-  "version": "0.8.10",
+  "version": "0.8.12",
   "description": "Machine-readable contract of the SakaniUI React library, generated from its TypeScript source.",
   "docs": "https://www.sakaniui.com",
   "guide": "https://www.sakaniui.com/llms-full.txt",
@@ -23,12 +23,13 @@
     "@sakaniui/react/icons": "Tabler icons: IconName and IconNameFilled, one module each (5184 outline, 1054 filled)."
   },
   "conventions": {
-    "version": "This manifest describes @sakaniui/react@0.8.10. Each component has `since`, the first release that contained it; a prop added later has its own `since`, and a value added later is listed in the prop's `valuesSince`. If the project has an older version installed, anything newer than that does not exist there.",
+    "version": "This manifest describes @sakaniui/react@0.8.12. Each component has `since`, the first release that contained it; a prop added later has its own `since`, and a value added later is listed in the prop's `valuesSince`. If the project has an older version installed, anything newer than that does not exist there.",
     "acceptsNativeProps": "Components forward native HTML attributes (className, style, aria-*, event handlers) to their root element unless a prop says otherwise; only the props that are specific to SakaniUI are listed here.",
     "accessibleName": "When `contract.requiresAccessibleName` is true, a required prop (aria-label, aria-labelledby or an alt text) is the only thing that names the control or image. Do not omit it.",
     "tokens": "Use only the token names listed under `tokens`. Colour tokens follow the theme (the `.dark` class flips them); do not hard-code colours.",
     "icons": "Icon props take the component itself (IconSettings), not an element (<IconSettings />). Only names in icon-index.json exist; search them (MCP: search_icons) instead of guessing.",
     "examples": "Each component has `example`: its imports and the element with every required prop filled in, type-checked against this build. Start from it.",
+    "shapes": "A prop with a `shape` takes an object (collection \"object\") or an array of objects (collection \"array\") with exactly those fields; `required` fields must be present. In a generic shape (`typeParameters: [\"T\"]`) T is the type of your own data: `key: keyof T & string` means the key must be a field of your row type. `recipes` hold patterns the types alone do not teach.",
     "literals": "Prop `values` keep their real type: a number is a number (columns: 2), a string is a string (\"md\")."
   },
   "nativeAttributes": [
@@ -480,7 +481,14 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Accordion } from '@sakaniui/react';\n\n<Accordion>Label</Accordion>"
+      "example": "import { Accordion } from '@sakaniui/react';\n\n<Accordion>Label</Accordion>",
+      "aliases": [
+        "collapse",
+        "collapsible",
+        "expandable",
+        "disclosure",
+        "expand collapse"
+      ]
     },
     {
       "name": "AccordionItem",
@@ -532,7 +540,52 @@
         {
           "name": "items",
           "type": "ActivityFeedItem[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "ActivityFeedItem",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string | number",
+                "required": false
+              },
+              {
+                "name": "actor",
+                "type": "string",
+                "required": true,
+                "description": "Who performed the action — rendered in fg/default, the rest in fg/muted."
+              },
+              {
+                "name": "description",
+                "type": "ReactNode",
+                "required": true,
+                "description": "Rest of the sentence, e.g. \"commented on Design Review\". Wrap the object/target span in `ActivityFeedHighlight` to color it fg/default."
+              },
+              {
+                "name": "timestamp",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "icon",
+                "type": "ReactNode",
+                "required": false,
+                "description": "Rail dot icon (variant=\"default\"). Rendered at 16px, colored fg/muted."
+              },
+              {
+                "name": "avatarSrc",
+                "type": "string",
+                "required": false,
+                "description": "Avatar image (variant=\"compact\")."
+              },
+              {
+                "name": "avatarAlt",
+                "type": "string",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "variant",
@@ -620,7 +673,15 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Alert } from '@sakaniui/react';\n\n<Alert />"
+      "example": "import { Alert } from '@sakaniui/react';\n\n<Alert />",
+      "aliases": [
+        "callout",
+        "notice",
+        "inline message",
+        "inline alert",
+        "status message",
+        "message box"
+      ]
     },
     {
       "name": "Announcement",
@@ -679,7 +740,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Announcement } from '@sakaniui/react';\n\n<Announcement message=\"Message\" />"
+      "example": "import { Announcement } from '@sakaniui/react';\n\n<Announcement message=\"Message\" />",
+      "aliases": [
+        "banner",
+        "announcement bar",
+        "top banner",
+        "promo bar"
+      ]
     },
     {
       "name": "AreaChart",
@@ -691,7 +758,29 @@
         {
           "name": "data",
           "type": "AreaChartDatum[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "AreaChartDatum",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "value",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "value2",
+                "type": "number",
+                "required": false,
+                "description": "Renders a second area, stacked on top of `value` when `variant=\"stacked\"`."
+              }
+            ]
+          }
         },
         {
           "name": "variant",
@@ -799,7 +888,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Avatar } from '@sakaniui/react';\n\n<Avatar />"
+      "example": "import { Avatar } from '@sakaniui/react';\n\n<Avatar />",
+      "aliases": [
+        "profile picture",
+        "user avatar",
+        "profile image"
+      ]
     },
     {
       "name": "AvatarGroup",
@@ -832,7 +926,28 @@
           "name": "avatars",
           "type": "{ src?: string | undefined; initials?: string | undefined; alt?: string | undefined; }[]",
           "required": true,
-          "description": "Avatar definitions."
+          "description": "Avatar definitions.",
+          "shape": {
+            "type": "{ src?: string | undefined; initials?: string | undefined; alt?: string | undefined; }",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "src",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "initials",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "alt",
+                "type": "string",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "className",
@@ -975,7 +1090,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Badge } from '@sakaniui/react';\n\n<Badge>Label</Badge>"
+      "example": "import { Badge } from '@sakaniui/react';\n\n<Badge>Label</Badge>",
+      "aliases": [
+        "pill",
+        "status pill",
+        "status badge",
+        "lozenge"
+      ]
     },
     {
       "name": "Balance",
@@ -998,7 +1119,30 @@
         {
           "name": "change",
           "type": "BalanceChangeInfo",
-          "required": false
+          "required": false,
+          "shape": {
+            "type": "BalanceChangeInfo",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "value",
+                "type": "string",
+                "required": true,
+                "description": "e.g. \"+$1,240.50\" -- sign/formatting is the caller's responsibility."
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": false,
+                "description": "Defaults to \"this month\"."
+              },
+              {
+                "name": "direction",
+                "type": "\"up\" | \"down\"",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "progress",
@@ -1042,7 +1186,28 @@
         {
           "name": "data",
           "type": "BarChartDatum[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "BarChartDatum",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "value",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "value2",
+                "type": "number",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "variant",
@@ -1108,7 +1273,34 @@
           "name": "author",
           "type": "BlogBlockquoteAuthor",
           "required": false,
-          "description": "Presence switches to the card + quote-mark-glyphs + attribution-row treatment."
+          "description": "Presence switches to the card + quote-mark-glyphs + attribution-row treatment.",
+          "shape": {
+            "type": "BlogBlockquoteAuthor",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "name",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "role",
+                "type": "string",
+                "required": true,
+                "description": "e.g. \"Founder at Loopline\" -- rendered after the name as \", {role}\"."
+              },
+              {
+                "name": "avatarSrc",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "avatarAlt",
+                "type": "string",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "className",
@@ -1252,7 +1444,34 @@
         {
           "name": "author",
           "type": "BlogListingCardAuthor",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "BlogListingCardAuthor",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "name",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "date",
+                "type": "string",
+                "required": true,
+                "description": "e.g. \"Aug 12, 2026\" -- rendered after the name as \" · {date}\"."
+              },
+              {
+                "name": "avatarSrc",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "avatarAlt",
+                "type": "string",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "layout",
@@ -1320,7 +1539,39 @@
         {
           "name": "author",
           "type": "BlogListingFeaturedCardAuthor",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "BlogListingFeaturedCardAuthor",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "name",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "date",
+                "type": "string",
+                "required": true,
+                "description": "e.g. \"Aug 12, 2026\" -- rendered after the name as \" · {date}\"."
+              },
+              {
+                "name": "avatarSrc",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "avatarAlt",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "initials",
+                "type": "string",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "ctaLabel",
@@ -1536,7 +1787,23 @@
         {
           "name": "items",
           "type": "BreadcrumbItem[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "BreadcrumbItem",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "href",
+                "type": "string",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "variant",
@@ -1561,7 +1828,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Breadcrumb } from '@sakaniui/react';\n\n<Breadcrumb items={[{ label: \"Label\" }]} />"
+      "example": "import { Breadcrumb } from '@sakaniui/react';\n\n<Breadcrumb items={[{ label: \"Label\" }]} />",
+      "aliases": [
+        "breadcrumbs",
+        "bread crumbs",
+        "path trail"
+      ]
     },
     {
       "name": "Button",
@@ -1664,7 +1936,23 @@
           "name": "range",
           "type": "DateRange",
           "required": false,
-          "description": "Selected range (range mode)."
+          "description": "Selected range (range mode).",
+          "shape": {
+            "type": "DateRange",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "from",
+                "type": "Date",
+                "required": false
+              },
+              {
+                "name": "to",
+                "type": "Date",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "onRangeChange",
@@ -1708,7 +1996,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Calendar } from '@sakaniui/react';\n\n<Calendar />"
+      "example": "import { Calendar } from '@sakaniui/react';\n\n<Calendar />",
+      "aliases": [
+        "date picker",
+        "datepicker",
+        "date selector",
+        "calendar picker"
+      ]
     },
     {
       "name": "Card",
@@ -1946,7 +2240,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { ChatComposer } from '@sakaniui/react';\n\n<ChatComposer />"
+      "example": "import { ChatComposer } from '@sakaniui/react';\n\n<ChatComposer />",
+      "aliases": [
+        "message input",
+        "chat input",
+        "message box",
+        "composer"
+      ]
     },
     {
       "name": "Checkbox",
@@ -1977,7 +2277,10 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Checkbox } from '@sakaniui/react';\n\n<Checkbox />"
+      "example": "import { Checkbox } from '@sakaniui/react';\n\n<Checkbox />",
+      "aliases": [
+        "tickbox"
+      ]
     },
     {
       "name": "CheckoutSteps",
@@ -2068,7 +2371,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { CodeSnippet } from '@sakaniui/react';\n\n<CodeSnippet code=\"Code\" />"
+      "example": "import { CodeSnippet } from '@sakaniui/react';\n\n<CodeSnippet code=\"Code\" />",
+      "aliases": [
+        "code block",
+        "code sample",
+        "code viewer"
+      ]
     },
     {
       "name": "ColorSwatch",
@@ -2133,7 +2441,33 @@
         {
           "name": "options",
           "type": "ComboboxOption[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "ComboboxOption",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "value",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "icon",
+                "type": "ReactNode",
+                "required": false
+              },
+              {
+                "name": "disabled",
+                "type": "boolean",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "mode",
@@ -2211,7 +2545,15 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Combobox } from '@sakaniui/react';\n\n<Combobox options={[{ value: \"Value\", label: \"Label\" }]} />"
+      "example": "import { Combobox } from '@sakaniui/react';\n\n<Combobox options={[{ value: \"Value\", label: \"Label\" }]} />",
+      "aliases": [
+        "autocomplete",
+        "typeahead",
+        "searchable select",
+        "multi select",
+        "multiselect",
+        "tag input"
+      ]
     },
     {
       "name": "ConversationItem",
@@ -2318,7 +2660,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Divider } from '@sakaniui/react';\n\n<Divider />"
+      "example": "import { Divider } from '@sakaniui/react';\n\n<Divider />",
+      "aliases": [
+        "separator",
+        "horizontal rule",
+        "hr",
+        "rule"
+      ]
     },
     {
       "name": "DonutChart",
@@ -2330,7 +2678,23 @@
         {
           "name": "data",
           "type": "DonutDatum[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "DonutDatum",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "value",
+                "type": "number",
+                "required": true
+              }
+            ]
+          }
         },
         {
           "name": "size",
@@ -2431,7 +2795,14 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { EmptyState } from '@sakaniui/react';\n\n<EmptyState />"
+      "example": "import { EmptyState } from '@sakaniui/react';\n\n<EmptyState />",
+      "aliases": [
+        "no data",
+        "blank state",
+        "zero state",
+        "empty view",
+        "no results"
+      ]
     },
     {
       "name": "Expenses",
@@ -2443,7 +2814,34 @@
         {
           "name": "categories",
           "type": "ExpenseCategory[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "ExpenseCategory",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string | number",
+                "required": false
+              },
+              {
+                "name": "icon",
+                "type": "ReactNode",
+                "required": true
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "amount",
+                "type": "number",
+                "required": true,
+                "description": "Raw amount -- formatted for display via `formatAmount`."
+              }
+            ]
+          }
         },
         {
           "name": "variant",
@@ -2590,7 +2988,15 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { FileUpload } from '@sakaniui/react';\n\n<FileUpload />"
+      "example": "import { FileUpload } from '@sakaniui/react';\n\n<FileUpload />",
+      "aliases": [
+        "file picker",
+        "dropzone",
+        "drop zone",
+        "file input",
+        "uploader",
+        "upload area"
+      ]
     },
     {
       "name": "FilterChip",
@@ -2661,18 +3067,71 @@
         {
           "name": "primaryCta",
           "type": "FirstPageHeadingCta",
-          "required": false
+          "required": false,
+          "shape": {
+            "type": "FirstPageHeadingCta",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "onClick",
+                "type": "(() => void)",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "secondaryCta",
           "type": "FirstPageHeadingCta",
-          "required": false
+          "required": false,
+          "shape": {
+            "type": "FirstPageHeadingCta",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "onClick",
+                "type": "(() => void)",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "avatars",
           "type": "{ src?: string; initials?: string; alt?: string | undefined; }[] | undefined",
           "required": false,
-          "description": "Presence (non-empty) renders the overlapping avatar stack."
+          "description": "Presence (non-empty) renders the overlapping avatar stack.",
+          "shape": {
+            "type": "{ src?: string | undefined; initials?: string | undefined; alt?: string | undefined; }",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "src",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "initials",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "alt",
+                "type": "string",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "avatarsCaption",
@@ -2715,7 +3174,23 @@
         {
           "name": "data",
           "type": "FunnelDatum[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "FunnelDatum",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "value",
+                "type": "number",
+                "required": true
+              }
+            ]
+          }
         },
         {
           "name": "size",
@@ -2887,7 +3362,13 @@
         "requiresAccessibleName": true
       },
       "since": "0.1.0",
-      "example": "import { IconButton } from '@sakaniui/react';\nimport { IconStar } from '@sakaniui/react/icons';\n\n<IconButton icon={IconStar} aria-label=\"Describe the action\" />"
+      "example": "import { IconButton } from '@sakaniui/react';\nimport { IconStar } from '@sakaniui/react/icons';\n\n<IconButton icon={IconStar} aria-label=\"Describe the action\" />",
+      "aliases": [
+        "icon only button",
+        "icon-only button",
+        "icon btn",
+        "round button"
+      ]
     },
     {
       "name": "InlineHint",
@@ -2982,7 +3463,14 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Input } from '@sakaniui/react';\n\n<Input />"
+      "example": "import { Input } from '@sakaniui/react';\n\n<Input />",
+      "aliases": [
+        "text field",
+        "textfield",
+        "text input",
+        "input field",
+        "form field"
+      ]
     },
     {
       "name": "InstagramIcon",
@@ -3106,7 +3594,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Kbd } from '@sakaniui/react';\n\n<Kbd>Label</Kbd>"
+      "example": "import { Kbd } from '@sakaniui/react';\n\n<Kbd>Label</Kbd>",
+      "aliases": [
+        "keyboard shortcut",
+        "key cap",
+        "keycap",
+        "shortcut key"
+      ]
     },
     {
       "name": "Label",
@@ -3236,7 +3730,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Link } from '@sakaniui/react';\n\n<Link>Label</Link>"
+      "example": "import { Link } from '@sakaniui/react';\n\n<Link>Label</Link>",
+      "aliases": [
+        "anchor",
+        "hyperlink",
+        "text link"
+      ]
     },
     {
       "name": "LinkedinIcon",
@@ -3587,7 +4086,14 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Menu } from '@sakaniui/react';\n\n<Menu>Label</Menu>"
+      "example": "import { Menu } from '@sakaniui/react';\n\n<Menu>Label</Menu>",
+      "aliases": [
+        "dropdown",
+        "dropdown menu",
+        "context menu",
+        "actions menu",
+        "kebab menu"
+      ]
     },
     {
       "name": "MenuDivider",
@@ -3744,7 +4250,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { MessageBubble } from '@sakaniui/react';\n\n<MessageBubble />"
+      "example": "import { MessageBubble } from '@sakaniui/react';\n\n<MessageBubble />",
+      "aliases": [
+        "chat bubble",
+        "chat message",
+        "message"
+      ]
     },
     {
       "name": "Metric",
@@ -3800,7 +4311,28 @@
         {
           "name": "links",
           "type": "MobileNavLink[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "MobileNavLink",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "href",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "onClick",
+                "type": "(() => void)",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "ctaLabel",
@@ -3844,7 +4376,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { MobileNavigationMenu } from '@sakaniui/react';\n\n<MobileNavigationMenu label=\"Label\" links={[{ label: \"Label\" }]} />"
+      "example": "import { MobileNavigationMenu } from '@sakaniui/react';\n\n<MobileNavigationMenu label=\"Label\" links={[{ label: \"Label\" }]} />",
+      "aliases": [
+        "mobile nav",
+        "mobile menu",
+        "hamburger menu",
+        "burger menu"
+      ]
     },
     {
       "name": "Modal",
@@ -3972,7 +4510,18 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Modal } from '@sakaniui/react';\n\n<Modal open={true} onClose={() => {}} title=\"Title\" />"
+      "example": "import { Modal } from '@sakaniui/react';\n\n<Modal open={true} onClose={() => {}} title=\"Title\" />",
+      "aliases": [
+        "dialog",
+        "alert dialog",
+        "alertdialog",
+        "confirm dialog",
+        "confirmation dialog",
+        "confirmation",
+        "modal window",
+        "popup dialog",
+        "lightbox"
+      ]
     },
     {
       "name": "NotificationItem",
@@ -4093,7 +4642,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Pagination } from '@sakaniui/react';\n\n<Pagination total={49} page={1} onPageChange={() => {}} />"
+      "example": "import { Pagination } from '@sakaniui/react';\n\n<Pagination total={49} page={1} onPageChange={() => {}} />",
+      "aliases": [
+        "pager",
+        "paginator",
+        "page numbers"
+      ]
     },
     {
       "name": "PieChart",
@@ -4105,7 +4659,23 @@
         {
           "name": "data",
           "type": "PieDatum[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "PieDatum",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "value",
+                "type": "number",
+                "required": true
+              }
+            ]
+          }
         },
         {
           "name": "variant",
@@ -4260,7 +4830,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Popover } from '@sakaniui/react';\n\n<Popover trigger=\"Trigger\" />"
+      "example": "import { Popover } from '@sakaniui/react';\n\n<Popover trigger=\"Trigger\" />",
+      "aliases": [
+        "popup",
+        "flyout",
+        "floating panel",
+        "popup panel"
+      ]
     },
     {
       "name": "PriceDisplay",
@@ -4359,7 +4935,47 @@
           "name": "colors",
           "type": "ProductCardColor[]",
           "required": false,
-          "default": "[]"
+          "default": "[]",
+          "shape": {
+            "type": "ProductCardColor",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": false,
+                "description": "Unique key for selection -- defaults to `label` if omitted."
+              },
+              {
+                "name": "selected",
+                "type": "boolean",
+                "required": false
+              },
+              {
+                "name": "className",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "color",
+                "type": "string",
+                "required": true,
+                "description": "CSS color value for the swatch fill."
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": true,
+                "description": "Accessible name, e.g. \"Navy\"."
+              },
+              {
+                "name": "available",
+                "type": "boolean",
+                "required": false,
+                "description": "Defaults to true. False renders a disabled, unclickable swatch."
+              }
+            ]
+          }
         },
         {
           "name": "onColorSelect",
@@ -4426,7 +5042,23 @@
         {
           "name": "images",
           "type": "ProductGalleryImage[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "ProductGalleryImage",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "src",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "alt",
+                "type": "string",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "thumbsPosition",
@@ -4507,7 +5139,34 @@
           "name": "socialLinks",
           "type": "ProfileCardSocialLink[]",
           "required": false,
-          "default": "[]"
+          "default": "[]",
+          "shape": {
+            "type": "ProfileCardSocialLink",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "icon",
+                "type": "ReactNode",
+                "required": true
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": true,
+                "description": "Accessible name, e.g. \"X (Twitter)\"."
+              },
+              {
+                "name": "href",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "onClick",
+                "type": "(() => void)",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "className",
@@ -4567,7 +5226,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Progress } from '@sakaniui/react';\n\n<Progress />"
+      "example": "import { Progress } from '@sakaniui/react';\n\n<Progress />",
+      "aliases": [
+        "progress bar",
+        "progressbar",
+        "meter",
+        "loading bar"
+      ]
     },
     {
       "name": "ProgressItem",
@@ -4732,7 +5397,29 @@
         {
           "name": "data",
           "type": "RadarDatum[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "RadarDatum",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "value",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "value2",
+                "type": "number",
+                "required": false,
+                "description": "Second series (variant=\"multiple\")."
+              }
+            ]
+          }
         },
         {
           "name": "variant",
@@ -4797,7 +5484,28 @@
         {
           "name": "data",
           "type": "RadialDatum[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "RadialDatum",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "value",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "max",
+                "type": "number",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "variant",
@@ -4875,7 +5583,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Radio } from '@sakaniui/react';\n\n<Radio />"
+      "example": "import { Radio } from '@sakaniui/react';\n\n<Radio />",
+      "aliases": [
+        "radio button",
+        "radio group",
+        "radio input"
+      ]
     },
     {
       "name": "RichSeparator",
@@ -5030,7 +5743,23 @@
         {
           "name": "options",
           "type": "SegmentedOption[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "SegmentedOption",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "value",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              }
+            ]
+          }
         },
         {
           "name": "value",
@@ -5110,7 +5839,28 @@
         {
           "name": "options",
           "type": "SelectOption[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "SelectOption",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "value",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "disabled",
+                "type": "boolean",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "value",
@@ -5152,7 +5902,14 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Select } from '@sakaniui/react';\n\n<Select options={[{ label: \"Label\", value: \"Value\" }]} />"
+      "example": "import { Select } from '@sakaniui/react';\n\n<Select options={[{ label: \"Label\", value: \"Value\" }]} />",
+      "aliases": [
+        "select box",
+        "selectbox",
+        "dropdown select",
+        "picker",
+        "dropdown list"
+      ]
     },
     {
       "name": "Sidebar",
@@ -5178,7 +5935,14 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Sidebar } from '@sakaniui/react';\n\n<Sidebar>Label</Sidebar>"
+      "example": "import { Sidebar } from '@sakaniui/react';\n\n<Sidebar>Label</Sidebar>",
+      "aliases": [
+        "side nav",
+        "sidenav",
+        "side navigation",
+        "left nav",
+        "navigation sidebar"
+      ]
     },
     {
       "name": "SidebarDivider",
@@ -5652,7 +6416,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Skeleton } from '@sakaniui/react';\n\n<Skeleton />"
+      "example": "import { Skeleton } from '@sakaniui/react';\n\n<Skeleton />",
+      "aliases": [
+        "shimmer",
+        "loading skeleton",
+        "content placeholder",
+        "skeleton loader"
+      ]
     },
     {
       "name": "Slider",
@@ -5690,7 +6460,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Slider } from '@sakaniui/react';\n\n<Slider />"
+      "example": "import { Slider } from '@sakaniui/react';\n\n<Slider />",
+      "aliases": [
+        "range",
+        "range slider",
+        "range input"
+      ]
     },
     {
       "name": "SpendingBalance",
@@ -5773,7 +6548,14 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Spinner } from '@sakaniui/react';\n\n<Spinner />"
+      "example": "import { Spinner } from '@sakaniui/react';\n\n<Spinner />",
+      "aliases": [
+        "loader",
+        "loading",
+        "loading spinner",
+        "activity indicator",
+        "busy indicator"
+      ]
     },
     {
       "name": "StarRating",
@@ -5830,7 +6612,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { StarRating } from '@sakaniui/react';\n\n<StarRating rating={4} />"
+      "example": "import { StarRating } from '@sakaniui/react';\n\n<StarRating rating={4} />",
+      "aliases": [
+        "rating",
+        "stars",
+        "review stars",
+        "star reviews"
+      ]
     },
     {
       "name": "StatCard",
@@ -5931,7 +6719,14 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { StatCard } from '@sakaniui/react';\n\n<StatCard title=\"Title\" value=\"Value\" />"
+      "example": "import { StatCard } from '@sakaniui/react';\n\n<StatCard title=\"Title\" value=\"Value\" />",
+      "aliases": [
+        "metric card",
+        "kpi",
+        "kpi card",
+        "stat tile",
+        "stats card"
+      ]
     },
     {
       "name": "Stepper",
@@ -5943,7 +6738,23 @@
         {
           "name": "steps",
           "type": "Step[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "Step",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "description",
+                "type": "string",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "current",
@@ -5976,7 +6787,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Stepper } from '@sakaniui/react';\n\n<Stepper steps={[{ label: \"Label\" }]} current={1} />"
+      "example": "import { Stepper } from '@sakaniui/react';\n\n<Stepper steps={[{ label: \"Label\" }]} current={1} />",
+      "aliases": [
+        "wizard",
+        "step indicator",
+        "steps",
+        "multi step"
+      ]
     },
     {
       "name": "StepperStep",
@@ -6077,7 +6894,23 @@
         {
           "name": "change",
           "type": "StockMarketChange",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "StockMarketChange",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "amount",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "percent",
+                "type": "number",
+                "required": true
+              }
+            ]
+          }
         },
         {
           "name": "formatAmount",
@@ -6088,7 +6921,28 @@
           "name": "chart",
           "type": "BarChartDatum[]",
           "required": false,
-          "description": "Presence switches to the expanded Full card with a bar chart."
+          "description": "Presence switches to the expanded Full card with a bar chart.",
+          "shape": {
+            "type": "BarChartDatum",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "value",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "value2",
+                "type": "number",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "periodLabel",
@@ -6253,7 +7107,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Switch } from '@sakaniui/react';\n\n<Switch />"
+      "example": "import { Switch } from '@sakaniui/react';\n\n<Switch />",
+      "aliases": [
+        "toggle",
+        "toggle switch",
+        "on off switch"
+      ]
     },
     {
       "name": "Table",
@@ -6265,7 +7124,41 @@
         {
           "name": "columns",
           "type": "TableColumn<T>[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "TableColumn<T>",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "key",
+                "type": "keyof T & string",
+                "required": true
+              },
+              {
+                "name": "header",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "render",
+                "type": "((row: T) => ReactNode)",
+                "required": false
+              },
+              {
+                "name": "align",
+                "type": "\"left\" | \"center\" | \"right\"",
+                "required": false
+              },
+              {
+                "name": "width",
+                "type": "string",
+                "required": false
+              }
+            ],
+            "typeParameters": [
+              "T"
+            ]
+          }
         },
         {
           "name": "rows",
@@ -6336,7 +7229,21 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Table } from '@sakaniui/react';\n\n<Table columns={[]} rows={[{}]} />"
+      "example": "import { Table } from '@sakaniui/react';\n\n<Table columns={[]} rows={[{}]} />",
+      "recipes": [
+        {
+          "title": "A column that is not data (a delete button, a menu)",
+          "description": "Every column `key` must be a field of the row type (`keyof T & string`), so a button column needs a key too. Give the row type an optional `never` field for it and render the control; do not invent a key that is not on the row type, it will not compile.",
+          "code": "import { Table, IconButton, type TableColumn } from '@sakaniui/react';\nimport { IconTrash } from '@sakaniui/react/icons';\n\ntype Row = { id: number; name: string; actions?: never };\n\nconst rows: Row[] = [{ id: 1, name: 'Olivia Carter' }];\n\nconst columns: TableColumn<Row>[] = [\n  { key: 'name', header: 'Customer' },\n  {\n    key: 'actions',\n    header: '',\n    align: 'right',\n    render: (row) => <IconButton icon={IconTrash} variant=\"destructive\" size=\"sm\" aria-label={`Delete ${row.name}`} />,\n  },\n];\n\nexport const Example = () => <Table columns={columns} rows={rows} />;"
+        }
+      ],
+      "aliases": [
+        "datagrid",
+        "data grid",
+        "data table",
+        "grid",
+        "list view"
+      ]
     },
     {
       "name": "Tabs",
@@ -6348,7 +7255,35 @@
         {
           "name": "items",
           "type": "TabItem[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "TabItem",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "value",
+                "type": "string",
+                "required": true,
+                "description": "Unique key/value for the tab."
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": true,
+                "description": "Visible label."
+              },
+              {
+                "name": "icon",
+                "type": "IconComponent",
+                "required": false
+              },
+              {
+                "name": "disabled",
+                "type": "boolean",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "value",
@@ -6394,7 +7329,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Tabs } from '@sakaniui/react';\n\n<Tabs items={[{ value: \"Value\", label: \"Label\" }]} />"
+      "example": "import { Tabs } from '@sakaniui/react';\n\n<Tabs items={[{ value: \"Value\", label: \"Label\" }]} />",
+      "aliases": [
+        "tab bar",
+        "tabbar",
+        "tab navigation",
+        "tabbed"
+      ]
     },
     {
       "name": "Tags",
@@ -6427,7 +7368,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Tags } from '@sakaniui/react';\n\n<Tags tags={[\"Tag\"]} />"
+      "example": "import { Tags } from '@sakaniui/react';\n\n<Tags tags={[\"Tag\"]} />",
+      "aliases": [
+        "tag list",
+        "chips",
+        "chip list",
+        "labels list"
+      ]
     },
     {
       "name": "TeamCard",
@@ -6481,7 +7428,34 @@
           "name": "socialLinks",
           "type": "TeamCardSocialLink[]",
           "required": false,
-          "default": "[]"
+          "default": "[]",
+          "shape": {
+            "type": "TeamCardSocialLink",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "icon",
+                "type": "ReactNode",
+                "required": true
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": true,
+                "description": "Accessible name, e.g. \"Instagram\"."
+              },
+              {
+                "name": "href",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "onClick",
+                "type": "(() => void)",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "className",
@@ -6529,7 +7503,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Textarea } from '@sakaniui/react';\n\n<Textarea />"
+      "example": "import { Textarea } from '@sakaniui/react';\n\n<Textarea />",
+      "aliases": [
+        "multiline input",
+        "multi line input",
+        "comment box"
+      ]
     },
     {
       "name": "Ticker",
@@ -6541,7 +7520,23 @@
         {
           "name": "items",
           "type": "TickerItem[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "TickerItem",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "symbol",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "changePercent",
+                "type": "number",
+                "required": true
+              }
+            ]
+          }
         },
         {
           "name": "speed",
@@ -6615,7 +7610,14 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Toast } from '@sakaniui/react';\n\n<Toast />"
+      "example": "import { Toast } from '@sakaniui/react';\n\n<Toast />",
+      "aliases": [
+        "snackbar",
+        "toaster",
+        "toast notification",
+        "flash message",
+        "transient notification"
+      ]
     },
     {
       "name": "Tooltip",
@@ -6671,7 +7673,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { Tooltip } from '@sakaniui/react';\n\n<Tooltip title=\"Title\">Label</Tooltip>"
+      "example": "import { Tooltip } from '@sakaniui/react';\n\n<Tooltip title=\"Title\">Label</Tooltip>",
+      "aliases": [
+        "hovercard",
+        "hover card",
+        "hint on hover"
+      ]
     },
     {
       "name": "TopBar",
@@ -6801,7 +7808,16 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { TopBar } from '@sakaniui/react';\n\n<TopBar />"
+      "example": "import { TopBar } from '@sakaniui/react';\n\n<TopBar />",
+      "aliases": [
+        "navbar",
+        "nav bar",
+        "app bar",
+        "appbar",
+        "top navigation",
+        "top nav",
+        "header bar"
+      ]
     },
     {
       "name": "TopBarMobile",
@@ -6877,7 +7893,39 @@
         {
           "name": "transactions",
           "type": "Transaction[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "Transaction",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string | number",
+                "required": false
+              },
+              {
+                "name": "name",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "category",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "amount",
+                "type": "number",
+                "required": true,
+                "description": "Positive = income (success), negative = expense (danger)."
+              },
+              {
+                "name": "icon",
+                "type": "ReactNode",
+                "required": true
+              }
+            ]
+          }
         },
         {
           "name": "formatAmount",
@@ -7083,7 +8131,23 @@
         {
           "name": "breadcrumbs",
           "type": "BreadcrumbItem[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "BreadcrumbItem",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "href",
+                "type": "string",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "title",
@@ -7099,7 +8163,34 @@
           "name": "actions",
           "type": "AppHeaderBlockAction[]",
           "required": false,
-          "default": "[]"
+          "default": "[]",
+          "shape": {
+            "type": "AppHeaderBlockAction",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "icon",
+                "type": "ReactNode",
+                "required": false
+              },
+              {
+                "name": "onClick",
+                "type": "(() => void)",
+                "required": false
+              },
+              {
+                "name": "variant",
+                "type": "ButtonVariant",
+                "required": false,
+                "description": "Overrides the position-derived default (last action = primary, rest = secondary)."
+              }
+            ]
+          }
         },
         {
           "name": "className",
@@ -7132,7 +8223,28 @@
         {
           "name": "countries",
           "type": "SelectOption[]",
-          "required": false
+          "required": false,
+          "shape": {
+            "type": "SelectOption",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "value",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "disabled",
+                "type": "boolean",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "initialStatus",
@@ -7176,7 +8288,47 @@
           "name": "invoices",
           "type": "BillingHistoryInvoice[]",
           "required": false,
-          "default": "[]"
+          "default": "[]",
+          "shape": {
+            "type": "BillingHistoryInvoice",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": false,
+                "description": "Unique key for the list -- defaults to index if omitted."
+              },
+              {
+                "name": "planLabel",
+                "type": "string",
+                "required": true,
+                "description": "e.g. \"Pro plan — Monthly\""
+              },
+              {
+                "name": "date",
+                "type": "string",
+                "required": true,
+                "description": "e.g. \"Aug 1, 2026\""
+              },
+              {
+                "name": "amount",
+                "type": "string",
+                "required": true,
+                "description": "e.g. \"$29.00\""
+              },
+              {
+                "name": "status",
+                "type": "BillingHistoryStatus",
+                "required": true
+              },
+              {
+                "name": "onDownload",
+                "type": "(() => void)",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "loading",
@@ -7225,12 +8377,99 @@
         {
           "name": "featuredPost",
           "type": "BlogListingFeaturedPost",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "BlogListingFeaturedPost",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "image",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "imageAlt",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "title",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "excerpt",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "author",
+                "type": "BlogListingFeaturedCardAuthor",
+                "required": true
+              },
+              {
+                "name": "ctaLabel",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "onCtaClick",
+                "type": "(() => void)",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "posts",
           "type": "BlogListingPost[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "BlogListingPost",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "image",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "imageAlt",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "category",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "readTime",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "title",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "excerpt",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "author",
+                "type": "BlogListingCardAuthor",
+                "required": true
+              }
+            ]
+          }
         },
         {
           "name": "className",
@@ -7276,7 +8515,60 @@
         {
           "name": "jobs",
           "type": "CareersJob[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "CareersJob",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": false,
+                "description": "Unique key for the list -- defaults to `title` if omitted."
+              },
+              {
+                "name": "description",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "location",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "title",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "department",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "employmentType",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "locationStatus",
+                "type": "LocationDotStatus",
+                "required": false,
+                "description": "Drives LocationDot's color."
+              },
+              {
+                "name": "onApply",
+                "type": "(() => void)",
+                "required": false
+              },
+              {
+                "name": "applyLabel",
+                "type": "string",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "className",
@@ -7335,7 +8627,48 @@
         {
           "name": "items",
           "type": "CheckoutFlowItem[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "CheckoutFlowItem",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "image",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "imageAlt",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "name",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "variant",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "price",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "quantity",
+                "type": "number",
+                "required": true
+              }
+            ]
+          }
         },
         {
           "name": "shippingCost",
@@ -7376,7 +8709,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { CheckoutFlowBlock } from '@sakaniui/react/blocks';\n\n<CheckoutFlowBlock items={[{ image: \"/images/example.jpg\", name: \"Name\", price: 49, quantity: 1 }]} />"
+      "example": "import { CheckoutFlowBlock } from '@sakaniui/react/blocks';\n\n<CheckoutFlowBlock items={[{ image: \"/images/example.jpg\", name: \"Name\", price: 49, quantity: 1 }]} />",
+      "aliases": [
+        "checkout",
+        "checkout flow",
+        "checkout page"
+      ]
     },
     {
       "name": "CRMDashboardBlock",
@@ -7425,12 +8763,44 @@
         {
           "name": "primaryAction",
           "type": "CtaBannerAction",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "CtaBannerAction",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "onClick",
+                "type": "(() => void)",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "secondaryAction",
           "type": "CtaBannerAction",
-          "required": false
+          "required": false,
+          "shape": {
+            "type": "CtaBannerAction",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "onClick",
+                "type": "(() => void)",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "secondaryActionIcon",
@@ -7464,7 +8834,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { CtaBannerBlock } from '@sakaniui/react/blocks';\n\n<CtaBannerBlock title=\"Title\" description=\"Description\" primaryAction={{ label: \"Label\" }} />"
+      "example": "import { CtaBannerBlock } from '@sakaniui/react/blocks';\n\n<CtaBannerBlock title=\"Title\" description=\"Description\" primaryAction={{ label: \"Label\" }} />",
+      "aliases": [
+        "cta",
+        "cta banner",
+        "call to action",
+        "call to action banner"
+      ]
     },
     {
       "name": "CurrentPlanBlock",
@@ -7615,7 +8991,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { DataTableBlock } from '@sakaniui/react/blocks';\n\n<DataTableBlock />"
+      "example": "import { DataTableBlock } from '@sakaniui/react/blocks';\n\n<DataTableBlock />",
+      "aliases": [
+        "data table section",
+        "table section",
+        "records table"
+      ]
     },
     {
       "name": "EmailVerificationBlock",
@@ -7666,7 +9047,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { EmailVerificationBlock } from '@sakaniui/react/blocks';\n\n<EmailVerificationBlock />"
+      "example": "import { EmailVerificationBlock } from '@sakaniui/react/blocks';\n\n<EmailVerificationBlock />",
+      "aliases": [
+        "verify email",
+        "email verification",
+        "confirm email"
+      ]
     },
     {
       "name": "FaqBlock",
@@ -7689,7 +9075,29 @@
         {
           "name": "items",
           "type": "FaqItem[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "FaqItem",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "question",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "answer",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "defaultOpen",
+                "type": "boolean",
+                "required": false,
+                "description": "Uncontrolled initial open state for this item."
+              }
+            ]
+          }
         },
         {
           "name": "columns",
@@ -7715,7 +9123,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { FaqBlock } from '@sakaniui/react/blocks';\n\n<FaqBlock title=\"Title\" items={[{ question: \"Question\", answer: \"Answer\" }]} />"
+      "example": "import { FaqBlock } from '@sakaniui/react/blocks';\n\n<FaqBlock title=\"Title\" items={[{ question: \"Question\", answer: \"Answer\" }]} />",
+      "aliases": [
+        "faq",
+        "faqs",
+        "questions and answers",
+        "frequently asked questions"
+      ]
     },
     {
       "name": "FeatureGridBlock",
@@ -7727,7 +9141,33 @@
         {
           "name": "features",
           "type": "FeatureGridItem[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "FeatureGridItem",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "icon",
+                "type": "ReactNode",
+                "required": true
+              },
+              {
+                "name": "title",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "description",
+                "type": "string",
+                "required": true
+              }
+            ]
+          }
         },
         {
           "name": "columns",
@@ -7748,7 +9188,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { FeatureGridBlock } from '@sakaniui/react/blocks';\n\n<FeatureGridBlock features={[{ icon: \"Icon\", title: \"Title\", description: \"Description\" }]} />"
+      "example": "import { FeatureGridBlock } from '@sakaniui/react/blocks';\n\n<FeatureGridBlock features={[{ icon: \"Icon\", title: \"Title\", description: \"Description\" }]} />",
+      "aliases": [
+        "features",
+        "feature grid",
+        "features section"
+      ]
     },
     {
       "name": "FileUploadPanelBlock",
@@ -7834,7 +9279,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { ForgotPasswordBlock } from '@sakaniui/react/blocks';\n\n<ForgotPasswordBlock />"
+      "example": "import { ForgotPasswordBlock } from '@sakaniui/react/blocks';\n\n<ForgotPasswordBlock />",
+      "aliases": [
+        "forgot password",
+        "password reset request",
+        "lost password"
+      ]
     },
     {
       "name": "FormModalBlock",
@@ -7895,12 +9345,44 @@
         {
           "name": "primaryAction",
           "type": "HeroAction",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "HeroAction",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "onClick",
+                "type": "(() => void)",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "secondaryAction",
           "type": "HeroAction",
-          "required": false
+          "required": false,
+          "shape": {
+            "type": "HeroAction",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "onClick",
+                "type": "(() => void)",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "secondaryActionIcon",
@@ -7957,7 +9439,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { HeroBlock } from '@sakaniui/react/blocks';\n\n<HeroBlock title=\"Title\" description=\"Description\" primaryAction={{ label: \"Label\" }} image=\"/images/example.jpg\" />"
+      "example": "import { HeroBlock } from '@sakaniui/react/blocks';\n\n<HeroBlock title=\"Title\" description=\"Description\" primaryAction={{ label: \"Label\" }} image=\"/images/example.jpg\" />",
+      "aliases": [
+        "hero",
+        "hero section",
+        "landing hero",
+        "header section"
+      ]
     },
     {
       "name": "InlineCtaBlock",
@@ -8055,7 +9543,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { KanbanBoardBlock } from '@sakaniui/react/blocks';\n\n<KanbanBoardBlock />"
+      "example": "import { KanbanBoardBlock } from '@sakaniui/react/blocks';\n\n<KanbanBoardBlock />",
+      "aliases": [
+        "kanban",
+        "kanban board",
+        "task board",
+        "board view"
+      ]
     },
     {
       "name": "LiquidDashboardBlock",
@@ -8127,7 +9621,28 @@
           "name": "socialProviders",
           "type": "LoginSocialProvider[]",
           "required": false,
-          "default": "[]"
+          "default": "[]",
+          "shape": {
+            "type": "LoginSocialProvider",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "icon",
+                "type": "ReactNode",
+                "required": true
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "onClick",
+                "type": "(() => void)",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "onSubmit",
@@ -8155,7 +9670,14 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { LoginBlock } from '@sakaniui/react/blocks';\n\n<LoginBlock />"
+      "example": "import { LoginBlock } from '@sakaniui/react/blocks';\n\n<LoginBlock />",
+      "aliases": [
+        "login",
+        "login form",
+        "sign in",
+        "signin",
+        "sign in form"
+      ]
     },
     {
       "name": "LogoCloudBlock",
@@ -8196,7 +9718,13 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { LogoCloudBlock } from '@sakaniui/react/blocks';\n\n<LogoCloudBlock />"
+      "example": "import { LogoCloudBlock } from '@sakaniui/react/blocks';\n\n<LogoCloudBlock />",
+      "aliases": [
+        "logo cloud",
+        "logo wall",
+        "customer logos",
+        "trusted by"
+      ]
     },
     {
       "name": "MultistepModalBlock",
@@ -8248,7 +9776,38 @@
         {
           "name": "items",
           "type": "NotificationPanelItem[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "NotificationPanelItem",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "icon",
+                "type": "ReactNode",
+                "required": false
+              },
+              {
+                "name": "title",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "timestamp",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "read",
+                "type": "boolean",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "onMarkAllRead",
@@ -8286,7 +9845,24 @@
         {
           "name": "items",
           "type": "OnboardingProgressItem[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "OnboardingProgressItem",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "progress",
+                "type": "number",
+                "required": true,
+                "description": "0-100."
+              }
+            ]
+          }
         },
         {
           "name": "variant",
@@ -8328,7 +9904,43 @@
         {
           "name": "items",
           "type": "OrderConfirmationItem[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "OrderConfirmationItem",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "image",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "imageAlt",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "name",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "variant",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "price",
+                "type": "number",
+                "required": true
+              }
+            ]
+          }
         },
         {
           "name": "total",
@@ -8384,7 +9996,35 @@
           "name": "card",
           "type": "PaymentMethodCard",
           "required": false,
-          "description": "Omit to show the Empty state."
+          "description": "Omit to show the Empty state.",
+          "shape": {
+            "type": "PaymentMethodCard",
+            "collection": "object",
+            "fields": [
+              {
+                "name": "brand",
+                "type": "PaymentMethodBrand",
+                "required": true
+              },
+              {
+                "name": "last4",
+                "type": "string",
+                "required": true,
+                "description": "Last 4 digits, e.g. \"4242\"."
+              },
+              {
+                "name": "expiry",
+                "type": "string",
+                "required": true,
+                "description": "e.g. \"08/27\""
+              },
+              {
+                "name": "status",
+                "type": "PaymentMethodStatus",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "onUpdateCard",
@@ -8443,7 +10083,66 @@
         {
           "name": "plans",
           "type": "PricingPlan[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "PricingPlan",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "name",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "price",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "period",
+                "type": "string",
+                "required": false,
+                "description": "Omit for a plan with no numeric period, e.g. \"Custom\"."
+              },
+              {
+                "name": "description",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "ctaLabel",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "onCtaClick",
+                "type": "(() => void)",
+                "required": false
+              },
+              {
+                "name": "features",
+                "type": "string[]",
+                "required": true
+              },
+              {
+                "name": "highlighted",
+                "type": "boolean",
+                "required": false,
+                "description": "Drives the \"Most popular\" badge, accent border/shadow, and primary CTA."
+              },
+              {
+                "name": "badgeLabel",
+                "type": "string",
+                "required": false,
+                "description": "Defaults to \"Most popular\" when highlighted."
+              }
+            ]
+          }
         },
         {
           "name": "className",
@@ -8459,7 +10158,14 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { PricingTableBlock } from '@sakaniui/react/blocks';\n\n<PricingTableBlock title=\"Title\" plans={[{ name: \"Name\", price: \"Price\", description: \"Description\", ctaLabel: \"Cta label\", features: [\"Feature\"] }]} />"
+      "example": "import { PricingTableBlock } from '@sakaniui/react/blocks';\n\n<PricingTableBlock title=\"Title\" plans={[{ name: \"Name\", price: \"Price\", description: \"Description\", ctaLabel: \"Cta label\", features: [\"Feature\"] }]} />",
+      "aliases": [
+        "pricing",
+        "pricing table",
+        "pricing section",
+        "pricing plans",
+        "plans"
+      ]
     },
     {
       "name": "ProductDetailBlock",
@@ -8476,7 +10182,23 @@
         {
           "name": "images",
           "type": "ProductGalleryImage[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "ProductGalleryImage",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "src",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "alt",
+                "type": "string",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "rating",
@@ -8513,13 +10235,50 @@
           "name": "colors",
           "type": "ProductDetailColorOption[]",
           "required": false,
-          "default": "[]"
+          "default": "[]",
+          "shape": {
+            "type": "ProductDetailColorOption",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "color",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "available",
+                "type": "boolean",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "sizes",
           "type": "ProductDetailSizeOption[]",
           "required": false,
-          "default": "[]"
+          "default": "[]",
+          "shape": {
+            "type": "ProductDetailSizeOption",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "size",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "available",
+                "type": "boolean",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "defaultColor",
@@ -8605,7 +10364,105 @@
         {
           "name": "products",
           "type": "ProductGridItem[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "ProductGridItem",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": false,
+                "description": "Unique key for the grid -- defaults to `name` if omitted."
+              },
+              {
+                "name": "image",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "imageAlt",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "name",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "description",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "price",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "compareAtPrice",
+                "type": "number",
+                "required": false,
+                "description": "Presence switches to the sale badge + struck-original/danger-current price."
+              },
+              {
+                "name": "rating",
+                "type": "number",
+                "required": false
+              },
+              {
+                "name": "reviewCount",
+                "type": "number",
+                "required": false
+              },
+              {
+                "name": "colors",
+                "type": "ProductCardColor[]",
+                "required": false
+              },
+              {
+                "name": "onColorSelect",
+                "type": "((id: string) => void)",
+                "required": false
+              },
+              {
+                "name": "inStock",
+                "type": "boolean",
+                "required": false
+              },
+              {
+                "name": "wishlisted",
+                "type": "boolean",
+                "required": false
+              },
+              {
+                "name": "onWishlistToggle",
+                "type": "((wishlisted: boolean) => void)",
+                "required": false
+              },
+              {
+                "name": "onAddItem",
+                "type": "(() => void)",
+                "required": false
+              },
+              {
+                "name": "addItemLabel",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "formatPrice",
+                "type": "((amount: number) => string)",
+                "required": false
+              },
+              {
+                "name": "className",
+                "type": "string",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "showFilterBar",
@@ -8688,7 +10545,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.1.0",
-      "example": "import { ProfileSettingsBlock } from '@sakaniui/react/blocks';\n\n<ProfileSettingsBlock />"
+      "example": "import { ProfileSettingsBlock } from '@sakaniui/react/blocks';\n\n<ProfileSettingsBlock />",
+      "aliases": [
+        "profile settings",
+        "account settings",
+        "settings page"
+      ]
     },
     {
       "name": "ResetPasswordBlock",
@@ -8737,7 +10599,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { ResetPasswordBlock } from '@sakaniui/react/blocks';\n\n<ResetPasswordBlock />"
+      "example": "import { ResetPasswordBlock } from '@sakaniui/react/blocks';\n\n<ResetPasswordBlock />",
+      "aliases": [
+        "reset password",
+        "new password",
+        "change password"
+      ]
     },
     {
       "name": "SectionFooterBlock",
@@ -8755,7 +10622,23 @@
         {
           "name": "links",
           "type": "SectionFooterLink[]",
-          "required": false
+          "required": false,
+          "shape": {
+            "type": "SectionFooterLink",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "href",
+                "type": "string",
+                "required": true
+              }
+            ]
+          }
         },
         {
           "name": "variant",
@@ -8790,7 +10673,54 @@
         {
           "name": "items",
           "type": "ShoppingCartItemData[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "ShoppingCartItemData",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "image",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "imageAlt",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "name",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "variant",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "price",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "compareAtPrice",
+                "type": "number",
+                "required": false,
+                "description": "Presence switches that row to CartItem's own struck-original + danger-current sale treatment."
+              },
+              {
+                "name": "quantity",
+                "type": "number",
+                "required": true
+              }
+            ]
+          }
         },
         {
           "name": "shippingCost",
@@ -8826,7 +10756,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { ShoppingCartBlock } from '@sakaniui/react/blocks';\n\n<ShoppingCartBlock items={[{ image: \"/images/example.jpg\", name: \"Name\", price: 49, quantity: 1 }]} />"
+      "example": "import { ShoppingCartBlock } from '@sakaniui/react/blocks';\n\n<ShoppingCartBlock items={[{ image: \"/images/example.jpg\", name: \"Name\", price: 49, quantity: 1 }]} />",
+      "aliases": [
+        "cart",
+        "shopping cart",
+        "basket"
+      ]
     },
     {
       "name": "SignUpBlock",
@@ -8852,7 +10787,28 @@
           "name": "socialProviders",
           "type": "SignUpSocialProvider[]",
           "required": false,
-          "default": "[]"
+          "default": "[]",
+          "shape": {
+            "type": "SignUpSocialProvider",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "icon",
+                "type": "ReactNode",
+                "required": true
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "onClick",
+                "type": "(() => void)",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "onSubmit",
@@ -8875,7 +10831,14 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { SignUpBlock } from '@sakaniui/react/blocks';\n\n<SignUpBlock />"
+      "example": "import { SignUpBlock } from '@sakaniui/react/blocks';\n\n<SignUpBlock />",
+      "aliases": [
+        "signup",
+        "sign up",
+        "register",
+        "registration",
+        "create account"
+      ]
     },
     {
       "name": "TeamSectionBlock",
@@ -8904,7 +10867,60 @@
         {
           "name": "members",
           "type": "TeamSectionMember[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "TeamSectionMember",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": false,
+                "description": "Unique key for the grid -- defaults to `name` if omitted."
+              },
+              {
+                "name": "location",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "name",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "role",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "image",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "locationStatus",
+                "type": "LocationDotStatus",
+                "required": false
+              },
+              {
+                "name": "imageAlt",
+                "type": "string",
+                "required": false
+              },
+              {
+                "name": "bio",
+                "type": "string",
+                "required": false,
+                "description": "Presence switches to the \"Card details\" style (adds this paragraph below the meta row)."
+              },
+              {
+                "name": "socialLinks",
+                "type": "TeamCardSocialLink[]",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "className",
@@ -8920,7 +10936,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { TeamSectionBlock } from '@sakaniui/react/blocks';\n\n<TeamSectionBlock title=\"Title\" members={[{ name: \"Name\", role: \"Role\", location: \"Location\", image: \"/images/example.jpg\" }]} />"
+      "example": "import { TeamSectionBlock } from '@sakaniui/react/blocks';\n\n<TeamSectionBlock title=\"Title\" members={[{ name: \"Name\", role: \"Role\", location: \"Location\", image: \"/images/example.jpg\" }]} />",
+      "aliases": [
+        "team",
+        "team section",
+        "meet the team"
+      ]
     },
     {
       "name": "TestimonialBlock",
@@ -8932,7 +10953,33 @@
         {
           "name": "testimonials",
           "type": "Testimonial[]",
-          "required": true
+          "required": true,
+          "shape": {
+            "type": "Testimonial",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "quote",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "authorName",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "authorRole",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "authorAvatar",
+                "type": "string",
+                "required": false
+              }
+            ]
+          }
         },
         {
           "name": "className",
@@ -8947,7 +10994,12 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { TestimonialBlock } from '@sakaniui/react/blocks';\n\n<TestimonialBlock testimonials={[{ quote: \"Quote\", authorName: \"Author name\", authorRole: \"Author role\" }]} />"
+      "example": "import { TestimonialBlock } from '@sakaniui/react/blocks';\n\n<TestimonialBlock testimonials={[{ quote: \"Quote\", authorName: \"Author name\", authorRole: \"Author role\" }]} />",
+      "aliases": [
+        "testimonial",
+        "testimonials",
+        "customer quotes"
+      ]
     },
     {
       "name": "TwoFactorAuthBlock",
@@ -8992,7 +11044,15 @@
         "requiresAccessibleName": false
       },
       "since": "0.3.0",
-      "example": "import { TwoFactorAuthBlock } from '@sakaniui/react/blocks';\n\n<TwoFactorAuthBlock />"
+      "example": "import { TwoFactorAuthBlock } from '@sakaniui/react/blocks';\n\n<TwoFactorAuthBlock />",
+      "aliases": [
+        "2fa",
+        "two factor",
+        "two factor authentication",
+        "otp",
+        "mfa",
+        "verification code"
+      ]
     }
   ],
   "utilities": [