@alfadocs/ui-kit 0.84.0 → 0.84.1

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.84.0",
+  "packageVersion": "0.84.1",
   "components": [
     {
       "kind": "component",

package/dist/components/select/select.d.ts

@@ -69,11 +69,14 @@ export interface SelectProps<T extends string = string> {
     'aria-label'?: string;
     className?: string;
     /**
-     * Portal target for the listbox. Defaults to `document.body`. Set this to a
-     * parent overlay's content element (e.g. a Popover) when the Select is nested
-     * inside one, so the listbox shares that stacking context and renders above
-     * it instead of behind it (the global z-scale puts `--z-dropdown` below
-     * `--z-popover`).
+     * Portal target for the listbox. Defaults to `document.body`, which is
+     * almost always correct.
+     *
+     * You do not need this to fix stacking. `--z-dropdown` and `--z-popover`
+     * are one layer, so a Select nested inside a Popover already paints over it
+     * by portal order (the listbox mounts last). Only pass a container when the
+     * listbox must live inside a specific subtree — e.g. a shadow root, or a
+     * scroll container that would otherwise clip it.
      */
     container?: HTMLElement | null;
 }