Skip to content

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

TypeScript

docs(dense): restore bestPractices parity for useLayer (#3300)

Joey9e99bd96f24f
diff --git a/packages/core/src/Layer/useLayer.doc.mjs b/packages/core/src/Layer/useLayer.doc.mjs
index f7c4eecadb..0e3104a1eb 100644
--- a/packages/core/src/Layer/useLayer.doc.mjs
+++ b/packages/core/src/Layer/useLayer.doc.mjs
@@ -144,6 +144,11 @@ export const docsDense = {
guidance: true,
description: 'Build on Popover/HoverCard/Tooltip for common overlay patterns.',
},
+ {
+ guidance: true,
+ description:
+ 'Rely on the Popover API top layer to escape clipping/stacking: render inline (no portal) to inherit the trigger theme cascade and natural focus order. Use `as: "span"` when the layer must be valid in inline contexts like a paragraph.',
+ },
{
guidance: false,
description: