Skip to content

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

TypeScript

feat(cli): add exampleFor field to all block templates (#1966)

Cindy Zhang687bf352d713
diff --git a/apps/docsite/scripts/generate-data.mjs b/apps/docsite/scripts/generate-data.mjs
index fcf00bc61a..ba2ca5be39 100644
--- a/apps/docsite/scripts/generate-data.mjs
+++ b/apps/docsite/scripts/generate-data.mjs
@@ -320,10 +320,11 @@ async function generateBlockRegistry() {
const meta = readDocMeta(docPath);
const relCategory = path.relative(BLOCKS_DIR, path.dirname(docPath));
- // Read isShowcase, aspectRatio, componentsUsed from the doc file
+ // Read isShowcase, aspectRatio, componentsUsed, exampleFor from the doc file
let isShowcase = false;
let aspectRatio = 1;
let componentsUsed = [];
+ let exampleFor = '';
try {
const content = fs.readFileSync(docPath, 'utf-8');
isShowcase = /isShowcase:\s*true/.test(content);
@@ -338,12 +339,17 @@ async function generateBlockRegistry() {
if (cuMatch) {
componentsUsed = [...cuMatch[1].matchAll(/['"]([^'"]+)['"]/g)].map(m => m[1]);
}
+ const efMatch = content.match(/exampleFor:\s*['"]([^'"]+)['"]/);
+ if (efMatch) {
+ exampleFor = efMatch[1];
+ }
} catch { /* ignore */ }
blocks.push({
dirName: basename,
name: meta.name || basename,
description: meta.description,
+ exampleFor,
isShowcase,
aspectRatio,
componentsUsed,
@@ -361,6 +367,8 @@ export interface BlockEntry {
dirName: string;
name: string;
description: string;
+ /** The component this block is an example of (e.g. 'Button', 'Dialog') */
+ exampleFor: string;
isShowcase: boolean;
aspectRatio: number;
componentsUsed: string[];
diff --git a/apps/docsite/src/__tests__/data-extraction.test.ts b/apps/docsite/src/__tests__/data-extraction.test.ts
index f62710a0b7..a804c91fa0 100644
--- a/apps/docsite/src/__tests__/data-extraction.test.ts
+++ b/apps/docsite/src/__tests__/data-extraction.test.ts
@@ -242,6 +242,7 @@ describe('blockRegistry', () => {
expect(block.aspectRatio).not.toBeNaN();
expect(Array.isArray(block.componentsUsed)).toBe(true);
expect(block.category).toBeDefined();
+ expect(typeof block.exampleFor).toBe('string');
}
});
@@ -263,11 +264,29 @@ describe('blockRegistry', () => {
it('showcase for Button exists', () => {
const buttonShowcase = blocks.find(
- b => b.isShowcase && b.category.includes('Button'),
+ b => b.isShowcase && b.exampleFor === 'Button',
);
expect(buttonShowcase).toBeDefined();
});
+ it('every block has exampleFor set', () => {
+ const missing = blocks.filter(b => !b.exampleFor);
+ expect(missing.map(b => b.dirName)).toEqual([]);
+ });
+
+ it('showcase blocks have unique exampleFor (one showcase per component)', () => {
+ const showcases = blocks.filter(b => b.isShowcase);
+ const seen = new Map<string, string[]>();
+ for (const s of showcases) {
+ if (!seen.has(s.exampleFor)) seen.set(s.exampleFor, []);
+ seen.get(s.exampleFor)!.push(s.dirName);
+ }
+ const dupes = [...seen.entries()].filter(([, v]) => v.length > 1);
+ // Some components may legitimately have multiple showcases, but flag them
+ // so we're aware. Most should have exactly one.
+ expect(dupes.length).toBeLessThan(showcases.length * 0.1);
+ });
+
it('componentsUsed links blocks to components', () => {
const blocksWithComponents = blocks.filter(
b => b.componentsUsed.length > 0,
diff --git a/packages/cli/templates/blocks/components/AlertDialog/AlertDialogAsyncAction.doc.mjs b/packages/cli/templates/blocks/components/AlertDialog/AlertDialogAsyncAction.doc.mjs
index c2ac4d5288..0422b7611f 100644
--- a/packages/cli/templates/blocks/components/AlertDialog/AlertDialogAsyncAction.doc.mjs
+++ b/packages/cli/templates/blocks/components/AlertDialog/AlertDialogAsyncAction.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'AlertDialog',
name: 'AlertDialog — Loading',
description:
'A confirmation dialog that shows a spinner while the action runs.',
diff --git a/packages/cli/templates/blocks/components/AlertDialog/AlertDialogDeleteConfirmation.doc.mjs b/packages/cli/templates/blocks/components/AlertDialog/AlertDialogDeleteConfirmation.doc.mjs
index 36ac279076..727239b87f 100644
--- a/packages/cli/templates/blocks/components/AlertDialog/AlertDialogDeleteConfirmation.doc.mjs
+++ b/packages/cli/templates/blocks/components/AlertDialog/AlertDialogDeleteConfirmation.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'AlertDialog',
name: 'AlertDialog — Delete',
description:
'A delete button that asks the user to confirm before deleting.',
diff --git a/packages/cli/templates/blocks/components/AppShell/AppShellContentOnly.doc.mjs b/packages/cli/templates/blocks/components/AppShell/AppShellContentOnly.doc.mjs
index 353eba34ba..6c8cb75bb3 100644
--- a/packages/cli/templates/blocks/components/AppShell/AppShellContentOnly.doc.mjs
+++ b/packages/cli/templates/blocks/components/AppShell/AppShellContentOnly.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'AppShell',
name: 'AppShell — Content Only',
description:
'Minimal shell with no navigation, useful for full-bleed pages, auth screens, or embedded views.',
diff --git a/packages/cli/templates/blocks/components/AppShell/AppShellShowcase.doc.mjs b/packages/cli/templates/blocks/components/AppShell/AppShellShowcase.doc.mjs
index ecf4409b02..76a301d28e 100644
--- a/packages/cli/templates/blocks/components/AppShell/AppShellShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/AppShell/AppShellShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'AppShell',
name: 'AppShell',
isReady: true,
aspectRatio: 4 / 3,
diff --git a/packages/cli/templates/blocks/components/AppShell/AppShellSideNavOnly.doc.mjs b/packages/cli/templates/blocks/components/AppShell/AppShellSideNavOnly.doc.mjs
index 0297bfbd76..1469cc308a 100644
--- a/packages/cli/templates/blocks/components/AppShell/AppShellSideNavOnly.doc.mjs
+++ b/packages/cli/templates/blocks/components/AppShell/AppShellSideNavOnly.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'AppShell',
name: 'AppShell — Side Nav Only',
description:
'App shell with SideNav header providing app identity, no TopNav needed.',
diff --git a/packages/cli/templates/blocks/components/AppShell/AppShellTopNavOnly.doc.mjs b/packages/cli/templates/blocks/components/AppShell/AppShellTopNavOnly.doc.mjs
index e95e5e1dc6..91abe4f673 100644
--- a/packages/cli/templates/blocks/components/AppShell/AppShellTopNavOnly.doc.mjs
+++ b/packages/cli/templates/blocks/components/AppShell/AppShellTopNavOnly.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'AppShell',
name: 'AppShell — Top Nav Only',
description:
'Simple layout with TopNav and no side navigation, suitable for landing pages.',
diff --git a/packages/cli/templates/blocks/components/AppShell/AppShellTopNavWithSideNav.doc.mjs b/packages/cli/templates/blocks/components/AppShell/AppShellTopNavWithSideNav.doc.mjs
index 5442a9d1f9..371e33ecfc 100644
--- a/packages/cli/templates/blocks/components/AppShell/AppShellTopNavWithSideNav.doc.mjs
+++ b/packages/cli/templates/blocks/components/AppShell/AppShellTopNavWithSideNav.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'AppShell',
name: 'AppShell — Top Nav with Side Nav',
description:
'The most common layout with TopNav for app identity and SideNav for page-level navigation.',
diff --git a/packages/cli/templates/blocks/components/AppShell/AppShellWithBanner.doc.mjs b/packages/cli/templates/blocks/components/AppShell/AppShellWithBanner.doc.mjs
index 0f1b5be921..cd73d3d5d5 100644
--- a/packages/cli/templates/blocks/components/AppShell/AppShellWithBanner.doc.mjs
+++ b/packages/cli/templates/blocks/components/AppShell/AppShellWithBanner.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'AppShell',
name: 'AppShell — With Banner',
description:
'Full layout with TopNav, SideNav, and a dismissable info banner between the nav and content.',
diff --git a/packages/cli/templates/blocks/components/AspectRatio/AspectRatioImageGallery.doc.mjs b/packages/cli/templates/blocks/components/AspectRatio/AspectRatioImageGallery.doc.mjs
index c4241f61ae..7e7598fa3a 100644
--- a/packages/cli/templates/blocks/components/AspectRatio/AspectRatioImageGallery.doc.mjs
+++ b/packages/cli/templates/blocks/components/AspectRatio/AspectRatioImageGallery.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'AspectRatio',
name: 'AspectRatio — Image Gallery',
description: 'Grid of images with consistent 4:3 aspect ratios.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/AspectRatio/AspectRatioShowcase.doc.mjs b/packages/cli/templates/blocks/components/AspectRatio/AspectRatioShowcase.doc.mjs
index 703be982f6..e9d71f972e 100644
--- a/packages/cli/templates/blocks/components/AspectRatio/AspectRatioShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/AspectRatio/AspectRatioShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'AspectRatio',
name: 'AspectRatio',
isReady: true,
aspectRatio: 4 / 3,
diff --git a/packages/cli/templates/blocks/components/AspectRatio/AspectRatioSquareImage.doc.mjs b/packages/cli/templates/blocks/components/AspectRatio/AspectRatioSquareImage.doc.mjs
index cb5c081986..f292583660 100644
--- a/packages/cli/templates/blocks/components/AspectRatio/AspectRatioSquareImage.doc.mjs
+++ b/packages/cli/templates/blocks/components/AspectRatio/AspectRatioSquareImage.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'AspectRatio',
name: 'AspectRatio — Square Image',
description: '1:1 square aspect ratio, ideal for avatars and Instagram-style images.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/AspectRatio/AspectRatioWidescreen.doc.mjs b/packages/cli/templates/blocks/components/AspectRatio/AspectRatioWidescreen.doc.mjs
index 3886e8e616..c281017179 100644
--- a/packages/cli/templates/blocks/components/AspectRatio/AspectRatioWidescreen.doc.mjs
+++ b/packages/cli/templates/blocks/components/AspectRatio/AspectRatioWidescreen.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'AspectRatio',
name: 'AspectRatio — 16:9 Widescreen Image',
description: '16:9 widescreen aspect ratio wrapping an image.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/AspectRatio/AspectRatioWithSkeleton.doc.mjs b/packages/cli/templates/blocks/components/AspectRatio/AspectRatioWithSkeleton.doc.mjs
index eda536767d..4343531f7c 100644
--- a/packages/cli/templates/blocks/components/AspectRatio/AspectRatioWithSkeleton.doc.mjs
+++ b/packages/cli/templates/blocks/components/AspectRatio/AspectRatioWithSkeleton.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'AspectRatio',
name: 'AspectRatio — Loading Skeleton',
description: 'Aspect ratio container with a skeleton loading placeholder.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Avatar/AvatarFallbackChain.doc.mjs b/packages/cli/templates/blocks/components/Avatar/AvatarFallbackChain.doc.mjs
index 069ceadfb1..3576f1bffb 100644
--- a/packages/cli/templates/blocks/components/Avatar/AvatarFallbackChain.doc.mjs
+++ b/packages/cli/templates/blocks/components/Avatar/AvatarFallbackChain.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Avatar',
name: 'Avatar — Fallback Chain',
description:
'Demonstrates the avatar fallback chain: primary image, fallback image, initials, then default icon.',
diff --git a/packages/cli/templates/blocks/components/Avatar/AvatarGroup.doc.mjs b/packages/cli/templates/blocks/components/Avatar/AvatarGroup.doc.mjs
index 95c5e7e396..a984d10144 100644
--- a/packages/cli/templates/blocks/components/Avatar/AvatarGroup.doc.mjs
+++ b/packages/cli/templates/blocks/components/Avatar/AvatarGroup.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Avatar',
name: 'Avatar — Group',
description: 'Overlap multiple avatars in a row to represent a group of people. Use for team lists, PR reviewers, or participant counts where you want to show faces without taking up much space.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Avatar/AvatarInitialsFallback.doc.mjs b/packages/cli/templates/blocks/components/Avatar/AvatarInitialsFallback.doc.mjs
index 1ce132a246..128d12fc63 100644
--- a/packages/cli/templates/blocks/components/Avatar/AvatarInitialsFallback.doc.mjs
+++ b/packages/cli/templates/blocks/components/Avatar/AvatarInitialsFallback.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Avatar',
name: 'Avatar — Initials',
description: 'Show initials instead of a photo. The avatar extracts the first and last initials from the name automatically. Use when you only have a user name, like in anonymous accounts or new user onboarding.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Avatar/AvatarShowcase.doc.mjs b/packages/cli/templates/blocks/components/Avatar/AvatarShowcase.doc.mjs
index 62c570bcbc..f855006a33 100644
--- a/packages/cli/templates/blocks/components/Avatar/AvatarShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Avatar/AvatarShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Avatar',
name: 'Avatar',
description:
'Avatars at every size with an image, initials fallback, and a status dot. A quick visual reference for choosing the right size.',
diff --git a/packages/cli/templates/blocks/components/Avatar/AvatarUserCard.doc.mjs b/packages/cli/templates/blocks/components/Avatar/AvatarUserCard.doc.mjs
index 27cd3fe0a1..49b36134bb 100644
--- a/packages/cli/templates/blocks/components/Avatar/AvatarUserCard.doc.mjs
+++ b/packages/cli/templates/blocks/components/Avatar/AvatarUserCard.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Avatar',
name: 'Avatar — User Card',
description: 'Place an avatar next to a name and role to create a user card row. Use for comment headers, contact lists, profile sections, or anywhere you need to identify a person at a glance.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Avatar/AvatarWithImage.doc.mjs b/packages/cli/templates/blocks/components/Avatar/AvatarWithImage.doc.mjs
index fde77c9ed8..bf461af46a 100644
--- a/packages/cli/templates/blocks/components/Avatar/AvatarWithImage.doc.mjs
+++ b/packages/cli/templates/blocks/components/Avatar/AvatarWithImage.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Avatar',
name: 'Avatar — Photo',
description: 'Show a profile photo at different sizes. Use when you have a user photo URL. If the image fails to load, initials are shown instead.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Avatar/AvatarWithStatus.doc.mjs b/packages/cli/templates/blocks/components/Avatar/AvatarWithStatus.doc.mjs
index b72f0ab33f..a0beecefa6 100644
--- a/packages/cli/templates/blocks/components/Avatar/AvatarWithStatus.doc.mjs
+++ b/packages/cli/templates/blocks/components/Avatar/AvatarWithStatus.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Avatar',
name: 'Avatar — Status Dot',
description: 'Add a status dot to an avatar to show whether someone is online, away, or busy. Use in chat, messaging, or any UI where knowing availability matters.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.doc.mjs b/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.doc.mjs
index ee06618a95..e96909188c 100644
--- a/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'AvatarStatusDot',
name: 'AvatarStatusDot',
description:
'AvatarStatusDot renders a presence indicator on an Avatar, with variants for positive, neutral, and negative states. The dot size automatically coordinates with the Avatar size.',
diff --git a/packages/cli/templates/blocks/components/Badge/BadgeCategoryTags.doc.mjs b/packages/cli/templates/blocks/components/Badge/BadgeCategoryTags.doc.mjs
index e80c9704d6..f3fc6191c3 100644
--- a/packages/cli/templates/blocks/components/Badge/BadgeCategoryTags.doc.mjs
+++ b/packages/cli/templates/blocks/components/Badge/BadgeCategoryTags.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Badge',
name: 'Badge — Colors',
description: 'Tag items with color-coded categories like teams, priorities, or topics. Use the 9 non-semantic color variants when you need to distinguish groups visually.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Badge/BadgeCountBadges.doc.mjs b/packages/cli/templates/blocks/components/Badge/BadgeCountBadges.doc.mjs
index ed60377dc2..440f1a490b 100644
--- a/packages/cli/templates/blocks/components/Badge/BadgeCountBadges.doc.mjs
+++ b/packages/cli/templates/blocks/components/Badge/BadgeCountBadges.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Badge',
name: 'Badge — Counts',
description: 'Show a number inside a badge for notification counts, unread messages, or task totals. Use next to icons, nav items, or list labels.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Badge/BadgeShowcase.doc.mjs b/packages/cli/templates/blocks/components/Badge/BadgeShowcase.doc.mjs
index 22869bf531..3aa6b527bb 100644
--- a/packages/cli/templates/blocks/components/Badge/BadgeShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Badge/BadgeShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Badge',
name: 'Badge — Variants',
description:
'All semantic and color badge variants in a single view. Use semantic variants for status and color variants for categories.',
diff --git a/packages/cli/templates/blocks/components/Badge/BadgeStatusLabels.doc.mjs b/packages/cli/templates/blocks/components/Badge/BadgeStatusLabels.doc.mjs
index 7ac5f95d87..a067f99b3e 100644
--- a/packages/cli/templates/blocks/components/Badge/BadgeStatusLabels.doc.mjs
+++ b/packages/cli/templates/blocks/components/Badge/BadgeStatusLabels.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Badge',
name: 'Badge — Status',
description: 'Show the state of an item like Active, Pending, or Failed. Use in table rows, list items, or detail pages where users need to see status at a glance.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Banner/BannerCollapsibleContent.doc.mjs b/packages/cli/templates/blocks/components/Banner/BannerCollapsibleContent.doc.mjs
index be842c3ff4..e94d659826 100644
--- a/packages/cli/templates/blocks/components/Banner/BannerCollapsibleContent.doc.mjs
+++ b/packages/cli/templates/blocks/components/Banner/BannerCollapsibleContent.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Banner',
name: 'Banner — Collapsible',
description: 'Combine an action button, dismiss control, and expandable detail area in one banner. Use for complex notifications like config changes or deployment summaries.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Banner/BannerDismissable.doc.mjs b/packages/cli/templates/blocks/components/Banner/BannerDismissable.doc.mjs
index 0e8e553792..84a6fa4f84 100644
--- a/packages/cli/templates/blocks/components/Banner/BannerDismissable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Banner/BannerDismissable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Banner',
name: 'Banner — Dismiss',
description: 'Let the user close a banner after reading it. Use for maintenance notices, feature tips, or any non-critical message the user can acknowledge.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Banner/BannerSectionVariant.doc.mjs b/packages/cli/templates/blocks/components/Banner/BannerSectionVariant.doc.mjs
index 55d0092014..a052fa32bc 100644
--- a/packages/cli/templates/blocks/components/Banner/BannerSectionVariant.doc.mjs
+++ b/packages/cli/templates/blocks/components/Banner/BannerSectionVariant.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Banner',
name: 'Banner — Full Width',
description: 'A full-width banner with no border radius for page-level notifications. Use at the top of a page for site-wide announcements or maintenance alerts.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Banner/BannerShowcase.doc.mjs b/packages/cli/templates/blocks/components/Banner/BannerShowcase.doc.mjs
index eefe127b48..52550cb329 100644
--- a/packages/cli/templates/blocks/components/Banner/BannerShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Banner/BannerShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Banner',
name: 'Banner — Statuses',
description:
'All four status banners stacked — info, success, warning, and error. A quick visual reference for choosing the right status.',
diff --git a/packages/cli/templates/blocks/components/Banner/BannerStatuses.doc.mjs b/packages/cli/templates/blocks/components/Banner/BannerStatuses.doc.mjs
index 9b7598028f..b5dbbb31a9 100644
--- a/packages/cli/templates/blocks/components/Banner/BannerStatuses.doc.mjs
+++ b/packages/cli/templates/blocks/components/Banner/BannerStatuses.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Banner',
name: 'Banner — Statuses',
description: 'All 4 banner statuses: info, success, warning, and error. Use to show persistent messages like updates, confirmations, cautions, or problems at the top of a page or section.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Banner/BannerWithActionButton.doc.mjs b/packages/cli/templates/blocks/components/Banner/BannerWithActionButton.doc.mjs
index 1eea363628..8366e1c58a 100644
--- a/packages/cli/templates/blocks/components/Banner/BannerWithActionButton.doc.mjs
+++ b/packages/cli/templates/blocks/components/Banner/BannerWithActionButton.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Banner',
name: 'Banner — Action',
description: 'Add a button to a banner so the user can act on the message. Use for trial expirations, payment failures, or anything that needs a response.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.doc.mjs
index f3b0dccc1e..27c7b6b738 100644
--- a/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'BreadcrumbItem',
name: 'BreadcrumbItem',
description:
'BreadcrumbItem represents a single step in a breadcrumb trail, supporting links, icons, current-page markers, and custom link components.',
diff --git a/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsCustomSeparator.doc.mjs b/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsCustomSeparator.doc.mjs
index 88bd528bdc..cf40721b69 100644
--- a/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsCustomSeparator.doc.mjs
+++ b/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsCustomSeparator.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Breadcrumbs',
name: 'Breadcrumbs — Separators',
description: 'Swap the default "/" for a different character like chevrons, arrows, or dots. Use when the visual style of the page calls for a different separator.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsDeepHierarchy.doc.mjs b/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsDeepHierarchy.doc.mjs
index c1595eaa6a..7166c3aa58 100644
--- a/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsDeepHierarchy.doc.mjs
+++ b/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsDeepHierarchy.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Breadcrumbs',
name: 'Breadcrumbs — Deep Path',
description: 'A 5-level breadcrumb trail for deeply nested content. Use in e-commerce, file browsers, or any UI with several levels of hierarchy.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsShowcase.doc.mjs b/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsShowcase.doc.mjs
index 7995c7e059..612001a8c9 100644
--- a/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Breadcrumbs',
name: 'Breadcrumbs',
description:
'A breadcrumb trail showing page hierarchy with linked ancestors and a current page.',
diff --git a/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsSupportingVariant.doc.mjs b/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsSupportingVariant.doc.mjs
index 30f1558467..3f8d7d0523 100644
--- a/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsSupportingVariant.doc.mjs
+++ b/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsSupportingVariant.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Breadcrumbs',
name: 'Breadcrumbs — Variants',
description: 'Compare the default and supporting variants side by side. Use the supporting variant in dense UIs like admin panels where the breadcrumb should be subtle.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsWithIcons.doc.mjs b/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsWithIcons.doc.mjs
index 8315e056ec..fa11b53f73 100644
--- a/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsWithIcons.doc.mjs
+++ b/packages/cli/templates/blocks/components/Breadcrumbs/BreadcrumbsWithIcons.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Breadcrumbs',
name: 'Breadcrumbs — Icons',
description: 'Add icons before breadcrumb labels for quick recognition. Use a home icon on the root item and contextual icons on key sections.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Button/ButtonShowcase.doc.mjs b/packages/cli/templates/blocks/components/Button/ButtonShowcase.doc.mjs
index a91729bb01..2785765e3f 100644
--- a/packages/cli/templates/blocks/components/Button/ButtonShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Button/ButtonShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Button',
name: 'Button — Variants',
description:
'All four button variants side by side — primary, secondary, ghost, and destructive. A quick visual reference for choosing the right variant.',
diff --git a/packages/cli/templates/blocks/components/Button/ButtonSizeVariants.doc.mjs b/packages/cli/templates/blocks/components/Button/ButtonSizeVariants.doc.mjs
index a9c1cc2b80..23318ff371 100644
--- a/packages/cli/templates/blocks/components/Button/ButtonSizeVariants.doc.mjs
+++ b/packages/cli/templates/blocks/components/Button/ButtonSizeVariants.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Button',
name: 'Button — Sizes',
description: 'Small, medium, and large buttons side by side. Use small in dense UIs like toolbars, medium for most cases, and large for prominent CTAs.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Button/ButtonVariants.doc.mjs b/packages/cli/templates/blocks/components/Button/ButtonVariants.doc.mjs
index fbe2732fa9..1e4310cfc9 100644
--- a/packages/cli/templates/blocks/components/Button/ButtonVariants.doc.mjs
+++ b/packages/cli/templates/blocks/components/Button/ButtonVariants.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Button',
name: 'Button — Variants',
description: 'All 4 button variants in default, disabled, and loading states. Use primary for the main action, secondary for most others, ghost for low-emphasis, and destructive for dangerous actions.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Button/ButtonWithEndSlot.doc.mjs b/packages/cli/templates/blocks/components/Button/ButtonWithEndSlot.doc.mjs
index 17835c5f04..54cf25526d 100644
--- a/packages/cli/templates/blocks/components/Button/ButtonWithEndSlot.doc.mjs
+++ b/packages/cli/templates/blocks/components/Button/ButtonWithEndSlot.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Button',
name: 'Button — End Slot',
description: 'Buttons with a trailing badge showing a count or status. Use for notification counts, unread messages, or any button that needs a visual indicator.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Button/ButtonWithIcon.doc.mjs b/packages/cli/templates/blocks/components/Button/ButtonWithIcon.doc.mjs
index d4d276ad7c..85161275bc 100644
--- a/packages/cli/templates/blocks/components/Button/ButtonWithIcon.doc.mjs
+++ b/packages/cli/templates/blocks/components/Button/ButtonWithIcon.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Button',
name: 'Button — Icon',
description: 'Buttons with a leading icon that reinforces the label. Use when the icon helps the user identify the action faster, like a plus for "New" or a trash can for "Delete".',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Calendar/CalendarConstraints.doc.mjs b/packages/cli/templates/blocks/components/Calendar/CalendarConstraints.doc.mjs
index 351e0c38c1..be84e76b2e 100644
--- a/packages/cli/templates/blocks/components/Calendar/CalendarConstraints.doc.mjs
+++ b/packages/cli/templates/blocks/components/Calendar/CalendarConstraints.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Calendar',
name: 'Calendar — Constraints',
description: 'Limit which dates can be selected using min/max bounds and custom rules like weekdays only. Use for scheduling UIs where certain dates are unavailable.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Calendar/CalendarRangeWithValue.doc.mjs b/packages/cli/templates/blocks/components/Calendar/CalendarRangeWithValue.doc.mjs
index ec2294d4e4..670977c0d9 100644
--- a/packages/cli/templates/blocks/components/Calendar/CalendarRangeWithValue.doc.mjs
+++ b/packages/cli/templates/blocks/components/Calendar/CalendarRangeWithValue.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Calendar',
name: 'Calendar — Range',
description: 'Pick a start and end date with the range highlighted between them. Use for booking dates, time-off requests, or report filters.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Calendar/CalendarShowcase.doc.mjs b/packages/cli/templates/blocks/components/Calendar/CalendarShowcase.doc.mjs
index 58da717585..07dd6866fa 100644
--- a/packages/cli/templates/blocks/components/Calendar/CalendarShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Calendar/CalendarShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Calendar',
name: 'Calendar',
description:
'An interactive single-date calendar with a selected date. Click any day to change the selection.',
diff --git a/packages/cli/templates/blocks/components/Calendar/CalendarSingle.doc.mjs b/packages/cli/templates/blocks/components/Calendar/CalendarSingle.doc.mjs
index 4ad7bf4e9c..2537f7c46d 100644
--- a/packages/cli/templates/blocks/components/Calendar/CalendarSingle.doc.mjs
+++ b/packages/cli/templates/blocks/components/Calendar/CalendarSingle.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Calendar',
name: 'Calendar — Single',
description: 'Pick one date from a month grid. Use for appointment dates, due dates, or any field that needs a single date.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Calendar/CalendarTwoMonths.doc.mjs b/packages/cli/templates/blocks/components/Calendar/CalendarTwoMonths.doc.mjs
index 4ac81af5cd..6bafac3a70 100644
--- a/packages/cli/templates/blocks/components/Calendar/CalendarTwoMonths.doc.mjs
+++ b/packages/cli/templates/blocks/components/Calendar/CalendarTwoMonths.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Calendar',
name: 'Calendar — Two Months',
description: 'Two months side by side for selecting ranges that span a month boundary. Use in booking or travel UIs where check-in and check-out often fall in different months.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Card/CardCallout.doc.mjs b/packages/cli/templates/blocks/components/Card/CardCallout.doc.mjs
index 086f3aa5f6..af779891d0 100644
--- a/packages/cli/templates/blocks/components/Card/CardCallout.doc.mjs
+++ b/packages/cli/templates/blocks/components/Card/CardCallout.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Card',
name: 'Card — Callout',
description: 'Muted-variant cards for tips, notes, or supplementary information. Use when content should be visually distinct but not prominent. The muted variant uses a wash background instead of the elevated default, making it feel recessed rather than raised. Works well in sidebars, help panels, or inline callouts.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Card/CardShowcase.doc.mjs b/packages/cli/templates/blocks/components/Card/CardShowcase.doc.mjs
index 9c149b8fb1..6ccbb7d019 100644
--- a/packages/cli/templates/blocks/components/Card/CardShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Card/CardShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Card',
name: 'Card',
description:
'A card with a heading and body text showing the default container style.',
diff --git a/packages/cli/templates/blocks/components/Card/CardVariants.doc.mjs b/packages/cli/templates/blocks/components/Card/CardVariants.doc.mjs
index 2ace4f0192..cf4097a1dc 100644
--- a/packages/cli/templates/blocks/components/Card/CardVariants.doc.mjs
+++ b/packages/cli/templates/blocks/components/Card/CardVariants.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Card',
name: 'Card — Variants',
description: 'Default, muted, and color variants side by side. Use color variants to categorize cards visually, like team colors, project tags, or content types. Each color uses the corresponding background token from the theme, so they adapt to light and dark mode automatically.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Card/CardWithInnerLayout.doc.mjs b/packages/cli/templates/blocks/components/Card/CardWithInnerLayout.doc.mjs
index 04749c0196..992e5437e3 100644
--- a/packages/cli/templates/blocks/components/Card/CardWithInnerLayout.doc.mjs
+++ b/packages/cli/templates/blocks/components/Card/CardWithInnerLayout.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Card',
name: 'Card — Layout',
description: 'A card with a structured header, content area, and footer with action buttons. Use for forms, dialogs, or settings panels that need clear sections. Pair XDSCard with XDSLayout to get automatic dividers between header, content, and footer. The footer aligns actions to the right by default.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Card/CardWithSimpleContent.doc.mjs b/packages/cli/templates/blocks/components/Card/CardWithSimpleContent.doc.mjs
index 7501b6c729..62d82e043e 100644
--- a/packages/cli/templates/blocks/components/Card/CardWithSimpleContent.doc.mjs
+++ b/packages/cli/templates/blocks/components/Card/CardWithSimpleContent.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Card',
name: 'Card — Simple',
description: 'A card with a heading and body text. Use for summaries, descriptions, or any grouped content that needs visual separation from the page. The card handles its own border, background, and padding — just pass your content as children. Set a width to constrain it, or leave it to fill the parent.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Card/ClickableCardShowcase.doc.mjs b/packages/cli/templates/blocks/components/Card/ClickableCardShowcase.doc.mjs
index 4bde0236fa..fea3ea02bf 100644
--- a/packages/cli/templates/blocks/components/Card/ClickableCardShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Card/ClickableCardShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Card',
name: 'ClickableCard',
description:
'A clickable card that navigates on click. Nested interactive elements work independently.',
diff --git a/packages/cli/templates/blocks/components/Card/ClickableCardWithNestedButton.doc.mjs b/packages/cli/templates/blocks/components/Card/ClickableCardWithNestedButton.doc.mjs
index 5f3b933cef..6bd232d23e 100644
--- a/packages/cli/templates/blocks/components/Card/ClickableCardWithNestedButton.doc.mjs
+++ b/packages/cli/templates/blocks/components/Card/ClickableCardWithNestedButton.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Card',
name: 'ClickableCardWithNestedButton',
description:
'A product card that navigates on click but has an independent "Add to cart" button inside.',
diff --git a/packages/cli/templates/blocks/components/Card/SelectableCardMulti.doc.mjs b/packages/cli/templates/blocks/components/Card/SelectableCardMulti.doc.mjs
index 9f3a85af71..e55696e9ee 100644
--- a/packages/cli/templates/blocks/components/Card/SelectableCardMulti.doc.mjs
+++ b/packages/cli/templates/blocks/components/Card/SelectableCardMulti.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Card',
name: 'SelectableCardMulti',
description:
'Multi-select tag picker using color variant selectable cards with color-matched selection borders.',
diff --git a/packages/cli/templates/blocks/components/Card/SelectableCardShowcase.doc.mjs b/packages/cli/templates/blocks/components/Card/SelectableCardShowcase.doc.mjs
index 620ea1f657..ddcda307c2 100644
--- a/packages/cli/templates/blocks/components/Card/SelectableCardShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Card/SelectableCardShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Card',
name: 'SelectableCard',
description:
'A plan picker with single-select radio behavior. Cards show an accent border when selected.',
diff --git a/packages/cli/templates/blocks/components/Carousel/CarouselCards.doc.mjs b/packages/cli/templates/blocks/components/Carousel/CarouselCards.doc.mjs
index 62e0ec4b4b..f723151cd1 100644
--- a/packages/cli/templates/blocks/components/Carousel/CarouselCards.doc.mjs
+++ b/packages/cli/templates/blocks/components/Carousel/CarouselCards.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Carousel',
name: 'Carousel — Cards',
description: 'A horizontally scrollable row of cards with snap scrolling enabled. Use for feature grids, product lists, or any set of cards that overflows the available width. The carousel adds fade edges and navigation buttons automatically.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Carousel/CarouselShowcase.doc.mjs b/packages/cli/templates/blocks/components/Carousel/CarouselShowcase.doc.mjs
index bd1c81d0ab..5d03ee10fc 100644
--- a/packages/cli/templates/blocks/components/Carousel/CarouselShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Carousel/CarouselShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Carousel',
name: 'Carousel',
description:
'A horizontal carousel of cards with scroll-snap and navigation buttons. Scroll or click the arrows to browse.',
diff --git a/packages/cli/templates/blocks/components/Carousel/CarouselSnap.doc.mjs b/packages/cli/templates/blocks/components/Carousel/CarouselSnap.doc.mjs
index c2ff70716a..c2e1e4cb02 100644
--- a/packages/cli/templates/blocks/components/Carousel/CarouselSnap.doc.mjs
+++ b/packages/cli/templates/blocks/components/Carousel/CarouselSnap.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Carousel',
name: 'Carousel — Snap',
description: 'Scroll-snap carousel with navigation buttons and team member cards. Each card snaps to the start edge on scroll. Use when items should be viewed one at a time rather than as a continuous strip.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Center/CenterHorizontal.doc.mjs b/packages/cli/templates/blocks/components/Center/CenterHorizontal.doc.mjs
index 9b3bbc6eaa..fa6cf67479 100644
--- a/packages/cli/templates/blocks/components/Center/CenterHorizontal.doc.mjs
+++ b/packages/cli/templates/blocks/components/Center/CenterHorizontal.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Center',
name: 'Center — Horizontal Center',
description: 'An editor toolbar with a document title on the left and formatting actions on the right. This shows axis="horizontal" — centering in one direction only. Use when content needs to be horizontally centered while other elements are positioned independently around it.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Center/CenterInsideACard.doc.mjs b/packages/cli/templates/blocks/components/Center/CenterInsideACard.doc.mjs
index 5bc4ca1f72..0783f2c2a1 100644
--- a/packages/cli/templates/blocks/components/Center/CenterInsideACard.doc.mjs
+++ b/packages/cli/templates/blocks/components/Center/CenterInsideACard.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Center',
name: 'Center — Vertical & Horizontal Center',
description: 'An empty state with an icon, heading, and description centered both vertically and horizontally inside a card. This is the most common use of Center — placing content in the middle of a fixed-height area like a panel, card, or content region. The height prop defines the centering space.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Center/CenterShowcase.doc.mjs b/packages/cli/templates/blocks/components/Center/CenterShowcase.doc.mjs
index 40d52b922b..4df73a23ec 100644
--- a/packages/cli/templates/blocks/components/Center/CenterShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Center/CenterShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Center',
name: 'Center',
description:
'Content centered horizontally and vertically inside a fixed-height container.',
diff --git a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerAttachments.doc.mjs b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerAttachments.doc.mjs
index 5a1ce7440b..c1ae083972 100644
--- a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerAttachments.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerAttachments.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposer',
name: 'ChatComposer — Attachments',
description: 'Chat composer with removable file tokens in a collapsible drawer. Use when users can attach files or context to their message.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerFooterActions.doc.mjs b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerFooterActions.doc.mjs
index 73862bed5a..0c5403c538 100644
--- a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerFooterActions.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerFooterActions.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposer',
name: 'ChatComposer — Footer Actions',
description: 'Chat composer with dropdown menus for a model selector and settings in the footer, and a mic button in the send actions slot.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerFullFeatured.doc.mjs b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerFullFeatured.doc.mjs
index 06031b6171..0019909bf9 100644
--- a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerFullFeatured.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerFullFeatured.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposer',
name: 'ChatComposer — Full Featured',
description: 'Chat composer with all slots populated — collapsible attachment drawer, header actions, context progress bar, footer dropdown menus, and mic button. Shows the maximum composer configuration.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerShowcase.doc.mjs b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerShowcase.doc.mjs
index 69b7ee38ed..62e807d4a9 100644
--- a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposer',
name: 'ChatComposer',
isReady: true,
aspectRatio: 4 / 3,
diff --git a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerSimple.doc.mjs b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerSimple.doc.mjs
index beed7eb56f..8fa2a379f3 100644
--- a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerSimple.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerSimple.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposer',
name: 'ChatComposer — Simple',
description: 'Minimal chat composer with a placeholder and submit handler. The simplest way to drop a message input into a page.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerStreaming.doc.mjs b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerStreaming.doc.mjs
index 3a265a26f2..8a6d71768a 100644
--- a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerStreaming.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerStreaming.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposer',
name: 'ChatComposer — Streaming',
description: 'Chat composer with streaming state and a stop button. Use when the assistant is generating a response and the user can cancel.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerValidation.doc.mjs b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerValidation.doc.mjs
index 8259564fa4..f875021e1e 100644
--- a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerValidation.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerValidation.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposer',
name: 'ChatComposer — Validation',
description: 'Chat composer with error and warning status messages. Status can appear above or below the composer to surface validation or system feedback.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerAttachments.doc.mjs b/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerAttachments.doc.mjs
index ed4d197158..7d126d0cb5 100644
--- a/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerAttachments.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerAttachments.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposerDrawer',
name: 'ChatComposerDrawer — Attachments',
description: 'Drawer with two rows: a scrollable carousel of image thumbnails and a row of removable file tokens. Omit count to keep the drawer always expanded.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerCollapsible.doc.mjs b/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerCollapsible.doc.mjs
index 6b5aacbc12..4a1684bc70 100644
--- a/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerCollapsible.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerCollapsible.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposerDrawer',
name: 'ChatComposerDrawer — Collapsible',
description: 'Drawer with many items and a collapse toggle. Pass count to enable the toggle — collapsed state shows a badge with the total count and a label.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerFeedback.doc.mjs b/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerFeedback.doc.mjs
index b40c262534..d054e65d9b 100644
--- a/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerFeedback.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerFeedback.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposerDrawer',
name: 'ChatComposerDrawer — Feedback',
description: 'Chat composer drawer with a feedback prompt and selectable lettered options. Use for user confirmation workflows that require explicit action before proceeding.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerShowcase.doc.mjs b/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerShowcase.doc.mjs
index ef825eca4e..93b48278ff 100644
--- a/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposerDrawer',
name: 'ChatComposerDrawer',
description: 'Composer drawer with file tokens, a collapsible toggle, and header actions. Use as a starting point for any chat composer with attachments.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerWithProgress.doc.mjs b/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerWithProgress.doc.mjs
index 9db632fbf8..82b3a35cec 100644
--- a/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerWithProgress.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposerDrawer/ChatComposerDrawerWithProgress.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposerDrawer',
name: 'ChatComposerDrawer — With Progress',
description: 'Drawer paired with a context progress bar in the header. Show context window usage when attachments consume part of the available token budget.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputControlledInput.doc.mjs b/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputControlledInput.doc.mjs
index 7a65cf532d..aae1fd6745 100644
--- a/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputControlledInput.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputControlledInput.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposerInput',
name: 'ChatComposerInput — Controlled',
description:
'Controlled chat input with live value display. Use controlled mode when you need to read or transform the input value outside the composer.',
diff --git a/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputDisabled.doc.mjs b/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputDisabled.doc.mjs
index 7f06893f3c..f4f5725d96 100644
--- a/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputDisabled.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputDisabled.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposerInput',
name: 'ChatComposerInput — Disabled',
description:
'Composer in a disabled state. Use when the input should be visible but not interactive, such as during streaming or when a prerequisite is unmet.',
diff --git a/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputMentionTrigger.doc.mjs b/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputMentionTrigger.doc.mjs
index 75c017450e..ed7f97a462 100644
--- a/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputMentionTrigger.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputMentionTrigger.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposerInput',
name: 'ChatComposerInput — Mentions',
description:
'Chat input with an @ trigger that opens a typeahead menu for mentioning users. Selected names appear as inline tokens.',
diff --git a/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputMultipleTriggers.doc.mjs b/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputMultipleTriggers.doc.mjs
index cb5c52688d..cb6f2cc831 100644
--- a/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputMultipleTriggers.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputMultipleTriggers.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposerInput',
name: 'ChatComposerInput — Multiple Triggers',
description:
'Chat input with both @ mentions and / commands. Each trigger type renders tokens in a distinct color so users can tell them apart at a glance.',
diff --git a/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputShowcase.doc.mjs b/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputShowcase.doc.mjs
index c9ecde5ea6..a3ad382fb4 100644
--- a/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposerInput',
name: 'ChatComposerInput',
isReady: true,
aspectRatio: 16 / 9,
diff --git a/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputSlashCommands.doc.mjs b/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputSlashCommands.doc.mjs
index 0537075787..4e124e4c43 100644
--- a/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputSlashCommands.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatComposerInput/ChatComposerInputSlashCommands.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatComposerInput',
name: 'ChatComposerInput — Slash Commands',
description:
'Chat input with a / trigger for command selection. Use for AI assistants or bots that support structured commands.',
diff --git a/packages/cli/templates/blocks/components/ChatDictation/ChatDictationDictationInComposer.doc.mjs b/packages/cli/templates/blocks/components/ChatDictation/ChatDictationDictationInComposer.doc.mjs
index 733e2b5344..7d0e0e29ef 100644
--- a/packages/cli/templates/blocks/components/ChatDictation/ChatDictationDictationInComposer.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatDictation/ChatDictationDictationInComposer.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatDictation',
name: 'ChatDictationButton — In Composer',
description: 'Dictation button placed in the sendActions slot of a chat composer. Shows the recommended integration point for voice input alongside the send button.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatDictation/ChatDictationDictationStates.doc.mjs b/packages/cli/templates/blocks/components/ChatDictation/ChatDictationDictationStates.doc.mjs
index 61d7d6ec1c..a0ca8474c3 100644
--- a/packages/cli/templates/blocks/components/ChatDictation/ChatDictationDictationStates.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatDictation/ChatDictationDictationStates.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatDictation',
name: 'ChatDictationButton — States',
description: 'Dictation button in idle, listening, and speaking states side by side. Shows the three visual phases of a voice input interaction.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatDictation/ChatDictationSizes.doc.mjs b/packages/cli/templates/blocks/components/ChatDictation/ChatDictationSizes.doc.mjs
index b79364366b..83280e7918 100644
--- a/packages/cli/templates/blocks/components/ChatDictation/ChatDictationSizes.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatDictation/ChatDictationSizes.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatDictation',
name: 'ChatDictationButton — Sizes',
description: 'Small and medium dictation buttons side by side. Use small in compact composer densities and medium for standard layouts.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatDictationButton/ChatDictationButtonShowcase.doc.mjs b/packages/cli/templates/blocks/components/ChatDictationButton/ChatDictationButtonShowcase.doc.mjs
index c1c1c852c8..f2df13c26e 100644
--- a/packages/cli/templates/blocks/components/ChatDictationButton/ChatDictationButtonShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatDictationButton/ChatDictationButtonShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatDictationButton',
name: 'ChatDictationButton',
description: 'Interactive dictation button connected to the SpeechRecognition API via useXDSChatDictation. Click the mic to dictate into the composer.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatLayout/ChatLayoutPanelChat.doc.mjs b/packages/cli/templates/blocks/components/ChatLayout/ChatLayoutPanelChat.doc.mjs
index e071dc50ea..44874a2415 100644
--- a/packages/cli/templates/blocks/components/ChatLayout/ChatLayoutPanelChat.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatLayout/ChatLayoutPanelChat.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatLayout',
name: 'ChatLayout — Panel View',
description: 'Narrow sidebar chat in a constrained container that triggers compact density. Use for side panels, drawers, or embedded chat widgets where horizontal space is limited.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatLayout/ChatLayoutShowcase.doc.mjs b/packages/cli/templates/blocks/components/ChatLayout/ChatLayoutShowcase.doc.mjs
index c097d88d91..a700de8813 100644
--- a/packages/cli/templates/blocks/components/ChatLayout/ChatLayoutShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatLayout/ChatLayoutShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatLayout',
name: 'ChatLayout',
isReady: true,
aspectRatio: 4 / 3,
diff --git a/packages/cli/templates/blocks/components/ChatLayoutScrollButton/ChatLayoutScrollButtonLabels.doc.mjs b/packages/cli/templates/blocks/components/ChatLayoutScrollButton/ChatLayoutScrollButtonLabels.doc.mjs
index 1b87b4e198..c814341000 100644
--- a/packages/cli/templates/blocks/components/ChatLayoutScrollButton/ChatLayoutScrollButtonLabels.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatLayoutScrollButton/ChatLayoutScrollButtonLabels.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatLayoutScrollButton',
name: 'ChatLayoutScrollButton — Labels',
description: 'Scroll button with different labels for context-specific notifications like new messages, unread replies, or a generic scroll prompt.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatLayoutScrollButton/ChatLayoutScrollButtonStates.doc.mjs b/packages/cli/templates/blocks/components/ChatLayoutScrollButton/ChatLayoutScrollButtonStates.doc.mjs
index e32187ce31..b5321ba5ff 100644
--- a/packages/cli/templates/blocks/components/ChatLayoutScrollButton/ChatLayoutScrollButtonStates.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatLayoutScrollButton/ChatLayoutScrollButtonStates.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatLayoutScrollButton',
name: 'ChatLayoutScrollButton',
description: 'Scroll button in hidden, visible, and expanded (with label) states. The button fades in when the user scrolls up and expands when new messages arrive.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageAvatarName.doc.mjs b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageAvatarName.doc.mjs
index 5978ef5da8..94b4a68c87 100644
--- a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageAvatarName.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageAvatarName.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessage',
name: 'ChatMessage — Avatar & Name',
description: 'Messages with avatars and sender names. Place the name on the bubble when using bubbles, or on the message wrapper for raw content.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageGhost.doc.mjs b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageGhost.doc.mjs
index ed4ff63292..e252d12682 100644
--- a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageGhost.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageGhost.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessage',
name: 'ChatMessage — Ghost',
description: 'Ghost variant for messages without visible bubble boundaries. Keeps padding for alignment but renders a transparent background, useful for AI-style responses.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageMultiBubble.doc.mjs b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageMultiBubble.doc.mjs
index c041d45674..f56f9f0dfd 100644
--- a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageMultiBubble.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageMultiBubble.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessage',
name: 'ChatMessage — Multi-Bubble',
description: 'Grouped bubbles using the group prop for corner radius reduction. Use first, middle, and last to visually connect related bubbles from the same sender.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageShowcase.doc.mjs b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageShowcase.doc.mjs
index b80a474aff..50fe506c81 100644
--- a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessage',
name: 'ChatMessage',
description: 'A user multi-bubble group with delivery status and an assistant ghost response with avatar, name, timestamp, and model info.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleDensity.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleDensity.doc.mjs
index 4fd0b4680e..0ed97d7393 100644
--- a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleDensity.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleDensity.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessageBubble',
name: 'ChatMessageBubble — Density',
description: 'Compact, balanced, and spacious density modes side by side. Density controls bubble padding, corner radius, and spacing between grouped bubbles.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleGrouping.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleGrouping.doc.mjs
index 0ab75169ce..51df0c1859 100644
--- a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleGrouping.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleGrouping.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessageBubble',
name: 'ChatMessageBubble — Grouping',
description: 'Multi-bubble messages using first, middle, and last group positions. Grouped bubbles tighten corner radius on the sender side for a continuous visual flow.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleMetadata.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleMetadata.doc.mjs
index 5f5a3beec3..40232af07e 100644
--- a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleMetadata.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleMetadata.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessageBubble',
name: 'ChatMessageBubble — Metadata',
description: 'Bubbles with name and metadata slots aligned to bubble padding. Put name on the first bubble and metadata on the last bubble in a message.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleShowcase.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleShowcase.doc.mjs
index 2f58e66c7f..6a24727579 100644
--- a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessageBubble',
name: 'ChatMessageBubble',
description: 'Grouped user bubbles with filled styling and a ghost-variant agent response, with timestamps and delivery status.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleVariants.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleVariants.doc.mjs
index 54acb27345..4813f093c7 100644
--- a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleVariants.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleVariants.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessageBubble',
name: 'ChatMessageBubble — Variants',
description: 'Filled and ghost bubble variants for both user and assistant senders. Use filled for standard messages and ghost when content needs alignment without a visual boundary.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListDensity.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListDensity.doc.mjs
index 43b7a240ca..3a8d1a506a 100644
--- a/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListDensity.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListDensity.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessageList',
name: 'ChatMessageList — Density',
description: 'Side-by-side comparison of compact, balanced, and spacious densities. Use compact in sidebars or panels, balanced for most full-page chat, and spacious for long-form reading.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListFullFeatured.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListFullFeatured.doc.mjs
index caffff080b..1576635185 100644
--- a/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListFullFeatured.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListFullFeatured.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessageList',
name: 'ChatMessageList — Full Featured',
description: 'Conversation showcasing system messages, multi-bubble grouping, markdown, code blocks, and metadata. Combines date dividers, ghost bubbles, grouped messages, and rich content in a single example.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListShowcase.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListShowcase.doc.mjs
index 1c4c38ef3c..9b7f680cae 100644
--- a/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessageList',
name: 'ChatMessageList',
description: 'Basic AI chat conversation with user and assistant messages. The simplest way to render a message list with alternating sender bubbles, metadata, and a date divider.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataFooter.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataFooter.doc.mjs
index 9698a14e0b..45c2fcb5cf 100644
--- a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataFooter.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataFooter.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessageMetadata',
name: 'ChatMessageMetadata — Footer Actions',
description: 'Assistant message with footer actions — copy, retry, thumbs up/down, and model label. Use for AI responses that need feedback or utility controls.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataShowcase.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataShowcase.doc.mjs
index a249095c97..e86bfcd64d 100644
--- a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessageMetadata',
name: 'ChatMessageMetadata',
description: 'Three-message conversation showcasing error status with retry, delivery status, and full footer actions with model label.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.doc.mjs
index f68427eeee..d17d7acb93 100644
--- a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessageMetadata',
name: 'ChatMessageMetadata — Status',
description: 'All 5 delivery statuses — sending, sent, delivered, read, and error — each with a timestamp. Use to show message delivery progress or surface failures.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.doc.mjs
index e3c30b7b3d..7092af2498 100644
--- a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatMessageMetadata',
name: 'ChatMessageMetadata — Timestamps',
description: 'Timestamp-only metadata on user and assistant messages. Supports absolute time and relative formats via XDSTimestamp.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonCustomIcon.doc.mjs b/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonCustomIcon.doc.mjs
index 3d2a91dd23..e91af51548 100644
--- a/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonCustomIcon.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonCustomIcon.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatSendButton',
name: 'ChatSendButton — Custom Icon',
description: 'Send buttons with custom icons via sendIcon and stopIcon props. Use to match the personality of the chat experience — a paper airplane for messaging, sparkles for AI generation, or a check mark for confirmation flows.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonInComposer.doc.mjs b/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonInComposer.doc.mjs
index 02962b980c..601add25e0 100644
--- a/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonInComposer.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonInComposer.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatSendButton',
name: 'ChatSendButton — In Composer',
description: 'Send button inside XDSChatComposer, where it reads state from context automatically. No wiring needed — the button enables when the input has content.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonShowcase.doc.mjs b/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonShowcase.doc.mjs
index abe925267d..31634344c6 100644
--- a/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatSendButton',
name: 'ChatSendButton',
description: 'Ready, custom icon, and streaming states of the send button.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonStates.doc.mjs b/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonStates.doc.mjs
index bf0b082eb9..3933199add 100644
--- a/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonStates.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatSendButton/ChatSendButtonStates.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatSendButton',
name: 'ChatSendButton — States',
description: 'Disabled, ready, and streaming states at both sizes. The button automatically toggles between send (primary) and stop (secondary) based on streaming state.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageShowcase.doc.mjs b/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageShowcase.doc.mjs
index c49b3915c3..1990bcfacf 100644
--- a/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatSystemMessage',
name: 'ChatSystemMessage',
description: 'System messages for date dividers, status updates, and informational notices. Shows both default and divider variants in a realistic conversation flow.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageStatusUpdates.doc.mjs b/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageStatusUpdates.doc.mjs
index 476725327a..d835983aa0 100644
--- a/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageStatusUpdates.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageStatusUpdates.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatSystemMessage',
name: 'ChatSystemMessage — Status Updates',
description: 'Realistic status messages in a conversation flow showing membership changes, timestamps, and resolution notices.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageVariants.doc.mjs b/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageVariants.doc.mjs
index 36e1007245..fb94ca51d0 100644
--- a/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageVariants.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageVariants.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatSystemMessage',
name: 'ChatSystemMessage — Variants',
description: 'Default and divider variants side by side. Use default for inline status updates and divider for date separators or section breaks.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageWithIcon.doc.mjs b/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageWithIcon.doc.mjs
index df95e72ba6..51196358ae 100644
--- a/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageWithIcon.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatSystemMessage/ChatSystemMessageWithIcon.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatSystemMessage',
name: 'ChatSystemMessage — Icon',
description: 'System messages with a leading icon that reinforces the message type. Use icons to help users scan and identify message categories at a glance.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatTokenizedText/ChatTokenizedTextBasic.doc.mjs b/packages/cli/templates/blocks/components/ChatTokenizedText/ChatTokenizedTextBasic.doc.mjs
index 710662878b..d1246bc3c4 100644
--- a/packages/cli/templates/blocks/components/ChatTokenizedText/ChatTokenizedTextBasic.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatTokenizedText/ChatTokenizedTextBasic.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatTokenizedText',
name: 'ChatTokenizedText — Basic',
description: 'A message with @mention tokens. Each matching pattern is replaced with its display name badge.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatTokenizedText/ChatTokenizedTextColors.doc.mjs b/packages/cli/templates/blocks/components/ChatTokenizedText/ChatTokenizedTextColors.doc.mjs
index 83ecd2ad4a..e29df55a07 100644
--- a/packages/cli/templates/blocks/components/ChatTokenizedText/ChatTokenizedTextColors.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatTokenizedText/ChatTokenizedTextColors.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatTokenizedText',
name: 'ChatTokenizedText — Colors',
description: 'Tokens with different color variants to distinguish mentions, bugs, and features. Use variant colors to create a visual taxonomy — blue for people, red for bugs, green for features.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatTokenizedText/ChatTokenizedTextShowcase.doc.mjs b/packages/cli/templates/blocks/components/ChatTokenizedText/ChatTokenizedTextShowcase.doc.mjs
index 10d983b266..ad01038aa4 100644
--- a/packages/cli/templates/blocks/components/ChatTokenizedText/ChatTokenizedTextShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatTokenizedText/ChatTokenizedTextShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatTokenizedText',
name: 'ChatTokenizedText',
isReady: true,
aspectRatio: 16 / 9,
diff --git a/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsInteractiveToolCalls.doc.mjs b/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsInteractiveToolCalls.doc.mjs
index ec1746bae4..05fd858700 100644
--- a/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsInteractiveToolCalls.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsInteractiveToolCalls.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatToolCalls',
name: 'ChatToolCalls — Expandable',
description: 'Tool calls with expandable result details showing diffs and command output in code blocks. Click a row to reveal its result.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsShowcase.doc.mjs b/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsShowcase.doc.mjs
index dfbdf01378..b23825b321 100644
--- a/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatToolCalls',
name: 'ChatToolCalls',
isReady: true,
aspectRatio: 16 / 9,
diff --git a/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsStatuses.doc.mjs b/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsStatuses.doc.mjs
index 825a8376d6..1ca85d4fbf 100644
--- a/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsStatuses.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsStatuses.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatToolCalls',
name: 'ChatToolCalls — Statuses',
description: 'All four status states — pending, running, complete, and error — shown together in a single group.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsToolCallsWithNodes.doc.mjs b/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsToolCallsWithNodes.doc.mjs
index d3f92e0b94..c29d4afe0d 100644
--- a/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsToolCallsWithNodes.doc.mjs
+++ b/packages/cli/templates/blocks/components/ChatToolCalls/ChatToolCallsToolCallsWithNodes.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ChatToolCalls',
name: 'ChatToolCalls — Simple',
description: 'A single inline tool call above a collapsible multi-call group with diff stats. Shows both layouts side by side.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputBasic.doc.mjs b/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputBasic.doc.mjs
index 1b94e3aac2..ebf7be644f 100644
--- a/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputBasic.doc.mjs
+++ b/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputBasic.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CheckboxInput',
name: 'CheckboxInput — States',
description: 'Checkboxes with labels and descriptions in checked, unchecked, and disabled states. Each checkbox controls a single on/off setting. Add a description to explain what the setting does.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputIndeterminateState.doc.mjs b/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputIndeterminateState.doc.mjs
index 28ad8c1409..604c41202d 100644
--- a/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputIndeterminateState.doc.mjs
+++ b/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputIndeterminateState.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CheckboxInput',
name: 'CheckboxInput — Indeterminate',
description: 'A "select all" checkbox that controls a group of options. When only some options are checked, it shows a dash instead of a checkmark. Clicking it checks or unchecks everything.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputShowcase.doc.mjs b/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputShowcase.doc.mjs
index 52128ea8fc..253823e7bc 100644
--- a/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CheckboxInput',
name: 'CheckboxInput',
description:
'Interactive checkboxes showing checked, unchecked, and indeterminate states with descriptions.',
diff --git a/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputStatusVariations.doc.mjs b/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputStatusVariations.doc.mjs
index 12f3bed4ae..cb9a278519 100644
--- a/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputStatusVariations.doc.mjs
+++ b/packages/cli/templates/blocks/components/CheckboxInput/CheckboxInputStatusVariations.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CheckboxInput',
name: 'CheckboxInput — Status',
description: 'Checkboxes with error, warning, and success validation messages. Use the status prop to show feedback after form validation — errors block submission, warnings inform, and success confirms.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/CheckboxList/CheckboxListSelectAllPattern.doc.mjs b/packages/cli/templates/blocks/components/CheckboxList/CheckboxListSelectAllPattern.doc.mjs
index ebfab8ed40..50b6963de6 100644
--- a/packages/cli/templates/blocks/components/CheckboxList/CheckboxListSelectAllPattern.doc.mjs
+++ b/packages/cli/templates/blocks/components/CheckboxList/CheckboxListSelectAllPattern.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CheckboxList',
name: 'CheckboxList — Select All With Indeterminate',
description:
'A "select all" toggle at the top of a checkbox list that switches to an indeterminate dash when only some items are checked — useful for bulk actions like exporting documents or assigning permissions where users often want everything at once.',
diff --git a/packages/cli/templates/blocks/components/CheckboxList/CheckboxListShowcase.doc.mjs b/packages/cli/templates/blocks/components/CheckboxList/CheckboxListShowcase.doc.mjs
index 7874c38590..f0ba96784b 100644
--- a/packages/cli/templates/blocks/components/CheckboxList/CheckboxListShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/CheckboxList/CheckboxListShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CheckboxList',
name: 'CheckboxList',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/CheckboxList/CheckboxListWithEndContent.doc.mjs b/packages/cli/templates/blocks/components/CheckboxList/CheckboxListWithEndContent.doc.mjs
index a5ac55f88f..6ef8585a3f 100644
--- a/packages/cli/templates/blocks/components/CheckboxList/CheckboxListWithEndContent.doc.mjs
+++ b/packages/cli/templates/blocks/components/CheckboxList/CheckboxListWithEndContent.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CheckboxList',
name: 'CheckboxList — With End Content',
description:
'Badges in the trailing slot show contextual info — like a price or status — next to each option without cluttering the label, so users can compare choices at a glance.',
diff --git a/packages/cli/templates/blocks/components/CheckboxListItem/CheckboxListItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/CheckboxListItem/CheckboxListItemShowcase.doc.mjs
index 28c5f10392..fd5d1e16f2 100644
--- a/packages/cli/templates/blocks/components/CheckboxListItem/CheckboxListItemShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/CheckboxListItem/CheckboxListItemShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CheckboxListItem',
name: 'CheckboxListItem',
description:
'Checkbox list items with labels, descriptions, and different states including disabled.',
diff --git a/packages/cli/templates/blocks/components/Code/CodeAcrossTextSizes.doc.mjs b/packages/cli/templates/blocks/components/Code/CodeAcrossTextSizes.doc.mjs
index de9933a8a8..c0d9c809a6 100644
--- a/packages/cli/templates/blocks/components/Code/CodeAcrossTextSizes.doc.mjs
+++ b/packages/cli/templates/blocks/components/Code/CodeAcrossTextSizes.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Code',
name: 'Code — Text Sizes',
description:
'Inline code rendered inside heading, body, supporting, and label text. XDSCode automatically matches the font size of its parent text element.',
diff --git a/packages/cli/templates/blocks/components/Code/CodeInlineInParagraph.doc.mjs b/packages/cli/templates/blocks/components/Code/CodeInlineInParagraph.doc.mjs
index d3828d517d..7fc56598df 100644
--- a/packages/cli/templates/blocks/components/Code/CodeInlineInParagraph.doc.mjs
+++ b/packages/cli/templates/blocks/components/Code/CodeInlineInParagraph.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Code',
name: 'Code — Inline',
description:
'Inline code references mixed within a paragraph of body text. Use XDSCode to mark up function names, hooks, or API terms so they stand out from surrounding prose.',
diff --git a/packages/cli/templates/blocks/components/Code/CodeShowcase.doc.mjs b/packages/cli/templates/blocks/components/Code/CodeShowcase.doc.mjs
index a592415db6..a30202bd13 100644
--- a/packages/cli/templates/blocks/components/Code/CodeShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Code/CodeShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Code',
name: 'Code',
description:
'Inline code snippets inside a sentence showing how Code renders alongside body text.',
diff --git a/packages/cli/templates/blocks/components/Code/CodeVariousContent.doc.mjs b/packages/cli/templates/blocks/components/Code/CodeVariousContent.doc.mjs
index 874200eee1..caf76ca58e 100644
--- a/packages/cli/templates/blocks/components/Code/CodeVariousContent.doc.mjs
+++ b/packages/cli/templates/blocks/components/Code/CodeVariousContent.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Code',
name: 'Code — Content Types',
description:
'Inline code used for variables, terminal commands, CSS properties, file paths, and keyboard shortcuts. Shows how XDSCode adapts to different kinds of technical content.',
diff --git a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockBashCommand.doc.mjs b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockBashCommand.doc.mjs
index e7d529031d..1b03b260cb 100644
--- a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockBashCommand.doc.mjs
+++ b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockBashCommand.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CodeBlock',
name: 'Code — Snippet',
description:
'Short terminal commands with a copy button and no line numbers. Use for install instructions or one-liner commands that readers will paste directly.',
diff --git a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockHighlightedLines.doc.mjs b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockHighlightedLines.doc.mjs
index f9a0933d39..3017a1b2a5 100644
--- a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockHighlightedLines.doc.mjs
+++ b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockHighlightedLines.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CodeBlock',
name: 'Code — Highlighted',
description:
'TypeScript code with specific lines highlighted to draw attention to a key section. Use highlightLines to call out new or important code in tutorials and changelogs.',
diff --git a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockJSONConfig.doc.mjs b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockJSONConfig.doc.mjs
index 8cad84c4fa..30eb797ab3 100644
--- a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockJSONConfig.doc.mjs
+++ b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockJSONConfig.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CodeBlock',
name: 'Code — Config',
description:
'A JSON configuration file with a title bar and line numbers. The title prop adds a filename label in the header so readers know which file the code belongs to.',
diff --git a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockScrollableBlock.doc.mjs b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockScrollableBlock.doc.mjs
index a90ab59b0d..b35bf67ba3 100644
--- a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockScrollableBlock.doc.mjs
+++ b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockScrollableBlock.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CodeBlock',
name: 'Code — Scrollable',
description:
'A long code block with a max height that enables vertical scrolling. Use maxHeight to keep the block from dominating the page when displaying large files.',
diff --git a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockShowcase.doc.mjs b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockShowcase.doc.mjs
index 221f13b3c4..dee3e727b0 100644
--- a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CodeBlock',
name: 'CodeBlock',
description:
'A syntax-highlighted TypeScript code block with line numbers, a title bar, and a copy button.',
diff --git a/packages/cli/templates/blocks/components/Collapsible/CollapsibleControlledAccordion.doc.mjs b/packages/cli/templates/blocks/components/Collapsible/CollapsibleControlledAccordion.doc.mjs
index 21b787479b..026dad819d 100644
--- a/packages/cli/templates/blocks/components/Collapsible/CollapsibleControlledAccordion.doc.mjs
+++ b/packages/cli/templates/blocks/components/Collapsible/CollapsibleControlledAccordion.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Collapsible',
name: 'Collapsible — Controlled',
description: 'Manage the open section from parent state. Use when the open state needs to sync with a URL param, form, or external control.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Collapsible/CollapsibleMultipleAccordion.doc.mjs b/packages/cli/templates/blocks/components/Collapsible/CollapsibleMultipleAccordion.doc.mjs
index 061f4e9a39..9a80f46a42 100644
--- a/packages/cli/templates/blocks/components/Collapsible/CollapsibleMultipleAccordion.doc.mjs
+++ b/packages/cli/templates/blocks/components/Collapsible/CollapsibleMultipleAccordion.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Collapsible',
name: 'Collapsible — Multiple Mode',
description: 'Several sections open at once. Use when users need to compare content across sections, like feature lists or pricing tiers.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Collapsible/CollapsibleShowcase.doc.mjs b/packages/cli/templates/blocks/components/Collapsible/CollapsibleShowcase.doc.mjs
index 4dc5141ac5..e123e2ac3b 100644
--- a/packages/cli/templates/blocks/components/Collapsible/CollapsibleShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Collapsible/CollapsibleShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Collapsible',
name: 'Collapsible',
description:
'An accordion group with three collapsible sections in single mode — opening one closes the others.',
diff --git a/packages/cli/templates/blocks/components/Collapsible/CollapsibleSingleAccordion.doc.mjs b/packages/cli/templates/blocks/components/Collapsible/CollapsibleSingleAccordion.doc.mjs
index 42b4bc92a2..24b02c46ca 100644
--- a/packages/cli/templates/blocks/components/Collapsible/CollapsibleSingleAccordion.doc.mjs
+++ b/packages/cli/templates/blocks/components/Collapsible/CollapsibleSingleAccordion.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Collapsible',
name: 'Collapsible — Single Mode',
description: 'Only one section open at a time. Use for settings pages or any list where expanding one item should close the others.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Collapsible/CollapsibleWithoutCard.doc.mjs b/packages/cli/templates/blocks/components/Collapsible/CollapsibleWithoutCard.doc.mjs
index c9be191ee2..bc6227c074 100644
--- a/packages/cli/templates/blocks/components/Collapsible/CollapsibleWithoutCard.doc.mjs
+++ b/packages/cli/templates/blocks/components/Collapsible/CollapsibleWithoutCard.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Collapsible',
name: 'Collapsible — With Dividers',
description: 'Collapsible sections separated by dividers instead of cards. Use for inline disclosure in detail panels or sidebar content where cards would add too much weight.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.doc.mjs b/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.doc.mjs
index 041a94c9f3..d3c3279e1c 100644
--- a/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CollapsibleGroup',
name: 'CollapsibleGroup',
description:
'CollapsibleGroup coordinates multiple Collapsible components so that expanding one can automatically collapse the others, creating accordion behavior.',
diff --git a/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteAsyncSearch.doc.mjs b/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteAsyncSearch.doc.mjs
index b6a64f62e5..53921619b6 100644
--- a/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteAsyncSearch.doc.mjs
+++ b/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteAsyncSearch.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CommandPalette',
name: 'CommandPalette — Async Search',
description:
'Server-side search with loading spinner and custom empty states.',
diff --git a/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteAutoGrouped.doc.mjs b/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteAutoGrouped.doc.mjs
index 7989c21e48..3a7be22aaa 100644
--- a/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteAutoGrouped.doc.mjs
+++ b/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteAutoGrouped.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CommandPalette',
name: 'CommandPalette — Grouped',
description:
'Command palette with items grouped via auxiliaryData.group.',
diff --git a/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteCustomFooter.doc.mjs b/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteCustomFooter.doc.mjs
index c459107dec..bc79ec35a4 100644
--- a/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteCustomFooter.doc.mjs
+++ b/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteCustomFooter.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CommandPalette',
name: 'CommandPalette — Custom Footer',
description: 'Command palette with a custom footer tip message.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/CommandPalette/CommandPalettePickerMode.doc.mjs b/packages/cli/templates/blocks/components/CommandPalette/CommandPalettePickerMode.doc.mjs
index e9bbf0dee6..924fd52fe3 100644
--- a/packages/cli/templates/blocks/components/CommandPalette/CommandPalettePickerMode.doc.mjs
+++ b/packages/cli/templates/blocks/components/CommandPalette/CommandPalettePickerMode.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CommandPalette',
name: 'CommandPalette — Picker Mode',
description:
'Single-value picker with persistent selection and check indicator.',
diff --git a/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteRichItems.doc.mjs b/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteRichItems.doc.mjs
index 217a07ef1a..cd500ed8b8 100644
--- a/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteRichItems.doc.mjs
+++ b/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteRichItems.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CommandPalette',
name: 'CommandPalette — Rich Items',
description:
'Custom item rendering with icons, keyboard shortcuts, and keyword search.',
diff --git a/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteShowcase.doc.mjs b/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteShowcase.doc.mjs
index 775ebac3e0..aca0949bcb 100644
--- a/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/CommandPalette/CommandPaletteShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CommandPalette',
name: 'CommandPalette',
description: 'Basic command palette with static items and keyboard navigation.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/CommandPaletteFooter/CommandPaletteFooterShowcase.doc.mjs b/packages/cli/templates/blocks/components/CommandPaletteFooter/CommandPaletteFooterShowcase.doc.mjs
index 35f3cdcd62..45b5f08573 100644
--- a/packages/cli/templates/blocks/components/CommandPaletteFooter/CommandPaletteFooterShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/CommandPaletteFooter/CommandPaletteFooterShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CommandPaletteFooter',
name: 'CommandPaletteFooter',
description: 'Command palette footer with custom tip content.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/CommandPaletteGroup/CommandPaletteGroupShowcase.doc.mjs b/packages/cli/templates/blocks/components/CommandPaletteGroup/CommandPaletteGroupShowcase.doc.mjs
index f1d2192f70..a1a084fd93 100644
--- a/packages/cli/templates/blocks/components/CommandPaletteGroup/CommandPaletteGroupShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/CommandPaletteGroup/CommandPaletteGroupShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CommandPaletteGroup',
name: 'CommandPaletteGroup',
description: 'Command palette groups in both data-driven (auxiliaryData.group) and composed (XDSCommandPaletteGroup + XDSCommandPaletteItem) forms.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/CommandPaletteItem/CommandPaletteItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/CommandPaletteItem/CommandPaletteItemShowcase.doc.mjs
index 8d028e85e9..0af7f22202 100644
--- a/packages/cli/templates/blocks/components/CommandPaletteItem/CommandPaletteItemShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/CommandPaletteItem/CommandPaletteItemShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'CommandPaletteItem',
name: 'CommandPaletteItem',
description: 'Command palette items with custom content via renderItem and as composed XDSCommandPaletteItem with icons, highlighted, selected, and disabled states.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/DateInput/DateInputClearable.doc.mjs b/packages/cli/templates/blocks/components/DateInput/DateInputClearable.doc.mjs
index edb1092974..ca04891c4b 100644
--- a/packages/cli/templates/blocks/components/DateInput/DateInputClearable.doc.mjs
+++ b/packages/cli/templates/blocks/components/DateInput/DateInputClearable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'DateInput',
name: 'DateInput — Clearable',
description:
'Date input with a clear button that resets the value. Use when the date field is optional and the user may need to undo their selection.',
diff --git a/packages/cli/templates/blocks/components/DateInput/DateInputDateRange.doc.mjs b/packages/cli/templates/blocks/components/DateInput/DateInputDateRange.doc.mjs
index 7b143412c7..a484deba93 100644
--- a/packages/cli/templates/blocks/components/DateInput/DateInputDateRange.doc.mjs
+++ b/packages/cli/templates/blocks/components/DateInput/DateInputDateRange.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'DateInput',
name: 'DateInput — Date Range',
description:
'Date input constrained to a min/max window. Use when only certain dates are valid, like booking availability or a fiscal quarter.',
diff --git a/packages/cli/templates/blocks/components/DateInput/DateInputShowcase.doc.mjs b/packages/cli/templates/blocks/components/DateInput/DateInputShowcase.doc.mjs
index feb73fa62e..4329dee473 100644
--- a/packages/cli/templates/blocks/components/DateInput/DateInputShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/DateInput/DateInputShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'DateInput',
name: 'DateInput',
description:
'A date input field with a calendar popover. Type a date or click the calendar icon to pick one.',
diff --git a/packages/cli/templates/blocks/components/DateInput/DateInputWithDescription.doc.mjs b/packages/cli/templates/blocks/components/DateInput/DateInputWithDescription.doc.mjs
index 0d36e80278..b1f4bb9c54 100644
--- a/packages/cli/templates/blocks/components/DateInput/DateInputWithDescription.doc.mjs
+++ b/packages/cli/templates/blocks/components/DateInput/DateInputWithDescription.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'DateInput',
name: 'DateInput — Description',
description:
'Date input with helper text below the label explaining what the field expects. Use when the purpose of the date is not obvious from the label alone.',
diff --git a/packages/cli/templates/blocks/components/DateInput/DateInputWithValidation.doc.mjs b/packages/cli/templates/blocks/components/DateInput/DateInputWithValidation.doc.mjs
index eaaa669ef6..33e25542dd 100644
--- a/packages/cli/templates/blocks/components/DateInput/DateInputWithValidation.doc.mjs
+++ b/packages/cli/templates/blocks/components/DateInput/DateInputWithValidation.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'DateInput',
name: 'DateInput — Validation',
description:
'Date input in all three status states: error, warning, and success. Use to surface validation issues, caution the user, or confirm a valid selection.',
diff --git a/packages/cli/templates/blocks/components/Dialog/DialogConfirmationDialog.doc.mjs b/packages/cli/templates/blocks/components/Dialog/DialogConfirmationDialog.doc.mjs
index 5f9ce2ca51..48e2818ec7 100644
--- a/packages/cli/templates/blocks/components/Dialog/DialogConfirmationDialog.doc.mjs
+++ b/packages/cli/templates/blocks/components/Dialog/DialogConfirmationDialog.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Dialog',
name: 'Dialog — Confirmation',
description:
'Asks the user to confirm a destructive action before it happens. Use before deleting projects, removing team members, revoking API keys, or any irreversible operation.',
diff --git a/packages/cli/templates/blocks/components/Dialog/DialogFormDialog.doc.mjs b/packages/cli/templates/blocks/components/Dialog/DialogFormDialog.doc.mjs
index 5d4e0ba52f..823cf2da3e 100644
--- a/packages/cli/templates/blocks/components/Dialog/DialogFormDialog.doc.mjs
+++ b/packages/cli/templates/blocks/components/Dialog/DialogFormDialog.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Dialog',
name: 'Dialog — Form',
description:
'Collects user input without navigating away from the page. Uses purpose="form" so clicking the backdrop won\'t close it. Use for editing profiles, creating items, or updating settings inline.',
diff --git a/packages/cli/templates/blocks/components/Dialog/DialogFullscreenDialog.doc.mjs b/packages/cli/templates/blocks/components/Dialog/DialogFullscreenDialog.doc.mjs
index 892440af18..edf0dfd27b 100644
--- a/packages/cli/templates/blocks/components/Dialog/DialogFullscreenDialog.doc.mjs
+++ b/packages/cli/templates/blocks/components/Dialog/DialogFullscreenDialog.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Dialog',
name: 'Dialog — Fullscreen',
description:
'Takes over the entire viewport for content that needs maximum space. Use for documentation viewers, rich text editors, multi-step wizards, or media previews where the standard dialog width is too narrow.',
diff --git a/packages/cli/templates/blocks/components/Dialog/DialogScrollingContent.doc.mjs b/packages/cli/templates/blocks/components/Dialog/DialogScrollingContent.doc.mjs
index c3f4999d73..564ea6eb66 100644
--- a/packages/cli/templates/blocks/components/Dialog/DialogScrollingContent.doc.mjs
+++ b/packages/cli/templates/blocks/components/Dialog/DialogScrollingContent.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Dialog',
name: 'Dialog — Scrollable',
description:
'Constrains the dialog height and scrolls the body when content overflows. Use for terms and conditions, license agreements, changelogs, or any long-form content the user needs to review before accepting.',
diff --git a/packages/cli/templates/blocks/components/Dialog/DialogShowcase.doc.mjs b/packages/cli/templates/blocks/components/Dialog/DialogShowcase.doc.mjs
index fd90fd0935..b801a90f2d 100644
--- a/packages/cli/templates/blocks/components/Dialog/DialogShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Dialog/DialogShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Dialog',
name: 'Dialog',
description:
'Modal dialog with a header, body content, and close button.',
diff --git a/packages/cli/templates/blocks/components/Dialog/DialogWithSubtitle.doc.mjs b/packages/cli/templates/blocks/components/Dialog/DialogWithSubtitle.doc.mjs
index a445c6d2b7..d343ef8585 100644
--- a/packages/cli/templates/blocks/components/Dialog/DialogWithSubtitle.doc.mjs
+++ b/packages/cli/templates/blocks/components/Dialog/DialogWithSubtitle.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Dialog',
name: 'Dialog — Required',
description:
'Cannot be dismissed by Escape or backdrop click — the user must explicitly choose an action. Uses purpose="required". Use for ownership transfers, legal acknowledgements, or critical decisions where skipping is not an option.',
diff --git a/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.doc.mjs b/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.doc.mjs
index 35dd347a03..35e8908bac 100644
--- a/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'DialogHeader',
name: 'DialogHeader',
description:
'DialogHeader provides a structured header for dialogs with slots for title, subtitle, close button, and optional start or end content.',
diff --git a/packages/cli/templates/blocks/components/Divider/DividerFullBleed.doc.mjs b/packages/cli/templates/blocks/components/Divider/DividerFullBleed.doc.mjs
index a27129af84..ce538fc9ad 100644
--- a/packages/cli/templates/blocks/components/Divider/DividerFullBleed.doc.mjs
+++ b/packages/cli/templates/blocks/components/Divider/DividerFullBleed.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Divider',
name: 'Divider — Full Bleed',
description:
'Divider that extends past container padding to span the full width. Use inside cards or panels when you want a clean edge-to-edge separation, like between an order summary and total.',
diff --git a/packages/cli/templates/blocks/components/Divider/DividerShowcase.doc.mjs b/packages/cli/templates/blocks/components/Divider/DividerShowcase.doc.mjs
index 4950c0ef20..b9819fb272 100644
--- a/packages/cli/templates/blocks/components/Divider/DividerShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Divider/DividerShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Divider',
name: 'Divider — Variants',
description:
'Horizontal dividers in subtle and strong variants, plus a labeled divider. A quick visual reference for separator styles.',
diff --git a/packages/cli/templates/blocks/components/Divider/DividerVariants.doc.mjs b/packages/cli/templates/blocks/components/Divider/DividerVariants.doc.mjs
index c4b2a3e013..5d24920377 100644
--- a/packages/cli/templates/blocks/components/Divider/DividerVariants.doc.mjs
+++ b/packages/cli/templates/blocks/components/Divider/DividerVariants.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Divider',
name: 'Divider — Variants',
description:
'Subtle, labeled, and strong dividers in a single card. Use subtle between related sections, labeled for alternatives like "or", and strong for high-contrast boundaries.',
diff --git a/packages/cli/templates/blocks/components/Divider/DividerVertical.doc.mjs b/packages/cli/templates/blocks/components/Divider/DividerVertical.doc.mjs
index 628694bea6..f547b4b3a2 100644
--- a/packages/cli/templates/blocks/components/Divider/DividerVertical.doc.mjs
+++ b/packages/cli/templates/blocks/components/Divider/DividerVertical.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Divider',
name: 'Divider — Vertical',
description:
'Vertical dividers separating side-by-side metrics. Use between stat cards, toolbar groups, or any horizontal layout where you need a visual boundary between sections.',
diff --git a/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuActions.doc.mjs b/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuActions.doc.mjs
index 1c7729c790..5eb2d93138 100644
--- a/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuActions.doc.mjs
+++ b/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuActions.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'DropdownMenu',
name: 'DropdownMenu — Actions',
description:
'Action menu with dividers separating safe and destructive operations. Use for row-level actions on items like documents, projects, or records.',
diff --git a/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuNoChevron.doc.mjs b/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuNoChevron.doc.mjs
index 2cb8cc5f69..a77f980c86 100644
--- a/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuNoChevron.doc.mjs
+++ b/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuNoChevron.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'DropdownMenu',
name: 'DropdownMenu — Icon Trigger',
description:
'Overflow menu triggered by an icon-only button with no chevron or label text. Use for row-level actions in tables, cards, or lists where a text button would take too much space.',
diff --git a/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuShowcase.doc.mjs b/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuShowcase.doc.mjs
index 02d085ca77..468da5dd9e 100644
--- a/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'DropdownMenu',
name: 'DropdownMenu',
description:
'A button that opens a dropdown menu with action items. The menu starts open for preview.',
diff --git a/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuWithDisabledItems.doc.mjs b/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuWithDisabledItems.doc.mjs
index 72d902514a..28b8fd7a5d 100644
--- a/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuWithDisabledItems.doc.mjs
+++ b/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuWithDisabledItems.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'DropdownMenu',
name: 'DropdownMenu — Disabled',
description:
'Menu with selectively disabled items based on permissions. Use when some actions require higher privileges, like admin-only operations.',
diff --git a/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuWithSections.doc.mjs b/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuWithSections.doc.mjs
index 9f571bbcfc..bf4654b921 100644
--- a/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuWithSections.doc.mjs
+++ b/packages/cli/templates/blocks/components/DropdownMenu/DropdownMenuWithSections.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'DropdownMenu',
name: 'DropdownMenu — Sections',
description:
'Menu items organized into titled sections for easy scanning. Use when you have 6+ actions that fall into distinct categories, like Create vs Manage.',
diff --git a/packages/cli/templates/blocks/components/DropdownMenuItem/DropdownMenuItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/DropdownMenuItem/DropdownMenuItemShowcase.doc.mjs
index ed229bda93..cb5641b94a 100644
--- a/packages/cli/templates/blocks/components/DropdownMenuItem/DropdownMenuItemShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/DropdownMenuItem/DropdownMenuItemShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'DropdownMenuItem',
name: 'DropdownMenuItem',
description:
'Dropdown menu with custom-rendered items using XDSDropdownMenuItem for icons and descriptions.',
diff --git a/packages/cli/templates/blocks/components/EmptyState/EmptyStateActions.doc.mjs b/packages/cli/templates/blocks/components/EmptyState/EmptyStateActions.doc.mjs
index 797182e242..0500598d78 100644
--- a/packages/cli/templates/blocks/components/EmptyState/EmptyStateActions.doc.mjs
+++ b/packages/cli/templates/blocks/components/EmptyState/EmptyStateActions.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'EmptyState',
name: 'EmptyState — Actions',
description:
'Full empty state with icon, message, and action buttons. Use when a search returns no results, a filter clears all items, or a list has been emptied. The buttons give the user a way forward — go back, clear filters, or try a different query.',
diff --git a/packages/cli/templates/blocks/components/EmptyState/EmptyStateCompact.doc.mjs b/packages/cli/templates/blocks/components/EmptyState/EmptyStateCompact.doc.mjs
index 175e6bcb30..72fea1b396 100644
--- a/packages/cli/templates/blocks/components/EmptyState/EmptyStateCompact.doc.mjs
+++ b/packages/cli/templates/blocks/components/EmptyState/EmptyStateCompact.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'EmptyState',
name: 'EmptyState — Compact',
description:
'Smaller empty state with reduced spacing for constrained areas. Use inside sidebar panels, card widgets, or notification drawers where a full-size empty state would overwhelm the layout.',
diff --git a/packages/cli/templates/blocks/components/EmptyState/EmptyStateContainer.doc.mjs b/packages/cli/templates/blocks/components/EmptyState/EmptyStateContainer.doc.mjs
index 8f215f46a5..0d55edd549 100644
--- a/packages/cli/templates/blocks/components/EmptyState/EmptyStateContainer.doc.mjs
+++ b/packages/cli/templates/blocks/components/EmptyState/EmptyStateContainer.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'EmptyState',
name: 'EmptyState — Container',
description:
'Empty state wrapped in a Card for first-time setup or onboarding. Use when the user has not created any items yet — like a project list, team roster, or dashboard widget that will fill with data once they take action.',
diff --git a/packages/cli/templates/blocks/components/EmptyState/EmptyStateShowcase.doc.mjs b/packages/cli/templates/blocks/components/EmptyState/EmptyStateShowcase.doc.mjs
index fec9d0c4c7..a1a343dd2f 100644
--- a/packages/cli/templates/blocks/components/EmptyState/EmptyStateShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/EmptyState/EmptyStateShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'EmptyState',
name: 'EmptyState',
description:
'A no-results empty state with an icon, descriptive message, and a call-to-action button.',
diff --git a/packages/cli/templates/blocks/components/Field/FieldRequired.doc.mjs b/packages/cli/templates/blocks/components/Field/FieldRequired.doc.mjs
index c53672b466..3cc4e1af00 100644
--- a/packages/cli/templates/blocks/components/Field/FieldRequired.doc.mjs
+++ b/packages/cli/templates/blocks/components/Field/FieldRequired.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Field',
name: 'Field — Required & Optional',
description:
'Required and optional field indicators side by side. Use isRequired on fields the user must fill in, and isOptional to clarify which fields can be skipped.',
diff --git a/packages/cli/templates/blocks/components/Field/FieldShowcase.doc.mjs b/packages/cli/templates/blocks/components/Field/FieldShowcase.doc.mjs
index 6df89ccf1c..f5698ff8f0 100644
--- a/packages/cli/templates/blocks/components/Field/FieldShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Field/FieldShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Field',
name: 'Field',
description:
'A form field wrapping a text input with a label, description, and validation status.',
diff --git a/packages/cli/templates/blocks/components/Field/FieldStatusVariants.doc.mjs b/packages/cli/templates/blocks/components/Field/FieldStatusVariants.doc.mjs
index 1ec99b3a93..c230411cf1 100644
--- a/packages/cli/templates/blocks/components/Field/FieldStatusVariants.doc.mjs
+++ b/packages/cli/templates/blocks/components/Field/FieldStatusVariants.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Field',
name: 'Field — Validation States',
description:
'All three validation states: error, warning, and success. Use error for invalid input, warning for potential issues like reserved names, and success to confirm valid entries like API keys.',
diff --git a/packages/cli/templates/blocks/components/Field/FieldWithDescription.doc.mjs b/packages/cli/templates/blocks/components/Field/FieldWithDescription.doc.mjs
index 593a3be464..84587a4f57 100644
--- a/packages/cli/templates/blocks/components/Field/FieldWithDescription.doc.mjs
+++ b/packages/cli/templates/blocks/components/Field/FieldWithDescription.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Field',
name: 'Field — Description',
description:
'Fields with helper text below the label. Use descriptions to explain format requirements, constraints, or what happens with the data — like "At least 8 characters" or "We will send a confirmation link".',
diff --git a/packages/cli/templates/blocks/components/FieldLabel/FieldLabelShowcase.doc.mjs b/packages/cli/templates/blocks/components/FieldLabel/FieldLabelShowcase.doc.mjs
index 48846a61fd..5b6e5074d1 100644
--- a/packages/cli/templates/blocks/components/FieldLabel/FieldLabelShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/FieldLabel/FieldLabelShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'FieldLabel',
name: 'FieldLabel',
description:
'Standalone field labels demonstrating required, optional, tooltip, and icon variations.',
diff --git a/packages/cli/templates/blocks/components/FieldStatus/FieldStatusShowcase.doc.mjs b/packages/cli/templates/blocks/components/FieldStatus/FieldStatusShowcase.doc.mjs
index 85d0a5e789..06483a9d9b 100644
--- a/packages/cli/templates/blocks/components/FieldStatus/FieldStatusShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/FieldStatus/FieldStatusShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'FieldStatus',
name: 'FieldStatus',
description:
'Field status messages in error, warning, and success states with attached and detached variants.',
diff --git a/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontal.doc.mjs b/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontal.doc.mjs
index 49fad1557f..4d6b2d21f0 100644
--- a/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontal.doc.mjs
+++ b/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontal.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'FormLayout',
name: 'FormLayout — Horizontal',
description: 'Two fields side by side for naturally paired inputs like first and last name',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontalLabels.doc.mjs b/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontalLabels.doc.mjs
index d000bc920e..b5fdc2d2b3 100644
--- a/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontalLabels.doc.mjs
+++ b/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontalLabels.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'FormLayout',
name: 'FormLayout — Settings Form',
description: 'Settings form with labels placed beside their inputs',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/FormLayout/FormLayoutMixedControls.doc.mjs b/packages/cli/templates/blocks/components/FormLayout/FormLayoutMixedControls.doc.mjs
index 2ff1b6b075..109574064a 100644
--- a/packages/cli/templates/blocks/components/FormLayout/FormLayoutMixedControls.doc.mjs
+++ b/packages/cli/templates/blocks/components/FormLayout/FormLayoutMixedControls.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'FormLayout',
name: 'FormLayout — Mixed Controls',
description: 'Form with different control types — text input, selector, and checkboxes',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/FormLayout/FormLayoutNested.doc.mjs b/packages/cli/templates/blocks/components/FormLayout/FormLayoutNested.doc.mjs
index e7a6a6436e..2e5d2fbfe9 100644
--- a/packages/cli/templates/blocks/components/FormLayout/FormLayoutNested.doc.mjs
+++ b/packages/cli/templates/blocks/components/FormLayout/FormLayoutNested.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'FormLayout',
name: 'FormLayout — Nested Address Form',
description: 'Address form mixing vertical and horizontal layouts for grouped fields',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/FormLayout/FormLayoutShowcase.doc.mjs b/packages/cli/templates/blocks/components/FormLayout/FormLayoutShowcase.doc.mjs
index 38f70e384b..22be5e66be 100644
--- a/packages/cli/templates/blocks/components/FormLayout/FormLayoutShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/FormLayout/FormLayoutShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'FormLayout',
name: 'FormLayout',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/Grid/GridDashboardLayout.doc.mjs b/packages/cli/templates/blocks/components/Grid/GridDashboardLayout.doc.mjs
index 52eb14dd48..3b18642f74 100644
--- a/packages/cli/templates/blocks/components/Grid/GridDashboardLayout.doc.mjs
+++ b/packages/cli/templates/blocks/components/Grid/GridDashboardLayout.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Grid',
name: 'Grid — Dashboard Layout',
description: 'Dashboard layout with mixed-size widgets and a full-width summary row',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Grid/GridGalleryExample.doc.mjs b/packages/cli/templates/blocks/components/Grid/GridGalleryExample.doc.mjs
index 7522da8bb0..5b1edda56c 100644
--- a/packages/cli/templates/blocks/components/Grid/GridGalleryExample.doc.mjs
+++ b/packages/cli/templates/blocks/components/Grid/GridGalleryExample.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Grid',
name: 'Grid — Card Gallery',
description: 'Card gallery with responsive columns that maintain consistent widths',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Grid/GridResponsiveAutoFit.doc.mjs b/packages/cli/templates/blocks/components/Grid/GridResponsiveAutoFit.doc.mjs
index 51eb3b4fe5..44696854ef 100644
--- a/packages/cli/templates/blocks/components/Grid/GridResponsiveAutoFit.doc.mjs
+++ b/packages/cli/templates/blocks/components/Grid/GridResponsiveAutoFit.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Grid',
name: 'Grid — Responsive Auto-Fit',
description: 'Responsive grid where cards stretch to fill remaining space',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Grid/GridShowcase.doc.mjs b/packages/cli/templates/blocks/components/Grid/GridShowcase.doc.mjs
index 32bb3594d1..6115ea47e8 100644
--- a/packages/cli/templates/blocks/components/Grid/GridShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Grid/GridShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Grid',
name: 'Grid',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/Grid/GridWithGridSpan.doc.mjs b/packages/cli/templates/blocks/components/Grid/GridWithGridSpan.doc.mjs
index 17e2f527de..eac6925685 100644
--- a/packages/cli/templates/blocks/components/Grid/GridWithGridSpan.doc.mjs
+++ b/packages/cli/templates/blocks/components/Grid/GridWithGridSpan.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Grid',
name: 'Grid — Column Spanning',
description: 'Grid with featured items spanning two, three, and all columns',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.doc.mjs b/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.doc.mjs
index 24b7e84287..883c77b6bc 100644
--- a/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'GridSpan',
name: 'GridSpan',
description:
'GridSpan lets a grid item span multiple columns or rows within an XDSGrid, enabling masonry-style and asymmetric layouts.',
diff --git a/packages/cli/templates/blocks/components/HStack/HStackShowcase.doc.mjs b/packages/cli/templates/blocks/components/HStack/HStackShowcase.doc.mjs
index 22124879f7..93d426b686 100644
--- a/packages/cli/templates/blocks/components/HStack/HStackShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/HStack/HStackShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'HStack',
name: 'HStack',
description: 'Demonstrates XDSHStack arranging items horizontally with different gaps and alignments.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Heading/HeadingCardGrid.doc.mjs b/packages/cli/templates/blocks/components/Heading/HeadingCardGrid.doc.mjs
index e5927d64b8..436b691c88 100644
--- a/packages/cli/templates/blocks/components/Heading/HeadingCardGrid.doc.mjs
+++ b/packages/cli/templates/blocks/components/Heading/HeadingCardGrid.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Heading',
name: 'Heading — Card Grid',
description:
'Responsive card grid with truncated headings and descriptions for uniform layout',
diff --git a/packages/cli/templates/blocks/components/Heading/HeadingPageLayout.doc.mjs b/packages/cli/templates/blocks/components/Heading/HeadingPageLayout.doc.mjs
index 3263f9d929..60323b6445 100644
--- a/packages/cli/templates/blocks/components/Heading/HeadingPageLayout.doc.mjs
+++ b/packages/cli/templates/blocks/components/Heading/HeadingPageLayout.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Heading',
name: 'Heading — Page Hierarchy',
description:
'Real-world page layout demonstrating heading levels h1 through h3 with supporting text',
diff --git a/packages/cli/templates/blocks/components/Heading/HeadingShowcase.doc.mjs b/packages/cli/templates/blocks/components/Heading/HeadingShowcase.doc.mjs
index cab602a530..2eedc70161 100644
--- a/packages/cli/templates/blocks/components/Heading/HeadingShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Heading/HeadingShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Heading',
name: 'Heading',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/Heading/HeadingTruncation.doc.mjs b/packages/cli/templates/blocks/components/Heading/HeadingTruncation.doc.mjs
index ede85974a2..eb688e9340 100644
--- a/packages/cli/templates/blocks/components/Heading/HeadingTruncation.doc.mjs
+++ b/packages/cli/templates/blocks/components/Heading/HeadingTruncation.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Heading',
name: 'Heading — Truncation',
description:
'Single-line and multi-line heading truncation with ellipsis for constrained layouts',
diff --git a/packages/cli/templates/blocks/components/HoverCard/HoverCardInlineTextHoverCard.doc.mjs b/packages/cli/templates/blocks/components/HoverCard/HoverCardInlineTextHoverCard.doc.mjs
index 5e64b00210..fce2c28c61 100644
--- a/packages/cli/templates/blocks/components/HoverCard/HoverCardInlineTextHoverCard.doc.mjs
+++ b/packages/cli/templates/blocks/components/HoverCard/HoverCardInlineTextHoverCard.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'HoverCard',
name: 'HoverCard — Definition',
description:
'Shows a term definition on hover within a paragraph. Use for technical terms, jargon, or concepts that some readers may not know — like a glossary built into the text.',
diff --git a/packages/cli/templates/blocks/components/HoverCard/HoverCardInteractiveContent.doc.mjs b/packages/cli/templates/blocks/components/HoverCard/HoverCardInteractiveContent.doc.mjs
index b66bf69a65..22fd79e178 100644
--- a/packages/cli/templates/blocks/components/HoverCard/HoverCardInteractiveContent.doc.mjs
+++ b/packages/cli/templates/blocks/components/HoverCard/HoverCardInteractiveContent.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'HoverCard',
name: 'HoverCard — Link Preview',
description:
'Shows a page summary when hovering a link — title, description, and URL. Use for documentation links, article references, or any URL where a preview helps the user decide whether to click.',
diff --git a/packages/cli/templates/blocks/components/HoverCard/HoverCardProfileHoverCard.doc.mjs b/packages/cli/templates/blocks/components/HoverCard/HoverCardProfileHoverCard.doc.mjs
index b39346da72..7191cdb713 100644
--- a/packages/cli/templates/blocks/components/HoverCard/HoverCardProfileHoverCard.doc.mjs
+++ b/packages/cli/templates/blocks/components/HoverCard/HoverCardProfileHoverCard.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'HoverCard',
name: 'HoverCard — Profile Preview',
description:
'Shows a user profile summary on hover with name, role, and bio. Use on usernames, avatars, or mentions to let users preview a profile without navigating away.',
diff --git a/packages/cli/templates/blocks/components/HoverCard/HoverCardShowcase.doc.mjs b/packages/cli/templates/blocks/components/HoverCard/HoverCardShowcase.doc.mjs
index adfa89f3bb..0d1582a524 100644
--- a/packages/cli/templates/blocks/components/HoverCard/HoverCardShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/HoverCard/HoverCardShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'HoverCard',
name: 'HoverCard',
description:
'A hover card that shows a user profile preview when hovering over a trigger button. Starts open for preview.',
diff --git a/packages/cli/templates/blocks/components/Icon/IconNonSemanticColors.doc.mjs b/packages/cli/templates/blocks/components/Icon/IconNonSemanticColors.doc.mjs
index 360b5c9246..b125c73bef 100644
--- a/packages/cli/templates/blocks/components/Icon/IconNonSemanticColors.doc.mjs
+++ b/packages/cli/templates/blocks/components/Icon/IconNonSemanticColors.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Icon',
name: 'Icon — Non-Semantic Colors',
description:
'Non-semantic color palette for icons.',
diff --git a/packages/cli/templates/blocks/components/Icon/IconSemanticColors.doc.mjs b/packages/cli/templates/blocks/components/Icon/IconSemanticColors.doc.mjs
index ca6bc8df4b..48d0193619 100644
--- a/packages/cli/templates/blocks/components/Icon/IconSemanticColors.doc.mjs
+++ b/packages/cli/templates/blocks/components/Icon/IconSemanticColors.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Icon',
name: 'Icon — Semantic Colors',
description:
'All semantic icon color variants with labels.',
diff --git a/packages/cli/templates/blocks/components/Icon/IconShowcase.doc.mjs b/packages/cli/templates/blocks/components/Icon/IconShowcase.doc.mjs
index 0be023538f..b94be9651b 100644
--- a/packages/cli/templates/blocks/components/Icon/IconShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Icon/IconShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Icon',
name: 'Icon',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/Icon/IconSizes.doc.mjs b/packages/cli/templates/blocks/components/Icon/IconSizes.doc.mjs
index d5a2ccd3e2..6428c69f85 100644
--- a/packages/cli/templates/blocks/components/Icon/IconSizes.doc.mjs
+++ b/packages/cli/templates/blocks/components/Icon/IconSizes.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Icon',
name: 'Icon — Size Variants',
description:
'All icon sizes from extra-small to large.',
diff --git a/packages/cli/templates/blocks/components/Icon/IconStatusIcons.doc.mjs b/packages/cli/templates/blocks/components/Icon/IconStatusIcons.doc.mjs
index 045da7ba8c..cf84f90510 100644
--- a/packages/cli/templates/blocks/components/Icon/IconStatusIcons.doc.mjs
+++ b/packages/cli/templates/blocks/components/Icon/IconStatusIcons.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Icon',
name: 'Icon — Status Indicators',
description:
'Status list using semantic icons for success, warning, error, and info.',
diff --git a/packages/cli/templates/blocks/components/IconButton/IconButtonActionBar.doc.mjs b/packages/cli/templates/blocks/components/IconButton/IconButtonActionBar.doc.mjs
index 0e2da0b94a..5069277fd6 100644
--- a/packages/cli/templates/blocks/components/IconButton/IconButtonActionBar.doc.mjs
+++ b/packages/cli/templates/blocks/components/IconButton/IconButtonActionBar.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'IconButton',
name: 'IconButton — Action Bar',
description: 'Row of ghost icon buttons for a compact action toolbar',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/IconButton/IconButtonLoadingToggle.doc.mjs b/packages/cli/templates/blocks/components/IconButton/IconButtonLoadingToggle.doc.mjs
index 612449307d..0d1b7a8900 100644
--- a/packages/cli/templates/blocks/components/IconButton/IconButtonLoadingToggle.doc.mjs
+++ b/packages/cli/templates/blocks/components/IconButton/IconButtonLoadingToggle.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'IconButton',
name: 'IconButton — Loading State',
description: 'Icon buttons that show a loading spinner on click for async feedback',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/IconButton/IconButtonShowcase.doc.mjs b/packages/cli/templates/blocks/components/IconButton/IconButtonShowcase.doc.mjs
index 3ed46cc196..4aaea986d0 100644
--- a/packages/cli/templates/blocks/components/IconButton/IconButtonShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/IconButton/IconButtonShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'IconButton',
name: 'IconButton',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/IconButton/IconButtonTooltipIconButton.doc.mjs b/packages/cli/templates/blocks/components/IconButton/IconButtonTooltipIconButton.doc.mjs
index 209607d683..e29a32462c 100644
--- a/packages/cli/templates/blocks/components/IconButton/IconButtonTooltipIconButton.doc.mjs
+++ b/packages/cli/templates/blocks/components/IconButton/IconButtonTooltipIconButton.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'IconButton',
name: 'IconButton — With Tooltips',
description: 'Icon buttons with tooltips that explain each action on hover',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Kbd/KbdInlineInstructions.doc.mjs b/packages/cli/templates/blocks/components/Kbd/KbdInlineInstructions.doc.mjs
index 37970a9f4b..01d40710b1 100644
--- a/packages/cli/templates/blocks/components/Kbd/KbdInlineInstructions.doc.mjs
+++ b/packages/cli/templates/blocks/components/Kbd/KbdInlineInstructions.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Kbd',
name: 'Kbd — Inline Instructions',
description: 'Keyboard shortcuts rendered inline within instructional text',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Kbd/KbdMenuShortcuts.doc.mjs b/packages/cli/templates/blocks/components/Kbd/KbdMenuShortcuts.doc.mjs
index c444fa3c23..ab454b938d 100644
--- a/packages/cli/templates/blocks/components/Kbd/KbdMenuShortcuts.doc.mjs
+++ b/packages/cli/templates/blocks/components/Kbd/KbdMenuShortcuts.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Kbd',
name: 'Kbd — Menu Shortcuts',
description: 'Menu-style list pairing action labels with their keyboard shortcuts',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Kbd/KbdModifierCombos.doc.mjs b/packages/cli/templates/blocks/components/Kbd/KbdModifierCombos.doc.mjs
index 88c05efd99..09f73d5993 100644
--- a/packages/cli/templates/blocks/components/Kbd/KbdModifierCombos.doc.mjs
+++ b/packages/cli/templates/blocks/components/Kbd/KbdModifierCombos.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Kbd',
name: 'Kbd — Modifier Combinations',
description: 'Modifier combinations and special keys rendered as shortcut badges',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Kbd/KbdShowcase.doc.mjs b/packages/cli/templates/blocks/components/Kbd/KbdShowcase.doc.mjs
index 0666ac137e..2e4c0d289c 100644
--- a/packages/cli/templates/blocks/components/Kbd/KbdShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Kbd/KbdShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Kbd',
name: 'Kbd',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/Layout/LayoutBasicCardLayout.doc.mjs b/packages/cli/templates/blocks/components/Layout/LayoutBasicCardLayout.doc.mjs
index d0f0f7fbd3..ea13dc3bfd 100644
--- a/packages/cli/templates/blocks/components/Layout/LayoutBasicCardLayout.doc.mjs
+++ b/packages/cli/templates/blocks/components/Layout/LayoutBasicCardLayout.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Layout',
name: 'Layout — Basic Card',
description:
'A card layout with header, scrollable content area, and footer with action buttons.',
diff --git a/packages/cli/templates/blocks/components/Layout/LayoutContentOnlyLayout.doc.mjs b/packages/cli/templates/blocks/components/Layout/LayoutContentOnlyLayout.doc.mjs
index c7a5405de2..a7317e6780 100644
--- a/packages/cli/templates/blocks/components/Layout/LayoutContentOnlyLayout.doc.mjs
+++ b/packages/cli/templates/blocks/components/Layout/LayoutContentOnlyLayout.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Layout',
name: 'Layout — Content Only',
description:
'A minimal layout with just a content area inside a card, without header or footer.',
diff --git a/packages/cli/templates/blocks/components/Layout/LayoutContentWidth.doc.mjs b/packages/cli/templates/blocks/components/Layout/LayoutContentWidth.doc.mjs
index a72f39c6c4..88e9057294 100644
--- a/packages/cli/templates/blocks/components/Layout/LayoutContentWidth.doc.mjs
+++ b/packages/cli/templates/blocks/components/Layout/LayoutContentWidth.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Layout',
name: 'Layout — Content Width',
description:
'A layout using contentWidth to constrain and center content while keeping dividers full-bleed.',
diff --git a/packages/cli/templates/blocks/components/Layout/LayoutDualPanelLayout.doc.mjs b/packages/cli/templates/blocks/components/Layout/LayoutDualPanelLayout.doc.mjs
index d0b064f674..7b3937ae18 100644
--- a/packages/cli/templates/blocks/components/Layout/LayoutDualPanelLayout.doc.mjs
+++ b/packages/cli/templates/blocks/components/Layout/LayoutDualPanelLayout.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Layout',
name: 'Layout — Dual Panel',
description:
'A file browser style layout with start panel for folders, main content for files, and end panel for details.',
diff --git a/packages/cli/templates/blocks/components/Layout/LayoutFullBleedContent.doc.mjs b/packages/cli/templates/blocks/components/Layout/LayoutFullBleedContent.doc.mjs
index f295a5ee00..9f9463659b 100644
--- a/packages/cli/templates/blocks/components/Layout/LayoutFullBleedContent.doc.mjs
+++ b/packages/cli/templates/blocks/components/Layout/LayoutFullBleedContent.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Layout',
name: 'Layout — Full Bleed Content',
description:
'A layout where content extends edge-to-edge with zero padding, ideal for tables or images.',
diff --git a/packages/cli/templates/blocks/components/Layout/LayoutShowcase.doc.mjs b/packages/cli/templates/blocks/components/Layout/LayoutShowcase.doc.mjs
index c3c38a837e..e48e8c69bc 100644
--- a/packages/cli/templates/blocks/components/Layout/LayoutShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Layout/LayoutShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Layout',
name: 'Layout',
isReady: true,
aspectRatio: 4 / 3,
diff --git a/packages/cli/templates/blocks/components/Layout/LayoutSidebarLayout.doc.mjs b/packages/cli/templates/blocks/components/Layout/LayoutSidebarLayout.doc.mjs
index 4afc6bc93f..824265c2ea 100644
--- a/packages/cli/templates/blocks/components/Layout/LayoutSidebarLayout.doc.mjs
+++ b/packages/cli/templates/blocks/components/Layout/LayoutSidebarLayout.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Layout',
name: 'Layout — Sidebar Navigation',
description:
'A settings page layout with a navigation sidebar panel, content area, header, and footer.',
diff --git a/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.doc.mjs b/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.doc.mjs
index 364ebc41ee..b07967318d 100644
--- a/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'LayoutContent',
name: 'LayoutContent',
description:
'LayoutContent is the scrollable main content area within a Layout, providing automatic padding and scroll containment between the header and footer.',
diff --git a/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.doc.mjs b/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.doc.mjs
index 9c34e389bf..2e440051ae 100644
--- a/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'LayoutFooter',
name: 'LayoutFooter',
description:
'LayoutFooter is a fixed footer slot within a Layout, pinned to the bottom for persistent actions like form buttons or navigation.',
diff --git a/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.doc.mjs b/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.doc.mjs
index a40713866e..fb794168e3 100644
--- a/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'LayoutHeader',
name: 'LayoutHeader',
description:
'LayoutHeader is a fixed header slot within a Layout, pinned to the top for titles, navigation, and action buttons.',
diff --git a/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.doc.mjs b/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.doc.mjs
index befbfb7ece..ac68b7b6dd 100644
--- a/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'LayoutPanel',
name: 'LayoutPanel',
description:
'LayoutPanel is a sidebar slot within a Layout, used for navigation, detail views, or secondary content alongside the main content area.',
diff --git a/packages/cli/templates/blocks/components/Link/LinkExternalLinks.doc.mjs b/packages/cli/templates/blocks/components/Link/LinkExternalLinks.doc.mjs
index 9d20894edb..44f0b15cfd 100644
--- a/packages/cli/templates/blocks/components/Link/LinkExternalLinks.doc.mjs
+++ b/packages/cli/templates/blocks/components/Link/LinkExternalLinks.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Link',
name: 'Link — External Links',
description:
'A vertical list of external links that open in a new tab with an indicator icon.',
diff --git a/packages/cli/templates/blocks/components/Link/LinkInlineLink.doc.mjs b/packages/cli/templates/blocks/components/Link/LinkInlineLink.doc.mjs
index 4f90f9f70f..6d28d2fe81 100644
--- a/packages/cli/templates/blocks/components/Link/LinkInlineLink.doc.mjs
+++ b/packages/cli/templates/blocks/components/Link/LinkInlineLink.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Link',
name: 'Link — Inline Text',
description: 'A link embedded within a paragraph of body text.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Link/LinkShowcase.doc.mjs b/packages/cli/templates/blocks/components/Link/LinkShowcase.doc.mjs
index 40b9c75225..993ca05247 100644
--- a/packages/cli/templates/blocks/components/Link/LinkShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Link/LinkShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Link',
name: 'Link',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/Link/LinksWithTooltips.doc.mjs b/packages/cli/templates/blocks/components/Link/LinksWithTooltips.doc.mjs
index 745c2408fa..44ea21d8be 100644
--- a/packages/cli/templates/blocks/components/Link/LinksWithTooltips.doc.mjs
+++ b/packages/cli/templates/blocks/components/Link/LinksWithTooltips.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Link',
name: 'Link — With Tooltips',
description:
'Horizontal row of standalone links with descriptive hover tooltips.',
diff --git a/packages/cli/templates/blocks/components/List/ListBasicList.doc.mjs b/packages/cli/templates/blocks/components/List/ListBasicList.doc.mjs
index 8018ebfe64..1022ededfb 100644
--- a/packages/cli/templates/blocks/components/List/ListBasicList.doc.mjs
+++ b/packages/cli/templates/blocks/components/List/ListBasicList.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'List',
name: 'List — Basic',
description: 'Simple list with labels and descriptions for settings-style layouts.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/List/ListBulletedFeatures.doc.mjs b/packages/cli/templates/blocks/components/List/ListBulletedFeatures.doc.mjs
index e1be5f6289..37c97c768e 100644
--- a/packages/cli/templates/blocks/components/List/ListBulletedFeatures.doc.mjs
+++ b/packages/cli/templates/blocks/components/List/ListBulletedFeatures.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'List',
name: 'List — Bulleted Features',
description: 'Bulleted list of feature highlights using disc markers.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/List/ListMessageList.doc.mjs b/packages/cli/templates/blocks/components/List/ListMessageList.doc.mjs
index 5e3bc0a8a4..aa23483925 100644
--- a/packages/cli/templates/blocks/components/List/ListMessageList.doc.mjs
+++ b/packages/cli/templates/blocks/components/List/ListMessageList.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'List',
name: 'List — Message List',
description:
'Chat-style message list with avatars, preview text, and unread badges.',
diff --git a/packages/cli/templates/blocks/components/List/ListOrderedSteps.doc.mjs b/packages/cli/templates/blocks/components/List/ListOrderedSteps.doc.mjs
index e4fc30125e..91a0fb871f 100644
--- a/packages/cli/templates/blocks/components/List/ListOrderedSteps.doc.mjs
+++ b/packages/cli/templates/blocks/components/List/ListOrderedSteps.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'List',
name: 'List — Ordered Steps',
description: 'Numbered step-by-step instructions using decimal list markers.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/List/ListShowcase.doc.mjs b/packages/cli/templates/blocks/components/List/ListShowcase.doc.mjs
index 59ac14e2f0..32540f29b6 100644
--- a/packages/cli/templates/blocks/components/List/ListShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/List/ListShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'List',
name: 'List',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/ListItem/ListItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/ListItem/ListItemShowcase.doc.mjs
index 6fe18ecea0..bb315bcbab 100644
--- a/packages/cli/templates/blocks/components/ListItem/ListItemShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ListItem/ListItemShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ListItem',
name: 'ListItem',
description:
'List items with icons, descriptions, and end content slots demonstrating the full ListItem API.',
diff --git a/packages/cli/templates/blocks/components/Markdown/MarkdownCitedContent.doc.mjs b/packages/cli/templates/blocks/components/Markdown/MarkdownCitedContent.doc.mjs
index d24f5fed47..733c816d75 100644
--- a/packages/cli/templates/blocks/components/Markdown/MarkdownCitedContent.doc.mjs
+++ b/packages/cli/templates/blocks/components/Markdown/MarkdownCitedContent.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Markdown',
name: 'Markdown — Cited Content',
description: 'Markdown with citation chips linked to external sources',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Markdown/MarkdownCompactAIResponse.doc.mjs b/packages/cli/templates/blocks/components/Markdown/MarkdownCompactAIResponse.doc.mjs
index 40b99f1463..227a7817b2 100644
--- a/packages/cli/templates/blocks/components/Markdown/MarkdownCompactAIResponse.doc.mjs
+++ b/packages/cli/templates/blocks/components/Markdown/MarkdownCompactAIResponse.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Markdown',
name: 'Markdown — Compact AI Response',
description: 'Compact markdown styled for AI responses with shifted heading levels',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Markdown/MarkdownDataTable.doc.mjs b/packages/cli/templates/blocks/components/Markdown/MarkdownDataTable.doc.mjs
index 2f62b36f78..9a7015bd06 100644
--- a/packages/cli/templates/blocks/components/Markdown/MarkdownDataTable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Markdown/MarkdownDataTable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Markdown',
name: 'Markdown — Data Table',
description: 'Comparison table rendered from a markdown string',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Markdown/MarkdownRichContent.doc.mjs b/packages/cli/templates/blocks/components/Markdown/MarkdownRichContent.doc.mjs
index 6742ab9a98..ac9d9e14ef 100644
--- a/packages/cli/templates/blocks/components/Markdown/MarkdownRichContent.doc.mjs
+++ b/packages/cli/templates/blocks/components/Markdown/MarkdownRichContent.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Markdown',
name: 'Markdown — Rich Content',
description: 'Markdown with headings, lists, code blocks, tables, blockquotes, and task lists',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Markdown/MarkdownShowcase.doc.mjs b/packages/cli/templates/blocks/components/Markdown/MarkdownShowcase.doc.mjs
index ed4d43e524..d1f69ae07d 100644
--- a/packages/cli/templates/blocks/components/Markdown/MarkdownShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Markdown/MarkdownShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Markdown',
name: 'Markdown',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/MetadataList/MetadataListBasicMetadata.doc.mjs b/packages/cli/templates/blocks/components/MetadataList/MetadataListBasicMetadata.doc.mjs
index 79cdb42e3b..7f3f0ff9a0 100644
--- a/packages/cli/templates/blocks/components/MetadataList/MetadataListBasicMetadata.doc.mjs
+++ b/packages/cli/templates/blocks/components/MetadataList/MetadataListBasicMetadata.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MetadataList',
name: 'MetadataList — Basic',
description: 'Single-column key-value metadata list.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/MetadataList/MetadataListCollapsibleMetadata.doc.mjs b/packages/cli/templates/blocks/components/MetadataList/MetadataListCollapsibleMetadata.doc.mjs
index b124c02f8d..fdef280a38 100644
--- a/packages/cli/templates/blocks/components/MetadataList/MetadataListCollapsibleMetadata.doc.mjs
+++ b/packages/cli/templates/blocks/components/MetadataList/MetadataListCollapsibleMetadata.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MetadataList',
name: 'MetadataList — Collapsible',
description:
'Metadata list with a show-more toggle after a set number of items.',
diff --git a/packages/cli/templates/blocks/components/MetadataList/MetadataListHorizontalMetadata.doc.mjs b/packages/cli/templates/blocks/components/MetadataList/MetadataListHorizontalMetadata.doc.mjs
index 4ec08817b6..1b31c36de2 100644
--- a/packages/cli/templates/blocks/components/MetadataList/MetadataListHorizontalMetadata.doc.mjs
+++ b/packages/cli/templates/blocks/components/MetadataList/MetadataListHorizontalMetadata.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MetadataList',
name: 'MetadataList — Horizontal',
description:
'Horizontal metadata items for compact inline display.',
diff --git a/packages/cli/templates/blocks/components/MetadataList/MetadataListMultiColumnMetadata.doc.mjs b/packages/cli/templates/blocks/components/MetadataList/MetadataListMultiColumnMetadata.doc.mjs
index ed19a85b86..86615ee137 100644
--- a/packages/cli/templates/blocks/components/MetadataList/MetadataListMultiColumnMetadata.doc.mjs
+++ b/packages/cli/templates/blocks/components/MetadataList/MetadataListMultiColumnMetadata.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MetadataList',
name: 'MetadataList — Multi-Column',
description:
'Multi-column metadata grid with token tags.',
diff --git a/packages/cli/templates/blocks/components/MetadataList/MetadataListShowcase.doc.mjs b/packages/cli/templates/blocks/components/MetadataList/MetadataListShowcase.doc.mjs
index b9d733c1e2..469806ac87 100644
--- a/packages/cli/templates/blocks/components/MetadataList/MetadataListShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/MetadataList/MetadataListShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MetadataList',
name: 'MetadataList',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/MetadataListItem/MetadataListItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/MetadataListItem/MetadataListItemShowcase.doc.mjs
index f6be24f97f..8a74049428 100644
--- a/packages/cli/templates/blocks/components/MetadataListItem/MetadataListItemShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/MetadataListItem/MetadataListItemShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MetadataListItem',
name: 'MetadataListItem',
description:
'Metadata list items displaying labeled values in various formats including text, badges, and links.',
diff --git a/packages/cli/templates/blocks/components/MobileNav/MobileNavBasicMobileNav.doc.mjs b/packages/cli/templates/blocks/components/MobileNav/MobileNavBasicMobileNav.doc.mjs
index 1b47bc93ac..487d439bab 100644
--- a/packages/cli/templates/blocks/components/MobileNav/MobileNavBasicMobileNav.doc.mjs
+++ b/packages/cli/templates/blocks/components/MobileNav/MobileNavBasicMobileNav.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MobileNav',
name: 'MobileNav — Basic Drawer',
description: 'Mobile navigation drawer with sectioned nav items triggered by a menu button',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/MobileNav/MobileNavEndSideMobileNav.doc.mjs b/packages/cli/templates/blocks/components/MobileNav/MobileNavEndSideMobileNav.doc.mjs
index ea3ad60cda..b035f1d0ab 100644
--- a/packages/cli/templates/blocks/components/MobileNav/MobileNavEndSideMobileNav.doc.mjs
+++ b/packages/cli/templates/blocks/components/MobileNav/MobileNavEndSideMobileNav.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MobileNav',
name: 'MobileNav — End Side Drawer',
description: 'Navigation drawer that slides in from the right side of the screen',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/MobileNav/MobileNavShowcase.doc.mjs b/packages/cli/templates/blocks/components/MobileNav/MobileNavShowcase.doc.mjs
index 21e522d485..060e31c744 100644
--- a/packages/cli/templates/blocks/components/MobileNav/MobileNavShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/MobileNav/MobileNavShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MobileNav',
name: 'MobileNav',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/MobileNav/MobileNavWithoutTitleMobileNav.doc.mjs b/packages/cli/templates/blocks/components/MobileNav/MobileNavWithoutTitleMobileNav.doc.mjs
index 5d01c2c993..3da53cdd75 100644
--- a/packages/cli/templates/blocks/components/MobileNav/MobileNavWithoutTitleMobileNav.doc.mjs
+++ b/packages/cli/templates/blocks/components/MobileNav/MobileNavWithoutTitleMobileNav.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MobileNav',
name: 'MobileNav — Without Title',
description: 'Mobile navigation drawer without a title header',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/MobileNavToggle/MobileNavToggleShowcase.doc.mjs b/packages/cli/templates/blocks/components/MobileNavToggle/MobileNavToggleShowcase.doc.mjs
index ece042b502..c87c7b7b75 100644
--- a/packages/cli/templates/blocks/components/MobileNavToggle/MobileNavToggleShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/MobileNavToggle/MobileNavToggleShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MobileNavToggle',
name: 'MobileNavToggle',
description: 'Demonstrates XDSMobileNavToggle as a standalone hamburger button for opening the mobile navigation drawer.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/MoreMenu/MoreMenuDefaultMoreMenu.doc.mjs b/packages/cli/templates/blocks/components/MoreMenu/MoreMenuDefaultMoreMenu.doc.mjs
index 56257e7e64..1655164df7 100644
--- a/packages/cli/templates/blocks/components/MoreMenu/MoreMenuDefaultMoreMenu.doc.mjs
+++ b/packages/cli/templates/blocks/components/MoreMenu/MoreMenuDefaultMoreMenu.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MoreMenu',
name: 'MoreMenu — Default',
description:
'Basic three-dot overflow menu with simple text-only action items.',
diff --git a/packages/cli/templates/blocks/components/MoreMenu/MoreMenuInToolbar.doc.mjs b/packages/cli/templates/blocks/components/MoreMenu/MoreMenuInToolbar.doc.mjs
index c8e118f4bc..e6abaa8923 100644
--- a/packages/cli/templates/blocks/components/MoreMenu/MoreMenuInToolbar.doc.mjs
+++ b/packages/cli/templates/blocks/components/MoreMenu/MoreMenuInToolbar.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MoreMenu',
name: 'MoreMenu — In Toolbar',
description:
'A three-dot menu alongside icon buttons in a card header toolbar.',
diff --git a/packages/cli/templates/blocks/components/MoreMenu/MoreMenuShowcase.doc.mjs b/packages/cli/templates/blocks/components/MoreMenu/MoreMenuShowcase.doc.mjs
index d742a5fbdd..a77ad4cf14 100644
--- a/packages/cli/templates/blocks/components/MoreMenu/MoreMenuShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/MoreMenu/MoreMenuShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MoreMenu',
name: 'MoreMenu',
description:
'A basic three-dot menu with simple action items.',
diff --git a/packages/cli/templates/blocks/components/MoreMenu/MoreMenuWithDividers.doc.mjs b/packages/cli/templates/blocks/components/MoreMenu/MoreMenuWithDividers.doc.mjs
index cc023c6494..174f5fa7d1 100644
--- a/packages/cli/templates/blocks/components/MoreMenu/MoreMenuWithDividers.doc.mjs
+++ b/packages/cli/templates/blocks/components/MoreMenu/MoreMenuWithDividers.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MoreMenu',
name: 'MoreMenu — With Dividers',
description:
'A three-dot menu with a divider separating destructive actions from safe ones.',
diff --git a/packages/cli/templates/blocks/components/MoreMenu/MoreMenuWithSections.doc.mjs b/packages/cli/templates/blocks/components/MoreMenu/MoreMenuWithSections.doc.mjs
index 86d4273e79..74a636153e 100644
--- a/packages/cli/templates/blocks/components/MoreMenu/MoreMenuWithSections.doc.mjs
+++ b/packages/cli/templates/blocks/components/MoreMenu/MoreMenuWithSections.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MoreMenu',
name: 'MoreMenu — With Sections',
description:
'A three-dot menu with actions organized into labeled groups.',
diff --git a/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorColumnVisibilitySelector.doc.mjs b/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorColumnVisibilitySelector.doc.mjs
index 3e17eb6570..dc4e5bbcea 100644
--- a/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorColumnVisibilitySelector.doc.mjs
+++ b/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorColumnVisibilitySelector.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MultiSelector',
name: 'MultiSelector — Column Visibility',
description:
'Column visibility toggle with hidden label, search, select-all, and selection count.',
diff --git a/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorForm.doc.mjs b/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorForm.doc.mjs
index ab37fdea7c..c15b681ae8 100644
--- a/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorForm.doc.mjs
+++ b/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorForm.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MultiSelector',
name: 'MultiSelector — Form Composition',
description:
'Two multi-selectors in a form with required/optional states.',
diff --git a/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorSearchableMultiSelector.doc.mjs b/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorSearchableMultiSelector.doc.mjs
index 218c29be2a..36f65df520 100644
--- a/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorSearchableMultiSelector.doc.mjs
+++ b/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorSearchableMultiSelector.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MultiSelector',
name: 'MultiSelector — Searchable',
description:
'Multi-select with search filtering and select-all.',
diff --git a/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorSectionedMultiSelector.doc.mjs b/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorSectionedMultiSelector.doc.mjs
index 1b2a07fd95..a960fc600d 100644
--- a/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorSectionedMultiSelector.doc.mjs
+++ b/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorSectionedMultiSelector.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MultiSelector',
name: 'MultiSelector — Sectioned Permissions',
description:
'Multi-select with options grouped into labeled sections.',
diff --git a/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorShowcase.doc.mjs b/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorShowcase.doc.mjs
index 3db6fcbc5e..29cd61bb43 100644
--- a/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/MultiSelector/MultiSelectorShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'MultiSelector',
name: 'MultiSelector',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/NavIcon/NavIconShowcase.doc.mjs b/packages/cli/templates/blocks/components/NavIcon/NavIconShowcase.doc.mjs
index dd44beb9fe..acebe7d3bc 100644
--- a/packages/cli/templates/blocks/components/NavIcon/NavIconShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/NavIcon/NavIconShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'NavIcon',
name: 'NavIcon',
description: 'Circular icon containers for navigation headers with accent backgrounds.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/NumberInput/NumberInputClearableNumberInput.doc.mjs b/packages/cli/templates/blocks/components/NumberInput/NumberInputClearableNumberInput.doc.mjs
index e374f5f144..8a5319259d 100644
--- a/packages/cli/templates/blocks/components/NumberInput/NumberInputClearableNumberInput.doc.mjs
+++ b/packages/cli/templates/blocks/components/NumberInput/NumberInputClearableNumberInput.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'NumberInput',
name: 'NumberInput — Clearable',
description: 'Number input with a clear button, unit suffix, and min/max constraint',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/NumberInput/NumberInputRangeNumberInput.doc.mjs b/packages/cli/templates/blocks/components/NumberInput/NumberInputRangeNumberInput.doc.mjs
index b7c5e23381..249389f463 100644
--- a/packages/cli/templates/blocks/components/NumberInput/NumberInputRangeNumberInput.doc.mjs
+++ b/packages/cli/templates/blocks/components/NumberInput/NumberInputRangeNumberInput.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'NumberInput',
name: 'NumberInput — Range Constrained',
description: 'Number input with min/max boundaries and a helper description',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/NumberInput/NumberInputShowcase.doc.mjs b/packages/cli/templates/blocks/components/NumberInput/NumberInputShowcase.doc.mjs
index 57eef69595..1537b049e2 100644
--- a/packages/cli/templates/blocks/components/NumberInput/NumberInputShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/NumberInput/NumberInputShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'NumberInput',
name: 'NumberInput',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/NumberInput/NumberInputStatuses.doc.mjs b/packages/cli/templates/blocks/components/NumberInput/NumberInputStatuses.doc.mjs
index 9f8a7f1b8b..0a9c1ef7d0 100644
--- a/packages/cli/templates/blocks/components/NumberInput/NumberInputStatuses.doc.mjs
+++ b/packages/cli/templates/blocks/components/NumberInput/NumberInputStatuses.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'NumberInput',
name: 'NumberInput — Status Variants',
description: 'Number inputs showing error, warning, and success validation states',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/NumberInput/NumberInputWithUnits.doc.mjs b/packages/cli/templates/blocks/components/NumberInput/NumberInputWithUnits.doc.mjs
index adec0cea9f..2232f7cdbe 100644
--- a/packages/cli/templates/blocks/components/NumberInput/NumberInputWithUnits.doc.mjs
+++ b/packages/cli/templates/blocks/components/NumberInput/NumberInputWithUnits.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'NumberInput',
name: 'NumberInput — With Units',
description: 'Number input with a percentage unit suffix and valid range',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/OverflowList/OverflowListCollapseFromStartList.doc.mjs b/packages/cli/templates/blocks/components/OverflowList/OverflowListCollapseFromStartList.doc.mjs
index b708b57c92..4c29c55ac9 100644
--- a/packages/cli/templates/blocks/components/OverflowList/OverflowListCollapseFromStartList.doc.mjs
+++ b/packages/cli/templates/blocks/components/OverflowList/OverflowListCollapseFromStartList.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'OverflowList',
name: 'OverflowList — Collapse From Start',
description: 'Overflow list that hides items from the start, keeping the latest visible',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/OverflowList/OverflowListOverflowBadges.doc.mjs b/packages/cli/templates/blocks/components/OverflowList/OverflowListOverflowBadges.doc.mjs
index c92f58b9a6..6d7d19b9eb 100644
--- a/packages/cli/templates/blocks/components/OverflowList/OverflowListOverflowBadges.doc.mjs
+++ b/packages/cli/templates/blocks/components/OverflowList/OverflowListOverflowBadges.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'OverflowList',
name: 'OverflowList — Badge Tags',
description: 'Resizable row of badges that collapses into a count badge on overflow',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/OverflowList/OverflowListOverflowDropdownActions.doc.mjs b/packages/cli/templates/blocks/components/OverflowList/OverflowListOverflowDropdownActions.doc.mjs
index 5b86ee62f5..4d39db6059 100644
--- a/packages/cli/templates/blocks/components/OverflowList/OverflowListOverflowDropdownActions.doc.mjs
+++ b/packages/cli/templates/blocks/components/OverflowList/OverflowListOverflowDropdownActions.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'OverflowList',
name: 'OverflowList — Dropdown Actions',
description: 'Action toolbar that collapses overflow buttons into a dropdown menu',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/OverflowList/OverflowListShowcase.doc.mjs b/packages/cli/templates/blocks/components/OverflowList/OverflowListShowcase.doc.mjs
index 2a60e9eebe..8b09707114 100644
--- a/packages/cli/templates/blocks/components/OverflowList/OverflowListShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/OverflowList/OverflowListShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'OverflowList',
name: 'OverflowList',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/Pagination/PaginationDotsCarousel.doc.mjs b/packages/cli/templates/blocks/components/Pagination/PaginationDotsCarousel.doc.mjs
index 8fcd656c1d..4921e334e6 100644
--- a/packages/cli/templates/blocks/components/Pagination/PaginationDotsCarousel.doc.mjs
+++ b/packages/cli/templates/blocks/components/Pagination/PaginationDotsCarousel.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Pagination',
name: 'Pagination — Dots Carousel',
description:
'A review carousel using dot pagination to step through testimonial cards. Use the dots variant for carousels, galleries, and any paged content where the total is small and visible position matters more than a page number.',
diff --git a/packages/cli/templates/blocks/components/Pagination/PaginationPageSize.doc.mjs b/packages/cli/templates/blocks/components/Pagination/PaginationPageSize.doc.mjs
index 6fd481d2da..07dc0dc535 100644
--- a/packages/cli/templates/blocks/components/Pagination/PaginationPageSize.doc.mjs
+++ b/packages/cli/templates/blocks/components/Pagination/PaginationPageSize.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Pagination',
name: 'Pagination — Page Size Selector',
description:
'A transactions table with pagination and a page size dropdown at the bottom. Shows how pagination works as a footer below real content, with adjustable rows per page.',
diff --git a/packages/cli/templates/blocks/components/Pagination/PaginationVariants.doc.mjs b/packages/cli/templates/blocks/components/Pagination/PaginationVariants.doc.mjs
index bed6158567..f14efff831 100644
--- a/packages/cli/templates/blocks/components/Pagination/PaginationVariants.doc.mjs
+++ b/packages/cli/templates/blocks/components/Pagination/PaginationVariants.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Pagination',
name: 'Pagination — Variants',
description:
'All four display variants stacked — dots, compact, count, and pages. A quick visual reference for choosing the right variant.',
diff --git a/packages/cli/templates/blocks/components/Pagination/PaginationWithTable.doc.mjs b/packages/cli/templates/blocks/components/Pagination/PaginationWithTable.doc.mjs
index b28d06d4c2..4d33abd222 100644
--- a/packages/cli/templates/blocks/components/Pagination/PaginationWithTable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Pagination/PaginationWithTable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Pagination',
name: 'Pagination — With Table',
description:
'Pagination below a data table with client-side page slicing. Use the count variant with small size for dense data views where users need to see item ranges.',
diff --git a/packages/cli/templates/blocks/components/Popover/PopoverConfirmAction.doc.mjs b/packages/cli/templates/blocks/components/Popover/PopoverConfirmAction.doc.mjs
index 177d779bea..9939b9f10a 100644
--- a/packages/cli/templates/blocks/components/Popover/PopoverConfirmAction.doc.mjs
+++ b/packages/cli/templates/blocks/components/Popover/PopoverConfirmAction.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Popover',
name: 'Popover — Confirm Action',
description:
'Inline confirmation popover for destructive actions with delete and cancel buttons.',
diff --git a/packages/cli/templates/blocks/components/Popover/PopoverFilterPanel.doc.mjs b/packages/cli/templates/blocks/components/Popover/PopoverFilterPanel.doc.mjs
index b01b0a2e66..68d8f0efde 100644
--- a/packages/cli/templates/blocks/components/Popover/PopoverFilterPanel.doc.mjs
+++ b/packages/cli/templates/blocks/components/Popover/PopoverFilterPanel.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Popover',
name: 'Popover — Filter Panel',
description:
'Popover with checkbox filters and apply/reset actions.',
diff --git a/packages/cli/templates/blocks/components/Popover/PopoverKeyboardShortcuts.doc.mjs b/packages/cli/templates/blocks/components/Popover/PopoverKeyboardShortcuts.doc.mjs
index a66c5c1bfb..113068876c 100644
--- a/packages/cli/templates/blocks/components/Popover/PopoverKeyboardShortcuts.doc.mjs
+++ b/packages/cli/templates/blocks/components/Popover/PopoverKeyboardShortcuts.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Popover',
name: 'Popover — Keyboard Shortcuts',
description:
'Popover displaying a list of keyboard shortcuts with key and description pairs.',
diff --git a/packages/cli/templates/blocks/components/Popover/PopoverSettingsPanel.doc.mjs b/packages/cli/templates/blocks/components/Popover/PopoverSettingsPanel.doc.mjs
index d3e14ec634..d1bf121bf4 100644
--- a/packages/cli/templates/blocks/components/Popover/PopoverSettingsPanel.doc.mjs
+++ b/packages/cli/templates/blocks/components/Popover/PopoverSettingsPanel.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Popover',
name: 'Popover — Settings Panel',
description:
'Popover with toggle switches for managing user preferences like notifications, dark mode, and sounds.',
diff --git a/packages/cli/templates/blocks/components/Popover/PopoverShowcase.doc.mjs b/packages/cli/templates/blocks/components/Popover/PopoverShowcase.doc.mjs
index d539dfaea3..6a9f5cfe56 100644
--- a/packages/cli/templates/blocks/components/Popover/PopoverShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Popover/PopoverShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Popover',
name: 'Popover',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/PowerSearch/PowerSearchContentSearch.doc.mjs b/packages/cli/templates/blocks/components/PowerSearch/PowerSearchContentSearch.doc.mjs
index c51274177c..19b1cbad64 100644
--- a/packages/cli/templates/blocks/components/PowerSearch/PowerSearchContentSearch.doc.mjs
+++ b/packages/cli/templates/blocks/components/PowerSearch/PowerSearchContentSearch.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'PowerSearch',
name: 'PowerSearch — Content Search',
description:
'Power search with contentSearchFieldKey so free-text input maps to a title field automatically.',
diff --git a/packages/cli/templates/blocks/components/PowerSearch/PowerSearchFullFeatured.doc.mjs b/packages/cli/templates/blocks/components/PowerSearch/PowerSearchFullFeatured.doc.mjs
index c126956b67..355b8f6613 100644
--- a/packages/cli/templates/blocks/components/PowerSearch/PowerSearchFullFeatured.doc.mjs
+++ b/packages/cli/templates/blocks/components/PowerSearch/PowerSearchFullFeatured.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'PowerSearch',
name: 'PowerSearch — Full Featured',
description:
'Power search with multiple field types: enum, multi-select, entity, and text filters.',
diff --git a/packages/cli/templates/blocks/components/PowerSearch/PowerSearchPresetFilters.doc.mjs b/packages/cli/templates/blocks/components/PowerSearch/PowerSearchPresetFilters.doc.mjs
index 1af5d2ae6f..4b6fd137f2 100644
--- a/packages/cli/templates/blocks/components/PowerSearch/PowerSearchPresetFilters.doc.mjs
+++ b/packages/cli/templates/blocks/components/PowerSearch/PowerSearchPresetFilters.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'PowerSearch',
name: 'PowerSearch — Preset Filters',
description:
'Power search initialized with pre-set filter tokens for status and priority.',
diff --git a/packages/cli/templates/blocks/components/PowerSearch/PowerSearchSearchWithTable.doc.mjs b/packages/cli/templates/blocks/components/PowerSearch/PowerSearchSearchWithTable.doc.mjs
index ad8e14804b..30b2336f9e 100644
--- a/packages/cli/templates/blocks/components/PowerSearch/PowerSearchSearchWithTable.doc.mjs
+++ b/packages/cli/templates/blocks/components/PowerSearch/PowerSearchSearchWithTable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'PowerSearch',
name: 'PowerSearch — Search with Table',
description:
'Composition of PowerSearch with Table using usePowerSearchConfig to auto-generate config and filter data.',
diff --git a/packages/cli/templates/blocks/components/PowerSearch/PowerSearchShowcase.doc.mjs b/packages/cli/templates/blocks/components/PowerSearch/PowerSearchShowcase.doc.mjs
index af67f9828c..e1b77a50d9 100644
--- a/packages/cli/templates/blocks/components/PowerSearch/PowerSearchShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/PowerSearch/PowerSearchShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'PowerSearch',
name: 'PowerSearch',
description:
'Token-based filter bar with enum and text fields, pre-populated with sample filters.',
diff --git a/packages/cli/templates/blocks/components/ProgressBar/ProgressBarCustomFormat.doc.mjs b/packages/cli/templates/blocks/components/ProgressBar/ProgressBarCustomFormat.doc.mjs
index cab3ddf346..b28b688ba7 100644
--- a/packages/cli/templates/blocks/components/ProgressBar/ProgressBarCustomFormat.doc.mjs
+++ b/packages/cli/templates/blocks/components/ProgressBar/ProgressBarCustomFormat.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ProgressBar',
name: 'ProgressBar — Custom Format',
description:
'Progress bar with a custom value label showing disk usage in GB.',
diff --git a/packages/cli/templates/blocks/components/ProgressBar/ProgressBarIndeterminate.doc.mjs b/packages/cli/templates/blocks/components/ProgressBar/ProgressBarIndeterminate.doc.mjs
index 052407d7a4..b0dacd82ed 100644
--- a/packages/cli/templates/blocks/components/ProgressBar/ProgressBarIndeterminate.doc.mjs
+++ b/packages/cli/templates/blocks/components/ProgressBar/ProgressBarIndeterminate.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ProgressBar',
name: 'ProgressBar — Indeterminate',
description:
'Indeterminate progress bar for operations with unknown duration.',
diff --git a/packages/cli/templates/blocks/components/ProgressBar/ProgressBarSemanticVariants.doc.mjs b/packages/cli/templates/blocks/components/ProgressBar/ProgressBarSemanticVariants.doc.mjs
index 08f876b0e9..1892267b89 100644
--- a/packages/cli/templates/blocks/components/ProgressBar/ProgressBarSemanticVariants.doc.mjs
+++ b/packages/cli/templates/blocks/components/ProgressBar/ProgressBarSemanticVariants.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ProgressBar',
name: 'ProgressBar — Semantic Variants',
description:
'All semantic color variants stacked vertically.',
diff --git a/packages/cli/templates/blocks/components/ProgressBar/ProgressBarShowcase.doc.mjs b/packages/cli/templates/blocks/components/ProgressBar/ProgressBarShowcase.doc.mjs
index 6a29abbc01..e5cb356b56 100644
--- a/packages/cli/templates/blocks/components/ProgressBar/ProgressBarShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ProgressBar/ProgressBarShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ProgressBar',
name: 'ProgressBar',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/ProgressBar/ProgressBarWithValueLabel.doc.mjs b/packages/cli/templates/blocks/components/ProgressBar/ProgressBarWithValueLabel.doc.mjs
index 6c97591b53..2a26c88c64 100644
--- a/packages/cli/templates/blocks/components/ProgressBar/ProgressBarWithValueLabel.doc.mjs
+++ b/packages/cli/templates/blocks/components/ProgressBar/ProgressBarWithValueLabel.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ProgressBar',
name: 'ProgressBar — With Value Label',
description:
'Progress bar with its current percentage displayed.',
diff --git a/packages/cli/templates/blocks/components/RadioList/RadioListHorizontalLayout.doc.mjs b/packages/cli/templates/blocks/components/RadioList/RadioListHorizontalLayout.doc.mjs
index 28ad93c894..4f2f8dea60 100644
--- a/packages/cli/templates/blocks/components/RadioList/RadioListHorizontalLayout.doc.mjs
+++ b/packages/cli/templates/blocks/components/RadioList/RadioListHorizontalLayout.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'RadioList',
name: 'RadioList — Horizontal Layout',
description:
'Radio list with horizontal orientation for compact selections.',
diff --git a/packages/cli/templates/blocks/components/RadioList/RadioListPricingTier.doc.mjs b/packages/cli/templates/blocks/components/RadioList/RadioListPricingTier.doc.mjs
index 267f82392d..aa0c42f8c5 100644
--- a/packages/cli/templates/blocks/components/RadioList/RadioListPricingTier.doc.mjs
+++ b/packages/cli/templates/blocks/components/RadioList/RadioListPricingTier.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'RadioList',
name: 'RadioList — Pricing Tier',
description:
'Radio list with pricing info in end content for plan selection.',
diff --git a/packages/cli/templates/blocks/components/RadioList/RadioListShowcase.doc.mjs b/packages/cli/templates/blocks/components/RadioList/RadioListShowcase.doc.mjs
index d2022b2c18..f9fa99d65f 100644
--- a/packages/cli/templates/blocks/components/RadioList/RadioListShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/RadioList/RadioListShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'RadioList',
name: 'RadioList',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/RadioList/RadioListWithDescriptions.doc.mjs b/packages/cli/templates/blocks/components/RadioList/RadioListWithDescriptions.doc.mjs
index 32dd24ea99..01ae9643b7 100644
--- a/packages/cli/templates/blocks/components/RadioList/RadioListWithDescriptions.doc.mjs
+++ b/packages/cli/templates/blocks/components/RadioList/RadioListWithDescriptions.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'RadioList',
name: 'RadioList — With Descriptions',
description:
'Radio list with descriptions on the group and each item.',
diff --git a/packages/cli/templates/blocks/components/RadioList/RadioListWithValidation.doc.mjs b/packages/cli/templates/blocks/components/RadioList/RadioListWithValidation.doc.mjs
index c0676e8267..7d969a0a1d 100644
--- a/packages/cli/templates/blocks/components/RadioList/RadioListWithValidation.doc.mjs
+++ b/packages/cli/templates/blocks/components/RadioList/RadioListWithValidation.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'RadioList',
name: 'RadioList — With Validation',
description:
'Required radio list with an error message when nothing is selected.',
diff --git a/packages/cli/templates/blocks/components/RadioListItem/RadioListItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/RadioListItem/RadioListItemShowcase.doc.mjs
index 58384745a2..462fc47cd7 100644
--- a/packages/cli/templates/blocks/components/RadioListItem/RadioListItemShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/RadioListItem/RadioListItemShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'RadioListItem',
name: 'RadioListItem',
description:
'Radio list items with labels, descriptions, and different states including disabled.',
diff --git a/packages/cli/templates/blocks/components/Resizable/ResizableShowcase.doc.mjs b/packages/cli/templates/blocks/components/Resizable/ResizableShowcase.doc.mjs
index 3b1619cdb5..014fb5aa6b 100644
--- a/packages/cli/templates/blocks/components/Resizable/ResizableShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Resizable/ResizableShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Resizable',
name: 'Resizable',
description:
'Horizontal resizable split with a draggable handle between two panels.',
diff --git a/packages/cli/templates/blocks/components/Section/SectionVariants.doc.mjs b/packages/cli/templates/blocks/components/Section/SectionVariants.doc.mjs
index 356d1d04cf..7d855d7fe2 100644
--- a/packages/cli/templates/blocks/components/Section/SectionVariants.doc.mjs
+++ b/packages/cli/templates/blocks/components/Section/SectionVariants.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Section',
name: 'Section — Variants',
description:
'All three background variants stacked — section (default surface), wash (muted), and transparent. A quick visual reference for choosing the right variant.',
diff --git a/packages/cli/templates/blocks/components/Section/SectionWashHighlight.doc.mjs b/packages/cli/templates/blocks/components/Section/SectionWashHighlight.doc.mjs
index 4615ee5838..ee17230b0b 100644
--- a/packages/cli/templates/blocks/components/Section/SectionWashHighlight.doc.mjs
+++ b/packages/cli/templates/blocks/components/Section/SectionWashHighlight.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Section',
name: 'Section — Default with Wash',
description:
'A default section stacked with a full-width wash section. Shows how wash draws attention to a specific region like an upgrade prompt or banner.',
diff --git a/packages/cli/templates/blocks/components/Section/SectionWithDividers.doc.mjs b/packages/cli/templates/blocks/components/Section/SectionWithDividers.doc.mjs
index 71c5649ba4..b760da1d24 100644
--- a/packages/cli/templates/blocks/components/Section/SectionWithDividers.doc.mjs
+++ b/packages/cli/templates/blocks/components/Section/SectionWithDividers.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Section',
name: 'Section — With Dividers',
description:
'Adjacent sections separated by bottom dividers, like a settings page. Use dividers when stacking same-variant sections that need visual separation without a background change.',
diff --git a/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlDisabledItem.doc.mjs b/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlDisabledItem.doc.mjs
index dce6e1aa9b..8210d2ce2e 100644
--- a/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlDisabledItem.doc.mjs
+++ b/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlDisabledItem.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'SegmentedControl',
name: 'SegmentedControl — Disabled Item',
description:
'Segmented control with an individually disabled option for unavailable choices.',
diff --git a/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlFillLayout.doc.mjs b/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlFillLayout.doc.mjs
index 6b921314c9..7219226ef7 100644
--- a/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlFillLayout.doc.mjs
+++ b/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlFillLayout.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'SegmentedControl',
name: 'SegmentedControl \u2014 Fill Layout',
description:
'Segmented control that stretches segments equally to fill the available width, useful for fixed-width containers.',
diff --git a/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlIconOnly.doc.mjs b/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlIconOnly.doc.mjs
index fcc831e9a4..69dafe2af0 100644
--- a/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlIconOnly.doc.mjs
+++ b/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlIconOnly.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'SegmentedControl',
name: 'SegmentedControl — Icon Only',
description:
'Compact segmented control with hidden labels, showing only icons for space-constrained layouts.',
diff --git a/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlShowcase.doc.mjs b/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlShowcase.doc.mjs
index d722458fd9..3165d94ec3 100644
--- a/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'SegmentedControl',
name: 'SegmentedControl',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlWithIcons.doc.mjs b/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlWithIcons.doc.mjs
index 2d1e183c22..d66738eb6d 100644
--- a/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlWithIcons.doc.mjs
+++ b/packages/cli/templates/blocks/components/SegmentedControl/SegmentedControlWithIcons.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'SegmentedControl',
name: 'SegmentedControl — With Icons',
description:
'Segmented control with icon and label pairs for a view mode switcher.',
diff --git a/packages/cli/templates/blocks/components/SegmentedControlItem/SegmentedControlItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/SegmentedControlItem/SegmentedControlItemShowcase.doc.mjs
index 98f882033c..d08a511076 100644
--- a/packages/cli/templates/blocks/components/SegmentedControlItem/SegmentedControlItemShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/SegmentedControlItem/SegmentedControlItemShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'SegmentedControlItem',
name: 'SegmentedControlItem',
description:
'Segmented control items with text labels and icons, including a disabled item.',
diff --git a/packages/cli/templates/blocks/components/Selector/SelectorClearable.doc.mjs b/packages/cli/templates/blocks/components/Selector/SelectorClearable.doc.mjs
index 49af7f9b6f..2e31316ab4 100644
--- a/packages/cli/templates/blocks/components/Selector/SelectorClearable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Selector/SelectorClearable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Selector',
name: 'Selector — Clearable',
description:
'Selector with a clear button to reset the selected value.',
diff --git a/packages/cli/templates/blocks/components/Selector/SelectorShowcase.doc.mjs b/packages/cli/templates/blocks/components/Selector/SelectorShowcase.doc.mjs
index 82016dbb47..db890a00c1 100644
--- a/packages/cli/templates/blocks/components/Selector/SelectorShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Selector/SelectorShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Selector',
name: 'Selector',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/Selector/SelectorWithSections.doc.mjs b/packages/cli/templates/blocks/components/Selector/SelectorWithSections.doc.mjs
index 5a82457622..1994961597 100644
--- a/packages/cli/templates/blocks/components/Selector/SelectorWithSections.doc.mjs
+++ b/packages/cli/templates/blocks/components/Selector/SelectorWithSections.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Selector',
name: 'Selector — Grouped Sections',
description:
'Selector with options grouped into labeled sections.',
diff --git a/packages/cli/templates/blocks/components/Selector/SelectorWithStatus.doc.mjs b/packages/cli/templates/blocks/components/Selector/SelectorWithStatus.doc.mjs
index 88fffbb602..b4fda2c572 100644
--- a/packages/cli/templates/blocks/components/Selector/SelectorWithStatus.doc.mjs
+++ b/packages/cli/templates/blocks/components/Selector/SelectorWithStatus.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Selector',
name: 'Selector — Validation States',
description:
'Selector showing error, warning, and success validation states.',
diff --git a/packages/cli/templates/blocks/components/SelectorOption/SelectorOptionShowcase.doc.mjs b/packages/cli/templates/blocks/components/SelectorOption/SelectorOptionShowcase.doc.mjs
index 40bc915c74..215f7e0cde 100644
--- a/packages/cli/templates/blocks/components/SelectorOption/SelectorOptionShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/SelectorOption/SelectorOptionShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'SelectorOption',
name: 'SelectorOption',
description:
'Selector with custom-rendered options using XDSSelectorOption for icons and descriptions.',
diff --git a/packages/cli/templates/blocks/components/SideNav/SideNavEndContent.doc.mjs b/packages/cli/templates/blocks/components/SideNav/SideNavEndContent.doc.mjs
index 03b22b031e..dbf6086436 100644
--- a/packages/cli/templates/blocks/components/SideNav/SideNavEndContent.doc.mjs
+++ b/packages/cli/templates/blocks/components/SideNav/SideNavEndContent.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'SideNav',
name: 'SideNav — End Content',
description:
'Side navigation items with badges, counts, and context menus as trailing content.',
diff --git a/packages/cli/templates/blocks/components/SideNav/SideNavNestedItems.doc.mjs b/packages/cli/templates/blocks/components/SideNav/SideNavNestedItems.doc.mjs
index 872510375c..5ba5db3cb8 100644
--- a/packages/cli/templates/blocks/components/SideNav/SideNavNestedItems.doc.mjs
+++ b/packages/cli/templates/blocks/components/SideNav/SideNavNestedItems.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'SideNav',
name: 'SideNav — Nested Items',
description:
'Side navigation with collapsible nested items for settings or hierarchical menus.',
diff --git a/packages/cli/templates/blocks/components/SideNav/SideNavShowcase.doc.mjs b/packages/cli/templates/blocks/components/SideNav/SideNavShowcase.doc.mjs
index c1f970623e..adefcf2f99 100644
--- a/packages/cli/templates/blocks/components/SideNav/SideNavShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/SideNav/SideNavShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'SideNav',
name: 'SideNav',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/SideNav/SideNavWithHeaderMenu.doc.mjs b/packages/cli/templates/blocks/components/SideNav/SideNavWithHeaderMenu.doc.mjs
index 6eb842b24b..25e1dba472 100644
--- a/packages/cli/templates/blocks/components/SideNav/SideNavWithHeaderMenu.doc.mjs
+++ b/packages/cli/templates/blocks/components/SideNav/SideNavWithHeaderMenu.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'SideNav',
name: 'SideNav — Header with Menu',
description:
'Side navigation with an account switcher dropdown in the header for multi-account apps.',
diff --git a/packages/cli/templates/blocks/components/SideNavCollapseButton/SideNavCollapseButtonShowcase.doc.mjs b/packages/cli/templates/blocks/components/SideNavCollapseButton/SideNavCollapseButtonShowcase.doc.mjs
index 636dc92ca1..0b6c518497 100644
--- a/packages/cli/templates/blocks/components/SideNavCollapseButton/SideNavCollapseButtonShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/SideNavCollapseButton/SideNavCollapseButtonShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'SideNavCollapseButton',
name: 'SideNavCollapseButton',
description: 'Demonstrates XDSSideNavCollapseButton inside a collapsible SideNav.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/SideNavHeading/SideNavHeadingShowcase.doc.mjs b/packages/cli/templates/blocks/components/SideNavHeading/SideNavHeadingShowcase.doc.mjs
index 5b6124c058..13c83749fe 100644
--- a/packages/cli/templates/blocks/components/SideNavHeading/SideNavHeadingShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/SideNavHeading/SideNavHeadingShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'SideNavHeading',
name: 'SideNavHeading',
description: 'Demonstrates XDSSideNavHeading with an app name, logo icon, superheading, and subheading.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/SideNavItem/SideNavItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/SideNavItem/SideNavItemShowcase.doc.mjs
index a5200ce5c2..8d69b81a51 100644
--- a/packages/cli/templates/blocks/components/SideNavItem/SideNavItemShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/SideNavItem/SideNavItemShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'SideNavItem',
name: 'SideNavItem',
description: 'Demonstrates XDSSideNavItem with selected, icon, disabled, and nested states.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/SideNavSection/SideNavSectionShowcase.doc.mjs b/packages/cli/templates/blocks/components/SideNavSection/SideNavSectionShowcase.doc.mjs
index 3ac433caab..e0f484e547 100644
--- a/packages/cli/templates/blocks/components/SideNavSection/SideNavSectionShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/SideNavSection/SideNavSectionShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'SideNavSection',
name: 'SideNavSection',
description: 'Demonstrates XDSSideNavSection with titled groups of navigation items.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Skeleton/SkeletonCardSkeleton.doc.mjs b/packages/cli/templates/blocks/components/Skeleton/SkeletonCardSkeleton.doc.mjs
index 8a49d530c2..71e7b81f00 100644
--- a/packages/cli/templates/blocks/components/Skeleton/SkeletonCardSkeleton.doc.mjs
+++ b/packages/cli/templates/blocks/components/Skeleton/SkeletonCardSkeleton.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Skeleton',
name: 'Skeleton — Card Loading',
description:
'Card skeleton with avatar, name, and content lines.',
diff --git a/packages/cli/templates/blocks/components/Skeleton/SkeletonShowcase.doc.mjs b/packages/cli/templates/blocks/components/Skeleton/SkeletonShowcase.doc.mjs
index 2213873431..0b5fe3597b 100644
--- a/packages/cli/templates/blocks/components/Skeleton/SkeletonShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Skeleton/SkeletonShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Skeleton',
name: 'Skeleton',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/Skeleton/SkeletonStaggeredList.doc.mjs b/packages/cli/templates/blocks/components/Skeleton/SkeletonStaggeredList.doc.mjs
index f334297fc1..14c56bf68f 100644
--- a/packages/cli/templates/blocks/components/Skeleton/SkeletonStaggeredList.doc.mjs
+++ b/packages/cli/templates/blocks/components/Skeleton/SkeletonStaggeredList.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Skeleton',
name: 'Skeleton — Staggered List',
description:
'Staggered skeleton lines with varying widths.',
diff --git a/packages/cli/templates/blocks/components/Skeleton/SkeletonTableRowSkeleton.doc.mjs b/packages/cli/templates/blocks/components/Skeleton/SkeletonTableRowSkeleton.doc.mjs
index c1a5f3230f..a8fc5fb84b 100644
--- a/packages/cli/templates/blocks/components/Skeleton/SkeletonTableRowSkeleton.doc.mjs
+++ b/packages/cli/templates/blocks/components/Skeleton/SkeletonTableRowSkeleton.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Skeleton',
name: 'Skeleton — Table Rows',
description:
'Table skeleton with staggered column widths.',
diff --git a/packages/cli/templates/blocks/components/Slider/SliderFormattedValue.doc.mjs b/packages/cli/templates/blocks/components/Slider/SliderFormattedValue.doc.mjs
index ed06b3b840..3b8a19419d 100644
--- a/packages/cli/templates/blocks/components/Slider/SliderFormattedValue.doc.mjs
+++ b/packages/cli/templates/blocks/components/Slider/SliderFormattedValue.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Slider',
name: 'Slider — Formatted Value',
description:
'Slider with custom formatting showing temperature in Fahrenheit.',
diff --git a/packages/cli/templates/blocks/components/Slider/SliderRangeSlider.doc.mjs b/packages/cli/templates/blocks/components/Slider/SliderRangeSlider.doc.mjs
index 4b520f8bc5..1a28a7c372 100644
--- a/packages/cli/templates/blocks/components/Slider/SliderRangeSlider.doc.mjs
+++ b/packages/cli/templates/blocks/components/Slider/SliderRangeSlider.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Slider',
name: 'Slider — Range',
description:
'Range slider for selecting a value range like price bounds.',
diff --git a/packages/cli/templates/blocks/components/Slider/SliderShowcase.doc.mjs b/packages/cli/templates/blocks/components/Slider/SliderShowcase.doc.mjs
index 4e79f98f93..ab0adba9f0 100644
--- a/packages/cli/templates/blocks/components/Slider/SliderShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Slider/SliderShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Slider',
name: 'Slider',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/Slider/SliderWithMarks.doc.mjs b/packages/cli/templates/blocks/components/Slider/SliderWithMarks.doc.mjs
index c8c6440f60..3f4bac46ff 100644
--- a/packages/cli/templates/blocks/components/Slider/SliderWithMarks.doc.mjs
+++ b/packages/cli/templates/blocks/components/Slider/SliderWithMarks.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Slider',
name: 'Slider — With Marks',
description:
'Slider with labeled tick marks at fixed intervals.',
diff --git a/packages/cli/templates/blocks/components/Slider/SliderWithStatus.doc.mjs b/packages/cli/templates/blocks/components/Slider/SliderWithStatus.doc.mjs
index 69d5312dbc..d6afb2e417 100644
--- a/packages/cli/templates/blocks/components/Slider/SliderWithStatus.doc.mjs
+++ b/packages/cli/templates/blocks/components/Slider/SliderWithStatus.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Slider',
name: 'Slider — Validation States',
description:
'Sliders with error, warning, and success validation states.',
diff --git a/packages/cli/templates/blocks/components/Spinner/SpinnerOnMedia.doc.mjs b/packages/cli/templates/blocks/components/Spinner/SpinnerOnMedia.doc.mjs
index 9fdf96c2eb..4f0c3deeea 100644
--- a/packages/cli/templates/blocks/components/Spinner/SpinnerOnMedia.doc.mjs
+++ b/packages/cli/templates/blocks/components/Spinner/SpinnerOnMedia.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Spinner',
name: 'Spinner — On Media Shade',
description:
'Default and onMedia shade spinners for light and dark backgrounds.',
diff --git a/packages/cli/templates/blocks/components/Spinner/SpinnerShowcase.doc.mjs b/packages/cli/templates/blocks/components/Spinner/SpinnerShowcase.doc.mjs
index 75be2d2621..4719d3c57c 100644
--- a/packages/cli/templates/blocks/components/Spinner/SpinnerShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Spinner/SpinnerShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Spinner',
name: 'Spinner',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/Spinner/SpinnerSizes.doc.mjs b/packages/cli/templates/blocks/components/Spinner/SpinnerSizes.doc.mjs
index 0de4c07caa..fcaf2e56d2 100644
--- a/packages/cli/templates/blocks/components/Spinner/SpinnerSizes.doc.mjs
+++ b/packages/cli/templates/blocks/components/Spinner/SpinnerSizes.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Spinner',
name: 'Spinner — Sizes',
description: 'All spinner sizes displayed side by side.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Spinner/SpinnerWithLabel.doc.mjs b/packages/cli/templates/blocks/components/Spinner/SpinnerWithLabel.doc.mjs
index 5c14606862..e1fc3eea0a 100644
--- a/packages/cli/templates/blocks/components/Spinner/SpinnerWithLabel.doc.mjs
+++ b/packages/cli/templates/blocks/components/Spinner/SpinnerWithLabel.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Spinner',
name: 'Spinner — With Label',
description:
'Spinners with text and rich multi-line labels.',
diff --git a/packages/cli/templates/blocks/components/Stack/StackAlignment.doc.mjs b/packages/cli/templates/blocks/components/Stack/StackAlignment.doc.mjs
index b61ea4d34a..9607b4dd50 100644
--- a/packages/cli/templates/blocks/components/Stack/StackAlignment.doc.mjs
+++ b/packages/cli/templates/blocks/components/Stack/StackAlignment.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Stack',
name: 'Stack — Alignment',
description:
'Buttons positioned at the start, center, and end of a row.',
diff --git a/packages/cli/templates/blocks/components/Stack/StackDirections.doc.mjs b/packages/cli/templates/blocks/components/Stack/StackDirections.doc.mjs
index cd387ec5d0..0f8698a146 100644
--- a/packages/cli/templates/blocks/components/Stack/StackDirections.doc.mjs
+++ b/packages/cli/templates/blocks/components/Stack/StackDirections.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Stack',
name: 'Stack — Directions',
description:
'Badges arranged horizontally and vertically in side-by-side cards.',
diff --git a/packages/cli/templates/blocks/components/Stack/StackFillItem.doc.mjs b/packages/cli/templates/blocks/components/Stack/StackFillItem.doc.mjs
index 7de93d8dc7..174efa1c05 100644
--- a/packages/cli/templates/blocks/components/Stack/StackFillItem.doc.mjs
+++ b/packages/cli/templates/blocks/components/Stack/StackFillItem.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Stack',
name: 'Stack — Fill Item',
description:
'An avatar, text, and button in a row — the text stretches to fill the available space.',
diff --git a/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.doc.mjs
index 86ec7140c5..dfd491378a 100644
--- a/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'StackItem',
name: 'StackItem',
description:
'StackItem can be used within XDSHStack or XDSVStack for more granular control over individual item sizing and alignment, but is optional — stack children work without it.',
diff --git a/packages/cli/templates/blocks/components/StatusDot/StatusDotPulsing.doc.mjs b/packages/cli/templates/blocks/components/StatusDot/StatusDotPulsing.doc.mjs
index f533d69551..f194082f30 100644
--- a/packages/cli/templates/blocks/components/StatusDot/StatusDotPulsing.doc.mjs
+++ b/packages/cli/templates/blocks/components/StatusDot/StatusDotPulsing.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'StatusDot',
name: 'StatusDot — Pulsing',
description: 'Animated pulsing dots for live, processing, and error states.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/StatusDot/StatusDotShowcase.doc.mjs b/packages/cli/templates/blocks/components/StatusDot/StatusDotShowcase.doc.mjs
index c927ac6380..2b56bc9dcd 100644
--- a/packages/cli/templates/blocks/components/StatusDot/StatusDotShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/StatusDot/StatusDotShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'StatusDot',
name: 'StatusDot',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/StatusDot/StatusDotStatusIndicators.doc.mjs b/packages/cli/templates/blocks/components/StatusDot/StatusDotStatusIndicators.doc.mjs
index 5f45d0a8bf..e8273d882d 100644
--- a/packages/cli/templates/blocks/components/StatusDot/StatusDotStatusIndicators.doc.mjs
+++ b/packages/cli/templates/blocks/components/StatusDot/StatusDotStatusIndicators.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'StatusDot',
name: 'StatusDot — Status Indicators',
description:
'Labeled status dot list for presence indicators like online, away, and offline.',
diff --git a/packages/cli/templates/blocks/components/StatusDot/StatusDotVariants.doc.mjs b/packages/cli/templates/blocks/components/StatusDot/StatusDotVariants.doc.mjs
index 9fbc73c25e..873afecff5 100644
--- a/packages/cli/templates/blocks/components/StatusDot/StatusDotVariants.doc.mjs
+++ b/packages/cli/templates/blocks/components/StatusDot/StatusDotVariants.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'StatusDot',
name: 'StatusDot — Variants',
description: 'All five semantic color variants displayed in a row.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Switch/SwitchDisabled.doc.mjs b/packages/cli/templates/blocks/components/Switch/SwitchDisabled.doc.mjs
index 75b9f21aa5..7dd98a7c9e 100644
--- a/packages/cli/templates/blocks/components/Switch/SwitchDisabled.doc.mjs
+++ b/packages/cli/templates/blocks/components/Switch/SwitchDisabled.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Switch',
name: 'Switch — Disabled',
description: 'Disabled switch with label and description for gated features.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Switch/SwitchSettingsPanel.doc.mjs b/packages/cli/templates/blocks/components/Switch/SwitchSettingsPanel.doc.mjs
index 58b3933b91..b80204f195 100644
--- a/packages/cli/templates/blocks/components/Switch/SwitchSettingsPanel.doc.mjs
+++ b/packages/cli/templates/blocks/components/Switch/SwitchSettingsPanel.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Switch',
name: 'Switch — Settings Panel',
description:
'Settings panel with spread-spaced switches in a card.',
diff --git a/packages/cli/templates/blocks/components/Switch/SwitchShowcase.doc.mjs b/packages/cli/templates/blocks/components/Switch/SwitchShowcase.doc.mjs
index ee88a2629b..5dd25669a1 100644
--- a/packages/cli/templates/blocks/components/Switch/SwitchShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Switch/SwitchShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Switch',
name: 'Switch',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/Switch/SwitchWithDescription.doc.mjs b/packages/cli/templates/blocks/components/Switch/SwitchWithDescription.doc.mjs
index 8502daa35c..e7881e76fe 100644
--- a/packages/cli/templates/blocks/components/Switch/SwitchWithDescription.doc.mjs
+++ b/packages/cli/templates/blocks/components/Switch/SwitchWithDescription.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Switch',
name: 'Switch — With Description',
description: 'Toggle with a label and supporting description text.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Switch/SwitchWithStatus.doc.mjs b/packages/cli/templates/blocks/components/Switch/SwitchWithStatus.doc.mjs
index 9f137dcfae..a682844373 100644
--- a/packages/cli/templates/blocks/components/Switch/SwitchWithStatus.doc.mjs
+++ b/packages/cli/templates/blocks/components/Switch/SwitchWithStatus.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Switch',
name: 'Switch — With Status',
description:
'Switches with error, warning, and success validation states.',
diff --git a/packages/cli/templates/blocks/components/Tab/TabShowcase.doc.mjs b/packages/cli/templates/blocks/components/Tab/TabShowcase.doc.mjs
index 504dc11327..37fb63c025 100644
--- a/packages/cli/templates/blocks/components/Tab/TabShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Tab/TabShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Tab',
name: 'Tab',
description:
'Tab is an individual tab item within a TabList, supporting labels, icons, selected icons, and end content slots.',
diff --git a/packages/cli/templates/blocks/components/TabList/TabListShowcase.doc.mjs b/packages/cli/templates/blocks/components/TabList/TabListShowcase.doc.mjs
index a5613b544c..a65363e137 100644
--- a/packages/cli/templates/blocks/components/TabList/TabListShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TabList/TabListShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TabList',
name: 'TabList',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/TabList/TabListTabsFillLayout.doc.mjs b/packages/cli/templates/blocks/components/TabList/TabListTabsFillLayout.doc.mjs
index e78a5292d5..7b217b79a9 100644
--- a/packages/cli/templates/blocks/components/TabList/TabListTabsFillLayout.doc.mjs
+++ b/packages/cli/templates/blocks/components/TabList/TabListTabsFillLayout.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TabList',
name: 'TabList — Fill Layout',
description:
'Tabs that stretch to fill the available width with a bottom divider.',
diff --git a/packages/cli/templates/blocks/components/TabList/TabListTabsWithActions.doc.mjs b/packages/cli/templates/blocks/components/TabList/TabListTabsWithActions.doc.mjs
index 6843e44faa..0952cc82b5 100644
--- a/packages/cli/templates/blocks/components/TabList/TabListTabsWithActions.doc.mjs
+++ b/packages/cli/templates/blocks/components/TabList/TabListTabsWithActions.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TabList',
name: 'TabList — With Actions',
description:
'Page header pattern with tabs on the left and action buttons pushed to the right. When hasDivider is true, pair with a smaller button size (sm) so actions don\u2019t overpower the tab row.',
diff --git a/packages/cli/templates/blocks/components/TabList/TabListTabsWithBadge.doc.mjs b/packages/cli/templates/blocks/components/TabList/TabListTabsWithBadge.doc.mjs
index 93faa7f6e7..c54411d9f1 100644
--- a/packages/cli/templates/blocks/components/TabList/TabListTabsWithBadge.doc.mjs
+++ b/packages/cli/templates/blocks/components/TabList/TabListTabsWithBadge.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TabList',
name: 'TabList \u2014 With Badge',
description:
'Tabs with notification badge counts rendered via endContent. Uses error variant for urgent counts and neutral for informational ones.',
diff --git a/packages/cli/templates/blocks/components/TabList/TabListTabsWithIcons.doc.mjs b/packages/cli/templates/blocks/components/TabList/TabListTabsWithIcons.doc.mjs
index d0cf078a1f..dab03377e1 100644
--- a/packages/cli/templates/blocks/components/TabList/TabListTabsWithIcons.doc.mjs
+++ b/packages/cli/templates/blocks/components/TabList/TabListTabsWithIcons.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TabList',
name: 'TabList — With Icons',
description: 'Tabs with leading icons alongside text labels.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TabList/TabListTabsWithMenu.doc.mjs b/packages/cli/templates/blocks/components/TabList/TabListTabsWithMenu.doc.mjs
index a7ad2dbf9e..1732f0de6b 100644
--- a/packages/cli/templates/blocks/components/TabList/TabListTabsWithMenu.doc.mjs
+++ b/packages/cli/templates/blocks/components/TabList/TabListTabsWithMenu.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TabList',
name: 'TabList — With Overflow Menu',
description:
'Tab list with a dropdown menu for additional items that do not fit inline.',
diff --git a/packages/cli/templates/blocks/components/TabList/TabListTabsWithStatusDot.doc.mjs b/packages/cli/templates/blocks/components/TabList/TabListTabsWithStatusDot.doc.mjs
index c62cf8f640..44b4f1b842 100644
--- a/packages/cli/templates/blocks/components/TabList/TabListTabsWithStatusDot.doc.mjs
+++ b/packages/cli/templates/blocks/components/TabList/TabListTabsWithStatusDot.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TabList',
name: 'TabList \u2014 With Status Dot',
description:
'Tabs with status dot indicators rendered via endContent to show live environment health at a glance.',
diff --git a/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.doc.mjs b/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.doc.mjs
index e9229edbb6..73b68d7b40 100644
--- a/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TabMenu',
name: 'TabMenu',
description:
'TabMenu is an overflow menu within a TabList that groups additional tab options into a dropdown, showing the selected option\'s label as the trigger text.',
diff --git a/packages/cli/templates/blocks/components/Table/TableColumnSettingsTable.doc.mjs b/packages/cli/templates/blocks/components/Table/TableColumnSettingsTable.doc.mjs
index a79348fc89..e6a7479613 100644
--- a/packages/cli/templates/blocks/components/Table/TableColumnSettingsTable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Table/TableColumnSettingsTable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Table',
name: 'Table — Column Settings',
description:
'Table with a column visibility picker in the toolbar. Toggle columns on and off.',
diff --git a/packages/cli/templates/blocks/components/Table/TableFilterableTable.doc.mjs b/packages/cli/templates/blocks/components/Table/TableFilterableTable.doc.mjs
index 0061a882f3..2adacfb4a9 100644
--- a/packages/cli/templates/blocks/components/Table/TableFilterableTable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Table/TableFilterableTable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Table',
name: 'Table — Popover Filters',
description:
'Table with popover filter controls triggered by icons in column headers.',
diff --git a/packages/cli/templates/blocks/components/Table/TableGridDividersTable.doc.mjs b/packages/cli/templates/blocks/components/Table/TableGridDividersTable.doc.mjs
index 8dbdf2f12a..3cae275073 100644
--- a/packages/cli/templates/blocks/components/Table/TableGridDividersTable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Table/TableGridDividersTable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Table',
name: 'Table — Grid Dividers',
description:
'Compact table with grid dividers showing both row and column borders, suited for dense numeric data.',
diff --git a/packages/cli/templates/blocks/components/Table/TableInCard.doc.mjs b/packages/cli/templates/blocks/components/Table/TableInCard.doc.mjs
index 537eb4e1a5..7fd275cf35 100644
--- a/packages/cli/templates/blocks/components/Table/TableInCard.doc.mjs
+++ b/packages/cli/templates/blocks/components/Table/TableInCard.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Table',
name: 'Table — In Card',
description:
'Table composed inside a card with a heading, demonstrating container bleed alignment.',
diff --git a/packages/cli/templates/blocks/components/Table/TableInlineFilterTable.doc.mjs b/packages/cli/templates/blocks/components/Table/TableInlineFilterTable.doc.mjs
index 004495c3a9..448aaa925d 100644
--- a/packages/cli/templates/blocks/components/Table/TableInlineFilterTable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Table/TableInlineFilterTable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Table',
name: 'Table — Inline Filters',
description:
'Table with inline filter controls rendered directly below each column header.',
diff --git a/packages/cli/templates/blocks/components/Table/TablePaginatedTable.doc.mjs b/packages/cli/templates/blocks/components/Table/TablePaginatedTable.doc.mjs
index 68ba527577..6b0571a3b4 100644
--- a/packages/cli/templates/blocks/components/Table/TablePaginatedTable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Table/TablePaginatedTable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Table',
name: 'Table — Paginated Data',
description:
'Paginated data table navigating through a larger dataset page by page.',
diff --git a/packages/cli/templates/blocks/components/Table/TableResizableTable.doc.mjs b/packages/cli/templates/blocks/components/Table/TableResizableTable.doc.mjs
index 24181f5f26..0ab71b6f27 100644
--- a/packages/cli/templates/blocks/components/Table/TableResizableTable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Table/TableResizableTable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Table',
name: 'Table — Resizable Columns',
description:
'Table with draggable column resize handles. Drag the right edge of any header to resize.',
diff --git a/packages/cli/templates/blocks/components/Table/TableRichCellTable.doc.mjs b/packages/cli/templates/blocks/components/Table/TableRichCellTable.doc.mjs
index 9ddd29ba10..98ba2c26bf 100644
--- a/packages/cli/templates/blocks/components/Table/TableRichCellTable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Table/TableRichCellTable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Table',
name: 'Table — Rich Cell Content',
description:
'Table with rich cell content using XDSLink for emails and XDSBadge for role labels.',
diff --git a/packages/cli/templates/blocks/components/Table/TableSelectableTable.doc.mjs b/packages/cli/templates/blocks/components/Table/TableSelectableTable.doc.mjs
index 5a5ccfdf45..44eff03672 100644
--- a/packages/cli/templates/blocks/components/Table/TableSelectableTable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Table/TableSelectableTable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Table',
name: 'Table — Row Selection',
description:
'Table with row selection checkboxes and a select-all header checkbox.',
diff --git a/packages/cli/templates/blocks/components/Table/TableShowcase.doc.mjs b/packages/cli/templates/blocks/components/Table/TableShowcase.doc.mjs
index 691a3e0b2a..3ab89bd843 100644
--- a/packages/cli/templates/blocks/components/Table/TableShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Table/TableShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Table',
name: 'Table',
description:
'Data-driven table with proportional and pixel column widths and hover highlighting.',
diff --git a/packages/cli/templates/blocks/components/Table/TableSortableTable.doc.mjs b/packages/cli/templates/blocks/components/Table/TableSortableTable.doc.mjs
index cdc3d27256..61bca24ed9 100644
--- a/packages/cli/templates/blocks/components/Table/TableSortableTable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Table/TableSortableTable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Table',
name: 'Table — Sortable Columns',
description:
'Table with sortable columns, click headers to sort ascending or descending.',
diff --git a/packages/cli/templates/blocks/components/Table/TableStripedTable.doc.mjs b/packages/cli/templates/blocks/components/Table/TableStripedTable.doc.mjs
index d1d71bf405..0aa1c2eefa 100644
--- a/packages/cli/templates/blocks/components/Table/TableStripedTable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Table/TableStripedTable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Table',
name: 'Table — Striped Rows',
description:
'Table with alternating row colors and hover highlighting for easy scanning.',
diff --git a/packages/cli/templates/blocks/components/Text/TextColors.doc.mjs b/packages/cli/templates/blocks/components/Text/TextColors.doc.mjs
index c0c4cc5993..46a8dc2f62 100644
--- a/packages/cli/templates/blocks/components/Text/TextColors.doc.mjs
+++ b/packages/cli/templates/blocks/components/Text/TextColors.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Text',
name: 'Text — Colors',
description: 'All text color options (primary, secondary, disabled, placeholder, active) applied to body text to show their intended use.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Text/TextHeadingLevels.doc.mjs b/packages/cli/templates/blocks/components/Text/TextHeadingLevels.doc.mjs
index b1b1f1a90a..64dae28160 100644
--- a/packages/cli/templates/blocks/components/Text/TextHeadingLevels.doc.mjs
+++ b/packages/cli/templates/blocks/components/Text/TextHeadingLevels.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Text',
name: 'Text — Heading Levels',
description: 'All 6 heading levels (h1 through h6) rendered with XDSHeading to show the full type scale.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Text/TextInline.doc.mjs b/packages/cli/templates/blocks/components/Text/TextInline.doc.mjs
index aed6825afa..0266022b53 100644
--- a/packages/cli/templates/blocks/components/Text/TextInline.doc.mjs
+++ b/packages/cli/templates/blocks/components/Text/TextInline.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Text',
name: 'Text — Inline',
description: 'Mixing body and code text inline within a single line using the default inline display mode.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Text/TextShowcase.doc.mjs b/packages/cli/templates/blocks/components/Text/TextShowcase.doc.mjs
index 43e843b1d2..48de4b7c14 100644
--- a/packages/cli/templates/blocks/components/Text/TextShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Text/TextShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Text',
name: 'Text',
isReady: true,
aspectRatio: 16 / 9,
diff --git a/packages/cli/templates/blocks/components/Text/TextTruncation.doc.mjs b/packages/cli/templates/blocks/components/Text/TextTruncation.doc.mjs
index ddc4e67e03..fcf5cc2886 100644
--- a/packages/cli/templates/blocks/components/Text/TextTruncation.doc.mjs
+++ b/packages/cli/templates/blocks/components/Text/TextTruncation.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Text',
name: 'Text — Truncation',
description: 'Single-line and multi-line text truncation with ellipsis using maxLines in a width-constrained container.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Text/TextTypes.doc.mjs b/packages/cli/templates/blocks/components/Text/TextTypes.doc.mjs
index af61d809d3..f4d86d8780 100644
--- a/packages/cli/templates/blocks/components/Text/TextTypes.doc.mjs
+++ b/packages/cli/templates/blocks/components/Text/TextTypes.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Text',
name: 'Text — Types',
description: 'All 5 semantic text types (body, large, label, supporting, code) with their default styling from the theme.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Text/TextWeight.doc.mjs b/packages/cli/templates/blocks/components/Text/TextWeight.doc.mjs
index 612233e329..dc24ea5a99 100644
--- a/packages/cli/templates/blocks/components/Text/TextWeight.doc.mjs
+++ b/packages/cli/templates/blocks/components/Text/TextWeight.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Text',
name: 'Text — Weight',
description: 'The 4 font weight variants (normal, medium, semibold, bold) applied to body text.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Text/TextWordBreak.doc.mjs b/packages/cli/templates/blocks/components/Text/TextWordBreak.doc.mjs
index 3e65ce0965..81faf71dac 100644
--- a/packages/cli/templates/blocks/components/Text/TextWordBreak.doc.mjs
+++ b/packages/cli/templates/blocks/components/Text/TextWordBreak.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Text',
name: 'Text — Word Break',
description: 'Compares break-word and break-all word break modes on a long unbreakable string.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Text/TextWrap.doc.mjs b/packages/cli/templates/blocks/components/Text/TextWrap.doc.mjs
index 8aae44e6ff..739e40348f 100644
--- a/packages/cli/templates/blocks/components/Text/TextWrap.doc.mjs
+++ b/packages/cli/templates/blocks/components/Text/TextWrap.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Text',
name: 'Text — Wrap',
description: 'The 4 text-wrap modes (wrap, nowrap, balance, pretty) shown in width-constrained containers.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TextArea/TextAreaCharacterCount.doc.mjs b/packages/cli/templates/blocks/components/TextArea/TextAreaCharacterCount.doc.mjs
index faa9d73ed3..be9c208f6c 100644
--- a/packages/cli/templates/blocks/components/TextArea/TextAreaCharacterCount.doc.mjs
+++ b/packages/cli/templates/blocks/components/TextArea/TextAreaCharacterCount.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TextArea',
name: 'TextArea — Character Count',
description: 'Textareas with maxLength and a live character counter. The counter turns red when the limit is exceeded.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TextArea/TextAreaShowcase.doc.mjs b/packages/cli/templates/blocks/components/TextArea/TextAreaShowcase.doc.mjs
index 453573b984..a6940091bc 100644
--- a/packages/cli/templates/blocks/components/TextArea/TextAreaShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TextArea/TextAreaShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TextArea',
name: 'TextArea',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/TextArea/TextAreaStates.doc.mjs b/packages/cli/templates/blocks/components/TextArea/TextAreaStates.doc.mjs
index d61a46ebb4..8147809b52 100644
--- a/packages/cli/templates/blocks/components/TextArea/TextAreaStates.doc.mjs
+++ b/packages/cli/templates/blocks/components/TextArea/TextAreaStates.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TextArea',
name: 'TextArea — States',
description: 'Required, disabled, and loading textareas side by side. Shows the interactive states the component supports.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TextArea/TextAreaValidation.doc.mjs b/packages/cli/templates/blocks/components/TextArea/TextAreaValidation.doc.mjs
index c01dfb43d6..b01ead66a2 100644
--- a/packages/cli/templates/blocks/components/TextArea/TextAreaValidation.doc.mjs
+++ b/packages/cli/templates/blocks/components/TextArea/TextAreaValidation.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TextArea',
name: 'TextArea — Validation',
description: 'All three status variants — error, warning, and success — with status messages, plus error without a message. Use to show inline validation feedback as the user types.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TextArea/TextAreaWithIcon.doc.mjs b/packages/cli/templates/blocks/components/TextArea/TextAreaWithIcon.doc.mjs
index d9ed36bb0e..818b98c8e7 100644
--- a/packages/cli/templates/blocks/components/TextArea/TextAreaWithIcon.doc.mjs
+++ b/packages/cli/templates/blocks/components/TextArea/TextAreaWithIcon.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TextArea',
name: 'TextArea — Icon',
description: 'Textareas with a leading icon that hints at the expected content, like a chat bubble for messages or a pencil for notes.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TextInput/TextInputIcon.doc.mjs b/packages/cli/templates/blocks/components/TextInput/TextInputIcon.doc.mjs
index bfed31a354..7415e3db6b 100644
--- a/packages/cli/templates/blocks/components/TextInput/TextInputIcon.doc.mjs
+++ b/packages/cli/templates/blocks/components/TextInput/TextInputIcon.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TextInput',
name: 'TextInput — Icon',
description: 'Inputs with a leading icon that hints at the expected content. Use when the icon helps users identify the field faster, like a lock for passwords or an envelope for email.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TextInput/TextInputSearch.doc.mjs b/packages/cli/templates/blocks/components/TextInput/TextInputSearch.doc.mjs
index b302448fea..a9ebeb1e3a 100644
--- a/packages/cli/templates/blocks/components/TextInput/TextInputSearch.doc.mjs
+++ b/packages/cli/templates/blocks/components/TextInput/TextInputSearch.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TextInput',
name: 'TextInput — Search',
description: 'Search input with a hidden label, start icon, and clear button. Use for toolbar and header search bars where the icon provides sufficient context.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TextInput/TextInputShowcase.doc.mjs b/packages/cli/templates/blocks/components/TextInput/TextInputShowcase.doc.mjs
index 5642f8e18b..2a49ca10d7 100644
--- a/packages/cli/templates/blocks/components/TextInput/TextInputShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TextInput/TextInputShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TextInput',
name: 'TextInput',
isReady: true,
aspectRatio: 16 / 9,
diff --git a/packages/cli/templates/blocks/components/TextInput/TextInputSizes.doc.mjs b/packages/cli/templates/blocks/components/TextInput/TextInputSizes.doc.mjs
index 833060ee9b..4aa84e9cfe 100644
--- a/packages/cli/templates/blocks/components/TextInput/TextInputSizes.doc.mjs
+++ b/packages/cli/templates/blocks/components/TextInput/TextInputSizes.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TextInput',
name: 'TextInput — Sizes',
description: 'Small, medium, and large inputs side by side. Use small in dense UIs like table filters, medium for most forms, and large for prominent single-field pages.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TextInput/TextInputStates.doc.mjs b/packages/cli/templates/blocks/components/TextInput/TextInputStates.doc.mjs
index 02a42e61bd..b62546df59 100644
--- a/packages/cli/templates/blocks/components/TextInput/TextInputStates.doc.mjs
+++ b/packages/cli/templates/blocks/components/TextInput/TextInputStates.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TextInput',
name: 'TextInput — States',
description: 'Error, warning, and success validation states with status messages. Use to show users what went wrong and how to fix it.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TextInput/TextInputTypes.doc.mjs b/packages/cli/templates/blocks/components/TextInput/TextInputTypes.doc.mjs
index b95f9f1f6b..bf7d6d40fc 100644
--- a/packages/cli/templates/blocks/components/TextInput/TextInputTypes.doc.mjs
+++ b/packages/cli/templates/blocks/components/TextInput/TextInputTypes.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TextInput',
name: 'TextInput — Types',
description: 'Text, password, and email types plus field-level features: tooltip, required, optional, description, disabled, and loading.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailDisabled.doc.mjs b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailDisabled.doc.mjs
index 036ef1fc17..5bdc3749fb 100644
--- a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailDisabled.doc.mjs
+++ b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailDisabled.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Thumbnail',
name: 'Thumbnail — Disabled',
description: 'Thumbnails in the disabled state with reduced opacity. The remove button and click handler are suppressed when disabled.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailGallery.doc.mjs b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailGallery.doc.mjs
index 49beb84260..3446573f62 100644
--- a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailGallery.doc.mjs
+++ b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailGallery.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Thumbnail',
name: 'Thumbnail — Gallery',
description: 'A row of clickable thumbnails with labels that open a detail view. Use for image attachment lists where users need to preview and manage uploads.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailRemovable.doc.mjs b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailRemovable.doc.mjs
index f4c2926b95..c94e184805 100644
--- a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailRemovable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailRemovable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Thumbnail',
name: 'Thumbnail — Removable',
description: 'Thumbnails with a remove button overlay. The close button uses APCA luminance detection to stay visible on both dark and light images.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailShowcase.doc.mjs b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailShowcase.doc.mjs
index 1f935ae8ba..be47df5120 100644
--- a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Thumbnail',
name: 'Thumbnail',
isReady: true,
aspectRatio: 16 / 9,
diff --git a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailStates.doc.mjs b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailStates.doc.mjs
index a9a6c44761..bf28f39935 100644
--- a/packages/cli/templates/blocks/components/Thumbnail/ThumbnailStates.doc.mjs
+++ b/packages/cli/templates/blocks/components/Thumbnail/ThumbnailStates.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Thumbnail',
name: 'Thumbnail — States',
description: 'All visual states side by side: image loaded, placeholder, skeleton loading, and upload overlay. Demonstrates the full lifecycle of a thumbnail from empty to loaded.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TimeInput/TimeInputConstrained.doc.mjs b/packages/cli/templates/blocks/components/TimeInput/TimeInputConstrained.doc.mjs
index b621c726a2..a301076e9b 100644
--- a/packages/cli/templates/blocks/components/TimeInput/TimeInputConstrained.doc.mjs
+++ b/packages/cli/templates/blocks/components/TimeInput/TimeInputConstrained.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TimeInput',
name: 'TimeInput — Constrained',
description: 'Time inputs with min/max constraints limiting selection to specific windows. Use to prevent out-of-bounds selections for appointments, reservations, or shift scheduling.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TimeInput/TimeInputFormats.doc.mjs b/packages/cli/templates/blocks/components/TimeInput/TimeInputFormats.doc.mjs
index 91e4759b1f..89162bd166 100644
--- a/packages/cli/templates/blocks/components/TimeInput/TimeInputFormats.doc.mjs
+++ b/packages/cli/templates/blocks/components/TimeInput/TimeInputFormats.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TimeInput',
name: 'TimeInput — Formats',
description: '12-hour, 24-hour, and seconds formats side by side. Use 12h for US-centric UIs, 24h for international or technical contexts, and seconds for precise timing.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TimeInput/TimeInputIncrement.doc.mjs b/packages/cli/templates/blocks/components/TimeInput/TimeInputIncrement.doc.mjs
index 15583c41a5..65b4724a4a 100644
--- a/packages/cli/templates/blocks/components/TimeInput/TimeInputIncrement.doc.mjs
+++ b/packages/cli/templates/blocks/components/TimeInput/TimeInputIncrement.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TimeInput',
name: 'TimeInput — Increment',
description: 'Time input with a custom step increment. Arrow keys jump by the specified interval (e.g. 15 minutes) for quick slot-based scheduling.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TimeInput/TimeInputShowcase.doc.mjs b/packages/cli/templates/blocks/components/TimeInput/TimeInputShowcase.doc.mjs
index 504efc29f3..770efe0658 100644
--- a/packages/cli/templates/blocks/components/TimeInput/TimeInputShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TimeInput/TimeInputShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TimeInput',
name: 'TimeInput',
isReady: true,
aspectRatio: 16 / 9,
diff --git a/packages/cli/templates/blocks/components/TimeInput/TimeInputStates.doc.mjs b/packages/cli/templates/blocks/components/TimeInput/TimeInputStates.doc.mjs
index ca4974e372..10729a451e 100644
--- a/packages/cli/templates/blocks/components/TimeInput/TimeInputStates.doc.mjs
+++ b/packages/cli/templates/blocks/components/TimeInput/TimeInputStates.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TimeInput',
name: 'TimeInput — States',
description: 'Default, disabled, error, warning, and success states. Use status messages to give users clear feedback about their time selection.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Timestamp/TimestampAutoFormat.doc.mjs b/packages/cli/templates/blocks/components/Timestamp/TimestampAutoFormat.doc.mjs
index 3a49a42bcd..394cc86a4e 100644
--- a/packages/cli/templates/blocks/components/Timestamp/TimestampAutoFormat.doc.mjs
+++ b/packages/cli/templates/blocks/components/Timestamp/TimestampAutoFormat.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Timestamp',
name: 'Timestamp — Auto',
description: 'Auto format that shows relative time for recent dates and switches to the full date for older ones. The default choice for most use cases.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Timestamp/TimestampColors.doc.mjs b/packages/cli/templates/blocks/components/Timestamp/TimestampColors.doc.mjs
index 3cb6055e58..da991f64db 100644
--- a/packages/cli/templates/blocks/components/Timestamp/TimestampColors.doc.mjs
+++ b/packages/cli/templates/blocks/components/Timestamp/TimestampColors.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Timestamp',
name: 'Timestamp \u2014 Colors',
description:
'Timestamp rendered in each available color variant: primary, secondary, disabled, and active.',
diff --git a/packages/cli/templates/blocks/components/Timestamp/TimestampFormats.doc.mjs b/packages/cli/templates/blocks/components/Timestamp/TimestampFormats.doc.mjs
index 36e34ad81a..1e02004ac9 100644
--- a/packages/cli/templates/blocks/components/Timestamp/TimestampFormats.doc.mjs
+++ b/packages/cli/templates/blocks/components/Timestamp/TimestampFormats.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Timestamp',
name: 'Timestamp — Formats',
description: 'All display formats side by side: date, date_time, time, and their system equivalents. Use date and date_time for user-facing UI, system variants for logs and dev tools.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Timestamp/TimestampRelativeFormat.doc.mjs b/packages/cli/templates/blocks/components/Timestamp/TimestampRelativeFormat.doc.mjs
index 82f458d9b6..fd0573fd5c 100644
--- a/packages/cli/templates/blocks/components/Timestamp/TimestampRelativeFormat.doc.mjs
+++ b/packages/cli/templates/blocks/components/Timestamp/TimestampRelativeFormat.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Timestamp',
name: 'Timestamp — Relative',
description: 'Relative time labels from seconds to months ago, with hover tooltips showing the full date. Use in feeds, comment threads, and activity logs.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Timestamp/TimestampShowcase.doc.mjs b/packages/cli/templates/blocks/components/Timestamp/TimestampShowcase.doc.mjs
index 3d44bc0c72..1c85e9be4f 100644
--- a/packages/cli/templates/blocks/components/Timestamp/TimestampShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Timestamp/TimestampShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Timestamp',
name: 'Timestamp',
isReady: true,
aspectRatio: 16 / 9,
diff --git a/packages/cli/templates/blocks/components/Timestamp/TimestampTimezone.doc.mjs b/packages/cli/templates/blocks/components/Timestamp/TimestampTimezone.doc.mjs
index 6459dd8ed8..64bab3f5f0 100644
--- a/packages/cli/templates/blocks/components/Timestamp/TimestampTimezone.doc.mjs
+++ b/packages/cli/templates/blocks/components/Timestamp/TimestampTimezone.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Timestamp',
name: 'Timestamp — Timezone',
description: 'Timestamps with the timezone abbreviation appended. Enable isTimezoneShown for audiences across time zones, like audit logs or team calendars.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Toast/ToastAction.doc.mjs b/packages/cli/templates/blocks/components/Toast/ToastAction.doc.mjs
index fcf7ae4ebe..d9e2cd99f6 100644
--- a/packages/cli/templates/blocks/components/Toast/ToastAction.doc.mjs
+++ b/packages/cli/templates/blocks/components/Toast/ToastAction.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Toast',
name: 'Toast — Action',
description: 'Persistent toasts with a trailing button or link so the user can act on the notification, like undoing a delete or viewing a report.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Toast/ToastDeduplication.doc.mjs b/packages/cli/templates/blocks/components/Toast/ToastDeduplication.doc.mjs
index a58994bc2d..49df089992 100644
--- a/packages/cli/templates/blocks/components/Toast/ToastDeduplication.doc.mjs
+++ b/packages/cli/templates/blocks/components/Toast/ToastDeduplication.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Toast',
name: 'Toast — Deduplication',
description: 'Prevent duplicate toasts with uniqueID. Use ignore to keep the first toast, or overwrite to replace it with updated content like a progress percentage.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Toast/ToastDismiss.doc.mjs b/packages/cli/templates/blocks/components/Toast/ToastDismiss.doc.mjs
index c938dd29a4..1b3f2ab025 100644
--- a/packages/cli/templates/blocks/components/Toast/ToastDismiss.doc.mjs
+++ b/packages/cli/templates/blocks/components/Toast/ToastDismiss.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Toast',
name: 'Toast — Dismiss',
description: 'Show a persistent toast and dismiss it programmatically using the function returned by useXDSToast. Use for long-running operations that need manual cleanup.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Toast/ToastShowcase.doc.mjs b/packages/cli/templates/blocks/components/Toast/ToastShowcase.doc.mjs
index 16c2641e20..24d37bc810 100644
--- a/packages/cli/templates/blocks/components/Toast/ToastShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Toast/ToastShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Toast',
name: 'Toast',
isReady: true,
aspectRatio: 16 / 9,
diff --git a/packages/cli/templates/blocks/components/Toast/ToastStacking.doc.mjs b/packages/cli/templates/blocks/components/Toast/ToastStacking.doc.mjs
index e6dfdacaad..e4514855c2 100644
--- a/packages/cli/templates/blocks/components/Toast/ToastStacking.doc.mjs
+++ b/packages/cli/templates/blocks/components/Toast/ToastStacking.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Toast',
name: 'Toast — Stacking',
description: 'Multiple toasts stacking vertically with smooth enter and exit animations. Click repeatedly to see how toasts queue and dismiss.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Toast/ToastTypes.doc.mjs b/packages/cli/templates/blocks/components/Toast/ToastTypes.doc.mjs
index 71c3587ed0..424ccd3a39 100644
--- a/packages/cli/templates/blocks/components/Toast/ToastTypes.doc.mjs
+++ b/packages/cli/templates/blocks/components/Toast/ToastTypes.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Toast',
name: 'Toast — Types',
description: 'Info and error toast variants side by side. Info toasts auto-dismiss after 5 seconds, error toasts persist until the user dismisses them.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonColor.doc.mjs b/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonColor.doc.mjs
index e48b7c9bcb..31432a0b88 100644
--- a/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonColor.doc.mjs
+++ b/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonColor.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ToggleButton',
name: 'ToggleButton — Color',
description: 'Toggle buttons with colored icons in the pressed state. Shows accent-colored toolbar formatting and semantic reaction colors (yellow star, red heart, blue bookmark).',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonGroup.doc.mjs b/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonGroup.doc.mjs
index af8067c238..af26a89f72 100644
--- a/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonGroup.doc.mjs
+++ b/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonGroup.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ToggleButton',
name: 'ToggleButton — Group',
description: 'Toggle button groups in single-select and multi-select modes. Single selection acts as a view mode switcher; multiple selection forms a formatting toolbar.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonIconSwap.doc.mjs b/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonIconSwap.doc.mjs
index eaaee90d78..9b13428751 100644
--- a/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonIconSwap.doc.mjs
+++ b/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonIconSwap.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ToggleButton',
name: 'ToggleButton — Icon Swap',
description: 'Icon-only toggle buttons that swap between outline and solid icons when pressed. Use for actions like favorite, bookmark, or mute where the icon itself communicates the state.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonLabel.doc.mjs b/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonLabel.doc.mjs
index 14af78f3ef..80aeb30fb3 100644
--- a/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonLabel.doc.mjs
+++ b/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonLabel.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ToggleButton',
name: 'ToggleButton — Label',
description: 'Toggle buttons with visible text labels that show a font weight shift on press. Use when the icon alone is not enough to communicate the action.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonShowcase.doc.mjs b/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonShowcase.doc.mjs
index d59533bb1e..cd7ccd51d9 100644
--- a/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ToggleButton',
name: 'ToggleButton',
isReady: true,
aspectRatio: 16 / 9,
diff --git a/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonStates.doc.mjs b/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonStates.doc.mjs
index b6c925449d..71d429e27f 100644
--- a/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonStates.doc.mjs
+++ b/packages/cli/templates/blocks/components/ToggleButton/ToggleButtonStates.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ToggleButton',
name: 'ToggleButton — States',
description: 'Default, pressed, disabled, and loading states of a standalone toggle button. Shows how visual treatment changes across states.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.doc.mjs b/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.doc.mjs
index 61e5836b4d..d253662597 100644
--- a/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'ToggleButtonGroup',
name: 'ToggleButtonGroup',
description:
'ToggleButtonGroup manages a set of ToggleButtons with single-select or multi-select behavior for options like view modes or filters.',
diff --git a/packages/cli/templates/blocks/components/Token/TokenClickable.doc.mjs b/packages/cli/templates/blocks/components/Token/TokenClickable.doc.mjs
index 2b4b9ea103..49f88caebd 100644
--- a/packages/cli/templates/blocks/components/Token/TokenClickable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Token/TokenClickable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Token',
name: 'Token — Clickable',
description: 'Interactive tokens that respond to clicks. Use for toggleable filters or tokens that open a detail view when selected.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Token/TokenColors.doc.mjs b/packages/cli/templates/blocks/components/Token/TokenColors.doc.mjs
index 45b7197bb9..b387def78b 100644
--- a/packages/cli/templates/blocks/components/Token/TokenColors.doc.mjs
+++ b/packages/cli/templates/blocks/components/Token/TokenColors.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Token',
name: 'Token — Colors',
description: 'All 11 color variants in default and disabled states. Use color to categorize entities or convey status at a glance.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Token/TokenEndContent.doc.mjs b/packages/cli/templates/blocks/components/Token/TokenEndContent.doc.mjs
index 8e4c094dc1..5904ece530 100644
--- a/packages/cli/templates/blocks/components/Token/TokenEndContent.doc.mjs
+++ b/packages/cli/templates/blocks/components/Token/TokenEndContent.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Token',
name: 'Token — End Content',
description: 'Tokens with trailing content like a count badge or status indicator after the label. Use for notification counts, item quantities, or compact status info.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Token/TokenIcon.doc.mjs b/packages/cli/templates/blocks/components/Token/TokenIcon.doc.mjs
index a2d5ed7529..18e6cd0ca7 100644
--- a/packages/cli/templates/blocks/components/Token/TokenIcon.doc.mjs
+++ b/packages/cli/templates/blocks/components/Token/TokenIcon.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Token',
name: 'Token — Icon',
description: 'Tokens with a leading icon that identifies the entity type. Use when the icon helps users recognize the token category faster, like a user icon for people or a tag icon for labels.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Token/TokenRemovable.doc.mjs b/packages/cli/templates/blocks/components/Token/TokenRemovable.doc.mjs
index 43ea01a246..b63d7a9a3f 100644
--- a/packages/cli/templates/blocks/components/Token/TokenRemovable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Token/TokenRemovable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Token',
name: 'Token — Removable',
description: 'Tokens with a dismiss button for selections the user can undo. Use in multi-select fields, active filters, or any list of user-chosen items.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Token/TokenShowcase.doc.mjs b/packages/cli/templates/blocks/components/Token/TokenShowcase.doc.mjs
index a554cee8df..84063047f1 100644
--- a/packages/cli/templates/blocks/components/Token/TokenShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Token/TokenShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Token',
name: 'Token',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/Tokenizer/TokenizerClear.doc.mjs b/packages/cli/templates/blocks/components/Tokenizer/TokenizerClear.doc.mjs
index 3a8d579e0a..ba002fc3b1 100644
--- a/packages/cli/templates/blocks/components/Tokenizer/TokenizerClear.doc.mjs
+++ b/packages/cli/templates/blocks/components/Tokenizer/TokenizerClear.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Tokenizer',
name: 'Tokenizer \u2014 Clear',
description: 'Tokenizer with a built-in clear-all button for bulk removal of all selected tokens.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Tokenizer/TokenizerCreatable.doc.mjs b/packages/cli/templates/blocks/components/Tokenizer/TokenizerCreatable.doc.mjs
index 07183ea2f9..b402e52e83 100644
--- a/packages/cli/templates/blocks/components/Tokenizer/TokenizerCreatable.doc.mjs
+++ b/packages/cli/templates/blocks/components/Tokenizer/TokenizerCreatable.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Tokenizer',
name: 'Tokenizer \u2014 Creatable',
description: 'Free-text tokenizer for creating custom tags and a combined create-or-search pattern. Use when users need to enter values that may not exist in a predefined list.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Tokenizer/TokenizerEndContent.doc.mjs b/packages/cli/templates/blocks/components/Tokenizer/TokenizerEndContent.doc.mjs
index 6c7f6a9b77..681effc528 100644
--- a/packages/cli/templates/blocks/components/Tokenizer/TokenizerEndContent.doc.mjs
+++ b/packages/cli/templates/blocks/components/Tokenizer/TokenizerEndContent.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Tokenizer',
name: 'Tokenizer \u2014 End Content',
description: 'Tokenizer with an action button in the end slot. Use for inline actions like applying selections alongside the input.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Tokenizer/TokenizerIcon.doc.mjs b/packages/cli/templates/blocks/components/Tokenizer/TokenizerIcon.doc.mjs
index 94f74a8752..16f23fa0a9 100644
--- a/packages/cli/templates/blocks/components/Tokenizer/TokenizerIcon.doc.mjs
+++ b/packages/cli/templates/blocks/components/Tokenizer/TokenizerIcon.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Tokenizer',
name: 'Tokenizer \u2014 Icon',
description: 'Tokenizer with a leading search icon to visually reinforce the search behavior.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Tokenizer/TokenizerMaxEntries.doc.mjs b/packages/cli/templates/blocks/components/Tokenizer/TokenizerMaxEntries.doc.mjs
index 8591b8b4e6..762341e3bd 100644
--- a/packages/cli/templates/blocks/components/Tokenizer/TokenizerMaxEntries.doc.mjs
+++ b/packages/cli/templates/blocks/components/Tokenizer/TokenizerMaxEntries.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Tokenizer',
name: 'Tokenizer \u2014 Max Entries',
description: 'Tokenizer with a maximum selection limit. The input hides automatically when the limit is reached, preventing further additions.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Tokenizer/TokenizerOverflow.doc.mjs b/packages/cli/templates/blocks/components/Tokenizer/TokenizerOverflow.doc.mjs
index 70d8b8255b..570c2ea985 100644
--- a/packages/cli/templates/blocks/components/Tokenizer/TokenizerOverflow.doc.mjs
+++ b/packages/cli/templates/blocks/components/Tokenizer/TokenizerOverflow.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Tokenizer',
name: 'Tokenizer \u2014 Overflow',
description: 'Tokenizer with overflow truncation when unfocused. Inline mode pushes content down on expand; layer mode overlays without shifting layout.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Tokenizer/TokenizerShowcase.doc.mjs b/packages/cli/templates/blocks/components/Tokenizer/TokenizerShowcase.doc.mjs
index 8dd93da74b..3b6cf83e18 100644
--- a/packages/cli/templates/blocks/components/Tokenizer/TokenizerShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Tokenizer/TokenizerShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Tokenizer',
name: 'Tokenizer',
isReady: true,
aspectRatio: 4 / 3,
diff --git a/packages/cli/templates/blocks/components/Tokenizer/TokenizerStates.doc.mjs b/packages/cli/templates/blocks/components/Tokenizer/TokenizerStates.doc.mjs
index 42c75aca20..f47ba02a1b 100644
--- a/packages/cli/templates/blocks/components/Tokenizer/TokenizerStates.doc.mjs
+++ b/packages/cli/templates/blocks/components/Tokenizer/TokenizerStates.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Tokenizer',
name: 'Tokenizer \u2014 States',
description: 'Tokenizer in disabled, error, warning, and success states. Use to communicate validation feedback or lock a selection from editing.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Toolbar/ToolbarBulkActions.doc.mjs b/packages/cli/templates/blocks/components/Toolbar/ToolbarBulkActions.doc.mjs
index 521a487a27..f89b6fbb9c 100644
--- a/packages/cli/templates/blocks/components/Toolbar/ToolbarBulkActions.doc.mjs
+++ b/packages/cli/templates/blocks/components/Toolbar/ToolbarBulkActions.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Toolbar',
name: 'Toolbar — Bulk Actions',
description:
'A compact toolbar with the wash variant for showing bulk selection actions. Use when the user selects multiple items in a list or table and needs quick access to batch operations.',
diff --git a/packages/cli/templates/blocks/components/Toolbar/ToolbarCardHeader.doc.mjs b/packages/cli/templates/blocks/components/Toolbar/ToolbarCardHeader.doc.mjs
index 0cdfc70900..a0d9dfb8cf 100644
--- a/packages/cli/templates/blocks/components/Toolbar/ToolbarCardHeader.doc.mjs
+++ b/packages/cli/templates/blocks/components/Toolbar/ToolbarCardHeader.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Toolbar',
name: 'Toolbar — Card Header',
description:
'A toolbar as a card header with a left-aligned title and icon actions on the right. Use Toolbar instead of LayoutHeader when your card header has interactive actions — Toolbar adds start/end slot layout, keyboard navigation, and automatic size cascading. If the header is just a title with no actions, a LayoutHeader or Section is enough.',
diff --git a/packages/cli/templates/blocks/components/Toolbar/ToolbarSizes.doc.mjs b/packages/cli/templates/blocks/components/Toolbar/ToolbarSizes.doc.mjs
index 96289481ea..235b373b1c 100644
--- a/packages/cli/templates/blocks/components/Toolbar/ToolbarSizes.doc.mjs
+++ b/packages/cli/templates/blocks/components/Toolbar/ToolbarSizes.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Toolbar',
name: 'Toolbar — Sizes',
description:
'Small, medium, and large toolbars side by side. The size prop cascades to child buttons and inputs automatically. Use small in dense UIs like cards, medium for most cases, and large for spacious layouts.',
diff --git a/packages/cli/templates/blocks/components/Toolbar/ToolbarTableFilter.doc.mjs b/packages/cli/templates/blocks/components/Toolbar/ToolbarTableFilter.doc.mjs
index 4c92926519..16e326690a 100644
--- a/packages/cli/templates/blocks/components/Toolbar/ToolbarTableFilter.doc.mjs
+++ b/packages/cli/templates/blocks/components/Toolbar/ToolbarTableFilter.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Toolbar',
name: 'Toolbar — Table Filter',
description:
'A compact toolbar with a search input, filter buttons, and an overflow menu. Use above a data table to let users search, filter, and access view options.',
diff --git a/packages/cli/templates/blocks/components/Toolbar/ToolbarThreeSlot.doc.mjs b/packages/cli/templates/blocks/components/Toolbar/ToolbarThreeSlot.doc.mjs
index 7162948700..f90d227734 100644
--- a/packages/cli/templates/blocks/components/Toolbar/ToolbarThreeSlot.doc.mjs
+++ b/packages/cli/templates/blocks/components/Toolbar/ToolbarThreeSlot.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Toolbar',
name: 'Toolbar — Three Slot',
description:
'A toolbar with start, center, and end content using the three-column grid layout. Use when you need a centered title or heading with navigation and actions on either side.',
diff --git a/packages/cli/templates/blocks/components/Toolbar/ToolbarWithTabs.doc.mjs b/packages/cli/templates/blocks/components/Toolbar/ToolbarWithTabs.doc.mjs
index 5c98eb6bf0..fb0b7a2ba1 100644
--- a/packages/cli/templates/blocks/components/Toolbar/ToolbarWithTabs.doc.mjs
+++ b/packages/cli/templates/blocks/components/Toolbar/ToolbarWithTabs.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Toolbar',
name: 'Toolbar — Tab Navigation',
description:
'A toolbar with tabs in the start slot and an action button at the end. Use as a card or section header when content is split into tabs with a primary action alongside.',
diff --git a/packages/cli/templates/blocks/components/Tooltip/TooltipActionBarTooltips.doc.mjs b/packages/cli/templates/blocks/components/Tooltip/TooltipActionBarTooltips.doc.mjs
index 54a09d7f71..d9d7a09c52 100644
--- a/packages/cli/templates/blocks/components/Tooltip/TooltipActionBarTooltips.doc.mjs
+++ b/packages/cli/templates/blocks/components/Tooltip/TooltipActionBarTooltips.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Tooltip',
name: 'Tooltip — Action Bar',
description:
'Tooltips on an action button bar with contextual descriptions.',
diff --git a/packages/cli/templates/blocks/components/Tooltip/TooltipHookUsage.doc.mjs b/packages/cli/templates/blocks/components/Tooltip/TooltipHookUsage.doc.mjs
index dcc6e3a136..207eecfbd3 100644
--- a/packages/cli/templates/blocks/components/Tooltip/TooltipHookUsage.doc.mjs
+++ b/packages/cli/templates/blocks/components/Tooltip/TooltipHookUsage.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Tooltip',
name: 'Tooltip — Hook Usage',
description:
'Tooltip using the useXDSTooltip hook for programmatic control.',
diff --git a/packages/cli/templates/blocks/components/Tooltip/TooltipInlineTextTooltips.doc.mjs b/packages/cli/templates/blocks/components/Tooltip/TooltipInlineTextTooltips.doc.mjs
index 5c1afd4591..e3319e1a41 100644
--- a/packages/cli/templates/blocks/components/Tooltip/TooltipInlineTextTooltips.doc.mjs
+++ b/packages/cli/templates/blocks/components/Tooltip/TooltipInlineTextTooltips.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Tooltip',
name: 'Tooltip — Inline Text',
description:
'Tooltips on inline text terms for definitions.',
diff --git a/packages/cli/templates/blocks/components/Tooltip/TooltipShowcase.doc.mjs b/packages/cli/templates/blocks/components/Tooltip/TooltipShowcase.doc.mjs
index bff43af414..b9d275ec73 100644
--- a/packages/cli/templates/blocks/components/Tooltip/TooltipShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Tooltip/TooltipShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Tooltip',
name: 'Tooltip',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/TopNav/TopNavCenteredNavigation.doc.mjs b/packages/cli/templates/blocks/components/TopNav/TopNavCenteredNavigation.doc.mjs
index 80d55f5773..2196e60cde 100644
--- a/packages/cli/templates/blocks/components/TopNav/TopNavCenteredNavigation.doc.mjs
+++ b/packages/cli/templates/blocks/components/TopNav/TopNavCenteredNavigation.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TopNav',
name: 'TopNav — Centered Navigation',
description:
'Navigation layout with center-aligned nav items flanked by a logo heading and end actions.',
diff --git a/packages/cli/templates/blocks/components/TopNav/TopNavEnterpriseDashboard.doc.mjs b/packages/cli/templates/blocks/components/TopNav/TopNavEnterpriseDashboard.doc.mjs
index ec96a86fe9..174382df4d 100644
--- a/packages/cli/templates/blocks/components/TopNav/TopNavEnterpriseDashboard.doc.mjs
+++ b/packages/cli/templates/blocks/components/TopNav/TopNavEnterpriseDashboard.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TopNav',
name: 'TopNav — Enterprise Dashboard',
description:
'Full-featured navigation bar with icon-labeled nav items, search, notifications, and a primary CTA.',
diff --git a/packages/cli/templates/blocks/components/TopNav/TopNavHoverMenu.doc.mjs b/packages/cli/templates/blocks/components/TopNav/TopNavHoverMenu.doc.mjs
index 95df3fd417..4c2fe44cd1 100644
--- a/packages/cli/templates/blocks/components/TopNav/TopNavHoverMenu.doc.mjs
+++ b/packages/cli/templates/blocks/components/TopNav/TopNavHoverMenu.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TopNav',
name: 'TopNav — Hover Menu',
description:
'Navigation bar with a hover-triggered dropdown menu showing product items with icons and descriptions.',
diff --git a/packages/cli/templates/blocks/components/TopNav/TopNavMegaMenu.doc.mjs b/packages/cli/templates/blocks/components/TopNav/TopNavMegaMenu.doc.mjs
index 0efe7ad541..87380a66de 100644
--- a/packages/cli/templates/blocks/components/TopNav/TopNavMegaMenu.doc.mjs
+++ b/packages/cli/templates/blocks/components/TopNav/TopNavMegaMenu.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TopNav',
name: 'TopNav — Mega Menu',
description:
'Marketing-style navigation with a full-width mega menu featuring product items and a promotional featured card.',
diff --git a/packages/cli/templates/blocks/components/TopNav/TopNavMultipleDropdowns.doc.mjs b/packages/cli/templates/blocks/components/TopNav/TopNavMultipleDropdowns.doc.mjs
index d026a308dd..c2da3efefb 100644
--- a/packages/cli/templates/blocks/components/TopNav/TopNavMultipleDropdowns.doc.mjs
+++ b/packages/cli/templates/blocks/components/TopNav/TopNavMultipleDropdowns.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TopNav',
name: 'TopNav — Multiple Dropdowns',
description:
'Navigation bar with multiple hover-triggered dropdown menus that auto-close when switching between them.',
diff --git a/packages/cli/templates/blocks/components/TopNav/TopNavShowcase.doc.mjs b/packages/cli/templates/blocks/components/TopNav/TopNavShowcase.doc.mjs
index 88267ffd24..6ec932dd81 100644
--- a/packages/cli/templates/blocks/components/TopNav/TopNavShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TopNav/TopNavShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TopNav',
name: 'TopNav',
isReady: true,
aspectRatio: 3,
diff --git a/packages/cli/templates/blocks/components/TopNav/TopNavWithLogo.doc.mjs b/packages/cli/templates/blocks/components/TopNav/TopNavWithLogo.doc.mjs
index 60dd43e9dc..4032bbb782 100644
--- a/packages/cli/templates/blocks/components/TopNav/TopNavWithLogo.doc.mjs
+++ b/packages/cli/templates/blocks/components/TopNav/TopNavWithLogo.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TopNav',
name: 'TopNav — With Logo',
description:
'Navigation bar with a branded logo icon, heading link, nav items, and a profile action.',
diff --git a/packages/cli/templates/blocks/components/TopNavHeading/TopNavHeadingShowcase.doc.mjs b/packages/cli/templates/blocks/components/TopNavHeading/TopNavHeadingShowcase.doc.mjs
index 35e2c2b90e..77e50b7f37 100644
--- a/packages/cli/templates/blocks/components/TopNavHeading/TopNavHeadingShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TopNavHeading/TopNavHeadingShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TopNavHeading',
name: 'TopNavHeading',
description: 'Demonstrates XDSTopNavHeading with a logo and text, both as a plain display and as a clickable link.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TopNavItem/TopNavItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/TopNavItem/TopNavItemShowcase.doc.mjs
index 70ef52043b..b6d5191bb2 100644
--- a/packages/cli/templates/blocks/components/TopNavItem/TopNavItemShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TopNavItem/TopNavItemShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TopNavItem',
name: 'TopNavItem',
description: 'Demonstrates XDSTopNavItem with selected, icon, disabled, and default states.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TopNavMegaMenu/TopNavMegaMenuShowcase.doc.mjs b/packages/cli/templates/blocks/components/TopNavMegaMenu/TopNavMegaMenuShowcase.doc.mjs
index 39b9aff5e6..a6ad7b40fe 100644
--- a/packages/cli/templates/blocks/components/TopNavMegaMenu/TopNavMegaMenuShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TopNavMegaMenu/TopNavMegaMenuShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TopNavMegaMenu',
name: 'TopNavMegaMenu',
description: 'Demonstrates XDSTopNavMegaMenu with items and a featured card in the mega menu panel.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TopNavMegaMenuFeaturedCard/TopNavMegaMenuFeaturedCardShowcase.doc.mjs b/packages/cli/templates/blocks/components/TopNavMegaMenuFeaturedCard/TopNavMegaMenuFeaturedCardShowcase.doc.mjs
index 7df0c6dc74..34134ba2c1 100644
--- a/packages/cli/templates/blocks/components/TopNavMegaMenuFeaturedCard/TopNavMegaMenuFeaturedCardShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TopNavMegaMenuFeaturedCard/TopNavMegaMenuFeaturedCardShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TopNavMegaMenuFeaturedCard',
name: 'TopNavMegaMenuFeaturedCard',
description: 'Demonstrates XDSTopNavMegaMenuFeaturedCard with a title, description, and CTA link inside a mega menu.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TopNavMegaMenuItem/TopNavMegaMenuItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/TopNavMegaMenuItem/TopNavMegaMenuItemShowcase.doc.mjs
index 70edffc0e2..0dd1fbc6f7 100644
--- a/packages/cli/templates/blocks/components/TopNavMegaMenuItem/TopNavMegaMenuItemShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TopNavMegaMenuItem/TopNavMegaMenuItemShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TopNavMegaMenuItem',
name: 'TopNavMegaMenuItem',
description: 'Demonstrates XDSTopNavMegaMenuItem with icons, titles, and descriptions inside a mega menu.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TopNavMenu/TopNavMenuShowcase.doc.mjs b/packages/cli/templates/blocks/components/TopNavMenu/TopNavMenuShowcase.doc.mjs
index d2c8353d0f..fade5c5667 100644
--- a/packages/cli/templates/blocks/components/TopNavMenu/TopNavMenuShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TopNavMenu/TopNavMenuShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TopNavMenu',
name: 'TopNavMenu',
description: 'Demonstrates XDSTopNavMenu with a hover-triggered dropdown containing items with icons and descriptions.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TreeList/TreeListFileTreeWithIcons.doc.mjs b/packages/cli/templates/blocks/components/TreeList/TreeListFileTreeWithIcons.doc.mjs
index cf8876c1df..81ac6e534a 100644
--- a/packages/cli/templates/blocks/components/TreeList/TreeListFileTreeWithIcons.doc.mjs
+++ b/packages/cli/templates/blocks/components/TreeList/TreeListFileTreeWithIcons.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TreeList',
name: 'TreeList — File Tree With Icons',
description:
'File browser tree with folder and document icons distinguishing directories from files.',
diff --git a/packages/cli/templates/blocks/components/TreeList/TreeListInteractiveSettings.doc.mjs b/packages/cli/templates/blocks/components/TreeList/TreeListInteractiveSettings.doc.mjs
index b7017cc6ec..1b6564ddb4 100644
--- a/packages/cli/templates/blocks/components/TreeList/TreeListInteractiveSettings.doc.mjs
+++ b/packages/cli/templates/blocks/components/TreeList/TreeListInteractiveSettings.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TreeList',
name: 'TreeList — Interactive Settings',
description:
'Settings tree with clickable items and a documentation link.',
diff --git a/packages/cli/templates/blocks/components/TreeList/TreeListMailboxTree.doc.mjs b/packages/cli/templates/blocks/components/TreeList/TreeListMailboxTree.doc.mjs
index 6b0f02b803..ee5774e697 100644
--- a/packages/cli/templates/blocks/components/TreeList/TreeListMailboxTree.doc.mjs
+++ b/packages/cli/templates/blocks/components/TreeList/TreeListMailboxTree.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TreeList',
name: 'TreeList — Mailbox Tree',
description:
'Email folder tree with unread badge counts.',
diff --git a/packages/cli/templates/blocks/components/TreeList/TreeListNavigationTree.doc.mjs b/packages/cli/templates/blocks/components/TreeList/TreeListNavigationTree.doc.mjs
index a9c3fd180c..93cbd0c62b 100644
--- a/packages/cli/templates/blocks/components/TreeList/TreeListNavigationTree.doc.mjs
+++ b/packages/cli/templates/blocks/components/TreeList/TreeListNavigationTree.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TreeList',
name: 'TreeList — Navigation Tree',
description:
'Navigation tree with a selected item for the current page.',
diff --git a/packages/cli/templates/blocks/components/TreeList/TreeListShowcase.doc.mjs b/packages/cli/templates/blocks/components/TreeList/TreeListShowcase.doc.mjs
index 2f11f9dfef..54255591b3 100644
--- a/packages/cli/templates/blocks/components/TreeList/TreeListShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TreeList/TreeListShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TreeList',
name: 'TreeList',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/TreeListBranches/TreeListBranchesShowcase.doc.mjs b/packages/cli/templates/blocks/components/TreeListBranches/TreeListBranchesShowcase.doc.mjs
index 65fa9c35a1..8efd460d78 100644
--- a/packages/cli/templates/blocks/components/TreeListBranches/TreeListBranchesShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TreeListBranches/TreeListBranchesShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TreeListBranches',
name: 'TreeListBranches',
description: 'Tree with expandable branches at multiple nesting levels.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/TreeListItem/TreeListItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/TreeListItem/TreeListItemShowcase.doc.mjs
index a0e32026f9..71d35e7e17 100644
--- a/packages/cli/templates/blocks/components/TreeListItem/TreeListItemShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TreeListItem/TreeListItemShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TreeListItem',
name: 'TreeListItem',
description: 'Tree items with descriptions, icons, badges, selection, disabled state, and nested expand/collapse. TreeList is data-driven — no composed children API.',
isReady: true,
diff --git a/packages/cli/templates/blocks/components/Typeahead/TypeaheadLimitedResults.doc.mjs b/packages/cli/templates/blocks/components/Typeahead/TypeaheadLimitedResults.doc.mjs
index a4bdf5a0e6..e140947bf1 100644
--- a/packages/cli/templates/blocks/components/Typeahead/TypeaheadLimitedResults.doc.mjs
+++ b/packages/cli/templates/blocks/components/Typeahead/TypeaheadLimitedResults.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Typeahead',
name: 'Typeahead — Limited Results',
description:
'Typeahead with a capped dropdown showing at most three results.',
diff --git a/packages/cli/templates/blocks/components/Typeahead/TypeaheadSearchField.doc.mjs b/packages/cli/templates/blocks/components/Typeahead/TypeaheadSearchField.doc.mjs
index 70fa18535f..e834e0dc1e 100644
--- a/packages/cli/templates/blocks/components/Typeahead/TypeaheadSearchField.doc.mjs
+++ b/packages/cli/templates/blocks/components/Typeahead/TypeaheadSearchField.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Typeahead',
name: 'Typeahead — Search Field',
description:
'Search input with icon and suggestions on focus.',
diff --git a/packages/cli/templates/blocks/components/Typeahead/TypeaheadShowcase.doc.mjs b/packages/cli/templates/blocks/components/Typeahead/TypeaheadShowcase.doc.mjs
index f4f72a5d33..b0cd4dffd4 100644
--- a/packages/cli/templates/blocks/components/Typeahead/TypeaheadShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Typeahead/TypeaheadShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Typeahead',
name: 'Typeahead',
isReady: true,
aspectRatio: 1,
diff --git a/packages/cli/templates/blocks/components/Typeahead/TypeaheadWithHelperText.doc.mjs b/packages/cli/templates/blocks/components/Typeahead/TypeaheadWithHelperText.doc.mjs
index 92a734880f..62313cf405 100644
--- a/packages/cli/templates/blocks/components/Typeahead/TypeaheadWithHelperText.doc.mjs
+++ b/packages/cli/templates/blocks/components/Typeahead/TypeaheadWithHelperText.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Typeahead',
name: 'Typeahead — With Helper Text',
description:
'Typeahead with a description below the label.',
diff --git a/packages/cli/templates/blocks/components/Typeahead/TypeaheadWithValidation.doc.mjs b/packages/cli/templates/blocks/components/Typeahead/TypeaheadWithValidation.doc.mjs
index f4c0c42cc4..a0fbd66f28 100644
--- a/packages/cli/templates/blocks/components/Typeahead/TypeaheadWithValidation.doc.mjs
+++ b/packages/cli/templates/blocks/components/Typeahead/TypeaheadWithValidation.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'Typeahead',
name: 'Typeahead — With Validation',
description:
'Typeahead with an error validation message.',
diff --git a/packages/cli/templates/blocks/components/TypeaheadItem/TypeaheadItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/TypeaheadItem/TypeaheadItemShowcase.doc.mjs
index 26598d2b74..23d899687f 100644
--- a/packages/cli/templates/blocks/components/TypeaheadItem/TypeaheadItemShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/TypeaheadItem/TypeaheadItemShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'TypeaheadItem',
name: 'TypeaheadItem',
description:
'Typeahead with custom item rendering using XDSTypeaheadItem for avatars and descriptions.',
diff --git a/packages/cli/templates/blocks/components/VStack/VStackShowcase.doc.mjs b/packages/cli/templates/blocks/components/VStack/VStackShowcase.doc.mjs
index d359c622d7..1bc70074ff 100644
--- a/packages/cli/templates/blocks/components/VStack/VStackShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/VStack/VStackShowcase.doc.mjs
@@ -1,6 +1,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
+ exampleFor: 'VStack',
name: 'VStack',
description: 'Demonstrates XDSVStack arranging items vertically with different gaps.',
isReady: true,
diff --git a/packages/core/src/docs-types.ts b/packages/core/src/docs-types.ts
index c86c21b421..140e35ddf0 100644
--- a/packages/core/src/docs-types.ts
+++ b/packages/core/src/docs-types.ts
@@ -551,11 +551,16 @@ export interface PageTemplateDoc extends BaseTemplateDoc {
export interface BlockTemplateDoc extends BaseTemplateDoc {
type: 'block';
+ /** The component this block is an example of.
+ * Matches the component's doc name (e.g. 'Button', 'Dialog', 'Stack').
+ * Used by the docsite to show relevant examples on component detail pages. */
+ exampleFor: string;
/** Width-to-height ratio for preview containers (e.g. 16/9, 1, 3/4). */
aspectRatio: number;
/** Scale factor for the block preview (default 1). */
scale?: number;
- /** Component names this block uses, for cross-referencing. */
+ /** Component names this block uses, for cross-referencing.
+ * Powers "See also" and "Used in" sections — not for primary attribution. */
componentsUsed?: string[];
/** When true this block is the canonical "hero" showcase for a component. */
isShowcase?: boolean;