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.mjsindex 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 filelet 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.tsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.mjsindex 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.tsindex 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;