@dschz/solid-uplot 0.3.0 → 0.4.0

package/dist/plugins/index.d.ts

@@ -384,6 +384,30 @@ type TooltipConfigOptions = {
      * @default false
      */
     readonly fixed?: boolean;
+    /**
+     * Optional callback to process or modify the calculated tooltip position.
+     * Receives the calculated position and placement preference, and should return a position object with the same structure.
+     * Use this to implement custom positioning logic or constraints.
+     *
+     * @param position - The calculated position with left and top coordinates
+     * @param placement - The placement preference that was used for calculation
+     * @returns Modified position object with left and top coordinates
+     *
+     * @example
+     * ```ts
+     * onPositionCalculated: (position, placement) => ({
+     *   left: Math.max(0, position.left), // Prevent negative positioning
+     *   top: placement.includes('top') ? position.top - 5 : position.top + 10
+     * })
+     * ```
+     */
+    readonly onPositionCalculated?: (position: {
+        left: number;
+        top: number;
+    }, placement: TooltipCursorPlacement) => {
+        left: number;
+        top: number;
+    };
 };
 /**
  * Combined options for the tooltip plugin including container props and behavior config.
@@ -400,6 +424,7 @@ type TooltipPluginOptions = TooltipRootProps & TooltipConfigOptions;
  * - Automatic positioning with edge detection and flipping
  * - Scroll-aware positioning that works with page scrolling
  * - Configurable placement preferences
+ * - Position callback for custom positioning logic or overrides
  * - Accessible tooltip with proper ARIA attributes
  * - Automatic cleanup and memory management
  *

package/dist/plugins/index.js

@@ -279,7 +279,7 @@ var tooltip = (Component, options = {}) => {
               zIndex: 20
             }, options);
             const chartCursorData = () => bus.data.cursor?.state[u.root.id];
-            const [tooltipOptions, containerProps] = splitProps(_options, ["placement", "fixed"]);
+            const [tooltipOptions, containerProps] = splitProps(_options, ["placement", "fixed", "onPositionCalculated"]);
             return createComponent(Show, {
               get when() {
                 return chartCursorData();
@@ -293,7 +293,8 @@ var tooltip = (Component, options = {}) => {
                   const cursorTop = overRect.top + cursor2().position.top;
                   const absoluteLeft = tooltipOptions.fixed ? cursorLeft : cursorLeft + window.scrollX;
                   const absoluteTop = tooltipOptions.fixed ? cursorTop : cursorTop + window.scrollY;
-                  return getTooltipPosition(tooltipOptions.placement, absoluteLeft, absoluteTop, tooltipWidth, tooltipHeight, tooltipOptions.fixed);
+                  const calculatedPosition = getTooltipPosition(tooltipOptions.placement, absoluteLeft, absoluteTop, tooltipWidth, tooltipHeight, tooltipOptions.fixed);
+                  return tooltipOptions.onPositionCalculated ? tooltipOptions.onPositionCalculated(calculatedPosition, tooltipOptions.placement) : calculatedPosition;
                 };
                 return (() => {
                   var _el$ = _tmpl$2();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dschz/solid-uplot",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "SolidJS wrapper for uPlot — ultra-fast, tiny time-series & charting library",
   "type": "module",
   "author": "Daniel Sanchez <dsanc89@pm.me>",