Skip to content

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

TypeScript

cleanup: remove examples, showcase from doc types (#1398)

Joey854a0018467c
diff --git a/packages/cli/src/api/component.mjs b/packages/cli/src/api/component.mjs
index a52a55d036..7b7d2c7df0 100644
--- a/packages/cli/src/api/component.mjs
+++ b/packages/cli/src/api/component.mjs
@@ -18,6 +18,7 @@ import {
import {loadDocs} from '../lib/component-loader.mjs';
import {searchComponents} from '../lib/string-utils.mjs';
import {XDSError} from './error.mjs';
+import {findShowcase} from './template.mjs';
/**
* @param {string} [name]
@@ -27,6 +28,7 @@ import {XDSError} from './error.mjs';
* @param {string} [options.category]
* @param {boolean} [options.props]
* @param {boolean} [options.source]
+ * @param {boolean} [options.showcase]
* @param {'full'|'compact'|'brief'} [options.detail]
* @param {string} [options.lang]
* @param {boolean} [options.zh]
@@ -40,6 +42,7 @@ export async function component(name, options = {}) {
category,
props = false,
source = false,
+ showcase = false,
detail = 'full',
lang = null,
zh = false,
@@ -133,6 +136,21 @@ export async function component(name, options = {}) {
return {type: 'component.detail.source', data: {component: dirName, source: fs.readFileSync(sourcePath, 'utf-8')}};
}
+ if (showcase) {
+ const match = await findShowcase(dirName);
+ if (!match) {
+ throw new XDSError(`No showcase found for "${name}"`);
+ }
+ return {
+ type: 'component.detail.showcase',
+ data: {
+ component: dirName,
+ aspectRatio: match.aspectRatio,
+ source: fs.readFileSync(match.filePath, 'utf-8'),
+ },
+ };
+ }
+
let readmePath = findComponentReadme(coreDir, dirName);
let resolvedName = dirName;
let fromExternal = null;
diff --git a/packages/cli/src/api/template.mjs b/packages/cli/src/api/template.mjs
index 031ad5eea0..dee812df02 100644
--- a/packages/cli/src/api/template.mjs
+++ b/packages/cli/src/api/template.mjs
@@ -11,6 +11,7 @@ import {loadConfig} from '../lib/config.mjs';
const TEMPLATES_DIR = path.join(CLI_ROOT, 'templates');
const PAGES_DIR = path.join(TEMPLATES_DIR, 'pages');
const BLOCKS_DIR = path.join(TEMPLATES_DIR, 'blocks');
+const SHOWCASE_DIR = path.join(TEMPLATES_DIR, 'showcase');
async function loadDocModule(docPath) {
if (!fs.existsSync(docPath)) return null;
@@ -108,6 +109,33 @@ export async function findRelatedBlocks(componentName) {
);
}
+async function discoverShowcases() {
+ if (!fs.existsSync(SHOWCASE_DIR)) return [];
+ const docFiles = fs.readdirSync(SHOWCASE_DIR).filter(f => f.endsWith('.doc.mjs'));
+ const showcases = [];
+ for (const docFile of docFiles) {
+ const basename = path.basename(docFile, '.doc.mjs');
+ const tsxPath = path.join(SHOWCASE_DIR, basename + '.tsx');
+ if (!fs.existsSync(tsxPath)) continue;
+ const docPath = path.join(SHOWCASE_DIR, docFile);
+ const doc = await loadDocModule(docPath);
+ showcases.push({
+ name: doc?.name || basename,
+ aspectRatio: doc?.aspectRatio ?? 1,
+ filePath: tsxPath,
+ docPath,
+ });
+ }
+ return showcases;
+}
+
+export async function findShowcase(componentName) {
+ const showcases = await discoverShowcases();
+ return showcases.find(s =>
+ s.name.toLowerCase() === componentName.toLowerCase(),
+ ) ?? null;
+}
+
const UBIQUITOUS = new Set([
'Text', 'Heading', 'Button', 'HStack', 'VStack', 'Link',
'StackItem', 'Icon',
diff --git a/packages/cli/src/commands/component/index.mjs b/packages/cli/src/commands/component/index.mjs
index 2fff4c6d97..c57944eebb 100644
--- a/packages/cli/src/commands/component/index.mjs
+++ b/packages/cli/src/commands/component/index.mjs
@@ -33,6 +33,7 @@ export function registerComponent(program) {
.option('--category <category>', 'List components in a specific category')
.option('--props', 'Print only the props table')
.option('--source', 'Print component source code')
+ .option('--showcase', 'Print showcase source code')
.action(async (name, options) => {
const run = getRunPrefix();
const zh = program.opts().zh || false;
@@ -57,6 +58,7 @@ export function registerComponent(program) {
category: options.category,
props: options.props,
source: options.source,
+ showcase: options.showcase,
detail,
lang, zh, dense,
});
@@ -144,6 +146,11 @@ export function registerComponent(program) {
console.log(result.data.source);
break;
}
+
+ case 'component.detail.showcase': {
+ console.log(result.data.source);
+ break;
+ }
}
});
}
diff --git a/packages/cli/src/types/api.d.ts b/packages/cli/src/types/api.d.ts
index 6ba838fa8a..3e4ffadbd9 100644
--- a/packages/cli/src/types/api.d.ts
+++ b/packages/cli/src/types/api.d.ts
@@ -11,6 +11,7 @@ import type {
ComponentDetailResponse,
ComponentDetailPropsResponse,
ComponentDetailSourceResponse,
+ ComponentDetailShowcaseResponse,
} from './component';
import type {
DocsListResponse,
@@ -48,6 +49,7 @@ export interface ComponentOptions {
category?: string;
props?: boolean;
source?: boolean;
+ showcase?: boolean;
detail?: 'full' | 'compact' | 'brief';
lang?: string;
zh?: boolean;
@@ -59,7 +61,8 @@ type ComponentResult =
| ComponentBriefResponse
| ComponentDetailResponse
| ComponentDetailPropsResponse
- | ComponentDetailSourceResponse;
+ | ComponentDetailSourceResponse
+ | ComponentDetailShowcaseResponse;
export declare function component(
name?: string,
diff --git a/packages/cli/src/types/base.d.ts b/packages/cli/src/types/base.d.ts
index b16160bb40..3bab11054a 100644
--- a/packages/cli/src/types/base.d.ts
+++ b/packages/cli/src/types/base.d.ts
@@ -12,6 +12,7 @@ import type {
ComponentDetailResponse,
ComponentDetailPropsResponse,
ComponentDetailSourceResponse,
+ ComponentDetailShowcaseResponse,
} from './component';
import type {
DiscoverListResponse,
@@ -60,6 +61,7 @@ export type CLIAnyResponse =
| ComponentDetailResponse
| ComponentDetailPropsResponse
| ComponentDetailSourceResponse
+ | ComponentDetailShowcaseResponse
| DiscoverListResponse
| DiscoverDetailResponse
| DiscoverDetailDocResponse
diff --git a/packages/cli/src/types/component.d.ts b/packages/cli/src/types/component.d.ts
index bb5cb598e9..6c271479fb 100644
--- a/packages/cli/src/types/component.d.ts
+++ b/packages/cli/src/types/component.d.ts
@@ -10,6 +10,7 @@
* xds --json component Button -> component.detail
* xds --json component Button --props -> component.detail.props
* xds --json component Button --source -> component.detail.source
+ * xds --json component Button --showcase -> component.detail.showcase
* (not found) -> CLIError
*/
@@ -50,3 +51,9 @@ export interface ComponentDetailSourceResponse {
type: 'component.detail.source';
data: {component: string; source: string};
}
+
+/** xds --json component <name> --showcase */
+export interface ComponentDetailShowcaseResponse {
+ type: 'component.detail.showcase';
+ data: {component: string; aspectRatio: number; source: string};
+}
diff --git a/packages/cli/templates/showcase/AlertDialog.doc.mjs b/packages/cli/templates/showcase/AlertDialog.doc.mjs
new file mode 100644
index 0000000000..daa537394f
--- /dev/null
+++ b/packages/cli/templates/showcase/AlertDialog.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'AlertDialog', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/AlertDialog.tsx b/packages/cli/templates/showcase/AlertDialog.tsx
new file mode 100644
index 0000000000..cf63d521e5
--- /dev/null
+++ b/packages/cli/templates/showcase/AlertDialog.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSAlertDialog} from '@xds/core/AlertDialog';
+
+export default function AlertDialogShowcase() {
+ return <XDSAlertDialog title="Confirm" description="Are you sure?" />;
+}
diff --git a/packages/cli/templates/showcase/AppShell.doc.mjs b/packages/cli/templates/showcase/AppShell.doc.mjs
new file mode 100644
index 0000000000..ce96a64b81
--- /dev/null
+++ b/packages/cli/templates/showcase/AppShell.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'AppShell', aspectRatio: 16 / 9};
diff --git a/packages/cli/templates/showcase/AppShell.tsx b/packages/cli/templates/showcase/AppShell.tsx
new file mode 100644
index 0000000000..1cfcb7ca8c
--- /dev/null
+++ b/packages/cli/templates/showcase/AppShell.tsx
@@ -0,0 +1,11 @@
+'use client';
+
+import {XDSAppShell} from '@xds/core/AppShell';
+
+export default function AppShellShowcase() {
+ return (
+ <XDSAppShell>
+ <div>Content</div>
+ </XDSAppShell>
+ );
+}
diff --git a/packages/cli/templates/showcase/AspectRatio.doc.mjs b/packages/cli/templates/showcase/AspectRatio.doc.mjs
new file mode 100644
index 0000000000..e1a4c0c9e1
--- /dev/null
+++ b/packages/cli/templates/showcase/AspectRatio.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'AspectRatio', aspectRatio: 16 / 9};
diff --git a/packages/cli/templates/showcase/AspectRatio.tsx b/packages/cli/templates/showcase/AspectRatio.tsx
new file mode 100644
index 0000000000..a85e58c1b3
--- /dev/null
+++ b/packages/cli/templates/showcase/AspectRatio.tsx
@@ -0,0 +1,11 @@
+'use client';
+
+import {XDSAspectRatio} from '@xds/core/AspectRatio';
+
+export default function AspectRatioShowcase() {
+ return (
+ <XDSAspectRatio ratio={16 / 9}>
+ <div style={{background: '#eee', height: '100%'}} />
+ </XDSAspectRatio>
+ );
+}
diff --git a/packages/cli/templates/showcase/Avatar.doc.mjs b/packages/cli/templates/showcase/Avatar.doc.mjs
new file mode 100644
index 0000000000..d16670a220
--- /dev/null
+++ b/packages/cli/templates/showcase/Avatar.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Avatar', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/Avatar.tsx b/packages/cli/templates/showcase/Avatar.tsx
new file mode 100644
index 0000000000..f40b642758
--- /dev/null
+++ b/packages/cli/templates/showcase/Avatar.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSAvatar} from '@xds/core/Avatar';
+
+export default function AvatarShowcase() {
+ return <XDSAvatar name="Jane Doe" />;
+}
diff --git a/packages/cli/templates/showcase/Badge.doc.mjs b/packages/cli/templates/showcase/Badge.doc.mjs
new file mode 100644
index 0000000000..53a645c382
--- /dev/null
+++ b/packages/cli/templates/showcase/Badge.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Badge', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/Badge.tsx b/packages/cli/templates/showcase/Badge.tsx
new file mode 100644
index 0000000000..e57458a88e
--- /dev/null
+++ b/packages/cli/templates/showcase/Badge.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSBadge} from '@xds/core/Badge';
+
+export default function BadgeShowcase() {
+ return <XDSBadge label="New" />;
+}
diff --git a/packages/cli/templates/showcase/Banner.doc.mjs b/packages/cli/templates/showcase/Banner.doc.mjs
new file mode 100644
index 0000000000..58fe833c1d
--- /dev/null
+++ b/packages/cli/templates/showcase/Banner.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Banner', aspectRatio: 16 / 4};
diff --git a/packages/cli/templates/showcase/Banner.tsx b/packages/cli/templates/showcase/Banner.tsx
new file mode 100644
index 0000000000..53c27f68e1
--- /dev/null
+++ b/packages/cli/templates/showcase/Banner.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSBanner} from '@xds/core/Banner';
+
+export default function BannerShowcase() {
+ return <XDSBanner variant="info">Important update</XDSBanner>;
+}
diff --git a/packages/cli/templates/showcase/Breadcrumbs.doc.mjs b/packages/cli/templates/showcase/Breadcrumbs.doc.mjs
new file mode 100644
index 0000000000..a03317d1f5
--- /dev/null
+++ b/packages/cli/templates/showcase/Breadcrumbs.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Breadcrumbs', aspectRatio: 16 / 4};
diff --git a/packages/cli/templates/showcase/Breadcrumbs.tsx b/packages/cli/templates/showcase/Breadcrumbs.tsx
new file mode 100644
index 0000000000..6551465677
--- /dev/null
+++ b/packages/cli/templates/showcase/Breadcrumbs.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSBreadcrumbs} from '@xds/core/Breadcrumbs';
+
+export default function BreadcrumbsShowcase() {
+ return <XDSBreadcrumbs items={[{label: 'Home'}, {label: 'Settings'}]} />;
+}
diff --git a/packages/cli/templates/showcase/Button.doc.mjs b/packages/cli/templates/showcase/Button.doc.mjs
new file mode 100644
index 0000000000..1c85006d05
--- /dev/null
+++ b/packages/cli/templates/showcase/Button.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Button', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/Button.tsx b/packages/cli/templates/showcase/Button.tsx
new file mode 100644
index 0000000000..e949f92f02
--- /dev/null
+++ b/packages/cli/templates/showcase/Button.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSButton} from '@xds/core/Button';
+
+export default function ButtonShowcase() {
+ return <XDSButton label="Click me" variant="primary" />;
+}
diff --git a/packages/cli/templates/showcase/Calendar.doc.mjs b/packages/cli/templates/showcase/Calendar.doc.mjs
new file mode 100644
index 0000000000..8f04f5af33
--- /dev/null
+++ b/packages/cli/templates/showcase/Calendar.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Calendar', aspectRatio: 3 / 4};
diff --git a/packages/cli/templates/showcase/Calendar.tsx b/packages/cli/templates/showcase/Calendar.tsx
new file mode 100644
index 0000000000..4106f6fbee
--- /dev/null
+++ b/packages/cli/templates/showcase/Calendar.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSCalendar} from '@xds/core/Calendar';
+
+export default function CalendarShowcase() {
+ return <XDSCalendar />;
+}
diff --git a/packages/cli/templates/showcase/Card.doc.mjs b/packages/cli/templates/showcase/Card.doc.mjs
new file mode 100644
index 0000000000..f0d04da95b
--- /dev/null
+++ b/packages/cli/templates/showcase/Card.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Card', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Card.tsx b/packages/cli/templates/showcase/Card.tsx
new file mode 100644
index 0000000000..d89378e438
--- /dev/null
+++ b/packages/cli/templates/showcase/Card.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSCard} from '@xds/core/Card';
+
+export default function CardShowcase() {
+ return <XDSCard>Card content</XDSCard>;
+}
diff --git a/packages/cli/templates/showcase/Carousel.doc.mjs b/packages/cli/templates/showcase/Carousel.doc.mjs
new file mode 100644
index 0000000000..3d31fd9474
--- /dev/null
+++ b/packages/cli/templates/showcase/Carousel.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Carousel', aspectRatio: 16 / 9};
diff --git a/packages/cli/templates/showcase/Carousel.tsx b/packages/cli/templates/showcase/Carousel.tsx
new file mode 100644
index 0000000000..d3819f390f
--- /dev/null
+++ b/packages/cli/templates/showcase/Carousel.tsx
@@ -0,0 +1,11 @@
+'use client';
+
+import {XDSCarousel} from '@xds/core/Carousel';
+
+export default function CarouselShowcase() {
+ return (
+ <XDSCarousel>
+ <div>Slide 1</div>
+ </XDSCarousel>
+ );
+}
diff --git a/packages/cli/templates/showcase/Center.doc.mjs b/packages/cli/templates/showcase/Center.doc.mjs
new file mode 100644
index 0000000000..a84e28837e
--- /dev/null
+++ b/packages/cli/templates/showcase/Center.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Center', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/Center.tsx b/packages/cli/templates/showcase/Center.tsx
new file mode 100644
index 0000000000..1a051b84f0
--- /dev/null
+++ b/packages/cli/templates/showcase/Center.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSCenter} from '@xds/core/Center';
+
+export default function CenterShowcase() {
+ return <XDSCenter>Centered</XDSCenter>;
+}
diff --git a/packages/cli/templates/showcase/Chat.doc.mjs b/packages/cli/templates/showcase/Chat.doc.mjs
new file mode 100644
index 0000000000..5a344d13b9
--- /dev/null
+++ b/packages/cli/templates/showcase/Chat.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Chat', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Chat.tsx b/packages/cli/templates/showcase/Chat.tsx
new file mode 100644
index 0000000000..728fc6b158
--- /dev/null
+++ b/packages/cli/templates/showcase/Chat.tsx
@@ -0,0 +1,17 @@
+'use client';
+
+import {
+ XDSChatMessageList,
+ XDSChatMessage,
+ XDSChatBubble,
+} from '@xds/core/Chat';
+
+export default function ChatShowcase() {
+ return (
+ <XDSChatMessageList>
+ <XDSChatMessage sender="user">
+ <XDSChatBubble>Hello</XDSChatBubble>
+ </XDSChatMessage>
+ </XDSChatMessageList>
+ );
+}
diff --git a/packages/cli/templates/showcase/CheckboxInput.doc.mjs b/packages/cli/templates/showcase/CheckboxInput.doc.mjs
new file mode 100644
index 0000000000..032bb2bc34
--- /dev/null
+++ b/packages/cli/templates/showcase/CheckboxInput.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'CheckboxInput', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/CheckboxInput.tsx b/packages/cli/templates/showcase/CheckboxInput.tsx
new file mode 100644
index 0000000000..7be744b299
--- /dev/null
+++ b/packages/cli/templates/showcase/CheckboxInput.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSCheckboxInput} from '@xds/core/CheckboxInput';
+
+export default function CheckboxInputShowcase() {
+ return <XDSCheckboxInput label="Accept terms" />;
+}
diff --git a/packages/cli/templates/showcase/CheckboxList.doc.mjs b/packages/cli/templates/showcase/CheckboxList.doc.mjs
new file mode 100644
index 0000000000..91c0b81b77
--- /dev/null
+++ b/packages/cli/templates/showcase/CheckboxList.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'CheckboxList', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/CheckboxList.tsx b/packages/cli/templates/showcase/CheckboxList.tsx
new file mode 100644
index 0000000000..0961638ec5
--- /dev/null
+++ b/packages/cli/templates/showcase/CheckboxList.tsx
@@ -0,0 +1,12 @@
+'use client';
+
+import {XDSCheckboxList} from '@xds/core/CheckboxList';
+
+export default function CheckboxListShowcase() {
+ return (
+ <XDSCheckboxList
+ label="Options"
+ items={[{label: 'Option A', value: 'a'}]}
+ />
+ );
+}
diff --git a/packages/cli/templates/showcase/Collapsible.doc.mjs b/packages/cli/templates/showcase/Collapsible.doc.mjs
new file mode 100644
index 0000000000..dd2926bf9d
--- /dev/null
+++ b/packages/cli/templates/showcase/Collapsible.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Collapsible', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Collapsible.tsx b/packages/cli/templates/showcase/Collapsible.tsx
new file mode 100644
index 0000000000..4cb8a55e37
--- /dev/null
+++ b/packages/cli/templates/showcase/Collapsible.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSCollapsible} from '@xds/core/Collapsible';
+
+export default function CollapsibleShowcase() {
+ return <XDSCollapsible trigger="Details">Hidden content</XDSCollapsible>;
+}
diff --git a/packages/cli/templates/showcase/DateInput.doc.mjs b/packages/cli/templates/showcase/DateInput.doc.mjs
new file mode 100644
index 0000000000..963bc6cb4e
--- /dev/null
+++ b/packages/cli/templates/showcase/DateInput.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'DateInput', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/DateInput.tsx b/packages/cli/templates/showcase/DateInput.tsx
new file mode 100644
index 0000000000..8edfa49722
--- /dev/null
+++ b/packages/cli/templates/showcase/DateInput.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSDateInput} from '@xds/core/DateInput';
+
+export default function DateInputShowcase() {
+ return <XDSDateInput label="Date" />;
+}
diff --git a/packages/cli/templates/showcase/Dialog.doc.mjs b/packages/cli/templates/showcase/Dialog.doc.mjs
new file mode 100644
index 0000000000..76e7f2167c
--- /dev/null
+++ b/packages/cli/templates/showcase/Dialog.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Dialog', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Dialog.tsx b/packages/cli/templates/showcase/Dialog.tsx
new file mode 100644
index 0000000000..a065f27d62
--- /dev/null
+++ b/packages/cli/templates/showcase/Dialog.tsx
@@ -0,0 +1,11 @@
+'use client';
+
+import {XDSDialog} from '@xds/core/Dialog';
+
+export default function DialogShowcase() {
+ return (
+ <XDSDialog isOpen={true} onOpenChange={() => {}}>
+ Dialog content
+ </XDSDialog>
+ );
+}
diff --git a/packages/cli/templates/showcase/Divider.doc.mjs b/packages/cli/templates/showcase/Divider.doc.mjs
new file mode 100644
index 0000000000..6773abaed9
--- /dev/null
+++ b/packages/cli/templates/showcase/Divider.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Divider', aspectRatio: 16 / 4};
diff --git a/packages/cli/templates/showcase/Divider.tsx b/packages/cli/templates/showcase/Divider.tsx
new file mode 100644
index 0000000000..c6d7416d71
--- /dev/null
+++ b/packages/cli/templates/showcase/Divider.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSDivider} from '@xds/core/Divider';
+
+export default function DividerShowcase() {
+ return <XDSDivider />;
+}
diff --git a/packages/cli/templates/showcase/DropdownMenu.doc.mjs b/packages/cli/templates/showcase/DropdownMenu.doc.mjs
new file mode 100644
index 0000000000..48e6f418c7
--- /dev/null
+++ b/packages/cli/templates/showcase/DropdownMenu.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'DropdownMenu', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/DropdownMenu.tsx b/packages/cli/templates/showcase/DropdownMenu.tsx
new file mode 100644
index 0000000000..62f8c9d5f4
--- /dev/null
+++ b/packages/cli/templates/showcase/DropdownMenu.tsx
@@ -0,0 +1,12 @@
+'use client';
+
+import {XDSDropdownMenu} from '@xds/core/DropdownMenu';
+
+export default function DropdownMenuShowcase() {
+ return (
+ <XDSDropdownMenu
+ trigger={<button>Menu</button>}
+ items={[{label: 'Edit'}]}
+ />
+ );
+}
diff --git a/packages/cli/templates/showcase/EmptyState.doc.mjs b/packages/cli/templates/showcase/EmptyState.doc.mjs
new file mode 100644
index 0000000000..7a69b729a5
--- /dev/null
+++ b/packages/cli/templates/showcase/EmptyState.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'EmptyState', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/EmptyState.tsx b/packages/cli/templates/showcase/EmptyState.tsx
new file mode 100644
index 0000000000..d779fac096
--- /dev/null
+++ b/packages/cli/templates/showcase/EmptyState.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSEmptyState} from '@xds/core/EmptyState';
+
+export default function EmptyStateShowcase() {
+ return <XDSEmptyState title="No results" />;
+}
diff --git a/packages/cli/templates/showcase/Field.doc.mjs b/packages/cli/templates/showcase/Field.doc.mjs
new file mode 100644
index 0000000000..5d9c0ca96c
--- /dev/null
+++ b/packages/cli/templates/showcase/Field.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Field', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Field.tsx b/packages/cli/templates/showcase/Field.tsx
new file mode 100644
index 0000000000..d73d51058c
--- /dev/null
+++ b/packages/cli/templates/showcase/Field.tsx
@@ -0,0 +1,11 @@
+'use client';
+
+import {XDSField} from '@xds/core/Field';
+
+export default function FieldShowcase() {
+ return (
+ <XDSField label="Name">
+ <input />
+ </XDSField>
+ );
+}
diff --git a/packages/cli/templates/showcase/FormLayout.doc.mjs b/packages/cli/templates/showcase/FormLayout.doc.mjs
new file mode 100644
index 0000000000..876cf1c6f5
--- /dev/null
+++ b/packages/cli/templates/showcase/FormLayout.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'FormLayout', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/FormLayout.tsx b/packages/cli/templates/showcase/FormLayout.tsx
new file mode 100644
index 0000000000..42a7380b8f
--- /dev/null
+++ b/packages/cli/templates/showcase/FormLayout.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSFormLayout} from '@xds/core/FormLayout';
+
+export default function FormLayoutShowcase() {
+ return <XDSFormLayout>Form fields</XDSFormLayout>;
+}
diff --git a/packages/cli/templates/showcase/Grid.doc.mjs b/packages/cli/templates/showcase/Grid.doc.mjs
new file mode 100644
index 0000000000..0c784859bc
--- /dev/null
+++ b/packages/cli/templates/showcase/Grid.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Grid', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Grid.tsx b/packages/cli/templates/showcase/Grid.tsx
new file mode 100644
index 0000000000..dc18f750d2
--- /dev/null
+++ b/packages/cli/templates/showcase/Grid.tsx
@@ -0,0 +1,13 @@
+'use client';
+
+import {XDSGrid} from '@xds/core/Grid';
+
+export default function GridShowcase() {
+ return (
+ <XDSGrid columns={3}>
+ <div>1</div>
+ <div>2</div>
+ <div>3</div>
+ </XDSGrid>
+ );
+}
diff --git a/packages/cli/templates/showcase/HoverCard.doc.mjs b/packages/cli/templates/showcase/HoverCard.doc.mjs
new file mode 100644
index 0000000000..d69c8a112e
--- /dev/null
+++ b/packages/cli/templates/showcase/HoverCard.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'HoverCard', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/HoverCard.tsx b/packages/cli/templates/showcase/HoverCard.tsx
new file mode 100644
index 0000000000..373a463eaf
--- /dev/null
+++ b/packages/cli/templates/showcase/HoverCard.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSHoverCard} from '@xds/core/HoverCard';
+
+export default function HoverCardShowcase() {
+ return <XDSHoverCard trigger={<span>Hover</span>}>Details</XDSHoverCard>;
+}
diff --git a/packages/cli/templates/showcase/Icon.doc.mjs b/packages/cli/templates/showcase/Icon.doc.mjs
new file mode 100644
index 0000000000..44c9a1d7b6
--- /dev/null
+++ b/packages/cli/templates/showcase/Icon.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Icon', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/Icon.tsx b/packages/cli/templates/showcase/Icon.tsx
new file mode 100644
index 0000000000..c41893b5e8
--- /dev/null
+++ b/packages/cli/templates/showcase/Icon.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSIcon} from '@xds/core/Icon';
+
+export default function IconShowcase() {
+ return <XDSIcon name="star" />;
+}
diff --git a/packages/cli/templates/showcase/IconButton.doc.mjs b/packages/cli/templates/showcase/IconButton.doc.mjs
new file mode 100644
index 0000000000..5634b9a105
--- /dev/null
+++ b/packages/cli/templates/showcase/IconButton.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'IconButton', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/IconButton.tsx b/packages/cli/templates/showcase/IconButton.tsx
new file mode 100644
index 0000000000..13eaaf4b29
--- /dev/null
+++ b/packages/cli/templates/showcase/IconButton.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSIconButton} from '@xds/core/IconButton';
+
+export default function IconButtonShowcase() {
+ return <XDSIconButton label="Settings" icon="gear" />;
+}
diff --git a/packages/cli/templates/showcase/Kbd.doc.mjs b/packages/cli/templates/showcase/Kbd.doc.mjs
new file mode 100644
index 0000000000..710597ce74
--- /dev/null
+++ b/packages/cli/templates/showcase/Kbd.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Kbd', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/Kbd.tsx b/packages/cli/templates/showcase/Kbd.tsx
new file mode 100644
index 0000000000..97f237fc15
--- /dev/null
+++ b/packages/cli/templates/showcase/Kbd.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSKbd} from '@xds/core/Kbd';
+
+export default function KbdShowcase() {
+ return <XDSKbd>⌘K</XDSKbd>;
+}
diff --git a/packages/cli/templates/showcase/Layer.doc.mjs b/packages/cli/templates/showcase/Layer.doc.mjs
new file mode 100644
index 0000000000..78d899bf4d
--- /dev/null
+++ b/packages/cli/templates/showcase/Layer.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Layer', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/Layer.tsx b/packages/cli/templates/showcase/Layer.tsx
new file mode 100644
index 0000000000..b5517ccc12
--- /dev/null
+++ b/packages/cli/templates/showcase/Layer.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSLayer} from '@xds/core/Layer';
+
+export default function LayerShowcase() {
+ return <XDSLayer>Layer content</XDSLayer>;
+}
diff --git a/packages/cli/templates/showcase/Layout.doc.mjs b/packages/cli/templates/showcase/Layout.doc.mjs
new file mode 100644
index 0000000000..4e8d24267b
--- /dev/null
+++ b/packages/cli/templates/showcase/Layout.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Layout', aspectRatio: 16 / 9};
diff --git a/packages/cli/templates/showcase/Layout.tsx b/packages/cli/templates/showcase/Layout.tsx
new file mode 100644
index 0000000000..81e46911e4
--- /dev/null
+++ b/packages/cli/templates/showcase/Layout.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSLayout} from '@xds/core/Layout';
+
+export default function LayoutShowcase() {
+ return <XDSLayout>Layout content</XDSLayout>;
+}
diff --git a/packages/cli/templates/showcase/Link.doc.mjs b/packages/cli/templates/showcase/Link.doc.mjs
new file mode 100644
index 0000000000..f7bbf04c11
--- /dev/null
+++ b/packages/cli/templates/showcase/Link.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Link', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/Link.tsx b/packages/cli/templates/showcase/Link.tsx
new file mode 100644
index 0000000000..a204b7cf3c
--- /dev/null
+++ b/packages/cli/templates/showcase/Link.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSLink} from '@xds/core/Link';
+
+export default function LinkShowcase() {
+ return <XDSLink href="#">Link text</XDSLink>;
+}
diff --git a/packages/cli/templates/showcase/List.doc.mjs b/packages/cli/templates/showcase/List.doc.mjs
new file mode 100644
index 0000000000..6d498280ee
--- /dev/null
+++ b/packages/cli/templates/showcase/List.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'List', aspectRatio: 3 / 4};
diff --git a/packages/cli/templates/showcase/List.tsx b/packages/cli/templates/showcase/List.tsx
new file mode 100644
index 0000000000..726e048c9b
--- /dev/null
+++ b/packages/cli/templates/showcase/List.tsx
@@ -0,0 +1,11 @@
+'use client';
+
+import {XDSList, XDSListItem} from '@xds/core/List';
+
+export default function ListShowcase() {
+ return (
+ <XDSList>
+ <XDSListItem>Item 1</XDSListItem>
+ </XDSList>
+ );
+}
diff --git a/packages/cli/templates/showcase/Markdown.doc.mjs b/packages/cli/templates/showcase/Markdown.doc.mjs
new file mode 100644
index 0000000000..ad0867548a
--- /dev/null
+++ b/packages/cli/templates/showcase/Markdown.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Markdown', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Markdown.tsx b/packages/cli/templates/showcase/Markdown.tsx
new file mode 100644
index 0000000000..500ed357ab
--- /dev/null
+++ b/packages/cli/templates/showcase/Markdown.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSMarkdown} from '@xds/core/Markdown';
+
+export default function MarkdownShowcase() {
+ return <XDSMarkdown content="# Hello" />;
+}
diff --git a/packages/cli/templates/showcase/MetadataList.doc.mjs b/packages/cli/templates/showcase/MetadataList.doc.mjs
new file mode 100644
index 0000000000..9703d4ab3b
--- /dev/null
+++ b/packages/cli/templates/showcase/MetadataList.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'MetadataList', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/MetadataList.tsx b/packages/cli/templates/showcase/MetadataList.tsx
new file mode 100644
index 0000000000..0ab70c8987
--- /dev/null
+++ b/packages/cli/templates/showcase/MetadataList.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSMetadataList} from '@xds/core/MetadataList';
+
+export default function MetadataListShowcase() {
+ return <XDSMetadataList items={[{label: 'Status', value: 'Active'}]} />;
+}
diff --git a/packages/cli/templates/showcase/MobileNav.doc.mjs b/packages/cli/templates/showcase/MobileNav.doc.mjs
new file mode 100644
index 0000000000..901916e812
--- /dev/null
+++ b/packages/cli/templates/showcase/MobileNav.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'MobileNav', aspectRatio: 3 / 4};
diff --git a/packages/cli/templates/showcase/MobileNav.tsx b/packages/cli/templates/showcase/MobileNav.tsx
new file mode 100644
index 0000000000..742e21587e
--- /dev/null
+++ b/packages/cli/templates/showcase/MobileNav.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSMobileNav} from '@xds/core/MobileNav';
+
+export default function MobileNavShowcase() {
+ return <XDSMobileNav>Nav items</XDSMobileNav>;
+}
diff --git a/packages/cli/templates/showcase/MoreMenu.doc.mjs b/packages/cli/templates/showcase/MoreMenu.doc.mjs
new file mode 100644
index 0000000000..c9db61734c
--- /dev/null
+++ b/packages/cli/templates/showcase/MoreMenu.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'MoreMenu', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/MoreMenu.tsx b/packages/cli/templates/showcase/MoreMenu.tsx
new file mode 100644
index 0000000000..959f9b82c9
--- /dev/null
+++ b/packages/cli/templates/showcase/MoreMenu.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSMoreMenu} from '@xds/core/MoreMenu';
+
+export default function MoreMenuShowcase() {
+ return <XDSMoreMenu items={[{label: 'Edit'}]} />;
+}
diff --git a/packages/cli/templates/showcase/MultiSelector.doc.mjs b/packages/cli/templates/showcase/MultiSelector.doc.mjs
new file mode 100644
index 0000000000..71b2e87074
--- /dev/null
+++ b/packages/cli/templates/showcase/MultiSelector.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'MultiSelector', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/MultiSelector.tsx b/packages/cli/templates/showcase/MultiSelector.tsx
new file mode 100644
index 0000000000..3d6dac2a69
--- /dev/null
+++ b/packages/cli/templates/showcase/MultiSelector.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSMultiSelector} from '@xds/core/MultiSelector';
+
+export default function MultiSelectorShowcase() {
+ return <XDSMultiSelector label="Tags" items={[]} />;
+}
diff --git a/packages/cli/templates/showcase/NavIcon.doc.mjs b/packages/cli/templates/showcase/NavIcon.doc.mjs
new file mode 100644
index 0000000000..2e1eb4f861
--- /dev/null
+++ b/packages/cli/templates/showcase/NavIcon.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'NavIcon', aspectRatio: 16 / 4};
diff --git a/packages/cli/templates/showcase/NavIcon.tsx b/packages/cli/templates/showcase/NavIcon.tsx
new file mode 100644
index 0000000000..a3ee5bf05a
--- /dev/null
+++ b/packages/cli/templates/showcase/NavIcon.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSNavIcon} from '@xds/core/NavIcon';
+
+export default function NavIconShowcase() {
+ return <XDSNavIcon label="Home" />;
+}
diff --git a/packages/cli/templates/showcase/NumberInput.doc.mjs b/packages/cli/templates/showcase/NumberInput.doc.mjs
new file mode 100644
index 0000000000..31a0a246af
--- /dev/null
+++ b/packages/cli/templates/showcase/NumberInput.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'NumberInput', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/NumberInput.tsx b/packages/cli/templates/showcase/NumberInput.tsx
new file mode 100644
index 0000000000..8203a2fe6c
--- /dev/null
+++ b/packages/cli/templates/showcase/NumberInput.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSNumberInput} from '@xds/core/NumberInput';
+
+export default function NumberInputShowcase() {
+ return <XDSNumberInput label="Amount" value={0} onChange={() => {}} />;
+}
diff --git a/packages/cli/templates/showcase/OverflowList.doc.mjs b/packages/cli/templates/showcase/OverflowList.doc.mjs
new file mode 100644
index 0000000000..0e257193f1
--- /dev/null
+++ b/packages/cli/templates/showcase/OverflowList.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'OverflowList', aspectRatio: 16 / 4};
diff --git a/packages/cli/templates/showcase/OverflowList.tsx b/packages/cli/templates/showcase/OverflowList.tsx
new file mode 100644
index 0000000000..818be7ba74
--- /dev/null
+++ b/packages/cli/templates/showcase/OverflowList.tsx
@@ -0,0 +1,13 @@
+'use client';
+
+import {XDSOverflowList} from '@xds/core/OverflowList';
+
+export default function OverflowListShowcase() {
+ return (
+ <XDSOverflowList
+ items={[]}
+ renderItem={() => null}
+ renderOverflow={() => null}
+ />
+ );
+}
diff --git a/packages/cli/templates/showcase/Pagination.doc.mjs b/packages/cli/templates/showcase/Pagination.doc.mjs
new file mode 100644
index 0000000000..c8abf2e101
--- /dev/null
+++ b/packages/cli/templates/showcase/Pagination.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Pagination', aspectRatio: 16 / 4};
diff --git a/packages/cli/templates/showcase/Pagination.tsx b/packages/cli/templates/showcase/Pagination.tsx
new file mode 100644
index 0000000000..0529c54d3c
--- /dev/null
+++ b/packages/cli/templates/showcase/Pagination.tsx
@@ -0,0 +1,9 @@
+'use client';
+
+import {XDSPagination} from '@xds/core/Pagination';
+
+export default function PaginationShowcase() {
+ return (
+ <XDSPagination totalPages={10} currentPage={1} onPageChange={() => {}} />
+ );
+}
diff --git a/packages/cli/templates/showcase/Popover.doc.mjs b/packages/cli/templates/showcase/Popover.doc.mjs
new file mode 100644
index 0000000000..484b9752ac
--- /dev/null
+++ b/packages/cli/templates/showcase/Popover.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Popover', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Popover.tsx b/packages/cli/templates/showcase/Popover.tsx
new file mode 100644
index 0000000000..e22a3976c3
--- /dev/null
+++ b/packages/cli/templates/showcase/Popover.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSPopover} from '@xds/core/Popover';
+
+export default function PopoverShowcase() {
+ return <XDSPopover trigger={<button>Open</button>}>Content</XDSPopover>;
+}
diff --git a/packages/cli/templates/showcase/PowerSearch.doc.mjs b/packages/cli/templates/showcase/PowerSearch.doc.mjs
new file mode 100644
index 0000000000..73ac965640
--- /dev/null
+++ b/packages/cli/templates/showcase/PowerSearch.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'PowerSearch', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/PowerSearch.tsx b/packages/cli/templates/showcase/PowerSearch.tsx
new file mode 100644
index 0000000000..84dd7359e2
--- /dev/null
+++ b/packages/cli/templates/showcase/PowerSearch.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSPowerSearch} from '@xds/core/PowerSearch';
+
+export default function PowerSearchShowcase() {
+ return <XDSPowerSearch config={{name: 'search', fields: []}} />;
+}
diff --git a/packages/cli/templates/showcase/ProgressBar.doc.mjs b/packages/cli/templates/showcase/ProgressBar.doc.mjs
new file mode 100644
index 0000000000..3b634d8d8e
--- /dev/null
+++ b/packages/cli/templates/showcase/ProgressBar.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'ProgressBar', aspectRatio: 16 / 4};
diff --git a/packages/cli/templates/showcase/ProgressBar.tsx b/packages/cli/templates/showcase/ProgressBar.tsx
new file mode 100644
index 0000000000..0d8c6ef726
--- /dev/null
+++ b/packages/cli/templates/showcase/ProgressBar.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSProgressBar} from '@xds/core/ProgressBar';
+
+export default function ProgressBarShowcase() {
+ return <XDSProgressBar label="Loading" value={60} />;
+}
diff --git a/packages/cli/templates/showcase/RadioList.doc.mjs b/packages/cli/templates/showcase/RadioList.doc.mjs
new file mode 100644
index 0000000000..5bc2433b16
--- /dev/null
+++ b/packages/cli/templates/showcase/RadioList.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'RadioList', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/RadioList.tsx b/packages/cli/templates/showcase/RadioList.tsx
new file mode 100644
index 0000000000..2ba4a068ee
--- /dev/null
+++ b/packages/cli/templates/showcase/RadioList.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSRadioList} from '@xds/core/RadioList';
+
+export default function RadioListShowcase() {
+ return <XDSRadioList label="Choice" items={[{label: 'A', value: 'a'}]} />;
+}
diff --git a/packages/cli/templates/showcase/Section.doc.mjs b/packages/cli/templates/showcase/Section.doc.mjs
new file mode 100644
index 0000000000..3ebbcf5202
--- /dev/null
+++ b/packages/cli/templates/showcase/Section.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Section', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Section.tsx b/packages/cli/templates/showcase/Section.tsx
new file mode 100644
index 0000000000..8c62ecd521
--- /dev/null
+++ b/packages/cli/templates/showcase/Section.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSSection} from '@xds/core/Section';
+
+export default function SectionShowcase() {
+ return <XDSSection title="Section">Content</XDSSection>;
+}
diff --git a/packages/cli/templates/showcase/SegmentedControl.doc.mjs b/packages/cli/templates/showcase/SegmentedControl.doc.mjs
new file mode 100644
index 0000000000..2d1bfaab14
--- /dev/null
+++ b/packages/cli/templates/showcase/SegmentedControl.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'SegmentedControl', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/SegmentedControl.tsx b/packages/cli/templates/showcase/SegmentedControl.tsx
new file mode 100644
index 0000000000..9bf32239bb
--- /dev/null
+++ b/packages/cli/templates/showcase/SegmentedControl.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSSegmentedControl} from '@xds/core/SegmentedControl';
+
+export default function SegmentedControlShowcase() {
+ return <XDSSegmentedControl items={[{label: 'Tab 1', value: '1'}]} />;
+}
diff --git a/packages/cli/templates/showcase/Selector.doc.mjs b/packages/cli/templates/showcase/Selector.doc.mjs
new file mode 100644
index 0000000000..23792a4f32
--- /dev/null
+++ b/packages/cli/templates/showcase/Selector.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Selector', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Selector.tsx b/packages/cli/templates/showcase/Selector.tsx
new file mode 100644
index 0000000000..049f216501
--- /dev/null
+++ b/packages/cli/templates/showcase/Selector.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSSelector} from '@xds/core/Selector';
+
+export default function SelectorShowcase() {
+ return <XDSSelector label="Choose" items={['Option A', 'Option B']} />;
+}
diff --git a/packages/cli/templates/showcase/SideNav.doc.mjs b/packages/cli/templates/showcase/SideNav.doc.mjs
new file mode 100644
index 0000000000..f65f1e2e00
--- /dev/null
+++ b/packages/cli/templates/showcase/SideNav.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'SideNav', aspectRatio: 3 / 4};
diff --git a/packages/cli/templates/showcase/SideNav.tsx b/packages/cli/templates/showcase/SideNav.tsx
new file mode 100644
index 0000000000..cdfb5e69ec
--- /dev/null
+++ b/packages/cli/templates/showcase/SideNav.tsx
@@ -0,0 +1,11 @@
+'use client';
+
+import {XDSSideNav, XDSSideNavItem} from '@xds/core/SideNav';
+
+export default function SideNavShowcase() {
+ return (
+ <XDSSideNav>
+ <XDSSideNavItem label="Dashboard" />
+ </XDSSideNav>
+ );
+}
diff --git a/packages/cli/templates/showcase/Skeleton.doc.mjs b/packages/cli/templates/showcase/Skeleton.doc.mjs
new file mode 100644
index 0000000000..9f130245a1
--- /dev/null
+++ b/packages/cli/templates/showcase/Skeleton.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Skeleton', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Skeleton.tsx b/packages/cli/templates/showcase/Skeleton.tsx
new file mode 100644
index 0000000000..fa7855f461
--- /dev/null
+++ b/packages/cli/templates/showcase/Skeleton.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSSkeleton} from '@xds/core/Skeleton';
+
+export default function SkeletonShowcase() {
+ return <XDSSkeleton />;
+}
diff --git a/packages/cli/templates/showcase/Slider.doc.mjs b/packages/cli/templates/showcase/Slider.doc.mjs
new file mode 100644
index 0000000000..d26165e29d
--- /dev/null
+++ b/packages/cli/templates/showcase/Slider.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Slider', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Slider.tsx b/packages/cli/templates/showcase/Slider.tsx
new file mode 100644
index 0000000000..61e8856572
--- /dev/null
+++ b/packages/cli/templates/showcase/Slider.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSSlider} from '@xds/core/Slider';
+
+export default function SliderShowcase() {
+ return <XDSSlider label="Volume" value={50} onChange={() => {}} />;
+}
diff --git a/packages/cli/templates/showcase/Spinner.doc.mjs b/packages/cli/templates/showcase/Spinner.doc.mjs
new file mode 100644
index 0000000000..041dc5c5d6
--- /dev/null
+++ b/packages/cli/templates/showcase/Spinner.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Spinner', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/Spinner.tsx b/packages/cli/templates/showcase/Spinner.tsx
new file mode 100644
index 0000000000..ac7994b60d
--- /dev/null
+++ b/packages/cli/templates/showcase/Spinner.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSSpinner} from '@xds/core/Spinner';
+
+export default function SpinnerShowcase() {
+ return <XDSSpinner label="Loading" />;
+}
diff --git a/packages/cli/templates/showcase/Stack.doc.mjs b/packages/cli/templates/showcase/Stack.doc.mjs
new file mode 100644
index 0000000000..d8d97de1b8
--- /dev/null
+++ b/packages/cli/templates/showcase/Stack.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Stack', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Stack.tsx b/packages/cli/templates/showcase/Stack.tsx
new file mode 100644
index 0000000000..653ac8975c
--- /dev/null
+++ b/packages/cli/templates/showcase/Stack.tsx
@@ -0,0 +1,12 @@
+'use client';
+
+import {XDSVStack} from '@xds/core/Stack';
+
+export default function StackShowcase() {
+ return (
+ <XDSVStack gap={2}>
+ <div>Item 1</div>
+ <div>Item 2</div>
+ </XDSVStack>
+ );
+}
diff --git a/packages/cli/templates/showcase/StatusDot.doc.mjs b/packages/cli/templates/showcase/StatusDot.doc.mjs
new file mode 100644
index 0000000000..b3d3792504
--- /dev/null
+++ b/packages/cli/templates/showcase/StatusDot.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'StatusDot', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/StatusDot.tsx b/packages/cli/templates/showcase/StatusDot.tsx
new file mode 100644
index 0000000000..3170dfecea
--- /dev/null
+++ b/packages/cli/templates/showcase/StatusDot.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSStatusDot} from '@xds/core/StatusDot';
+
+export default function StatusDotShowcase() {
+ return <XDSStatusDot variant="positive" label="Online" />;
+}
diff --git a/packages/cli/templates/showcase/Switch.doc.mjs b/packages/cli/templates/showcase/Switch.doc.mjs
new file mode 100644
index 0000000000..a84adfc0c4
--- /dev/null
+++ b/packages/cli/templates/showcase/Switch.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Switch', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Switch.tsx b/packages/cli/templates/showcase/Switch.tsx
new file mode 100644
index 0000000000..fb6deed51e
--- /dev/null
+++ b/packages/cli/templates/showcase/Switch.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSSwitch} from '@xds/core/Switch';
+
+export default function SwitchShowcase() {
+ return <XDSSwitch label="Dark mode" />;
+}
diff --git a/packages/cli/templates/showcase/TabList.doc.mjs b/packages/cli/templates/showcase/TabList.doc.mjs
new file mode 100644
index 0000000000..7735e8b25b
--- /dev/null
+++ b/packages/cli/templates/showcase/TabList.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'TabList', aspectRatio: 16 / 4};
diff --git a/packages/cli/templates/showcase/TabList.tsx b/packages/cli/templates/showcase/TabList.tsx
new file mode 100644
index 0000000000..f3a993b259
--- /dev/null
+++ b/packages/cli/templates/showcase/TabList.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSTabList} from '@xds/core/TabList';
+
+export default function TabListShowcase() {
+ return <XDSTabList tabs={[{label: 'Tab 1'}, {label: 'Tab 2'}]} />;
+}
diff --git a/packages/cli/templates/showcase/Table.doc.mjs b/packages/cli/templates/showcase/Table.doc.mjs
new file mode 100644
index 0000000000..ad236a3b17
--- /dev/null
+++ b/packages/cli/templates/showcase/Table.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Table', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Table.tsx b/packages/cli/templates/showcase/Table.tsx
new file mode 100644
index 0000000000..b54cc994f9
--- /dev/null
+++ b/packages/cli/templates/showcase/Table.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSTable} from '@xds/core/Table';
+
+export default function TableShowcase() {
+ return <XDSTable data={[]} columns={[]} />;
+}
diff --git a/packages/cli/templates/showcase/Text.doc.mjs b/packages/cli/templates/showcase/Text.doc.mjs
new file mode 100644
index 0000000000..4046438f0b
--- /dev/null
+++ b/packages/cli/templates/showcase/Text.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Text', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/Text.tsx b/packages/cli/templates/showcase/Text.tsx
new file mode 100644
index 0000000000..f863c4e7da
--- /dev/null
+++ b/packages/cli/templates/showcase/Text.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSText} from '@xds/core/Text';
+
+export default function TextShowcase() {
+ return <XDSText type="body">Hello world</XDSText>;
+}
diff --git a/packages/cli/templates/showcase/TextArea.doc.mjs b/packages/cli/templates/showcase/TextArea.doc.mjs
new file mode 100644
index 0000000000..f8a60012a3
--- /dev/null
+++ b/packages/cli/templates/showcase/TextArea.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'TextArea', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/TextArea.tsx b/packages/cli/templates/showcase/TextArea.tsx
new file mode 100644
index 0000000000..4ddac8dcc7
--- /dev/null
+++ b/packages/cli/templates/showcase/TextArea.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSTextArea} from '@xds/core/TextArea';
+
+export default function TextAreaShowcase() {
+ return <XDSTextArea label="Description" value="" onChange={() => {}} />;
+}
diff --git a/packages/cli/templates/showcase/TextInput.doc.mjs b/packages/cli/templates/showcase/TextInput.doc.mjs
new file mode 100644
index 0000000000..1ebb38a9f9
--- /dev/null
+++ b/packages/cli/templates/showcase/TextInput.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'TextInput', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/TextInput.tsx b/packages/cli/templates/showcase/TextInput.tsx
new file mode 100644
index 0000000000..8317ea329b
--- /dev/null
+++ b/packages/cli/templates/showcase/TextInput.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSTextInput} from '@xds/core/TextInput';
+
+export default function TextInputShowcase() {
+ return <XDSTextInput label="Name" value="" onChange={() => {}} />;
+}
diff --git a/packages/cli/templates/showcase/Thumbnail.doc.mjs b/packages/cli/templates/showcase/Thumbnail.doc.mjs
new file mode 100644
index 0000000000..a0a6355685
--- /dev/null
+++ b/packages/cli/templates/showcase/Thumbnail.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Thumbnail', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/Thumbnail.tsx b/packages/cli/templates/showcase/Thumbnail.tsx
new file mode 100644
index 0000000000..22edc0267e
--- /dev/null
+++ b/packages/cli/templates/showcase/Thumbnail.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSThumbnail} from '@xds/core/Thumbnail';
+
+export default function ThumbnailShowcase() {
+ return <XDSThumbnail src="https://via.placeholder.com/80" alt="Preview" />;
+}
diff --git a/packages/cli/templates/showcase/TimeInput.doc.mjs b/packages/cli/templates/showcase/TimeInput.doc.mjs
new file mode 100644
index 0000000000..574bebe4d0
--- /dev/null
+++ b/packages/cli/templates/showcase/TimeInput.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'TimeInput', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/TimeInput.tsx b/packages/cli/templates/showcase/TimeInput.tsx
new file mode 100644
index 0000000000..c0e993cb5f
--- /dev/null
+++ b/packages/cli/templates/showcase/TimeInput.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSTimeInput} from '@xds/core/TimeInput';
+
+export default function TimeInputShowcase() {
+ return <XDSTimeInput label="Time" />;
+}
diff --git a/packages/cli/templates/showcase/Timestamp.doc.mjs b/packages/cli/templates/showcase/Timestamp.doc.mjs
new file mode 100644
index 0000000000..d031b98746
--- /dev/null
+++ b/packages/cli/templates/showcase/Timestamp.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Timestamp', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/Timestamp.tsx b/packages/cli/templates/showcase/Timestamp.tsx
new file mode 100644
index 0000000000..87880f49d9
--- /dev/null
+++ b/packages/cli/templates/showcase/Timestamp.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSTimestamp} from '@xds/core/Timestamp';
+
+export default function TimestampShowcase() {
+ return <XDSTimestamp date={new Date()} />;
+}
diff --git a/packages/cli/templates/showcase/Toast.doc.mjs b/packages/cli/templates/showcase/Toast.doc.mjs
new file mode 100644
index 0000000000..9b8e5cb48e
--- /dev/null
+++ b/packages/cli/templates/showcase/Toast.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Toast', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Toast.tsx b/packages/cli/templates/showcase/Toast.tsx
new file mode 100644
index 0000000000..9ab243cb87
--- /dev/null
+++ b/packages/cli/templates/showcase/Toast.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSToast} from '@xds/core/Toast';
+
+export default function ToastShowcase() {
+ return <XDSToast message="Saved successfully" />;
+}
diff --git a/packages/cli/templates/showcase/ToggleButton.doc.mjs b/packages/cli/templates/showcase/ToggleButton.doc.mjs
new file mode 100644
index 0000000000..ebc84d791b
--- /dev/null
+++ b/packages/cli/templates/showcase/ToggleButton.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'ToggleButton', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/ToggleButton.tsx b/packages/cli/templates/showcase/ToggleButton.tsx
new file mode 100644
index 0000000000..64ae552169
--- /dev/null
+++ b/packages/cli/templates/showcase/ToggleButton.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSToggleButton} from '@xds/core/ToggleButton';
+
+export default function ToggleButtonShowcase() {
+ return <XDSToggleButton label="Bold" isIconOnly />;
+}
diff --git a/packages/cli/templates/showcase/Token.doc.mjs b/packages/cli/templates/showcase/Token.doc.mjs
new file mode 100644
index 0000000000..dadab487e9
--- /dev/null
+++ b/packages/cli/templates/showcase/Token.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Token', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/Token.tsx b/packages/cli/templates/showcase/Token.tsx
new file mode 100644
index 0000000000..d3390ecbe8
--- /dev/null
+++ b/packages/cli/templates/showcase/Token.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSToken} from '@xds/core/Token';
+
+export default function TokenShowcase() {
+ return <XDSToken label="Tag" />;
+}
diff --git a/packages/cli/templates/showcase/Tokenizer.doc.mjs b/packages/cli/templates/showcase/Tokenizer.doc.mjs
new file mode 100644
index 0000000000..d5e9d978a4
--- /dev/null
+++ b/packages/cli/templates/showcase/Tokenizer.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Tokenizer', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Tokenizer.tsx b/packages/cli/templates/showcase/Tokenizer.tsx
new file mode 100644
index 0000000000..f526ea32cb
--- /dev/null
+++ b/packages/cli/templates/showcase/Tokenizer.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSTokenizer} from '@xds/core/Tokenizer';
+
+export default function TokenizerShowcase() {
+ return <XDSTokenizer label="Tags" items={[]} />;
+}
diff --git a/packages/cli/templates/showcase/Toolbar.doc.mjs b/packages/cli/templates/showcase/Toolbar.doc.mjs
new file mode 100644
index 0000000000..d4e65380d1
--- /dev/null
+++ b/packages/cli/templates/showcase/Toolbar.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Toolbar', aspectRatio: 16 / 4};
diff --git a/packages/cli/templates/showcase/Toolbar.tsx b/packages/cli/templates/showcase/Toolbar.tsx
new file mode 100644
index 0000000000..cadfdf0b2f
--- /dev/null
+++ b/packages/cli/templates/showcase/Toolbar.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSToolbar} from '@xds/core/Toolbar';
+
+export default function ToolbarShowcase() {
+ return <XDSToolbar label="Actions" />;
+}
diff --git a/packages/cli/templates/showcase/Tooltip.doc.mjs b/packages/cli/templates/showcase/Tooltip.doc.mjs
new file mode 100644
index 0000000000..606e79530f
--- /dev/null
+++ b/packages/cli/templates/showcase/Tooltip.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Tooltip', aspectRatio: 1};
diff --git a/packages/cli/templates/showcase/Tooltip.tsx b/packages/cli/templates/showcase/Tooltip.tsx
new file mode 100644
index 0000000000..ef42e1857e
--- /dev/null
+++ b/packages/cli/templates/showcase/Tooltip.tsx
@@ -0,0 +1,11 @@
+'use client';
+
+import {XDSTooltip} from '@xds/core/Tooltip';
+
+export default function TooltipShowcase() {
+ return (
+ <XDSTooltip content="Help text">
+ <button>Hover</button>
+ </XDSTooltip>
+ );
+}
diff --git a/packages/cli/templates/showcase/TopNav.doc.mjs b/packages/cli/templates/showcase/TopNav.doc.mjs
new file mode 100644
index 0000000000..b49196ca91
--- /dev/null
+++ b/packages/cli/templates/showcase/TopNav.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'TopNav', aspectRatio: 16 / 4};
diff --git a/packages/cli/templates/showcase/TopNav.tsx b/packages/cli/templates/showcase/TopNav.tsx
new file mode 100644
index 0000000000..7c9b5c3aef
--- /dev/null
+++ b/packages/cli/templates/showcase/TopNav.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSTopNav} from '@xds/core/TopNav';
+
+export default function TopNavShowcase() {
+ return <XDSTopNav label="Navigation" />;
+}
diff --git a/packages/cli/templates/showcase/TreeList.doc.mjs b/packages/cli/templates/showcase/TreeList.doc.mjs
new file mode 100644
index 0000000000..d791084f6b
--- /dev/null
+++ b/packages/cli/templates/showcase/TreeList.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'TreeList', aspectRatio: 3 / 4};
diff --git a/packages/cli/templates/showcase/TreeList.tsx b/packages/cli/templates/showcase/TreeList.tsx
new file mode 100644
index 0000000000..2888f9be58
--- /dev/null
+++ b/packages/cli/templates/showcase/TreeList.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSTreeList} from '@xds/core/TreeList';
+
+export default function TreeListShowcase() {
+ return <XDSTreeList items={[{label: 'Root'}]} />;
+}
diff --git a/packages/cli/templates/showcase/Typeahead.doc.mjs b/packages/cli/templates/showcase/Typeahead.doc.mjs
new file mode 100644
index 0000000000..3d34093de6
--- /dev/null
+++ b/packages/cli/templates/showcase/Typeahead.doc.mjs
@@ -0,0 +1,2 @@
+/** @type {import('@xds/core').ComponentShowcaseDoc} */
+export const doc = {name: 'Typeahead', aspectRatio: 4 / 3};
diff --git a/packages/cli/templates/showcase/Typeahead.tsx b/packages/cli/templates/showcase/Typeahead.tsx
new file mode 100644
index 0000000000..35ceef4488
--- /dev/null
+++ b/packages/cli/templates/showcase/Typeahead.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import {XDSTypeahead} from '@xds/core/Typeahead';
+
+export default function TypeaheadShowcase() {
+ return <XDSTypeahead label="Search" />;
+}
diff --git a/packages/core/src/AlertDialog/AlertDialog.doc.mjs b/packages/core/src/AlertDialog/AlertDialog.doc.mjs
index 9bd3c37503..ded8cc43d3 100644
--- a/packages/core/src/AlertDialog/AlertDialog.doc.mjs
+++ b/packages/core/src/AlertDialog/AlertDialog.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'AlertDialog',
description:
'Confirmation dialog for destructive or irreversible actions. Uses role="alertdialog" with required title, description, and cancel/action buttons.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSAlertDialog title="Confirm" description="Are you sure?" />',
- },
keywords: [
'alert',
'alertdialog',
diff --git a/packages/core/src/AppShell/AppShell.doc.mjs b/packages/core/src/AppShell/AppShell.doc.mjs
index 30c977c548..a7f9148b70 100644
--- a/packages/core/src/AppShell/AppShell.doc.mjs
+++ b/packages/core/src/AppShell/AppShell.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'AppShell',
description:
'Application-level layout shell providing header, side navigation, and main content area — composes XDSLayout internally and replaces the XDSPage + XDSPageLayout pattern.',
- showcase: {
- aspectRatio: 16 / 9,
- code: '<XDSAppShell><div>Content</div></XDSAppShell>',
- },
keywords: ["appshell","layout","scaffold","sidebar","sidenav","topnav","header","navigation","dashboard","shell","page","frame"],
features: [
'Two navigation slots: topNav (horizontal bar) and sideNav (vertical sidebar)',
diff --git a/packages/core/src/AspectRatio/AspectRatio.doc.mjs b/packages/core/src/AspectRatio/AspectRatio.doc.mjs
index ea51fb691f..316239a38a 100644
--- a/packages/core/src/AspectRatio/AspectRatio.doc.mjs
+++ b/packages/core/src/AspectRatio/AspectRatio.doc.mjs
@@ -2,12 +2,7 @@
export const docs = {
name: 'AspectRatio',
- description: 'Maintains a specific aspect ratio for its children.',
- showcase: {
- aspectRatio: 16 / 9,
- code: '<XDSAspectRatio ratio={16/9}><div style={{background: "#eee", height: "100%"}} /></XDSAspectRatio>',
- },
- keywords: ["aspect-ratio","ratio","proportion","responsive","embed","container","widescreen","thumbnail","letterbox","crop"],
+ description: 'Maintains a specific aspect ratio for its children.', keywords: ["aspect-ratio","ratio","proportion","responsive","embed","container","widescreen","thumbnail","letterbox","crop"],
features: [
'Accepts any numeric ratio expressed as width/height (e.g. 16/9, 4/3, 1)',
'Children are positioned absolutely to fill the container',
diff --git a/packages/core/src/Avatar/Avatar.doc.mjs b/packages/core/src/Avatar/Avatar.doc.mjs
index f449ab629d..add513ed8f 100644
--- a/packages/core/src/Avatar/Avatar.doc.mjs
+++ b/packages/core/src/Avatar/Avatar.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Avatar',
description:
'Avatar component for displaying user profile pictures with fallback support.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSAvatar name="Jane Doe" />',
- },
keywords: ["avatar","profile","user","photo","thumbnail","initials","gravatar","pfp","userpic"],
features: [
'Image loading: Primary and fallback image sources',
diff --git a/packages/core/src/Badge/Badge.doc.mjs b/packages/core/src/Badge/Badge.doc.mjs
index 43c2798657..cc5cfe02a2 100644
--- a/packages/core/src/Badge/Badge.doc.mjs
+++ b/packages/core/src/Badge/Badge.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Badge',
description:
'A badge component for displaying status indicators, counts, or labels.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSBadge label="New" />',
- },
keywords: ["badge","tag","chip","label","status","indicator","count","counter","pill","notification","marker"],
props: [
{
diff --git a/packages/core/src/Banner/Banner.doc.mjs b/packages/core/src/Banner/Banner.doc.mjs
index 0c00feb1cc..33e0ec1f7b 100644
--- a/packages/core/src/Banner/Banner.doc.mjs
+++ b/packages/core/src/Banner/Banner.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Banner',
description:
'Persistent status notification for info, warning, error, or success messages.',
- showcase: {
- aspectRatio: 16 / 4,
- code: '<XDSBanner variant="info">Important update</XDSBanner>',
- },
keywords: ["banner","alert","notification","callout","notice","status","message","info","warning","error","success","toast"],
features: [
diff --git a/packages/core/src/Breadcrumbs/Breadcrumbs.doc.mjs b/packages/core/src/Breadcrumbs/Breadcrumbs.doc.mjs
index 97e88e2bb1..ee5aa22096 100644
--- a/packages/core/src/Breadcrumbs/Breadcrumbs.doc.mjs
+++ b/packages/core/src/Breadcrumbs/Breadcrumbs.doc.mjs
@@ -2,12 +2,7 @@
export const docs = {
name: 'Breadcrumbs',
- description: 'A navigation breadcrumb trail with semantic HTML.',
- showcase: {
- aspectRatio: 16 / 4,
- code: '<XDSBreadcrumbs items={[{label: "Home"}, {label: "Settings"}]} />',
- },
- keywords: ["breadcrumbs","breadcrumb","navigation","nav","crumbs","trail","path","hierarchy","wayfinding","steps"],
+ description: 'A navigation breadcrumb trail with semantic HTML.', keywords: ["breadcrumbs","breadcrumb","navigation","nav","crumbs","trail","path","hierarchy","wayfinding","steps"],
features: [
'Renders a <nav> landmark with an ordered list of breadcrumb items',
'Configurable separator between items (defaults to /)',
diff --git a/packages/core/src/Button/Button.doc.mjs b/packages/core/src/Button/Button.doc.mjs
index 3c253b1233..092963ab1f 100644
--- a/packages/core/src/Button/Button.doc.mjs
+++ b/packages/core/src/Button/Button.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Button',
description:
'XDSButton component with multiple variants, sizes, and isLoading state support.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSButton label="Click me" variant="primary" />',
- },
keywords: ["button","btn","cta","submit","action","loading","primary","secondary","ghost","destructive","danger"],
features: [
diff --git a/packages/core/src/Calendar/Calendar.doc.mjs b/packages/core/src/Calendar/Calendar.doc.mjs
index 7beb17a3d4..6f225c1c56 100644
--- a/packages/core/src/Calendar/Calendar.doc.mjs
+++ b/packages/core/src/Calendar/Calendar.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Calendar',
description:
'XDSCalendar component for date selection with single and range modes.',
- showcase: {
- aspectRatio: 3 / 4,
- code: '<XDSCalendar />',
- },
keywords: ["calendar","datepicker","date picker","rangepicker","date range","monthview","daypicker"],
features: [
"Selection Modes: 'single' (default) and 'range'",
diff --git a/packages/core/src/Card/Card.doc.mjs b/packages/core/src/Card/Card.doc.mjs
index c370a0c51d..cb774f6369 100644
--- a/packages/core/src/Card/Card.doc.mjs
+++ b/packages/core/src/Card/Card.doc.mjs
@@ -3,10 +3,6 @@
export const docs = {
name: 'Card',
description: 'Card container component with shadow and themed styling.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSCard>Card content</XDSCard>',
- },
keywords: ["card","surface","panel","container","elevated","shadow","box","paper","tile","well"],
features: [
'Top-level container for elevated content',
diff --git a/packages/core/src/Carousel/Carousel.doc.mjs b/packages/core/src/Carousel/Carousel.doc.mjs
index d016dfb03e..8eda9f50c8 100644
--- a/packages/core/src/Carousel/Carousel.doc.mjs
+++ b/packages/core/src/Carousel/Carousel.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Carousel',
description:
'Horizontal scroll container with fade-edge overflow indication, optional navigation buttons, and scroll-snap support.',
- showcase: {
- aspectRatio: 16 / 9,
- code: '<XDSCarousel><div>Slide 1</div></XDSCarousel>',
- },
keywords: ['carousel', 'slider', 'scroll', 'gallery', 'filmstrip', 'swiper', 'horizontal', 'overflow', 'snap'],
features: [
'Overflow Detection: Gradient fades appear at edges when content overflows, signaling more items',
diff --git a/packages/core/src/Center/Center.doc.mjs b/packages/core/src/Center/Center.doc.mjs
index 94ad3ab025..a5d75c40e2 100644
--- a/packages/core/src/Center/Center.doc.mjs
+++ b/packages/core/src/Center/Center.doc.mjs
@@ -3,10 +3,6 @@
export const docs = {
name: 'Center',
description: 'Centers children horizontally and/or vertically using flexbox.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSCenter>Centered</XDSCenter>',
- },
keywords: ["center","centered","centering","align","alignment","justify","flexbox","middle"],
features: [
'Supports centering on both axes, horizontal only, or vertical only',
diff --git a/packages/core/src/Chat/Chat.doc.mjs b/packages/core/src/Chat/Chat.doc.mjs
index 04bd7b850c..2c0c241834 100644
--- a/packages/core/src/Chat/Chat.doc.mjs
+++ b/packages/core/src/Chat/Chat.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Chat',
description:
'Chat components for AI chat interfaces. Layout (MessageList, Message, Bubble, SystemMessage) + Composer (Composer, ComposerInput with trigger menus, ComposerAttachments).',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSChatMessageList><XDSChatMessage sender="user"><XDSChatBubble>Hello</XDSChatBubble></XDSChatMessage></XDSChatMessageList>',
- },
keywords: ['chat', 'message', 'bubble', 'conversation', 'ai', 'assistant', 'thread', 'system-message', 'composer', 'mention', 'trigger', 'typeahead', 'token', 'imperative', 'tokenized-text'],
features: [
'Composition model — MessageList > Message > Bubble',
diff --git a/packages/core/src/CheckboxInput/CheckboxInput.doc.mjs b/packages/core/src/CheckboxInput/CheckboxInput.doc.mjs
index 7eda6006b4..c045695ab9 100644
--- a/packages/core/src/CheckboxInput/CheckboxInput.doc.mjs
+++ b/packages/core/src/CheckboxInput/CheckboxInput.doc.mjs
@@ -3,10 +3,6 @@
export const docs = {
name: 'CheckboxInput',
description: 'A checkbox input component for toggling boolean values.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSCheckboxInput label="Accept terms" />',
- },
keywords: ["checkbox","check","toggle","tick","indeterminate","boolean","tristate"],
features: [
'Accessible — always includes a label (can be visually hidden)',
diff --git a/packages/core/src/CheckboxList/CheckboxList.doc.mjs b/packages/core/src/CheckboxList/CheckboxList.doc.mjs
index 7910edef01..e80210896f 100644
--- a/packages/core/src/CheckboxList/CheckboxList.doc.mjs
+++ b/packages/core/src/CheckboxList/CheckboxList.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'CheckboxList',
description:
- 'A checkbox group component for multi-value selection from a list of options. Supports collection mode (parent-managed state) and standalone mode (per-item state).',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSCheckboxList label="Options" items={[{label: "Option A", value: "a"}]} />',
- },
- keywords: ["checkboxlist","checkbox","checkboxgroup","multichoice","multiselect","checklist"],
+ 'A checkbox group component for multi-value selection from a list of options. Supports collection mode (parent-managed state) and standalone mode (per-item state).', keywords: ["checkboxlist","checkbox","checkboxgroup","multichoice","multiselect","checklist"],
features: [
'Accessible — uses native <input type="checkbox"> with proper ARIA attributes',
'Collection mode — parent manages selected values as string[], items derive checked state',
diff --git a/packages/core/src/CodeBlock/XDSCodeBlock.doc.mjs b/packages/core/src/CodeBlock/XDSCodeBlock.doc.mjs
index 9a7a47a84e..fda4def997 100644
--- a/packages/core/src/CodeBlock/XDSCodeBlock.doc.mjs
+++ b/packages/core/src/CodeBlock/XDSCodeBlock.doc.mjs
@@ -42,10 +42,6 @@ export const docs = {
{name: 'style', type: 'CSSProperties', description: 'Inline styles. Prefer xstyle for StyleX-optimized styling.'},
{name: 'data-testid', type: 'string', description: 'Test selector for automated testing frameworks.'},
],
- examples: [
- {label: 'Basic usage', code: '<XDSCodeBlock\n code={`const x = 42;`}\n language="typescript"\n hasLineNumbers\n/>'},
- {label: 'With title and line highlighting', code: '<XDSCodeBlock\n code={snippetCode}\n language="typescript"\n title="utils.ts"\n highlightLines={[3, 4, 5]}\n/>'},
- ],
},
{
name: 'XDSCode',
@@ -57,15 +53,8 @@ export const docs = {
{name: 'style', type: 'CSSProperties', description: 'Inline styles. Prefer xstyle for StyleX-optimized styling.'},
{name: 'data-testid', type: 'string', description: 'Test selector for automated testing frameworks.'},
],
- examples: [
- {label: 'Inline in prose', code: '<XDSText type="body">\n Pass <XDSCode>xstyle</XDSCode> a <XDSCode>stylex.create()</XDSCode> value.\n</XDSText>'},
- ],
},
],
- examples: [
- {label: 'TypeScript with line numbers', code: '<XDSCodeBlock\n code={`function greet(name: string) { return name; }`}\n language="typescript"\n hasLineNumbers\n title="greet.ts"\n/>'},
- {label: 'Inline code in text', code: '<XDSText type="body">\n Use <XDSCode>const</XDSCode> for block-scoped declarations.\n</XDSText>'},
- ],
theming: {
targets: [
{className: 'xds-code'},
diff --git a/packages/core/src/Collapsible/Collapsible.doc.mjs b/packages/core/src/Collapsible/Collapsible.doc.mjs
index 00e80ea937..6e1de87340 100644
--- a/packages/core/src/Collapsible/Collapsible.doc.mjs
+++ b/packages/core/src/Collapsible/Collapsible.doc.mjs
@@ -3,10 +3,6 @@
export const docs = {
name: 'Collapsible',
description: 'Collapsible content primitive and group coordination.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSCollapsible trigger="Details">Hidden content</XDSCollapsible>',
- },
keywords: ["accordion","collapse","expandable","disclosure","toggle","panel","foldable","expander","expand"],
features: [
'XDSCollapsible makes any content collapsible — a trigger toggles visibility of the content area',
diff --git a/packages/core/src/CommandPalette/XDSCommandPalette.doc.mjs b/packages/core/src/CommandPalette/XDSCommandPalette.doc.mjs
index e6b2ba06e6..97991dcdbc 100644
--- a/packages/core/src/CommandPalette/XDSCommandPalette.doc.mjs
+++ b/packages/core/src/CommandPalette/XDSCommandPalette.doc.mjs
@@ -113,21 +113,6 @@ export const docs = {
default: '480',
},
],
- examples: [
- {
- label: 'Static source',
- code: `const source = createStaticSource([
- {id: 'home', label: 'Home'},
- {id: 'settings', label: 'Settings'},
-]);
-
-<XDSCommandPalette
- isOpen={isOpen}
- onOpenChange={setIsOpen}
- searchSource={source}
-/>`,
- },
- ],
},
{
name: 'XDSCommandPaletteInput',
@@ -171,14 +156,6 @@ export const docs = {
'StyleX styles for layout customization. Must be a stylex.create() value.',
},
],
- examples: [
- {
- label: 'Custom placeholder',
- code: `<XDSCommandPalette isOpen={isOpen} onOpenChange={setIsOpen} searchSource={source}
- input={<XDSCommandPaletteInput placeholder="Search commands..." />}
-/>`,
- },
- ],
},
{
name: 'XDSCommandPaletteList',
@@ -204,16 +181,6 @@ export const docs = {
'StyleX styles for layout customization. Must be a stylex.create() value.',
},
],
- examples: [
- {
- label: 'Basic',
- code: `<XDSCommandPaletteList>
- <XDSCommandPaletteItem value="home" onSelect={goHome}>
- Go Home
- </XDSCommandPaletteItem>
-</XDSCommandPaletteList>`,
- },
- ],
},
{
name: 'XDSCommandPaletteItem',
@@ -264,16 +231,6 @@ export const docs = {
'StyleX styles for layout customization. Must be a stylex.create() value.',
},
],
- examples: [
- {
- label: 'With icon and shortcut',
- code: `<XDSCommandPaletteItem value="settings" onSelect={() => navigate('/settings')}>
- <XDSIcon name="settings" size="sm" />
- Settings
- <XDSKbd keys={['⌘', ',']} />
-</XDSCommandPaletteItem>`,
- },
- ],
},
{
name: 'XDSCommandPaletteGroup',
@@ -298,15 +255,6 @@ export const docs = {
'StyleX styles for layout customization. Must be a stylex.create() value.',
},
],
- examples: [
- {
- label: 'Basic',
- code: `<XDSCommandPaletteGroup heading="Navigation">
- <XDSCommandPaletteItem value="home" onSelect={goHome}>Home</XDSCommandPaletteItem>
- <XDSCommandPaletteItem value="settings" onSelect={goSettings}>Settings</XDSCommandPaletteItem>
-</XDSCommandPaletteGroup>`,
- },
- ],
},
{
name: 'XDSCommandPaletteFooter',
@@ -326,14 +274,6 @@ export const docs = {
'StyleX styles for layout customization. Must be a stylex.create() value.',
},
],
- examples: [
- {
- label: 'Default hints',
- code: `<XDSCommandPalette isOpen={isOpen} onOpenChange={setIsOpen} searchSource={source}
- footer={<XDSCommandPaletteFooter />}
-/>`,
- },
- ],
},
{
name: 'XDSCommandPaletteEmpty',
@@ -347,54 +287,6 @@ export const docs = {
required: true,
},
],
- examples: [
- {
- label: 'Custom empty state',
- code: `<XDSCommandPalette
- isOpen={isOpen}
- onOpenChange={setIsOpen}
- searchSource={source}
- emptySearchText={
- <XDSCommandPaletteEmpty>No commands found</XDSCommandPaletteEmpty>
- }
-/>`,
- },
- ],
- },
- ],
- examples: [
- {
- label: 'Static source with createStaticSource',
- code: `const source = createStaticSource([
- {id: 'home', label: 'Home'},
- {id: 'settings', label: 'Settings'},
- {id: 'logout', label: 'Sign out'},
-]);
-
-function MyCommandPalette() {
- const [isOpen, setIsOpen] = useState(false);
- return (
- <XDSCommandPalette
- isOpen={isOpen}
- onOpenChange={setIsOpen}
- searchSource={source}
- />
- );
-}`,
- },
- {
- label: 'Grouped items with renderItem',
- code: `<XDSCommandPalette
- isOpen={isOpen}
- onOpenChange={setIsOpen}
- searchSource={source}
- renderItem={(item) => (
- <>
- <XDSIcon name={item.auxiliaryData.icon} size="sm" />
- {item.label}
- </>
- )}
-/>`,
},
],
theming: {
diff --git a/packages/core/src/DateInput/DateInput.doc.mjs b/packages/core/src/DateInput/DateInput.doc.mjs
index 58b9c25966..6e62f92680 100644
--- a/packages/core/src/DateInput/DateInput.doc.mjs
+++ b/packages/core/src/DateInput/DateInput.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'DateInput',
description:
'XDSDateInput component combining a text input with a calendar popover for date selection.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSDateInput label="Date" />',
- },
keywords: ["dateinput","datepicker","datefield","calendar","dateselect","dateentry","datechooser"],
features: [
'Text Input — manual date entry with flexible parsing (supports various formats)',
diff --git a/packages/core/src/Dialog/Dialog.doc.mjs b/packages/core/src/Dialog/Dialog.doc.mjs
index a771452ea0..507ccdc436 100644
--- a/packages/core/src/Dialog/Dialog.doc.mjs
+++ b/packages/core/src/Dialog/Dialog.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'Dialog',
description:
- 'Modal dialog using the native <dialog> element with automatic focus trapping, backdrop, and purpose-based dismissal control.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSDialog isOpen={true} onOpenChange={() => {}}>Dialog content</XDSDialog>',
- },
- keywords: ["dialog","modal","popup","overlay","lightbox","alert","confirm","prompt","backdrop","focus trap"],
+ 'Modal dialog using the native <dialog> element with automatic focus trapping, backdrop, and purpose-based dismissal control.', keywords: ["dialog","modal","popup","overlay","lightbox","alert","confirm","prompt","backdrop","focus trap"],
features: [
"Native <dialog>: Uses the browser's built-in modal behavior via showModal()",
'Automatic focus trap: Focus is trapped within the dialog when open (browser-native)',
diff --git a/packages/core/src/Divider/Divider.doc.mjs b/packages/core/src/Divider/Divider.doc.mjs
index 2aa5a37c20..eb6fc24ae2 100644
--- a/packages/core/src/Divider/Divider.doc.mjs
+++ b/packages/core/src/Divider/Divider.doc.mjs
@@ -5,10 +5,6 @@
export const docs = {
name: 'Divider',
description: 'Visual separator with optional label, using XDS design tokens.',
- showcase: {
- aspectRatio: 16 / 4,
- code: '<XDSDivider />',
- },
keywords: ["divider","separator","hr","rule","line","border","spacer","horizontal rule"],
features: [
'Supports horizontal and vertical orientations',
diff --git a/packages/core/src/DropdownMenu/DropdownMenu.doc.mjs b/packages/core/src/DropdownMenu/DropdownMenu.doc.mjs
index 229f8b3097..7d4bff8f17 100644
--- a/packages/core/src/DropdownMenu/DropdownMenu.doc.mjs
+++ b/packages/core/src/DropdownMenu/DropdownMenu.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'DropdownMenu',
description:
- 'A dropdown menu component for displaying actionable items in a popup menu.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSDropdownMenu trigger={<button>Menu</button>} items={[{label: "Edit"}]} />',
- },
- keywords: ["dropdown","menu","popover","select","actions","contextmenu","overflow","kebab","menubutton"],
+ 'A dropdown menu component for displaying actionable items in a popup menu.', keywords: ["dropdown","menu","popover","select","actions","contextmenu","overflow","kebab","menubutton"],
features: [
'Button customization: Customize the trigger button via the `button` prop (supports all XDSButton props)',
'Data-driven items: Pass items via the `items` prop with support for sections and dividers',
diff --git a/packages/core/src/EmptyState/EmptyState.doc.mjs b/packages/core/src/EmptyState/EmptyState.doc.mjs
index 9472080650..d7292f35e8 100644
--- a/packages/core/src/EmptyState/EmptyState.doc.mjs
+++ b/packages/core/src/EmptyState/EmptyState.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'EmptyState',
description:
'An empty state placeholder for content areas with no data. Displays an icon or illustration, title, optional description, and action buttons.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSEmptyState title="No results" />',
- },
keywords: ["emptystate","empty","placeholder","nodata","blank","noresults","illustration","blankslate"],
features: [
'Uses role="status" so screen readers announce the empty state automatically',
diff --git a/packages/core/src/Field/Field.doc.mjs b/packages/core/src/Field/Field.doc.mjs
index c5b912b6b1..0ba008abf9 100644
--- a/packages/core/src/Field/Field.doc.mjs
+++ b/packages/core/src/Field/Field.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Field',
description:
'A form field wrapper component that provides label, description, and optional/required indicators.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSField label="Name"><input /></XDSField>',
- },
keywords: ["field","formfield","formgroup","formcontrol","label","input","required","optional","helpertext","hint"],
features: [
'Label Support — required label for accessibility (can be visually hidden)',
diff --git a/packages/core/src/FormLayout/FormLayout.doc.mjs b/packages/core/src/FormLayout/FormLayout.doc.mjs
index 5cd5ccc63b..0a2fc87bf4 100644
--- a/packages/core/src/FormLayout/FormLayout.doc.mjs
+++ b/packages/core/src/FormLayout/FormLayout.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'FormLayout',
description:
'A spatial layout container for arranging form fields with consistent spacing and direction.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSFormLayout>Form fields</XDSFormLayout>',
- },
keywords: ["formlayout","form","fieldset","formgroup","formcontainer","fields","vertical","horizontal"],
props: [
{
diff --git a/packages/core/src/Grid/Grid.doc.mjs b/packages/core/src/Grid/Grid.doc.mjs
index 548cb6dd98..87eae9e9b1 100644
--- a/packages/core/src/Grid/Grid.doc.mjs
+++ b/packages/core/src/Grid/Grid.doc.mjs
@@ -2,12 +2,7 @@
export const docs = {
name: 'Grid',
- description: 'CSS Grid-based layout with responsive auto-fit support.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSGrid columns={3}><div>1</div><div>2</div><div>3</div></XDSGrid>',
- },
- keywords: ["grid","columns","responsive","auto-fit","masonry","tiles","row","col","simplegrid"],
+ description: 'CSS Grid-based layout with responsive auto-fit support.', keywords: ["grid","columns","responsive","auto-fit","masonry","tiles","row","col","simplegrid"],
features: [
'Fixed-column grids via the `columns` prop',
'Responsive auto-fit columns via `minChildWidth` — items wrap based on available space',
diff --git a/packages/core/src/HoverCard/HoverCard.doc.mjs b/packages/core/src/HoverCard/HoverCard.doc.mjs
index 66d756d3a6..0b0299b8d9 100644
--- a/packages/core/src/HoverCard/HoverCard.doc.mjs
+++ b/packages/core/src/HoverCard/HoverCard.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'HoverCard',
description:
- 'A hover/focus triggered overlay for displaying rich, interactive content anchored to a trigger element.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSHoverCard trigger={<span>Hover</span>}>Details</XDSHoverCard>',
- },
- keywords: ["hovercard","hover card","popover","tooltip","preview card","flyout","overlay","hover popup"],
+ 'A hover/focus triggered overlay for displaying rich, interactive content anchored to a trigger element.', keywords: ["hovercard","hover card","popover","tooltip","preview card","flyout","overlay","hover popup"],
features: [
'CSS Anchor Positioning for automatic placement relative to trigger elements',
'Popover API for top-layer rendering — no React portals needed',
diff --git a/packages/core/src/Icon/Icon.doc.mjs b/packages/core/src/Icon/Icon.doc.mjs
index 4790773998..e8abff38d6 100644
--- a/packages/core/src/Icon/Icon.doc.mjs
+++ b/packages/core/src/Icon/Icon.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Icon',
description:
'Renders icons with XDS design system colors and sizes. Supports both direct SVG icon components and semantic icon names that adapt to the active theme.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSIcon name="star" />',
- },
keywords: ["icon","svg","glyph","symbol","pictogram","graphic","vector"],
features: [
"Semantic Icon Names: Use names like 'close' or 'chevronDown' — resolved from the theme's icon registry",
diff --git a/packages/core/src/IconButton/IconButton.doc.mjs b/packages/core/src/IconButton/IconButton.doc.mjs
index 59e41000ed..0b3a336fc3 100644
--- a/packages/core/src/IconButton/IconButton.doc.mjs
+++ b/packages/core/src/IconButton/IconButton.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'IconButton',
description:
'An icon-only button. Thin wrapper around XDSButton with isIconOnly always true.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSIconButton label="Settings" icon="gear" />',
- },
keywords: ['icon-button', 'icon', 'button', 'toolbar', 'action', 'compact'],
features: [
diff --git a/packages/core/src/Kbd/Kbd.doc.mjs b/packages/core/src/Kbd/Kbd.doc.mjs
index 4dbe32295f..ccb411ab00 100644
--- a/packages/core/src/Kbd/Kbd.doc.mjs
+++ b/packages/core/src/Kbd/Kbd.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Kbd',
description:
'Displays a keyboard shortcut as styled <kbd> elements. Use in tooltips, menus, and documentation to show key combinations.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSKbd>⌘K</XDSKbd>',
- },
keywords: ["kbd","keyboard","shortcut","hotkey","keybinding","keystroke","keycombo","modifier","accelerator"],
features: [
'Key parsing — splits "mod+k" into individual styled <kbd> elements',
diff --git a/packages/core/src/Layer/Layer.doc.mjs b/packages/core/src/Layer/Layer.doc.mjs
index 02e3508aee..0b9bf929a7 100644
--- a/packages/core/src/Layer/Layer.doc.mjs
+++ b/packages/core/src/Layer/Layer.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Layer',
description:
'Core hook for overlay positioning using CSS Anchor Positioning and the Popover API — no React portals needed. Popover, HoverCard, and Tooltip build on this foundation and live in their own directories.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSLayer>Layer content</XDSLayer>',
- },
keywords: ["layer","overlay","popover","positioning","anchor","floating","dropdown","popper","popup","portal"],
features: [
'CSS Anchor Positioning for automatic placement relative to trigger elements',
diff --git a/packages/core/src/Layout/Layout.doc.mjs b/packages/core/src/Layout/Layout.doc.mjs
index eeb8e09e03..b69dffeb14 100644
--- a/packages/core/src/Layout/Layout.doc.mjs
+++ b/packages/core/src/Layout/Layout.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Layout',
description:
'Composable utilities and components for building structured layouts with a container/content separation pattern.',
- showcase: {
- aspectRatio: 16 / 9,
- code: '<XDSLayout>Layout content</XDSLayout>',
- },
keywords: ["layout","container","content","flex","box","wrapper","scaffold","page","shell"],
features: [
'Primitive + higher-order architecture — XDSLayoutContainer is a primitive; XDSCard, XDSSection are higher-order',
diff --git a/packages/core/src/Link/Link.doc.mjs b/packages/core/src/Link/Link.doc.mjs
index 757844200a..34d3db41b4 100644
--- a/packages/core/src/Link/Link.doc.mjs
+++ b/packages/core/src/Link/Link.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Link',
description:
'XDSLink component for styled anchor links with multiple variants and features, plus polymorphic link infrastructure for rendering custom link components (Next.js Link, React Router Link, etc.).',
- showcase: {
- aspectRatio: 1,
- code: '<XDSLink href="#">Link text</XDSLink>',
- },
keywords: ["link","anchor","href","hyperlink","navigation","url","external","textlink"],
features: [
"Color control: Uses XDSText color prop ('active' default, 'secondary', 'inherit', etc.)",
diff --git a/packages/core/src/List/List.doc.mjs b/packages/core/src/List/List.doc.mjs
index 2a617f0e4c..d8ef244c20 100644
--- a/packages/core/src/List/List.doc.mjs
+++ b/packages/core/src/List/List.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'List',
description:
'Vertical list component for rendering collections of items with consistent spacing, dividers, and marker styles. Uses a composition model: XDSList wraps XDSListItem sub-components.',
- showcase: {
- aspectRatio: 3 / 4,
- code: '<XDSList><XDSListItem>Item 1</XDSListItem></XDSList>',
- },
keywords: ["list","listitem","listbox","menu","collection","items","ul","navlist"],
features: [
'Composition model — XDSList wraps XDSListItem sub-components',
diff --git a/packages/core/src/Markdown/Markdown.doc.mjs b/packages/core/src/Markdown/Markdown.doc.mjs
index f4830b4509..f1af9572f2 100644
--- a/packages/core/src/Markdown/Markdown.doc.mjs
+++ b/packages/core/src/Markdown/Markdown.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Markdown',
description:
'Renders a markdown string as XDS components. Supports headings, paragraphs, bold, italic, code, lists, tables, links, images, blockquotes, horizontal rules, and task lists. Handles streaming text with a smooth fade-in animation.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSMarkdown content="# Hello" />',
- },
keywords: [
'markdown',
'rich text',
diff --git a/packages/core/src/MetadataList/MetadataList.doc.mjs b/packages/core/src/MetadataList/MetadataList.doc.mjs
index b671b00a87..e8f3cd8929 100644
--- a/packages/core/src/MetadataList/MetadataList.doc.mjs
+++ b/packages/core/src/MetadataList/MetadataList.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'MetadataList',
description:
- 'A read-only labeled list for displaying key-value metadata. Semantic equivalent of HTML <dl>/<dt>/<dd> with layout control, column modes, and consistent styling. Uses a composition model: XDSMetadataList wraps XDSMetadataListItem sub-components.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSMetadataList items={[{label: "Status", value: "Active"}]} />',
- },
- keywords: ["metadata","description","definition","keyvalue","properties","details","attributes","summary"],
+ 'A read-only labeled list for displaying key-value metadata. Semantic equivalent of HTML <dl>/<dt>/<dd> with layout control, column modes, and consistent styling. Uses a composition model: XDSMetadataList wraps XDSMetadataListItem sub-components.', keywords: ["metadata","description","definition","keyvalue","properties","details","attributes","summary"],
features: [
'Composition model — XDSMetadataList wraps XDSMetadataListItem sub-components',
'Column modes: single, multi (auto-fill), or fixed number',
diff --git a/packages/core/src/MobileNav/MobileNav.doc.mjs b/packages/core/src/MobileNav/MobileNav.doc.mjs
index 40a75c6f69..82f6c5e3f3 100644
--- a/packages/core/src/MobileNav/MobileNav.doc.mjs
+++ b/packages/core/src/MobileNav/MobileNav.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'MobileNav',
description:
'Slide-out drawer overlay for mobile navigation. The mobile counterpart to XDSSideNav — accepts the same children (XDSSideNavSection, XDSSideNavItem, or any ReactNode).',
- showcase: {
- aspectRatio: 3 / 4,
- code: '<XDSMobileNav>Nav items</XDSMobileNav>',
- },
keywords: ["mobilenav","drawer","sidebar","navigation","hamburger","menu","offcanvas","slideout","navdrawer"],
props: [
{
diff --git a/packages/core/src/MoreMenu/MoreMenu.doc.mjs b/packages/core/src/MoreMenu/MoreMenu.doc.mjs
index 1d84542424..9590a2ba65 100644
--- a/packages/core/src/MoreMenu/MoreMenu.doc.mjs
+++ b/packages/core/src/MoreMenu/MoreMenu.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'MoreMenu',
description:
- 'Overflow menu with a three-dot icon trigger. A convenience wrapper that composes an icon-only XDSButton with a dropdown menu, eliminating the boilerplate of wiring up state management, positioning, and accessibility attributes.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSMoreMenu items={[{label: "Edit"}]} />',
- },
- keywords: ["moremenu","overflow","kebab","dotmenu","threedot","ellipsis","dropdown","contextmenu","actionmenu"],
+ 'Overflow menu with a three-dot icon trigger. A convenience wrapper that composes an icon-only XDSButton with a dropdown menu, eliminating the boilerplate of wiring up state management, positioning, and accessibility attributes.', keywords: ["moremenu","overflow","kebab","dotmenu","threedot","ellipsis","dropdown","contextmenu","actionmenu"],
props: [
{
name: 'items',
diff --git a/packages/core/src/MultiSelector/MultiSelector.doc.mjs b/packages/core/src/MultiSelector/MultiSelector.doc.mjs
index 9ddbe3ba11..c235ae482c 100644
--- a/packages/core/src/MultiSelector/MultiSelector.doc.mjs
+++ b/packages/core/src/MultiSelector/MultiSelector.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'MultiSelector',
description:
- 'Multi-select dropdown with checkboxes for choosing multiple items from a list. For small, finite sets like column toggles or filter facets — not a replacement for XDSTokenizer.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSMultiSelector label="Tags" items={[]} />',
- },
- keywords: ['multiselect', 'checkbox', 'dropdown', 'multi', 'picker', 'checklist', 'facet', 'filter', 'select'],
+ 'Multi-select dropdown with checkboxes for choosing multiple items from a list. For small, finite sets like column toggles or filter facets — not a replacement for XDSTokenizer.', keywords: ['multiselect', 'checkbox', 'dropdown', 'multi', 'picker', 'checklist', 'facet', 'filter', 'select'],
features: [
'Checkbox-based multi-select — dropdown stays open on toggle',
'Supports string items, object items with optional icon and disabled state, dividers, and labeled sections',
diff --git a/packages/core/src/NavIcon/NavIcon.doc.mjs b/packages/core/src/NavIcon/NavIcon.doc.mjs
index 8252395a1f..db6c4207b1 100644
--- a/packages/core/src/NavIcon/NavIcon.doc.mjs
+++ b/packages/core/src/NavIcon/NavIcon.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'NavIcon',
description:
'Circular icon container with accent background for navigation headers.',
- showcase: {
- aspectRatio: 16 / 4,
- code: '<XDSNavIcon label="Home" />',
- },
keywords: ["navicon","iconbutton","toolbar icon","appbar icon","nav button"],
features: [
'Shared — used in both XDSTopNavHeading and XDSPageNavHeader',
diff --git a/packages/core/src/NumberInput/NumberInput.doc.mjs b/packages/core/src/NumberInput/NumberInput.doc.mjs
index bf5e03f110..d7b67a54b6 100644
--- a/packages/core/src/NumberInput/NumberInput.doc.mjs
+++ b/packages/core/src/NumberInput/NumberInput.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'NumberInput',
description:
- 'A number input component for collecting numeric user input with validation.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSNumberInput label="Amount" value={0} onChange={() => {}} />',
- },
- keywords: ["numberinput","numberfield","stepper","spinner","counter","increment","decrement","quantity","numberpicker"],
+ 'A number input component for collecting numeric user input with validation.', keywords: ["numberinput","numberfield","stepper","spinner","counter","increment","decrement","quantity","numberpicker"],
features: [
'Label Support — required label for accessibility (can be visually hidden)',
'Description — optional description text displayed between the label and input',
diff --git a/packages/core/src/OverflowList/OverflowList.doc.mjs b/packages/core/src/OverflowList/OverflowList.doc.mjs
index 563b6bcea6..39a0bce4ff 100644
--- a/packages/core/src/OverflowList/OverflowList.doc.mjs
+++ b/packages/core/src/OverflowList/OverflowList.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'OverflowList',
description:
- 'Horizontal list that hides items that overflow the available width and shows a custom indicator. Uses a hidden measurement container to avoid layout flicker.',
- showcase: {
- aspectRatio: 16 / 4,
- code: '<XDSOverflowList items={[]} renderItem={() => null} renderOverflow={() => null} />',
- },
- keywords: [
+ 'Horizontal list that hides items that overflow the available width and shows a custom indicator. Uses a hidden measurement container to avoid layout flicker.', keywords: [
'overflow',
'truncate',
'collapse',
diff --git a/packages/core/src/Pagination/Pagination.doc.mjs b/packages/core/src/Pagination/Pagination.doc.mjs
index efbdca708a..f0246c03d1 100644
--- a/packages/core/src/Pagination/Pagination.doc.mjs
+++ b/packages/core/src/Pagination/Pagination.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'Pagination',
description:
- 'Standalone pagination controls for navigating through pages of content. Supports multiple display variants and works with known totals or cursor-based pagination.',
- showcase: {
- aspectRatio: 16 / 4,
- code: '<XDSPagination totalPages={10} currentPage={1} onPageChange={() => {}} />',
- },
- keywords: ["pagination","pager","paginator","pagenavigation","paging","paginate","pages","pagecontrol"],
+ 'Standalone pagination controls for navigating through pages of content. Supports multiple display variants and works with known totals or cursor-based pagination.', keywords: ["pagination","pager","paginator","pagenavigation","paging","paginate","pages","pagecontrol"],
props: [
{
name: 'page',
diff --git a/packages/core/src/Popover/Popover.doc.mjs b/packages/core/src/Popover/Popover.doc.mjs
index c9877323ba..99a80fc542 100644
--- a/packages/core/src/Popover/Popover.doc.mjs
+++ b/packages/core/src/Popover/Popover.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'Popover',
description:
- 'A click-triggered popover for displaying interactive content anchored to a trigger element, implementing the button + dialog ARIA pattern.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSPopover trigger={<button>Open</button>}>Content</XDSPopover>',
- },
- keywords: ["popover","popup","dropdown","tooltip","overlay","flyout","callout","popper","anchor","floating","bubble"],
+ 'A click-triggered popover for displaying interactive content anchored to a trigger element, implementing the button + dialog ARIA pattern.', keywords: ["popover","popup","dropdown","tooltip","overlay","flyout","callout","popper","anchor","floating","bubble"],
features: [
'CSS Anchor Positioning for automatic placement relative to trigger elements',
'Popover API for top-layer rendering — no React portals needed',
diff --git a/packages/core/src/PowerSearch/PowerSearch.doc.mjs b/packages/core/src/PowerSearch/PowerSearch.doc.mjs
index 515eaada7b..9b1c170496 100644
--- a/packages/core/src/PowerSearch/PowerSearch.doc.mjs
+++ b/packages/core/src/PowerSearch/PowerSearch.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'PowerSearch',
description:
- 'Structured filter bar where each token represents a filter (field + operator + value). Users select fields from a typeahead dropdown, configure operators and values in an edit popover, and manage filters as removable tokens.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSPowerSearch config={{name: "search", fields: []}} />',
- },
- keywords: ["powersearch","search","searchbar","filter","filterbar","faceted","querybuilder","structured","omnibar"],
+ 'Structured filter bar where each token represents a filter (field + operator + value). Users select fields from a typeahead dropdown, configure operators and values in an edit popover, and manage filters as removable tokens.', keywords: ["powersearch","search","searchbar","filter","filterbar","faceted","querybuilder","structured","omnibar"],
props: [
{
name: 'config',
diff --git a/packages/core/src/ProgressBar/ProgressBar.doc.mjs b/packages/core/src/ProgressBar/ProgressBar.doc.mjs
index 6f464456b2..57ba45ac33 100644
--- a/packages/core/src/ProgressBar/ProgressBar.doc.mjs
+++ b/packages/core/src/ProgressBar/ProgressBar.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'ProgressBar',
description:
- 'A progress bar for displaying determinate or indeterminate progress.',
- showcase: {
- aspectRatio: 16 / 4,
- code: '<XDSProgressBar label="Loading" value={60} />',
- },
- keywords: ["progressbar","progress","loader","loading","linear","determinate","indeterminate","meter"],
+ 'A progress bar for displaying determinate or indeterminate progress.', keywords: ["progressbar","progress","loader","loading","linear","determinate","indeterminate","meter"],
features: [
'Determinate mode uses role="meter" with aria-valuenow, aria-valuemin, and aria-valuemax',
'Indeterminate mode uses role="progressbar" without value attributes',
diff --git a/packages/core/src/RadioList/RadioList.doc.mjs b/packages/core/src/RadioList/RadioList.doc.mjs
index 52f549c11b..e945100fbc 100644
--- a/packages/core/src/RadioList/RadioList.doc.mjs
+++ b/packages/core/src/RadioList/RadioList.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'RadioList',
description:
- 'A radio group component for single-value selection from a list of options.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSRadioList label="Choice" items={[{label: "A", value: "a"}]} />',
- },
- keywords: ["radiolist","radio","radiogroup","radiobutton","optionlist","singlechoice","choicelist"],
+ 'A radio group component for single-value selection from a list of options.', keywords: ["radiolist","radio","radiogroup","radiobutton","optionlist","singlechoice","choicelist"],
features: [
'Accessible — uses native <input type="radio"> with proper role="radiogroup" and ARIA attributes',
'Orientation — supports vertical and horizontal layouts',
diff --git a/packages/core/src/Section/Section.doc.mjs b/packages/core/src/Section/Section.doc.mjs
index 385b9b5697..4f9e4f607f 100644
--- a/packages/core/src/Section/Section.doc.mjs
+++ b/packages/core/src/Section/Section.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Section',
description:
'Container with background variants for creating visually distinct regions that automatically escape parent container padding for edge-to-edge fills.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSSection title="Section">Content</XDSSection>',
- },
keywords: ["section","panel","container","group","fieldset","region","block"],
features: [
'Background variants: section, transparent, and wash',
diff --git a/packages/core/src/SegmentedControl/SegmentedControl.doc.mjs b/packages/core/src/SegmentedControl/SegmentedControl.doc.mjs
index 4d35603168..8f860dc1e1 100644
--- a/packages/core/src/SegmentedControl/SegmentedControl.doc.mjs
+++ b/packages/core/src/SegmentedControl/SegmentedControl.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'SegmentedControl',
description:
- 'Segmented button group for single selection with radio group semantics. Visually resembles a tab bar but controls a value, not a view.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSSegmentedControl items={[{label: "Tab 1", value: "1"}]} />',
- },
- keywords: ['radio', 'tabs', 'toggle', 'toggle-group', 'pill', 'button-group', 'switch', 'segment', 'control'],
+ 'Segmented button group for single selection with radio group semantics. Visually resembles a tab bar but controls a value, not a view.', keywords: ['radio', 'tabs', 'toggle', 'toggle-group', 'pill', 'button-group', 'switch', 'segment', 'control'],
features: [
'Context-based communication: XDSSegmentedControlContext passes value/onChange/size/isDisabled from parent to children',
'Radio group semantics: role="radiogroup" with role="radio" items and aria-checked',
diff --git a/packages/core/src/Selector/Selector.doc.mjs b/packages/core/src/Selector/Selector.doc.mjs
index b90669caf3..e1e5215ce7 100644
--- a/packages/core/src/Selector/Selector.doc.mjs
+++ b/packages/core/src/Selector/Selector.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'Selector',
description:
- 'Dropdown selector for choosing from a list of options. Follows XDS input conventions with label, status, and field props.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSSelector label="Choose" items={["Option A", "Option B"]} />',
- },
- keywords: ["selector","select","dropdown","combobox","picker","listbox","chooser","autocomplete","option","selectmenu"],
+ 'Dropdown selector for choosing from a list of options. Follows XDS input conventions with label, status, and field props.', keywords: ["selector","select","dropdown","combobox","picker","listbox","chooser","autocomplete","option","selectmenu"],
features: [
'Supports string items (auto-converted to {value, label}), object items with optional icon and disabled state, dividers, and labeled sections',
'Custom item rendering via children render prop and XDSSelectorItem helper',
diff --git a/packages/core/src/SideNav/SideNav.doc.mjs b/packages/core/src/SideNav/SideNav.doc.mjs
index d8f515e322..08e051aedb 100644
--- a/packages/core/src/SideNav/SideNav.doc.mjs
+++ b/packages/core/src/SideNav/SideNav.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'SideNav',
description:
'Sidebar navigation component for application pages. Supports sections, nested items, selected state, icons, and collapsible sidebar.',
- showcase: {
- aspectRatio: 3 / 4,
- code: '<XDSSideNav><XDSSideNavItem label="Dashboard" /></XDSSideNav>',
- },
keywords: ["sidenav","sidebar","navigation","drawer","menu","nav","aside","sidemenu","navmenu","sider","treeview"],
features: [
'Five-zone layout: header, topContent, children (scrollable), footer, footerIcons',
diff --git a/packages/core/src/Skeleton/Skeleton.doc.mjs b/packages/core/src/Skeleton/Skeleton.doc.mjs
index fee2f5176b..db16a4b36f 100644
--- a/packages/core/src/Skeleton/Skeleton.doc.mjs
+++ b/packages/core/src/Skeleton/Skeleton.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Skeleton',
description:
'A placeholder loading component that displays an animated pulsing effect while content is loading.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSSkeleton />',
- },
keywords: ["skeleton","placeholder","loading","shimmer","pulse","loader","bone","ghost","preloader"],
features: [
'Pulsing Animation: Smooth opacity animation using stepped timing for a subtle shimmer effect',
diff --git a/packages/core/src/Slider/Slider.doc.mjs b/packages/core/src/Slider/Slider.doc.mjs
index a14cdf0323..66d365d831 100644
--- a/packages/core/src/Slider/Slider.doc.mjs
+++ b/packages/core/src/Slider/Slider.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'Slider',
description:
- 'A slider component for selecting numeric values or ranges with full keyboard and pointer support.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSSlider label="Volume" value={50} onChange={() => {}} />',
- },
- keywords: ["slider","range","slidebar","trackbar","scrubber","knob","thumb","rangeslider"],
+ 'A slider component for selecting numeric values or ranges with full keyboard and pointer support.', keywords: ["slider","range","slidebar","trackbar","scrubber","knob","thumb","rangeslider"],
features: [
'Single & range modes: Pass a `number` for single thumb, `[number, number]` for range',
'Orientation: Supports `horizontal` and `vertical` layouts',
diff --git a/packages/core/src/Spinner/Spinner.doc.mjs b/packages/core/src/Spinner/Spinner.doc.mjs
index 4c1e61fee0..338560afa7 100644
--- a/packages/core/src/Spinner/Spinner.doc.mjs
+++ b/packages/core/src/Spinner/Spinner.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Spinner',
description:
'An animated loading indicator with optional visible label.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSSpinner label="Loading" />',
- },
keywords: ["spinner","loader","loading","circular","progress","spin","activity","busy","indeterminate"],
features: [
'Canvas Animation: Lightweight canvas-based spinner with smooth 360° rotation',
diff --git a/packages/core/src/Stack/Stack.doc.mjs b/packages/core/src/Stack/Stack.doc.mjs
index e0eaa42696..cc769d31de 100644
--- a/packages/core/src/Stack/Stack.doc.mjs
+++ b/packages/core/src/Stack/Stack.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'Stack',
description:
- 'Stack layout primitives for arranging items in horizontal or vertical sequences using flexbox-based layout with themed spacing tokens.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSVStack gap={2}><div>Item 1</div><div>Item 2</div></XDSVStack>',
- },
- keywords: ["stack","hstack","vstack","flexbox","flex","spacing","gap","horizontal","vertical","row","column"],
+ 'Stack layout primitives for arranging items in horizontal or vertical sequences using flexbox-based layout with themed spacing tokens.', keywords: ["stack","hstack","vstack","flexbox","flex","spacing","gap","horizontal","vertical","row","column"],
features: [
'Horizontal (XDSHStack) and vertical (XDSVStack) stacking',
'Themed spacing via gap tokens from the design system spacing scale',
diff --git a/packages/core/src/StatusDot/StatusDot.doc.mjs b/packages/core/src/StatusDot/StatusDot.doc.mjs
index 92ffe61541..fe6b277bd5 100644
--- a/packages/core/src/StatusDot/StatusDot.doc.mjs
+++ b/packages/core/src/StatusDot/StatusDot.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'StatusDot',
description:
'A small colored dot indicator for status display (online/offline, severity, etc).',
- showcase: {
- aspectRatio: 1,
- code: '<XDSStatusDot variant="positive" label="Online" />',
- },
keywords: ["statusdot","dot","indicator","status","signal","presence","availability","online","pip"],
features: [
'Five semantic color variants: positive, warning, negative, info, neutral',
diff --git a/packages/core/src/Switch/Switch.doc.mjs b/packages/core/src/Switch/Switch.doc.mjs
index 753b4d5609..d57bcd781a 100644
--- a/packages/core/src/Switch/Switch.doc.mjs
+++ b/packages/core/src/Switch/Switch.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Switch',
description:
'A toggle switch component for boolean values with integrated label support.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSSwitch label="Dark mode" />',
- },
keywords: ["switch","toggle","onoff","flipswitch","boolean","toggleswitch"],
features: [
'Boolean toggle — fixed 40x24px track with animated 16px (off) / 20px (on) thumb',
diff --git a/packages/core/src/TabList/TabList.doc.mjs b/packages/core/src/TabList/TabList.doc.mjs
index 3214e2fe3f..d158d37427 100644
--- a/packages/core/src/TabList/TabList.doc.mjs
+++ b/packages/core/src/TabList/TabList.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'TabList',
description:
- 'Tab navigation components with overflow menu support, rendering as a semantic nav landmark with button or anchor tab items.',
- showcase: {
- aspectRatio: 16 / 4,
- code: '<XDSTabList tabs={[{label: "Tab 1"}, {label: "Tab 2"}]} />',
- },
- keywords: ["tabs","tabbar","tabstrip","navigation","tabpanel","tabgroup","segmented","navtabs","tab"],
+ 'Tab navigation components with overflow menu support, rendering as a semantic nav landmark with button or anchor tab items.', keywords: ["tabs","tabbar","tabstrip","navigation","tabpanel","tabgroup","segmented","navtabs","tab"],
features: [
'Context-based communication: XDSTabListContext passes value/onChange/size from XDSTabList to children',
'Single-responsibility XDSTab: renders as <button> or <a> (when href is provided) in the nav',
diff --git a/packages/core/src/Table/Table.doc.mjs b/packages/core/src/Table/Table.doc.mjs
index 95ad7581fb..fd80533576 100644
--- a/packages/core/src/Table/Table.doc.mjs
+++ b/packages/core/src/Table/Table.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'Table',
description:
- 'Data-driven table with rich cell content via renderCell. Compose cells with XDSBadge, XDSStatusDot, XDSText, XDSAvatar, and layout primitives. XDSBaseTable provides the unstyled structural core with a composable plugin pipeline.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSTable data={[]} columns={[]} />',
- },
- keywords: ["table","datatable","datagrid","spreadsheet","sorting","virtualized","columns","rows","selection","pinning"],
+ 'Data-driven table with rich cell content via renderCell. Compose cells with XDSBadge, XDSStatusDot, XDSText, XDSAvatar, and layout primitives. XDSBaseTable provides the unstyled structural core with a composable plugin pipeline.', keywords: ["table","datatable","datagrid","spreadsheet","sorting","virtualized","columns","rows","selection","pinning"],
features: [
'Data-driven rendering — pass data + columns, rows render automatically',
'Rich cell content via renderCell — compose XDS components (XDSBadge, XDSStatusDot, XDSText, XDSAvatar) inside table cells',
diff --git a/packages/core/src/Text/Text.doc.mjs b/packages/core/src/Text/Text.doc.mjs
index 6df475949f..e1556058ad 100644
--- a/packages/core/src/Text/Text.doc.mjs
+++ b/packages/core/src/Text/Text.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Text',
description:
'Typography components for the XDS design system, including semantic body text, headings, and a wrapper for applying typography styles to native HTML.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSText type="body">Hello world</XDSText>',
- },
keywords: ["text","typography","label","paragraph","heading","caption","font","body","subtitle"], features: [
'Semantic text types (body, large, label, supporting, code) driven by theme tokens',
'Headings use native h1–h6 elements with optional aria-level override for decoupled visual vs document hierarchy',
diff --git a/packages/core/src/TextArea/TextArea.doc.mjs b/packages/core/src/TextArea/TextArea.doc.mjs
index b18872c441..006eeb2ee6 100644
--- a/packages/core/src/TextArea/TextArea.doc.mjs
+++ b/packages/core/src/TextArea/TextArea.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'TextArea',
description:
- 'A multi-line text input component for collecting longer user input.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSTextArea label="Description" value="" onChange={() => {}} />',
- },
- keywords: ["textarea","textfield","multiline","comment","message","autoresize","autosize","charlimit"],
+ 'A multi-line text input component for collecting longer user input.', keywords: ["textarea","textfield","multiline","comment","message","autoresize","autosize","charlimit"],
features: [
'Label support — required label for accessibility, can be visually hidden',
'Description — optional text displayed between the label and textarea',
diff --git a/packages/core/src/TextInput/TextInput.doc.mjs b/packages/core/src/TextInput/TextInput.doc.mjs
index caaff71eab..2ab07005b6 100644
--- a/packages/core/src/TextInput/TextInput.doc.mjs
+++ b/packages/core/src/TextInput/TextInput.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'TextInput',
description:
- 'A text input component for collecting user text input, with label, description, validation status, and optional/required indicators.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSTextInput label="Name" value="" onChange={() => {}} />',
- },
- keywords: ["textinput","textfield","input","search","clearable","prefix","suffix","adornment","validation"],
+ 'A text input component for collecting user text input, with label, description, validation status, and optional/required indicators.', keywords: ["textinput","textfield","input","search","clearable","prefix","suffix","adornment","validation"],
features: [
'Label support — required label for accessibility (can be visually hidden)',
'Description — optional text displayed between the label and input',
diff --git a/packages/core/src/Thumbnail/Thumbnail.doc.mjs b/packages/core/src/Thumbnail/Thumbnail.doc.mjs
index 5385f4093b..47ceae342c 100644
--- a/packages/core/src/Thumbnail/Thumbnail.doc.mjs
+++ b/packages/core/src/Thumbnail/Thumbnail.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Thumbnail',
description:
'A square preview card for image attachments. Shows a skeleton shimmer while uploading, the image on success, or a placeholder icon when no source is provided.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSThumbnail src="https://via.placeholder.com/80" alt="Preview" />',
- },
keywords: ["thumbnail","attachment","preview","image","upload","dismiss","remove","loading"],
features: [
'Square 1:1 aspect ratio via CSS aspect-ratio',
diff --git a/packages/core/src/TimeInput/TimeInput.doc.mjs b/packages/core/src/TimeInput/TimeInput.doc.mjs
index 5bd73c5250..465c9b8493 100644
--- a/packages/core/src/TimeInput/TimeInput.doc.mjs
+++ b/packages/core/src/TimeInput/TimeInput.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'TimeInput',
description:
'Time input with free-text entry, text parsing, and arrow-key navigation.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSTimeInput label="Time" />',
- },
keywords: ["timeinput","timepicker","time","clock","hour","minute","ampm","timeselect","timefield"],
features: [
'Accepts free-text time entry and parses common formats (e.g. "2:30 PM", "14:30")',
diff --git a/packages/core/src/Timestamp/Timestamp.doc.mjs b/packages/core/src/Timestamp/Timestamp.doc.mjs
index 76499f8cc1..f06a06f2c7 100644
--- a/packages/core/src/Timestamp/Timestamp.doc.mjs
+++ b/packages/core/src/Timestamp/Timestamp.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'Timestamp',
description:
- 'Displays a formatted timestamp as human-readable text with optional tooltip and live updates. Renders via XDSText for consistent typography.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSTimestamp date={new Date()} />',
- },
- keywords: ['date', 'time', 'datetime', 'relative', 'ago', 'clock', 'format', 'duration'],
+ 'Displays a formatted timestamp as human-readable text with optional tooltip and live updates. Renders via XDSText for consistent typography.', keywords: ['date', 'time', 'datetime', 'relative', 'ago', 'clock', 'format', 'duration'],
props: [
{
name: 'value',
diff --git a/packages/core/src/Toast/Toast.doc.mjs b/packages/core/src/Toast/Toast.doc.mjs
index fcf25b6ad4..6cd46fa413 100644
--- a/packages/core/src/Toast/Toast.doc.mjs
+++ b/packages/core/src/Toast/Toast.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Toast',
description:
'Toast notification system with auto-dismiss, stacking, deduplication, and smooth animations. Uses XDSMediaTheme for inverted surface theming.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSToast message="Saved successfully" />',
- },
keywords: ["toast","notification","snackbar","alert","message","feedback","status"],
features: [
diff --git a/packages/core/src/ToggleButton/ToggleButton.doc.mjs b/packages/core/src/ToggleButton/ToggleButton.doc.mjs
index a6888cf2f4..4a0064d983 100644
--- a/packages/core/src/ToggleButton/ToggleButton.doc.mjs
+++ b/packages/core/src/ToggleButton/ToggleButton.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'ToggleButton',
description:
'A button that toggles between pressed and unpressed states, with optional icon swap and group integration for single or multi-select behavior.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSToggleButton label="Bold" isIconOnly />',
- },
keywords: ["toggle","togglebutton","pressed","toolbar","formatting","segmented","button-group","exclusive","multi-select"],
features: [
'Controlled toggle via isPressed/onPressedChange',
diff --git a/packages/core/src/Token/Token.doc.mjs b/packages/core/src/Token/Token.doc.mjs
index 3310c62f16..b3569e4031 100644
--- a/packages/core/src/Token/Token.doc.mjs
+++ b/packages/core/src/Token/Token.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Token',
description:
'A chip/tag component for displaying entities inline. Renders as a <span> by default, <a> when href is provided, or a <span> with an invisible <button> inside when onClick is provided.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSToken label="Tag" />',
- },
keywords: ["token","chip","tag","pill","label","removable","dismissible","filter chip","closable"],
features: [
'Polymorphic — renders as <span>, <a>, or interactive <span>+<button> based on props',
diff --git a/packages/core/src/Tokenizer/Tokenizer.doc.mjs b/packages/core/src/Tokenizer/Tokenizer.doc.mjs
index 65e649a736..fa07bd25ee 100644
--- a/packages/core/src/Tokenizer/Tokenizer.doc.mjs
+++ b/packages/core/src/Tokenizer/Tokenizer.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'Tokenizer',
description:
- 'Multi-select typeahead with token chips for selected items. Composes XDSBaseTypeahead for search and XDSToken for chips.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSTokenizer label="Tags" items={[]} />',
- },
- keywords: ["tokenizer","multiselect","multi-select","chips","tags","combobox","autocomplete","taginput","chipinput"],
+ 'Multi-select typeahead with token chips for selected items. Composes XDSBaseTypeahead for search and XDSToken for chips.', keywords: ["tokenizer","multiselect","multi-select","chips","tags","combobox","autocomplete","taginput","chipinput"],
props: [
{
name: 'label',
diff --git a/packages/core/src/Toolbar/Toolbar.doc.mjs b/packages/core/src/Toolbar/Toolbar.doc.mjs
index 85d03f5d3a..538c2838ff 100644
--- a/packages/core/src/Toolbar/Toolbar.doc.mjs
+++ b/packages/core/src/Toolbar/Toolbar.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Toolbar',
description:
'General-purpose toolbar with start, center, and end content slots. Built on XDSSection with roving tabindex keyboard navigation.',
- showcase: {
- aspectRatio: 16 / 4,
- code: '<XDSToolbar label="Actions" />',
- },
keywords: ['toolbar', 'nav', 'bar', 'actions', 'buttonbar', 'header', 'footer', 'action-bar', 'control-bar'],
features: [
'Slot-based layout — startContent, centerContent, and endContent for flexible organization',
diff --git a/packages/core/src/Tooltip/Tooltip.doc.mjs b/packages/core/src/Tooltip/Tooltip.doc.mjs
index 9c2e6c1307..80ddc77dbb 100644
--- a/packages/core/src/Tooltip/Tooltip.doc.mjs
+++ b/packages/core/src/Tooltip/Tooltip.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Tooltip',
description:
'A hover/focus triggered tooltip for displaying short, non-interactive text anchored to a trigger element.',
- showcase: {
- aspectRatio: 1,
- code: '<XDSTooltip content="Help text"><button>Hover</button></XDSTooltip>',
- },
keywords: ["tooltip","hint","infotip","title","hover","flyout","balloon","helpertext"],
features: [
'CSS Anchor Positioning for automatic placement relative to trigger elements',
diff --git a/packages/core/src/TopNav/TopNav.doc.mjs b/packages/core/src/TopNav/TopNav.doc.mjs
index 010d951561..591849f461 100644
--- a/packages/core/src/TopNav/TopNav.doc.mjs
+++ b/packages/core/src/TopNav/TopNav.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'TopNav',
description:
'Top navigation bar component for application headers with slot-based layout and companion nav item components.',
- showcase: {
- aspectRatio: 16 / 4,
- code: '<XDSTopNav label="Navigation" />',
- },
keywords: ["topnav","navbar","appbar","header","toolbar","navigation","menubar","topbar"],
features: [
'Slot-based layout — heading, startContent, centerContent, and endContent slots for flexible organization',
diff --git a/packages/core/src/TreeList/TreeList.doc.mjs b/packages/core/src/TreeList/TreeList.doc.mjs
index 598c9a2cca..3752a0271d 100644
--- a/packages/core/src/TreeList/TreeList.doc.mjs
+++ b/packages/core/src/TreeList/TreeList.doc.mjs
@@ -3,12 +3,7 @@
export const docs = {
name: 'TreeList',
description:
- 'Data-driven tree list component for rendering hierarchical data with expand/collapse, branch lines, and interactive items. Uses a flat items array with recursive children — no composition, no cloneElement.',
- showcase: {
- aspectRatio: 3 / 4,
- code: '<XDSTreeList items={[{label: "Root"}]} />',
- },
- keywords: ['tree', 'hierarchy', 'nested', 'accordion', 'folder', 'expand', 'collapse', 'treeview', 'outline'],
+ 'Data-driven tree list component for rendering hierarchical data with expand/collapse, branch lines, and interactive items. Uses a flat items array with recursive children — no composition, no cloneElement.', keywords: ['tree', 'hierarchy', 'nested', 'accordion', 'folder', 'expand', 'collapse', 'treeview', 'outline'],
features: [
'Data-driven API — items array with recursive children',
'Internal expansion state — seed via isExpanded on each item',
diff --git a/packages/core/src/Typeahead/Typeahead.doc.mjs b/packages/core/src/Typeahead/Typeahead.doc.mjs
index aa139cf620..1efdf1ed92 100644
--- a/packages/core/src/Typeahead/Typeahead.doc.mjs
+++ b/packages/core/src/Typeahead/Typeahead.doc.mjs
@@ -4,10 +4,6 @@ export const docs = {
name: 'Typeahead',
description:
'Searchable dropdown components for single-item selection with keyboard navigation. Supports async and sync search via a searchSource interface.',
- showcase: {
- aspectRatio: 4 / 3,
- code: '<XDSTypeahead label="Search" />',
- },
keywords: ["typeahead","autocomplete","combobox","searchbox","autosuggest","select","dropdown","lookup","searchable","suggestion","picker"],
features: [
'Async and sync search via a searchSource interface with search() and bootstrap() methods',
diff --git a/packages/core/src/docs-types.ts b/packages/core/src/docs-types.ts
index c2e7d04505..030d49efd5 100644
--- a/packages/core/src/docs-types.ts
+++ b/packages/core/src/docs-types.ts
@@ -47,28 +47,6 @@ export interface PropDoc {
required?: boolean;
}
-/**
- * A usage example showing the component in JSX. Examples should progress
- * from basic to advanced. Include 2-5 examples per component (complex
- * components like Table or Layer may justify more).
- *
- * @example
- * ```
- * {label: 'Basic', code: '<XDSButton variant="primary">Save</XDSButton>'}
- * {label: 'With icon', code: '<XDSButton icon={PlusIcon} variant="secondary">Add</XDSButton>'}
- * ```
- */
-export interface Example {
- /** Short descriptive title in sentence case, 2-8 words.
- * e.g. `"Basic"`, `"With icon"`, `"Rich cell content with renderCell"`.
- * Omit only for trivial single-example sub-components. */
- label?: string;
- /** JSX code string. Use regular strings for single-line snippets and
- * template literals for multi-line code. Prefer realistic variable names
- * (`users`, `transactions`) over generic ones (`data`, `value1`). */
- code: string;
-}
-
/**
* A theming target — a stable CSS class name that `defineTheme` can target
* via `@scope` selectors. Each component renders one or more class names
@@ -159,8 +137,6 @@ export interface ComponentEntry {
description: string;
/** All public props for this component. */
props: PropDoc[];
- /** Usage examples for this component. */
- examples?: Example[];
}
/**
@@ -227,20 +203,6 @@ interface BaseDoc {
* Be specific enough to differentiate from similar components.
* e.g. `"Data-driven table with rich cell content via renderCell."` */
description: string;
- /** Top-level usage examples showing the component in real scenarios.
- * For multi-component dirs, these show how the components work together.
- * Start with the most common usage pattern, then progress to advanced.
- * Include 2-5 examples (complex components may justify more). */
- examples?: Example[];
- /** Minimal JSX code string showing the component in its simplest valid
- * form. Used as the live preview "cover image" in gallery views.
- * e.g. `'<XDSButton label="Click" variant="primary" />'` */
- showcase?: {
- /** Width-to-height ratio for the preview container. */
- aspectRatio: number;
- /** JSX code string of the component in minimal form. */
- code: string;
- };
/** Search keywords for CLI discovery. Terms a developer might type when
* looking for this component: synonyms, related UI concepts, and common
* names from other design systems (MUI, Chakra, Radix, shadcn).
@@ -335,7 +297,7 @@ export type ComponentDoc = SingleComponentDoc | MultiComponentDoc;
* Translation overlay for component documentation.
*
* Contains only the prose fields that change between languages/formats.
- * The CLI merges this onto the base `docs` at read time — props, examples,
+ * The CLI merges this onto the base `docs` at read time — props,
* types, defaults, and code all come from `docs`.
*
* Used by both `docsZh` (Chinese translation) and `docsDense` (compressed format).
@@ -505,3 +467,21 @@ export interface BlockTemplateDoc extends BaseTemplateDoc {
}
export type TemplateDoc = PageTemplateDoc | BlockTemplateDoc;
+
+/**
+ * Showcase metadata for a component.
+ *
+ * Each component can have a showcase file in `packages/cli/templates/showcase/`
+ * consisting of a `{Name}.doc.mjs` (this type) and a `{Name}.tsx` (the component).
+ *
+ * /\*\* \@type \{import('@xds/core').ComponentShowcaseDoc\} *\/
+ * export const doc = \{ name: 'Button', aspectRatio: 1 \};
+ */
+export interface ComponentShowcaseDoc {
+ /** Component name (matches the directory name).
+ * e.g. `"Button"`, `"Layout"`, `"Dialog"` */
+ name: string;
+ /** Width-to-height ratio for the preview container.
+ * e.g. `1`, `16 / 9`, `4 / 3` */
+ aspectRatio: number;
+}
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index 7fae9b60d3..5fa4949c5d 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -150,10 +150,10 @@ export type {
SingleComponentDoc,
MultiComponentDoc,
PropDoc,
- Example,
ComponentEntry,
ThemingTarget,
CSSPropertyDoc,
ComponentVar,
TranslationDoc,
+ ComponentShowcaseDoc,
} from './docs-types';