@keboola/design 10.1.0 → 11.0.1

package/dist/utils-D0c5VAyF.js

@@ -0,0 +1,308 @@
+import { cn } from "./classNames-BzrkDnOD.js";
+import { useArgoDesign } from "./context-KxxeMHbR.js";
+import { Slot } from "@radix-ui/react-slot";
+import { useEffect, useState } from "react";
+import { Content, Portal, Provider, Root as Root$1, Trigger } from "@radix-ui/react-tooltip";
+import { cva } from "class-variance-authority";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/utils/copyToClipboard.ts
+/**
+* The async Clipboard API requires the document to be focused and rejects with
+* `NotAllowedError: Document is not focused` otherwise — which is the normal state
+* for a page inside an iframe that has not taken focus, such as Storybook's canvas
+* or an embedded preview. `execCommand` has no such requirement because it copies
+* the selection of a node we focus ourselves, so it covers that gap.
+*/
+const copyViaSelection = (text) => {
+	const node = document.createElement("textarea");
+	node.value = text;
+	node.setAttribute("readonly", "");
+	node.style.cssText = "position:fixed;top:0;left:0;opacity:0";
+	document.body.append(node);
+	node.select();
+	try {
+		return document.execCommand("copy");
+	} finally {
+		node.remove();
+	}
+};
+const copyToClipboard = async (text) => {
+	try {
+		await navigator.clipboard.writeText(text);
+	} catch (error) {
+		if (!copyViaSelection(text)) throw error;
+	}
+};
+//#endregion
+//#region src/utils/createChangeInputEvent.ts
+const createChangeInputEvent = (input) => {
+	const changeEvent = {
+		target: input,
+		currentTarget: input,
+		type: "change",
+		nativeEvent: new Event("change", { bubbles: true }),
+		bubbles: true,
+		cancelable: false,
+		defaultPrevented: false,
+		eventPhase: 2,
+		isTrusted: false,
+		preventDefault: () => {},
+		isDefaultPrevented: () => false,
+		stopPropagation: () => {},
+		isPropagationStopped: () => false,
+		persist: () => {},
+		timeStamp: Date.now()
+	};
+	Object.defineProperty(changeEvent, "target", {
+		value: input,
+		writable: false
+	});
+	return changeEvent;
+};
+//#endregion
+//#region src/constants/keyCodes.ts
+const keyCodes = {
+	ENTER: "Enter",
+	ESCAPE: "Escape",
+	SPACE: " "
+};
+//#endregion
+//#region src/components/Tooltip/TooltipContent.tsx
+const tooltipVariants = cva([
+	"tailwindcss-preflight",
+	"tw:inline-block",
+	"tw:break-anywhere",
+	"tw:max-h-96",
+	"tw:overflow-y-auto",
+	"tw:z-[1060]",
+	"tw:rounded",
+	"tw:bg-neutral-800",
+	"tw:text-white",
+	"tw:data-[argo=true]:rounded-2xl",
+	"tw:data-[argo=true]:border",
+	"tw:data-[argo=true]:border-solid",
+	"tw:data-[argo=true]:border-border",
+	"tw:data-[argo=true]:bg-popover",
+	"tw:data-[argo=true]:text-popover-foreground",
+	"tw:data-[argo=true]:shadow-md",
+	"tw:data-[argo=true]:data-[state=delayed-open]:animate-in",
+	"tw:data-[argo=true]:data-[state=instant-open]:animate-in",
+	"tw:data-[argo=true]:data-[state=delayed-open]:fade-in-0",
+	"tw:data-[argo=true]:data-[state=instant-open]:fade-in-0",
+	"tw:data-[argo=true]:data-[state=delayed-open]:zoom-in-95",
+	"tw:data-[argo=true]:data-[state=instant-open]:zoom-in-95",
+	"tw:data-[argo=true]:data-[state=closed]:animate-out",
+	"tw:data-[argo=true]:data-[state=closed]:fade-out-0",
+	"tw:data-[argo=true]:data-[state=closed]:zoom-out-95",
+	"tw:data-[argo=true]:data-[side=bottom]:slide-in-from-top-2",
+	"tw:data-[argo=true]:data-[side=left]:slide-in-from-right-2",
+	"tw:data-[argo=true]:data-[side=right]:slide-in-from-left-2",
+	"tw:data-[argo=true]:data-[side=top]:slide-in-from-bottom-2"
+], {
+	defaultVariants: { variant: "action" },
+	variants: { variant: {
+		action: [
+			"tw:max-w-fit",
+			"tw:px-3",
+			"tw:py-2",
+			"tw:text-center",
+			"tw:text-xs",
+			"tw:font-medium",
+			"tw:uppercase",
+			"tw:tracking-wider",
+			"tw:[[data-brand=keboola]_&]:normal-case",
+			"tw:[[data-brand=keboola]_&]:tracking-normal"
+		],
+		explanatory: [
+			"tw:max-w-80",
+			"tw:px-4",
+			"tw:py-3",
+			"tw:text-left",
+			"tw:text-sm",
+			"tw:font-normal"
+		]
+	} }
+});
+const TooltipContent = ({ className, variant, keepOpenOnPointerDownOutside = false, children, onPointerDownOutside, sideOffset = 8, collisionPadding = 8, hideWhenDetached = true, placement = "right", ...rest }) => {
+	const renderArgo = useArgoDesign();
+	const handlePointerDownOutside = (event) => {
+		if (keepOpenOnPointerDownOutside) event.preventDefault();
+		onPointerDownOutside?.(event);
+	};
+	return /* @__PURE__ */ jsx(Portal, { children: /* @__PURE__ */ jsx(Content, {
+		...rest,
+		"data-tooltip-content": renderArgo ? void 0 : true,
+		"data-argo": renderArgo,
+		sideOffset,
+		collisionPadding,
+		onPointerDownOutside: handlePointerDownOutside,
+		className: tooltipVariants({
+			className,
+			variant
+		}),
+		hideWhenDetached,
+		side: placement,
+		children
+	}) });
+};
+//#endregion
+//#region src/components/Tooltip/TooltipRoot.tsx
+const DELAY_SHOW_TOOLTIP = 300;
+const TooltipRoot = ({ children, delayDuration = DELAY_SHOW_TOOLTIP, ...rest }) => /* @__PURE__ */ jsx(Root$1, {
+	...rest,
+	delayDuration,
+	children
+});
+//#endregion
+//#region src/components/Tooltip/TooltipTrigger.tsx
+/**
+* Radix stamps the tooltip's own open/closed `data-state` onto the trigger. Merged onto an
+* `asChild` child that keeps a `data-state` of its own — `ToggleGroup.Item`, `Switch`, a `Tabs`
+* trigger — it wins, because those primitives spread incoming props *after* their own attribute.
+* The child then silently loses every `data-[state=…]` style it has, which is usually the only
+* thing marking it as selected.
+*
+* The tooltip's trigger state is styled nowhere, so it is dropped before it reaches the child.
+*/
+const WithoutTooltipState = ({ children, ...props }) => {
+	const { "data-state": _tooltipState, ...rest } = props;
+	return /* @__PURE__ */ jsx(Slot, {
+		...rest,
+		children
+	});
+};
+const TooltipTrigger = ({ ref, children, className, keepOpenOnClick = false, onClick, onPointerDown, asChild, ...rest }) => {
+	const handleClick = (event) => {
+		if (keepOpenOnClick) event.preventDefault();
+		onClick?.(event);
+	};
+	const handlePointerDown = (event) => {
+		if (keepOpenOnClick) event.preventDefault();
+		onPointerDown?.(event);
+	};
+	return /* @__PURE__ */ jsx(Trigger, {
+		...rest,
+		asChild: true,
+		ref,
+		className: cn("tailwindcss-preflight", className),
+		onClick: handleClick,
+		onPointerDown: handlePointerDown,
+		children: asChild ? /* @__PURE__ */ jsx(WithoutTooltipState, { children }) : /* @__PURE__ */ jsx("span", {
+			className: "tw:inline-flex tw:items-center",
+			children
+		})
+	});
+};
+//#endregion
+//#region src/components/Tooltip/Tooltip.tsx
+const ACTION_TOOLTIP_LIMIT = 30;
+/** Re-export of Radix `Tooltip.Provider`. Mount once at the app root so tooltips share delay state. */
+const TooltipProvider = Provider;
+/**
+* Short plain-text label that appears on hover or focus.
+*
+* **When to use:** describing an icon-only `Button`, explaining a disabled control, or labelling a
+* truncated value. Plain text only — auto-switches to the longer `"explanatory"` variant when the string
+* exceeds 30 characters.
+* **When NOT to use:** for rich preview content (multiple lines, formatted text, structured data) use
+* `HoverCard`; for tooltips containing links or buttons use `Popover` (interactive elements break a11y
+* inside a `Tooltip`).
+* **Composition:** wrap any focusable element via `triggerAsChild` so the tooltip targets the underlying
+* native element. Mount `TooltipProvider` once at the app root.
+*
+* @see RECIPES.md#disabled-button-tooltip — for the disabled-button + tooltip pattern
+*/
+const Tooltip = ({ tooltip, children, className, keepOpenOnTriggerClick = false, variant, placement = "right", forceHide = false, forceShow = false, delayDuration, triggerAsChild = false }) => {
+	const [open, setOpen] = useState(false);
+	const resolvedVariant = (() => {
+		if (!!variant) return variant;
+		if (typeof tooltip === "string" && tooltip.length > ACTION_TOOLTIP_LIMIT) return "explanatory";
+		return "action";
+	})();
+	const isActionVariant = resolvedVariant === "action";
+	const handleKeyUp = (event) => {
+		if (![keyCodes.ENTER, keyCodes.SPACE].includes(event.key)) return;
+		event.stopPropagation();
+	};
+	return /* @__PURE__ */ jsxs(TooltipRoot, {
+		open: !!tooltip && (open || forceShow) && !forceHide,
+		onOpenChange: setOpen,
+		delayDuration,
+		disableHoverableContent: isActionVariant,
+		children: [/* @__PURE__ */ jsx(TooltipTrigger, {
+			asChild: triggerAsChild,
+			keepOpenOnClick: keepOpenOnTriggerClick,
+			onKeyUp: handleKeyUp,
+			children
+		}), /* @__PURE__ */ jsx(TooltipContent, {
+			className,
+			variant: resolvedVariant,
+			placement,
+			keepOpenOnPointerDownOutside: keepOpenOnTriggerClick,
+			children: tooltip
+		})]
+	});
+};
+Tooltip.Root = TooltipRoot;
+Tooltip.Content = TooltipContent;
+Tooltip.Trigger = TooltipTrigger;
+//#endregion
+//#region src/utils/decorators.tsx
+const withTooltipProvider = (Story) => /* @__PURE__ */ jsx(TooltipProvider, { children: /* @__PURE__ */ jsx(Story, {}) });
+const withHiddenFullscreen = (Story) => /* @__PURE__ */ jsx("div", {
+	className: "tw:[&_[aria-label=Fullscreen]]:hidden",
+	children: /* @__PURE__ */ jsx(Story, {})
+});
+//#endregion
+//#region src/utils/createPrefixedString.ts
+const createPrefixedString = (prefix) => (literals) => literals.reduce((acc, literal) => acc + literal, `${prefix}-`);
+//#endregion
+//#region src/utils/noop.ts
+const noop = () => void 0;
+//#endregion
+//#region src/utils/debounce.ts
+const debounce = (fn, delay) => {
+	let timeoutId;
+	const debounced = (...args) => {
+		clearTimeout(timeoutId);
+		timeoutId = setTimeout(() => fn(...args), delay);
+	};
+	debounced.cancel = () => clearTimeout(timeoutId);
+	return debounced;
+};
+//#endregion
+//#region src/utils/isMac.ts
+const getIsMac = () => {
+	if (typeof navigator !== "undefined" && "userAgentData" in navigator) {
+		const platform = navigator.userAgentData.platform;
+		if (typeof platform === "string") return platform.toLowerCase() === "macos";
+	}
+	if (typeof navigator !== "undefined" && typeof navigator.platform === "string") return navigator.platform.toUpperCase().indexOf("MAC") >= 0;
+	return false;
+};
+const isMac = getIsMac();
+//#endregion
+//#region src/utils/useSHA256.ts
+const sha256 = async (text) => {
+	const msgUint8 = new TextEncoder().encode(text);
+	const hashBuffer = await crypto.subtle.digest("SHA-256", msgUint8);
+	return Array.from(new Uint8Array(hashBuffer)).map((b) => b.toString(16).padStart(2, "0")).join("");
+};
+const useSHA256 = (text) => {
+	const [hash, setHash] = useState("");
+	useEffect(() => {
+		if (!text) return;
+		let cancelled = false;
+		sha256(text).then((h) => {
+			if (!cancelled) setHash(h);
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, [text]);
+	return text ? hash : "";
+};
+//#endregion
+export { Tooltip, TooltipProvider, copyToClipboard, createChangeInputEvent, createPrefixedString, debounce, isMac, keyCodes, noop, useSHA256, withHiddenFullscreen, withTooltipProvider };
+
+//# sourceMappingURL=utils-D0c5VAyF.js.map

package/dist/utils-D0c5VAyF.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils-D0c5VAyF.js","names":["Root"],"sources":["../src/utils/copyToClipboard.ts","../src/utils/createChangeInputEvent.ts","../src/constants/keyCodes.ts","../src/components/Tooltip/TooltipContent.tsx","../src/components/Tooltip/TooltipRoot.tsx","../src/components/Tooltip/TooltipTrigger.tsx","../src/components/Tooltip/Tooltip.tsx","../src/utils/decorators.tsx","../src/utils/createPrefixedString.ts","../src/utils/noop.ts","../src/utils/debounce.ts","../src/utils/isMac.ts","../src/utils/useSHA256.ts"],"sourcesContent":["/**\n * The async Clipboard API requires the document to be focused and rejects with\n * `NotAllowedError: Document is not focused` otherwise — which is the normal state\n * for a page inside an iframe that has not taken focus, such as Storybook's canvas\n * or an embedded preview. `execCommand` has no such requirement because it copies\n * the selection of a node we focus ourselves, so it covers that gap.\n */\nconst copyViaSelection = (text: string) => {\n  const node = document.createElement('textarea');\n  node.value = text;\n  node.setAttribute('readonly', '');\n  node.style.cssText = 'position:fixed;top:0;left:0;opacity:0';\n  document.body.append(node);\n  node.select();\n\n  try {\n    return document.execCommand('copy');\n  } finally {\n    node.remove();\n  }\n};\n\nexport const copyToClipboard = async (text: string) => {\n  try {\n    await navigator.clipboard.writeText(text);\n  } catch (error) {\n    if (!copyViaSelection(text)) throw error;\n  }\n};\n","import type { ChangeEvent } from 'react';\n\nexport const createChangeInputEvent = (input: HTMLInputElement) => {\n  const changeEvent: ChangeEvent<HTMLInputElement> = {\n    target: input,\n    currentTarget: input,\n    type: 'change',\n    nativeEvent: new Event('change', { bubbles: true }),\n    bubbles: true,\n    cancelable: false,\n    defaultPrevented: false,\n    eventPhase: 2, // AT_TARGET\n    isTrusted: false, // Synthetic events are not trusted\n    preventDefault: () => {}, // Provide dummy functions if not needed\n    isDefaultPrevented: () => false,\n    stopPropagation: () => {},\n    isPropagationStopped: () => false,\n    persist: () => {},\n    timeStamp: Date.now(),\n  };\n\n  Object.defineProperty(changeEvent, 'target', {\n    value: input,\n    writable: false,\n  });\n\n  return changeEvent;\n};\n","export const keyCodes = {\n  ENTER: 'Enter',\n  ESCAPE: 'Escape',\n  SPACE: ' ',\n};\n","import type { ComponentProps } from 'react';\nimport { Content, Portal } from '@radix-ui/react-tooltip';\nimport type { VariantProps } from 'class-variance-authority';\nimport { cva } from 'class-variance-authority';\n\nimport { useArgoDesign } from '../ThemeProvider/context';\n\nconst tooltipVariants = cva(\n  [\n    'tailwindcss-preflight',\n    'tw:inline-block',\n    'tw:break-anywhere',\n    'tw:max-h-96',\n    'tw:overflow-y-auto',\n    'tw:z-[1060]',\n\n    // legacy (dark) chrome — default\n    'tw:rounded',\n    'tw:bg-neutral-800',\n    'tw:text-white',\n\n    // argo chrome overrides — semantic floating-panel tokens\n    'tw:data-[argo=true]:rounded-2xl',\n    'tw:data-[argo=true]:border',\n    'tw:data-[argo=true]:border-solid',\n    'tw:data-[argo=true]:border-border',\n    'tw:data-[argo=true]:bg-popover',\n    'tw:data-[argo=true]:text-popover-foreground',\n    'tw:data-[argo=true]:shadow-md',\n\n    // argo open animation\n    'tw:data-[argo=true]:data-[state=delayed-open]:animate-in',\n    'tw:data-[argo=true]:data-[state=instant-open]:animate-in',\n    'tw:data-[argo=true]:data-[state=delayed-open]:fade-in-0',\n    'tw:data-[argo=true]:data-[state=instant-open]:fade-in-0',\n    'tw:data-[argo=true]:data-[state=delayed-open]:zoom-in-95',\n    'tw:data-[argo=true]:data-[state=instant-open]:zoom-in-95',\n\n    // argo closed animation\n    'tw:data-[argo=true]:data-[state=closed]:animate-out',\n    'tw:data-[argo=true]:data-[state=closed]:fade-out-0',\n    'tw:data-[argo=true]:data-[state=closed]:zoom-out-95',\n\n    // argo position animation\n    'tw:data-[argo=true]:data-[side=bottom]:slide-in-from-top-2',\n    'tw:data-[argo=true]:data-[side=left]:slide-in-from-right-2',\n    'tw:data-[argo=true]:data-[side=right]:slide-in-from-left-2',\n    'tw:data-[argo=true]:data-[side=top]:slide-in-from-bottom-2',\n  ],\n  {\n    defaultVariants: {\n      variant: 'action',\n    },\n    variants: {\n      variant: {\n        action: [\n          'tw:max-w-fit',\n          'tw:px-3',\n          'tw:py-2',\n\n          'tw:text-center',\n          'tw:text-xs',\n          'tw:font-medium',\n          // Legacy chrome uppercases the action tooltip; the Keboola V2 brand\n          // (`data-brand=\"keboola\"`) renders it in standard case instead.\n          'tw:uppercase',\n          'tw:tracking-wider',\n          'tw:[[data-brand=keboola]_&]:normal-case',\n          'tw:[[data-brand=keboola]_&]:tracking-normal',\n        ],\n        explanatory: [\n          'tw:max-w-80',\n          'tw:px-4',\n          'tw:py-3',\n          'tw:text-left',\n\n          'tw:text-sm',\n          'tw:font-normal',\n        ],\n      },\n    },\n  },\n);\n\ntype Props = {\n  keepOpenOnPointerDownOutside?: boolean;\n  placement?: ComponentProps<typeof Content>['side'];\n} & Omit<ComponentProps<typeof Content>, 'side'> &\n  VariantProps<typeof tooltipVariants>;\n\nexport const TooltipContent = ({\n  className,\n  variant,\n  keepOpenOnPointerDownOutside = false,\n  children,\n  onPointerDownOutside,\n  sideOffset = 8,\n  collisionPadding = 8,\n  hideWhenDetached = true,\n  placement = 'right',\n  ...rest\n}: Props) => {\n  const renderArgo = useArgoDesign();\n\n  const handlePointerDownOutside: ComponentProps<typeof Content>['onPointerDownOutside'] = (\n    event,\n  ) => {\n    if (keepOpenOnPointerDownOutside) event.preventDefault();\n    onPointerDownOutside?.(event);\n  };\n\n  return (\n    <Portal>\n      <Content\n        {...rest}\n        // Marks the dark (non-argo) tooltip chrome so styles.css can invert\n        // nested `.tw\\:prose` for contrast.\n        data-tooltip-content={renderArgo ? undefined : true}\n        data-argo={renderArgo}\n        sideOffset={sideOffset}\n        collisionPadding={collisionPadding}\n        onPointerDownOutside={handlePointerDownOutside}\n        className={tooltipVariants({ className, variant })}\n        hideWhenDetached={hideWhenDetached}\n        side={placement}\n      >\n        {children}\n      </Content>\n    </Portal>\n  );\n};\n","import type { ComponentProps } from 'react';\nimport { Root } from '@radix-ui/react-tooltip';\n\ntype Props = ComponentProps<typeof Root>;\n\nconst DELAY_SHOW_TOOLTIP = 300;\n\nexport const TooltipRoot = ({ children, delayDuration = DELAY_SHOW_TOOLTIP, ...rest }: Props) => (\n  <Root {...rest} delayDuration={delayDuration}>\n    {children}\n  </Root>\n);\n","import type { ComponentProps } from 'react';\nimport { Slot } from '@radix-ui/react-slot';\nimport { Trigger } from '@radix-ui/react-tooltip';\n\nimport { cn } from '../../utils';\n\n/**\n * Radix stamps the tooltip's own open/closed `data-state` onto the trigger. Merged onto an\n * `asChild` child that keeps a `data-state` of its own — `ToggleGroup.Item`, `Switch`, a `Tabs`\n * trigger — it wins, because those primitives spread incoming props *after* their own attribute.\n * The child then silently loses every `data-[state=…]` style it has, which is usually the only\n * thing marking it as selected.\n *\n * The tooltip's trigger state is styled nowhere, so it is dropped before it reaches the child.\n */\nconst WithoutTooltipState = ({\n  children,\n  ...props\n  // `Slot`'s own props, plus the one attribute this exists to remove: React's types declare no\n  // `data-*`, so it has to be named to be destructured away.\n}: ComponentProps<typeof Slot> & { 'data-state'?: string }) => {\n  const { 'data-state': _tooltipState, ...rest } = props;\n\n  return <Slot {...rest}>{children}</Slot>;\n};\n\ntype Props = {\n  keepOpenOnClick?: boolean;\n} & ComponentProps<typeof Trigger>;\n\nexport const TooltipTrigger = ({\n  ref,\n  children,\n  className,\n  keepOpenOnClick = false,\n  onClick,\n  onPointerDown,\n  asChild,\n  ...rest\n}: Props) => {\n  const handleClick: ComponentProps<typeof Trigger>['onClick'] = (event) => {\n    if (keepOpenOnClick) event.preventDefault();\n    onClick?.(event);\n  };\n\n  const handlePointerDown: ComponentProps<typeof Trigger>['onPointerDown'] = (event) => {\n    if (keepOpenOnClick) event.preventDefault();\n    onPointerDown?.(event);\n  };\n\n  return (\n    <Trigger\n      {...rest}\n      asChild\n      ref={ref}\n      className={cn('tailwindcss-preflight', className)}\n      onClick={handleClick}\n      onPointerDown={handlePointerDown}\n    >\n      {asChild ? (\n        <WithoutTooltipState>{children}</WithoutTooltipState>\n      ) : (\n        // Default-mode trigger wraps children in a span so Radix has a\n        // single DOM element to attach handlers to. `tailwindcss-preflight`\n        // (merged in via Slot) activates Tailwind's preflight inside the\n        // span, which sets `svg { display: block }` — without an inline-flex\n        // container that would stack any bare Lucide icon onto its own\n        // line. `tw:inline-flex tw:items-center` keeps icon + text aligned.\n        <span className=\"tw:inline-flex tw:items-center\">{children}</span>\n      )}\n    </Trigger>\n  );\n};\n","import { useState } from 'react';\nimport type { ComponentProps, ReactNode } from 'react';\nimport type { Content, Trigger } from '@radix-ui/react-tooltip';\nimport { Provider } from '@radix-ui/react-tooltip';\n\nimport { keyCodes } from '../../constants/keyCodes';\n\nimport { TooltipContent } from './TooltipContent';\nimport { TooltipRoot } from './TooltipRoot';\nimport { TooltipTrigger } from './TooltipTrigger';\n\nconst ACTION_TOOLTIP_LIMIT = 30;\n\ntype TriggerProps = {\n  triggerAsChild?: boolean;\n};\n\n/**\n * Props for `Tooltip`. `tooltip` is the popup content; `children` is the trigger element.\n * `variant` auto-resolves to `\"explanatory\"` for strings >30 chars, else `\"action\"`.\n */\nexport type Props = {\n  /** Keep the tooltip visible when the user clicks the trigger (useful for click-to-copy feedback). */\n  keepOpenOnTriggerClick?: boolean;\n  /** Content rendered inside the tooltip. Plain text only — no interactive elements (use `HoverCard` or `Popover` for that). */\n  tooltip: ReactNode;\n  children: ReactNode;\n  placement?: ComponentProps<typeof Content>['side'];\n  /** Forcibly hide the tooltip regardless of hover state. */\n  forceHide?: boolean;\n  /** Forcibly show the tooltip regardless of hover state. Useful for guided-tour overlays. */\n  forceShow?: boolean;\n  /** Hover delay before the tooltip opens, in ms. Defaults to the shared 300ms. */\n  delayDuration?: number;\n  className?: string;\n} & TriggerProps &\n  Pick<ComponentProps<typeof TooltipContent>, 'variant' | 'className'>;\n\n/** Re-export of Radix `Tooltip.Provider`. Mount once at the app root so tooltips share delay state. */\nexport const TooltipProvider = Provider;\n\n/**\n * Short plain-text label that appears on hover or focus.\n *\n * **When to use:** describing an icon-only `Button`, explaining a disabled control, or labelling a\n * truncated value. Plain text only — auto-switches to the longer `\"explanatory\"` variant when the string\n * exceeds 30 characters.\n * **When NOT to use:** for rich preview content (multiple lines, formatted text, structured data) use\n * `HoverCard`; for tooltips containing links or buttons use `Popover` (interactive elements break a11y\n * inside a `Tooltip`).\n * **Composition:** wrap any focusable element via `triggerAsChild` so the tooltip targets the underlying\n * native element. Mount `TooltipProvider` once at the app root.\n *\n * @see RECIPES.md#disabled-button-tooltip — for the disabled-button + tooltip pattern\n */\nexport const Tooltip = ({\n  tooltip,\n  children,\n  className,\n  keepOpenOnTriggerClick = false,\n  variant,\n  placement = 'right',\n  forceHide = false,\n  forceShow = false,\n  delayDuration,\n  // trigger props\n  triggerAsChild = false,\n}: Props) => {\n  const [open, setOpen] = useState(false);\n\n  const resolvedVariant = (() => {\n    if (!!variant) return variant;\n    if (typeof tooltip === 'string' && tooltip.length > ACTION_TOOLTIP_LIMIT) return 'explanatory';\n\n    return 'action';\n  })();\n\n  const isActionVariant = resolvedVariant === 'action';\n\n  const handleKeyUp: ComponentProps<typeof Trigger>['onKeyUp'] = (event) => {\n    if (![keyCodes.ENTER, keyCodes.SPACE].includes(event.key)) return;\n    event.stopPropagation();\n  };\n\n  return (\n    <TooltipRoot\n      open={!!tooltip && (open || forceShow) && !forceHide}\n      onOpenChange={setOpen}\n      delayDuration={delayDuration}\n      disableHoverableContent={isActionVariant}\n    >\n      <TooltipTrigger\n        asChild={triggerAsChild}\n        keepOpenOnClick={keepOpenOnTriggerClick}\n        onKeyUp={handleKeyUp}\n      >\n        {children}\n      </TooltipTrigger>\n\n      <TooltipContent\n        className={className}\n        variant={resolvedVariant}\n        placement={placement}\n        keepOpenOnPointerDownOutside={keepOpenOnTriggerClick}\n      >\n        {tooltip}\n      </TooltipContent>\n    </TooltipRoot>\n  );\n};\n\nTooltip.Root = TooltipRoot;\nTooltip.Content = TooltipContent;\nTooltip.Trigger = TooltipTrigger;\n","import type { ComponentType } from 'react';\n\nimport { TooltipProvider } from '../components/Tooltip';\n\nexport const withTooltipProvider = (Story: ComponentType) => (\n  <TooltipProvider>\n    <Story />\n  </TooltipProvider>\n);\n\n// position:fixed only fills the Storybook iframe, not the browser window.\nexport const withHiddenFullscreen = (Story: ComponentType) => (\n  <div className=\"tw:[&_[aria-label=Fullscreen]]:hidden\">\n    <Story />\n  </div>\n);\n","export const createPrefixedString = (prefix: string) => (literals: TemplateStringsArray) =>\n  literals.reduce((acc, literal) => acc + literal, `${prefix}-`);\n","export const noop = () => void 0;\n","type DebouncedFn<T extends (...args: any[]) => void> = {\n  (...args: Parameters<T>): void;\n  cancel: () => void;\n};\n\nexport const debounce = <T extends (...args: any[]) => void>(\n  fn: T,\n  delay: number,\n): DebouncedFn<T> => {\n  let timeoutId: ReturnType<typeof setTimeout>;\n  const debounced = (...args: Parameters<T>) => {\n    clearTimeout(timeoutId);\n    timeoutId = setTimeout(() => fn(...args), delay);\n  };\n  debounced.cancel = () => clearTimeout(timeoutId);\n  return debounced;\n};\n","// Platform detection\ntype NavigatorUAData = {\n  platform: string;\n  brands: { brand: string; version: string }[];\n  mobile: boolean;\n};\n\nconst getIsMac = (): boolean => {\n  // Modern approach using navigator.userAgentData\n  if (typeof navigator !== 'undefined' && 'userAgentData' in navigator) {\n    const platform = (navigator.userAgentData as NavigatorUAData).platform;\n\n    if (typeof platform === 'string') {\n      return platform.toLowerCase() === 'macos';\n    }\n  }\n\n  if (typeof navigator !== 'undefined' && typeof navigator.platform === 'string') {\n    return navigator.platform.toUpperCase().indexOf('MAC') >= 0;\n  }\n\n  // Server-side rendering fallback\n  return false;\n};\n\nexport const isMac = getIsMac();\n","import { useEffect, useState } from 'react';\n\n// https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/digest#converting_a_digest_to_a_hex_string\nconst sha256 = async (text: string) => {\n  const msgUint8 = new TextEncoder().encode(text);\n  const hashBuffer = await crypto.subtle.digest('SHA-256', msgUint8);\n  const hashArray = Array.from(new Uint8Array(hashBuffer));\n  return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');\n};\n\nexport const useSHA256 = (text?: string) => {\n  const [hash, setHash] = useState('');\n\n  useEffect(() => {\n    if (!text) return;\n    let cancelled = false;\n    sha256(text).then((h) => {\n      if (!cancelled) setHash(h);\n    });\n    return () => {\n      cancelled = true;\n    };\n  }, [text]);\n\n  // Empty input has no hash — derive it during render instead of syncing state\n  // in the effect (avoids the extra render and a stale-value frame).\n  return text ? hash : '';\n};\n"],"mappings":";;;;;;;;;;;;;;;AAOA,MAAM,oBAAoB,SAAiB;CACzC,MAAM,OAAO,SAAS,cAAc,UAAU;CAC9C,KAAK,QAAQ;CACb,KAAK,aAAa,YAAY,EAAE;CAChC,KAAK,MAAM,UAAU;CACrB,SAAS,KAAK,OAAO,IAAI;CACzB,KAAK,OAAO;CAEZ,IAAI;EACF,OAAO,SAAS,YAAY,MAAM;CACpC,UAAU;EACR,KAAK,OAAO;CACd;AACF;AAEA,MAAa,kBAAkB,OAAO,SAAiB;CACrD,IAAI;EACF,MAAM,UAAU,UAAU,UAAU,IAAI;CAC1C,SAAS,OAAO;EACd,IAAI,CAAC,iBAAiB,IAAI,GAAG,MAAM;CACrC;AACF;;;AC1BA,MAAa,0BAA0B,UAA4B;CACjE,MAAM,cAA6C;EACjD,QAAQ;EACR,eAAe;EACf,MAAM;EACN,aAAa,IAAI,MAAM,UAAU,EAAE,SAAS,KAAK,CAAC;EAClD,SAAS;EACT,YAAY;EACZ,kBAAkB;EAClB,YAAY;EACZ,WAAW;EACX,sBAAsB,CAAC;EACvB,0BAA0B;EAC1B,uBAAuB,CAAC;EACxB,4BAA4B;EAC5B,eAAe,CAAC;EAChB,WAAW,KAAK,IAAI;CACtB;CAEA,OAAO,eAAe,aAAa,UAAU;EAC3C,OAAO;EACP,UAAU;CACZ,CAAC;CAED,OAAO;AACT;;;AC3BA,MAAa,WAAW;CACtB,OAAO;CACP,QAAQ;CACR,OAAO;AACT;;;ACGA,MAAM,kBAAkB,IACtB;CACE;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CAGA;CACA;CACA;CACA;AACF,GACA;CACE,iBAAiB,EACf,SAAS,SACX;CACA,UAAU,EACR,SAAS;EACP,QAAQ;GACN;GACA;GACA;GAEA;GACA;GACA;GAGA;GACA;GACA;GACA;EACF;EACA,aAAa;GACX;GACA;GACA;GACA;GAEA;GACA;EACF;CACF,EACF;AACF,CACF;AAQA,MAAa,kBAAkB,EAC7B,WACA,SACA,+BAA+B,OAC/B,UACA,sBACA,aAAa,GACb,mBAAmB,GACnB,mBAAmB,MACnB,YAAY,SACZ,GAAG,WACQ;CACX,MAAM,aAAa,cAAc;CAEjC,MAAM,4BACJ,UACG;EACH,IAAI,8BAA8B,MAAM,eAAe;EACvD,uBAAuB,KAAK;CAC9B;CAEA,OACE,oBAAC,QAAD,EAAA,UACE,oBAAC,SAAD;EACE,GAAI;EAGJ,wBAAsB,aAAa,KAAA,IAAY;EAC/C,aAAW;EACC;EACM;EAClB,sBAAsB;EACtB,WAAW,gBAAgB;GAAE;GAAW;EAAQ,CAAC;EAC/B;EAClB,MAAM;EAEL;CACM,CAAA,EACH,CAAA;AAEZ;;;AC7HA,MAAM,qBAAqB;AAE3B,MAAa,eAAe,EAAE,UAAU,gBAAgB,oBAAoB,GAAG,WAC7E,oBAACA,QAAD;CAAM,GAAI;CAAqB;CAC5B;AACG,CAAA;;;;;;;;;;;;ACKR,MAAM,uBAAuB,EAC3B,UACA,GAAG,YAG0D;CAC7D,MAAM,EAAE,cAAc,eAAe,GAAG,SAAS;CAEjD,OAAO,oBAAC,MAAD;EAAM,GAAI;EAAO;CAAe,CAAA;AACzC;AAMA,MAAa,kBAAkB,EAC7B,KACA,UACA,WACA,kBAAkB,OAClB,SACA,eACA,SACA,GAAG,WACQ;CACX,MAAM,eAA0D,UAAU;EACxE,IAAI,iBAAiB,MAAM,eAAe;EAC1C,UAAU,KAAK;CACjB;CAEA,MAAM,qBAAsE,UAAU;EACpF,IAAI,iBAAiB,MAAM,eAAe;EAC1C,gBAAgB,KAAK;CACvB;CAEA,OACE,oBAAC,SAAD;EACE,GAAI;EACJ,SAAA;EACK;EACL,WAAW,GAAG,yBAAyB,SAAS;EAChD,SAAS;EACT,eAAe;EAEd,UAAA,UACC,oBAAC,qBAAD,EAAsB,SAA8B,CAAA,IAQpD,oBAAC,QAAD;GAAM,WAAU;GAAkC;EAAe,CAAA;CAE5D,CAAA;AAEb;;;AC7DA,MAAM,uBAAuB;;AA4B7B,MAAa,kBAAkB;;;;;;;;;;;;;;;AAgB/B,MAAa,WAAW,EACtB,SACA,UACA,WACA,yBAAyB,OACzB,SACA,YAAY,SACZ,YAAY,OACZ,YAAY,OACZ,eAEA,iBAAiB,YACN;CACX,MAAM,CAAC,MAAM,WAAW,SAAS,KAAK;CAEtC,MAAM,yBAAyB;EAC7B,IAAI,CAAC,CAAC,SAAS,OAAO;EACtB,IAAI,OAAO,YAAY,YAAY,QAAQ,SAAS,sBAAsB,OAAO;EAEjF,OAAO;CACT,EAAA,CAAG;CAEH,MAAM,kBAAkB,oBAAoB;CAE5C,MAAM,eAA0D,UAAU;EACxE,IAAI,CAAC,CAAC,SAAS,OAAO,SAAS,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG;EAC3D,MAAM,gBAAgB;CACxB;CAEA,OACE,qBAAC,aAAD;EACE,MAAM,CAAC,CAAC,YAAY,QAAQ,cAAc,CAAC;EAC3C,cAAc;EACC;EACf,yBAAyB;EAJ3B,UAAA,CAME,oBAAC,gBAAD;GACE,SAAS;GACT,iBAAiB;GACjB,SAAS;GAER;EACa,CAAA,GAEhB,oBAAC,gBAAD;GACa;GACX,SAAS;GACE;GACX,8BAA8B;GAE7B,UAAA;EACa,CAAA,CACL;;AAEjB;AAEA,QAAQ,OAAO;AACf,QAAQ,UAAU;AAClB,QAAQ,UAAU;;;AC7GlB,MAAa,uBAAuB,UAClC,oBAAC,iBAAD,EAAA,UACE,oBAAC,OAAD,CAAQ,CAAA,EACO,CAAA;AAInB,MAAa,wBAAwB,UACnC,oBAAC,OAAD;CAAK,WAAU;CACb,UAAA,oBAAC,OAAD,CAAQ,CAAA;AACL,CAAA;;;ACdP,MAAa,wBAAwB,YAAoB,aACvD,SAAS,QAAQ,KAAK,YAAY,MAAM,SAAS,GAAG,OAAO,EAAE;;;ACD/D,MAAa,aAAa,KAAK;;;ACK/B,MAAa,YACX,IACA,UACmB;CACnB,IAAI;CACJ,MAAM,aAAa,GAAG,SAAwB;EAC5C,aAAa,SAAS;EACtB,YAAY,iBAAiB,GAAG,GAAG,IAAI,GAAG,KAAK;CACjD;CACA,UAAU,eAAe,aAAa,SAAS;CAC/C,OAAO;AACT;;;ACTA,MAAM,iBAA0B;CAE9B,IAAI,OAAO,cAAc,eAAe,mBAAmB,WAAW;EACpE,MAAM,WAAY,UAAU,cAAkC;EAE9D,IAAI,OAAO,aAAa,UACtB,OAAO,SAAS,YAAY,MAAM;CAEtC;CAEA,IAAI,OAAO,cAAc,eAAe,OAAO,UAAU,aAAa,UACpE,OAAO,UAAU,SAAS,YAAY,CAAC,CAAC,QAAQ,KAAK,KAAK;CAI5D,OAAO;AACT;AAEA,MAAa,QAAQ,SAAS;;;ACtB9B,MAAM,SAAS,OAAO,SAAiB;CACrC,MAAM,WAAW,IAAI,YAAY,CAAC,CAAC,OAAO,IAAI;CAC9C,MAAM,aAAa,MAAM,OAAO,OAAO,OAAO,WAAW,QAAQ;CAEjE,OADkB,MAAM,KAAK,IAAI,WAAW,UAAU,CACvC,CAAC,CAAC,KAAK,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE;AACtE;AAEA,MAAa,aAAa,SAAkB;CAC1C,MAAM,CAAC,MAAM,WAAW,SAAS,EAAE;CAEnC,gBAAgB;EACd,IAAI,CAAC,MAAM;EACX,IAAI,YAAY;EAChB,OAAO,IAAI,CAAC,CAAC,MAAM,MAAM;GACvB,IAAI,CAAC,WAAW,QAAQ,CAAC;EAC3B,CAAC;EACD,aAAa;GACX,YAAY;EACd;CACF,GAAG,CAAC,IAAI,CAAC;CAIT,OAAO,OAAO,OAAO;AACvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keboola/design",
-  "version": "10.1.0",
+  "version": "11.0.1",
   "description": "Keboola UI platform design system — shadcn-aligned React primitives, Keboola-branded blocks, and the form bindings built on TanStack Form.",
   "license": "MIT",
   "type": "module",
@@ -140,7 +140,7 @@
     "storybook": "^10.2.19",
     "tailwindcss": "^4.3.3",
     "tailwindcss-scoped-preflight": "^4.0.6",
-    "tsup": "^8.5.1",
+    "tsdown": "^0.22.14",
     "tsx": "^4.19.4",
     "tw-animate-css": "^1.4.0",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
@@ -233,18 +233,18 @@
     "remark-gfm": "^4.0.1",
     "sonner": "^2.0.7",
     "tailwind-merge": "^3.6.0",
-    "@keboola/brand-registry": "^1.8.0",
-    "@keboola/codemirror-lang-sql": "^0.6.0",
-    "@keboola/tailwind-config": "^1.0.2"
+    "@keboola/codemirror-lang-sql": "^0.7.1",
+    "@keboola/tailwind-config": "^1.1.0",
+    "@keboola/brand-registry": "^1.9.2"
   },
   "scripts": {
     "dev": "storybook dev -p \"${PORT:-6006}\"",
     "build-storybook": "storybook build",
     "transit": "pnpm build",
     "build": "pnpm build:js && pnpm build:css",
-    "build:js": "tsup",
+    "build:js": "tsdown",
     "build:css": "tailwindcss -i src/styles.css -o dist/styles.css --minify",
-    "build:check": "attw --pack . --profile esm-only --exclude-entrypoints ./styles ./styles/compiled ./theme",
+    "build:check": "node ../../tooling/check-dist-exports.mjs && attw --pack . --profile esm-only --exclude-entrypoints ./styles ./styles/compiled ./theme",
     "test": "vitest run --config vite.config.ts --passWithNoTests --reporter=dot",
     "test:stories": "vitest run --config vitest.config.ts",
     "test:stories:coverage": "vitest run --config vitest.config.ts --coverage",
@@ -257,13 +257,14 @@
     "lint:format": "oxfmt --check",
     "lint:oxlint": "oxlint . --quiet",
     "lint:design": "designmd lint DESIGN.md",
-    "ci-checks": "pnpm check:api && pnpm check:icons && pnpm size",
+    "ci-checks": "pnpm check:api && pnpm check:icons && pnpm check:contrast && pnpm size",
     "size": "size-limit",
     "generate:api": "tsx scripts/generate-component-api.ts",
     "check:api": "tsx scripts/generate-component-api.ts --check",
     "audit:contrast": "tsx scripts/contrast-audit.ts",
     "type-check": "tsc",
     "generate:icons": "tsx scripts/generate-icon-exports.ts",
-    "check:icons": "tsx scripts/generate-icon-exports.ts && git diff --exit-code -- src/icons/index.ts"
+    "check:icons": "tsx scripts/generate-icon-exports.ts && git diff --exit-code -- src/icons/index.ts",
+    "check:contrast": "tsx scripts/contrast-audit.ts && git diff --exit-code -- CONTRAST-AUDIT.md"
   }
 }

package/src/styles.css

@@ -13,10 +13,16 @@
 @import 'react-day-picker/src/style.css';
 @import './theme.css';
 
-/* Tokens, the (extended) theme, typography + our custom variants/utilities stay
- * in JS, loaded via v4's `@config` bridge — this keeps `colors.ts` and the
- * ThemeProvider/brand runtime-swap model unchanged (channel triples consumed as
- * `rgb(var(--*) / <alpha>)`). */
+/* Test files name utility classes as data — `customUtilities.test.ts` compiles every custom
+ * utility by name, `brandNeutrality.test.ts` spells out colour literals — and v4 scans them like
+ * any other source, emitting those candidates into the bundle apps ship. Nothing a test alone
+ * mentions belongs in it. */
+@source not '**/*.test.{ts,tsx}';
+
+/* The remaining v3 token surface plus typography and scroll-fade stay in JS, loaded
+ * via v4's `@config` bridge — this keeps `colors.ts` and the ThemeProvider/brand
+ * runtime-swap model unchanged (channel triples consumed as `rgb(var(--*) / <alpha>)`).
+ * Anything an app authors belongs in `theme.css` instead: this bridge is design-only. */
 @config '../tailwind.config.js';
 
 /* Scoped, opt-in preflight — the v4 replacement for v3's
@@ -31,7 +37,7 @@
 /*
  * Semantic color tokens — read by Tailwind via rgb(var(--*) / <alpha-value>) in
  * packages/tailwind-config/colors.ts. Channel values are stored as space-separated RGB so
- * Tailwind opacity modifiers (e.g. `tw-bg-muted/50`) resolve correctly.
+ * Tailwind opacity modifiers (e.g. `tw:bg-muted/50`) resolve correctly.
  * Primitive scales (neutral-*, primary-*, error-*, warning-*, etc.) remain hardcoded in colors.ts.
  */
 :root {
@@ -119,6 +125,14 @@
      with a black shadow so it doesn't read as a light halo on dark surfaces. */
   --shadow-raised: 0 2px 6px 0 rgb(100 135 153 / 0.13);
 
+  /* Runtime mirrors of the `shadow-card` / `shadow-table` @theme tokens, so a rule
+     can read `var(--shadow-card)` and follow the colour scheme. Declared here rather
+     than left to @theme: v4 inlines an @theme value into the utility it generates and
+     emits no custom property for it, so `var(--shadow-table)` would resolve to nothing
+     and drop the shadow entirely. Values match theme.css; the dark block overrides both. */
+  --shadow-card: 0px 1px 4px rgb(100 135 153 / 0.15);
+  --shadow-table: 0px 6px 6px -4px rgb(100 135 153 / 0.13);
+
   /* Typography pairing — display + mono faces; a brand overrides via
      `theme.typography.fontDisplay` / `fontMono`. Display defaults to the body
      face (`--font-sans`), then the canonical Inter stack, so unset brands keep
@@ -250,6 +264,20 @@
      blue-gray, which reads as a halo around Card / Search on dark surfaces. */
   --shadow-raised: 0 2px 6px 0 rgb(0 0 0 / 0.4);
 
+  /* Same correction for the two elevation tokens apps author directly — the pale
+     blue-gray lights up against a dark surface instead of reading as depth, and under
+     a sticky table header it read as a glowing seam. `--shadow-table` is softer than
+     `--shadow-raised` because the header casts a full-width band.
+
+     Reaches rules that read `var(--shadow-table)` / `var(--shadow-card)` directly,
+     which is how kbc-ui's Less consumes them. It does NOT reach the `shadow-table` /
+     `shadow-card` Tailwind utilities: those are `@theme` tokens (theme.css), so v4
+     inlines the light literal into the generated class at build time. Making the
+     utilities scheme-aware needs the token to carry a `var(--runtime, fallback)`
+     shape, which is a separate change with control-ui / boilerplate to verify against. */
+  --shadow-card: 0px 1px 4px rgb(0 0 0 / 0.4);
+  --shadow-table: 0px 6px 6px -4px rgb(0 0 0 / 0.3);
+
   /* Table header — lighter than card so the header row reads as raised on dark
      (light value is the tailwind-config fallback: 219 225 235). */
   --table-header: 54 55 65;
@@ -292,8 +320,8 @@
   html {
     /* Brand font opt-in: a brand's `typography.fontFamily` is injected as
        `--font-sans` by ThemeProvider and inherited from `html`; absent a brand
-       the fallback reproduces the canonical `tw-font-sans` stack so default
-       rendering is unchanged. Elements that set `tw-font-sans` explicitly also
+       the fallback reproduces the canonical `tw:font-sans` stack so default
+       rendering is unchanged. Elements that set `tw:font-sans` explicitly also
        follow the brand — the Tailwind `fontFamily.sans` scale reads `--font-sans`
        with the same `Inter` fallback. */
     font-family: var(

package/src/theme.css

@@ -11,6 +11,20 @@
  * design AND every v4 app) so those utilities resolve again. Each token keeps the
  * v3 `var(--runtime-var, fallback)` shape so `ThemeProvider` can still re-skin it. */
 @theme {
+  /* Body face — `font-sans`. Design keeps the v3 `fontFamily.sans` scale through its
+   * `@config` bridge, but the apps have no such bridge, so there `font-sans` resolved
+   * to v4's stock stack: no `Inter`, no brand hook. Every element that sets the
+   * utility explicitly (top-bar nav, inputs, menu descriptions) therefore rendered in
+   * a system face while its siblings inherited Inter from `html`. Re-registering the
+   * token restores the v3 value: the brand's `--font-sans` (emitted by ThemeProvider)
+   * first, then the canonical Inter stack. Safe as a @theme token because the emitted
+   * name is prefixed (`--tw-font-sans`) and so cannot cycle with the runtime var it
+   * reads — unlike `font-display`, which must stay an @utility. */
+  --font-sans:
+    var(--font-sans, Inter), system-ui, -apple-system, 'Segoe UI', Roboto, 'Helvetica Neue', Arial,
+    'Noto Sans', 'Liberation Sans', sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji',
+    'Segoe UI Symbol', 'Noto Color Emoji';
+
   /* Legacy Bootstrap-era breakpoints (screens). */
   --breakpoint-sm-legacy: 992px;
   --breakpoint-md-legacy: 1092px;
@@ -32,6 +46,12 @@
   --shadow-table: 0px 6px 6px -4px rgba(100, 135, 153, 0.13);
   --radius-card: 10px;
 
+  /* Raised-surface elevation — `shadow-raised`. Dark-aware: `styles.css` flips the runtime
+   * `--shadow-raised` to a black shadow under `[data-theme='dark']`. Reading a var of the same
+   * name is safe here because the emitted token is prefixed (`--tw-shadow-raised`), so the two
+   * cannot cycle — same reasoning as `--font-sans` above. */
+  --shadow-raised: var(--shadow-raised, 0 2px 6px 0 rgb(100 135 153 / 0.13));
+
   /* Brand easing — `ease-brand`. The runtime override var (`--motion-easing`) differs from
    * this @theme token name, so registering it here drops no fallback (unlike bg-brand /
    * shadow-lift, whose runtime var name collides → they stay @utility below). */
@@ -41,6 +61,12 @@
   --animate-progress-bar: progress-bar var(--progress-bar-duration, 3s) linear forwards;
   --animate-spinner-dots: spinner-dots 1s ease-in-out infinite;
   --animate-marching-ants: marching-ants 1s linear infinite;
+
+  /* Collapsible disclosure — keyframes below. `tw-animate-css` owns `collapsible-down`/`-up`
+   * and every app imports it unlayered, so those two names are unusable here.
+   * 300ms `ease` is the motion the retired `Collapse` had. */
+  --animate-collapsible-open: collapsible-open 300ms ease;
+  --animate-collapsible-close: collapsible-close 300ms ease;
 }
 
 @keyframes progress-bar {
@@ -68,6 +94,29 @@
     stroke-dashoffset: -12;
   }
 }
+/* `overflow` animates discretely — it flips mid-animation, so both endpoints must clip for the
+ * content to stay inside the box the whole way. No fill mode, so a settled-open panel is back to
+ * its own `overflow: visible` at its own height. */
+@keyframes collapsible-open {
+  from {
+    height: 0;
+    overflow: hidden;
+  }
+  to {
+    height: var(--radix-collapsible-content-height);
+    overflow: hidden;
+  }
+}
+@keyframes collapsible-close {
+  from {
+    height: var(--radix-collapsible-content-height);
+    overflow: hidden;
+  }
+  to {
+    height: 0;
+    overflow: hidden;
+  }
+}
 
 /* Fallback-chain utilities (kept as @utility, not @theme, so the runtime-var +
  * fallback chain is preserved exactly as v3 emitted it — a @theme token whose name
@@ -100,6 +149,21 @@
     sans-serif;
 }
 
+/* Interaction-state variant — `not-disabled:hover:…`. Skips BOTH ways a control reports being
+ * disabled; v4's core `not-*` compound reads the same name as `:not(:disabled)` alone, so this
+ * deliberately shadows it. That shadowing is why the variant has to live here and not in an
+ * `addVariant` in design's `@config` plugin: an app's own build has no bridge to that plugin, so
+ * it fell through to the core variant and silently dropped the `data-disabled` half — every
+ * `tw:not-disabled:*` class kbc-ui authors that design's compiled CSS did not already carry
+ * still highlighted a `[data-disabled="true"]` control on hover and focus. */
+@custom-variant not-disabled (&:not([data-disabled="true"]):not(:disabled));
+
+/* `overflow-wrap: anywhere` — no v4 core utility covers it (`break-words` is `break-word`,
+ * which keeps long unbroken tokens overflowing). Authored in 16 app files. */
+@utility break-anywhere {
+  overflow-wrap: anywhere;
+}
+
 @theme inline {
   --color-inherit: inherit;
   --color-transparent: rgba(255, 255, 255, 0);

package/dist/MermaidDiagram-EOKJHQQV.js

@@ -1,10 +0,0 @@
-export { MermaidDiagram } from './chunk-KPNAW5MU.js';
-import './chunk-IJTHFNNJ.js';
-import './chunk-VPPM7UUQ.js';
-import './chunk-L37JJ6MR.js';
-import './chunk-CTCFYWJC.js';
-import './chunk-BOHNXTMM.js';
-import './chunk-63NSN2VL.js';
-import './chunk-JP7PNHLH.js';
-//# sourceMappingURL=MermaidDiagram-EOKJHQQV.js.map
-//# sourceMappingURL=MermaidDiagram-EOKJHQQV.js.map

package/dist/MermaidDiagram-EOKJHQQV.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"MermaidDiagram-EOKJHQQV.js"}