@nucleux/popover 0.1.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/dist/index.cjs

@@ -0,0 +1,111 @@
+"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 PopoverContext = React__namespace.createContext(null);
+function usePopover(component) {
+  const ctx = React__namespace.useContext(PopoverContext);
+  if (!ctx) throw new Error(`<${component}> must be used inside <Popover>`);
+  return ctx;
+}
+function Popover({ open, defaultOpen = false, onOpenChange, children }) {
+  const [internal, setInternal] = React__namespace.useState(defaultOpen);
+  const isControlled = open != null;
+  const value = isControlled ? open : internal;
+  const contentId = React__namespace.useId();
+  const containerRef = React__namespace.useRef(null);
+  const setOpen = React__namespace.useCallback(
+    (next) => {
+      if (!isControlled) setInternal(next);
+      onOpenChange?.(next);
+    },
+    [isControlled, onOpenChange]
+  );
+  React__namespace.useEffect(() => {
+    if (!value) return;
+    const onDown = (e) => {
+      if (!containerRef.current?.contains(e.target)) setOpen(false);
+    };
+    const onKey = (e) => {
+      if (e.key === "Escape") setOpen(false);
+    };
+    document.addEventListener("mousedown", onDown);
+    document.addEventListener("keydown", onKey);
+    return () => {
+      document.removeEventListener("mousedown", onDown);
+      document.removeEventListener("keydown", onKey);
+    };
+  }, [value, setOpen]);
+  return /* @__PURE__ */ jsxRuntime.jsx(PopoverContext.Provider, { value: { open: value, setOpen, contentId }, children: /* @__PURE__ */ jsxRuntime.jsx("div", { ref: containerRef, className: "relative inline-block", children }) });
+}
+var PopoverTrigger = React__namespace.forwardRef(
+  ({ onClick, type = "button", ...props }, ref) => {
+    const { open, setOpen, contentId } = usePopover("PopoverTrigger");
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "button",
+      {
+        ref,
+        type,
+        "aria-haspopup": "dialog",
+        "aria-expanded": open,
+        "aria-controls": open ? contentId : void 0,
+        onClick: (e) => {
+          onClick?.(e);
+          setOpen(!open);
+        },
+        ...props
+      }
+    );
+  }
+);
+PopoverTrigger.displayName = "PopoverTrigger";
+var PopoverContent = React__namespace.forwardRef(
+  ({ align = "start", className, ...props }, ref) => {
+    const { open, contentId } = usePopover("PopoverContent");
+    if (!open) return null;
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        ref,
+        id: contentId,
+        className: utils.cn(
+          "absolute top-full z-50 mt-2 min-w-[12rem] rounded-lg border border-border bg-background p-4 text-foreground shadow-md outline-none animate-nx-fade-in",
+          align === "end" ? "right-0" : "left-0",
+          className
+        ),
+        ...props
+      }
+    );
+  }
+);
+PopoverContent.displayName = "PopoverContent";
+
+exports.Popover = Popover;
+exports.PopoverContent = PopoverContent;
+exports.PopoverTrigger = PopoverTrigger;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":["React","jsx","cn"],"mappings":"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","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\ninterface PopoverContextValue {\n  open: boolean;\n  setOpen: (open: boolean) => void;\n  contentId: string;\n}\nconst PopoverContext = React.createContext<PopoverContextValue | null>(null);\n\nfunction usePopover(component: string) {\n  const ctx = React.useContext(PopoverContext);\n  if (!ctx) throw new Error(`<${component}> must be used inside <Popover>`);\n  return ctx;\n}\n\nexport interface PopoverProps {\n  open?: boolean;\n  defaultOpen?: boolean;\n  onOpenChange?: (open: boolean) => void;\n  children: React.ReactNode;\n}\n\n/**\n * A click-triggered popover. Compose PopoverTrigger + PopoverContent. Closes on\n * outside click or Escape. Content is positioned relative to the trigger.\n */\nexport function Popover({ open, defaultOpen = false, onOpenChange, children }: PopoverProps) {\n  const [internal, setInternal] = React.useState(defaultOpen);\n  const isControlled = open != null;\n  const value = isControlled ? open : internal;\n  const contentId = React.useId();\n  const containerRef = React.useRef<HTMLDivElement>(null);\n\n  const setOpen = React.useCallback(\n    (next: boolean) => {\n      if (!isControlled) setInternal(next);\n      onOpenChange?.(next);\n    },\n    [isControlled, onOpenChange],\n  );\n\n  React.useEffect(() => {\n    if (!value) return;\n    const onDown = (e: MouseEvent) => {\n      if (!containerRef.current?.contains(e.target as Node)) setOpen(false);\n    };\n    const onKey = (e: KeyboardEvent) => {\n      if (e.key === \"Escape\") setOpen(false);\n    };\n    document.addEventListener(\"mousedown\", onDown);\n    document.addEventListener(\"keydown\", onKey);\n    return () => {\n      document.removeEventListener(\"mousedown\", onDown);\n      document.removeEventListener(\"keydown\", onKey);\n    };\n  }, [value, setOpen]);\n\n  return (\n    <PopoverContext.Provider value={{ open: value, setOpen, contentId }}>\n      <div ref={containerRef} className=\"relative inline-block\">\n        {children}\n      </div>\n    </PopoverContext.Provider>\n  );\n}\n\nexport const PopoverTrigger = React.forwardRef<HTMLButtonElement, React.ButtonHTMLAttributes<HTMLButtonElement>>(\n  ({ onClick, type = \"button\", ...props }, ref) => {\n    const { open, setOpen, contentId } = usePopover(\"PopoverTrigger\");\n    return (\n      <button\n        ref={ref}\n        type={type}\n        aria-haspopup=\"dialog\"\n        aria-expanded={open}\n        aria-controls={open ? contentId : undefined}\n        onClick={(e) => {\n          onClick?.(e);\n          setOpen(!open);\n        }}\n        {...props}\n      />\n    );\n  },\n);\nPopoverTrigger.displayName = \"PopoverTrigger\";\n\nexport interface PopoverContentProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Horizontal alignment relative to the trigger. */\n  align?: \"start\" | \"end\";\n}\n\nexport const PopoverContent = React.forwardRef<HTMLDivElement, PopoverContentProps>(\n  ({ align = \"start\", className, ...props }, ref) => {\n    const { open, contentId } = usePopover(\"PopoverContent\");\n    if (!open) return null;\n    return (\n      <div\n        ref={ref}\n        id={contentId}\n        className={cn(\n          \"absolute top-full z-50 mt-2 min-w-[12rem] rounded-lg border border-border bg-background p-4 text-foreground shadow-md outline-none animate-nx-fade-in\",\n          align === \"end\" ? \"right-0\" : \"left-0\",\n          className,\n        )}\n        {...props}\n      />\n    );\n  },\n);\nPopoverContent.displayName = \"PopoverContent\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,21 @@
+import * as React from 'react';
+
+interface PopoverProps {
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    children: React.ReactNode;
+}
+/**
+ * A click-triggered popover. Compose PopoverTrigger + PopoverContent. Closes on
+ * outside click or Escape. Content is positioned relative to the trigger.
+ */
+declare function Popover({ open, defaultOpen, onOpenChange, children }: PopoverProps): React.JSX.Element;
+declare const PopoverTrigger: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+interface PopoverContentProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Horizontal alignment relative to the trigger. */
+    align?: "start" | "end";
+}
+declare const PopoverContent: React.ForwardRefExoticComponent<PopoverContentProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger };

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import * as React from 'react';
+
+interface PopoverProps {
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    children: React.ReactNode;
+}
+/**
+ * A click-triggered popover. Compose PopoverTrigger + PopoverContent. Closes on
+ * outside click or Escape. Content is positioned relative to the trigger.
+ */
+declare function Popover({ open, defaultOpen, onOpenChange, children }: PopoverProps): React.JSX.Element;
+declare const PopoverTrigger: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+interface PopoverContentProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Horizontal alignment relative to the trigger. */
+    align?: "start" | "end";
+}
+declare const PopoverContent: React.ForwardRefExoticComponent<PopoverContentProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger };

package/dist/index.js

@@ -0,0 +1,87 @@
+"use client";
+import * as React from 'react';
+import { cn } from '@nucleux/utils';
+import { jsx } from 'react/jsx-runtime';
+
+// src/index.tsx
+var PopoverContext = React.createContext(null);
+function usePopover(component) {
+  const ctx = React.useContext(PopoverContext);
+  if (!ctx) throw new Error(`<${component}> must be used inside <Popover>`);
+  return ctx;
+}
+function Popover({ open, defaultOpen = false, onOpenChange, children }) {
+  const [internal, setInternal] = React.useState(defaultOpen);
+  const isControlled = open != null;
+  const value = isControlled ? open : internal;
+  const contentId = React.useId();
+  const containerRef = React.useRef(null);
+  const setOpen = React.useCallback(
+    (next) => {
+      if (!isControlled) setInternal(next);
+      onOpenChange?.(next);
+    },
+    [isControlled, onOpenChange]
+  );
+  React.useEffect(() => {
+    if (!value) return;
+    const onDown = (e) => {
+      if (!containerRef.current?.contains(e.target)) setOpen(false);
+    };
+    const onKey = (e) => {
+      if (e.key === "Escape") setOpen(false);
+    };
+    document.addEventListener("mousedown", onDown);
+    document.addEventListener("keydown", onKey);
+    return () => {
+      document.removeEventListener("mousedown", onDown);
+      document.removeEventListener("keydown", onKey);
+    };
+  }, [value, setOpen]);
+  return /* @__PURE__ */ jsx(PopoverContext.Provider, { value: { open: value, setOpen, contentId }, children: /* @__PURE__ */ jsx("div", { ref: containerRef, className: "relative inline-block", children }) });
+}
+var PopoverTrigger = React.forwardRef(
+  ({ onClick, type = "button", ...props }, ref) => {
+    const { open, setOpen, contentId } = usePopover("PopoverTrigger");
+    return /* @__PURE__ */ jsx(
+      "button",
+      {
+        ref,
+        type,
+        "aria-haspopup": "dialog",
+        "aria-expanded": open,
+        "aria-controls": open ? contentId : void 0,
+        onClick: (e) => {
+          onClick?.(e);
+          setOpen(!open);
+        },
+        ...props
+      }
+    );
+  }
+);
+PopoverTrigger.displayName = "PopoverTrigger";
+var PopoverContent = React.forwardRef(
+  ({ align = "start", className, ...props }, ref) => {
+    const { open, contentId } = usePopover("PopoverContent");
+    if (!open) return null;
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref,
+        id: contentId,
+        className: cn(
+          "absolute top-full z-50 mt-2 min-w-[12rem] rounded-lg border border-border bg-background p-4 text-foreground shadow-md outline-none animate-nx-fade-in",
+          align === "end" ? "right-0" : "left-0",
+          className
+        ),
+        ...props
+      }
+    );
+  }
+);
+PopoverContent.displayName = "PopoverContent";
+
+export { Popover, PopoverContent, PopoverTrigger };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\ninterface PopoverContextValue {\n  open: boolean;\n  setOpen: (open: boolean) => void;\n  contentId: string;\n}\nconst PopoverContext = React.createContext<PopoverContextValue | null>(null);\n\nfunction usePopover(component: string) {\n  const ctx = React.useContext(PopoverContext);\n  if (!ctx) throw new Error(`<${component}> must be used inside <Popover>`);\n  return ctx;\n}\n\nexport interface PopoverProps {\n  open?: boolean;\n  defaultOpen?: boolean;\n  onOpenChange?: (open: boolean) => void;\n  children: React.ReactNode;\n}\n\n/**\n * A click-triggered popover. Compose PopoverTrigger + PopoverContent. Closes on\n * outside click or Escape. Content is positioned relative to the trigger.\n */\nexport function Popover({ open, defaultOpen = false, onOpenChange, children }: PopoverProps) {\n  const [internal, setInternal] = React.useState(defaultOpen);\n  const isControlled = open != null;\n  const value = isControlled ? open : internal;\n  const contentId = React.useId();\n  const containerRef = React.useRef<HTMLDivElement>(null);\n\n  const setOpen = React.useCallback(\n    (next: boolean) => {\n      if (!isControlled) setInternal(next);\n      onOpenChange?.(next);\n    },\n    [isControlled, onOpenChange],\n  );\n\n  React.useEffect(() => {\n    if (!value) return;\n    const onDown = (e: MouseEvent) => {\n      if (!containerRef.current?.contains(e.target as Node)) setOpen(false);\n    };\n    const onKey = (e: KeyboardEvent) => {\n      if (e.key === \"Escape\") setOpen(false);\n    };\n    document.addEventListener(\"mousedown\", onDown);\n    document.addEventListener(\"keydown\", onKey);\n    return () => {\n      document.removeEventListener(\"mousedown\", onDown);\n      document.removeEventListener(\"keydown\", onKey);\n    };\n  }, [value, setOpen]);\n\n  return (\n    <PopoverContext.Provider value={{ open: value, setOpen, contentId }}>\n      <div ref={containerRef} className=\"relative inline-block\">\n        {children}\n      </div>\n    </PopoverContext.Provider>\n  );\n}\n\nexport const PopoverTrigger = React.forwardRef<HTMLButtonElement, React.ButtonHTMLAttributes<HTMLButtonElement>>(\n  ({ onClick, type = \"button\", ...props }, ref) => {\n    const { open, setOpen, contentId } = usePopover(\"PopoverTrigger\");\n    return (\n      <button\n        ref={ref}\n        type={type}\n        aria-haspopup=\"dialog\"\n        aria-expanded={open}\n        aria-controls={open ? contentId : undefined}\n        onClick={(e) => {\n          onClick?.(e);\n          setOpen(!open);\n        }}\n        {...props}\n      />\n    );\n  },\n);\nPopoverTrigger.displayName = \"PopoverTrigger\";\n\nexport interface PopoverContentProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Horizontal alignment relative to the trigger. */\n  align?: \"start\" | \"end\";\n}\n\nexport const PopoverContent = React.forwardRef<HTMLDivElement, PopoverContentProps>(\n  ({ align = \"start\", className, ...props }, ref) => {\n    const { open, contentId } = usePopover(\"PopoverContent\");\n    if (!open) return null;\n    return (\n      <div\n        ref={ref}\n        id={contentId}\n        className={cn(\n          \"absolute top-full z-50 mt-2 min-w-[12rem] rounded-lg border border-border bg-background p-4 text-foreground shadow-md outline-none animate-nx-fade-in\",\n          align === \"end\" ? \"right-0\" : \"left-0\",\n          className,\n        )}\n        {...props}\n      />\n    );\n  },\n);\nPopoverContent.displayName = \"PopoverContent\";\n"]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@nucleux/popover",
+  "version": "0.1.0",
+  "type": "module",
+  "sideEffects": false,
+  "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"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "dependencies": {
+    "@nucleux/utils": "0.1.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/popover"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
+}