Skip to content

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

TypeScript

docs(ComplexSelector): backfill two missing dense best-practice bullets (#5292)

Joeyc460ad6bab08
diff --git a/packages/core/src/ComplexSelector/ComplexSelector.doc.mjs b/packages/core/src/ComplexSelector/ComplexSelector.doc.mjs
index ff93f792e3..7e632d4e22 100644
--- a/packages/core/src/ComplexSelector/ComplexSelector.doc.mjs
+++ b/packages/core/src/ComplexSelector/ComplexSelector.doc.mjs
@@ -215,6 +215,16 @@ export const docsDense = {
description:
'Use when a selection needs richer custom content than a Selector row. One component: it owns field, trigger, popover, focus restore, and changeAction; the render prop owns the selector-specific accessible structure.',
bestPractices: [
+ {
+ guidance: true,
+ description:
+ 'Use variant="ghost" with a startIcon for a toolbar trigger. Use alignment="end" when a wide surface should align its end edge to the trigger.',
+ },
+ {
+ guidance: true,
+ description:
+ 'For staged editors, keep draft state in the composed content and call the provided onChange helper only from Apply. Cancel or dismiss without committing.',
+ },
{
guidance: true,
description: