@dashforge/tw 1.4.0 → 1.5.0

package/dist/index.esm.js

@@ -1,5 +1,5 @@
-import { jsxs, jsx, Fragment as Fragment$1 } from 'react/jsx-runtime';
-import { useMemo, forwardRef, useContext, useState, useEffect, useRef, useId, useCallback, Fragment, createContext, Children, isValidElement, memo, cloneElement, useLayoutEffect } from 'react';
+import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
+import { useMemo, forwardRef, useContext, useState, useEffect, useRef, useId, useCallback, Fragment as Fragment$1, createContext, Children, isValidElement, memo, cloneElement, useLayoutEffect } from 'react';
 import { Slot } from '@radix-ui/react-slot';
 import { DashFormContext, useEngineVisibility } from '@dashforge/ui-core';
 import { useComponentDefaults } from '@dashforge/tw-theme';
@@ -9,6 +9,7 @@ import { useRbacOptional, resolveAccessState } from '@dashforge/rbac';
 import { tv } from 'tailwind-variants';
 export { tv } from 'tailwind-variants';
 import { useDashFieldMeta } from '@dashforge/forms';
+import * as RadixTooltip from '@radix-ui/react-tooltip';
 import * as RadixCheckbox from '@radix-ui/react-checkbox';
 import * as RadixSwitch from '@radix-ui/react-switch';
 import * as RadixRadioGroup from '@radix-ui/react-radio-group';
@@ -17,7 +18,6 @@ import * as RadixPopover from '@radix-ui/react-popover';
 import * as RadixDialog from '@radix-ui/react-dialog';
 import * as RadixSlider from '@radix-ui/react-slider';
 import * as RadixMenu from '@radix-ui/react-dropdown-menu';
-import * as RadixTooltip from '@radix-ui/react-tooltip';
 import * as RadixAccordion from '@radix-ui/react-accordion';
 
 function _extends() {
@@ -630,6 +630,172 @@ Spinner.displayName = 'Spinner';
     }));
 });
 
+const tooltipVariants = tv({
+    slots: {
+        content: [
+            'z-50 max-w-xs rounded-md px-3 py-1.5 text-xs font-medium',
+            // Auto-invert via the dashforgePreset() CSS-var swap:
+            //  - Light mode: `bg-neutral-900` = #171717 (dark surface) +
+            //    `text-neutral-50` = #fafafa (light text) — DARK tooltip
+            //    on the light page (high contrast).
+            //  - Dark mode: `bg-neutral-900` flips to #f5f5f5 (light) +
+            //    `text-neutral-50` flips to #0a0a0a (dark text) — LIGHT
+            //    tooltip on the dark page (high contrast against page).
+            // Adding `dark:bg-neutral-50 dark:text-neutral-900` (the old
+            // pattern) would force the dark-mode tooltip back to a dark
+            // surface — invisible against the dark page.
+            'bg-neutral-900 text-neutral-50',
+            'shadow-md',
+            'data-[state=delayed-open]:animate-in data-[state=delayed-open]:fade-in-0 data-[state=delayed-open]:zoom-in-95',
+            'data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95',
+            'motion-reduce:transition-none motion-reduce:duration-0'
+        ],
+        // Arrow tracks the content bg — auto-inverts the same way.
+        arrow: 'fill-neutral-900'
+    }
+});
+
+/**
+ * Dashforge TW `<Tooltip>` — hoverable / focusable tooltip.
+ *
+ * Built on `@radix-ui/react-tooltip`:
+ *  - APG tooltip pattern: `role="tooltip"`, `aria-describedby` wired
+ *    to the trigger automatically (Radix manages the id linkage).
+ *  - Shows on hover OR keyboard focus.
+ *  - Dismissed on Escape or pointer leave.
+ *
+ * Wrap any single React node — it becomes the trigger via Radix's
+ * `asChild` slot. The trigger inherits `aria-describedby` so screen
+ * readers announce the tooltip content along with the trigger.
+ *
+ * @example
+ * ```tsx
+ * <Tooltip content="Delete this item">
+ *   <Button variant="ghost">
+ *     <TrashIcon />
+ *   </Button>
+ * </Tooltip>
+ * ```
+ *
+ * Each consumer can also wrap the entire app once in
+ * `<RadixTooltip.Provider>` to share delay/skip configuration; we
+ * include a per-component provider here for ease-of-use.
+ */ function Tooltip(props) {
+    var _themeSlotProps_content, _slotProps_content, _themeSlotProps_arrow, _slotProps_arrow;
+    const themeDefaults = useComponentDefaults('Tooltip');
+    const merged = _extends({}, themeDefaults == null ? void 0 : themeDefaults.defaults, props);
+    const themeSlotProps = themeDefaults == null ? void 0 : themeDefaults.slotProps;
+    const { children, content, side = 'top', align = 'center', hideArrow = false, delayDuration = 200, open, onOpenChange, sideOffset = 4, sx, slotProps } = merged;
+    const v = tooltipVariants();
+    return jsx(RadixTooltip.Provider, {
+        delayDuration: delayDuration,
+        children: jsxs(RadixTooltip.Root, {
+            open: open,
+            onOpenChange: onOpenChange,
+            children: [
+                jsx(RadixTooltip.Trigger, {
+                    asChild: true,
+                    children: children
+                }),
+                jsx(RadixTooltip.Portal, {
+                    children: jsxs(RadixTooltip.Content, {
+                        side: side,
+                        align: align,
+                        sideOffset: sideOffset,
+                        className: cn(v.content(), sx, themeSlotProps == null ? void 0 : (_themeSlotProps_content = themeSlotProps.content) == null ? void 0 : _themeSlotProps_content.className, slotProps == null ? void 0 : (_slotProps_content = slotProps.content) == null ? void 0 : _slotProps_content.className),
+                        children: [
+                            content,
+                            !hideArrow && jsx(RadixTooltip.Arrow, {
+                                className: cn(v.arrow(), themeSlotProps == null ? void 0 : (_themeSlotProps_arrow = themeSlotProps.arrow) == null ? void 0 : _themeSlotProps_arrow.className, slotProps == null ? void 0 : (_slotProps_arrow = slotProps.arrow) == null ? void 0 : _slotProps_arrow.className)
+                            })
+                        ]
+                    })
+                })
+            ]
+        })
+    });
+}
+
+/** Normalise `string | config` to a config (or null when absent). */ function normalizeFieldTooltip(tooltip) {
+    if (tooltip == null) return null;
+    return typeof tooltip === 'string' ? {
+        content: tooltip
+    } : tooltip;
+}
+/**
+ * Resolve the effective tooltip config (Option C): deep-merge the
+ * per-instance `tooltip` over the theme default. The instance wins per
+ * key, so the theme can set `icon` / `position` / `side` while the
+ * instance supplies just `content` (via the string shorthand).
+ */ function resolveFieldTooltip(instance, themeDefault) {
+    const inst = normalizeFieldTooltip(instance);
+    const base = normalizeFieldTooltip(themeDefault);
+    if (!inst && !base) return null;
+    if (!inst) return base;
+    if (!base) return inst;
+    return _extends({}, base, inst);
+}
+/** Built-in default trigger icon — inline SVG, no external dependency. */ function InfoCircleIcon() {
+    return jsxs("svg", {
+        width: "16",
+        height: "16",
+        viewBox: "0 0 24 24",
+        fill: "none",
+        stroke: "currentColor",
+        strokeWidth: "1.7",
+        strokeLinecap: "round",
+        strokeLinejoin: "round",
+        "aria-hidden": "true",
+        children: [
+            jsx("circle", {
+                cx: "12",
+                cy: "12",
+                r: "9"
+            }),
+            jsx("path", {
+                d: "M12 16v-4"
+            }),
+            jsx("path", {
+                d: "M12 8h.01"
+            })
+        ]
+    });
+}
+/** The focusable ⓘ trigger + the Radix-based `<Tooltip>` popup. */ function LabelTooltipTrigger({ config }) {
+    const { content, icon, position = 'after', side = 'top' } = config;
+    return jsx(Tooltip, {
+        content: content,
+        side: side,
+        children: jsx("button", {
+            type: "button",
+            "aria-label": "More information",
+            className: cn('inline-flex items-center justify-center align-middle leading-none text-neutral-500 hover:text-neutral-700 cursor-help', position === 'before' ? 'mr-1' : 'ml-1'),
+            children: icon != null ? icon : jsx(InfoCircleIcon, {})
+        })
+    });
+}
+/**
+ * Compose a label node with its help-tooltip trigger. Pass the resolved
+ * config (from {@link resolveFieldTooltip}) or `null`. Returns the plain
+ * label when there is no tooltip.
+ */ function renderLabelWithTooltip(label, config) {
+    if (!config) return label;
+    const trigger = jsx(LabelTooltipTrigger, {
+        config: config
+    });
+    return config.position === 'before' ? jsxs(Fragment, {
+        children: [
+            trigger,
+            label
+        ]
+    }) : jsxs(Fragment, {
+        children: [
+            label,
+            trigger
+        ]
+    });
+}
+
 /**
  * `useStandaloneFieldWarning` — dev-only guard for `@dashforge/tw` form
  * widgets rendered outside a `DashFormProvider` and without a controlled
@@ -849,10 +1015,12 @@ Spinner.displayName = 'Spinner';
  *   - `aria-describedby` links the input to the helper/error text node.
  *   - Required fields get the native `required` attribute + a visual `*`.
  */ function TextField(props) {
-    var _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_inputWrapper, _slotProps_inputWrapper, _slotProps_prefix, _themeSlotProps_input, _slotProps_input, _slotProps_suffix, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
+    var _themeDefaults_defaults, _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_inputWrapper, _slotProps_inputWrapper, _slotProps_prefix, _themeSlotProps_input, _slotProps_input, _slotProps_suffix, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
     const themeDefaults = useComponentDefaults('TextField');
     const merged = _extends({}, themeDefaults == null ? void 0 : themeDefaults.defaults, props);
     const themeSlotProps = themeDefaults == null ? void 0 : themeDefaults.slotProps;
+    // Option C deep-merge: instance `tooltip` over `theme…defaults.tooltip`.
+    const tooltipConfig = resolveFieldTooltip(props.tooltip, themeDefaults == null ? void 0 : (_themeDefaults_defaults = themeDefaults.defaults) == null ? void 0 : _themeDefaults_defaults.tooltip);
     const { name, rules, visibleWhen, layout = 'stacked', size, label, helperText, required, error, disabled, fullWidth, access, sx, slotProps, placeholder, type, onChange: userOnChange, onBlur: userOnBlur, value: userValue, defaultValue } = merged, rest = _object_without_properties_loose(merged, [
         "name",
         "rules",
@@ -975,7 +1143,7 @@ Spinner.displayName = 'Spinner';
                 htmlFor: inputId,
                 className: cn(v.label(), themeSlotProps == null ? void 0 : (_themeSlotProps_label = themeSlotProps.label) == null ? void 0 : _themeSlotProps_label.className, slotProps == null ? void 0 : (_slotProps_label = slotProps.label) == null ? void 0 : _slotProps_label.className),
                 children: [
-                    label,
+                    renderLabelWithTooltip(label, tooltipConfig),
                     required && jsx("span", {
                         "aria-hidden": "true",
                         className: cn(v.requiredMark(), themeSlotProps == null ? void 0 : (_themeSlotProps_requiredMark = themeSlotProps.requiredMark) == null ? void 0 : _themeSlotProps_requiredMark.className, slotProps == null ? void 0 : (_slotProps_requiredMark = slotProps.requiredMark) == null ? void 0 : _slotProps_requiredMark.className),
@@ -1169,10 +1337,12 @@ Spinner.displayName = 'Spinner';
  *    rather than MUI slot components.
  */ function Checkbox(props) {
     var _ref;
-    var _themeSlotProps_root, _slotProps_root, _themeSlotProps_control, _slotProps_control, _themeSlotProps_indicator, _slotProps_indicator, _themeSlotProps_label, _slotProps_label, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
+    var _themeDefaults_defaults, _themeSlotProps_root, _slotProps_root, _themeSlotProps_control, _slotProps_control, _themeSlotProps_indicator, _slotProps_indicator, _themeSlotProps_label, _slotProps_label, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
     const themeDefaults = useComponentDefaults('Checkbox');
     const merged = _extends({}, themeDefaults == null ? void 0 : themeDefaults.defaults, props);
     const themeSlotProps = themeDefaults == null ? void 0 : themeDefaults.slotProps;
+    // Option C deep-merge: instance `tooltip` over `theme…defaults.tooltip`.
+    const tooltipConfig = resolveFieldTooltip(props.tooltip, themeDefaults == null ? void 0 : (_themeDefaults_defaults = themeDefaults.defaults) == null ? void 0 : _themeDefaults_defaults.tooltip);
     const { name, rules, visibleWhen, label, helperText, error, access, size, disabled, checked, defaultChecked, onCheckedChange, sx, slotProps } = merged;
     // ───── Hooks (always called, unconditional) ─────
     const bridge = useContext(DashFormContext);
@@ -1310,7 +1480,7 @@ Spinner.displayName = 'Spinner';
                     label && jsx("label", {
                         htmlFor: controlId,
                         className: cn(v.label(), themeSlotProps == null ? void 0 : (_themeSlotProps_label = themeSlotProps.label) == null ? void 0 : _themeSlotProps_label.className, slotProps == null ? void 0 : (_slotProps_label = slotProps.label) == null ? void 0 : _slotProps_label.className),
-                        children: label
+                        children: renderLabelWithTooltip(label, tooltipConfig)
                     }),
                     resolvedHelperText && jsx("p", {
                         className: cn(resolvedError ? v.errorText() : v.helperText(), resolvedError ? [
@@ -1407,10 +1577,12 @@ Spinner.displayName = 'Spinner';
  *    translate-x distance so the knob lands flush at each end.
  */ function Switch(props) {
     var _ref;
-    var _themeSlotProps_root, _slotProps_root, _themeSlotProps_control, _slotProps_control, _themeSlotProps_thumb, _slotProps_thumb, _themeSlotProps_label, _slotProps_label, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
+    var _themeDefaults_defaults, _themeSlotProps_root, _slotProps_root, _themeSlotProps_control, _slotProps_control, _themeSlotProps_thumb, _slotProps_thumb, _themeSlotProps_label, _slotProps_label, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
     const themeDefaults = useComponentDefaults('Switch');
     const merged = _extends({}, themeDefaults == null ? void 0 : themeDefaults.defaults, props);
     const themeSlotProps = themeDefaults == null ? void 0 : themeDefaults.slotProps;
+    // Option C deep-merge: instance `tooltip` over `theme…defaults.tooltip`.
+    const tooltipConfig = resolveFieldTooltip(props.tooltip, themeDefaults == null ? void 0 : (_themeDefaults_defaults = themeDefaults.defaults) == null ? void 0 : _themeDefaults_defaults.tooltip);
     const { name, rules, visibleWhen, label, helperText, error, access, size, disabled, checked, defaultChecked, onCheckedChange, sx, slotProps } = merged;
     const bridge = useContext(DashFormContext);
     const isVisible = useEngineVisibility(bridge == null ? void 0 : bridge.engine, visibleWhen);
@@ -1522,7 +1694,7 @@ Spinner.displayName = 'Spinner';
                     label && jsx("label", {
                         htmlFor: controlId,
                         className: cn(v.label(), themeSlotProps == null ? void 0 : (_themeSlotProps_label = themeSlotProps.label) == null ? void 0 : _themeSlotProps_label.className, slotProps == null ? void 0 : (_slotProps_label = slotProps.label) == null ? void 0 : _slotProps_label.className),
-                        children: label
+                        children: renderLabelWithTooltip(label, tooltipConfig)
                     }),
                     resolvedHelperText && jsx("p", {
                         className: cn(resolvedError ? v.errorText() : v.helperText(), resolvedError ? [
@@ -1660,10 +1832,12 @@ Spinner.displayName = 'Spinner';
  *     keyboard-accessible by default (arrow keys move selection).
  */ function RadioGroup(props) {
     var _ref;
-    var _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_optionList, _slotProps_optionList, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
+    var _themeDefaults_defaults, _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_optionList, _slotProps_optionList, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
     const themeDefaults = useComponentDefaults('RadioGroup');
     const merged = _extends({}, themeDefaults == null ? void 0 : themeDefaults.defaults, props);
     const themeSlotProps = themeDefaults == null ? void 0 : themeDefaults.slotProps;
+    // Option C deep-merge: instance `tooltip` over `theme…defaults.tooltip`.
+    const tooltipConfig = resolveFieldTooltip(props.tooltip, themeDefaults == null ? void 0 : (_themeDefaults_defaults = themeDefaults.defaults) == null ? void 0 : _themeDefaults_defaults.tooltip);
     const { name, options, label, rules, helperText, required, error, disabled, size, layout, access, visibleWhen, sx, slotProps, value: explicitValue, defaultValue, onValueChange } = merged;
     // ───── Hooks (unconditional) ─────
     const bridge = useContext(DashFormContext);
@@ -1783,7 +1957,7 @@ Spinner.displayName = 'Spinner';
                 id: labelId,
                 className: cn(v.label(), themeSlotProps == null ? void 0 : (_themeSlotProps_label = themeSlotProps.label) == null ? void 0 : _themeSlotProps_label.className, slotProps == null ? void 0 : (_slotProps_label = slotProps.label) == null ? void 0 : _slotProps_label.className),
                 children: [
-                    label,
+                    renderLabelWithTooltip(label, tooltipConfig),
                     required && jsx("span", {
                         "aria-hidden": "true",
                         className: cn(v.requiredMark(), themeSlotProps == null ? void 0 : (_themeSlotProps_requiredMark = themeSlotProps.requiredMark) == null ? void 0 : _themeSlotProps_requiredMark.className, slotProps == null ? void 0 : (_slotProps_requiredMark = slotProps.requiredMark) == null ? void 0 : _slotProps_requiredMark.className),
@@ -1950,10 +2124,12 @@ Spinner.displayName = 'Spinner';
  * `aria-describedby` links to the helper/error text node, required
  * fields get the native `required` attribute + a visual `*`.
  */ function Textarea(props) {
-    var _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_inputWrapper, _slotProps_inputWrapper, _themeSlotProps_input, _slotProps_input, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
+    var _themeDefaults_defaults, _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_inputWrapper, _slotProps_inputWrapper, _themeSlotProps_input, _slotProps_input, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
     const themeDefaults = useComponentDefaults('Textarea');
     const merged = _extends({}, themeDefaults == null ? void 0 : themeDefaults.defaults, props);
     const themeSlotProps = themeDefaults == null ? void 0 : themeDefaults.slotProps;
+    // Option C deep-merge: instance `tooltip` over `theme…defaults.tooltip`.
+    const tooltipConfig = resolveFieldTooltip(props.tooltip, themeDefaults == null ? void 0 : (_themeDefaults_defaults = themeDefaults.defaults) == null ? void 0 : _themeDefaults_defaults.tooltip);
     const { name, rules, visibleWhen, layout = 'stacked', size, resize, label, helperText, required, error, disabled, fullWidth, access, sx, slotProps, placeholder, rows = 3, onChange: userOnChange, onBlur: userOnBlur, value: userValue, defaultValue } = merged, rest = _object_without_properties_loose(merged, [
         "name",
         "rules",
@@ -2065,7 +2241,7 @@ Spinner.displayName = 'Spinner';
                 htmlFor: inputId,
                 className: cn(v.label(), themeSlotProps == null ? void 0 : (_themeSlotProps_label = themeSlotProps.label) == null ? void 0 : _themeSlotProps_label.className, slotProps == null ? void 0 : (_slotProps_label = slotProps.label) == null ? void 0 : _slotProps_label.className),
                 children: [
-                    label,
+                    renderLabelWithTooltip(label, tooltipConfig),
                     required && jsx("span", {
                         "aria-hidden": "true",
                         className: cn(v.requiredMark(), themeSlotProps == null ? void 0 : (_themeSlotProps_requiredMark = themeSlotProps.requiredMark) == null ? void 0 : _themeSlotProps_requiredMark.className, slotProps == null ? void 0 : (_slotProps_requiredMark = slotProps.requiredMark) == null ? void 0 : _slotProps_requiredMark.className),
@@ -2251,10 +2427,12 @@ Spinner.displayName = 'Spinner';
  *    `aria-valuemin` / `aria-valuemax` automatically)
  */ function NumberField(props) {
     var _parseFromInput, _parseFromInput1;
-    var _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_inputWrapper, _slotProps_inputWrapper, _themeSlotProps_input, _slotProps_input, _themeSlotProps_stepper, _slotProps_stepper, _themeSlotProps_stepperButton, _slotProps_stepperButton, _themeSlotProps_stepperButton1, _slotProps_stepperButton1, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
+    var _themeDefaults_defaults, _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_inputWrapper, _slotProps_inputWrapper, _themeSlotProps_input, _slotProps_input, _themeSlotProps_stepper, _slotProps_stepper, _themeSlotProps_stepperButton, _slotProps_stepperButton, _themeSlotProps_stepperButton1, _slotProps_stepperButton1, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
     const themeDefaults = useComponentDefaults('NumberField');
     const merged = _extends({}, themeDefaults == null ? void 0 : themeDefaults.defaults, props);
     const themeSlotProps = themeDefaults == null ? void 0 : themeDefaults.slotProps;
+    // Option C deep-merge: instance `tooltip` over `theme…defaults.tooltip`.
+    const tooltipConfig = resolveFieldTooltip(props.tooltip, themeDefaults == null ? void 0 : (_themeDefaults_defaults = themeDefaults.defaults) == null ? void 0 : _themeDefaults_defaults.tooltip);
     const { name, rules, visibleWhen, layout = 'stacked', size, label, helperText, required, error, disabled, fullWidth, access, sx, slotProps, placeholder, min, max, step = 1, showStepper = false, onChange: userOnChange, onBlur: userOnBlur, value: userValue, defaultValue } = merged, rest = _object_without_properties_loose(merged, [
         "name",
         "rules",
@@ -2409,7 +2587,7 @@ Spinner.displayName = 'Spinner';
                 htmlFor: inputId,
                 className: cn(v.label(), themeSlotProps == null ? void 0 : (_themeSlotProps_label = themeSlotProps.label) == null ? void 0 : _themeSlotProps_label.className, slotProps == null ? void 0 : (_slotProps_label = slotProps.label) == null ? void 0 : _slotProps_label.className),
                 children: [
-                    label,
+                    renderLabelWithTooltip(label, tooltipConfig),
                     required && jsx("span", {
                         "aria-hidden": "true",
                         className: cn(v.requiredMark(), themeSlotProps == null ? void 0 : (_themeSlotProps_requiredMark = themeSlotProps.requiredMark) == null ? void 0 : _themeSlotProps_requiredMark.className, slotProps == null ? void 0 : (_slotProps_requiredMark = slotProps.requiredMark) == null ? void 0 : _slotProps_requiredMark.className),
@@ -2582,10 +2760,12 @@ Spinner.displayName = 'Spinner';
  * `inputMode="numeric" | "text"` per mode + `autoComplete="one-time-code"`
  * so iOS Safari + Android Chrome trigger SMS autofill correctly.
  */ function OTPField(props) {
-    var _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_slotsRow, _slotProps_slotsRow, _themeSlotProps_hiddenInput, _slotProps_hiddenInput, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
+    var _themeDefaults_defaults, _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_slotsRow, _slotProps_slotsRow, _themeSlotProps_hiddenInput, _slotProps_hiddenInput, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
     const themeDefaults = useComponentDefaults('OTPField');
     const merged = _extends({}, themeDefaults == null ? void 0 : themeDefaults.defaults, props);
     const themeSlotProps = themeDefaults == null ? void 0 : themeDefaults.slotProps;
+    // Option C deep-merge: instance `tooltip` over `theme…defaults.tooltip`.
+    const tooltipConfig = resolveFieldTooltip(props.tooltip, themeDefaults == null ? void 0 : (_themeDefaults_defaults = themeDefaults.defaults) == null ? void 0 : _themeDefaults_defaults.tooltip);
     const { name, rules, visibleWhen, size, label, helperText, required, error, disabled, access, sx, slotProps, length = 6, mode = 'numeric', value: userValue, defaultValue, onChange: userOnChange, onComplete } = merged;
     // ───── Hooks (unconditional) ─────
     const bridge = useContext(DashFormContext);
@@ -2693,7 +2873,7 @@ Spinner.displayName = 'Spinner';
                 htmlFor: inputId,
                 className: cn(v.label(), themeSlotProps == null ? void 0 : (_themeSlotProps_label = themeSlotProps.label) == null ? void 0 : _themeSlotProps_label.className, slotProps == null ? void 0 : (_slotProps_label = slotProps.label) == null ? void 0 : _slotProps_label.className),
                 children: [
-                    label,
+                    renderLabelWithTooltip(label, tooltipConfig),
                     required && jsx("span", {
                         "aria-hidden": "true",
                         className: cn(v.requiredMark(), themeSlotProps == null ? void 0 : (_themeSlotProps_requiredMark = themeSlotProps.requiredMark) == null ? void 0 : _themeSlotProps_requiredMark.className, slotProps == null ? void 0 : (_slotProps_requiredMark = slotProps.requiredMark) == null ? void 0 : _slotProps_requiredMark.className),
@@ -3009,10 +3189,12 @@ const defaultGetOptionDisabled = (option)=>Boolean(option.disabled);
  * shapes, and async runtime options (`optionsFromFieldData`) are
  * deferred to F5-A-bis.
  */ function Autocomplete(props) {
-    var _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_inputWrapper, _slotProps_inputWrapper, _themeSlotProps_chipsList, _slotProps_chipsList, _themeSlotProps_input, _slotProps_input, _themeSlotProps_clearButton, _slotProps_clearButton, _themeSlotProps_trigger, _slotProps_trigger, _themeSlotProps_popover, _slotProps_popover, _themeSlotProps_listBox, _slotProps_listBox, _themeSlotProps_emptyState, _slotProps_emptyState, _themeSlotProps_emptyState1, _slotProps_emptyState1, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
+    var _themeDefaults_defaults, _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_inputWrapper, _slotProps_inputWrapper, _themeSlotProps_chipsList, _slotProps_chipsList, _themeSlotProps_input, _slotProps_input, _themeSlotProps_clearButton, _slotProps_clearButton, _themeSlotProps_trigger, _slotProps_trigger, _themeSlotProps_popover, _slotProps_popover, _themeSlotProps_listBox, _slotProps_listBox, _themeSlotProps_emptyState, _slotProps_emptyState, _themeSlotProps_emptyState1, _slotProps_emptyState1, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
     const themeDefaults = useComponentDefaults('Autocomplete');
     const merged = _extends({}, themeDefaults == null ? void 0 : themeDefaults.defaults, props);
     const themeSlotProps = themeDefaults == null ? void 0 : themeDefaults.slotProps;
+    // Option C deep-merge: instance `tooltip` over `theme…defaults.tooltip`.
+    const tooltipConfig = resolveFieldTooltip(props.tooltip, themeDefaults == null ? void 0 : (_themeDefaults_defaults = themeDefaults.defaults) == null ? void 0 : _themeDefaults_defaults.tooltip);
     const { name, rules, options, visibleWhen, layout = 'stacked', size, label, helperText, required, error, disabled, fullWidth, access, sx, slotProps, placeholder, value: explicitValue, defaultValue, onValueChange, emptyMessage = 'No matching options', getOptionValue = defaultGetOptionValue, getOptionLabel = defaultGetOptionLabel, getOptionDisabled = defaultGetOptionDisabled, getOptionKey, multiple, freeSolo, loadOptions, loadDebounceMs = 250, loadingMessage = 'Loading…' } = merged;
     const isMulti = Boolean(multiple);
     // Default the React-key accessor to `getOptionValue` (typical case:
@@ -3605,7 +3787,7 @@ const defaultGetOptionDisabled = (option)=>Boolean(option.disabled);
                 htmlFor: `${baseId}-input`,
                 className: cn(v.label(), themeSlotProps == null ? void 0 : (_themeSlotProps_label = themeSlotProps.label) == null ? void 0 : _themeSlotProps_label.className, slotProps == null ? void 0 : (_slotProps_label = slotProps.label) == null ? void 0 : _slotProps_label.className),
                 children: [
-                    label,
+                    renderLabelWithTooltip(label, tooltipConfig),
                     required && jsx("span", {
                         "aria-hidden": "true",
                         className: cn(v.requiredMark(), themeSlotProps == null ? void 0 : (_themeSlotProps_requiredMark = themeSlotProps.requiredMark) == null ? void 0 : _themeSlotProps_requiredMark.className, slotProps == null ? void 0 : (_slotProps_requiredMark = slotProps.requiredMark) == null ? void 0 : _slotProps_requiredMark.className),
@@ -4202,10 +4384,12 @@ function CalendarIcon$2() {
  * Storage contract: an ISO `YYYY-MM-DD` string, or `null` — shared with the
  * MUI `@dashforge/ui` `DatePicker`.
  */ function DatePicker(_props) {
-    var _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_trigger, _slotProps_trigger, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
+    var _themeDefaults_defaults, _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_trigger, _slotProps_trigger, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
     const themeDefaults = useComponentDefaults('DatePicker');
     const props = _extends({}, themeDefaults == null ? void 0 : themeDefaults.defaults, _props);
     const themeSlotProps = themeDefaults == null ? void 0 : themeDefaults.slotProps;
+    // Option C deep-merge: instance `tooltip` over `theme…defaults.tooltip`.
+    const tooltipConfig = resolveFieldTooltip(_props.tooltip, themeDefaults == null ? void 0 : (_themeDefaults_defaults = themeDefaults.defaults) == null ? void 0 : _themeDefaults_defaults.tooltip);
     const { name, rules, label, helperText, error, required, disabled, placeholder, layout = 'stacked', visibleWhen, access, value: explicitValue, defaultValue, onChange, minDate, maxDate, disabledDates, isDateDisabled, weekStartDay, locale, fullWidth, sx, slotProps, testId } = props;
     // ───── Hooks (unconditional, before any early return) ─────
     const bridge = useContext(DashFormContext);
@@ -4335,7 +4519,7 @@ function CalendarIcon$2() {
                 htmlFor: fieldId,
                 className: cn(v.label(), themeSlotProps == null ? void 0 : (_themeSlotProps_label = themeSlotProps.label) == null ? void 0 : _themeSlotProps_label.className, slotProps == null ? void 0 : (_slotProps_label = slotProps.label) == null ? void 0 : _slotProps_label.className),
                 children: [
-                    label,
+                    renderLabelWithTooltip(label, tooltipConfig),
                     required && jsx("span", {
                         "aria-hidden": "true",
                         className: cn(v.requiredMark(), themeSlotProps == null ? void 0 : (_themeSlotProps_requiredMark = themeSlotProps.requiredMark) == null ? void 0 : _themeSlotProps_requiredMark.className, slotProps == null ? void 0 : (_slotProps_requiredMark = slotProps.requiredMark) == null ? void 0 : _slotProps_requiredMark.className),
@@ -4479,10 +4663,12 @@ function ClockIcon() {
  * shared with the MUI `@dashforge/ui` `TimePicker`. `hour12` is display-only.
  */ function TimePicker(_props) {
     var _timeStringToMinutes, _timeStringToMinutes1;
-    var _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_trigger, _slotProps_trigger, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
+    var _themeDefaults_defaults, _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_trigger, _slotProps_trigger, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
     const themeDefaults = useComponentDefaults('TimePicker');
     const props = _extends({}, themeDefaults == null ? void 0 : themeDefaults.defaults, _props);
     const themeSlotProps = themeDefaults == null ? void 0 : themeDefaults.slotProps;
+    // Option C deep-merge: instance `tooltip` over `theme…defaults.tooltip`.
+    const tooltipConfig = resolveFieldTooltip(_props.tooltip, themeDefaults == null ? void 0 : (_themeDefaults_defaults = themeDefaults.defaults) == null ? void 0 : _themeDefaults_defaults.tooltip);
     const { name, rules, label, helperText, error, required, disabled, placeholder, layout = 'stacked', visibleWhen, access, value: explicitValue, defaultValue, onChange, minTime, maxTime, stepMinutes, hour12 = false, fullWidth, sx, slotProps, testId } = props;
     const bridge = useContext(DashFormContext);
     const isVisible = useEngineVisibility(bridge == null ? void 0 : bridge.engine, visibleWhen);
@@ -4620,7 +4806,7 @@ function ClockIcon() {
                 htmlFor: fieldId,
                 className: cn(v.label(), themeSlotProps == null ? void 0 : (_themeSlotProps_label = themeSlotProps.label) == null ? void 0 : _themeSlotProps_label.className, slotProps == null ? void 0 : (_slotProps_label = slotProps.label) == null ? void 0 : _slotProps_label.className),
                 children: [
-                    label,
+                    renderLabelWithTooltip(label, tooltipConfig),
                     required && jsx("span", {
                         "aria-hidden": "true",
                         className: cn(v.requiredMark(), themeSlotProps == null ? void 0 : (_themeSlotProps_requiredMark = themeSlotProps.requiredMark) == null ? void 0 : _themeSlotProps_requiredMark.className, slotProps == null ? void 0 : (_slotProps_requiredMark = slotProps.requiredMark) == null ? void 0 : _slotProps_requiredMark.className),
@@ -4817,10 +5003,12 @@ const DATETIME_PATTERN = /^(\d{4}-\d{2}-\d{2})T(\d{2}):(\d{2})/;
  * Storage contract: a naive ISO datetime `"YYYY-MM-DDTHH:mm"` — no seconds,
  * no timezone. Shared with the MUI `@dashforge/ui` `DateTimePicker`.
  */ function DateTimePicker(_props) {
-    var _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_trigger, _slotProps_trigger, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
+    var _themeDefaults_defaults, _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_trigger, _slotProps_trigger, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
     const themeDefaults = useComponentDefaults('DateTimePicker');
     const props = _extends({}, themeDefaults == null ? void 0 : themeDefaults.defaults, _props);
     const themeSlotProps = themeDefaults == null ? void 0 : themeDefaults.slotProps;
+    // Option C deep-merge: instance `tooltip` over `theme…defaults.tooltip`.
+    const tooltipConfig = resolveFieldTooltip(_props.tooltip, themeDefaults == null ? void 0 : (_themeDefaults_defaults = themeDefaults.defaults) == null ? void 0 : _themeDefaults_defaults.tooltip);
     const { name, rules, label, helperText, error, required, disabled, placeholder, layout = 'stacked', visibleWhen, access, value: explicitValue, defaultValue, onChange, minDate, maxDate, disabledDates, isDateDisabled, weekStartDay, locale, stepMinutes, hour12 = false, fullWidth, sx, slotProps, testId } = props;
     const bridge = useContext(DashFormContext);
     const isVisible = useEngineVisibility(bridge == null ? void 0 : bridge.engine, visibleWhen);
@@ -4950,7 +5138,7 @@ const DATETIME_PATTERN = /^(\d{4}-\d{2}-\d{2})T(\d{2}):(\d{2})/;
                 htmlFor: fieldId,
                 className: cn(v.label(), themeSlotProps == null ? void 0 : (_themeSlotProps_label = themeSlotProps.label) == null ? void 0 : _themeSlotProps_label.className, slotProps == null ? void 0 : (_slotProps_label = slotProps.label) == null ? void 0 : _slotProps_label.className),
                 children: [
-                    label,
+                    renderLabelWithTooltip(label, tooltipConfig),
                     required && jsx("span", {
                         "aria-hidden": "true",
                         className: cn(v.requiredMark(), themeSlotProps == null ? void 0 : (_themeSlotProps_requiredMark = themeSlotProps.requiredMark) == null ? void 0 : _themeSlotProps_requiredMark.className, slotProps == null ? void 0 : (_slotProps_requiredMark = slotProps.requiredMark) == null ? void 0 : _slotProps_requiredMark.className),
@@ -5382,10 +5570,12 @@ function formatRange(range, locale) {
  * Storage contract: a `{ start, end }` pair of ISO `YYYY-MM-DD` dates —
  * shared with the MUI `@dashforge/ui` `DateRangePicker`.
  */ function DateRangePicker(_props) {
-    var _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_trigger, _slotProps_trigger, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
+    var _themeDefaults_defaults, _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_trigger, _slotProps_trigger, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_helperText, _slotProps_helperText;
     const themeDefaults = useComponentDefaults('DateRangePicker');
     const props = _extends({}, themeDefaults == null ? void 0 : themeDefaults.defaults, _props);
     const themeSlotProps = themeDefaults == null ? void 0 : themeDefaults.slotProps;
+    // Option C deep-merge: instance `tooltip` over `theme…defaults.tooltip`.
+    const tooltipConfig = resolveFieldTooltip(_props.tooltip, themeDefaults == null ? void 0 : (_themeDefaults_defaults = themeDefaults.defaults) == null ? void 0 : _themeDefaults_defaults.tooltip);
     const { name, rules, label, helperText, error, required, disabled, placeholder, layout = 'stacked', visibleWhen, access, value: explicitValue, defaultValue, onChange, minDate, maxDate, disabledDates, isDateDisabled, weekStartDay, locale, fullWidth, sx, slotProps, testId } = props;
     const bridge = useContext(DashFormContext);
     const isVisible = useEngineVisibility(bridge == null ? void 0 : bridge.engine, visibleWhen);
@@ -5508,7 +5698,7 @@ function formatRange(range, locale) {
                 htmlFor: fieldId,
                 className: cn(v.label(), themeSlotProps == null ? void 0 : (_themeSlotProps_label = themeSlotProps.label) == null ? void 0 : _themeSlotProps_label.className, slotProps == null ? void 0 : (_slotProps_label = slotProps.label) == null ? void 0 : _slotProps_label.className),
                 children: [
-                    label,
+                    renderLabelWithTooltip(label, tooltipConfig),
                     required && jsx("span", {
                         "aria-hidden": "true",
                         className: cn(v.requiredMark(), themeSlotProps == null ? void 0 : (_themeSlotProps_requiredMark = themeSlotProps.requiredMark) == null ? void 0 : _themeSlotProps_requiredMark.className, slotProps == null ? void 0 : (_slotProps_requiredMark = slotProps.requiredMark) == null ? void 0 : _slotProps_requiredMark.className),
@@ -5731,7 +5921,7 @@ function formatRange(range, locale) {
                             href: item.href,
                             onClick: item.onClick,
                             className: cn(v.link(), themeSlotProps == null ? void 0 : (_themeSlotProps_link = themeSlotProps.link) == null ? void 0 : _themeSlotProps_link.className, slotProps == null ? void 0 : (_slotProps_link = slotProps.link) == null ? void 0 : _slotProps_link.className),
-                            children: item.icon ? jsxs(Fragment, {
+                            children: item.icon ? jsxs(Fragment$1, {
                                 children: [
                                     jsx("span", {
                                         "aria-hidden": "true",
@@ -5750,7 +5940,7 @@ function formatRange(range, locale) {
                                 themeSlotProps == null ? void 0 : (_themeSlotProps_link1 = themeSlotProps.link) == null ? void 0 : _themeSlotProps_link1.className,
                                 slotProps == null ? void 0 : (_slotProps_link1 = slotProps.link) == null ? void 0 : _slotProps_link1.className
                             ]),
-                            children: item.icon ? jsxs(Fragment, {
+                            children: item.icon ? jsxs(Fragment$1, {
                                 children: [
                                     jsx("span", {
                                         "aria-hidden": "true",
@@ -5899,7 +6089,7 @@ function formatRange(range, locale) {
     const Link = linkComponent;
     const linkClasses = cn(v.itemLink(), isActive && v.itemActive(), themeSlotProps == null ? void 0 : (_themeSlotProps_itemLink = themeSlotProps.itemLink) == null ? void 0 : _themeSlotProps_itemLink.className, slotProps == null ? void 0 : (_slotProps_itemLink = slotProps.itemLink) == null ? void 0 : _slotProps_itemLink.className, isActive && (themeSlotProps == null ? void 0 : (_themeSlotProps_itemActive = themeSlotProps.itemActive) == null ? void 0 : _themeSlotProps_itemActive.className), slotProps == null ? void 0 : (_slotProps_itemActive = slotProps.itemActive) == null ? void 0 : _slotProps_itemActive.className);
     // Visual content — same in `<a>` / `<button>` branches below.
-    const content = jsxs(Fragment$1, {
+    const content = jsxs(Fragment, {
         children: [
             item.icon && jsx("span", {
                 "aria-hidden": "true",
@@ -6446,7 +6636,7 @@ function formatRange(range, locale) {
             jsxs("div", {
                 className: v.body(),
                 children: [
-                    nav && jsxs(Fragment$1, {
+                    nav && jsxs(Fragment, {
                         children: [
                             jsx("aside", {
                                 className: cn(v.nav(), themeSlotProps == null ? void 0 : (_themeSlotProps_nav = themeSlotProps.nav) == null ? void 0 : _themeSlotProps_nav.className, slotProps == null ? void 0 : (_slotProps_nav = slotProps.nav) == null ? void 0 : _slotProps_nav.className),
@@ -6712,7 +6902,7 @@ const ConfirmContext = /*#__PURE__*/ createContext(null);
                 "aria-labelledby": (opts == null ? void 0 : opts.title) != null ? titleId : undefined,
                 onClick: handleDialogClick,
                 className: cn(v.backdrop(), v.dialog(), (_mergedSlotProps_backdrop = mergedSlotProps.backdrop) == null ? void 0 : _mergedSlotProps_backdrop.className, (_mergedSlotProps_dialog = mergedSlotProps.dialog) == null ? void 0 : _mergedSlotProps_dialog.className),
-                children: opts != null && jsxs(Fragment$1, {
+                children: opts != null && jsxs(Fragment, {
                     children: [
                         opts.title != null && jsx("h2", {
                             id: titleId,
@@ -8746,7 +8936,7 @@ if (process.env.NODE_ENV !== 'production') {
  */ function flattenChildren(children) {
     const flat = [];
     Children.forEach(children, (child)=>{
-        if (/*#__PURE__*/ isValidElement(child) && child.type === Fragment) {
+        if (/*#__PURE__*/ isValidElement(child) && child.type === Fragment$1) {
             const nested = child.props.children;
             flat.push(...flattenChildren(nested));
             return;
@@ -8799,7 +8989,7 @@ if (process.env.NODE_ENV !== 'production') {
                 sawStrayDom = true;
                 return;
             }
-            pass.push(jsx(Fragment, {
+            pass.push(jsx(Fragment$1, {
                 children: child
             }, `stepper-passthrough-${i}`));
         });
@@ -9089,7 +9279,7 @@ if (process.env.NODE_ENV !== 'production') {
                         const labelClass = cn(v.label(), themeSlotProps == null ? void 0 : (_themeSlotProps_label = themeSlotProps.label) == null ? void 0 : _themeSlotProps_label.className, slotProps == null ? void 0 : (_slotProps_label = slotProps.label) == null ? void 0 : _slotProps_label.className);
                         const helperClass = cn(v.helperText(), themeSlotProps == null ? void 0 : (_themeSlotProps_helperText = themeSlotProps.helperText) == null ? void 0 : _themeSlotProps_helperText.className, slotProps == null ? void 0 : (_slotProps_helperText = slotProps.helperText) == null ? void 0 : _slotProps_helperText.className);
                         const optionalClass = cn(v.optionalTag(), themeSlotProps == null ? void 0 : (_themeSlotProps_optionalTag = themeSlotProps.optionalTag) == null ? void 0 : _themeSlotProps_optionalTag.className, slotProps == null ? void 0 : (_slotProps_optionalTag = slotProps.optionalTag) == null ? void 0 : _slotProps_optionalTag.className);
-                        return jsxs(Fragment, {
+                        return jsxs(Fragment$1, {
                             children: [
                                 jsxs("div", {
                                     role: "listitem",
@@ -9205,10 +9395,10 @@ Stepper.displayName = 'Stepper';
             ]
         });
     }
-    if (icon) return jsx(Fragment$1, {
+    if (icon) return jsx(Fragment, {
         children: icon
     });
-    return jsx(Fragment$1, {
+    return jsx(Fragment, {
         children: index + 1
     });
 }
@@ -10060,10 +10250,12 @@ Slider.displayName = 'Slider';
  * array so `onChange` gets the precise literal type.
  */ function SelectInner(props, ref) {
     var _ref;
-    var _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_trigger, _slotProps_trigger, _themeSlotProps_triggerText, _slotProps_triggerText, _themeSlotProps_triggerPlaceholder, _slotProps_triggerPlaceholder, _themeSlotProps_chevron, _slotProps_chevron, _themeSlotProps_popover, _slotProps_popover, _themeSlotProps_listBox, _slotProps_listBox, _themeSlotProps_emptyState, _slotProps_emptyState, _themeSlotProps_helperText, _slotProps_helperText, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_chipsList, _slotProps_chipsList, _themeSlotProps_chip, _slotProps_chip, _themeSlotProps_chipRemove, _slotProps_chipRemove, _triggerRef_current;
+    var _themeDefaults_defaults, _themeSlotProps_root, _slotProps_root, _themeSlotProps_label, _slotProps_label, _themeSlotProps_requiredMark, _slotProps_requiredMark, _themeSlotProps_trigger, _slotProps_trigger, _themeSlotProps_triggerText, _slotProps_triggerText, _themeSlotProps_triggerPlaceholder, _slotProps_triggerPlaceholder, _themeSlotProps_chevron, _slotProps_chevron, _themeSlotProps_popover, _slotProps_popover, _themeSlotProps_listBox, _slotProps_listBox, _themeSlotProps_emptyState, _slotProps_emptyState, _themeSlotProps_helperText, _slotProps_helperText, _themeSlotProps_errorText, _slotProps_errorText, _themeSlotProps_chipsList, _slotProps_chipsList, _themeSlotProps_chip, _slotProps_chip, _themeSlotProps_chipRemove, _slotProps_chipRemove, _triggerRef_current;
     const themeDefaults = useComponentDefaults('Select');
     const merged = _extends({}, themeDefaults == null ? void 0 : themeDefaults.defaults, props);
     const themeSlotProps = themeDefaults == null ? void 0 : themeDefaults.slotProps;
+    // Option C deep-merge: instance `tooltip` over `theme…defaults.tooltip`.
+    const tooltipConfig = resolveFieldTooltip(props.tooltip, themeDefaults == null ? void 0 : (_themeDefaults_defaults = themeDefaults.defaults) == null ? void 0 : _themeDefaults_defaults.tooltip);
     const { name, rules, label, helperText, error, required, disabled, fullWidth, layout, size, visibleWhen, access, options, placeholder = 'Select…', emptyState = 'No options', value: userValue, defaultValue, onChange, onBlur, multiple = false, sx, slotProps, testId } = merged;
     // ───── Hooks (unconditional, above the early returns) ─────
     const bridge = useContext(DashFormContext);
@@ -10424,7 +10616,7 @@ Slider.displayName = 'Slider';
                 htmlFor: controlId,
                 className: labelClasses,
                 children: [
-                    label,
+                    renderLabelWithTooltip(label, tooltipConfig),
                     required && jsx("span", {
                         className: requiredMarkClasses,
                         children: "*"
@@ -13626,7 +13818,7 @@ CardActionArea.displayName = 'CardActionArea';
     // `inline-flex items-center` provides vertical alignment with
     // any leading / trailing slots.
     const leading = avatar != null ? avatar : icon;
-    const innerContent = jsxs(Fragment$1, {
+    const innerContent = jsxs(Fragment, {
         children: [
             leading != null && jsx("span", {
                 className: "-ml-0.5 inline-flex items-center shrink-0",
@@ -14039,7 +14231,7 @@ Typography.displayName = 'Typography';
                     key
                 }));
             } else {
-                result.push(jsx(Fragment, {
+                result.push(jsx(Fragment$1, {
                     children: divider
                 }, key));
             }
@@ -15335,92 +15527,6 @@ function useTabs(options) {
     });
 }
 
-const tooltipVariants = tv({
-    slots: {
-        content: [
-            'z-50 max-w-xs rounded-md px-3 py-1.5 text-xs font-medium',
-            // Auto-invert via the dashforgePreset() CSS-var swap:
-            //  - Light mode: `bg-neutral-900` = #171717 (dark surface) +
-            //    `text-neutral-50` = #fafafa (light text) — DARK tooltip
-            //    on the light page (high contrast).
-            //  - Dark mode: `bg-neutral-900` flips to #f5f5f5 (light) +
-            //    `text-neutral-50` flips to #0a0a0a (dark text) — LIGHT
-            //    tooltip on the dark page (high contrast against page).
-            // Adding `dark:bg-neutral-50 dark:text-neutral-900` (the old
-            // pattern) would force the dark-mode tooltip back to a dark
-            // surface — invisible against the dark page.
-            'bg-neutral-900 text-neutral-50',
-            'shadow-md',
-            'data-[state=delayed-open]:animate-in data-[state=delayed-open]:fade-in-0 data-[state=delayed-open]:zoom-in-95',
-            'data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95',
-            'motion-reduce:transition-none motion-reduce:duration-0'
-        ],
-        // Arrow tracks the content bg — auto-inverts the same way.
-        arrow: 'fill-neutral-900'
-    }
-});
-
-/**
- * Dashforge TW `<Tooltip>` — hoverable / focusable tooltip.
- *
- * Built on `@radix-ui/react-tooltip`:
- *  - APG tooltip pattern: `role="tooltip"`, `aria-describedby` wired
- *    to the trigger automatically (Radix manages the id linkage).
- *  - Shows on hover OR keyboard focus.
- *  - Dismissed on Escape or pointer leave.
- *
- * Wrap any single React node — it becomes the trigger via Radix's
- * `asChild` slot. The trigger inherits `aria-describedby` so screen
- * readers announce the tooltip content along with the trigger.
- *
- * @example
- * ```tsx
- * <Tooltip content="Delete this item">
- *   <Button variant="ghost">
- *     <TrashIcon />
- *   </Button>
- * </Tooltip>
- * ```
- *
- * Each consumer can also wrap the entire app once in
- * `<RadixTooltip.Provider>` to share delay/skip configuration; we
- * include a per-component provider here for ease-of-use.
- */ function Tooltip(props) {
-    var _themeSlotProps_content, _slotProps_content, _themeSlotProps_arrow, _slotProps_arrow;
-    const themeDefaults = useComponentDefaults('Tooltip');
-    const merged = _extends({}, themeDefaults == null ? void 0 : themeDefaults.defaults, props);
-    const themeSlotProps = themeDefaults == null ? void 0 : themeDefaults.slotProps;
-    const { children, content, side = 'top', align = 'center', hideArrow = false, delayDuration = 200, open, onOpenChange, sideOffset = 4, sx, slotProps } = merged;
-    const v = tooltipVariants();
-    return jsx(RadixTooltip.Provider, {
-        delayDuration: delayDuration,
-        children: jsxs(RadixTooltip.Root, {
-            open: open,
-            onOpenChange: onOpenChange,
-            children: [
-                jsx(RadixTooltip.Trigger, {
-                    asChild: true,
-                    children: children
-                }),
-                jsx(RadixTooltip.Portal, {
-                    children: jsxs(RadixTooltip.Content, {
-                        side: side,
-                        align: align,
-                        sideOffset: sideOffset,
-                        className: cn(v.content(), sx, themeSlotProps == null ? void 0 : (_themeSlotProps_content = themeSlotProps.content) == null ? void 0 : _themeSlotProps_content.className, slotProps == null ? void 0 : (_slotProps_content = slotProps.content) == null ? void 0 : _slotProps_content.className),
-                        children: [
-                            content,
-                            !hideArrow && jsx(RadixTooltip.Arrow, {
-                                className: cn(v.arrow(), themeSlotProps == null ? void 0 : (_themeSlotProps_arrow = themeSlotProps.arrow) == null ? void 0 : _themeSlotProps_arrow.className, slotProps == null ? void 0 : (_slotProps_arrow = slotProps.arrow) == null ? void 0 : _slotProps_arrow.className)
-                            })
-                        ]
-                    })
-                })
-            ]
-        })
-    });
-}
-
 const accordionVariants = tv({
     slots: {
         root: 'w-full',
@@ -17074,7 +17180,7 @@ function HeaderCell$1(props) {
 // ───── Data row ─────
 function Row(props) {
     const { row, rowId, rowIndex, isSelected, isExpanded, visibleCols, columnTypes, rowSelection, showSelectionColumn, showExpandColumn, showRowActionsColumn, expandable, rowActions, labels, toggleRow, toggleExpand, isInteractive, rowClass, cellClass, selectionCellClass, expandToggleCellClass, rowActionsCellClass, expandedRowClass, totalColumnCount } = props;
-    return jsxs(Fragment$1, {
+    return jsxs(Fragment, {
         children: [
             jsxs("tr", {
                 "data-selected": isSelected ? 'true' : 'false',
@@ -17249,7 +17355,7 @@ function SortIcon$1(props) {
             d: "M8 4l4 6H4z"
         }) : props.direction === 'desc' ? jsx("path", {
             d: "M8 12L4 6h8z"
-        }) : jsxs(Fragment$1, {
+        }) : jsxs(Fragment, {
             children: [
                 jsx("path", {
                     d: "M8 3l3 4H5z",
@@ -19096,7 +19202,7 @@ function HeaderCell(props) {
 // ───── Virtualized body ─────
 function renderVirtualizedBody(args) {
     const { vWindow, renderedRows, visibleCols, columnTypes, columnWidths, selection, rowSelection, showSelectionColumn, showRowActionsColumn, rowActions, getRowId, isInteractive, labels, classes } = args;
-    return jsxs(Fragment$1, {
+    return jsxs(Fragment, {
         children: [
             vWindow.paddingTop > 0 && jsx("tr", {
                 "aria-hidden": "true",
@@ -19255,7 +19361,7 @@ function SortIcon(props) {
             d: "M8 4l4 6H4z"
         }) : props.direction === 'desc' ? jsx("path", {
             d: "M8 12L4 6h8z"
-        }) : jsxs(Fragment$1, {
+        }) : jsxs(Fragment, {
             children: [
                 jsx("path", {
                     d: "M8 3l3 4H5z",
@@ -19321,6 +19427,6 @@ function SearchIcon(props) {
  */ // ───── Components ─────
 /**
  * Package version (synced with `package.json` at publish time).
- */ const VERSION = '1.4.0';
+ */ const VERSION = '1.5.0';
 
 export { AVATAR_SOFT_FALLBACK, AVATAR_TONE_FALLBACK, Accordion, Alert, AlertTitle, AppShell, AspectRatio, Autocomplete, Avatar, AvatarGroup, Badge, Box, Breadcrumbs, Button, Calendar, Card, CardActionArea, CardContent, Checkbox, Chip, ConfirmDialogProvider, Container, DRAWER_SIZE_PRESETS, DataGrid, DatePicker, DateRangePicker, DateTimePicker, Dialog, Divider, Drawer, Grid, ICON_BUTTON_BASE, ICON_BUTTON_SIZE_OVERRIDES, IconButton, Image, LeftNav, Link, Menu, MenuContent, MenuItem, MenuLabel, MenuSeparator, MenuSkeleton, MenuTrigger, NumberField, OTPField, Pagination, Popover, Progress, RadioGroup, RenderButton, RenderChip, RenderText, RenderTwoLine, RowActionsMenu, SPINNER_COLORS, SPINNER_STROKE_WIDTH, SPINNER_TRACK_OPACITY, Select, Skeleton, Slider, SnackbarProvider, Spinner, Stack, Step, Stepper, Switch, Table, Tabs, TextField, Textarea, TimePicker, Tooltip, TopBar, Typography, VERSION, Video, VisuallyHidden, accordionVariants, alertVariants, appShellVariants, autocompleteVariants, avatarVariants, badgeVariants, boxVariants, breadcrumbsVariants, buttonVariants, calendarDayVariants, calendarVariants, checkboxVariants, chipVariants, cn, confirmDialogVariants, containerVariants, dataGridVariants, datePickerVariants, dateRangeDayVariants, dateRangePickerVariants, dateTimePickerVariants, dialogVariants, dividerLineVariants, dividerVariants, drawerVariants, getNestedValue, gridVariants, imageVariants, leftNavVariants, linkVariants, menuVariants, numberFieldVariants, otpFieldVariants, paginationVariants, popoverVariants, progressVariants, radioGroupVariants, selectVariants, skeletonVariants, sliderVariants, snackbarVariants, spinnerVariants, stackVariants, stepperVariants, switchVariants, tableVariants, tabsVariants, textFieldVariants, textareaVariants, timePickerVariants, tooltipVariants, topBarVariants, typographyVariants, useAccessState, useConfirm, useSnackbar, useStep, videoVariants };