@nucleux/hover-card 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nucleux
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# @nucleux/hover-card
+
+Hover-triggered content card — Nucleux agentic UI for React.
+
+Part of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** — agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).
+
+## Install
+
+```bash
+pnpm add @nucleux/hover-card @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { HoverCard } from "@nucleux/hover-card";
+```
+
+Requires the theme once in your app: `import "@nucleux/tokens/styles.css";`
+and the Tailwind preset from `@nucleux/tokens/preset`.
+
+## License
+
+MIT © Nucleux

package/dist/index.cjs

@@ -0,0 +1,87 @@
+"use client";
+'use strict';
+
+var React = require('react');
+var utils = require('@nucleux/utils');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+// src/index.tsx
+var alignClass = {
+  start: "left-0",
+  center: "left-1/2 -translate-x-1/2",
+  end: "right-0"
+};
+var HoverCard = React__namespace.forwardRef(
+  ({
+    trigger,
+    content,
+    side = "top",
+    align = "center",
+    openDelay = 200,
+    closeDelay = 150,
+    className,
+    ...props
+  }, ref) => {
+    const [open, setOpen] = React__namespace.useState(false);
+    const timer = React__namespace.useRef();
+    const schedule = (next, delay) => {
+      clearTimeout(timer.current);
+      timer.current = setTimeout(() => setOpen(next), delay);
+    };
+    React__namespace.useEffect(() => () => clearTimeout(timer.current), []);
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      "div",
+      {
+        ref,
+        className: utils.cn("relative inline-block", className),
+        onMouseEnter: () => schedule(true, openDelay),
+        onMouseLeave: () => schedule(false, closeDelay),
+        onFocusCapture: () => setOpen(true),
+        onBlurCapture: (e) => {
+          if (!e.currentTarget.contains(e.relatedTarget)) setOpen(false);
+        },
+        ...props,
+        children: [
+          trigger,
+          open && /* @__PURE__ */ jsxRuntime.jsx(
+            "div",
+            {
+              role: "tooltip",
+              className: utils.cn(
+                "absolute z-50 w-64 animate-nx-fade-in rounded-md border border-border bg-background p-4 text-sm text-foreground shadow-md",
+                side === "top" ? "bottom-full mb-2" : "top-full mt-2",
+                alignClass[align]
+              ),
+              children: content
+            }
+          )
+        ]
+      }
+    );
+  }
+);
+HoverCard.displayName = "HoverCard";
+
+exports.HoverCard = HoverCard;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":["React","jsxs","cn","jsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,IAAM,UAAA,GAAmE;AAAA,EACvE,KAAA,EAAO,QAAA;AAAA,EACP,MAAA,EAAQ,2BAAA;AAAA,EACR,GAAA,EAAK;AACP,CAAA;AAGO,IAAM,SAAA,GAAkBA,gBAAA,CAAA,UAAA;AAAA,EAC7B,CACE;AAAA,IACE,OAAA;AAAA,IACA,OAAA;AAAA,IACA,IAAA,GAAO,KAAA;AAAA,IACP,KAAA,GAAQ,QAAA;AAAA,IACR,SAAA,GAAY,GAAA;AAAA,IACZ,UAAA,GAAa,GAAA;AAAA,IACb,SAAA;AAAA,IACA,GAAG;AAAA,KAEL,GAAA,KACG;AACH,IAAA,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,GAAUA,0BAAS,KAAK,CAAA;AAC5C,IAAA,MAAM,QAAcA,gBAAA,CAAA,MAAA,EAAsC;AAE1D,IAAA,MAAM,QAAA,GAAW,CAAC,IAAA,EAAe,KAAA,KAAkB;AACjD,MAAA,YAAA,CAAa,MAAM,OAAO,CAAA;AAC1B,MAAA,KAAA,CAAM,UAAU,UAAA,CAAW,MAAM,OAAA,CAAQ,IAAI,GAAG,KAAK,CAAA;AAAA,IACvD,CAAA;AAEA,IAAMA,gBAAA,CAAA,SAAA,CAAU,MAAM,MAAM,YAAA,CAAa,MAAM,OAAO,CAAA,EAAG,EAAE,CAAA;AAE3D,IAAA,uBACEC,eAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAWC,QAAA,CAAG,uBAAA,EAAyB,SAAS,CAAA;AAAA,QAChD,YAAA,EAAc,MAAM,QAAA,CAAS,IAAA,EAAM,SAAS,CAAA;AAAA,QAC5C,YAAA,EAAc,MAAM,QAAA,CAAS,KAAA,EAAO,UAAU,CAAA;AAAA,QAC9C,cAAA,EAAgB,MAAM,OAAA,CAAQ,IAAI,CAAA;AAAA,QAClC,aAAA,EAAe,CAAC,CAAA,KAAM;AACpB,UAAA,IAAI,CAAC,EAAE,aAAA,CAAc,QAAA,CAAS,EAAE,aAAqB,CAAA,UAAW,KAAK,CAAA;AAAA,QACvE,CAAA;AAAA,QACC,GAAG,KAAA;AAAA,QAEH,QAAA,EAAA;AAAA,UAAA,OAAA;AAAA,UACA,IAAA,oBACCC,cAAA;AAAA,YAAC,KAAA;AAAA,YAAA;AAAA,cACC,IAAA,EAAK,SAAA;AAAA,cACL,SAAA,EAAWD,QAAA;AAAA,gBACT,2HAAA;AAAA,gBACA,IAAA,KAAS,QAAQ,kBAAA,GAAqB,eAAA;AAAA,gBACtC,WAAW,KAAK;AAAA,eAClB;AAAA,cAEC,QAAA,EAAA;AAAA;AAAA;AACH;AAAA;AAAA,KAEJ;AAAA,EAEJ;AACF;AACA,SAAA,CAAU,WAAA,GAAc,WAAA","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\nexport interface HoverCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, \"content\"> {\n  /** The element that reveals the card on hover/focus. */\n  trigger: React.ReactNode;\n  /** The floating card content. */\n  content: React.ReactNode;\n  side?: \"top\" | \"bottom\";\n  align?: \"start\" | \"center\" | \"end\";\n  /** Delay in ms before opening on hover. */\n  openDelay?: number;\n  /** Delay in ms before closing after leaving. */\n  closeDelay?: number;\n}\n\nconst alignClass: Record<NonNullable<HoverCardProps[\"align\"]>, string> = {\n  start: \"left-0\",\n  center: \"left-1/2 -translate-x-1/2\",\n  end: \"right-0\",\n};\n\n/** Reveals a floating card when its trigger is hovered or focused. */\nexport const HoverCard = React.forwardRef<HTMLDivElement, HoverCardProps>(\n  (\n    {\n      trigger,\n      content,\n      side = \"top\",\n      align = \"center\",\n      openDelay = 200,\n      closeDelay = 150,\n      className,\n      ...props\n    },\n    ref,\n  ) => {\n    const [open, setOpen] = React.useState(false);\n    const timer = React.useRef<ReturnType<typeof setTimeout>>();\n\n    const schedule = (next: boolean, delay: number) => {\n      clearTimeout(timer.current);\n      timer.current = setTimeout(() => setOpen(next), delay);\n    };\n\n    React.useEffect(() => () => clearTimeout(timer.current), []);\n\n    return (\n      <div\n        ref={ref}\n        className={cn(\"relative inline-block\", className)}\n        onMouseEnter={() => schedule(true, openDelay)}\n        onMouseLeave={() => schedule(false, closeDelay)}\n        onFocusCapture={() => setOpen(true)}\n        onBlurCapture={(e) => {\n          if (!e.currentTarget.contains(e.relatedTarget as Node)) setOpen(false);\n        }}\n        {...props}\n      >\n        {trigger}\n        {open && (\n          <div\n            role=\"tooltip\"\n            className={cn(\n              \"absolute z-50 w-64 animate-nx-fade-in rounded-md border border-border bg-background p-4 text-sm text-foreground shadow-md\",\n              side === \"top\" ? \"bottom-full mb-2\" : \"top-full mt-2\",\n              alignClass[align],\n            )}\n          >\n            {content}\n          </div>\n        )}\n      </div>\n    );\n  },\n);\nHoverCard.displayName = \"HoverCard\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,18 @@
+import * as React from 'react';
+
+interface HoverCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "content"> {
+    /** The element that reveals the card on hover/focus. */
+    trigger: React.ReactNode;
+    /** The floating card content. */
+    content: React.ReactNode;
+    side?: "top" | "bottom";
+    align?: "start" | "center" | "end";
+    /** Delay in ms before opening on hover. */
+    openDelay?: number;
+    /** Delay in ms before closing after leaving. */
+    closeDelay?: number;
+}
+/** Reveals a floating card when its trigger is hovered or focused. */
+declare const HoverCard: React.ForwardRefExoticComponent<HoverCardProps & React.RefAttributes<HTMLDivElement>>;
+
+export { HoverCard, type HoverCardProps };

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import * as React from 'react';
+
+interface HoverCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "content"> {
+    /** The element that reveals the card on hover/focus. */
+    trigger: React.ReactNode;
+    /** The floating card content. */
+    content: React.ReactNode;
+    side?: "top" | "bottom";
+    align?: "start" | "center" | "end";
+    /** Delay in ms before opening on hover. */
+    openDelay?: number;
+    /** Delay in ms before closing after leaving. */
+    closeDelay?: number;
+}
+/** Reveals a floating card when its trigger is hovered or focused. */
+declare const HoverCard: React.ForwardRefExoticComponent<HoverCardProps & React.RefAttributes<HTMLDivElement>>;
+
+export { HoverCard, type HoverCardProps };

package/dist/index.js

@@ -0,0 +1,65 @@
+"use client";
+import * as React from 'react';
+import { cn } from '@nucleux/utils';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/index.tsx
+var alignClass = {
+  start: "left-0",
+  center: "left-1/2 -translate-x-1/2",
+  end: "right-0"
+};
+var HoverCard = React.forwardRef(
+  ({
+    trigger,
+    content,
+    side = "top",
+    align = "center",
+    openDelay = 200,
+    closeDelay = 150,
+    className,
+    ...props
+  }, ref) => {
+    const [open, setOpen] = React.useState(false);
+    const timer = React.useRef();
+    const schedule = (next, delay) => {
+      clearTimeout(timer.current);
+      timer.current = setTimeout(() => setOpen(next), delay);
+    };
+    React.useEffect(() => () => clearTimeout(timer.current), []);
+    return /* @__PURE__ */ jsxs(
+      "div",
+      {
+        ref,
+        className: cn("relative inline-block", className),
+        onMouseEnter: () => schedule(true, openDelay),
+        onMouseLeave: () => schedule(false, closeDelay),
+        onFocusCapture: () => setOpen(true),
+        onBlurCapture: (e) => {
+          if (!e.currentTarget.contains(e.relatedTarget)) setOpen(false);
+        },
+        ...props,
+        children: [
+          trigger,
+          open && /* @__PURE__ */ jsx(
+            "div",
+            {
+              role: "tooltip",
+              className: cn(
+                "absolute z-50 w-64 animate-nx-fade-in rounded-md border border-border bg-background p-4 text-sm text-foreground shadow-md",
+                side === "top" ? "bottom-full mb-2" : "top-full mt-2",
+                alignClass[align]
+              ),
+              children: content
+            }
+          )
+        ]
+      }
+    );
+  }
+);
+HoverCard.displayName = "HoverCard";
+
+export { HoverCard };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;AAgBA,IAAM,UAAA,GAAmE;AAAA,EACvE,KAAA,EAAO,QAAA;AAAA,EACP,MAAA,EAAQ,2BAAA;AAAA,EACR,GAAA,EAAK;AACP,CAAA;AAGO,IAAM,SAAA,GAAkB,KAAA,CAAA,UAAA;AAAA,EAC7B,CACE;AAAA,IACE,OAAA;AAAA,IACA,OAAA;AAAA,IACA,IAAA,GAAO,KAAA;AAAA,IACP,KAAA,GAAQ,QAAA;AAAA,IACR,SAAA,GAAY,GAAA;AAAA,IACZ,UAAA,GAAa,GAAA;AAAA,IACb,SAAA;AAAA,IACA,GAAG;AAAA,KAEL,GAAA,KACG;AACH,IAAA,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,GAAU,eAAS,KAAK,CAAA;AAC5C,IAAA,MAAM,QAAc,KAAA,CAAA,MAAA,EAAsC;AAE1D,IAAA,MAAM,QAAA,GAAW,CAAC,IAAA,EAAe,KAAA,KAAkB;AACjD,MAAA,YAAA,CAAa,MAAM,OAAO,CAAA;AAC1B,MAAA,KAAA,CAAM,UAAU,UAAA,CAAW,MAAM,OAAA,CAAQ,IAAI,GAAG,KAAK,CAAA;AAAA,IACvD,CAAA;AAEA,IAAM,KAAA,CAAA,SAAA,CAAU,MAAM,MAAM,YAAA,CAAa,MAAM,OAAO,CAAA,EAAG,EAAE,CAAA;AAE3D,IAAA,uBACE,IAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAW,EAAA,CAAG,uBAAA,EAAyB,SAAS,CAAA;AAAA,QAChD,YAAA,EAAc,MAAM,QAAA,CAAS,IAAA,EAAM,SAAS,CAAA;AAAA,QAC5C,YAAA,EAAc,MAAM,QAAA,CAAS,KAAA,EAAO,UAAU,CAAA;AAAA,QAC9C,cAAA,EAAgB,MAAM,OAAA,CAAQ,IAAI,CAAA;AAAA,QAClC,aAAA,EAAe,CAAC,CAAA,KAAM;AACpB,UAAA,IAAI,CAAC,EAAE,aAAA,CAAc,QAAA,CAAS,EAAE,aAAqB,CAAA,UAAW,KAAK,CAAA;AAAA,QACvE,CAAA;AAAA,QACC,GAAG,KAAA;AAAA,QAEH,QAAA,EAAA;AAAA,UAAA,OAAA;AAAA,UACA,IAAA,oBACC,GAAA;AAAA,YAAC,KAAA;AAAA,YAAA;AAAA,cACC,IAAA,EAAK,SAAA;AAAA,cACL,SAAA,EAAW,EAAA;AAAA,gBACT,2HAAA;AAAA,gBACA,IAAA,KAAS,QAAQ,kBAAA,GAAqB,eAAA;AAAA,gBACtC,WAAW,KAAK;AAAA,eAClB;AAAA,cAEC,QAAA,EAAA;AAAA;AAAA;AACH;AAAA;AAAA,KAEJ;AAAA,EAEJ;AACF;AACA,SAAA,CAAU,WAAA,GAAc,WAAA","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\nexport interface HoverCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, \"content\"> {\n  /** The element that reveals the card on hover/focus. */\n  trigger: React.ReactNode;\n  /** The floating card content. */\n  content: React.ReactNode;\n  side?: \"top\" | \"bottom\";\n  align?: \"start\" | \"center\" | \"end\";\n  /** Delay in ms before opening on hover. */\n  openDelay?: number;\n  /** Delay in ms before closing after leaving. */\n  closeDelay?: number;\n}\n\nconst alignClass: Record<NonNullable<HoverCardProps[\"align\"]>, string> = {\n  start: \"left-0\",\n  center: \"left-1/2 -translate-x-1/2\",\n  end: \"right-0\",\n};\n\n/** Reveals a floating card when its trigger is hovered or focused. */\nexport const HoverCard = React.forwardRef<HTMLDivElement, HoverCardProps>(\n  (\n    {\n      trigger,\n      content,\n      side = \"top\",\n      align = \"center\",\n      openDelay = 200,\n      closeDelay = 150,\n      className,\n      ...props\n    },\n    ref,\n  ) => {\n    const [open, setOpen] = React.useState(false);\n    const timer = React.useRef<ReturnType<typeof setTimeout>>();\n\n    const schedule = (next: boolean, delay: number) => {\n      clearTimeout(timer.current);\n      timer.current = setTimeout(() => setOpen(next), delay);\n    };\n\n    React.useEffect(() => () => clearTimeout(timer.current), []);\n\n    return (\n      <div\n        ref={ref}\n        className={cn(\"relative inline-block\", className)}\n        onMouseEnter={() => schedule(true, openDelay)}\n        onMouseLeave={() => schedule(false, closeDelay)}\n        onFocusCapture={() => setOpen(true)}\n        onBlurCapture={(e) => {\n          if (!e.currentTarget.contains(e.relatedTarget as Node)) setOpen(false);\n        }}\n        {...props}\n      >\n        {trigger}\n        {open && (\n          <div\n            role=\"tooltip\"\n            className={cn(\n              \"absolute z-50 w-64 animate-nx-fade-in rounded-md border border-border bg-background p-4 text-sm text-foreground shadow-md\",\n              side === \"top\" ? \"bottom-full mb-2\" : \"top-full mt-2\",\n              alignClass[align],\n            )}\n          >\n            {content}\n          </div>\n        )}\n      </div>\n    );\n  },\n);\nHoverCard.displayName = \"HoverCard\";\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@nucleux/hover-card",
+  "version": "0.2.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Hover-triggered content card — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "hover-card"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "dependencies": {
+    "@nucleux/utils": "0.2.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "@types/react": "^18.3.18",
+    "react": "^18.3.1",
+    "lucide-react": "^0.469.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intelligaia-open-labs/nucleux.git",
+    "directory": "packages/hover-card"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
+}