@bitrise/bitkit-v2 0.3.326 → 0.3.328

package/dist/components/BitkitCombobox/BitkitCombobox.js

@@ -1,11 +1,11 @@
 import AssetSelectChevron from "../../utilities/AssetSelectChevron.js";
 import IconErrorCircleFilled from "../../icons/IconErrorCircleFilled.js";
 import IconWarningYellow from "../../icons/IconWarningYellow.js";
+import BitkitPortalContext from "../../utilities/BitkitPortalContext.js";
 import BitkitCloseButton from "../BitkitCloseButton/BitkitCloseButton.js";
 import { withSubComponents } from "../../utilities/withSubComponents.js";
 import BitkitSelectMenuAction from "../BitkitSelectMenu/BitkitSelectMenuAction.js";
 import BitkitSelectMenu from "../BitkitSelectMenu/BitkitSelectMenu.js";
-import BitkitPortalContext from "../../utilities/BitkitPortalContext.js";
 import BitkitField from "../BitkitField/BitkitField.js";
 import { forwardRef, useContext, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";

package/dist/components/BitkitDatePicker/BitkitDatePicker.js

@@ -1,11 +1,11 @@
 import IconCalendar from "../../icons/IconCalendar.js";
 import IconErrorCircleFilled from "../../icons/IconErrorCircleFilled.js";
 import IconWarningYellow from "../../icons/IconWarningYellow.js";
+import BitkitPortalContext from "../../utilities/BitkitPortalContext.js";
 import BitkitControlButton from "../BitkitControlButton/BitkitControlButton.js";
 import { DatePicker, useDatePickerContext } from "../../atoms/DatePicker/DatePicker.js";
 import { calendarDateToDate, dateToCalendarDate } from "../BitkitCalendar/Calendar.utils.js";
 import CalendarContent from "../BitkitCalendar/components/CalendarContent.js";
-import BitkitPortalContext from "../../utilities/BitkitPortalContext.js";
 import BitkitField from "../BitkitField/BitkitField.js";
 import { Box } from "@chakra-ui/react/box";
 import { useSlotRecipe } from "@chakra-ui/react/styled-system";

package/dist/components/BitkitDefinitionTooltip/BitkitDefinitionTooltip.d.ts

@@ -1,18 +1,43 @@
 import { TooltipRootProps } from '@chakra-ui/react/tooltip';
 import { BitkitTooltipProps } from '../BitkitTooltip/BitkitTooltip';
 export interface BitkitDefinitionTooltipProps {
+    /** Action button rendered at the end of the tooltip, below the definition. */
     button?: BitkitTooltipProps['button'];
+    /** The term being defined. Rendered as the underlined trigger, so plain text only. */
     children: string;
+    /**
+     * Render the tooltip inline instead of in a portal. Only needed when it must stay inside its
+     * parent's DOM subtree — a dialog already sets this for you.
+     */
+    disablePortal?: boolean;
+    /** Target for the "Learn more" link. `_blank` also sets `rel="noopener noreferrer"`. */
     learnMoreTarget?: BitkitTooltipProps['learnMoreTarget'];
+    /** Adds a "Learn more" link pointing here, for the fuller explanation. */
     learnMoreUrl?: BitkitTooltipProps['learnMoreUrl'];
+    /**
+     * How the definition opens. `click` (default) toggles it and keeps it open — the right choice when
+     * it carries a link or a button, which need a stable target. `hover` behaves like a plain tooltip.
+     */
     method?: 'click' | 'hover';
+    /** Where the tooltip sits relative to the term (default `top`). It flips if space is short. */
     placement?: NonNullable<TooltipRootProps['positioning']>['placement'];
+    /** The definition itself. */
     text: string;
+    /** Type size of the term, to match the surrounding copy. */
     textSize?: 'lg' | 'md' | 'sm';
+    /** Truncate the term with an ellipsis when it doesn't fit (default `true`). */
     truncate?: boolean;
 }
+/**
+ * An inline glossary term: the word stays in the sentence, underlined, and reveals its definition
+ * on demand. Unlike `BitkitTooltip`, the trigger is the content — a `<button>` wrapping the term —
+ * so it is reachable by keyboard on its own.
+ *
+ * Defaults to `method="click"`, which latches the definition open; that is what makes a
+ * `learnMoreUrl` or `button` inside it actually clickable.
+ */
 declare const BitkitDefinitionTooltip: {
-    ({ button, children, learnMoreTarget, learnMoreUrl, method, placement, text, textSize, truncate, }: BitkitDefinitionTooltipProps): import("react").JSX.Element;
+    ({ button, children, disablePortal, learnMoreTarget, learnMoreUrl, method, placement, text, textSize, truncate, }: BitkitDefinitionTooltipProps): import("react").JSX.Element;
     displayName: string;
 };
 export default BitkitDefinitionTooltip;

package/dist/components/BitkitDefinitionTooltip/BitkitDefinitionTooltip.js

@@ -3,12 +3,21 @@ import { chakra, useRecipe } from "@chakra-ui/react/styled-system";
 import { useState } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region lib/components/BitkitDefinitionTooltip/BitkitDefinitionTooltip.tsx
-var BitkitDefinitionTooltip = ({ button, children, learnMoreTarget, learnMoreUrl, method = "click", placement = "top", text, textSize, truncate = true }) => {
+/**
+* An inline glossary term: the word stays in the sentence, underlined, and reveals its definition
+* on demand. Unlike `BitkitTooltip`, the trigger is the content — a `<button>` wrapping the term —
+* so it is reachable by keyboard on its own.
+*
+* Defaults to `method="click"`, which latches the definition open; that is what makes a
+* `learnMoreUrl` or `button` inside it actually clickable.
+*/
+var BitkitDefinitionTooltip = ({ button, children, disablePortal, learnMoreTarget, learnMoreUrl, method = "click", placement = "top", text, textSize, truncate = true }) => {
 	const style = useRecipe({ key: "definitionTooltip" });
 	const [open, setOpen] = useState(false);
 	return /* @__PURE__ */ jsx(BitkitTooltip, {
 		button,
 		closeOnClick: method === "click" ? false : void 0,
+		disablePortal,
 		learnMoreTarget,
 		learnMoreUrl,
 		onOpenChange: method === "click" ? ({ open: nextOpen }) => {

package/dist/components/BitkitDefinitionTooltip/BitkitDefinitionTooltip.js.map

@@ -1 +1 @@
-{"version":3,"file":"BitkitDefinitionTooltip.js","names":[],"sources":["../../../lib/components/BitkitDefinitionTooltip/BitkitDefinitionTooltip.tsx"],"sourcesContent":["import { chakra, useRecipe } from '@chakra-ui/react/styled-system';\nimport { type TooltipRootProps } from '@chakra-ui/react/tooltip';\nimport { useState } from 'react';\n\nimport BitkitTooltip, { type BitkitTooltipProps } from '../BitkitTooltip/BitkitTooltip';\n\nexport interface BitkitDefinitionTooltipProps {\n  button?: BitkitTooltipProps['button'];\n  children: string;\n  learnMoreTarget?: BitkitTooltipProps['learnMoreTarget'];\n  learnMoreUrl?: BitkitTooltipProps['learnMoreUrl'];\n  method?: 'click' | 'hover';\n  placement?: NonNullable<TooltipRootProps['positioning']>['placement'];\n  text: string;\n  textSize?: 'lg' | 'md' | 'sm';\n  truncate?: boolean;\n}\n\nconst BitkitDefinitionTooltip = ({\n  button,\n  children,\n  learnMoreTarget,\n  learnMoreUrl,\n  method = 'click',\n  placement = 'top',\n  text,\n  textSize,\n  truncate = true,\n}: BitkitDefinitionTooltipProps) => {\n  const style = useRecipe({ key: 'definitionTooltip' });\n  const [open, setOpen] = useState(false);\n\n  return (\n    <BitkitTooltip\n      button={button}\n      closeOnClick={method === 'click' ? false : undefined}\n      learnMoreTarget={learnMoreTarget}\n      learnMoreUrl={learnMoreUrl}\n      onOpenChange={\n        method === 'click'\n          ? ({ open: nextOpen }) => {\n              if (!nextOpen) setOpen(false);\n            }\n          : undefined\n      }\n      open={method === 'click' ? open : undefined}\n      openDelay={method === 'click' ? Infinity : undefined}\n      placement={placement}\n      text={text}\n    >\n      <chakra.button\n        aria-expanded={method === 'click' ? open : undefined}\n        css={style({ method, textSize })}\n        onClick={method === 'click' ? () => setOpen(!open) : undefined}\n        truncate={truncate}\n        type=\"button\"\n      >\n        {children}\n      </chakra.button>\n    </BitkitTooltip>\n  );\n};\n\nBitkitDefinitionTooltip.displayName = 'BitkitDefinitionTooltip';\n\nexport default BitkitDefinitionTooltip;\n"],"mappings":";;;;;AAkBA,IAAM,2BAA2B,EAC/B,QACA,UACA,iBACA,cACA,SAAS,SACT,YAAY,OACZ,MACA,UACA,WAAW,WACuB;CAClC,MAAM,QAAQ,UAAU,EAAE,KAAK,oBAAoB,CAAC;CACpD,MAAM,CAAC,MAAM,WAAW,SAAS,KAAK;CAEtC,OACE,oBAAC,eAAD;EACU;EACR,cAAc,WAAW,UAAU,QAAQ,KAAA;EAC1B;EACH;EACd,cACE,WAAW,WACN,EAAE,MAAM,eAAe;GACtB,IAAI,CAAC,UAAU,QAAQ,KAAK;EAC9B,IACA,KAAA;EAEN,MAAM,WAAW,UAAU,OAAO,KAAA;EAClC,WAAW,WAAW,UAAU,WAAW,KAAA;EAChC;EACL;YAEN,oBAAC,OAAO,QAAR;GACE,iBAAe,WAAW,UAAU,OAAO,KAAA;GAC3C,KAAK,MAAM;IAAE;IAAQ;GAAS,CAAC;GAC/B,SAAS,WAAW,gBAAgB,QAAQ,CAAC,IAAI,IAAI,KAAA;GAC3C;GACV,MAAK;GAEJ;EACY,CAAA;CACF,CAAA;AAEnB;AAEA,wBAAwB,cAAc"}
+{"version":3,"file":"BitkitDefinitionTooltip.js","names":[],"sources":["../../../lib/components/BitkitDefinitionTooltip/BitkitDefinitionTooltip.tsx"],"sourcesContent":["import { chakra, useRecipe } from '@chakra-ui/react/styled-system';\nimport { type TooltipRootProps } from '@chakra-ui/react/tooltip';\nimport { useState } from 'react';\n\nimport BitkitTooltip, { type BitkitTooltipProps } from '../BitkitTooltip/BitkitTooltip';\n\nexport interface BitkitDefinitionTooltipProps {\n  /** Action button rendered at the end of the tooltip, below the definition. */\n  button?: BitkitTooltipProps['button'];\n  /** The term being defined. Rendered as the underlined trigger, so plain text only. */\n  children: string;\n  /**\n   * Render the tooltip inline instead of in a portal. Only needed when it must stay inside its\n   * parent's DOM subtree — a dialog already sets this for you.\n   */\n  disablePortal?: boolean;\n  /** Target for the \"Learn more\" link. `_blank` also sets `rel=\"noopener noreferrer\"`. */\n  learnMoreTarget?: BitkitTooltipProps['learnMoreTarget'];\n  /** Adds a \"Learn more\" link pointing here, for the fuller explanation. */\n  learnMoreUrl?: BitkitTooltipProps['learnMoreUrl'];\n  /**\n   * How the definition opens. `click` (default) toggles it and keeps it open — the right choice when\n   * it carries a link or a button, which need a stable target. `hover` behaves like a plain tooltip.\n   */\n  method?: 'click' | 'hover';\n  /** Where the tooltip sits relative to the term (default `top`). It flips if space is short. */\n  placement?: NonNullable<TooltipRootProps['positioning']>['placement'];\n  /** The definition itself. */\n  text: string;\n  /** Type size of the term, to match the surrounding copy. */\n  textSize?: 'lg' | 'md' | 'sm';\n  /** Truncate the term with an ellipsis when it doesn't fit (default `true`). */\n  truncate?: boolean;\n}\n\n/**\n * An inline glossary term: the word stays in the sentence, underlined, and reveals its definition\n * on demand. Unlike `BitkitTooltip`, the trigger is the content — a `<button>` wrapping the term —\n * so it is reachable by keyboard on its own.\n *\n * Defaults to `method=\"click\"`, which latches the definition open; that is what makes a\n * `learnMoreUrl` or `button` inside it actually clickable.\n */\nconst BitkitDefinitionTooltip = ({\n  button,\n  children,\n  disablePortal,\n  learnMoreTarget,\n  learnMoreUrl,\n  method = 'click',\n  placement = 'top',\n  text,\n  textSize,\n  truncate = true,\n}: BitkitDefinitionTooltipProps) => {\n  const style = useRecipe({ key: 'definitionTooltip' });\n  const [open, setOpen] = useState(false);\n\n  return (\n    <BitkitTooltip\n      button={button}\n      closeOnClick={method === 'click' ? false : undefined}\n      disablePortal={disablePortal}\n      learnMoreTarget={learnMoreTarget}\n      learnMoreUrl={learnMoreUrl}\n      onOpenChange={\n        method === 'click'\n          ? ({ open: nextOpen }) => {\n              if (!nextOpen) setOpen(false);\n            }\n          : undefined\n      }\n      open={method === 'click' ? open : undefined}\n      openDelay={method === 'click' ? Infinity : undefined}\n      placement={placement}\n      text={text}\n    >\n      <chakra.button\n        aria-expanded={method === 'click' ? open : undefined}\n        css={style({ method, textSize })}\n        onClick={method === 'click' ? () => setOpen(!open) : undefined}\n        truncate={truncate}\n        type=\"button\"\n      >\n        {children}\n      </chakra.button>\n    </BitkitTooltip>\n  );\n};\n\nBitkitDefinitionTooltip.displayName = 'BitkitDefinitionTooltip';\n\nexport default BitkitDefinitionTooltip;\n"],"mappings":";;;;;;;;;;;;;AA2CA,IAAM,2BAA2B,EAC/B,QACA,UACA,eACA,iBACA,cACA,SAAS,SACT,YAAY,OACZ,MACA,UACA,WAAW,WACuB;CAClC,MAAM,QAAQ,UAAU,EAAE,KAAK,oBAAoB,CAAC;CACpD,MAAM,CAAC,MAAM,WAAW,SAAS,KAAK;CAEtC,OACE,oBAAC,eAAD;EACU;EACR,cAAc,WAAW,UAAU,QAAQ,KAAA;EAC5B;EACE;EACH;EACd,cACE,WAAW,WACN,EAAE,MAAM,eAAe;GACtB,IAAI,CAAC,UAAU,QAAQ,KAAK;EAC9B,IACA,KAAA;EAEN,MAAM,WAAW,UAAU,OAAO,KAAA;EAClC,WAAW,WAAW,UAAU,WAAW,KAAA;EAChC;EACL;YAEN,oBAAC,OAAO,QAAR;GACE,iBAAe,WAAW,UAAU,OAAO,KAAA;GAC3C,KAAK,MAAM;IAAE;IAAQ;GAAS,CAAC;GAC/B,SAAS,WAAW,gBAAgB,QAAQ,CAAC,IAAI,IAAI,KAAA;GAC3C;GACV,MAAK;GAEJ;EACY,CAAA;CACF,CAAA;AAEnB;AAEA,wBAAwB,cAAc"}

package/dist/components/BitkitDialog/DialogInner.js

@@ -1,5 +1,5 @@
-import BitkitCloseButton from "../BitkitCloseButton/BitkitCloseButton.js";
 import BitkitPortalContext from "../../utilities/BitkitPortalContext.js";
+import BitkitCloseButton from "../BitkitCloseButton/BitkitCloseButton.js";
 import DialogBody, { DialogBodyContext, resolveScrollBehavior } from "./DialogBodyContext.js";
 import { Box } from "@chakra-ui/react/box";
 import { chakra } from "@chakra-ui/react/styled-system";

package/dist/components/BitkitLabelTooltip/BitkitLabelTooltip.d.ts

@@ -1,13 +1,32 @@
 import { TooltipRootProps } from '@chakra-ui/react/tooltip';
 import { ReactNode } from 'react';
 export type BitkitLabelTooltipProps = {
+    /** The control the tooltip labels. Rendered via `asChild`, so it must accept a ref. */
     children: ReactNode;
+    /** Render the trigger without a tooltip — for labels that only apply in some states. */
     disabled?: TooltipRootProps['disabled'];
+    /**
+     * Render the tooltip inline instead of in a portal. Only needed when it must stay inside its
+     * parent's DOM subtree — a dialog already sets this for you.
+     */
+    disablePortal?: boolean;
+    /** Where the tooltip sits relative to the trigger (default `top`). It flips if space is short. */
     placement?: NonNullable<TooltipRootProps['positioning']>['placement'];
+    /** The label. Keep it to a couple of words — this is a name, not an explanation. */
     text: string;
 };
+/**
+ * Names a control that shows no text of its own, typically an icon button. Small, tight and
+ * semibold, in contrast to `BitkitTooltip`, which explains rather than labels.
+ *
+ * Note this only *describes* the trigger to sighted users — it does not give it an accessible name.
+ * An icon-only control still needs its own `aria-label`.
+ *
+ * The content renders in a portal so it escapes ancestors that trap stacking or clip overflow.
+ * Dialogs turn that off through `BitkitPortalContext`; `disablePortal` is the manual override.
+ */
 declare const BitkitLabelTooltip: {
-    ({ children, disabled, placement, text }: BitkitLabelTooltipProps): import("react").JSX.Element;
+    ({ children, disablePortal, disabled, placement, text, }: BitkitLabelTooltipProps): import("react").JSX.Element;
     displayName: string;
 };
 export default BitkitLabelTooltip;

package/dist/components/BitkitLabelTooltip/BitkitLabelTooltip.js

@@ -1,9 +1,21 @@
-import { useRef } from "react";
+import BitkitPortalContext from "../../utilities/BitkitPortalContext.js";
+import { useContext, useRef } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Portal } from "@chakra-ui/react/portal";
 import { Tooltip } from "@chakra-ui/react/tooltip";
 //#region lib/components/BitkitLabelTooltip/BitkitLabelTooltip.tsx
-var BitkitLabelTooltip = ({ children, disabled, placement = "top", text }) => {
+/**
+* Names a control that shows no text of its own, typically an icon button. Small, tight and
+* semibold, in contrast to `BitkitTooltip`, which explains rather than labels.
+*
+* Note this only *describes* the trigger to sighted users — it does not give it an accessible name.
+* An icon-only control still needs its own `aria-label`.
+*
+* The content renders in a portal so it escapes ancestors that trap stacking or clip overflow.
+* Dialogs turn that off through `BitkitPortalContext`; `disablePortal` is the manual override.
+*/
+var BitkitLabelTooltip = ({ children, disablePortal, disabled, placement = "top", text }) => {
+	const { disablePortal: disablePortalFromContext } = useContext(BitkitPortalContext);
 	const triggerRef = useRef(null);
 	return /* @__PURE__ */ jsxs(Tooltip.Root, {
 		disabled,
@@ -21,7 +33,10 @@ var BitkitLabelTooltip = ({ children, disabled, placement = "top", text }) => {
 			ref: triggerRef,
 			asChild: true,
 			children
-		}), /* @__PURE__ */ jsx(Portal, { children: /* @__PURE__ */ jsx(Tooltip.Positioner, { children: /* @__PURE__ */ jsx(Tooltip.Content, { children: text }) }) })]
+		}), /* @__PURE__ */ jsx(Portal, {
+			disabled: disablePortal || disablePortalFromContext,
+			children: /* @__PURE__ */ jsx(Tooltip.Positioner, { children: /* @__PURE__ */ jsx(Tooltip.Content, { children: text }) })
+		})]
 	});
 };
 BitkitLabelTooltip.displayName = "BitkitLabelTooltip";

package/dist/components/BitkitLabelTooltip/BitkitLabelTooltip.js.map

@@ -1 +1 @@
-{"version":3,"file":"BitkitLabelTooltip.js","names":[],"sources":["../../../lib/components/BitkitLabelTooltip/BitkitLabelTooltip.tsx"],"sourcesContent":["import { Portal } from '@chakra-ui/react/portal';\nimport { Tooltip, type TooltipRootProps } from '@chakra-ui/react/tooltip';\nimport { type ReactNode, type Ref, useRef } from 'react';\n\nexport type BitkitLabelTooltipProps = {\n  children: ReactNode;\n  disabled?: TooltipRootProps['disabled'];\n  placement?: NonNullable<TooltipRootProps['positioning']>['placement'];\n  text: string;\n};\n\nconst BitkitLabelTooltip = ({ children, disabled, placement = 'top', text }: BitkitLabelTooltipProps) => {\n  // Anchor positioning to the trigger node by ref rather than relying on Zag's\n  // id/data-scope lookup. When the trigger is also wrapped by another `asChild`\n  // trigger (e.g. Menu.Trigger, Dialog.CloseTrigger), the outer trigger's id and\n  // data-scope/data-part overwrite ours on the shared node, so `getTriggerEl()`\n  // can't find it and the tooltip loses its anchor. `getAnchorElement` takes\n  // precedence over the id lookup, so this is safe in the standalone case too.\n  const triggerRef = useRef<HTMLElement>(null);\n\n  return (\n    <Tooltip.Root\n      disabled={disabled}\n      paddingSize=\"sm\"\n      positioning={{ getAnchorElement: () => triggerRef.current, placement, offset: { mainAxis: 4, crossAxis: 0 } }}\n      textStyle=\"sm/semibold\"\n    >\n      <Tooltip.Trigger ref={triggerRef as Ref<HTMLButtonElement>} asChild>\n        {children}\n      </Tooltip.Trigger>\n      <Portal>\n        <Tooltip.Positioner>\n          <Tooltip.Content>{text}</Tooltip.Content>\n        </Tooltip.Positioner>\n      </Portal>\n    </Tooltip.Root>\n  );\n};\n\nBitkitLabelTooltip.displayName = 'BitkitLabelTooltip';\n\nexport default BitkitLabelTooltip;\n"],"mappings":";;;;;AAWA,IAAM,sBAAsB,EAAE,UAAU,UAAU,YAAY,OAAO,WAAoC;CAOvG,MAAM,aAAa,OAAoB,IAAI;CAE3C,OACE,qBAAC,QAAQ,MAAT;EACY;EACV,aAAY;EACZ,aAAa;GAAE,wBAAwB,WAAW;GAAS;GAAW,QAAQ;IAAE,UAAU;IAAG,WAAW;GAAE;EAAE;EAC5G,WAAU;YAJZ,CAME,oBAAC,QAAQ,SAAT;GAAiB,KAAK;GAAsC,SAAA;GACzD;EACc,CAAA,GACjB,oBAAC,QAAD,EAAA,UACE,oBAAC,QAAQ,YAAT,EAAA,UACE,oBAAC,QAAQ,SAAT,EAAA,UAAkB,KAAsB,CAAA,EACtB,CAAA,EACd,CAAA,CACI;;AAElB;AAEA,mBAAmB,cAAc"}
+{"version":3,"file":"BitkitLabelTooltip.js","names":[],"sources":["../../../lib/components/BitkitLabelTooltip/BitkitLabelTooltip.tsx"],"sourcesContent":["import { Portal } from '@chakra-ui/react/portal';\nimport { Tooltip, type TooltipRootProps } from '@chakra-ui/react/tooltip';\nimport { type ReactNode, type Ref, useContext, useRef } from 'react';\n\nimport BitkitPortalContext from '../../utilities/BitkitPortalContext';\n\nexport type BitkitLabelTooltipProps = {\n  /** The control the tooltip labels. Rendered via `asChild`, so it must accept a ref. */\n  children: ReactNode;\n  /** Render the trigger without a tooltip — for labels that only apply in some states. */\n  disabled?: TooltipRootProps['disabled'];\n  /**\n   * Render the tooltip inline instead of in a portal. Only needed when it must stay inside its\n   * parent's DOM subtree — a dialog already sets this for you.\n   */\n  disablePortal?: boolean;\n  /** Where the tooltip sits relative to the trigger (default `top`). It flips if space is short. */\n  placement?: NonNullable<TooltipRootProps['positioning']>['placement'];\n  /** The label. Keep it to a couple of words — this is a name, not an explanation. */\n  text: string;\n};\n\n/**\n * Names a control that shows no text of its own, typically an icon button. Small, tight and\n * semibold, in contrast to `BitkitTooltip`, which explains rather than labels.\n *\n * Note this only *describes* the trigger to sighted users — it does not give it an accessible name.\n * An icon-only control still needs its own `aria-label`.\n *\n * The content renders in a portal so it escapes ancestors that trap stacking or clip overflow.\n * Dialogs turn that off through `BitkitPortalContext`; `disablePortal` is the manual override.\n */\nconst BitkitLabelTooltip = ({\n  children,\n  disablePortal,\n  disabled,\n  placement = 'top',\n  text,\n}: BitkitLabelTooltipProps) => {\n  const { disablePortal: disablePortalFromContext } = useContext(BitkitPortalContext);\n\n  // Anchor positioning to the trigger node by ref rather than relying on Zag's\n  // id/data-scope lookup. When the trigger is also wrapped by another `asChild`\n  // trigger (e.g. Menu.Trigger, Dialog.CloseTrigger), the outer trigger's id and\n  // data-scope/data-part overwrite ours on the shared node, so `getTriggerEl()`\n  // can't find it and the tooltip loses its anchor. `getAnchorElement` takes\n  // precedence over the id lookup, so this is safe in the standalone case too.\n  const triggerRef = useRef<HTMLElement>(null);\n\n  return (\n    <Tooltip.Root\n      disabled={disabled}\n      paddingSize=\"sm\"\n      positioning={{ getAnchorElement: () => triggerRef.current, placement, offset: { mainAxis: 4, crossAxis: 0 } }}\n      textStyle=\"sm/semibold\"\n    >\n      <Tooltip.Trigger ref={triggerRef as Ref<HTMLButtonElement>} asChild>\n        {children}\n      </Tooltip.Trigger>\n      <Portal disabled={disablePortal || disablePortalFromContext}>\n        <Tooltip.Positioner>\n          <Tooltip.Content>{text}</Tooltip.Content>\n        </Tooltip.Positioner>\n      </Portal>\n    </Tooltip.Root>\n  );\n};\n\nBitkitLabelTooltip.displayName = 'BitkitLabelTooltip';\n\nexport default BitkitLabelTooltip;\n"],"mappings":";;;;;;;;;;;;;;;;AAgCA,IAAM,sBAAsB,EAC1B,UACA,eACA,UACA,YAAY,OACZ,WAC6B;CAC7B,MAAM,EAAE,eAAe,6BAA6B,WAAW,mBAAmB;CAQlF,MAAM,aAAa,OAAoB,IAAI;CAE3C,OACE,qBAAC,QAAQ,MAAT;EACY;EACV,aAAY;EACZ,aAAa;GAAE,wBAAwB,WAAW;GAAS;GAAW,QAAQ;IAAE,UAAU;IAAG,WAAW;GAAE;EAAE;EAC5G,WAAU;YAJZ,CAME,oBAAC,QAAQ,SAAT;GAAiB,KAAK;GAAsC,SAAA;GACzD;EACc,CAAA,GACjB,oBAAC,QAAD;GAAQ,UAAU,iBAAiB;aACjC,oBAAC,QAAQ,YAAT,EAAA,UACE,oBAAC,QAAQ,SAAT,EAAA,UAAkB,KAAsB,CAAA,EACtB,CAAA;EACd,CAAA,CACI;;AAElB;AAEA,mBAAmB,cAAc"}

package/dist/components/BitkitMultiselect/BitkitMultiselect.js

@@ -1,10 +1,10 @@
 import AssetSelectChevron from "../../utilities/AssetSelectChevron.js";
 import IconErrorCircleFilled from "../../icons/IconErrorCircleFilled.js";
 import IconWarningYellow from "../../icons/IconWarningYellow.js";
+import BitkitPortalContext from "../../utilities/BitkitPortalContext.js";
 import BitkitCloseButton from "../BitkitCloseButton/BitkitCloseButton.js";
 import { withSubComponents } from "../../utilities/withSubComponents.js";
 import BitkitSelectMenuAction from "../BitkitSelectMenu/BitkitSelectMenuAction.js";
-import BitkitPortalContext from "../../utilities/BitkitPortalContext.js";
 import BitkitField from "../BitkitField/BitkitField.js";
 import BitkitMultiselectMenu from "../BitkitMultiselectMenu/BitkitMultiselectMenu.js";
 import BitkitTag from "../BitkitTag/BitkitTag.js";

package/dist/components/BitkitOverflowTooltip/BitkitOverflowTooltip.d.ts

@@ -1,13 +1,31 @@
 import { TooltipRootProps } from '@chakra-ui/react/tooltip';
 import { ReactNode } from 'react';
 export type BitkitOverflowTooltipProps = {
+    /** The truncated element the tooltip is anchored to. Rendered via `asChild`, so it must accept a ref. */
     children: ReactNode;
+    /** Render the trigger without a tooltip — pass `true` when the text isn't actually truncated. */
     disabled?: TooltipRootProps['disabled'];
+    /**
+     * Render the tooltip inline instead of in a portal. Only needed when it must stay inside its
+     * parent's DOM subtree — a dialog already sets this for you.
+     */
+    disablePortal?: boolean;
+    /** Where the tooltip sits relative to the trigger (default `right`). It flips if space is short. */
     placement?: NonNullable<TooltipRootProps['positioning']>['placement'];
+    /** The full, untruncated text. */
     text: string;
 };
+/**
+ * Reveals text that its container had to truncate. Light, roomy (up to 800px) and plain — it repeats
+ * content the user can already partly see, so it carries no icon, link or action.
+ *
+ * The content renders in a portal, which matters more here than elsewhere: the trigger lives in a
+ * clipping container by definition, and an inline tooltip would be cut off by the very `overflow`
+ * that truncated the text. Dialogs turn the portal off through `BitkitPortalContext`;
+ * `disablePortal` is the manual override.
+ */
 declare const BitkitOverflowTooltip: {
-    ({ children, disabled, placement, text }: BitkitOverflowTooltipProps): import("react").JSX.Element;
+    ({ children, disablePortal, disabled, placement, text, }: BitkitOverflowTooltipProps): import("react").JSX.Element;
     displayName: string;
 };
 export default BitkitOverflowTooltip;

package/dist/components/BitkitOverflowTooltip/BitkitOverflowTooltip.js

@@ -1,9 +1,21 @@
+import BitkitPortalContext from "../../utilities/BitkitPortalContext.js";
 import { rem } from "../../theme/themeUtils.js";
-import { useRef } from "react";
+import { useContext, useRef } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { Portal } from "@chakra-ui/react/portal";
 import { Tooltip } from "@chakra-ui/react/tooltip";
 //#region lib/components/BitkitOverflowTooltip/BitkitOverflowTooltip.tsx
-var BitkitOverflowTooltip = ({ children, disabled, placement = "right", text }) => {
+/**
+* Reveals text that its container had to truncate. Light, roomy (up to 800px) and plain — it repeats
+* content the user can already partly see, so it carries no icon, link or action.
+*
+* The content renders in a portal, which matters more here than elsewhere: the trigger lives in a
+* clipping container by definition, and an inline tooltip would be cut off by the very `overflow`
+* that truncated the text. Dialogs turn the portal off through `BitkitPortalContext`;
+* `disablePortal` is the manual override.
+*/
+var BitkitOverflowTooltip = ({ children, disablePortal, disabled, placement = "right", text }) => {
+	const { disablePortal: disablePortalFromContext } = useContext(BitkitPortalContext);
 	const triggerRef = useRef(null);
 	return /* @__PURE__ */ jsxs(Tooltip.Root, {
 		disabled,
@@ -22,10 +34,13 @@ var BitkitOverflowTooltip = ({ children, disabled, placement = "right", text })
 			ref: triggerRef,
 			asChild: true,
 			children
-		}), /* @__PURE__ */ jsx(Tooltip.Positioner, { children: /* @__PURE__ */ jsx(Tooltip.Content, {
-			css: { maxWidth: rem(800) },
-			children: text
-		}) })]
+		}), /* @__PURE__ */ jsx(Portal, {
+			disabled: disablePortal || disablePortalFromContext,
+			children: /* @__PURE__ */ jsx(Tooltip.Positioner, { children: /* @__PURE__ */ jsx(Tooltip.Content, {
+				css: { maxWidth: rem(800) },
+				children: text
+			}) })
+		})]
 	});
 };
 BitkitOverflowTooltip.displayName = "BitkitOverflowTooltip";

package/dist/components/BitkitOverflowTooltip/BitkitOverflowTooltip.js.map

@@ -1 +1 @@
-{"version":3,"file":"BitkitOverflowTooltip.js","names":[],"sources":["../../../lib/components/BitkitOverflowTooltip/BitkitOverflowTooltip.tsx"],"sourcesContent":["import { Tooltip, type TooltipRootProps } from '@chakra-ui/react/tooltip';\nimport { type ReactNode, type Ref, useRef } from 'react';\n\nimport { rem } from '../../theme/themeUtils';\n\nexport type BitkitOverflowTooltipProps = {\n  children: ReactNode;\n  disabled?: TooltipRootProps['disabled'];\n  placement?: NonNullable<TooltipRootProps['positioning']>['placement'];\n  text: string;\n};\n\nconst BitkitOverflowTooltip = ({ children, disabled, placement = 'right', text }: BitkitOverflowTooltipProps) => {\n  // Anchor positioning to the trigger node by ref rather than relying on Zag's\n  // id/data-scope lookup. When the trigger is also wrapped by another `asChild`\n  // trigger (e.g. Menu.Trigger), the outer trigger's id and data-scope/data-part\n  // overwrite ours on the shared node, so `getTriggerEl()` can't find it and the\n  // tooltip loses its anchor. `getAnchorElement` takes precedence over the id\n  // lookup, so this is safe in the standalone case too.\n  const triggerRef = useRef<HTMLElement>(null);\n\n  return (\n    <Tooltip.Root\n      disabled={disabled}\n      paddingSize=\"sm\"\n      positioning={{ getAnchorElement: () => triggerRef.current, placement, offset: { mainAxis: 4, crossAxis: 0 } }}\n      textStyle=\"sm/regular\"\n      variant=\"light\"\n    >\n      <Tooltip.Trigger ref={triggerRef as Ref<HTMLButtonElement>} asChild>\n        {children}\n      </Tooltip.Trigger>\n      <Tooltip.Positioner>\n        <Tooltip.Content css={{ maxWidth: rem(800) }}>{text}</Tooltip.Content>\n      </Tooltip.Positioner>\n    </Tooltip.Root>\n  );\n};\n\nBitkitOverflowTooltip.displayName = 'BitkitOverflowTooltip';\n\nexport default BitkitOverflowTooltip;\n"],"mappings":";;;;;AAYA,IAAM,yBAAyB,EAAE,UAAU,UAAU,YAAY,SAAS,WAAuC;CAO/G,MAAM,aAAa,OAAoB,IAAI;CAE3C,OACE,qBAAC,QAAQ,MAAT;EACY;EACV,aAAY;EACZ,aAAa;GAAE,wBAAwB,WAAW;GAAS;GAAW,QAAQ;IAAE,UAAU;IAAG,WAAW;GAAE;EAAE;EAC5G,WAAU;EACV,SAAQ;YALV,CAOE,oBAAC,QAAQ,SAAT;GAAiB,KAAK;GAAsC,SAAA;GACzD;EACc,CAAA,GACjB,oBAAC,QAAQ,YAAT,EAAA,UACE,oBAAC,QAAQ,SAAT;GAAiB,KAAK,EAAE,UAAU,IAAI,GAAG,EAAE;aAAI;EAAsB,CAAA,EACnD,CAAA,CACR;;AAElB;AAEA,sBAAsB,cAAc"}
+{"version":3,"file":"BitkitOverflowTooltip.js","names":[],"sources":["../../../lib/components/BitkitOverflowTooltip/BitkitOverflowTooltip.tsx"],"sourcesContent":["import { Portal } from '@chakra-ui/react/portal';\nimport { Tooltip, type TooltipRootProps } from '@chakra-ui/react/tooltip';\nimport { type ReactNode, type Ref, useContext, useRef } from 'react';\n\nimport { rem } from '../../theme/themeUtils';\nimport BitkitPortalContext from '../../utilities/BitkitPortalContext';\n\nexport type BitkitOverflowTooltipProps = {\n  /** The truncated element the tooltip is anchored to. Rendered via `asChild`, so it must accept a ref. */\n  children: ReactNode;\n  /** Render the trigger without a tooltip — pass `true` when the text isn't actually truncated. */\n  disabled?: TooltipRootProps['disabled'];\n  /**\n   * Render the tooltip inline instead of in a portal. Only needed when it must stay inside its\n   * parent's DOM subtree — a dialog already sets this for you.\n   */\n  disablePortal?: boolean;\n  /** Where the tooltip sits relative to the trigger (default `right`). It flips if space is short. */\n  placement?: NonNullable<TooltipRootProps['positioning']>['placement'];\n  /** The full, untruncated text. */\n  text: string;\n};\n\n/**\n * Reveals text that its container had to truncate. Light, roomy (up to 800px) and plain — it repeats\n * content the user can already partly see, so it carries no icon, link or action.\n *\n * The content renders in a portal, which matters more here than elsewhere: the trigger lives in a\n * clipping container by definition, and an inline tooltip would be cut off by the very `overflow`\n * that truncated the text. Dialogs turn the portal off through `BitkitPortalContext`;\n * `disablePortal` is the manual override.\n */\nconst BitkitOverflowTooltip = ({\n  children,\n  disablePortal,\n  disabled,\n  placement = 'right',\n  text,\n}: BitkitOverflowTooltipProps) => {\n  const { disablePortal: disablePortalFromContext } = useContext(BitkitPortalContext);\n\n  // Anchor positioning to the trigger node by ref rather than relying on Zag's\n  // id/data-scope lookup. When the trigger is also wrapped by another `asChild`\n  // trigger (e.g. Menu.Trigger), the outer trigger's id and data-scope/data-part\n  // overwrite ours on the shared node, so `getTriggerEl()` can't find it and the\n  // tooltip loses its anchor. `getAnchorElement` takes precedence over the id\n  // lookup, so this is safe in the standalone case too.\n  const triggerRef = useRef<HTMLElement>(null);\n\n  return (\n    <Tooltip.Root\n      disabled={disabled}\n      paddingSize=\"sm\"\n      positioning={{ getAnchorElement: () => triggerRef.current, placement, offset: { mainAxis: 4, crossAxis: 0 } }}\n      textStyle=\"sm/regular\"\n      variant=\"light\"\n    >\n      <Tooltip.Trigger ref={triggerRef as Ref<HTMLButtonElement>} asChild>\n        {children}\n      </Tooltip.Trigger>\n      <Portal disabled={disablePortal || disablePortalFromContext}>\n        <Tooltip.Positioner>\n          <Tooltip.Content css={{ maxWidth: rem(800) }}>{text}</Tooltip.Content>\n        </Tooltip.Positioner>\n      </Portal>\n    </Tooltip.Root>\n  );\n};\n\nBitkitOverflowTooltip.displayName = 'BitkitOverflowTooltip';\n\nexport default BitkitOverflowTooltip;\n"],"mappings":";;;;;;;;;;;;;;;;AAgCA,IAAM,yBAAyB,EAC7B,UACA,eACA,UACA,YAAY,SACZ,WACgC;CAChC,MAAM,EAAE,eAAe,6BAA6B,WAAW,mBAAmB;CAQlF,MAAM,aAAa,OAAoB,IAAI;CAE3C,OACE,qBAAC,QAAQ,MAAT;EACY;EACV,aAAY;EACZ,aAAa;GAAE,wBAAwB,WAAW;GAAS;GAAW,QAAQ;IAAE,UAAU;IAAG,WAAW;GAAE;EAAE;EAC5G,WAAU;EACV,SAAQ;YALV,CAOE,oBAAC,QAAQ,SAAT;GAAiB,KAAK;GAAsC,SAAA;GACzD;EACc,CAAA,GACjB,oBAAC,QAAD;GAAQ,UAAU,iBAAiB;aACjC,oBAAC,QAAQ,YAAT,EAAA,UACE,oBAAC,QAAQ,SAAT;IAAiB,KAAK,EAAE,UAAU,IAAI,GAAG,EAAE;cAAI;GAAsB,CAAA,EACnD,CAAA;EACd,CAAA,CACI;;AAElB;AAEA,sBAAsB,cAAc"}

package/dist/components/BitkitSelect/BitkitSelect.js

@@ -1,10 +1,10 @@
 import AssetSelectChevron from "../../utilities/AssetSelectChevron.js";
 import IconErrorCircleFilled from "../../icons/IconErrorCircleFilled.js";
 import IconWarningYellow from "../../icons/IconWarningYellow.js";
+import BitkitPortalContext from "../../utilities/BitkitPortalContext.js";
 import { withSubComponents } from "../../utilities/withSubComponents.js";
 import BitkitSelectMenuAction from "../BitkitSelectMenu/BitkitSelectMenuAction.js";
 import BitkitSelectMenu from "../BitkitSelectMenu/BitkitSelectMenu.js";
-import BitkitPortalContext from "../../utilities/BitkitPortalContext.js";
 import BitkitField from "../BitkitField/BitkitField.js";
 import { forwardRef, useContext } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";

package/dist/components/BitkitTooltip/BitkitTooltip.d.ts

@@ -12,6 +12,11 @@ export type BitkitTooltipProps = {
     children: ReactNode;
     /** Dismiss the tooltip when the trigger is clicked. */
     closeOnClick?: TooltipRootProps['closeOnClick'];
+    /**
+     * Render the tooltip inline instead of in a portal. Only needed when it must stay inside its
+     * parent's DOM subtree — a dialog already sets this for you.
+     */
+    disablePortal?: boolean;
     /** Render the trigger without a tooltip — for hints that only apply in some states. */
     disabled?: TooltipRootProps['disabled'];
     /**
@@ -43,9 +48,14 @@ export type BitkitTooltipProps = {
  *
  * Setting either of those two makes the tooltip *interactive*: it gains roomier padding and stays
  * open while the pointer travels into it, so the link and the button can actually be reached.
+ *
+ * The content renders in a portal, so it escapes any ancestor that traps stacking (`isolation`,
+ * `transform`, a `z-index`ed positioned box) or clips overflow. Dialogs turn that off through
+ * `BitkitPortalContext` so an interactive tooltip stays inside the focus trap; `disablePortal` is
+ * the manual override.
  */
 declare const BitkitTooltip: {
-    ({ button, children, closeOnClick, disabled, icon: Icon, learnMoreTarget, learnMoreUrl, onOpenChange, open, openDelay, placement, text, }: BitkitTooltipProps): import("react").JSX.Element;
+    ({ button, children, closeOnClick, disablePortal, disabled, icon: Icon, learnMoreTarget, learnMoreUrl, onOpenChange, open, openDelay, placement, text, }: BitkitTooltipProps): import("react").JSX.Element;
     displayName: string;
 };
 export default BitkitTooltip;

package/dist/components/BitkitTooltip/BitkitTooltip.js

@@ -1,8 +1,10 @@
+import BitkitPortalContext from "../../utilities/BitkitPortalContext.js";
 import { rem } from "../../theme/themeUtils.js";
 import BitkitColorButton from "../BitkitColorButton/BitkitColorButton.js";
 import { Box } from "@chakra-ui/react/box";
-import { useRef } from "react";
+import { useContext, useRef } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { Portal } from "@chakra-ui/react/portal";
 import { Tooltip } from "@chakra-ui/react/tooltip";
 import { Link } from "@chakra-ui/react/link";
 //#region lib/components/BitkitTooltip/BitkitTooltip.tsx
@@ -12,8 +14,14 @@ import { Link } from "@chakra-ui/react/link";
 *
 * Setting either of those two makes the tooltip *interactive*: it gains roomier padding and stays
 * open while the pointer travels into it, so the link and the button can actually be reached.
+*
+* The content renders in a portal, so it escapes any ancestor that traps stacking (`isolation`,
+* `transform`, a `z-index`ed positioned box) or clips overflow. Dialogs turn that off through
+* `BitkitPortalContext` so an interactive tooltip stays inside the focus trap; `disablePortal` is
+* the manual override.
 */
-var BitkitTooltip = ({ button, children, closeOnClick, disabled, icon: Icon, learnMoreTarget, learnMoreUrl, onOpenChange, open, openDelay, placement = "top", text }) => {
+var BitkitTooltip = ({ button, children, closeOnClick, disablePortal, disabled, icon: Icon, learnMoreTarget, learnMoreUrl, onOpenChange, open, openDelay, placement = "top", text }) => {
+	const { disablePortal: disablePortalFromContext } = useContext(BitkitPortalContext);
 	const isInteractive = !!learnMoreUrl || !!button;
 	const triggerRef = useRef(null);
 	return /* @__PURE__ */ jsxs(Tooltip.Root, {
@@ -36,37 +44,40 @@ var BitkitTooltip = ({ button, children, closeOnClick, disabled, icon: Icon, lea
 			ref: triggerRef,
 			asChild: true,
 			children
-		}), /* @__PURE__ */ jsx(Tooltip.Positioner, { children: /* @__PURE__ */ jsxs(Tooltip.Content, {
-			maxWidth: rem(320),
-			css: isInteractive && { minWidth: rem(240) },
-			children: [
-				/* @__PURE__ */ jsx(Tooltip.Arrow, { children: /* @__PURE__ */ jsx(Tooltip.ArrowTip, {}) }),
-				/* @__PURE__ */ jsxs(Box, {
-					display: "flex",
-					gap: "8",
-					children: [text, Icon && /* @__PURE__ */ jsx(Icon, {
-						flexShrink: "0",
-						size: "16"
-					})]
-				}),
-				isInteractive && /* @__PURE__ */ jsxs(Box, {
-					alignItems: "center",
-					display: "flex",
-					gap: "16",
-					marginBlockStart: "16",
-					children: [learnMoreUrl && /* @__PURE__ */ jsx(Link, {
-						color: "color/purple/highlight",
-						href: learnMoreUrl,
-						rel: learnMoreTarget === "_blank" ? "noopener noreferrer" : void 0,
-						target: learnMoreTarget,
-						children: "Learn more"
-					}), button && /* @__PURE__ */ jsx(BitkitColorButton, {
-						css: { marginInlineStart: "auto" },
-						...button
-					})]
-				})
-			]
-		}) })]
+		}), /* @__PURE__ */ jsx(Portal, {
+			disabled: disablePortal || disablePortalFromContext,
+			children: /* @__PURE__ */ jsx(Tooltip.Positioner, { children: /* @__PURE__ */ jsxs(Tooltip.Content, {
+				maxWidth: rem(320),
+				css: isInteractive && { minWidth: rem(240) },
+				children: [
+					/* @__PURE__ */ jsx(Tooltip.Arrow, { children: /* @__PURE__ */ jsx(Tooltip.ArrowTip, {}) }),
+					/* @__PURE__ */ jsxs(Box, {
+						display: "flex",
+						gap: "8",
+						children: [text, Icon && /* @__PURE__ */ jsx(Icon, {
+							flexShrink: "0",
+							size: "16"
+						})]
+					}),
+					isInteractive && /* @__PURE__ */ jsxs(Box, {
+						alignItems: "center",
+						display: "flex",
+						gap: "16",
+						marginBlockStart: "16",
+						children: [learnMoreUrl && /* @__PURE__ */ jsx(Link, {
+							color: "color/purple/highlight",
+							href: learnMoreUrl,
+							rel: learnMoreTarget === "_blank" ? "noopener noreferrer" : void 0,
+							target: learnMoreTarget,
+							children: "Learn more"
+						}), button && /* @__PURE__ */ jsx(BitkitColorButton, {
+							css: { marginInlineStart: "auto" },
+							...button
+						})]
+					})
+				]
+			}) })
+		})]
 	});
 };
 BitkitTooltip.displayName = "BitkitTooltip";

package/dist/components/BitkitTooltip/BitkitTooltip.js.map

@@ -1 +1 @@
-{"version":3,"file":"BitkitTooltip.js","names":[],"sources":["../../../lib/components/BitkitTooltip/BitkitTooltip.tsx"],"sourcesContent":["import { Box } from '@chakra-ui/react/box';\nimport { Link } from '@chakra-ui/react/link';\nimport { Tooltip, type TooltipRootProps } from '@chakra-ui/react/tooltip';\nimport { type ReactNode, type Ref, useRef } from 'react';\n\nimport { type BitkitIconComponent } from '../../icons';\nimport { rem } from '../../theme/themeUtils';\nimport BitkitColorButton, { type BitkitColorButtonProps } from '../BitkitColorButton/BitkitColorButton';\n\nexport type BitkitTooltipProps = {\n  /**\n   * Action button rendered at the end of the tooltip. Setting it makes the tooltip interactive, so\n   * the pointer can move into the tooltip without dismissing it.\n   */\n  button?: BitkitColorButtonProps;\n  /** The trigger the tooltip is anchored to. Rendered via `asChild`, so it must accept a ref. */\n  children: ReactNode;\n  /** Dismiss the tooltip when the trigger is clicked. */\n  closeOnClick?: TooltipRootProps['closeOnClick'];\n  /** Render the trigger without a tooltip — for hints that only apply in some states. */\n  disabled?: TooltipRootProps['disabled'];\n  /**\n   * Icon rendered after `text`, at size 16. Use it for the affordance the tooltip describes — an\n   * `IconArrowNortheast` when the trigger opens something in a new tab, for instance.\n   */\n  icon?: BitkitIconComponent;\n  /** Target for the \"Learn more\" link. `_blank` also sets `rel=\"noopener noreferrer\"`. */\n  learnMoreTarget?: HTMLAnchorElement['target'];\n  /**\n   * Adds a \"Learn more\" link pointing here. Setting it makes the tooltip interactive, so the\n   * pointer can move into the tooltip to reach the link.\n   */\n  learnMoreUrl?: string;\n  /** Called when the tooltip opens or closes, including from hover and focus. */\n  onOpenChange?: TooltipRootProps['onOpenChange'];\n  /** Controlled open state. Leave unset to let hover and focus drive it. */\n  open?: TooltipRootProps['open'];\n  /** Delay in ms before an uncontrolled tooltip opens on hover. */\n  openDelay?: TooltipRootProps['openDelay'];\n  /** Where the tooltip sits relative to the trigger (default `top`). It flips if space is short. */\n  placement?: NonNullable<TooltipRootProps['positioning']>['placement'];\n  /** The tooltip's text. Plain string only — use `icon`, `learnMoreUrl` and `button` for the rest. */\n  text: string;\n};\n\n/**\n * A hover/focus tooltip anchored to its child. `text` carries the message, `icon` appends a glyph\n * after it, and `learnMoreUrl`/`button` add a link and an action.\n *\n * Setting either of those two makes the tooltip *interactive*: it gains roomier padding and stays\n * open while the pointer travels into it, so the link and the button can actually be reached.\n */\nconst BitkitTooltip = ({\n  button,\n  children,\n  closeOnClick,\n  disabled,\n  icon: Icon,\n  learnMoreTarget,\n  learnMoreUrl,\n  onOpenChange,\n  open,\n  openDelay,\n  placement = 'top',\n  text,\n}: BitkitTooltipProps) => {\n  const isInteractive = !!learnMoreUrl || !!button;\n\n  // Anchor positioning to the trigger node by ref rather than relying on Zag's\n  // id/data-scope lookup. When the trigger is also wrapped by another `asChild`\n  // trigger (e.g. Menu.Trigger), the outer trigger's id and data-scope/data-part\n  // overwrite ours on the shared node, so `getTriggerEl()` can't find it and the\n  // tooltip loses its anchor. `getAnchorElement` takes precedence over the id\n  // lookup, so this is safe in the standalone case too.\n  const triggerRef = useRef<HTMLElement>(null);\n\n  return (\n    <Tooltip.Root\n      closeOnClick={closeOnClick}\n      disabled={disabled}\n      interactive={isInteractive || undefined}\n      onOpenChange={onOpenChange}\n      open={open}\n      openDelay={openDelay}\n      paddingSize={isInteractive ? 'lg' : undefined}\n      positioning={{ getAnchorElement: () => triggerRef.current, placement, offset: { mainAxis: 4, crossAxis: 0 } }}\n    >\n      <Tooltip.Trigger ref={triggerRef as Ref<HTMLButtonElement>} asChild>\n        {children}\n      </Tooltip.Trigger>\n      <Tooltip.Positioner>\n        <Tooltip.Content maxWidth={rem(320)} css={isInteractive && { minWidth: rem(240) }}>\n          <Tooltip.Arrow>\n            <Tooltip.ArrowTip />\n          </Tooltip.Arrow>\n          <Box display=\"flex\" gap=\"8\">\n            {text}\n            {Icon && <Icon flexShrink=\"0\" size=\"16\" />}\n          </Box>\n          {isInteractive && (\n            <Box alignItems=\"center\" display=\"flex\" gap=\"16\" marginBlockStart=\"16\">\n              {learnMoreUrl && (\n                <Link\n                  color=\"color/purple/highlight\"\n                  href={learnMoreUrl}\n                  rel={learnMoreTarget === '_blank' ? 'noopener noreferrer' : undefined}\n                  target={learnMoreTarget}\n                >\n                  Learn more\n                </Link>\n              )}\n              {button && <BitkitColorButton css={{ marginInlineStart: 'auto' }} {...button} />}\n            </Box>\n          )}\n        </Tooltip.Content>\n      </Tooltip.Positioner>\n    </Tooltip.Root>\n  );\n};\n\nBitkitTooltip.displayName = 'BitkitTooltip';\n\nexport default BitkitTooltip;\n"],"mappings":";;;;;;;;;;;;;;;AAoDA,IAAM,iBAAiB,EACrB,QACA,UACA,cACA,UACA,MAAM,MACN,iBACA,cACA,cACA,MACA,WACA,YAAY,OACZ,WACwB;CACxB,MAAM,gBAAgB,CAAC,CAAC,gBAAgB,CAAC,CAAC;CAQ1C,MAAM,aAAa,OAAoB,IAAI;CAE3C,OACE,qBAAC,QAAQ,MAAT;EACgB;EACJ;EACV,aAAa,iBAAiB,KAAA;EAChB;EACR;EACK;EACX,aAAa,gBAAgB,OAAO,KAAA;EACpC,aAAa;GAAE,wBAAwB,WAAW;GAAS;GAAW,QAAQ;IAAE,UAAU;IAAG,WAAW;GAAE;EAAE;YAR9G,CAUE,oBAAC,QAAQ,SAAT;GAAiB,KAAK;GAAsC,SAAA;GACzD;EACc,CAAA,GACjB,oBAAC,QAAQ,YAAT,EAAA,UACE,qBAAC,QAAQ,SAAT;GAAiB,UAAU,IAAI,GAAG;GAAG,KAAK,iBAAiB,EAAE,UAAU,IAAI,GAAG,EAAE;aAAhF;IACE,oBAAC,QAAQ,OAAT,EAAA,UACE,oBAAC,QAAQ,UAAT,CAAmB,CAAA,EACN,CAAA;IACf,qBAAC,KAAD;KAAK,SAAQ;KAAO,KAAI;eAAxB,CACG,MACA,QAAQ,oBAAC,MAAD;MAAM,YAAW;MAAI,MAAK;KAAM,CAAA,CACtC;;IACJ,iBACC,qBAAC,KAAD;KAAK,YAAW;KAAS,SAAQ;KAAO,KAAI;KAAK,kBAAiB;eAAlE,CACG,gBACC,oBAAC,MAAD;MACE,OAAM;MACN,MAAM;MACN,KAAK,oBAAoB,WAAW,wBAAwB,KAAA;MAC5D,QAAQ;gBACT;KAEK,CAAA,GAEP,UAAU,oBAAC,mBAAD;MAAmB,KAAK,EAAE,mBAAmB,OAAO;MAAG,GAAI;KAAS,CAAA,CAC5E;;GAEQ;KACC,CAAA,CACR;;AAElB;AAEA,cAAc,cAAc"}
+{"version":3,"file":"BitkitTooltip.js","names":[],"sources":["../../../lib/components/BitkitTooltip/BitkitTooltip.tsx"],"sourcesContent":["import { Box } from '@chakra-ui/react/box';\nimport { Link } from '@chakra-ui/react/link';\nimport { Portal } from '@chakra-ui/react/portal';\nimport { Tooltip, type TooltipRootProps } from '@chakra-ui/react/tooltip';\nimport { type ReactNode, type Ref, useContext, useRef } from 'react';\n\nimport { type BitkitIconComponent } from '../../icons';\nimport { rem } from '../../theme/themeUtils';\nimport BitkitPortalContext from '../../utilities/BitkitPortalContext';\nimport BitkitColorButton, { type BitkitColorButtonProps } from '../BitkitColorButton/BitkitColorButton';\n\nexport type BitkitTooltipProps = {\n  /**\n   * Action button rendered at the end of the tooltip. Setting it makes the tooltip interactive, so\n   * the pointer can move into the tooltip without dismissing it.\n   */\n  button?: BitkitColorButtonProps;\n  /** The trigger the tooltip is anchored to. Rendered via `asChild`, so it must accept a ref. */\n  children: ReactNode;\n  /** Dismiss the tooltip when the trigger is clicked. */\n  closeOnClick?: TooltipRootProps['closeOnClick'];\n  /**\n   * Render the tooltip inline instead of in a portal. Only needed when it must stay inside its\n   * parent's DOM subtree — a dialog already sets this for you.\n   */\n  disablePortal?: boolean;\n  /** Render the trigger without a tooltip — for hints that only apply in some states. */\n  disabled?: TooltipRootProps['disabled'];\n  /**\n   * Icon rendered after `text`, at size 16. Use it for the affordance the tooltip describes — an\n   * `IconArrowNortheast` when the trigger opens something in a new tab, for instance.\n   */\n  icon?: BitkitIconComponent;\n  /** Target for the \"Learn more\" link. `_blank` also sets `rel=\"noopener noreferrer\"`. */\n  learnMoreTarget?: HTMLAnchorElement['target'];\n  /**\n   * Adds a \"Learn more\" link pointing here. Setting it makes the tooltip interactive, so the\n   * pointer can move into the tooltip to reach the link.\n   */\n  learnMoreUrl?: string;\n  /** Called when the tooltip opens or closes, including from hover and focus. */\n  onOpenChange?: TooltipRootProps['onOpenChange'];\n  /** Controlled open state. Leave unset to let hover and focus drive it. */\n  open?: TooltipRootProps['open'];\n  /** Delay in ms before an uncontrolled tooltip opens on hover. */\n  openDelay?: TooltipRootProps['openDelay'];\n  /** Where the tooltip sits relative to the trigger (default `top`). It flips if space is short. */\n  placement?: NonNullable<TooltipRootProps['positioning']>['placement'];\n  /** The tooltip's text. Plain string only — use `icon`, `learnMoreUrl` and `button` for the rest. */\n  text: string;\n};\n\n/**\n * A hover/focus tooltip anchored to its child. `text` carries the message, `icon` appends a glyph\n * after it, and `learnMoreUrl`/`button` add a link and an action.\n *\n * Setting either of those two makes the tooltip *interactive*: it gains roomier padding and stays\n * open while the pointer travels into it, so the link and the button can actually be reached.\n *\n * The content renders in a portal, so it escapes any ancestor that traps stacking (`isolation`,\n * `transform`, a `z-index`ed positioned box) or clips overflow. Dialogs turn that off through\n * `BitkitPortalContext` so an interactive tooltip stays inside the focus trap; `disablePortal` is\n * the manual override.\n */\nconst BitkitTooltip = ({\n  button,\n  children,\n  closeOnClick,\n  disablePortal,\n  disabled,\n  icon: Icon,\n  learnMoreTarget,\n  learnMoreUrl,\n  onOpenChange,\n  open,\n  openDelay,\n  placement = 'top',\n  text,\n}: BitkitTooltipProps) => {\n  const { disablePortal: disablePortalFromContext } = useContext(BitkitPortalContext);\n  const isInteractive = !!learnMoreUrl || !!button;\n\n  // Anchor positioning to the trigger node by ref rather than relying on Zag's\n  // id/data-scope lookup. When the trigger is also wrapped by another `asChild`\n  // trigger (e.g. Menu.Trigger), the outer trigger's id and data-scope/data-part\n  // overwrite ours on the shared node, so `getTriggerEl()` can't find it and the\n  // tooltip loses its anchor. `getAnchorElement` takes precedence over the id\n  // lookup, so this is safe in the standalone case too.\n  const triggerRef = useRef<HTMLElement>(null);\n\n  return (\n    <Tooltip.Root\n      closeOnClick={closeOnClick}\n      disabled={disabled}\n      interactive={isInteractive || undefined}\n      onOpenChange={onOpenChange}\n      open={open}\n      openDelay={openDelay}\n      paddingSize={isInteractive ? 'lg' : undefined}\n      positioning={{ getAnchorElement: () => triggerRef.current, placement, offset: { mainAxis: 4, crossAxis: 0 } }}\n    >\n      <Tooltip.Trigger ref={triggerRef as Ref<HTMLButtonElement>} asChild>\n        {children}\n      </Tooltip.Trigger>\n      <Portal disabled={disablePortal || disablePortalFromContext}>\n        <Tooltip.Positioner>\n          <Tooltip.Content maxWidth={rem(320)} css={isInteractive && { minWidth: rem(240) }}>\n            <Tooltip.Arrow>\n              <Tooltip.ArrowTip />\n            </Tooltip.Arrow>\n            <Box display=\"flex\" gap=\"8\">\n              {text}\n              {Icon && <Icon flexShrink=\"0\" size=\"16\" />}\n            </Box>\n            {isInteractive && (\n              <Box alignItems=\"center\" display=\"flex\" gap=\"16\" marginBlockStart=\"16\">\n                {learnMoreUrl && (\n                  <Link\n                    color=\"color/purple/highlight\"\n                    href={learnMoreUrl}\n                    rel={learnMoreTarget === '_blank' ? 'noopener noreferrer' : undefined}\n                    target={learnMoreTarget}\n                  >\n                    Learn more\n                  </Link>\n                )}\n                {button && <BitkitColorButton css={{ marginInlineStart: 'auto' }} {...button} />}\n              </Box>\n            )}\n          </Tooltip.Content>\n        </Tooltip.Positioner>\n      </Portal>\n    </Tooltip.Root>\n  );\n};\n\nBitkitTooltip.displayName = 'BitkitTooltip';\n\nexport default BitkitTooltip;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAgEA,IAAM,iBAAiB,EACrB,QACA,UACA,cACA,eACA,UACA,MAAM,MACN,iBACA,cACA,cACA,MACA,WACA,YAAY,OACZ,WACwB;CACxB,MAAM,EAAE,eAAe,6BAA6B,WAAW,mBAAmB;CAClF,MAAM,gBAAgB,CAAC,CAAC,gBAAgB,CAAC,CAAC;CAQ1C,MAAM,aAAa,OAAoB,IAAI;CAE3C,OACE,qBAAC,QAAQ,MAAT;EACgB;EACJ;EACV,aAAa,iBAAiB,KAAA;EAChB;EACR;EACK;EACX,aAAa,gBAAgB,OAAO,KAAA;EACpC,aAAa;GAAE,wBAAwB,WAAW;GAAS;GAAW,QAAQ;IAAE,UAAU;IAAG,WAAW;GAAE;EAAE;YAR9G,CAUE,oBAAC,QAAQ,SAAT;GAAiB,KAAK;GAAsC,SAAA;GACzD;EACc,CAAA,GACjB,oBAAC,QAAD;GAAQ,UAAU,iBAAiB;aACjC,oBAAC,QAAQ,YAAT,EAAA,UACE,qBAAC,QAAQ,SAAT;IAAiB,UAAU,IAAI,GAAG;IAAG,KAAK,iBAAiB,EAAE,UAAU,IAAI,GAAG,EAAE;cAAhF;KACE,oBAAC,QAAQ,OAAT,EAAA,UACE,oBAAC,QAAQ,UAAT,CAAmB,CAAA,EACN,CAAA;KACf,qBAAC,KAAD;MAAK,SAAQ;MAAO,KAAI;gBAAxB,CACG,MACA,QAAQ,oBAAC,MAAD;OAAM,YAAW;OAAI,MAAK;MAAM,CAAA,CACtC;;KACJ,iBACC,qBAAC,KAAD;MAAK,YAAW;MAAS,SAAQ;MAAO,KAAI;MAAK,kBAAiB;gBAAlE,CACG,gBACC,oBAAC,MAAD;OACE,OAAM;OACN,MAAM;OACN,KAAK,oBAAoB,WAAW,wBAAwB,KAAA;OAC5D,QAAQ;iBACT;MAEK,CAAA,GAEP,UAAU,oBAAC,mBAAD;OAAmB,KAAK,EAAE,mBAAmB,OAAO;OAAG,GAAI;MAAS,CAAA,CAC5E;;IAEQ;MACC,CAAA;EACd,CAAA,CACI;;AAElB;AAEA,cAAc,cAAc"}

package/docs/v1-to-v2-migration-guide.md

@@ -105,12 +105,14 @@ Chakra v2 → v3 prop changes on primitives:
 
 | v1 | v2 |
 |----|----|
-| `Badge colorScheme="positive"` | `BitkitBadge colorPalette="green"` |
-| `Badge colorScheme="negative"` | `BitkitBadge colorPalette="red"` |
-| `Badge colorScheme="warning"` | `BitkitBadge colorPalette="yellow"` |
-| `Badge colorScheme="progress"` | `BitkitBadge colorPalette="purple"` |
+| `Badge colorScheme="positive"` | `BitkitBadge colorVariant="green"` |
+| `Badge colorScheme="negative"` | `BitkitBadge colorVariant="red"` |
+| `Badge colorScheme="warning"` | `BitkitBadge colorVariant="yellow"` |
+| `Badge colorScheme="progress"` | `BitkitBadge colorVariant="purple"` |
 | `Tag` | `BitkitTag` |
 
+The color prop is `colorVariant`, not Chakra's `colorPalette` — `BitkitBadge` deliberately omits `colorPalette` from its props. Available values: `neutral`, `purple`, `blue`, `green`, `yellow`, `red`, `orange`, `turquoise`, `ai-gradient`.
+
 ### Toast
 
 ```tsx
@@ -134,16 +136,20 @@ createBitkitToast({ variant: 'critical', titleText: 'Oops', messageText: 'Someth
 </Dialog>
 
 // v2
-<BitkitDialog open={open} onOpenChange={({ open }) => setOpen(open)}>
-  <BitkitDialog.Body>...</BitkitDialog.Body>
-  <BitkitDialog.Footer>
-    <BitkitDialog.Buttons>...</BitkitDialog.Buttons>
-  </BitkitDialog.Footer>
+<BitkitDialog
+  open={open}
+  onOpenChange={({ open }) => setOpen(open)}
+  title="Title"
+  footerButtons={<BitkitButton onClick={save}>Save</BitkitButton>}
+>
+  ...body...
 </BitkitDialog>
 ```
 
 Key changes: `isOpen` → `open`, `onClose` → `onOpenChange` (receives `{ open: boolean }`).
 
+`BitkitDialog` is a flat component, not a compound one: the body is `children`, the header comes from the required `title`, and the footer is filled via `footerButtons` (the right-aligned button row) and/or `footerContent`. Its only sub-component is `BitkitDialog.ActionTrigger`.
+
 Other prop mappings:
 
 | v1 | v2 |
@@ -151,9 +157,7 @@ Other prop mappings:
 | `isClosable={false}` | `closable={false}` |
 | `onCloseComplete={fn}` | `onExitComplete={fn}` (fires when the close animation finishes) |
 
-`closable={false}` matches v1: the header close button is **rendered but disabled** (kept in place so the header layout stays consistent), **ESC is blocked**, and overlay/outside clicks are ignored (`closeOnInteractOutside` is already `false` by default on `BitkitDialogRoot`). The only way to dismiss the dialog is through an explicit footer action.
-
-If you're composing the lower-level primitives directly, you have to set the same controls explicitly: pass `closeOnEscape={false}` to `BitkitDialogRoot` and `closable={false}` to `BitkitDialogContent`.
+`closable={false}` matches v1: the header close button is **rendered but disabled** (kept in place so the header layout stays consistent) and **ESC is blocked**. Overlay/outside clicks are ignored regardless of `closable` — the dialog always sets `closeOnInteractOutside={false}` internally. With `closable={false}` the only way to dismiss the dialog is through an explicit footer action.
 
 ```tsx
 // Acknowledge-only dialog
@@ -226,12 +230,15 @@ For password fields with an eye-toggle: use `BitkitField` + Chakra v3 `InputGrou
 
 | v1 | v2 |
 |----|----|
-| `Card` | `BitkitCard` |
+| `Card` | `Card.Root` from `@chakra-ui/react/card` |
+| `CardProps` | `CardRootProps` from `@chakra-ui/react/card` |
 | `ExpandableCard` | `BitkitExpandableCard` |
 
-`BitkitCard` accepts `paddingSize` and `elevation` (boolean). Common `BitkitExpandableCard` props: `title`, `secdText`, `size`; use `defaultExpanded` for uncontrolled or `expanded`/`onChange` for controlled usage. It also supports `icon`, `suffix`, and other options — see the component API for the full list.
+There is no plain `BitkitCard` — it was removed in `0.3.239` ([#223](https://github.com/bitrise-io/bitkit-v2/pull/223)), since a closed component earned nothing over the Chakra primitive. A plain card is Chakra's compound `Card.Root` / `Card.Body`.
+
+Common `BitkitExpandableCard` props: `title`, `subtitle`, `size`; use `defaultExpanded` for uncontrolled or `expanded`/`onChange` for controlled usage. It also supports `icon`, `suffix`, and other options — see the component API for the full list.
 
-If your codebase has a local `card.tsx` wrapper around v1 Card (e.g. Shadcn-style `CardHeader`, `CardContent` etc.), remove the wrapper entirely and migrate to `BitkitCard` directly — keeping the wrapper layer just adds indirection you'll need to unwind later.
+If your codebase has a local `card.tsx` wrapper around v1 Card (e.g. Shadcn-style `CardHeader`, `CardContent` etc.), remove the wrapper entirely and use `Card.Root` directly — keeping the wrapper layer just adds indirection you'll need to unwind later.
 
 ### Notifications / Alert
 
@@ -281,9 +288,9 @@ Use `text/*` tokens on `<Text>` (and other text elements), and `icon/*` tokens o
 |---|---|---|
 | `text/secondary` | `icon/secondary` | ✓ |
 | `text/tertiary` | `icon/tertiary` | ✓ |
-| `text/link` | `icon/interactive` | ✓ (both → `sys.interactive`) |
+| `text/link` | `icon/interactive` | ✓ (both → `color/purple/base`) |
 
-**Gotcha**: `icon/link` does **not** exist. Use `icon/interactive` instead — it resolves to the same `sys.interactive` color as `text/link`.
+**Gotcha**: `icon/link` does **not** exist. Use `icon/interactive` instead — it resolves to the same `color/purple/base` as `text/link`.
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bitrise/bitkit-v2",
   "private": false,
-  "version": "0.3.326",
+  "version": "0.3.328",
   "description": "Bitrise Design System Components built with Chakra UI V3",
   "keywords": [
     "react",