Skip to content

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

TypeScript

docs(docsite): update component categories for overview page (#2444)

Kenton Quatman6ef735abcc36
diff --git a/apps/docsite/scripts/generate-data.mjs b/apps/docsite/scripts/generate-data.mjs
index 6a3049a3b8..a5260e99e6 100644
--- a/apps/docsite/scripts/generate-data.mjs
+++ b/apps/docsite/scripts/generate-data.mjs
@@ -309,7 +309,7 @@ async function generateComponentRegistry() {
directory: entry.name,
group,
category,
- isHiddenFromOverview: isHiddenFromOverview || isSubEntry,
+ isHiddenFromOverview: sub.isHiddenFromOverview ?? isHiddenFromOverview,
description: sub.description || topDescription,
keywords,
hidden,
diff --git a/apps/docsite/src/__tests__/data-extraction.test.ts b/apps/docsite/src/__tests__/data-extraction.test.ts
index 1bbd2a3f29..a38752ef65 100644
--- a/apps/docsite/src/__tests__/data-extraction.test.ts
+++ b/apps/docsite/src/__tests__/data-extraction.test.ts
@@ -165,8 +165,9 @@ describe('componentRegistry', () => {
it('Chat has many sub-components (standalone docs take priority over compound entries)', () => {
const core = components['@xds/core'];
- // Chat compound doc has 14 sub-components, but ChatToolCalls has its own
- // standalone doc so it appears with parentDoc: null instead of parentDoc: 'Chat'
+ // Chat compound doc has 14 sub-components, but ChatToolCalls and
+ // ChatDictationButton have their own standalone docs so they appear
+ // with parentDoc: null instead of parentDoc: 'Chat'
const chatSubs = core.filter(c => c.parentDoc === 'Chat');
expect(chatSubs.length).toBeGreaterThanOrEqual(12);
const chatNames = chatSubs.map(c => c.name);
diff --git a/apps/docsite/src/app/(docs)/components/page.tsx b/apps/docsite/src/app/(docs)/components/page.tsx
index 7115aaf7e5..dfe76eae10 100644
--- a/apps/docsite/src/app/(docs)/components/page.tsx
+++ b/apps/docsite/src/app/(docs)/components/page.tsx
@@ -24,21 +24,23 @@ import {ShowcaseThumbnail} from '../../../components/ShowcaseThumbnail';
* Sourced from component .doc.mjs `category` fields.
*/
const CATEGORIES = [
- 'Actions',
- 'Communications',
- 'Containers',
+ 'Action',
+ 'Chat',
+ 'Container',
+ 'Content',
+ 'Data Input',
+ 'Data Visualization',
+ 'Feedback & Status',
'Layout',
- 'Inputs',
- 'Lists',
'Navigation',
- 'Performance',
+ 'Overlay',
+ 'Table & List',
+ 'Utility',
] as const;
/** Map of showcase blocks by component name for thumbnails */
const showcaseMap = new Map(
- blocks
- .filter(b => b.isShowcase)
- .map(b => [b.componentsUsed[0] || b.exampleFor, b]),
+ blocks.filter(b => b.isShowcase).map(b => [b.exampleFor, b]),
);
const styles = stylex.create({
@@ -75,15 +77,21 @@ export default function ComponentsGalleryPage() {
for (const comp of coreComponents) {
// Skip components explicitly hidden from overview
- if (comp.isHiddenFromOverview) {continue;}
+ if (comp.isHiddenFromOverview) {
+ continue;
+ }
// Skip hidden components
- if (comp.hidden) {continue;}
- // Skip hooks (they appear in the Utilities section)
- if (comp.name.startsWith('use')) {continue;}
+ if (comp.hidden) {
+ continue;
+ }
+ // Skip hooks
+ if (comp.name.startsWith('use')) {
+ continue;
+ }
// Skip components without a category
- if (!comp.category) {continue;}
- // Skip utilities group
- if (comp.group === 'Utilities') {continue;}
+ if (!comp.category) {
+ continue;
+ }
items.push({
name: comp.name,
@@ -106,7 +114,9 @@ export default function ComponentsGalleryPage() {
}
for (const item of categorizedItems) {
const list = map.get(item.category);
- if (list) {list.push(item);}
+ if (list) {
+ list.push(item);
+ }
}
return map;
}, [categorizedItems]);
@@ -126,7 +136,9 @@ export default function ComponentsGalleryPage() {
{CATEGORIES.map(cat => {
const items = groupedByCategory.get(cat) ?? [];
- if (items.length === 0) {return null;}
+ if (items.length === 0) {
+ return null;
+ }
return (
<Fragment key={cat}>
diff --git a/packages/cli/templates/blocks/components/Card/ClickableCardShowcase.doc.mjs b/packages/cli/templates/blocks/components/Card/ClickableCardShowcase.doc.mjs
index 4c4e581571..66acb8c3a6 100644
--- a/packages/cli/templates/blocks/components/Card/ClickableCardShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Card/ClickableCardShowcase.doc.mjs
@@ -3,7 +3,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
- exampleFor: 'Card',
+ exampleFor: 'ClickableCard',
name: 'ClickableCard',
displayName: 'Clickable Card',
description:
diff --git a/packages/cli/templates/blocks/components/Card/ClickableCardWithNestedButton.doc.mjs b/packages/cli/templates/blocks/components/Card/ClickableCardWithNestedButton.doc.mjs
index cc96286910..d8e47e0fa0 100644
--- a/packages/cli/templates/blocks/components/Card/ClickableCardWithNestedButton.doc.mjs
+++ b/packages/cli/templates/blocks/components/Card/ClickableCardWithNestedButton.doc.mjs
@@ -3,7 +3,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
- exampleFor: 'Card',
+ exampleFor: 'ClickableCard',
name: 'ClickableCardWithNestedButton',
displayName: 'Clickable Card With Nested Button',
description:
diff --git a/packages/cli/templates/blocks/components/Card/SelectableCardMulti.doc.mjs b/packages/cli/templates/blocks/components/Card/SelectableCardMulti.doc.mjs
index c0c26af9bb..5a3a240f22 100644
--- a/packages/cli/templates/blocks/components/Card/SelectableCardMulti.doc.mjs
+++ b/packages/cli/templates/blocks/components/Card/SelectableCardMulti.doc.mjs
@@ -3,7 +3,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
- exampleFor: 'Card',
+ exampleFor: 'SelectableCard',
name: 'SelectableCardMulti',
displayName: 'Selectable Card Multi',
description:
diff --git a/packages/cli/templates/blocks/components/Card/SelectableCardShowcase.doc.mjs b/packages/cli/templates/blocks/components/Card/SelectableCardShowcase.doc.mjs
index 52e569c344..b2922b018c 100644
--- a/packages/cli/templates/blocks/components/Card/SelectableCardShowcase.doc.mjs
+++ b/packages/cli/templates/blocks/components/Card/SelectableCardShowcase.doc.mjs
@@ -3,7 +3,7 @@
/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
export const doc = {
type: 'block',
- exampleFor: 'Card',
+ exampleFor: 'SelectableCard',
name: 'SelectableCard',
displayName: 'Selectable Card',
description:
diff --git a/packages/core/src/AlertDialog/AlertDialog.doc.mjs b/packages/core/src/AlertDialog/AlertDialog.doc.mjs
index 1fd2a7faa6..3ff55a5fe6 100644
--- a/packages/core/src/AlertDialog/AlertDialog.doc.mjs
+++ b/packages/core/src/AlertDialog/AlertDialog.doc.mjs
@@ -6,7 +6,8 @@ export const docs = {
name: 'AlertDialog',
displayName: 'Alert Dialog',
group: 'Dialog',
- category: 'Containers',
+ category: 'Overlay',
+ isHiddenFromOverview: true,
keywords: [
'alert',
'alertdialog',
@@ -40,6 +41,7 @@ export const docs = {
components: [
{
name: 'XDSAlertDialog',
+ isHiddenFromOverview: true,
displayName: 'Alert Dialog',
description: 'A modal dialog that asks the user to confirm a destructive action.',
props: [
diff --git a/packages/core/src/AppShell/AppShell.doc.mjs b/packages/core/src/AppShell/AppShell.doc.mjs
index 3108841e94..572e640ddd 100644
--- a/packages/core/src/AppShell/AppShell.doc.mjs
+++ b/packages/core/src/AppShell/AppShell.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'AppShell',
displayName: 'App Shell',
- category: 'Containers',
+ category: 'Layout',
keywords: ["appshell","layout","scaffold","sidebar","sidenav","topnav","header","navigation","dashboard","shell","page","frame"],
usage: {
description:
diff --git a/packages/core/src/Avatar/Avatar.doc.mjs b/packages/core/src/Avatar/Avatar.doc.mjs
index 3771718353..26571ef463 100644
--- a/packages/core/src/Avatar/Avatar.doc.mjs
+++ b/packages/core/src/Avatar/Avatar.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'Avatar',
displayName: 'Avatar',
group: 'Avatar',
- category: 'Communications',
+ category: 'Content',
keywords: ["avatar","profile","user","photo","thumbnail","initials","gravatar","pfp","userpic"],
usage: {
description:
@@ -73,6 +73,7 @@ export const docs = {
], },
{
name: 'XDSAvatarStatusDot',
+ isHiddenFromOverview: true,
displayName: 'Avatar Status Dot',
description:
'Size-aware status indicator dot that reads avatar size from context and scales proportionally.',
@@ -146,6 +147,7 @@ export const docsZh = {
},
{
name: 'XDSAvatarStatusDot',
+ isHiddenFromOverview: true,
displayName: 'Avatar Status Dot',
description: '尺寸感知的状态指示点,从上下文中读取头像尺寸并等比缩放。',
props: [
@@ -188,6 +190,7 @@ export const docsDense = {
},
{
name: 'XDSAvatarStatusDot',
+ isHiddenFromOverview: true,
displayName: 'Avatar Status Dot',
description: 'size-aware status dot, reads avatar size from context + scales proportionally',
propDescriptions: {
diff --git a/packages/core/src/AvatarGroup/AvatarGroup.doc.mjs b/packages/core/src/AvatarGroup/AvatarGroup.doc.mjs
index 40ccdc8bbb..55ad1d52e7 100644
--- a/packages/core/src/AvatarGroup/AvatarGroup.doc.mjs
+++ b/packages/core/src/AvatarGroup/AvatarGroup.doc.mjs
@@ -5,7 +5,7 @@ export const docs = {
name: 'AvatarGroup',
displayName: 'Avatar Group',
group: 'Avatar',
- category: 'Communications',
+ category: 'Content',
keywords: ['avatar', 'group', 'facepile', 'stack', 'overlap', 'participants', 'assignees', 'members', 'team'],
usage: {
description:
@@ -41,6 +41,7 @@ export const docs = {
},
{
name: 'XDSAvatarGroupOverflow',
+ isHiddenFromOverview: true,
displayName: 'Avatar Group Overflow',
description: 'Slot for custom overflow content inside XDSAvatarGroup. Replaces the default "+N" indicator when present.',
props: [
@@ -78,6 +79,7 @@ export const docsZh = {
},
{
name: 'XDSAvatarGroupOverflow',
+ isHiddenFromOverview: true,
displayName: 'Avatar Group Overflow',
description: 'XDSAvatarGroup 内的自定义溢出内容插槽。存在时替换默认的 "+N" 指示器。',
propDescriptions: {
@@ -116,6 +118,7 @@ export const docsDense = {
},
{
name: 'XDSAvatarGroupOverflow',
+ isHiddenFromOverview: true,
displayName: 'Avatar Group Overflow',
description: 'custom overflow slot, replaces default +N',
propDescriptions: {
diff --git a/packages/core/src/Badge/Badge.doc.mjs b/packages/core/src/Badge/Badge.doc.mjs
index ebaeb2bfae..736d78172a 100644
--- a/packages/core/src/Badge/Badge.doc.mjs
+++ b/packages/core/src/Badge/Badge.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Badge',
displayName: 'Badge',
- category: 'Communications',
+ category: 'Feedback & Status',
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 20d911bb96..9fc2f2dc24 100644
--- a/packages/core/src/Banner/Banner.doc.mjs
+++ b/packages/core/src/Banner/Banner.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Banner',
displayName: 'Banner',
- category: 'Communications',
+ category: 'Feedback & Status',
keywords: ["banner","alert","notification","callout","notice","status","message","info","warning","error","success","toast"],
usage: {
description:
diff --git a/packages/core/src/Blockquote/Blockquote.doc.mjs b/packages/core/src/Blockquote/Blockquote.doc.mjs
index dd75c5cd22..212ac68563 100644
--- a/packages/core/src/Blockquote/Blockquote.doc.mjs
+++ b/packages/core/src/Blockquote/Blockquote.doc.mjs
@@ -7,7 +7,7 @@
export const docs = {
name: 'Blockquote',
displayName: 'Blockquote',
- category: 'Communications',
+ category: 'Content',
keywords: ["blockquote","quote","citation","pullquote","quotation","cite","excerpt"],
props: [
{
diff --git a/packages/core/src/Breadcrumbs/Breadcrumbs.doc.mjs b/packages/core/src/Breadcrumbs/Breadcrumbs.doc.mjs
index 7ac948360a..e5aa920a22 100644
--- a/packages/core/src/Breadcrumbs/Breadcrumbs.doc.mjs
+++ b/packages/core/src/Breadcrumbs/Breadcrumbs.doc.mjs
@@ -77,6 +77,7 @@ export const docs = {
], },
{
name: 'XDSBreadcrumbItem',
+ isHiddenFromOverview: true,
displayName: 'Breadcrumb Item',
description:
'Individual breadcrumb item that renders as a link when href is provided, or as plain text for the current page.',
@@ -171,6 +172,7 @@ export const docsZh = {
},
{
name: 'XDSBreadcrumbItem',
+ isHiddenFromOverview: true,
displayName: 'Breadcrumb Item',
description: '单个面包屑项,提供 href 时渲染为链接,当前页面渲染为纯文本。',
props: [
@@ -215,6 +217,7 @@ export const docsDense = {
},
{
name: 'XDSBreadcrumbItem',
+ isHiddenFromOverview: true,
displayName: 'Breadcrumb Item',
description: 'individual breadcrumb; link w/ href, plain text for current page',
propDescriptions: {
diff --git a/packages/core/src/Button/Button.doc.mjs b/packages/core/src/Button/Button.doc.mjs
index 05c1b4f420..19130c7ed6 100644
--- a/packages/core/src/Button/Button.doc.mjs
+++ b/packages/core/src/Button/Button.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'Button',
displayName: 'Button',
group: 'Button',
- category: 'Actions',
+ category: 'Action',
keywords: ["button","btn","cta","submit","action","loading","primary","secondary","ghost","destructive","danger"],
diff --git a/packages/core/src/ButtonGroup/ButtonGroup.doc.mjs b/packages/core/src/ButtonGroup/ButtonGroup.doc.mjs
index dc4fb71136..b33a1f35bd 100644
--- a/packages/core/src/ButtonGroup/ButtonGroup.doc.mjs
+++ b/packages/core/src/ButtonGroup/ButtonGroup.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'ButtonGroup',
displayName: 'Button Group',
group: 'Button',
- category: 'Actions',
+ category: 'Action',
keywords: ["button-group","connected","split","toolbar","actions","grouped","buttons"],
playground: {
defaults: {
diff --git a/packages/core/src/Calendar/Calendar.doc.mjs b/packages/core/src/Calendar/Calendar.doc.mjs
index 4934b4d534..651833fbe4 100644
--- a/packages/core/src/Calendar/Calendar.doc.mjs
+++ b/packages/core/src/Calendar/Calendar.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Calendar',
displayName: 'Calendar',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["calendar","datepicker","date picker","rangepicker","date range","monthview","daypicker"],
usage: {
description:
diff --git a/packages/core/src/Card/Card.doc.mjs b/packages/core/src/Card/Card.doc.mjs
index 96c7b17dcf..cec88aaa49 100644
--- a/packages/core/src/Card/Card.doc.mjs
+++ b/packages/core/src/Card/Card.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'Card',
displayName: 'Card',
group: 'Card',
- category: 'Containers',
+ category: 'Container',
keywords: ["card","surface","panel","container","elevated","shadow","box","paper","tile","well"],
usage: {
description:
diff --git a/packages/core/src/Carousel/Carousel.doc.mjs b/packages/core/src/Carousel/Carousel.doc.mjs
index b30f945c55..8fe58aa306 100644
--- a/packages/core/src/Carousel/Carousel.doc.mjs
+++ b/packages/core/src/Carousel/Carousel.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Carousel',
displayName: 'Carousel',
- category: 'Lists',
+ category: 'Container',
keywords: ['carousel', 'slider', 'scroll', 'gallery', 'filmstrip', 'swiper', 'horizontal', 'overflow', 'snap'],
usage: {
description:
diff --git a/packages/core/src/Center/Center.doc.mjs b/packages/core/src/Center/Center.doc.mjs
index f3fde67432..d944a7acc6 100644
--- a/packages/core/src/Center/Center.doc.mjs
+++ b/packages/core/src/Center/Center.doc.mjs
@@ -7,6 +7,7 @@ export const docs = {
displayName: 'Center',
group: 'Layout',
category: 'Layout',
+ isHiddenFromOverview: true,
keywords: ["center","centered","centering","align","alignment","justify","flexbox","middle"],
props: [
{
diff --git a/packages/core/src/Chat/Chat.doc.mjs b/packages/core/src/Chat/Chat.doc.mjs
index 169a832f80..02200ec681 100644
--- a/packages/core/src/Chat/Chat.doc.mjs
+++ b/packages/core/src/Chat/Chat.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'Chat',
displayName: 'Chat',
group: 'Chat',
- category: 'Communications',
+ category: 'Chat',
keywords: ['chat', 'message', 'bubble', 'conversation', 'ai', 'assistant', 'thread', 'system-message', 'composer', 'mention', 'trigger', 'typeahead', 'token', 'imperative', 'tokenized-text'],
theming: {
targets: [
@@ -40,6 +40,7 @@ export const docs = {
components: [
{
name: 'XDSChatMessageList',
+ isHiddenFromOverview: true,
displayName: 'Chat Message List',
description: 'Presentational message container with density context and infinite scroll support. Provides role="log" with aria-live="polite" for accessibility. A flex spacer pushes messages to the bottom when the list isn\'t full.',
props: [
@@ -71,6 +72,7 @@ export const docs = {
},
{
name: 'XDSChatMessageBubble',
+ isHiddenFromOverview: true,
displayName: 'Chat Message Bubble',
description: 'Styled content container — the chat “bubble.” Reads sender from parent XDSChatMessage context to auto-style the background. Use filled for standard messages and ghost when content needs alignment without a visible boundary. Supports name/metadata slots aligned with bubble padding, and multi-bubble grouping via the group prop for consecutive messages from the same sender.',
props: [
@@ -149,6 +151,7 @@ export const docs = {
},
{
name: 'XDSChatComposerInput',
+ isHiddenFromOverview: true,
displayName: 'Chat Composer Input',
description: 'Rich text input for the chat composer. Supports trigger menus (type @ or / to open a typeahead), inline tokens rendered as badges, message history recall with ArrowUp/Down, paste/drop file handling, and a 16px touch-device font-size floor to prevent iOS input zoom. Pass it to XDSChatComposer\'s input slot when you need more than a plain textarea.',
props: [
@@ -169,6 +172,7 @@ export const docs = {
},
{
name: 'XDSChatComposerDrawer',
+ isHiddenFromOverview: true,
displayName: 'Chat Composer Drawer',
description: 'Collapsible drawer panel that sits above the chat input inside XDSChatComposer. Pass it to the composer\'s `drawer` slot to show attachments, context chips, or any supplementary content. When `count` is provided the drawer gains a collapse toggle — collapsed state shows a badge and label, expanded state shows all children.',
props: [
@@ -182,6 +186,7 @@ export const docs = {
},
{
name: 'XDSChatSendButton',
+ isHiddenFromOverview: true,
displayName: 'Chat Send Button',
description: 'Circular send/stop toggle button for the chat composer. Place it inside XDSChatComposer where it reads context automatically — no wiring needed. When streaming starts, the button switches from a primary send icon to a secondary stop icon. Override any context value via props for standalone or custom usage.',
props: [
@@ -213,6 +218,7 @@ export const docs = {
},
{
name: 'XDSChatTokenizedText',
+ isHiddenFromOverview: true,
displayName: 'Chat Tokenized Text',
description: 'Renders a text string with token patterns replaced by inline XDSBadge components. Wrap any message body inside XDSChatMessageBubble to turn raw @mentions, #tags, or /commands into styled badges. When no tokens match or none are provided, the text renders as-is — so you can use ChatTokenizedText unconditionally on every message.',
props: [
@@ -222,6 +228,7 @@ export const docs = {
},
{
name: 'XDSChatComposerTokenElement',
+ isHiddenFromOverview: true,
displayName: 'Chat Composer Token Element',
description: 'Renders a single token chip outside the contentEditable input. Wraps a badge config or custom render function in the correct data-xds-token span so the token serializes properly and stays visually consistent with tokens inside the composer.',
props: [
@@ -282,6 +289,7 @@ docs.components.push(chatLayoutComponent);
const chatLayoutScrollButtonComponent = {
name: 'XDSChatLayoutScrollButton',
+ isHiddenFromOverview: true,
displayName: 'Chat Layout Scroll Button',
description: 'Floating scroll-to-bottom button that appears when the user scrolls away from the latest messages. It fades in as a compact icon button and expands to show a label when new messages arrive. XDSChatLayout renders this by default — pass a custom element to the scrollButton prop to override, or null to hide it entirely.',
props: [
@@ -322,6 +330,7 @@ export const docsZh = {
components: [
{
name: 'XDSChatMessageList',
+ isHiddenFromOverview: true,
displayName: 'Chat Message List',
description: '消息展示容器,支持密度上下文和无限滚动。自动滚动由 XDSChatLayout 管理。',
propDescriptions: {
@@ -347,6 +356,7 @@ export const docsZh = {
},
{
name: 'XDSChatMessageBubble',
+ isHiddenFromOverview: true,
displayName: 'Chat Message Bubble',
description: '样式化的气泡容器,从父上下文读取发送者信息进行自动样式化。支持 name/metadata 插槽、多气泡分组和透明变体。',
propDescriptions: {
@@ -395,6 +405,7 @@ export const docsZh = {
},
{
name: 'XDSChatComposerInput',
+ isHiddenFromOverview: true,
displayName: 'Chat Composer Input',
description:
'聊天编写器的富文本输入。支持触发菜单(输入 @ 或 / 打开 typeahead)、内联标记徽章、ArrowUp/Down 消息历史回溯、粘贴/拖放文件处理,并在触控设备上将字体大小保持至少 16px 以避免 iOS 输入缩放。当需要普通文本区域以外的功能时,传入 XDSChatComposer 的 input 插槽。',
@@ -416,12 +427,14 @@ export const docsZh = {
},
{
name: 'XDSChatComposerDrawer',
+ isHiddenFromOverview: true,
displayName: 'Chat Composer Drawer',
description: '位于聊天输入上方的可折叠抽屉面板。传入 XDSChatComposer 的 `drawer` 插槽,用于显示附件、上下文标签或预览内容。提供 `count` 时启用折叠切换。',
propDescriptions: {children: '抽屉内渲染的内容——标记、标签、预览或任何 React 元素。', count: '折叠徽章中显示的总数。提供时,抽屉获得折叠/展开切换。', label: '折叠状态下显示在数量旁边的标签。', isCollapsed: '受控折叠状态。与 onCollapsedChange 一起使用。', defaultIsCollapsed: '非受控模式的初始折叠状态。', onCollapsedChange: '用户切换抽屉时触发的回调。'},
},
{
name: 'XDSChatSendButton',
+ isHiddenFromOverview: true,
displayName: 'Chat Send Button',
description:
'编写器的圆形发送/停止切换按钮。默认从 XDSChatComposerContext 读取状态,在 XDSChatComposer 内自动工作。所有上下文值均可通过 props 覆盖以用于独立使用。',
@@ -452,6 +465,7 @@ export const docsZh = {
},
{
name: 'XDSChatTokenizedText',
+ isHiddenFromOverview: true,
displayName: 'Chat Tokenized Text',
description:
'渲染带有标记模式的文本,将匹配的模式替换为内联 XDSBadge 组件。在 XDSChatMessageBubble 内使用,将 @提及、#标签或 /命令显示为样式化徽章。未提供标记时以纯文本渲染,因此可以无条件使用。',
@@ -459,6 +473,7 @@ export const docsZh = {
},
{
name: 'XDSChatComposerTokenElement',
+ isHiddenFromOverview: true,
displayName: 'Chat Composer Token Element',
description: '在 contentEditable 外部渲染标记芯片。',
propDescriptions: {token: '徽章配置或自定义渲染。'},
@@ -477,6 +492,7 @@ export const docsZh = {
},
{
name: 'XDSChatLayoutScrollButton',
+ isHiddenFromOverview: true,
displayName: 'Chat Layout Scroll Button',
description: '可组合的滚动到底部按钮。可见时淡入,提供标签时展开。',
propDescriptions: {isVisible: '按钮是否可见。', label: '可选标签 — 展开按钮(如"新消息")。', onClick: '点击处理器。'},
@@ -509,6 +525,7 @@ export const docsDense = {
components: [
{
name: 'XDSChatMessageList',
+ isHiddenFromOverview: true,
displayName: 'Chat Message List',
description: 'presentational msg container w/ density context + infinite scroll; auto-scroll owned by XDSChatLayout',
propDescriptions: {
@@ -535,6 +552,7 @@ export const docsDense = {
},
{
name: 'XDSChatMessageBubble',
+ isHiddenFromOverview: true,
displayName: 'Chat Message Bubble',
description: 'styled bubble container; reads sender from context; supports name/metadata slots, group corners, ghost variant',
propDescriptions: {
@@ -592,6 +610,7 @@ export const docsDense = {
},
{
name: 'XDSChatComposerInput',
+ isHiddenFromOverview: true,
displayName: 'Chat Composer Input',
description: 'rich input for composer; trigger menus (@/commands), inline tokens, msg history, paste/drop files, 16px touch font-size floor to prevent iOS zoom. Use in XDSChatComposer input slot when you need more than plain textarea.',
propDescriptions: {
@@ -612,6 +631,7 @@ export const docsDense = {
},
{
name: 'XDSChatComposerDrawer',
+ isHiddenFromOverview: true,
displayName: 'Chat Composer Drawer',
description: 'collapsible drawer above chat input; pass to composer `drawer` slot for attachments, context chips, previews. `count` enables collapse toggle',
propDescriptions: {
@@ -625,6 +645,7 @@ export const docsDense = {
},
{
name: 'XDSChatSendButton',
+ isHiddenFromOverview: true,
displayName: 'Chat Send Button',
description: 'circular send/stop toggle btn for composer; reads XDSChatComposerContext; all context vals overridable via props',
propDescriptions: {
@@ -652,6 +673,7 @@ export const docsDense = {
},
{
name: 'XDSChatTokenizedText',
+ isHiddenFromOverview: true,
displayName: 'Chat Tokenized Text',
description: 'renders text w/ token patterns replaced by inline badges; use in bubble for @mentions, #tags, /commands; degrades to plain text when no tokens match',
propDescriptions: {
@@ -661,6 +683,7 @@ export const docsDense = {
},
{
name: 'XDSChatComposerTokenElement',
+ isHiddenFromOverview: true,
displayName: 'Chat Composer Token Element',
description: 'token chip outside contentEditable; badge config or custom render in data-xds-token span',
propDescriptions: {token: 'badge config or custom render'},
@@ -679,6 +702,7 @@ export const docsDense = {
},
{
name: 'XDSChatLayoutScrollButton',
+ isHiddenFromOverview: true,
displayName: 'Chat Layout Scroll Button',
description: 'floating scroll-to-bottom btn; fades in when scrolled up, expands w/ label for new msgs. Default in XDSChatLayout; override via scrollButton prop.',
propDescriptions: {
diff --git a/packages/core/src/Chat/ChatDictationButton.doc.mjs b/packages/core/src/Chat/ChatDictationButton.doc.mjs
index 172bc25c8f..214716c3dc 100644
--- a/packages/core/src/Chat/ChatDictationButton.doc.mjs
+++ b/packages/core/src/Chat/ChatDictationButton.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'ChatDictationButton',
displayName: 'Chat Dictation Button',
group: 'Chat',
- category: 'Communications',
+ category: 'Chat',
isHiddenFromOverview: true,
hidden: false,
diff --git a/packages/core/src/Chat/ChatToolCalls.doc.mjs b/packages/core/src/Chat/ChatToolCalls.doc.mjs
index 38f9d91772..9c649bde02 100644
--- a/packages/core/src/Chat/ChatToolCalls.doc.mjs
+++ b/packages/core/src/Chat/ChatToolCalls.doc.mjs
@@ -6,8 +6,7 @@ export const docs = {
name: 'ChatToolCalls',
displayName: 'Chat Tool Calls',
group: 'Chat',
- category: 'Communications',
- isHiddenFromOverview: true,
+ category: 'Chat',
keywords: ['tool', 'function', 'call', 'invocation', 'llm', 'agent', 'bash', 'edit', 'read', 'search', 'status', 'running', 'error', 'complete', 'diff', 'stats'],
diff --git a/packages/core/src/CheckboxInput/CheckboxInput.doc.mjs b/packages/core/src/CheckboxInput/CheckboxInput.doc.mjs
index 544d9a07df..63599517b5 100644
--- a/packages/core/src/CheckboxInput/CheckboxInput.doc.mjs
+++ b/packages/core/src/CheckboxInput/CheckboxInput.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'CheckboxInput',
displayName: 'Checkbox Input',
group: 'Checkbox',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["checkbox","check","toggle","tick","indeterminate","boolean","tristate"],
props: [
{
diff --git a/packages/core/src/CheckboxList/CheckboxList.doc.mjs b/packages/core/src/CheckboxList/CheckboxList.doc.mjs
index 2f4c035af4..9cde5fc902 100644
--- a/packages/core/src/CheckboxList/CheckboxList.doc.mjs
+++ b/packages/core/src/CheckboxList/CheckboxList.doc.mjs
@@ -6,11 +6,13 @@ export const docs = {
name: 'CheckboxList',
displayName: 'Checkbox List',
group: 'Checkbox',
- category: 'Inputs',
+ category: 'Data Input',
+ isHiddenFromOverview: true,
keywords: ["checkboxlist","checkbox","checkboxgroup","multichoice","multiselect","checklist"],
components: [
{
name: 'XDSCheckboxList',
+ isHiddenFromOverview: true,
displayName: 'Checkbox List',
description:
'Checkbox group container with field integration for label, description, and status.', props: [
@@ -93,6 +95,7 @@ export const docs = {
},
{
name: 'XDSCheckboxListItem',
+ isHiddenFromOverview: true,
displayName: 'Checkbox List Item',
description:
'Individual checkbox item with label, description, and end content slot. Works in collection mode (inside XDSCheckboxList) or standalone mode (inside XDSList).',
@@ -170,6 +173,7 @@ export const docsZh = {
components: [
{
name: 'XDSCheckboxList',
+ isHiddenFromOverview: true,
displayName: 'Checkbox List',
description: '复选框组容器,集成字段功能,支持标签、描述和状态。',
props: [
@@ -190,6 +194,7 @@ export const docsZh = {
},
{
name: 'XDSCheckboxListItem',
+ isHiddenFromOverview: true,
displayName: 'Checkbox List Item',
description: '单个复选框选项,包含标签、描述和尾部内容插槽。可在集合模式或独立模式下使用。',
props: [
@@ -222,6 +227,7 @@ export const docsDense = {
components: [
{
name: 'XDSCheckboxList',
+ isHiddenFromOverview: true,
displayName: 'Checkbox List',
description:
'Checkbox group container w/ field integration for label, description, status.',
@@ -243,6 +249,7 @@ export const docsDense = {
},
{
name: 'XDSCheckboxListItem',
+ isHiddenFromOverview: true,
displayName: 'Checkbox List Item',
description:
'Individual checkbox item w/ label, description, end content slot.',
diff --git a/packages/core/src/Citation/Citation.doc.mjs b/packages/core/src/Citation/Citation.doc.mjs
new file mode 100644
index 0000000000..9a4a2429e6
--- /dev/null
+++ b/packages/core/src/Citation/Citation.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'Citation',
+ displayName: 'Citation',
+ group: 'Citation',
+ category: 'Content',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/core/src/ClickableCard/ClickableCard.doc.mjs b/packages/core/src/ClickableCard/ClickableCard.doc.mjs
index 99fb976787..d1dac41534 100644
--- a/packages/core/src/ClickableCard/ClickableCard.doc.mjs
+++ b/packages/core/src/ClickableCard/ClickableCard.doc.mjs
@@ -5,7 +5,7 @@ export const docs = {
name: 'ClickableCard',
displayName: 'Clickable Card',
group: 'Card',
- category: 'Actions',
+ category: 'Container',
keywords: ['card', 'clickable', 'interactive', 'navigation', 'action', 'link'],
usage: {
description: 'An interactive card for navigation or action targets. Nested interactive elements work independently.',
diff --git a/packages/core/src/CodeBlock/CodeBlock.doc.mjs b/packages/core/src/CodeBlock/CodeBlock.doc.mjs
index 35906fc389..d271f1cf96 100644
--- a/packages/core/src/CodeBlock/CodeBlock.doc.mjs
+++ b/packages/core/src/CodeBlock/CodeBlock.doc.mjs
@@ -4,7 +4,7 @@
export const docs = {
name: 'CodeBlock',
displayName: 'Code Block',
- category: 'Communications',
+ category: 'Content',
keywords: [
'code', 'syntax', 'highlight', 'snippet', 'prism', 'shiki',
'pre', 'monospace', 'codeblock', 'inline',
diff --git a/packages/core/src/Collapsible/Collapsible.doc.mjs b/packages/core/src/Collapsible/Collapsible.doc.mjs
index c68d275f94..8b43329c81 100644
--- a/packages/core/src/Collapsible/Collapsible.doc.mjs
+++ b/packages/core/src/Collapsible/Collapsible.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'Collapsible',
displayName: 'Collapsible',
group: 'Collapsible',
- category: 'Containers',
+ category: 'Container',
keywords: ["accordion","collapse","expandable","disclosure","toggle","panel","foldable","expander","expand"],
playground: {
defaults: {
@@ -63,6 +63,7 @@ export const docs = {
], },
{
name: 'XDSCollapsibleGroup',
+ isHiddenFromOverview: true,
displayName: 'Collapsible Group',
description:
'Coordinates multiple XDSCollapsible instances so only one (single mode) or any number (multiple mode) can be open at a time. Renders no wrapper DOM element.',
@@ -157,6 +158,7 @@ export const docsZh = {
},
{
name: 'XDSCollapsibleGroup',
+ isHiddenFromOverview: true,
displayName: 'Collapsible Group',
description:
'协调多个 XDSCollapsible 实例,使同一时间只有一个(single 模式)或任意数量(multiple 模式)可以展开。不渲染包裹 DOM 元素。',
@@ -200,6 +202,7 @@ export const docsDense = {
},
{
name: 'XDSCollapsibleGroup',
+ isHiddenFromOverview: true,
displayName: 'Collapsible Group',
description: 'coordinates multiple XDSCollapsible instances; single or multiple open. no wrapper DOM.',
propDescriptions: {
diff --git a/packages/core/src/CommandPalette/CommandPalette.doc.mjs b/packages/core/src/CommandPalette/CommandPalette.doc.mjs
index 997953f97a..38744631e6 100644
--- a/packages/core/src/CommandPalette/CommandPalette.doc.mjs
+++ b/packages/core/src/CommandPalette/CommandPalette.doc.mjs
@@ -5,7 +5,7 @@ export const docs = {
name: 'CommandPalette',
displayName: 'Command Palette',
group: 'CommandPalette',
- category: 'Actions',
+ category: 'Overlay',
keywords: [
'command',
'spotlight',
@@ -118,6 +118,7 @@ export const docs = {
},
{
name: 'XDSCommandPaletteInput',
+ isHiddenFromOverview: true,
displayName: 'Command Palette Input',
description:
'Search input slot. Auto-focuses on mount. Wires to command palette context when used inside XDSCommandPalette.',
@@ -166,6 +167,7 @@ export const docs = {
},
{
name: 'XDSCommandPaletteList',
+ isHiddenFromOverview: true,
displayName: 'Command Palette List',
description:
'Scrollable results container. Renders as a listbox for ARIA. Contains XDSCommandPaletteItem and XDSCommandPaletteGroup children.',
@@ -192,6 +194,7 @@ export const docs = {
},
{
name: 'XDSCommandPaletteItem',
+ isHiddenFromOverview: true,
displayName: 'Command Palette Item',
description:
'A selectable item. Accepts arbitrary children for full rendering control. Registers with context for keyboard navigation when inside XDSCommandPalette.',
@@ -243,6 +246,7 @@ export const docs = {
},
{
name: 'XDSCommandPaletteGroup',
+ isHiddenFromOverview: true,
displayName: 'Command Palette Group',
description: 'Visual grouping with a heading label. Place inside XDSCommandPaletteList.',
props: [
@@ -268,6 +272,7 @@ export const docs = {
},
{
name: 'XDSCommandPaletteFooter',
+ isHiddenFromOverview: true,
displayName: 'Command Palette Footer',
description:
'Footer showing keyboard navigation hints. Renders default arrow/Enter/Escape hints when no children are provided.',
@@ -288,6 +293,7 @@ export const docs = {
},
{
name: 'XDSCommandPaletteEmpty',
+ isHiddenFromOverview: true,
displayName: 'Command Palette Empty',
description:
'Empty state display for the results area. Rendered automatically by XDSCommandPalette for no-results and no-query states.',
@@ -356,6 +362,7 @@ export const docsZh = {
},
{
name: 'XDSCommandPaletteInput',
+ isHiddenFromOverview: true,
displayName: 'Command Palette Input',
description: '搜索输入插槽。挂载时自动聚焦。在 XDSCommandPalette 内使用时连接到上下文。',
propDescriptions: {
@@ -369,12 +376,14 @@ export const docsZh = {
},
{
name: 'XDSCommandPaletteList',
+ isHiddenFromOverview: true,
displayName: 'Command Palette List',
description: '可滚动的结果容器。作为 listbox 渲染以符合 ARIA 规范。',
propDescriptions: {children: '条目、分组和空状态。', label: 'listbox 的无障碍标签。', xstyle: 'StyleX 布局自定义样式。必须是 stylex.create() 的值。'},
},
{
name: 'XDSCommandPaletteItem',
+ isHiddenFromOverview: true,
displayName: 'Command Palette Item',
description: '可选择的条目。接受任意子元素以实现完整的渲染控制。',
propDescriptions: {
@@ -389,18 +398,21 @@ export const docsZh = {
},
{
name: 'XDSCommandPaletteGroup',
+ isHiddenFromOverview: true,
displayName: 'Command Palette Group',
description: '带标题标签的视觉分组。放置在 XDSCommandPaletteList 内。',
propDescriptions: {heading: '分组标题文本。', children: 'XDSCommandPaletteItem 子元素。', xstyle: 'StyleX 布局自定义样式。必须是 stylex.create() 的值。'},
},
{
name: 'XDSCommandPaletteFooter',
+ isHiddenFromOverview: true,
displayName: 'Command Palette Footer',
description: '显示键盘导航提示的页脚。未提供子元素时渲染默认方向键/Enter/Escape 提示。',
propDescriptions: {children: '自定义页脚内容。省略时通过 XDSKbd 渲染默认键盘提示。', xstyle: 'StyleX 布局自定义样式。必须是 stylex.create() 的值。'},
},
{
name: 'XDSCommandPaletteEmpty',
+ isHiddenFromOverview: true,
displayName: 'Command Palette Empty',
description: '结果区域的空状态展示。由 XDSCommandPalette 在无结果和无查询状态下自动渲染。',
propDescriptions: {children: '要显示的消息或内容。'},
@@ -445,6 +457,7 @@ export const docsDense = {
},
{
name: 'XDSCommandPaletteInput',
+ isHiddenFromOverview: true,
displayName: 'Command Palette Input',
description: 'search input; auto-focus on mount; wires to context inside XDSCommandPalette',
propDescriptions: {
@@ -458,6 +471,7 @@ export const docsDense = {
},
{
name: 'XDSCommandPaletteList',
+ isHiddenFromOverview: true,
displayName: 'Command Palette List',
description: 'scrollable results container; role=listbox',
propDescriptions: {
@@ -468,6 +482,7 @@ export const docsDense = {
},
{
name: 'XDSCommandPaletteItem',
+ isHiddenFromOverview: true,
displayName: 'Command Palette Item',
description: 'selectable item; arbitrary children; registers w/ context for kbd nav',
propDescriptions: {
@@ -482,6 +497,7 @@ export const docsDense = {
},
{
name: 'XDSCommandPaletteGroup',
+ isHiddenFromOverview: true,
displayName: 'Command Palette Group',
description: 'group w/ heading label; inside XDSCommandPaletteList',
propDescriptions: {
@@ -492,6 +508,7 @@ export const docsDense = {
},
{
name: 'XDSCommandPaletteFooter',
+ isHiddenFromOverview: true,
displayName: 'Command Palette Footer',
description: 'footer w/ kbd hints; default=arrow/Enter/Escape hints via XDSKbd',
propDescriptions: {
@@ -501,6 +518,7 @@ export const docsDense = {
},
{
name: 'XDSCommandPaletteEmpty',
+ isHiddenFromOverview: true,
displayName: 'Command Palette Empty',
description: 'empty state; auto-rendered by palette for no-results+no-query states',
propDescriptions: {
diff --git a/packages/core/src/ContextMenu/ContextMenu.doc.mjs b/packages/core/src/ContextMenu/ContextMenu.doc.mjs
index 4b250daaea..b721c6a904 100644
--- a/packages/core/src/ContextMenu/ContextMenu.doc.mjs
+++ b/packages/core/src/ContextMenu/ContextMenu.doc.mjs
@@ -5,7 +5,8 @@ export const docs = {
name: 'ContextMenu',
displayName: 'Context Menu',
group: 'ContextMenu',
- category: 'Actions',
+ category: 'Action',
+ isHiddenFromOverview: true,
keywords: ["contextmenu","right-click","menu","popover","actions","context"],
theming: {
targets: [
@@ -74,6 +75,7 @@ export const docs = {
},
{
name: 'XDSContextMenuItem',
+ isHiddenFromOverview: true,
displayName: 'Context Menu Item',
description:
'Menu item component for compound mode. Re-exported from XDSDropdownMenuItem for discoverability.',
@@ -189,6 +191,7 @@ export const docsZh = {
},
{
name: 'XDSContextMenuItem',
+ isHiddenFromOverview: true,
displayName: 'Context Menu Item',
description:
'复合模式的菜单项组件。从 XDSDropdownMenuItem 重新导出以便发现。',
@@ -263,6 +266,7 @@ export const docsDense = {
},
{
name: 'XDSContextMenuItem',
+ isHiddenFromOverview: true,
displayName: 'Context Menu Item',
description: 're-exported XDSDropdownMenuItem for compound mode',
propDescriptions: {
diff --git a/packages/core/src/DateInput/DateInput.doc.mjs b/packages/core/src/DateInput/DateInput.doc.mjs
index a939016565..e7a1da8748 100644
--- a/packages/core/src/DateInput/DateInput.doc.mjs
+++ b/packages/core/src/DateInput/DateInput.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'DateInput',
displayName: 'Date Input',
group: 'DateInput',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["dateinput","datepicker","datefield","calendar","dateselect","dateentry","datechooser"],
props: [
{
diff --git a/packages/core/src/DateRangeInput/DateRangeInput.doc.mjs b/packages/core/src/DateRangeInput/DateRangeInput.doc.mjs
index 00cf070a6e..1dc25b5f54 100644
--- a/packages/core/src/DateRangeInput/DateRangeInput.doc.mjs
+++ b/packages/core/src/DateRangeInput/DateRangeInput.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'DateRangeInput',
displayName: 'Date Range Input',
group: 'DateInput',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["daterangepicker","daterange","range","calendar","filter","analytics","period","schedule"],
props: [
{ name: 'label', type: 'string', description: 'Label text.', required: true },
diff --git a/packages/core/src/DateTimeInput/DateTimeInput.doc.mjs b/packages/core/src/DateTimeInput/DateTimeInput.doc.mjs
index 00e3efec14..0398ca4407 100644
--- a/packages/core/src/DateTimeInput/DateTimeInput.doc.mjs
+++ b/packages/core/src/DateTimeInput/DateTimeInput.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'DateTimeInput',
displayName: 'Date Time Input',
group: 'DateInput',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["datetimepicker","datetime","datepicker","timepicker","calendar","schedule","event","deadline","timestamp"],
props: [
{
diff --git a/packages/core/src/Dialog/Dialog.doc.mjs b/packages/core/src/Dialog/Dialog.doc.mjs
index fe61ac0f45..b0f114f274 100644
--- a/packages/core/src/Dialog/Dialog.doc.mjs
+++ b/packages/core/src/Dialog/Dialog.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'Dialog',
displayName: 'Dialog',
group: 'Dialog',
- category: 'Containers',
+ category: 'Overlay',
keywords: ["dialog","modal","popup","overlay","lightbox","alert","confirm","prompt","backdrop","focus trap","imperative"],
playground: {
defaults: {
@@ -101,6 +101,7 @@ export const docs = {
], },
{
name: 'XDSDialogHeader',
+ isHiddenFromOverview: true,
displayName: 'Dialog Header',
description:
'Header for dialogs with a title, optional subtitle, close button, and start/end content slots.',
@@ -255,6 +256,7 @@ export const docsZh = {
},
{
name: 'XDSDialogHeader',
+ isHiddenFromOverview: true,
displayName: 'Dialog Header',
description:
'对话框头部,包含标题、可选副标题、关闭按钮以及首尾内容插槽。',
@@ -346,6 +348,7 @@ export const docsDense = {
},
{
name: 'XDSDialogHeader',
+ isHiddenFromOverview: true,
displayName: 'Dialog Header',
description: 'dialog header w/ title, optional subtitle, close button, start/end content slots',
propDescriptions: {
diff --git a/packages/core/src/DropdownMenu/DropdownMenu.doc.mjs b/packages/core/src/DropdownMenu/DropdownMenu.doc.mjs
index b54494c71d..194bfb31e8 100644
--- a/packages/core/src/DropdownMenu/DropdownMenu.doc.mjs
+++ b/packages/core/src/DropdownMenu/DropdownMenu.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'DropdownMenu',
displayName: 'Dropdown Menu',
group: 'DropdownMenu',
- category: 'Actions',
+ category: 'Action',
keywords: ["dropdown","menu","popover","select","actions","contextmenu","overflow","kebab","menubutton"],
theming: {
targets: [
@@ -84,6 +84,7 @@ export const docs = {
], },
{
name: 'XDSDropdownMenuItem',
+ isHiddenFromOverview: true,
displayName: 'Dropdown Menu Item',
description:
'Helper component for custom item rendering with consistent styling.',
@@ -209,6 +210,7 @@ export const docsZh = {
},
{
name: 'XDSDropdownMenuItem',
+ isHiddenFromOverview: true,
displayName: 'Dropdown Menu Item',
description:
'用于自定义项渲染的辅助组件,提供一致的样式。',
@@ -284,6 +286,7 @@ export const docsDense = {
},
{
name: 'XDSDropdownMenuItem',
+ isHiddenFromOverview: true,
displayName: 'Dropdown Menu Item',
description: 'helper for custom item rendering w/ consistent styling',
propDescriptions: {
diff --git a/packages/core/src/EmptyState/EmptyState.doc.mjs b/packages/core/src/EmptyState/EmptyState.doc.mjs
index d830df1bb6..d65fdc3552 100644
--- a/packages/core/src/EmptyState/EmptyState.doc.mjs
+++ b/packages/core/src/EmptyState/EmptyState.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'EmptyState',
displayName: 'Empty State',
- category: 'Communications',
+ category: 'Content',
keywords: ["emptystate","empty","placeholder","nodata","blank","noresults","illustration","blankslate"],
props: [
{
diff --git a/packages/core/src/Field/Field.doc.mjs b/packages/core/src/Field/Field.doc.mjs
index 19b7fc1bc8..173aea7e23 100644
--- a/packages/core/src/Field/Field.doc.mjs
+++ b/packages/core/src/Field/Field.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'Field',
displayName: 'Field',
group: 'Field',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["field","formfield","formgroup","formcontrol","label","input","required","optional","helpertext","hint"],
playground: {
defaults: {
@@ -144,6 +144,7 @@ export const docs = {
},
{
name: 'XDSFieldLabel',
+ isHiddenFromOverview: true,
displayName: 'Field Label',
description:
'Standalone label component with optional/required indicators and tooltip support.',
@@ -198,6 +199,7 @@ export const docs = {
},
{
name: 'XDSFieldStatus',
+ isHiddenFromOverview: true,
displayName: 'Field Status',
description:
'Status message component for form field validation feedback.',
@@ -385,6 +387,7 @@ export const docsZh = {
},
{
name: 'XDSFieldLabel',
+ isHiddenFromOverview: true,
displayName: 'Field Label',
description:
'独立的标签组件,支持可选/必填指示器和工具提示。',
@@ -439,6 +442,7 @@ export const docsZh = {
},
{
name: 'XDSFieldStatus',
+ isHiddenFromOverview: true,
displayName: 'Field Status',
description:
'用于表单字段验证反馈的状态消息组件。',
@@ -521,6 +525,7 @@ export const docsDense = {
},
{
name: 'XDSFieldLabel',
+ isHiddenFromOverview: true,
displayName: 'Field Label',
description: 'Standalone label w/ optional/required indicators + tooltip support.',
propDescriptions: {
@@ -536,6 +541,7 @@ export const docsDense = {
},
{
name: 'XDSFieldStatus',
+ isHiddenFromOverview: true,
displayName: 'Field Status',
description: 'Status message for form field validation feedback.',
propDescriptions: {
diff --git a/packages/core/src/FileInput/FileInput.doc.mjs b/packages/core/src/FileInput/FileInput.doc.mjs
index d5e84811d9..7100e53c53 100644
--- a/packages/core/src/FileInput/FileInput.doc.mjs
+++ b/packages/core/src/FileInput/FileInput.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'FileInput',
displayName: 'File Input',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["fileinput","file","upload","drag","drop","dropzone","attachment","browse"],
props: [
{
diff --git a/packages/core/src/Grid/Grid.doc.mjs b/packages/core/src/Grid/Grid.doc.mjs
index 53c38cc5dd..ed7ff7794d 100644
--- a/packages/core/src/Grid/Grid.doc.mjs
+++ b/packages/core/src/Grid/Grid.doc.mjs
@@ -95,6 +95,7 @@ export const docs = {
},
{
name: 'XDSGridSpan',
+ isHiddenFromOverview: true,
displayName: 'Grid Span',
description: 'Grid item that spans multiple columns or rows.',
props: [
@@ -198,6 +199,7 @@ export const docsZh = {
},
{
name: 'XDSGridSpan',
+ isHiddenFromOverview: true,
displayName: 'Grid Span',
description: '可跨越多列或多行的网格项。',
props: [
@@ -268,6 +270,7 @@ export const docsDense = {
},
{
name: 'XDSGridSpan',
+ isHiddenFromOverview: true,
displayName: 'Grid Span',
description: 'Grid item spanning multiple columns/rows.',
propDescriptions: {
diff --git a/packages/core/src/HoverCard/HoverCard.doc.mjs b/packages/core/src/HoverCard/HoverCard.doc.mjs
index 3400e7b6e0..78bff55c90 100644
--- a/packages/core/src/HoverCard/HoverCard.doc.mjs
+++ b/packages/core/src/HoverCard/HoverCard.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'HoverCard',
displayName: 'Hover Card',
group: 'HoverCard',
- category: 'Communications',
+ category: 'Overlay',
keywords: ["hovercard","hover card","popover","tooltip","preview card","flyout","overlay","hover popup"],
playground: {
defaults: {
diff --git a/packages/core/src/Icon/Icon.doc.mjs b/packages/core/src/Icon/Icon.doc.mjs
index 685c392fee..aab0baebe4 100644
--- a/packages/core/src/Icon/Icon.doc.mjs
+++ b/packages/core/src/Icon/Icon.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Icon',
displayName: 'Icon',
- category: 'Communications',
+ category: 'Content',
keywords: ["icon","svg","glyph","symbol","pictogram","graphic","vector"],
props: [
{
diff --git a/packages/core/src/IconButton/IconButton.doc.mjs b/packages/core/src/IconButton/IconButton.doc.mjs
index 2b73a7a146..bd76d87591 100644
--- a/packages/core/src/IconButton/IconButton.doc.mjs
+++ b/packages/core/src/IconButton/IconButton.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'IconButton',
displayName: 'Icon Button',
group: 'Button',
- category: 'Actions',
+ category: 'Action',
keywords: ['icon-button', 'icon', 'button', 'toolbar', 'action', 'compact'],
props: [
diff --git a/packages/core/src/InputGroup/InputGroup.doc.mjs b/packages/core/src/InputGroup/InputGroup.doc.mjs
index 01741b39d3..7b3a606de4 100644
--- a/packages/core/src/InputGroup/InputGroup.doc.mjs
+++ b/packages/core/src/InputGroup/InputGroup.doc.mjs
@@ -6,7 +6,8 @@ export const docs = {
name: 'InputGroup',
displayName: 'Input Group',
group: 'Field',
- category: 'Inputs',
+ category: 'Data Input',
+ isHiddenFromOverview: true,
keywords: ["inputgroup","addon","prefix","suffix","connected","grouped","input"],
theming: {
targets: [
@@ -35,6 +36,7 @@ export const docs = {
},
{
name: 'XDSInputGroupText',
+ isHiddenFromOverview: true,
displayName: 'Input Group Text',
description: 'A prefix or suffix text element rendered inside XDSInputGroup. Displays text or icons.',
props: [
@@ -97,6 +99,7 @@ export const docsDense = {
},
{
name: 'XDSInputGroupText',
+ isHiddenFromOverview: true,
displayName: 'Input Group Text',
description: 'prefix/suffix text/icon element',
propDescriptions: {
diff --git a/packages/core/src/Item/Item.doc.mjs b/packages/core/src/Item/Item.doc.mjs
index db4072bc77..6cf3c26617 100644
--- a/packages/core/src/Item/Item.doc.mjs
+++ b/packages/core/src/Item/Item.doc.mjs
@@ -6,7 +6,8 @@ export const docs = {
name: 'Item',
displayName: 'Item',
group: 'Item',
- category: 'Lists',
+ category: 'Table & List',
+ isHiddenFromOverview: true,
keywords: ["item","list-item","media-object","row","cell","entity","contact","notification","preview"],
playground: {
defaults: {
diff --git a/packages/core/src/Kbd/Kbd.doc.mjs b/packages/core/src/Kbd/Kbd.doc.mjs
index cf0bb51de0..11c9805054 100644
--- a/packages/core/src/Kbd/Kbd.doc.mjs
+++ b/packages/core/src/Kbd/Kbd.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Kbd',
displayName: 'Kbd',
- category: 'Communications',
+ category: 'Content',
keywords: ["kbd","keyboard","shortcut","hotkey","keybinding","keystroke","keycombo","modifier","accelerator"],
props: [
{
diff --git a/packages/core/src/Layout/Layout.doc.mjs b/packages/core/src/Layout/Layout.doc.mjs
index 592f79bc58..49be0b70f6 100644
--- a/packages/core/src/Layout/Layout.doc.mjs
+++ b/packages/core/src/Layout/Layout.doc.mjs
@@ -71,6 +71,7 @@ export const docs = {
], },
{
name: 'XDSLayoutHeader',
+ isHiddenFromOverview: true,
displayName: 'Layout Header',
description: 'Top bar for page titles, app bars, and toolbars.',
props: [
@@ -104,6 +105,7 @@ export const docs = {
},
{
name: 'XDSLayoutContent',
+ isHiddenFromOverview: true,
displayName: 'Layout Content',
description: 'Scrollable main content area.',
props: [
@@ -132,6 +134,7 @@ export const docs = {
},
{
name: 'XDSLayoutFooter',
+ isHiddenFromOverview: true,
displayName: 'Layout Footer',
description: 'Bottom bar for action bars, pagination, and status bars.',
props: [
@@ -165,6 +168,7 @@ export const docs = {
},
{
name: 'XDSLayoutPanel',
+ isHiddenFromOverview: true,
displayName: 'Layout Panel',
description: 'Sidebar for navigation, settings, or inspector panels.',
props: [
@@ -199,6 +203,7 @@ export const docs = {
},
{
name: 'XDSLayoutContainer',
+ isHiddenFromOverview: true,
displayName: 'Layout Container',
description:
'Primitive component that sets CSS variables for padding, used as the base for XDSCard and XDSSection.',
@@ -220,18 +225,21 @@ export const docs = {
},
{
name: 'XDSHStack',
+ isHiddenFromOverview: true,
displayName: 'H Stack',
description: 'Horizontal stack that arranges children left-to-right.',
props: [],
},
{
name: 'XDSVStack',
+ isHiddenFromOverview: true,
displayName: 'V Stack',
description: 'Vertical stack that arranges children top-to-bottom.',
props: [],
},
{
name: 'XDSStackItem',
+ isHiddenFromOverview: true,
displayName: 'Stack Item',
description:
'Stack item with fill and alignment control for use inside XDSHStack or XDSVStack.',
@@ -306,6 +314,7 @@ export const docsZh = {
},
{
name: 'XDSLayoutHeader',
+ isHiddenFromOverview: true,
displayName: 'Layout Header',
description: '用于页面标题、应用栏和工具栏的顶部栏。',
props: [
@@ -339,6 +348,7 @@ export const docsZh = {
},
{
name: 'XDSLayoutContent',
+ isHiddenFromOverview: true,
displayName: 'Layout Content',
description: '可滚动的主内容区域。',
props: [
@@ -367,6 +377,7 @@ export const docsZh = {
},
{
name: 'XDSLayoutFooter',
+ isHiddenFromOverview: true,
displayName: 'Layout Footer',
description: '用于操作栏、分页和状态栏的底部栏。',
props: [
@@ -400,6 +411,7 @@ export const docsZh = {
},
{
name: 'XDSLayoutPanel',
+ isHiddenFromOverview: true,
displayName: 'Layout Panel',
description: '用于导航、设置或检查器面板的侧边栏。',
props: [
@@ -434,6 +446,7 @@ export const docsZh = {
},
{
name: 'XDSLayoutContainer',
+ isHiddenFromOverview: true,
displayName: 'Layout Container',
description:
'设置内边距 CSS 变量的基础组件,作为 XDSCard 和 XDSSection 的基础。',
@@ -455,18 +468,21 @@ export const docsZh = {
},
{
name: 'XDSHStack',
+ isHiddenFromOverview: true,
displayName: 'H Stack',
description: '将子元素从左到右排列的水平堆叠。',
props: [],
},
{
name: 'XDSVStack',
+ isHiddenFromOverview: true,
displayName: 'V Stack',
description: '将子元素从上到下排列的垂直堆叠。',
props: [],
},
{
name: 'XDSStackItem',
+ isHiddenFromOverview: true,
displayName: 'Stack Item',
description:
'用于 XDSHStack 或 XDSVStack 内部的堆叠项,支持填充和对齐控制。',
@@ -516,6 +532,7 @@ export const docsDense = {
},
{
name: 'XDSLayoutHeader',
+ isHiddenFromOverview: true,
displayName: 'Layout Header',
description: 'Top bar for page titles, app bars, toolbars.',
propDescriptions: {
@@ -528,6 +545,7 @@ export const docsDense = {
},
{
name: 'XDSLayoutContent',
+ isHiddenFromOverview: true,
displayName: 'Layout Content',
description: 'Scrollable main content area.',
propDescriptions: {
@@ -539,6 +557,7 @@ export const docsDense = {
},
{
name: 'XDSLayoutFooter',
+ isHiddenFromOverview: true,
displayName: 'Layout Footer',
description: 'Bottom bar for action bars, pagination, status bars.',
propDescriptions: {
@@ -551,6 +570,7 @@ export const docsDense = {
},
{
name: 'XDSLayoutPanel',
+ isHiddenFromOverview: true,
displayName: 'Layout Panel',
description: 'Sidebar for navigation, settings, inspector panels.',
propDescriptions: {
@@ -563,6 +583,7 @@ export const docsDense = {
},
{
name: 'XDSLayoutContainer',
+ isHiddenFromOverview: true,
displayName: 'Layout Container',
description:
'Primitive setting CSS padding vars; base for XDSCard + XDSSection.',
@@ -581,16 +602,19 @@ export const docsDense = {
},
{
name: 'XDSHStack',
+ isHiddenFromOverview: true,
displayName: 'H Stack',
description: 'Horizontal stack arranging children left-to-right.',
},
{
name: 'XDSVStack',
+ isHiddenFromOverview: true,
displayName: 'V Stack',
description: 'Vertical stack arranging children top-to-bottom.',
},
{
name: 'XDSStackItem',
+ isHiddenFromOverview: true,
displayName: 'Stack Item',
description:
'Stack item w/ fill + alignment control inside XDSHStack or XDSVStack.',
diff --git a/packages/core/src/Lightbox/Lightbox.doc.mjs b/packages/core/src/Lightbox/Lightbox.doc.mjs
index 8e6d4a2b05..154204ce50 100644
--- a/packages/core/src/Lightbox/Lightbox.doc.mjs
+++ b/packages/core/src/Lightbox/Lightbox.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Lightbox',
displayName: 'Lightbox',
- category: 'Containers',
+ category: 'Overlay',
keywords: ["lightbox","image","video","viewer","gallery","zoom","fullscreen","media","photo","preview"],
props: [
{
diff --git a/packages/core/src/Link/Link.doc.mjs b/packages/core/src/Link/Link.doc.mjs
index 50b19fc516..539700e2da 100644
--- a/packages/core/src/Link/Link.doc.mjs
+++ b/packages/core/src/Link/Link.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Link',
displayName: 'Link',
- category: 'Actions',
+ category: 'Action',
keywords: ["link","anchor","href","hyperlink","navigation","url","external","textlink"],
playground: {
defaults: {
@@ -96,6 +96,7 @@ export const docs = {
], },
{
name: 'XDSLinkProvider',
+ isHiddenFromOverview: true,
displayName: 'Link Provider',
description:
'Provider that sets the default link component for all XDS link-rendering components in the subtree. ' +
@@ -222,6 +223,7 @@ export const docsZh = {
},
{
name: 'XDSLinkProvider',
+ isHiddenFromOverview: true,
displayName: 'Link Provider',
description:
'为子树中所有 XDS 链接组件设置默认链接组件的 Provider。',
@@ -305,6 +307,7 @@ export const docsDense = {
},
{
name: 'XDSLinkProvider',
+ isHiddenFromOverview: true,
displayName: 'Link Provider',
description:
'Provider setting default link component for all XDS links in subtree.',
diff --git a/packages/core/src/Link/LinkProvider.doc.mjs b/packages/core/src/Link/LinkProvider.doc.mjs
index c2d5928320..d23e319d3f 100644
--- a/packages/core/src/Link/LinkProvider.doc.mjs
+++ b/packages/core/src/Link/LinkProvider.doc.mjs
@@ -6,6 +6,7 @@ export const docs = {
name: 'LinkProvider',
displayName: 'Link Provider',
group: 'Utilities',
+ category: 'Utility',
isHiddenFromOverview: true,
keywords: ['link', 'provider', 'router', 'nextjs', 'client-side-routing'],
usage: {
diff --git a/packages/core/src/List/List.doc.mjs b/packages/core/src/List/List.doc.mjs
index 1976c76d0a..f199ababda 100644
--- a/packages/core/src/List/List.doc.mjs
+++ b/packages/core/src/List/List.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'List',
displayName: 'List',
group: 'List',
- category: 'Lists',
+ category: 'Table & List',
keywords: ["list","listitem","listbox","menu","collection","items","ul","navlist"],
theming: {
targets: [
@@ -61,6 +61,7 @@ export const docs = {
},
{
name: 'XDSListItem',
+ isHiddenFromOverview: true,
displayName: 'List Item',
description:
'List item with label, description, start/end content slots, and interactive patterns.',
@@ -206,6 +207,7 @@ export const docsZh = {
},
{
name: 'XDSListItem',
+ isHiddenFromOverview: true,
displayName: 'List Item',
description:
'列表项,包含标签、描述、起始/结束内容插槽和交互模式。',
@@ -329,6 +331,7 @@ export const docsDense = {
},
{
name: 'XDSListItem',
+ isHiddenFromOverview: true,
displayName: 'List Item',
description:
'List item w/ label, description, start/end content slots, interactive patterns.',
diff --git a/packages/core/src/Markdown/Markdown.doc.mjs b/packages/core/src/Markdown/Markdown.doc.mjs
index 744db8bb1f..1c9bcb248f 100644
--- a/packages/core/src/Markdown/Markdown.doc.mjs
+++ b/packages/core/src/Markdown/Markdown.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Markdown',
displayName: 'Markdown',
- category: 'Communications',
+ category: 'Content',
keywords: [
'markdown',
'rich text',
diff --git a/packages/core/src/MetadataList/MetadataList.doc.mjs b/packages/core/src/MetadataList/MetadataList.doc.mjs
index 23826bced9..d6e3589f71 100644
--- a/packages/core/src/MetadataList/MetadataList.doc.mjs
+++ b/packages/core/src/MetadataList/MetadataList.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'MetadataList',
displayName: 'Metadata List',
group: 'MetadataList',
- category: 'Lists',
+ category: 'Table & List',
keywords: ["metadata","description","definition","keyvalue","properties","details","attributes","summary"],
theming: {
targets: [
@@ -71,6 +71,7 @@ export const docs = {
},
{
name: 'XDSMetadataListItem',
+ isHiddenFromOverview: true,
displayName: 'Metadata List Item',
description: 'A single labeled metadata value within an XDSMetadataList.',
props: [
@@ -132,6 +133,7 @@ export const docsZh = {
},
{
name: 'XDSMetadataListItem',
+ isHiddenFromOverview: true,
displayName: 'Metadata List Item',
description: 'XDSMetadataList 中的单个带标签元数据值。',
propDescriptions: {
@@ -195,6 +197,7 @@ export const docsDense = {
},
{
name: 'XDSMetadataListItem',
+ isHiddenFromOverview: true,
displayName: 'Metadata List Item',
description: 'single labeled value in XDSMetadataList',
propDescriptions: {
diff --git a/packages/core/src/MobileNav/MobileNav.doc.mjs b/packages/core/src/MobileNav/MobileNav.doc.mjs
index e924a2d36b..e38704ed9a 100644
--- a/packages/core/src/MobileNav/MobileNav.doc.mjs
+++ b/packages/core/src/MobileNav/MobileNav.doc.mjs
@@ -7,6 +7,7 @@ export const docs = {
displayName: 'Mobile Nav',
group: 'MobileNav',
category: 'Navigation',
+ isHiddenFromOverview: true,
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 92754869b0..ab5fa67339 100644
--- a/packages/core/src/MoreMenu/MoreMenu.doc.mjs
+++ b/packages/core/src/MoreMenu/MoreMenu.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'MoreMenu',
displayName: 'More Menu',
- category: 'Actions',
+ category: 'Action',
keywords: ["moremenu","overflow","kebab","dotmenu","threedot","ellipsis","dropdown","contextmenu","actionmenu"],
props: [
{
diff --git a/packages/core/src/MultiSelector/MultiSelector.doc.mjs b/packages/core/src/MultiSelector/MultiSelector.doc.mjs
index a043937452..34514281e7 100644
--- a/packages/core/src/MultiSelector/MultiSelector.doc.mjs
+++ b/packages/core/src/MultiSelector/MultiSelector.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'MultiSelector',
displayName: 'Multi Selector',
group: 'Selector',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ['multiselect', 'checkbox', 'dropdown', 'multi', 'picker', 'checklist', 'facet', 'filter', 'select'],
theming: {
targets: [
diff --git a/packages/core/src/NumberInput/NumberInput.doc.mjs b/packages/core/src/NumberInput/NumberInput.doc.mjs
index 4bdda2f286..904cfa5324 100644
--- a/packages/core/src/NumberInput/NumberInput.doc.mjs
+++ b/packages/core/src/NumberInput/NumberInput.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'NumberInput',
displayName: 'Number Input',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["numberinput","numberfield","stepper","spinner","counter","increment","decrement","quantity","numberpicker"],
props: [
{
diff --git a/packages/core/src/OverflowList/OverflowList.doc.mjs b/packages/core/src/OverflowList/OverflowList.doc.mjs
index f9e62b9a05..885f6d6517 100644
--- a/packages/core/src/OverflowList/OverflowList.doc.mjs
+++ b/packages/core/src/OverflowList/OverflowList.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'OverflowList',
displayName: 'Overflow List',
- category: 'Lists',
+ category: 'Table & List',
keywords: [
'overflow',
'truncate',
diff --git a/packages/core/src/Overlay/Overlay.doc.mjs b/packages/core/src/Overlay/Overlay.doc.mjs
new file mode 100644
index 0000000000..9e4907e0aa
--- /dev/null
+++ b/packages/core/src/Overlay/Overlay.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'Overlay',
+ displayName: 'Overlay',
+ group: 'Overlay',
+ category: 'Overlay',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/core/src/Popover/Popover.doc.mjs b/packages/core/src/Popover/Popover.doc.mjs
index cb6ca882fc..fc8424c92f 100644
--- a/packages/core/src/Popover/Popover.doc.mjs
+++ b/packages/core/src/Popover/Popover.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'Popover',
displayName: 'Popover',
group: 'Popover',
- category: 'Communications',
+ category: 'Overlay',
keywords: ["popover","popup","dropdown","tooltip","overlay","flyout","callout","popper","anchor","floating","bubble"],
components: [
{
diff --git a/packages/core/src/PowerSearch/PowerSearch.doc.mjs b/packages/core/src/PowerSearch/PowerSearch.doc.mjs
index 4770bbbf20..3766e972af 100644
--- a/packages/core/src/PowerSearch/PowerSearch.doc.mjs
+++ b/packages/core/src/PowerSearch/PowerSearch.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'PowerSearch',
displayName: 'Power Search',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["powersearch","search","searchbar","filter","filterbar","faceted","querybuilder","structured","omnibar"],
props: [
{
diff --git a/packages/core/src/ProgressBar/ProgressBar.doc.mjs b/packages/core/src/ProgressBar/ProgressBar.doc.mjs
index 300b590050..449c9dc229 100644
--- a/packages/core/src/ProgressBar/ProgressBar.doc.mjs
+++ b/packages/core/src/ProgressBar/ProgressBar.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'ProgressBar',
displayName: 'Progress Bar',
- category: 'Performance',
+ category: 'Feedback & Status',
keywords: ["progressbar","progress","loader","loading","linear","determinate","indeterminate","meter"],
props: [
{
diff --git a/packages/core/src/RadioList/RadioList.doc.mjs b/packages/core/src/RadioList/RadioList.doc.mjs
index 8534ee466d..7d2a6e3d78 100644
--- a/packages/core/src/RadioList/RadioList.doc.mjs
+++ b/packages/core/src/RadioList/RadioList.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'RadioList',
displayName: 'Radio List',
group: 'Radio',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["radiolist","radio","radiogroup","radiobutton","optionlist","singlechoice","choicelist"],
theming: {
targets: [
@@ -110,6 +110,7 @@ export const docs = {
},
{
name: 'XDSRadioListItem',
+ isHiddenFromOverview: true,
displayName: 'Radio List Item',
description:
'Individual radio item with label, description, and content slots.',
@@ -280,6 +281,7 @@ export const docsZh = {
},
{
name: 'XDSRadioListItem',
+ isHiddenFromOverview: true,
displayName: 'Radio List Item',
description:
'单个单选选项,包含标签、描述和内容插槽。',
@@ -385,6 +387,7 @@ export const docsDense = {
},
{
name: 'XDSRadioListItem',
+ isHiddenFromOverview: true,
displayName: 'Radio List Item',
description:
'Individual radio item w/ label, description, content slots.',
diff --git a/packages/core/src/Section/Section.doc.mjs b/packages/core/src/Section/Section.doc.mjs
index 88e1485d97..d4c9fd58c6 100644
--- a/packages/core/src/Section/Section.doc.mjs
+++ b/packages/core/src/Section/Section.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'Section',
displayName: 'Section',
group: 'Layout',
- category: 'Containers',
+ category: 'Layout',
keywords: ["section","panel","container","group","fieldset","region","block"],
props: [
{
diff --git a/packages/core/src/SegmentedControl/SegmentedControl.doc.mjs b/packages/core/src/SegmentedControl/SegmentedControl.doc.mjs
index da53e658de..867a3f3d5b 100644
--- a/packages/core/src/SegmentedControl/SegmentedControl.doc.mjs
+++ b/packages/core/src/SegmentedControl/SegmentedControl.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'SegmentedControl',
displayName: 'Segmented Control',
group: 'SegmentedControl',
- category: 'Inputs',
+ category: 'Action',
keywords: ['radio', 'tabs', 'toggle', 'toggle-group', 'pill', 'button-group', 'switch', 'segment', 'control'],
playground: {
defaults: {
@@ -86,6 +86,7 @@ export const docs = {
], },
{
name: 'XDSSegmentedControlItem',
+ isHiddenFromOverview: true,
displayName: 'Segmented Control Item',
description:
'Individual segment item rendering as a radio button within the segmented control.',
@@ -159,6 +160,7 @@ export const docsZh = {
},
{
name: 'XDSSegmentedControlItem',
+ isHiddenFromOverview: true,
displayName: 'Segmented Control Item',
description:
'单个分段项,在分段控件中渲染为单选按钮。',
@@ -223,6 +225,7 @@ export const docsDense = {
},
{
name: 'XDSSegmentedControlItem',
+ isHiddenFromOverview: true,
displayName: 'Segmented Control Item',
description: 'individual segment; renders as radio button in control',
propDescriptions: {
diff --git a/packages/core/src/SelectableCard/SelectableCard.doc.mjs b/packages/core/src/SelectableCard/SelectableCard.doc.mjs
index b0b25c826c..503e888ebe 100644
--- a/packages/core/src/SelectableCard/SelectableCard.doc.mjs
+++ b/packages/core/src/SelectableCard/SelectableCard.doc.mjs
@@ -5,7 +5,7 @@ export const docs = {
name: 'SelectableCard',
displayName: 'Selectable Card',
group: 'Card',
- category: 'Actions',
+ category: 'Container',
keywords: ['card', 'selectable', 'toggle', 'checkbox', 'radio', 'selection'],
usage: {
description: 'A card that toggles between selected and unselected states with an accent border. For navigation use ClickableCard.',
diff --git a/packages/core/src/Selector/Selector.doc.mjs b/packages/core/src/Selector/Selector.doc.mjs
index bc1f3a05a1..5f55f032c8 100644
--- a/packages/core/src/Selector/Selector.doc.mjs
+++ b/packages/core/src/Selector/Selector.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'Selector',
displayName: 'Selector',
group: 'Selector',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["selector","select","dropdown","combobox","picker","listbox","chooser","autocomplete","option","selectmenu"],
theming: {
targets: [
@@ -119,6 +119,7 @@ export const docs = {
},
{
name: 'XDSSelectorOption',
+ isHiddenFromOverview: true,
displayName: 'Selector Option',
description:
'Helper component for custom item rendering inside an XDSSelector children render prop.',
@@ -280,6 +281,7 @@ export const docsZh = {
},
{
name: 'XDSSelectorOption',
+ isHiddenFromOverview: true,
displayName: 'Selector Option',
description:
'用于在 XDSSelector 的 children 渲染函数中自定义选项渲染的辅助组件。',
@@ -378,6 +380,7 @@ export const docsDense = {
},
{
name: 'XDSSelectorOption',
+ isHiddenFromOverview: true,
displayName: 'Selector Option',
description:
'Helper component for custom item rendering inside XDSSelector children render prop.',
diff --git a/packages/core/src/SideNav/SideNav.doc.mjs b/packages/core/src/SideNav/SideNav.doc.mjs
index c345dd257c..feebdd2b34 100644
--- a/packages/core/src/SideNav/SideNav.doc.mjs
+++ b/packages/core/src/SideNav/SideNav.doc.mjs
@@ -84,6 +84,7 @@ export const docs = {
], },
{
name: 'XDSSideNavHeading',
+ isHiddenFromOverview: true,
displayName: 'Side Nav Heading',
description:
'Product/suite/account heading with smart interaction boundary logic for links and a menu popover.',
@@ -141,6 +142,7 @@ export const docs = {
},
{
name: 'XDSSideNavItem',
+ isHiddenFromOverview: true,
displayName: 'Side Nav Item',
description:
'Navigation item with icon, selected state, optional end content, and nesting support via children.',
@@ -214,6 +216,7 @@ export const docs = {
},
{
name: 'XDSSideNavSection',
+ isHiddenFromOverview: true,
displayName: 'Side Nav Section',
description:
'Section grouping with an optional title, subtitle, and end content.',
@@ -261,6 +264,7 @@ export const docs = {
},
{
name: 'XDSSideNavCollapseButton',
+ isHiddenFromOverview: true,
displayName: 'Side Nav Collapse Button',
description:
'Toggle button for sidenav collapse. Place inside XDSSideNav (reads context automatically) or outside (pass handleRef). Renders as an icon-only ghost button by default.',
@@ -370,6 +374,7 @@ export const docsZh = {
},
{
name: 'XDSSideNavHeading',
+ isHiddenFromOverview: true,
displayName: 'Side Nav Heading',
description:
'产品/套件/账户头部,具有智能交互边界逻辑,支持链接和菜单弹出框。',
@@ -424,6 +429,7 @@ export const docsZh = {
},
{
name: 'XDSSideNavItem',
+ isHiddenFromOverview: true,
displayName: 'Side Nav Item',
description:
'导航项,支持图标、选中状态、可选尾部内容,以及通过 children 实现嵌套。',
@@ -492,6 +498,7 @@ export const docsZh = {
},
{
name: 'XDSSideNavSection',
+ isHiddenFromOverview: true,
displayName: 'Side Nav Section',
description:
'分组,支持可选的标题、副标题和尾部内容。',
@@ -528,6 +535,7 @@ export const docsZh = {
},
{
name: 'XDSSideNavCollapseButton',
+ isHiddenFromOverview: true,
displayName: 'Side Nav Collapse Button',
description:
'侧边栏折叠切换按钮。放置在 XDSSideNav 内部(自动读取上下文)或外部(传入 handleRef)。默认渲染为仅图标的 ghost 按钮。',
@@ -606,6 +614,7 @@ export const docsDense = {
},
{
name: 'XDSSideNavHeading',
+ isHiddenFromOverview: true,
displayName: 'Side Nav Heading',
description:
'Product/suite/account heading w/ smart interaction boundary logic for links + menu popover.',
@@ -623,6 +632,7 @@ export const docsDense = {
},
{
name: 'XDSSideNavItem',
+ isHiddenFromOverview: true,
displayName: 'Side Nav Item',
description:
'Navigation item w/ icon, selected state, optional end content, nesting via children.',
@@ -642,6 +652,7 @@ export const docsDense = {
},
{
name: 'XDSSideNavSection',
+ isHiddenFromOverview: true,
displayName: 'Side Nav Section',
description:
'Section grouping w/ optional title, subtitle, end content.',
@@ -656,6 +667,7 @@ export const docsDense = {
},
{
name: 'XDSSideNavCollapseButton',
+ isHiddenFromOverview: true,
displayName: 'Side Nav Collapse Button',
description:
'Toggle button for sidenav collapse. Place inside XDSSideNav (reads context) or outside (pass handleRef). Icon-only ghost button by default.',
diff --git a/packages/core/src/Skeleton/Skeleton.doc.mjs b/packages/core/src/Skeleton/Skeleton.doc.mjs
index 31b6f68eef..e454a2483e 100644
--- a/packages/core/src/Skeleton/Skeleton.doc.mjs
+++ b/packages/core/src/Skeleton/Skeleton.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Skeleton',
displayName: 'Skeleton',
- category: 'Performance',
+ category: 'Feedback & Status',
keywords: ["skeleton","placeholder","loading","shimmer","pulse","loader","bone","ghost","preloader"],
props: [
{
diff --git a/packages/core/src/Slider/Slider.doc.mjs b/packages/core/src/Slider/Slider.doc.mjs
index 13860f07fc..41c7127db4 100644
--- a/packages/core/src/Slider/Slider.doc.mjs
+++ b/packages/core/src/Slider/Slider.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Slider',
displayName: 'Slider',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["slider","range","slidebar","trackbar","scrubber","knob","thumb","rangeslider"],
playground: {
defaults: {
diff --git a/packages/core/src/Spinner/Spinner.doc.mjs b/packages/core/src/Spinner/Spinner.doc.mjs
index 6956ca187c..c6cff6c5a7 100644
--- a/packages/core/src/Spinner/Spinner.doc.mjs
+++ b/packages/core/src/Spinner/Spinner.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Spinner',
displayName: 'Spinner',
- category: 'Performance',
+ category: 'Feedback & Status',
keywords: ["spinner","loader","loading","circular","progress","spin","activity","busy","indeterminate"],
props: [
{
diff --git a/packages/core/src/Stack/Stack.doc.mjs b/packages/core/src/Stack/Stack.doc.mjs
index 9d388994bb..cd226ded5d 100644
--- a/packages/core/src/Stack/Stack.doc.mjs
+++ b/packages/core/src/Stack/Stack.doc.mjs
@@ -17,6 +17,7 @@ export const docs = {
components: [
{
name: 'XDSHStack',
+ isHiddenFromOverview: true,
displayName: 'XDSH Stack',
description:
'Horizontal stack for arranging items left-to-right. Supports polymorphic rendering.',
@@ -84,6 +85,7 @@ export const docs = {
], },
{
name: 'XDSVStack',
+ isHiddenFromOverview: true,
displayName: 'XDSV Stack',
description:
'Vertical stack for arranging items top-to-bottom. Supports polymorphic rendering.',
@@ -146,6 +148,7 @@ export const docs = {
},
{
name: 'XDSStackItem',
+ isHiddenFromOverview: true,
displayName: 'Stack Item',
description:
'Stack item for controlling individual item behavior within a stack. Supports polymorphic rendering.',
@@ -202,6 +205,7 @@ export const docsZh = {
components: [
{
name: 'XDSHStack',
+ isHiddenFromOverview: true,
displayName: 'XDSH Stack',
description:
'水平堆叠组件,将元素从左到右排列。支持多态渲染。',
@@ -270,6 +274,7 @@ export const docsZh = {
},
{
name: 'XDSVStack',
+ isHiddenFromOverview: true,
displayName: 'XDSV Stack',
description:
'垂直堆叠组件,将元素从上到下排列。支持多态渲染。',
@@ -332,6 +337,7 @@ export const docsZh = {
},
{
name: 'XDSStackItem',
+ isHiddenFromOverview: true,
displayName: 'Stack Item',
description:
'堆叠子元素,用于控制堆叠中单个元素的行为。支持多态渲染。',
@@ -389,6 +395,7 @@ export const docsDense = {
components: [
{
name: 'XDSHStack',
+ isHiddenFromOverview: true,
displayName: 'XDSH Stack',
description: 'Horizontal stack; left-to-right, polymorphic rendering.',
propDescriptions: {
@@ -407,6 +414,7 @@ export const docsDense = {
},
{
name: 'XDSVStack',
+ isHiddenFromOverview: true,
displayName: 'XDSV Stack',
description: 'Vertical stack; top-to-bottom, polymorphic rendering.',
propDescriptions: {
@@ -424,6 +432,7 @@ export const docsDense = {
},
{
name: 'XDSStackItem',
+ isHiddenFromOverview: true,
displayName: 'Stack Item',
description: 'Controls individual item behavior in stack; polymorphic rendering.',
propDescriptions: {
diff --git a/packages/core/src/StatusDot/StatusDot.doc.mjs b/packages/core/src/StatusDot/StatusDot.doc.mjs
index a28114f85d..300de85099 100644
--- a/packages/core/src/StatusDot/StatusDot.doc.mjs
+++ b/packages/core/src/StatusDot/StatusDot.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'StatusDot',
displayName: 'Status Dot',
- category: 'Communications',
+ category: 'Feedback & Status',
keywords: ["statusdot","dot","indicator","status","signal","presence","availability","online","pip"],
props: [
{
diff --git a/packages/core/src/Switch/Switch.doc.mjs b/packages/core/src/Switch/Switch.doc.mjs
index 000babaad5..8b7a583e2b 100644
--- a/packages/core/src/Switch/Switch.doc.mjs
+++ b/packages/core/src/Switch/Switch.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Switch',
displayName: 'Switch',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["switch","toggle","onoff","flipswitch","boolean","toggleswitch"],
props: [
{
diff --git a/packages/core/src/TabList/TabList.doc.mjs b/packages/core/src/TabList/TabList.doc.mjs
index b752fd984a..794ad2c3b9 100644
--- a/packages/core/src/TabList/TabList.doc.mjs
+++ b/packages/core/src/TabList/TabList.doc.mjs
@@ -71,6 +71,7 @@ export const docs = {
], },
{
name: 'XDSTab',
+ isHiddenFromOverview: true,
displayName: 'Tab',
description:
'Individual tab item that renders as a button or an anchor link, with selected-state styling and optional icons.',
@@ -133,6 +134,7 @@ export const docs = {
},
{
name: 'XDSTabMenu',
+ isHiddenFromOverview: true,
displayName: 'Tab Menu',
description:
"Overflow menu trigger that opens a dropdown of additional tab options, showing the selected option's label as the trigger text.",
@@ -235,6 +237,7 @@ export const docsZh = {
},
{
name: 'XDSTab',
+ isHiddenFromOverview: true,
displayName: 'Tab',
description:
'单个标签项,渲染为按钮或锚点链接,具有选中状态样式和可选图标。',
@@ -291,6 +294,7 @@ export const docsZh = {
},
{
name: 'XDSTabMenu',
+ isHiddenFromOverview: true,
displayName: 'Tab Menu',
description:
'溢出菜单触发器,打开包含额外标签选项的下拉菜单,将选中选项的标签显示为触发器文本。',
@@ -366,6 +370,7 @@ export const docsDense = {
},
{
name: 'XDSTab',
+ isHiddenFromOverview: true,
displayName: 'Tab',
description: 'Individual tab; renders as button or anchor w/ selected-state styling + optional icons.',
propDescriptions: {
@@ -381,6 +386,7 @@ export const docsDense = {
},
{
name: 'XDSTabMenu',
+ isHiddenFromOverview: true,
displayName: 'Tab Menu',
description: "Overflow menu trigger; dropdown of extra tab options, shows selected option's label as trigger text.",
propDescriptions: {
diff --git a/packages/core/src/Table/Table.doc.mjs b/packages/core/src/Table/Table.doc.mjs
index 63349654e9..a87d641654 100644
--- a/packages/core/src/Table/Table.doc.mjs
+++ b/packages/core/src/Table/Table.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'Table',
displayName: 'Table',
group: 'Table',
- category: 'Lists',
+ category: 'Table & List',
keywords: ["table","datatable","datagrid","spreadsheet","sorting","virtualized","columns","rows","selection","pinning"],
playground: {
defaults: {
@@ -100,6 +100,7 @@ export const docs = {
], },
{
name: 'XDSBaseTable',
+ isHiddenFromOverview: true,
displayName: 'Base Table',
description:
'Unstyled structural table component with a plugin transform pipeline and a components prop for swapping in custom row/cell renderers.',
@@ -149,6 +150,7 @@ export const docs = {
},
{
name: 'XDSTableRow',
+ isHiddenFromOverview: true,
displayName: 'Table Row',
description:
'<tr> wrapper that reads XDSTableContext to apply striped, hover, and divider styles when used inside XDSTable.',
@@ -163,6 +165,7 @@ export const docs = {
},
{
name: 'XDSTableCell',
+ isHiddenFromOverview: true,
displayName: 'Table Cell',
description:
'<td> wrapper that reads XDSTableContext to apply density padding, font size, and divider borders when used inside XDSTable.',
@@ -176,6 +179,7 @@ export const docs = {
},
{
name: 'XDSTableHeaderCell',
+ isHiddenFromOverview: true,
displayName: 'Table Header Cell',
description:
'<th> wrapper that reads XDSTableContext to apply density padding, semibold weight, secondary text color, and divider borders when used inside XDSTable.',
@@ -435,6 +439,51 @@ export const docs = {
},
],
},
+ {
+ name: 'useXDSTableFiltering',
+ isHiddenFromOverview: true,
+ displayName: 'useXDSTableFiltering',
+ description:
+ 'Table plugin that adds inline column filters with popover or inline controls. Pairs with useXDSTableFilterState for managed state. Supports text, select, multi-select, date, and number filter types via PowerSearch field definitions.',
+ props: [
+ {
+ name: 'filters',
+ type: 'XDSTableFilterState',
+ description:
+ 'Current filter state — map from column key to filter value.',
+ required: true,
+ },
+ {
+ name: 'onFilterChange',
+ type: '(columnKey: string, value: XDSTableFilterValue | null) => void',
+ description:
+ 'Called when the user changes a filter value. null clears the filter.',
+ required: true,
+ },
+ {
+ name: 'variant',
+ type: "'popover' | 'inline'",
+ description:
+ 'Display variant for filter controls.',
+ default: "'popover'",
+ },
+ ],
+ },
+ {
+ name: 'useXDSTableFilterState',
+ isHiddenFromOverview: true,
+ displayName: 'useXDSTableFilterState',
+ description:
+ 'Managed state hook for table filtering. Returns the current filter map and an onChange handler. Pass the result directly to useXDSTableFiltering.',
+ props: [
+ {
+ name: 'initialState',
+ type: 'XDSTableFilterState',
+ description:
+ 'Optional initial filter state map.',
+ },
+ ],
+ },
],
usage: {
description:
@@ -542,6 +591,7 @@ export const docsZh = {
},
{
name: 'XDSBaseTable',
+ isHiddenFromOverview: true,
displayName: 'Base Table',
description:
'无样式的结构表格组件,配有插件转换管道和 components 属性,用于替换自定义行/单元格渲染器。',
@@ -591,6 +641,7 @@ export const docsZh = {
},
{
name: 'XDSTableRow',
+ isHiddenFromOverview: true,
displayName: 'Table Row',
description:
'<tr> 包装器,读取 XDSTableContext 以在 XDSTable 内部使用时应用条纹、悬停和分隔线样式。',
@@ -605,6 +656,7 @@ export const docsZh = {
},
{
name: 'XDSTableCell',
+ isHiddenFromOverview: true,
displayName: 'Table Cell',
description:
'<td> 包装器,读取 XDSTableContext 以在 XDSTable 内部使用时应用密度内边距、字体大小和分隔线边框。',
@@ -618,6 +670,7 @@ export const docsZh = {
},
{
name: 'XDSTableHeaderCell',
+ isHiddenFromOverview: true,
displayName: 'Table Header Cell',
description:
'<th> 包装器,读取 XDSTableContext 以在 XDSTable 内部使用时应用密度内边距、半粗字重、次要文本颜色和分隔线边框。',
@@ -791,6 +844,47 @@ export const docsZh = {
},
],
},
+ {
+ name: 'useXDSTableFiltering',
+ isHiddenFromOverview: true,
+ displayName: 'useXDSTableFiltering',
+ description:
+ '表格筛选插件,添加内联列过滤器(弹出式或内联控件)。与 useXDSTableFilterState 配合使用管理状态。',
+ props: [
+ {
+ name: 'filters',
+ type: 'XDSTableFilterState',
+ description: '当前筛选状态——列键到筛选值的映射。',
+ required: true,
+ },
+ {
+ name: 'onFilterChange',
+ type: '(columnKey: string, value: XDSTableFilterValue | null) => void',
+ description: '用户更改筛选值时调用。null 清除筛选。',
+ required: true,
+ },
+ {
+ name: 'variant',
+ type: "'popover' | 'inline'",
+ description: '筛选控件的显示变体。',
+ default: "'popover'",
+ },
+ ],
+ },
+ {
+ name: 'useXDSTableFilterState',
+ isHiddenFromOverview: true,
+ displayName: 'useXDSTableFilterState',
+ description:
+ '表格筛选的受管状态 hook。返回当前筛选映射和 onChange 处理程序。将结果直接传递给 useXDSTableFiltering。',
+ props: [
+ {
+ name: 'initialState',
+ type: 'XDSTableFilterState',
+ description: '可选的初始筛选状态映射。',
+ },
+ ],
+ },
],
usage: {
description:
@@ -853,6 +947,7 @@ export const docsDense = {
},
{
name: 'XDSBaseTable',
+ isHiddenFromOverview: true,
displayName: 'Base Table',
description: 'Unstyled structural table w/ plugin transform pipeline + components prop for custom row/cell renderers.',
propDescriptions: {
@@ -867,6 +962,7 @@ export const docsDense = {
},
{
name: 'XDSTableRow',
+ isHiddenFromOverview: true,
displayName: 'Table Row',
description: '<tr> wrapper; reads XDSTableContext for striped/hover/divider styles.',
propDescriptions: {
@@ -875,6 +971,7 @@ export const docsDense = {
},
{
name: 'XDSTableCell',
+ isHiddenFromOverview: true,
displayName: 'Table Cell',
description: '<td> wrapper; reads XDSTableContext for density padding, font size, divider borders.',
propDescriptions: {
@@ -883,6 +980,7 @@ export const docsDense = {
},
{
name: 'XDSTableHeaderCell',
+ isHiddenFromOverview: true,
displayName: 'Table Header Cell',
description: '<th> wrapper; reads XDSTableContext for density padding, semibold weight, secondary color, dividers.',
propDescriptions: {
@@ -938,5 +1036,25 @@ export const docsDense = {
defaultColumnKeys: 'Default column set for reset. Omit = show all.',
},
},
+ {
+ name: 'useXDSTableFiltering',
+ isHiddenFromOverview: true,
+ displayName: 'useXDSTableFiltering',
+ description: 'Table filtering plugin — inline column filters (popover/inline). Pairs w/ useXDSTableFilterState.',
+ propDescriptions: {
+ filters: 'Current filter state map (columnKey → value).',
+ onFilterChange: 'Called on filter change. null clears.',
+ variant: 'Filter control display variant.',
+ },
+ },
+ {
+ name: 'useXDSTableFilterState',
+ isHiddenFromOverview: true,
+ displayName: 'useXDSTableFilterState',
+ description: 'Managed filter state hook. Returns filter map + onChange handler for useXDSTableFiltering.',
+ propDescriptions: {
+ initialState: 'Optional initial filter state map.',
+ },
+ },
],
};
\ No newline at end of file
diff --git a/packages/core/src/Text/Text.doc.mjs b/packages/core/src/Text/Text.doc.mjs
index 264b361ab7..51333f75c9 100644
--- a/packages/core/src/Text/Text.doc.mjs
+++ b/packages/core/src/Text/Text.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Text',
displayName: 'Text',
- category: 'Communications',
+ category: 'Content',
keywords: ["text","typography","label","paragraph","heading","caption","font","body","subtitle"],
playground: {
defaults: {
diff --git a/packages/core/src/TextArea/TextArea.doc.mjs b/packages/core/src/TextArea/TextArea.doc.mjs
index fd856d65b7..a7accab5c5 100644
--- a/packages/core/src/TextArea/TextArea.doc.mjs
+++ b/packages/core/src/TextArea/TextArea.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'TextArea',
displayName: 'Text Area',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["textarea","textfield","multiline","comment","message","autoresize","autosize","charlimit"],
props: [
{
diff --git a/packages/core/src/TextInput/TextInput.doc.mjs b/packages/core/src/TextInput/TextInput.doc.mjs
index ae318bc637..1add8afc9f 100644
--- a/packages/core/src/TextInput/TextInput.doc.mjs
+++ b/packages/core/src/TextInput/TextInput.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'TextInput',
displayName: 'Text Input',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["textinput","textfield","input","search","clearable","prefix","suffix","adornment","validation"],
props: [
{
diff --git a/packages/core/src/Thumbnail/Thumbnail.doc.mjs b/packages/core/src/Thumbnail/Thumbnail.doc.mjs
index e79a04bc3c..eb334b58fa 100644
--- a/packages/core/src/Thumbnail/Thumbnail.doc.mjs
+++ b/packages/core/src/Thumbnail/Thumbnail.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Thumbnail',
displayName: 'Thumbnail',
- category: 'Communications',
+ category: 'Content',
keywords: ["thumbnail","attachment","preview","image","upload","dismiss","remove","loading"],
props: [
{
diff --git a/packages/core/src/TimeInput/TimeInput.doc.mjs b/packages/core/src/TimeInput/TimeInput.doc.mjs
index 83647de810..f239843041 100644
--- a/packages/core/src/TimeInput/TimeInput.doc.mjs
+++ b/packages/core/src/TimeInput/TimeInput.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'TimeInput',
displayName: 'Time Input',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["timeinput","timepicker","time","clock","hour","minute","ampm","timeselect","timefield","schedule"],
usage: {
diff --git a/packages/core/src/Timestamp/Timestamp.doc.mjs b/packages/core/src/Timestamp/Timestamp.doc.mjs
index 79bb421ed2..20d426043f 100644
--- a/packages/core/src/Timestamp/Timestamp.doc.mjs
+++ b/packages/core/src/Timestamp/Timestamp.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Timestamp',
displayName: 'Timestamp',
- category: 'Communications',
+ category: 'Content',
keywords: ['date', 'time', 'datetime', 'relative', 'ago', 'clock', 'format', 'duration'],
props: [
{
diff --git a/packages/core/src/Toast/Toast.doc.mjs b/packages/core/src/Toast/Toast.doc.mjs
index 5d2968661f..81467e220e 100644
--- a/packages/core/src/Toast/Toast.doc.mjs
+++ b/packages/core/src/Toast/Toast.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'Toast',
displayName: 'Toast',
group: 'Toast',
- category: 'Communications',
+ category: 'Overlay',
hiddenComponents: ['ToastViewport'],
keywords: ["toast","notification","snackbar","alert","message","feedback","status"],
diff --git a/packages/core/src/ToggleButton/ToggleButton.doc.mjs b/packages/core/src/ToggleButton/ToggleButton.doc.mjs
index cf84032bc9..97e5f87c17 100644
--- a/packages/core/src/ToggleButton/ToggleButton.doc.mjs
+++ b/packages/core/src/ToggleButton/ToggleButton.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'ToggleButton',
displayName: 'Toggle Button',
group: 'Button',
- category: 'Actions',
+ category: 'Action',
keywords: ["toggle","togglebutton","pressed","toolbar","formatting","segmented","button-group","exclusive","multi-select"],
playground: {
defaults: {
diff --git a/packages/core/src/Token/Token.doc.mjs b/packages/core/src/Token/Token.doc.mjs
index a194fe7baf..041088a8de 100644
--- a/packages/core/src/Token/Token.doc.mjs
+++ b/packages/core/src/Token/Token.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Token',
displayName: 'Token',
- category: 'Communications',
+ category: 'Content',
keywords: ["token","chip","tag","pill","label","removable","dismissible","filter chip","closable"],
props: [
{
diff --git a/packages/core/src/Tokenizer/Tokenizer.doc.mjs b/packages/core/src/Tokenizer/Tokenizer.doc.mjs
index 7d5f6faa9f..43ba90bab0 100644
--- a/packages/core/src/Tokenizer/Tokenizer.doc.mjs
+++ b/packages/core/src/Tokenizer/Tokenizer.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Tokenizer',
displayName: 'Tokenizer',
- category: 'Communications',
+ category: 'Data Input',
keywords: ["tokenizer","multiselect","multi-select","chips","tags","combobox","autocomplete","taginput","chipinput"],
props: [
{
diff --git a/packages/core/src/Toolbar/Toolbar.doc.mjs b/packages/core/src/Toolbar/Toolbar.doc.mjs
index 9e4d91680f..92d70e5a5d 100644
--- a/packages/core/src/Toolbar/Toolbar.doc.mjs
+++ b/packages/core/src/Toolbar/Toolbar.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'Toolbar',
displayName: 'Toolbar',
- category: 'Navigation',
+ category: 'Action',
keywords: ['toolbar', 'nav', 'bar', 'actions', 'buttonbar', 'header', 'footer', 'action-bar', 'control-bar'],
theming: {
targets: [
diff --git a/packages/core/src/Tooltip/Tooltip.doc.mjs b/packages/core/src/Tooltip/Tooltip.doc.mjs
index ed6d5007d9..c1387198a8 100644
--- a/packages/core/src/Tooltip/Tooltip.doc.mjs
+++ b/packages/core/src/Tooltip/Tooltip.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'Tooltip',
displayName: 'Tooltip',
group: 'Tooltip',
- category: 'Communications',
+ category: 'Overlay',
playground: {
defaults: {
content: 'Helpful tooltip text',
diff --git a/packages/core/src/TopNav/TopNav.doc.mjs b/packages/core/src/TopNav/TopNav.doc.mjs
index c54ac76256..587aedca78 100644
--- a/packages/core/src/TopNav/TopNav.doc.mjs
+++ b/packages/core/src/TopNav/TopNav.doc.mjs
@@ -84,6 +84,7 @@ export const docs = {
], },
{
name: 'XDSTopNavHeading',
+ isHiddenFromOverview: true,
displayName: 'Top Nav Heading',
description:
'Product/suite/account heading for the XDSTopNav heading slot. Supports smart interaction boundary logic: logo, heading text, superheading/subheading with independent links, and an optional menu popover with automatic chevron indicator.',
@@ -166,6 +167,7 @@ export const docs = {
},
{
name: 'XDSTopNavItem',
+ isHiddenFromOverview: true,
displayName: 'Top Nav Item',
description:
'Navigation link item for use in XDSTopNav startContent — renders as an anchor with hover and selected states.',
@@ -306,6 +308,7 @@ export const docs = {
},
{
name: 'XDSTopNavMegaMenuItem',
+ isHiddenFromOverview: true,
displayName: 'Top Nav Mega Menu Item',
description:
'An individual item inside an XDSTopNavMegaMenu. Renders itself in both desktop (popover grid) and mobile drawer modes via render mode context.',
@@ -475,6 +478,7 @@ export const docsZh = {
},
{
name: 'XDSTopNavHeading',
+ isHiddenFromOverview: true,
displayName: 'Top Nav Heading',
description:
'XDSTopNav 标题插槽的产品/套件/账户标题组件。支持智能交互边界逻辑:标志、标题文本、独立链接的上标题/下标题,以及带自动箭头指示器的可选菜单弹出层。',
@@ -554,6 +558,7 @@ export const docsZh = {
},
{
name: 'XDSTopNavItem',
+ isHiddenFromOverview: true,
displayName: 'Top Nav Item',
description:
'用于 XDSTopNav startContent 的导航链接项 — 渲染为具有悬停和选中状态的锚点。',
@@ -684,6 +689,7 @@ export const docsZh = {
},
{
name: 'XDSTopNavMegaMenuItem',
+ isHiddenFromOverview: true,
displayName: 'Top Nav Mega Menu Item',
description:
'超级菜单中的单个项目。在桌面端(弹出层网格)和移动抽屉模式中都会自行渲染。',
@@ -821,6 +827,7 @@ export const docsDense = {
},
{
name: 'XDSTopNavHeading',
+ isHiddenFromOverview: true,
displayName: 'Top Nav Heading',
description: 'Product/suite heading for XDSTopNav; logo+heading text w/ smart interaction boundaries, optional menu popover, superheading/subheading w/ independent links.',
propDescriptions: {
@@ -840,6 +847,7 @@ export const docsDense = {
},
{
name: 'XDSTopNavItem',
+ isHiddenFromOverview: true,
displayName: 'Top Nav Item',
description: 'Nav link for XDSTopNav startContent; renders as anchor w/ hover+selected states.',
propDescriptions: {
@@ -878,6 +886,7 @@ export const docsDense = {
},
{
name: 'XDSTopNavMegaMenuItem',
+ isHiddenFromOverview: true,
displayName: 'Top Nav Mega Menu Item',
description: 'Individual mega menu item. Renders in desktop popover grid + mobile drawer modes via context.',
propDescriptions: {
diff --git a/packages/core/src/TreeList/TreeList.doc.mjs b/packages/core/src/TreeList/TreeList.doc.mjs
index 537f79fae0..48486f2335 100644
--- a/packages/core/src/TreeList/TreeList.doc.mjs
+++ b/packages/core/src/TreeList/TreeList.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'TreeList',
displayName: 'Tree List',
group: 'TreeList',
- category: 'Lists',
+ category: 'Table & List',
keywords: ['tree', 'hierarchy', 'nested', 'accordion', 'folder', 'expand', 'collapse', 'treeview', 'outline'],
playground: {
defaults: {
diff --git a/packages/core/src/Typeahead/Typeahead.doc.mjs b/packages/core/src/Typeahead/Typeahead.doc.mjs
index fd014c3867..53dde8c85d 100644
--- a/packages/core/src/Typeahead/Typeahead.doc.mjs
+++ b/packages/core/src/Typeahead/Typeahead.doc.mjs
@@ -6,7 +6,7 @@ export const docs = {
name: 'Typeahead',
displayName: 'Typeahead',
group: 'Typeahead',
- category: 'Inputs',
+ category: 'Data Input',
keywords: ["typeahead","autocomplete","combobox","searchbox","autosuggest","select","dropdown","lookup","searchable","suggestion","picker"],
components: [
{
@@ -154,6 +154,7 @@ export const docs = {
], },
{
name: 'XDSBaseTypeahead',
+ isHiddenFromOverview: true,
displayName: 'Base Typeahead',
description:
'Unstyled combobox engine providing input, search, keyboard navigation, and dropdown. No wrapper div, no border styling, no token rendering. Used by XDSTypeahead and XDSTokenizer for custom compositions.',
@@ -472,6 +473,7 @@ export const docsZh = {
},
{
name: 'XDSBaseTypeahead',
+ isHiddenFromOverview: true,
displayName: 'Base Typeahead',
description:
'无样式的组合框引擎,提供输入、搜索、键盘导航和下拉列表。无包装 div,无边框样式,无标记渲染。由 XDSTypeahead 和 XDSTokenizer 用于自定义组合。',
@@ -686,6 +688,7 @@ export const docsDense = {
},
{
name: 'XDSBaseTypeahead',
+ isHiddenFromOverview: true,
displayName: 'Base Typeahead',
description: 'Unstyled combobox engine; input+search+keyboard nav+dropdown. No wrapper/border/token. Used by XDSTypeahead+XDSTokenizer.',
propDescriptions: {
diff --git a/packages/core/src/docs-types.ts b/packages/core/src/docs-types.ts
index 267a47ae8d..e380e0108a 100644
--- a/packages/core/src/docs-types.ts
+++ b/packages/core/src/docs-types.ts
@@ -199,6 +199,8 @@ export interface ComponentEntry {
props: PropDoc[];
/** Short code examples rendered by the CLI after the props table. */
examples?: ExampleDoc[];
+ /** When true, this sub-component is excluded from the overview page. */
+ isHiddenFromOverview?: boolean;
}
/**
@@ -418,23 +420,31 @@ interface BaseDoc {
* component's functional role in a UI.
*
* Valid values:
- * - `'Actions'` — interactive components like buttons and links
- * - `'Communications'` — informational display: tooltips, toasts, badges
- * - `'Containers'` — wrappers: cards, dialogs, collapsibles
- * - `'Layout'` — structural: grid, stack, center, dividers
- * - `'Inputs'` — data entry: text fields, selectors, date pickers
- * - `'Lists'` — data display in list/table form
+ * - `'Action'` — interactive triggers: buttons, links, toggles, menus
+ * - `'Chat'` — conversational UI: messages, composers, layouts
+ * - `'Container'` — wrappers: cards, carousels, collapsibles
+ * - `'Content'` — display: text, icons, avatars, code blocks
+ * - `'Data Input'` — data entry: text fields, selectors, date pickers
+ * - `'Data Visualization'` — charts, graphs, 3D visualizations
+ * - `'Feedback & Status'` — progress indication: spinners, banners, badges
+ * - `'Layout'` — structural: grid, stack, dividers, app shell
* - `'Navigation'` — wayfinding: tabs, breadcrumbs, sidebars
- * - `'Performance'` — progress indication: spinners, skeletons, bars */
+ * - `'Overlay'` — layered UI: dialogs, popovers, tooltips
+ * - `'Table & List'` — tabular and list data display
+ * - `'Utility'` — providers and context: themes, link providers */
category?:
- | 'Actions'
- | 'Communications'
- | 'Containers'
+ | 'Action'
+ | 'Chat'
+ | 'Container'
+ | 'Content'
+ | 'Data Input'
+ | 'Data Visualization'
+ | 'Feedback & Status'
| 'Layout'
- | 'Inputs'
- | 'Lists'
| 'Navigation'
- | 'Performance';
+ | 'Overlay'
+ | 'Table & List'
+ | 'Utility';
/** When true, this component is excluded from the categorized overview
* page but remains in the sidebar and CLI. Use for sub-components that
* only make sense within a parent (e.g. BreadcrumbItem, DialogHeader)
@@ -544,6 +554,8 @@ export interface TranslationDoc {
description: string;
/** Prop descriptions keyed by prop name. */
propDescriptions?: Record<string, string>;
+ /** When true, this sub-component is excluded from the overview page. */
+ isHiddenFromOverview?: boolean;
}[];
}
diff --git a/packages/core/src/theme/MediaTheme.doc.mjs b/packages/core/src/theme/MediaTheme.doc.mjs
index 1cf64f26c1..4e1177fe76 100644
--- a/packages/core/src/theme/MediaTheme.doc.mjs
+++ b/packages/core/src/theme/MediaTheme.doc.mjs
@@ -6,6 +6,8 @@ export const docs = {
name: 'MediaTheme',
displayName: 'Media Theme',
group: 'Utilities',
+ category: 'Utility',
+ isHiddenFromOverview: true,
keywords: ['theme', 'dark-mode', 'light-mode', 'media', 'inverted', 'overlay', 'scrim', 'toast', 'tooltip'],
usage: {
description:
diff --git a/packages/core/src/theme/SyntaxTheme.doc.mjs b/packages/core/src/theme/SyntaxTheme.doc.mjs
index 8bd2058d51..4555e745ce 100644
--- a/packages/core/src/theme/SyntaxTheme.doc.mjs
+++ b/packages/core/src/theme/SyntaxTheme.doc.mjs
@@ -6,6 +6,8 @@ export const docs = {
name: 'SyntaxTheme',
displayName: 'Syntax Theme',
group: 'Utilities',
+ category: 'Utility',
+ isHiddenFromOverview: true,
keywords: ['syntax', 'highlighting', 'code', 'theme', 'codeblock', 'prism', 'shiki'],
usage: {
description:
diff --git a/packages/core/src/theme/XDSTheme.doc.mjs b/packages/core/src/theme/XDSTheme.doc.mjs
index a18a6fb484..e17e5d3fd8 100644
--- a/packages/core/src/theme/XDSTheme.doc.mjs
+++ b/packages/core/src/theme/XDSTheme.doc.mjs
@@ -6,6 +6,8 @@ export const docs = {
name: 'Theme',
displayName: 'Theme',
group: 'Utilities',
+ category: 'Utility',
+ isHiddenFromOverview: true,
keywords: ['theme', 'theming', 'provider', 'color-scheme'],
usage: {
description: 'Wraps a subtree with a specific XDS theme. Use at the app root or around sections that need a different visual treatment.',
diff --git a/packages/lab/src/Chart/ChartArea.doc.mjs b/packages/lab/src/Chart/ChartArea.doc.mjs
new file mode 100644
index 0000000000..3c3d69a394
--- /dev/null
+++ b/packages/lab/src/Chart/ChartArea.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'ChartArea',
+ displayName: 'Chart Area',
+ group: 'Chart',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/Chart/ChartBar.doc.mjs b/packages/lab/src/Chart/ChartBar.doc.mjs
new file mode 100644
index 0000000000..e0afe33550
--- /dev/null
+++ b/packages/lab/src/Chart/ChartBar.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'ChartBar',
+ displayName: 'Chart Bar',
+ group: 'Chart',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/Chart/ChartCandlestick.doc.mjs b/packages/lab/src/Chart/ChartCandlestick.doc.mjs
new file mode 100644
index 0000000000..72110c672d
--- /dev/null
+++ b/packages/lab/src/Chart/ChartCandlestick.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'ChartCandlestick',
+ displayName: 'Chart Candlestick',
+ group: 'Chart',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/Chart/ChartDot.doc.mjs b/packages/lab/src/Chart/ChartDot.doc.mjs
new file mode 100644
index 0000000000..ba98b2f289
--- /dev/null
+++ b/packages/lab/src/Chart/ChartDot.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'ChartDot',
+ displayName: 'Chart Dot',
+ group: 'Chart',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/Chart/ChartDotGL.doc.mjs b/packages/lab/src/Chart/ChartDotGL.doc.mjs
new file mode 100644
index 0000000000..656dff96c2
--- /dev/null
+++ b/packages/lab/src/Chart/ChartDotGL.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'ChartDotGL',
+ displayName: 'Chart Dot GL',
+ group: 'Chart',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/Chart/ChartDotGLInteractive.doc.mjs b/packages/lab/src/Chart/ChartDotGLInteractive.doc.mjs
new file mode 100644
index 0000000000..8b8a1fb1a1
--- /dev/null
+++ b/packages/lab/src/Chart/ChartDotGLInteractive.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'ChartDotGLInteractive',
+ displayName: 'Chart Dot GL Interactive',
+ group: 'Chart',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/Chart/ChartHeatmapGL.doc.mjs b/packages/lab/src/Chart/ChartHeatmapGL.doc.mjs
new file mode 100644
index 0000000000..6cb9234011
--- /dev/null
+++ b/packages/lab/src/Chart/ChartHeatmapGL.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'ChartHeatmapGL',
+ displayName: 'Chart Heatmap GL',
+ group: 'Chart',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/Chart/ChartLine.doc.mjs b/packages/lab/src/Chart/ChartLine.doc.mjs
new file mode 100644
index 0000000000..e6b5b941e2
--- /dev/null
+++ b/packages/lab/src/Chart/ChartLine.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'ChartLine',
+ displayName: 'Chart Line',
+ group: 'Chart',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/Chart/ChartStreamGL.doc.mjs b/packages/lab/src/Chart/ChartStreamGL.doc.mjs
new file mode 100644
index 0000000000..a2fbf08c67
--- /dev/null
+++ b/packages/lab/src/Chart/ChartStreamGL.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'ChartStreamGL',
+ displayName: 'Chart Stream GL',
+ group: 'Chart',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/ChartV2/ChartSwatch.doc.mjs b/packages/lab/src/ChartV2/ChartSwatch.doc.mjs
new file mode 100644
index 0000000000..2509f82bde
--- /dev/null
+++ b/packages/lab/src/ChartV2/ChartSwatch.doc.mjs
@@ -0,0 +1,17 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'ChartSwatch',
+ displayName: 'Chart Swatch',
+ group: 'ChartV2',
+ category: 'Data Visualization',
+ isHiddenFromOverview: true,
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/ChartV2/ChartV2.doc.mjs b/packages/lab/src/ChartV2/ChartV2.doc.mjs
new file mode 100644
index 0000000000..c2a8651faf
--- /dev/null
+++ b/packages/lab/src/ChartV2/ChartV2.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'ChartV2',
+ displayName: 'Chart V2',
+ group: 'ChartV2',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/ChatReasoning/ChatReasoning.doc.mjs b/packages/lab/src/ChatReasoning/ChatReasoning.doc.mjs
new file mode 100644
index 0000000000..ce94702847
--- /dev/null
+++ b/packages/lab/src/ChatReasoning/ChatReasoning.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'ChatReasoning',
+ displayName: 'Chat Reasoning',
+ group: 'Chat',
+ category: 'Chat',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/CircularProgress/CircularProgress.doc.mjs b/packages/lab/src/CircularProgress/CircularProgress.doc.mjs
index d62191203e..aa953cb927 100644
--- a/packages/lab/src/CircularProgress/CircularProgress.doc.mjs
+++ b/packages/lab/src/CircularProgress/CircularProgress.doc.mjs
@@ -5,7 +5,7 @@
export const docs = {
name: 'CircularProgress',
displayName: 'Circular Progress',
- category: 'Performance',
+ category: 'Feedback & Status',
keywords: ["circular","progress","radial","ring","arc","determinate","indeterminate","gauge","meter","donut"],
props: [
{
diff --git a/packages/lab/src/CodeEditor/CodeEditor.doc.mjs b/packages/lab/src/CodeEditor/CodeEditor.doc.mjs
new file mode 100644
index 0000000000..f64efe212c
--- /dev/null
+++ b/packages/lab/src/CodeEditor/CodeEditor.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'CodeEditor',
+ displayName: 'Code Editor',
+ group: 'CodeEditor',
+ category: 'Data Input',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/Radial/RadialChart.doc.mjs b/packages/lab/src/Radial/RadialChart.doc.mjs
new file mode 100644
index 0000000000..64fc438e9d
--- /dev/null
+++ b/packages/lab/src/Radial/RadialChart.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'RadialChart',
+ displayName: 'Radial Chart',
+ group: 'Radial',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/SVGIcon/SVGIcon.doc.mjs b/packages/lab/src/SVGIcon/SVGIcon.doc.mjs
new file mode 100644
index 0000000000..5cd66062b5
--- /dev/null
+++ b/packages/lab/src/SVGIcon/SVGIcon.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'SVGIcon',
+ displayName: 'SVG Icon',
+ group: 'SVGIcon',
+ category: 'Content',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/Sankey/SankeyChart.doc.mjs b/packages/lab/src/Sankey/SankeyChart.doc.mjs
new file mode 100644
index 0000000000..00043bf6f1
--- /dev/null
+++ b/packages/lab/src/Sankey/SankeyChart.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'SankeyChart',
+ displayName: 'Sankey Chart',
+ group: 'Sankey',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/Schedule/Schedule.doc.mjs b/packages/lab/src/Schedule/Schedule.doc.mjs
new file mode 100644
index 0000000000..3739c13b3f
--- /dev/null
+++ b/packages/lab/src/Schedule/Schedule.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'Schedule',
+ displayName: 'Schedule',
+ group: 'Schedule',
+ category: 'Data Input',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/Stepper/Step.doc.mjs b/packages/lab/src/Stepper/Step.doc.mjs
new file mode 100644
index 0000000000..4aabcb9183
--- /dev/null
+++ b/packages/lab/src/Stepper/Step.doc.mjs
@@ -0,0 +1,17 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: 'Step',
+ displayName: 'Step',
+ group: 'Stepper',
+ category: 'Navigation',
+ isHiddenFromOverview: true,
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/ThreeD/3DBar.doc.mjs b/packages/lab/src/ThreeD/3DBar.doc.mjs
new file mode 100644
index 0000000000..a75e65cf81
--- /dev/null
+++ b/packages/lab/src/ThreeD/3DBar.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: '3DBar',
+ displayName: '3D Bar',
+ group: 'ThreeD',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/ThreeD/3DChart.doc.mjs b/packages/lab/src/ThreeD/3DChart.doc.mjs
new file mode 100644
index 0000000000..5ed1cff0a2
--- /dev/null
+++ b/packages/lab/src/ThreeD/3DChart.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: '3DChart',
+ displayName: '3D Chart',
+ group: 'ThreeD',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/ThreeD/3DScatter.doc.mjs b/packages/lab/src/ThreeD/3DScatter.doc.mjs
new file mode 100644
index 0000000000..9aa313d8c4
--- /dev/null
+++ b/packages/lab/src/ThreeD/3DScatter.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: '3DScatter',
+ displayName: '3D Scatter',
+ group: 'ThreeD',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/ThreeD/3DScatterGL.doc.mjs b/packages/lab/src/ThreeD/3DScatterGL.doc.mjs
new file mode 100644
index 0000000000..61a67916ab
--- /dev/null
+++ b/packages/lab/src/ThreeD/3DScatterGL.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: '3DScatterGL',
+ displayName: '3D Scatter GL',
+ group: 'ThreeD',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};
diff --git a/packages/lab/src/ThreeD/3DSurface.doc.mjs b/packages/lab/src/ThreeD/3DSurface.doc.mjs
new file mode 100644
index 0000000000..290f8bed47
--- /dev/null
+++ b/packages/lab/src/ThreeD/3DSurface.doc.mjs
@@ -0,0 +1,16 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+ name: '3DSurface',
+ displayName: '3D Surface',
+ group: 'ThreeD',
+ category: 'Data Visualization',
+
+ usage: {
+ description: '',
+ },
+
+ props: [],
+};