@langchain/macaw-components 1.0.0-beta.0

package/dist/utils/prettify-error-payload.js

@@ -0,0 +1,188 @@
+//#region packages/components/src/utils/prettify-error-payload.ts
+var MAX_INPUT_LENGTH = 5e4;
+var MAX_UNESCAPE_PASSES = 6;
+var OPEN_BRACKETS = /* @__PURE__ */ new Set([
+	"{",
+	"[",
+	"("
+]);
+var CLOSE_BRACKETS = /* @__PURE__ */ new Set([
+	"}",
+	"]",
+	")"
+]);
+var STRUCTURAL = /["'{[(]/;
+var ESCAPE_REPLACEMENTS = {
+	n: "\n",
+	r: "\r",
+	t: "	",
+	"\\": "\\",
+	"'": "'",
+	"\"": "\""
+};
+var TRACEBACK_HEADER = "Traceback (most recent call last):";
+var ESCAPED_NEWLINE = /\\n/g;
+var isWhitespace = (ch) => ch === " " || ch === "	" || ch === "\n" || ch === "\r";
+/**
+* Reads the quoted literal starting at `i`, returning it verbatim (delimiters
+* and backslash escapes included) and the index just past the closing quote.
+* An unterminated literal reads to end-of-input; characters are never dropped.
+*/
+var readStringLiteral = (input, i) => {
+	const quote = input[i];
+	let literal = quote;
+	let j = i + 1;
+	while (j < input.length) {
+		const ch = input[j];
+		if (ch === "\\") {
+			literal += ch + (input[j + 1] ?? "");
+			j += 2;
+			continue;
+		}
+		literal += ch;
+		j += 1;
+		if (ch === quote) break;
+	}
+	return {
+		literal,
+		next: j
+	};
+};
+/**
+* Maps each opening-bracket index to whether it should expand onto multiple
+* lines. A bracket expands only when its contents contain a string literal or
+* a nested bracket, so casual prose parentheses ("failed (status 500)") stay
+* inline.
+*/
+var computeExpandMap = (input) => {
+	const expand = /* @__PURE__ */ new Map();
+	const stack = [];
+	let i = 0;
+	while (i < input.length) {
+		const ch = input[i];
+		if (ch === "\"" || ch === "'") {
+			if (stack.length > 0) stack[stack.length - 1].hasSignal = true;
+			i = readStringLiteral(input, i).next;
+			continue;
+		}
+		if (OPEN_BRACKETS.has(ch)) {
+			if (stack.length > 0) stack[stack.length - 1].hasSignal = true;
+			stack.push({
+				index: i,
+				hasSignal: false
+			});
+			i += 1;
+			continue;
+		}
+		if (CLOSE_BRACKETS.has(ch)) {
+			const frame = stack.pop();
+			if (frame !== void 0) expand.set(frame.index, frame.hasSignal);
+			i += 1;
+			continue;
+		}
+		i += 1;
+	}
+	return expand;
+};
+/**
+* Decodes `\n`, `\r`, `\t`, `\\`, `\'`, and `\"` so escaped payloads render
+* readably, repeating while the result still looks structured. Unknown escapes
+* (e.g. `\x41`) are left intact.
+*
+* `preserveQuote` leaves that one quote escaped, so unwrapping a literal's body
+* cannot produce a doubled delimiter (`''hi''` instead of `'hi'`).
+*/
+var decodeEscapedBody = (text, preserveQuote) => {
+	let prev = text;
+	for (let pass = 0; pass < MAX_UNESCAPE_PASSES; pass += 1) {
+		const next = prev.replace(/\\(.)/g, (match, ch) => ch === preserveQuote ? match : ESCAPE_REPLACEMENTS[ch] ?? match);
+		if (next === prev) break;
+		prev = next;
+		if (!STRUCTURAL.test(prev)) break;
+	}
+	return prev;
+};
+var decodeStringLiteral = (literal) => {
+	if (!literal.includes("\\")) return literal;
+	const quote = literal[0];
+	const hasClosingQuote = literal.length > 1 && literal.endsWith(quote);
+	const bodyEnd = hasClosingQuote ? literal.length - 1 : literal.length;
+	return quote + decodeEscapedBody(literal.slice(1, bodyEnd), quote) + (hasClosingQuote ? quote : "");
+};
+/**
+* True when an entire multi-line traceback arrived as one escaped line, rather
+* than as structured data that merely contains escaped newlines in its own
+* string values (those go through the per-literal decode below).
+*/
+var looksFullyEscaped = (input) => {
+	if (input.includes("\n")) return false;
+	if (!input.includes(TRACEBACK_HEADER)) return false;
+	const matches = input.match(ESCAPED_NEWLINE);
+	return matches != null && matches.length >= 2;
+};
+/**
+* Re-indents data structures embedded in an error string so dense single-line
+* dumps (Python `repr()`, JSON, stringified dicts) become readable, decoding
+* backslash escapes inside string literals along the way. Plain prose and
+* inputs with nothing structural are returned unchanged.
+*/
+var prettifyErrorPayload = (input, indentUnit = "  ") => {
+	if (input.length > MAX_INPUT_LENGTH) return input;
+	if (looksFullyEscaped(input)) {
+		const decoded = decodeEscapedBody(input);
+		if (decoded !== input) return decoded;
+	}
+	if (!STRUCTURAL.test(input)) return input;
+	const expand = computeExpandMap(input);
+	if (expand.size === 0) return input;
+	let out = "";
+	let depth = 0;
+	let i = 0;
+	const expanded = [];
+	const newline = () => {
+		let end = out.length;
+		while (end > 0 && (out[end - 1] === " " || out[end - 1] === "	")) end -= 1;
+		out = out.slice(0, end) + "\n" + indentUnit.repeat(depth);
+	};
+	const skipWhitespace = () => {
+		while (i < input.length && isWhitespace(input[i])) i += 1;
+	};
+	while (i < input.length) {
+		const ch = input[i];
+		if (ch === "\"" || ch === "'") {
+			const { literal, next } = readStringLiteral(input, i);
+			out += decodeStringLiteral(literal);
+			i = next;
+		} else if (OPEN_BRACKETS.has(ch)) {
+			const doExpand = expand.get(i) ?? false;
+			expanded.push(doExpand);
+			out += ch;
+			i += 1;
+			if (doExpand) {
+				depth += 1;
+				newline();
+				skipWhitespace();
+			}
+		} else if (CLOSE_BRACKETS.has(ch)) {
+			if (expanded.pop() ?? false) {
+				depth -= 1;
+				newline();
+			}
+			out += ch;
+			i += 1;
+		} else if (ch === "," && (expanded[expanded.length - 1] ?? false)) {
+			out += ch;
+			i += 1;
+			newline();
+			skipWhitespace();
+		} else {
+			out += ch;
+			i += 1;
+		}
+	}
+	return out;
+};
+//#endregion
+export { prettifyErrorPayload };
+
+//# sourceMappingURL=prettify-error-payload.js.map

package/dist/utils/prettify-error-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prettify-error-payload.js","names":[],"sources":["../../src/utils/prettify-error-payload.ts"],"sourcesContent":["// Above this size we skip formatting to avoid event-loop stalls.\nconst MAX_INPUT_LENGTH = 50_000;\n\n// Error payloads are often re-`repr()`'d a few times.\nconst MAX_UNESCAPE_PASSES = 6;\n\nconst OPEN_BRACKETS = new Set(['{', '[', '(']);\nconst CLOSE_BRACKETS = new Set(['}', ']', ')']);\nconst STRUCTURAL = /[\"'{[(]/;\n\nconst ESCAPE_REPLACEMENTS: Record<string, string> = {\n  n: '\\n',\n  r: '\\r',\n  t: '\\t',\n  '\\\\': '\\\\',\n  \"'\": \"'\",\n  '\"': '\"',\n};\n\n// CPython opens every formatted traceback with this exact line.\nconst TRACEBACK_HEADER = 'Traceback (most recent call last):';\nconst ESCAPED_NEWLINE = /\\\\n/g;\n\nconst isWhitespace = (ch: string): boolean =>\n  ch === ' ' || ch === '\\t' || ch === '\\n' || ch === '\\r';\n\n/**\n * Reads the quoted literal starting at `i`, returning it verbatim (delimiters\n * and backslash escapes included) and the index just past the closing quote.\n * An unterminated literal reads to end-of-input; characters are never dropped.\n */\nconst readStringLiteral = (\n  input: string,\n  i: number\n): { literal: string; next: number } => {\n  const quote = input[i];\n  let literal = quote;\n  let j = i + 1;\n  while (j < input.length) {\n    const ch = input[j];\n    if (ch === '\\\\') {\n      literal += ch + (input[j + 1] ?? '');\n      j += 2;\n      continue;\n    }\n    literal += ch;\n    j += 1;\n    if (ch === quote) break;\n  }\n  return { literal, next: j };\n};\n\n/**\n * Maps each opening-bracket index to whether it should expand onto multiple\n * lines. A bracket expands only when its contents contain a string literal or\n * a nested bracket, so casual prose parentheses (\"failed (status 500)\") stay\n * inline.\n */\nconst computeExpandMap = (input: string): Map<number, boolean> => {\n  const expand = new Map<number, boolean>();\n  const stack: { index: number; hasSignal: boolean }[] = [];\n  let i = 0;\n  while (i < input.length) {\n    const ch = input[i];\n    if (ch === '\"' || ch === \"'\") {\n      if (stack.length > 0) stack[stack.length - 1].hasSignal = true;\n      i = readStringLiteral(input, i).next;\n      continue;\n    }\n    if (OPEN_BRACKETS.has(ch)) {\n      if (stack.length > 0) stack[stack.length - 1].hasSignal = true;\n      stack.push({ index: i, hasSignal: false });\n      i += 1;\n      continue;\n    }\n    if (CLOSE_BRACKETS.has(ch)) {\n      const frame = stack.pop();\n      if (frame !== undefined) expand.set(frame.index, frame.hasSignal);\n      i += 1;\n      continue;\n    }\n    i += 1;\n  }\n  return expand;\n};\n\n/**\n * Decodes `\\n`, `\\r`, `\\t`, `\\\\`, `\\'`, and `\\\"` so escaped payloads render\n * readably, repeating while the result still looks structured. Unknown escapes\n * (e.g. `\\x41`) are left intact.\n *\n * `preserveQuote` leaves that one quote escaped, so unwrapping a literal's body\n * cannot produce a doubled delimiter (`''hi''` instead of `'hi'`).\n */\nconst decodeEscapedBody = (text: string, preserveQuote?: string): string => {\n  let prev = text;\n  for (let pass = 0; pass < MAX_UNESCAPE_PASSES; pass += 1) {\n    const next = prev.replace(/\\\\(.)/g, (match, ch: string) =>\n      ch === preserveQuote ? match : (ESCAPE_REPLACEMENTS[ch] ?? match)\n    );\n    if (next === prev) break;\n    prev = next;\n    if (!STRUCTURAL.test(prev)) break;\n  }\n  return prev;\n};\n\nconst decodeStringLiteral = (literal: string): string => {\n  if (!literal.includes('\\\\')) return literal;\n  const quote = literal[0];\n  const hasClosingQuote = literal.length > 1 && literal.endsWith(quote);\n  const bodyEnd = hasClosingQuote ? literal.length - 1 : literal.length;\n  const body = literal.slice(1, bodyEnd);\n  return (\n    quote + decodeEscapedBody(body, quote) + (hasClosingQuote ? quote : '')\n  );\n};\n\n/**\n * True when an entire multi-line traceback arrived as one escaped line, rather\n * than as structured data that merely contains escaped newlines in its own\n * string values (those go through the per-literal decode below).\n */\nconst looksFullyEscaped = (input: string): boolean => {\n  if (input.includes('\\n')) return false;\n  if (!input.includes(TRACEBACK_HEADER)) return false;\n  const matches = input.match(ESCAPED_NEWLINE);\n  return matches != null && matches.length >= 2;\n};\n\n/**\n * Re-indents data structures embedded in an error string so dense single-line\n * dumps (Python `repr()`, JSON, stringified dicts) become readable, decoding\n * backslash escapes inside string literals along the way. Plain prose and\n * inputs with nothing structural are returned unchanged.\n */\nexport const prettifyErrorPayload = (\n  input: string,\n  indentUnit = '  '\n): string => {\n  if (input.length > MAX_INPUT_LENGTH) return input;\n\n  if (looksFullyEscaped(input)) {\n    // Decoding restores the traceback's own line breaks.\n    const decoded = decodeEscapedBody(input);\n    if (decoded !== input) return decoded;\n  }\n\n  if (!STRUCTURAL.test(input)) return input;\n\n  const expand = computeExpandMap(input);\n  if (expand.size === 0) return input;\n\n  let out = '';\n  let depth = 0;\n  let i = 0;\n  const expanded: boolean[] = [];\n\n  const newline = () => {\n    // Drop the trailing whitespace run only, to stay O(1) amortized.\n    let end = out.length;\n    while (end > 0 && (out[end - 1] === ' ' || out[end - 1] === '\\t')) end -= 1;\n    out = out.slice(0, end) + '\\n' + indentUnit.repeat(depth);\n  };\n\n  const skipWhitespace = () => {\n    while (i < input.length && isWhitespace(input[i])) i += 1;\n  };\n\n  while (i < input.length) {\n    const ch = input[i];\n\n    if (ch === '\"' || ch === \"'\") {\n      const { literal, next } = readStringLiteral(input, i);\n      out += decodeStringLiteral(literal);\n      i = next;\n    } else if (OPEN_BRACKETS.has(ch)) {\n      const doExpand = expand.get(i) ?? false;\n      expanded.push(doExpand);\n      out += ch;\n      i += 1;\n      if (doExpand) {\n        depth += 1;\n        newline();\n        skipWhitespace();\n      }\n    } else if (CLOSE_BRACKETS.has(ch)) {\n      if (expanded.pop() ?? false) {\n        depth -= 1;\n        newline();\n      }\n      out += ch;\n      i += 1;\n    } else if (ch === ',' && (expanded[expanded.length - 1] ?? false)) {\n      out += ch;\n      i += 1;\n      newline();\n      skipWhitespace();\n    } else {\n      out += ch;\n      i += 1;\n    }\n  }\n\n  return out;\n};\n"],"mappings":"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"}

package/dist/utils/spacing.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 4-point spacing scale (`space-1` … `space-9`).
+ *
+ * For guidelines on how to use, refer to Storybook:
+ * https://langsmith-design-system.vercel.app/?path=/story/foundations-spacing--scale-and-guidelines
+ *
+ * The scale is surfaced as additive Tailwind utilities via
+ * `tailwind.preset.cjs`, so it is used through the property prefix:
+ * `gap-space-4`, `px-space-6`, `mt-space-2`, etc.
+ * The px mapping mirrors Radix
+ * Themes spacing (https://www.radix-ui.com/themes/docs/theme/spacing).
+ *
+ * This module is the single source of truth. Keep it in sync with
+ * `tailwind.preset.cjs` (theme.extend.spacing `space-*` keys).
+ */
+/** Step → pixel value. The step is an ordinal index, not the px value. */
+export declare const SPACE_SCALE_PX: {
+    readonly 1: 4;
+    readonly 2: 8;
+    readonly 3: 12;
+    readonly 4: 16;
+    readonly 5: 24;
+    readonly 6: 32;
+    readonly 7: 40;
+    readonly 8: 48;
+    readonly 9: 64;
+};
+export type SpaceStep = keyof typeof SPACE_SCALE_PX;
+/** Ordered list of steps, e.g. for rendering the scale. */
+export declare const SPACE_STEPS: (1 | 2 | 3 | 4 | 5 | 6 | 8 | 7 | 9)[];

package/dist/utils/spacing.js

@@ -0,0 +1,34 @@
+//#region packages/components/src/utils/spacing.ts
+/**
+* 4-point spacing scale (`space-1` … `space-9`).
+*
+* For guidelines on how to use, refer to Storybook:
+* https://langsmith-design-system.vercel.app/?path=/story/foundations-spacing--scale-and-guidelines
+*
+* The scale is surfaced as additive Tailwind utilities via
+* `tailwind.preset.cjs`, so it is used through the property prefix:
+* `gap-space-4`, `px-space-6`, `mt-space-2`, etc.
+* The px mapping mirrors Radix
+* Themes spacing (https://www.radix-ui.com/themes/docs/theme/spacing).
+*
+* This module is the single source of truth. Keep it in sync with
+* `tailwind.preset.cjs` (theme.extend.spacing `space-*` keys).
+*/
+/** Step → pixel value. The step is an ordinal index, not the px value. */
+var SPACE_SCALE_PX = {
+	1: 4,
+	2: 8,
+	3: 12,
+	4: 16,
+	5: 24,
+	6: 32,
+	7: 40,
+	8: 48,
+	9: 64
+};
+/** Ordered list of steps, e.g. for rendering the scale. */
+var SPACE_STEPS = Object.keys(SPACE_SCALE_PX).map((step) => Number(step));
+//#endregion
+export { SPACE_SCALE_PX, SPACE_STEPS };
+
+//# sourceMappingURL=spacing.js.map

package/dist/utils/spacing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.js","names":[],"sources":["../../src/utils/spacing.ts"],"sourcesContent":["/**\n * 4-point spacing scale (`space-1` … `space-9`).\n *\n * For guidelines on how to use, refer to Storybook:\n * https://langsmith-design-system.vercel.app/?path=/story/foundations-spacing--scale-and-guidelines\n *\n * The scale is surfaced as additive Tailwind utilities via\n * `tailwind.preset.cjs`, so it is used through the property prefix:\n * `gap-space-4`, `px-space-6`, `mt-space-2`, etc.\n * The px mapping mirrors Radix\n * Themes spacing (https://www.radix-ui.com/themes/docs/theme/spacing).\n *\n * This module is the single source of truth. Keep it in sync with\n * `tailwind.preset.cjs` (theme.extend.spacing `space-*` keys).\n */\n\n/** Step → pixel value. The step is an ordinal index, not the px value. */\nexport const SPACE_SCALE_PX = {\n  1: 4,\n  2: 8,\n  3: 12,\n  4: 16,\n  5: 24,\n  6: 32,\n  7: 40,\n  8: 48,\n  9: 64,\n} as const;\n\nexport type SpaceStep = keyof typeof SPACE_SCALE_PX;\n\n/** Ordered list of steps, e.g. for rendering the scale. */\nexport const SPACE_STEPS = Object.keys(SPACE_SCALE_PX).map(\n  (step) => Number(step) as SpaceStep\n);\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,IAAa,iBAAiB;CAC5B,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;AACL;;AAKA,IAAa,cAAc,OAAO,KAAK,cAAc,CAAC,CAAC,KACpD,SAAS,OAAO,IAAI,CACvB"}

package/dist/utils/useCodeMirror.d.ts

@@ -0,0 +1,7 @@
+import { type CMBundle } from './lazy-codemirror-loader.js';
+/**
+ * Returns the CodeMirror bundle once loaded, or null if still loading.
+ * Initializes synchronously from cache if CM was already loaded (no flicker
+ * on subsequent mounts after the first load).
+ */
+export declare function useCodeMirror(): CMBundle | null;

package/dist/utils/useCodeMirror.js

@@ -0,0 +1,28 @@
+import { getCodeMirror, loadCodeMirror } from "./lazy-codemirror-loader.js";
+import { useEffect, useState } from "react";
+//#region packages/components/src/utils/useCodeMirror.ts
+/**
+* Returns the CodeMirror bundle once loaded, or null if still loading.
+* Initializes synchronously from cache if CM was already loaded (no flicker
+* on subsequent mounts after the first load).
+*/
+function useCodeMirror() {
+	const [cm, setCm] = useState(() => getCodeMirror());
+	useEffect(() => {
+		if (cm) return;
+		let cancelled = false;
+		loadCodeMirror().then((loaded) => {
+			if (!cancelled) setCm(loaded);
+		}).catch((err) => {
+			if (!cancelled) console.error("Failed to load CodeMirror:", err);
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, [cm]);
+	return cm;
+}
+//#endregion
+export { useCodeMirror };
+
+//# sourceMappingURL=useCodeMirror.js.map

package/dist/utils/useCodeMirror.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCodeMirror.js","names":[],"sources":["../../src/utils/useCodeMirror.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport {\n  type CMBundle,\n  getCodeMirror,\n  loadCodeMirror,\n} from './lazy-codemirror-loader';\n\n/**\n * Returns the CodeMirror bundle once loaded, or null if still loading.\n * Initializes synchronously from cache if CM was already loaded (no flicker\n * on subsequent mounts after the first load).\n */\nexport function useCodeMirror(): CMBundle | null {\n  const [cm, setCm] = useState<CMBundle | null>(() => getCodeMirror());\n\n  useEffect(() => {\n    if (cm) return;\n\n    let cancelled = false;\n\n    loadCodeMirror()\n      .then((loaded) => {\n        if (!cancelled) setCm(loaded);\n      })\n      .catch((err) => {\n        if (!cancelled) {\n          console.error('Failed to load CodeMirror:', err);\n        }\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [cm]);\n\n  return cm;\n}\n"],"mappings":";;;;;;;;AAaA,SAAgB,gBAAiC;CAC/C,MAAM,CAAC,IAAI,SAAS,eAAgC,cAAc,CAAC;CAEnE,gBAAgB;EACd,IAAI,IAAI;EAER,IAAI,YAAY;EAEhB,eAAe,CAAC,CACb,MAAM,WAAW;GAChB,IAAI,CAAC,WAAW,MAAM,MAAM;EAC9B,CAAC,CAAC,CACD,OAAO,QAAQ;GACd,IAAI,CAAC,WACH,QAAQ,MAAM,8BAA8B,GAAG;EAEnD,CAAC;EAEH,aAAa;GACX,YAAY;EACd;CACF,GAAG,CAAC,EAAE,CAAC;CAEP,OAAO;AACT"}

package/dist/utils/useZIndex.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Tracks the z-index of the nearest portal-rendered ancestor (pane, dialog,
+ * popover, etc.). Defaults to zIndices.content (0) when there is no ancestor.
+ *
+ * Consumers should never read this context directly. Use useZIndex() instead.
+ */
+export declare const ZIndexContext: import("react").Context<number>;
+/**
+ * Returns the z-index a portal-rendered overlay should use so that it always
+ * stacks above its nearest ancestor overlay, regardless of nesting depth.
+ *
+ * Portal-rendered elements (popovers, dropdowns, dialogs) escape the DOM tree
+ * and render at the document body, so their z-index competes globally. Without
+ * coordination a dropdown inside a modal can render behind it if the dropdown's
+ * default z-index is lower than the modal's.
+ *
+ * useZIndex solves this with Math.max(defaultZIndex, contextZIndex + 1):
+ * - At the root (no ancestor): uses defaultZIndex, the semantic floor that
+ *   guarantees the overlay beats all page layout (e.g. popover always >= 1300).
+ * - Inside an ancestor overlay: ignores defaultZIndex and uses contextZIndex + 1
+ *   instead, ensuring it always renders ab ove the parent regardless of the
+ *   parent's absolute value.
+ *
+ * After calling useZIndex, the component must:
+ * 1. Apply the returned value as style={{ zIndex }} on the portaled element.
+ * 2. Wrap its children in <ZIndexProvider value={zIndex}> so that any further
+ *    nested overlays can repeat the same calculation relative to this layer.
+ *
+ * Note: Tooltips do NOT use useZIndex — they have no semantic floor and always
+ * render at contextZIndex + 1 directly, since they only need to appear above
+ * whatever triggered them.
+ *
+ * @example
+ * ```tsx
+ * function MyPopover({ children }) {
+ *   const zIndex = useZIndex(zIndices.popover);
+ *   return (
+ *     <Portal>
+ *       <Content style={{ zIndex }}>
+ *         <ZIndexProvider value={zIndex}>
+ *           {children}
+ *         </ZIndexProvider>
+ *       </Content>
+ *     </Portal>
+ *   );
+ * }
+ * ```
+ *
+ * @param defaultZIndex - The semantic floor for this overlay type (e.g. zIndices.popover).
+ * @returns The z-index to apply — either the floor or contextZIndex + 1, whichever is higher.
+ */
+export declare function useZIndex(defaultZIndex: number): number;

package/dist/utils/useZIndex.js

@@ -0,0 +1,62 @@
+import zIndices from "./zIndices.js";
+import { createContext, useContext } from "react";
+//#region packages/components/src/utils/useZIndex.ts
+/**
+* Tracks the z-index of the nearest portal-rendered ancestor (pane, dialog,
+* popover, etc.). Defaults to zIndices.content (0) when there is no ancestor.
+*
+* Consumers should never read this context directly. Use useZIndex() instead.
+*/
+var ZIndexContext = createContext(zIndices.content);
+/**
+* Returns the z-index a portal-rendered overlay should use so that it always
+* stacks above its nearest ancestor overlay, regardless of nesting depth.
+*
+* Portal-rendered elements (popovers, dropdowns, dialogs) escape the DOM tree
+* and render at the document body, so their z-index competes globally. Without
+* coordination a dropdown inside a modal can render behind it if the dropdown's
+* default z-index is lower than the modal's.
+*
+* useZIndex solves this with Math.max(defaultZIndex, contextZIndex + 1):
+* - At the root (no ancestor): uses defaultZIndex, the semantic floor that
+*   guarantees the overlay beats all page layout (e.g. popover always >= 1300).
+* - Inside an ancestor overlay: ignores defaultZIndex and uses contextZIndex + 1
+*   instead, ensuring it always renders ab ove the parent regardless of the
+*   parent's absolute value.
+*
+* After calling useZIndex, the component must:
+* 1. Apply the returned value as style={{ zIndex }} on the portaled element.
+* 2. Wrap its children in <ZIndexProvider value={zIndex}> so that any further
+*    nested overlays can repeat the same calculation relative to this layer.
+*
+* Note: Tooltips do NOT use useZIndex — they have no semantic floor and always
+* render at contextZIndex + 1 directly, since they only need to appear above
+* whatever triggered them.
+*
+* @example
+* ```tsx
+* function MyPopover({ children }) {
+*   const zIndex = useZIndex(zIndices.popover);
+*   return (
+*     <Portal>
+*       <Content style={{ zIndex }}>
+*         <ZIndexProvider value={zIndex}>
+*           {children}
+*         </ZIndexProvider>
+*       </Content>
+*     </Portal>
+*   );
+* }
+* ```
+*
+* @param defaultZIndex - The semantic floor for this overlay type (e.g. zIndices.popover).
+* @returns The z-index to apply — either the floor or contextZIndex + 1, whichever is higher.
+*/
+function useZIndex(defaultZIndex) {
+	const contextZIndex = useContext(ZIndexContext);
+	return Math.max(defaultZIndex, contextZIndex + 1);
+}
+//#endregion
+export { ZIndexContext, useZIndex };
+
+//# sourceMappingURL=useZIndex.js.map

package/dist/utils/useZIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useZIndex.js","names":[],"sources":["../../src/utils/useZIndex.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\n\nimport zIndices from './zIndices';\n\n/**\n * Tracks the z-index of the nearest portal-rendered ancestor (pane, dialog,\n * popover, etc.). Defaults to zIndices.content (0) when there is no ancestor.\n *\n * Consumers should never read this context directly. Use useZIndex() instead.\n */\nexport const ZIndexContext = createContext<number>(zIndices.content);\n\n/**\n * Returns the z-index a portal-rendered overlay should use so that it always\n * stacks above its nearest ancestor overlay, regardless of nesting depth.\n *\n * Portal-rendered elements (popovers, dropdowns, dialogs) escape the DOM tree\n * and render at the document body, so their z-index competes globally. Without\n * coordination a dropdown inside a modal can render behind it if the dropdown's\n * default z-index is lower than the modal's.\n *\n * useZIndex solves this with Math.max(defaultZIndex, contextZIndex + 1):\n * - At the root (no ancestor): uses defaultZIndex, the semantic floor that\n *   guarantees the overlay beats all page layout (e.g. popover always >= 1300).\n * - Inside an ancestor overlay: ignores defaultZIndex and uses contextZIndex + 1\n *   instead, ensuring it always renders ab ove the parent regardless of the\n *   parent's absolute value.\n *\n * After calling useZIndex, the component must:\n * 1. Apply the returned value as style={{ zIndex }} on the portaled element.\n * 2. Wrap its children in <ZIndexProvider value={zIndex}> so that any further\n *    nested overlays can repeat the same calculation relative to this layer.\n *\n * Note: Tooltips do NOT use useZIndex — they have no semantic floor and always\n * render at contextZIndex + 1 directly, since they only need to appear above\n * whatever triggered them.\n *\n * @example\n * ```tsx\n * function MyPopover({ children }) {\n *   const zIndex = useZIndex(zIndices.popover);\n *   return (\n *     <Portal>\n *       <Content style={{ zIndex }}>\n *         <ZIndexProvider value={zIndex}>\n *           {children}\n *         </ZIndexProvider>\n *       </Content>\n *     </Portal>\n *   );\n * }\n * ```\n *\n * @param defaultZIndex - The semantic floor for this overlay type (e.g. zIndices.popover).\n * @returns The z-index to apply — either the floor or contextZIndex + 1, whichever is higher.\n */\nexport function useZIndex(defaultZIndex: number): number {\n  const contextZIndex = useContext(ZIndexContext);\n  return Math.max(defaultZIndex, contextZIndex + 1);\n}\n"],"mappings":";;;;;;;;;AAUA,IAAa,gBAAgB,cAAsB,SAAS,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CnE,SAAgB,UAAU,eAA+B;CACvD,MAAM,gBAAgB,WAAW,aAAa;CAC9C,OAAO,KAAK,IAAI,eAAe,gBAAgB,CAAC;AAClD"}

package/dist/utils/zIndices.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Centralized z-index values for the application.
+ *
+ * This file defines all z-index values used throughout the app to ensure
+ * proper stacking order and avoid conflicts.
+ *
+ * Z-index layers (from lowest to highest):
+ * - Content (0): Natural CSS baseline — regular content, sticky headers
+ * - Navigation (1): Resize handles, floating bars
+ * - Layout (2): Sidebar, overlays
+ * - Grid interaction (4-5): Drag/resize overlays, sticky page headers
+ * - Pane (500): Side panes
+ * - Popover (1000+): Popovers, dropdowns — large intentional jump to guarantee
+ *   portal-rendered overlays always beat any page layout complexity
+ * - Modal (2000+): Modal dialogs
+ * - Toast (9999): System toasts
+ *
+ * Note: Tooltips do NOT have a fixed z-index here. They always render at
+ * contextZIndex + 1 (relative to their parent caller) via ZIndexContext,
+ * so they naturally stack above whichever layer triggered them.
+ */
+declare const zIndices: {
+    readonly content: 0;
+    readonly stickyHeader: 1;
+    readonly tableStickyCell: 1;
+    readonly tableStickyHeader: 3;
+    readonly paneHeader: 4;
+    readonly dragOverlay: 4;
+    readonly dashboardHeader: 5;
+    readonly floatingBar: 2;
+    readonly resizeHandle: 2;
+    readonly sidebar: 5;
+    readonly tooltip: 6;
+    readonly selectionActionBar: 12;
+    readonly pane: 500;
+    readonly popover: 1300;
+    readonly devToolPanel: 2500;
+    readonly dialogOverlay: 2999;
+    readonly dialogContent: 3000;
+    readonly toast: 9999;
+};
+export default zIndices;

package/dist/utils/zIndices.js

@@ -0,0 +1,46 @@
+//#region packages/components/src/utils/zIndices.ts
+/**
+* Centralized z-index values for the application.
+*
+* This file defines all z-index values used throughout the app to ensure
+* proper stacking order and avoid conflicts.
+*
+* Z-index layers (from lowest to highest):
+* - Content (0): Natural CSS baseline — regular content, sticky headers
+* - Navigation (1): Resize handles, floating bars
+* - Layout (2): Sidebar, overlays
+* - Grid interaction (4-5): Drag/resize overlays, sticky page headers
+* - Pane (500): Side panes
+* - Popover (1000+): Popovers, dropdowns — large intentional jump to guarantee
+*   portal-rendered overlays always beat any page layout complexity
+* - Modal (2000+): Modal dialogs
+* - Toast (9999): System toasts
+*
+* Note: Tooltips do NOT have a fixed z-index here. They always render at
+* contextZIndex + 1 (relative to their parent caller) via ZIndexContext,
+* so they naturally stack above whichever layer triggered them.
+*/
+var zIndices = {
+	content: 0,
+	stickyHeader: 1,
+	tableStickyCell: 1,
+	tableStickyHeader: 3,
+	paneHeader: 4,
+	dragOverlay: 4,
+	dashboardHeader: 5,
+	floatingBar: 2,
+	resizeHandle: 2,
+	sidebar: 5,
+	tooltip: 6,
+	selectionActionBar: 12,
+	pane: 500,
+	popover: 1300,
+	devToolPanel: 2500,
+	dialogOverlay: 2999,
+	dialogContent: 3e3,
+	toast: 9999
+};
+//#endregion
+export { zIndices as default };
+
+//# sourceMappingURL=zIndices.js.map

package/dist/utils/zIndices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zIndices.js","names":[],"sources":["../../src/utils/zIndices.ts"],"sourcesContent":["/**\n * Centralized z-index values for the application.\n *\n * This file defines all z-index values used throughout the app to ensure\n * proper stacking order and avoid conflicts.\n *\n * Z-index layers (from lowest to highest):\n * - Content (0): Natural CSS baseline — regular content, sticky headers\n * - Navigation (1): Resize handles, floating bars\n * - Layout (2): Sidebar, overlays\n * - Grid interaction (4-5): Drag/resize overlays, sticky page headers\n * - Pane (500): Side panes\n * - Popover (1000+): Popovers, dropdowns — large intentional jump to guarantee\n *   portal-rendered overlays always beat any page layout complexity\n * - Modal (2000+): Modal dialogs\n * - Toast (9999): System toasts\n *\n * Note: Tooltips do NOT have a fixed z-index here. They always render at\n * contextZIndex + 1 (relative to their parent caller) via ZIndexContext,\n * so they naturally stack above whichever layer triggered them.\n */\n\nconst zIndices = {\n  // Content layer\n  content: 0,\n  stickyHeader: 1,\n  tableStickyCell: 1, // Sticky table columns — above non-sticky cells (auto)\n  tableStickyHeader: 3, // Sticky table header — above rows and sticky columns\n  paneHeader: 4, // Above a scrolled table's sticky header\n  dragOverlay: 4, // Grid drag/resize overlays — above sticky table headers (3)\n  dashboardHeader: 5, // Sticky page header — above drag overlays, below tooltips\n  floatingBar: 2,\n  resizeHandle: 2, // Higher than sticky header to ensure it's always interactive\n\n  // Layout layer (this is arbitrarily 5 to give a few layers above the content layer)\n  sidebar: 5,\n\n  tooltip: 6,\n\n  selectionActionBar: 12, // Selection bars — above page headers and their tooltips\n\n  // Pane layer\n  pane: 500,\n\n  // Popover layer — large jump ensures portal overlays always beat page layout\n  popover: 1300,\n\n  // Dev tool panels (e.g. Eppo control panel) — above popovers/Polly, below dialogs\n  devToolPanel: 2500,\n\n  dialogOverlay: 2999,\n  dialogContent: 3000,\n\n  // System toasts — above dialogs, but bounded so nested items(e.g., button labels) can overlay\n  toast: 9999,\n} as const;\n\nexport default zIndices;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAM,WAAW;CAEf,SAAS;CACT,cAAc;CACd,iBAAiB;CACjB,mBAAmB;CACnB,YAAY;CACZ,aAAa;CACb,iBAAiB;CACjB,aAAa;CACb,cAAc;CAGd,SAAS;CAET,SAAS;CAET,oBAAoB;CAGpB,MAAM;CAGN,SAAS;CAGT,cAAc;CAEd,eAAe;CACf,eAAe;CAGf,OAAO;AACT"}