@nucleux/context-menu 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/context-menu
+
+Right-click context menu — 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/context-menu @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { ContextMenu } from "@nucleux/context-menu";
+```
+
+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,128 @@
+"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 ContextMenuContext = React__namespace.createContext(null);
+var ContextMenu = React__namespace.forwardRef(
+  ({ content, children, className, ...props }, ref) => {
+    const [pos, setPos] = React__namespace.useState(null);
+    const menuRef = React__namespace.useRef(null);
+    const close = React__namespace.useCallback(() => setPos(null), []);
+    React__namespace.useEffect(() => {
+      if (!pos) return;
+      const onDown = (e) => {
+        if (!menuRef.current?.contains(e.target)) close();
+      };
+      const onKey = (e) => e.key === "Escape" && close();
+      const onScroll = () => close();
+      document.addEventListener("mousedown", onDown);
+      document.addEventListener("keydown", onKey);
+      window.addEventListener("scroll", onScroll, true);
+      return () => {
+        document.removeEventListener("mousedown", onDown);
+        document.removeEventListener("keydown", onKey);
+        window.removeEventListener("scroll", onScroll, true);
+      };
+    }, [pos, close]);
+    React__namespace.useEffect(() => {
+      if (pos) menuRef.current?.focus();
+    }, [pos]);
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      "div",
+      {
+        ref,
+        onContextMenu: (e) => {
+          e.preventDefault();
+          setPos({ x: e.clientX, y: e.clientY });
+        },
+        className,
+        ...props,
+        children: [
+          children,
+          pos && /* @__PURE__ */ jsxRuntime.jsx(
+            "div",
+            {
+              ref: menuRef,
+              role: "menu",
+              tabIndex: -1,
+              style: { top: pos.y, left: pos.x },
+              className: utils.cn(
+                "fixed z-50 min-w-[12rem] animate-nx-fade-in rounded-lg border border-border bg-background p-1 text-foreground shadow-md outline-none"
+              ),
+              children: /* @__PURE__ */ jsxRuntime.jsx(ContextMenuContext.Provider, { value: { close }, children: content })
+            }
+          )
+        ]
+      }
+    );
+  }
+);
+ContextMenu.displayName = "ContextMenu";
+var ContextMenuItem = React__namespace.forwardRef(
+  ({ icon, trailing, destructive = false, className, children, onClick, ...props }, ref) => {
+    const ctx = React__namespace.useContext(ContextMenuContext);
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      "button",
+      {
+        ref,
+        type: "button",
+        role: "menuitem",
+        onClick: (e) => {
+          onClick?.(e);
+          if (!e.defaultPrevented) ctx?.close();
+        },
+        className: utils.cn(
+          "flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left text-sm transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 [&_svg]:size-4",
+          destructive ? "text-destructive hover:bg-destructive/10" : "text-foreground hover:bg-accent",
+          className
+        ),
+        ...props,
+        children: [
+          icon && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "shrink-0", children: icon }),
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex-1 truncate", children }),
+          trailing && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "shrink-0 text-muted-foreground", children: trailing })
+        ]
+      }
+    );
+  }
+);
+ContextMenuItem.displayName = "ContextMenuItem";
+var ContextMenuSeparator = React__namespace.forwardRef(
+  ({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, role: "separator", className: utils.cn("-mx-1 my-1 h-px bg-border", className), ...props })
+);
+ContextMenuSeparator.displayName = "ContextMenuSeparator";
+var ContextMenuLabel = React__namespace.forwardRef(
+  ({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: utils.cn("px-2 py-1.5 text-xs font-medium text-muted-foreground", className), ...props })
+);
+ContextMenuLabel.displayName = "ContextMenuLabel";
+
+exports.ContextMenu = ContextMenu;
+exports.ContextMenuItem = ContextMenuItem;
+exports.ContextMenuLabel = ContextMenuLabel;
+exports.ContextMenuSeparator = ContextMenuSeparator;
+//# 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","jsx","cn"],"mappings":"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","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\ninterface ContextMenuContextValue {\n  close: () => void;\n}\nconst ContextMenuContext = React.createContext<ContextMenuContextValue | null>(null);\n\nexport interface ContextMenuProps extends Omit<React.HTMLAttributes<HTMLDivElement>, \"content\"> {\n  /** Menu items — compose ContextMenuItem / ContextMenuSeparator / ContextMenuLabel. */\n  content: React.ReactNode;\n  /** The area that opens the menu on right-click. */\n  children: React.ReactNode;\n}\n\n/** Wraps a region so right-clicking it opens a menu at the cursor. */\nexport const ContextMenu = React.forwardRef<HTMLDivElement, ContextMenuProps>(\n  ({ content, children, className, ...props }, ref) => {\n    const [pos, setPos] = React.useState<{ x: number; y: number } | null>(null);\n    const menuRef = React.useRef<HTMLDivElement>(null);\n    const close = React.useCallback(() => setPos(null), []);\n\n    React.useEffect(() => {\n      if (!pos) return;\n      const onDown = (e: MouseEvent) => {\n        if (!menuRef.current?.contains(e.target as Node)) close();\n      };\n      const onKey = (e: KeyboardEvent) => e.key === \"Escape\" && close();\n      const onScroll = () => close();\n      document.addEventListener(\"mousedown\", onDown);\n      document.addEventListener(\"keydown\", onKey);\n      window.addEventListener(\"scroll\", onScroll, true);\n      return () => {\n        document.removeEventListener(\"mousedown\", onDown);\n        document.removeEventListener(\"keydown\", onKey);\n        window.removeEventListener(\"scroll\", onScroll, true);\n      };\n    }, [pos, close]);\n\n    React.useEffect(() => {\n      if (pos) menuRef.current?.focus();\n    }, [pos]);\n\n    return (\n      <div\n        ref={ref}\n        onContextMenu={(e) => {\n          e.preventDefault();\n          setPos({ x: e.clientX, y: e.clientY });\n        }}\n        className={className}\n        {...props}\n      >\n        {children}\n        {pos && (\n          <div\n            ref={menuRef}\n            role=\"menu\"\n            tabIndex={-1}\n            style={{ top: pos.y, left: pos.x }}\n            className={cn(\n              \"fixed z-50 min-w-[12rem] animate-nx-fade-in rounded-lg border border-border bg-background p-1 text-foreground shadow-md outline-none\",\n            )}\n          >\n            <ContextMenuContext.Provider value={{ close }}>{content}</ContextMenuContext.Provider>\n          </div>\n        )}\n      </div>\n    );\n  },\n);\nContextMenu.displayName = \"ContextMenu\";\n\nexport interface ContextMenuItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  icon?: React.ReactNode;\n  trailing?: React.ReactNode;\n  destructive?: boolean;\n}\n\n/** A selectable item inside a {@link ContextMenu}. Closes the menu on click. */\nexport const ContextMenuItem = React.forwardRef<HTMLButtonElement, ContextMenuItemProps>(\n  ({ icon, trailing, destructive = false, className, children, onClick, ...props }, ref) => {\n    const ctx = React.useContext(ContextMenuContext);\n    return (\n      <button\n        ref={ref}\n        type=\"button\"\n        role=\"menuitem\"\n        onClick={(e) => {\n          onClick?.(e);\n          if (!e.defaultPrevented) ctx?.close();\n        }}\n        className={cn(\n          \"flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left text-sm transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 [&_svg]:size-4\",\n          destructive ? \"text-destructive hover:bg-destructive/10\" : \"text-foreground hover:bg-accent\",\n          className,\n        )}\n        {...props}\n      >\n        {icon && <span className=\"shrink-0\">{icon}</span>}\n        <span className=\"flex-1 truncate\">{children}</span>\n        {trailing && <span className=\"shrink-0 text-muted-foreground\">{trailing}</span>}\n      </button>\n    );\n  },\n);\nContextMenuItem.displayName = \"ContextMenuItem\";\n\nexport const ContextMenuSeparator = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(\n  ({ className, ...props }, ref) => (\n    <div ref={ref} role=\"separator\" className={cn(\"-mx-1 my-1 h-px bg-border\", className)} {...props} />\n  ),\n);\nContextMenuSeparator.displayName = \"ContextMenuSeparator\";\n\nexport const ContextMenuLabel = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(\n  ({ className, ...props }, ref) => (\n    <div ref={ref} className={cn(\"px-2 py-1.5 text-xs font-medium text-muted-foreground\", className)} {...props} />\n  ),\n);\nContextMenuLabel.displayName = \"ContextMenuLabel\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,21 @@
+import * as React from 'react';
+
+interface ContextMenuProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "content"> {
+    /** Menu items — compose ContextMenuItem / ContextMenuSeparator / ContextMenuLabel. */
+    content: React.ReactNode;
+    /** The area that opens the menu on right-click. */
+    children: React.ReactNode;
+}
+/** Wraps a region so right-clicking it opens a menu at the cursor. */
+declare const ContextMenu: React.ForwardRefExoticComponent<ContextMenuProps & React.RefAttributes<HTMLDivElement>>;
+interface ContextMenuItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    icon?: React.ReactNode;
+    trailing?: React.ReactNode;
+    destructive?: boolean;
+}
+/** A selectable item inside a {@link ContextMenu}. Closes the menu on click. */
+declare const ContextMenuItem: React.ForwardRefExoticComponent<ContextMenuItemProps & React.RefAttributes<HTMLButtonElement>>;
+declare const ContextMenuSeparator: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuLabel: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+
+export { ContextMenu, ContextMenuItem, type ContextMenuItemProps, ContextMenuLabel, type ContextMenuProps, ContextMenuSeparator };

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import * as React from 'react';
+
+interface ContextMenuProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "content"> {
+    /** Menu items — compose ContextMenuItem / ContextMenuSeparator / ContextMenuLabel. */
+    content: React.ReactNode;
+    /** The area that opens the menu on right-click. */
+    children: React.ReactNode;
+}
+/** Wraps a region so right-clicking it opens a menu at the cursor. */
+declare const ContextMenu: React.ForwardRefExoticComponent<ContextMenuProps & React.RefAttributes<HTMLDivElement>>;
+interface ContextMenuItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    icon?: React.ReactNode;
+    trailing?: React.ReactNode;
+    destructive?: boolean;
+}
+/** A selectable item inside a {@link ContextMenu}. Closes the menu on click. */
+declare const ContextMenuItem: React.ForwardRefExoticComponent<ContextMenuItemProps & React.RefAttributes<HTMLButtonElement>>;
+declare const ContextMenuSeparator: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuLabel: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+
+export { ContextMenu, ContextMenuItem, type ContextMenuItemProps, ContextMenuLabel, type ContextMenuProps, ContextMenuSeparator };

package/dist/index.js

@@ -0,0 +1,103 @@
+"use client";
+import * as React from 'react';
+import { cn } from '@nucleux/utils';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/index.tsx
+var ContextMenuContext = React.createContext(null);
+var ContextMenu = React.forwardRef(
+  ({ content, children, className, ...props }, ref) => {
+    const [pos, setPos] = React.useState(null);
+    const menuRef = React.useRef(null);
+    const close = React.useCallback(() => setPos(null), []);
+    React.useEffect(() => {
+      if (!pos) return;
+      const onDown = (e) => {
+        if (!menuRef.current?.contains(e.target)) close();
+      };
+      const onKey = (e) => e.key === "Escape" && close();
+      const onScroll = () => close();
+      document.addEventListener("mousedown", onDown);
+      document.addEventListener("keydown", onKey);
+      window.addEventListener("scroll", onScroll, true);
+      return () => {
+        document.removeEventListener("mousedown", onDown);
+        document.removeEventListener("keydown", onKey);
+        window.removeEventListener("scroll", onScroll, true);
+      };
+    }, [pos, close]);
+    React.useEffect(() => {
+      if (pos) menuRef.current?.focus();
+    }, [pos]);
+    return /* @__PURE__ */ jsxs(
+      "div",
+      {
+        ref,
+        onContextMenu: (e) => {
+          e.preventDefault();
+          setPos({ x: e.clientX, y: e.clientY });
+        },
+        className,
+        ...props,
+        children: [
+          children,
+          pos && /* @__PURE__ */ jsx(
+            "div",
+            {
+              ref: menuRef,
+              role: "menu",
+              tabIndex: -1,
+              style: { top: pos.y, left: pos.x },
+              className: cn(
+                "fixed z-50 min-w-[12rem] animate-nx-fade-in rounded-lg border border-border bg-background p-1 text-foreground shadow-md outline-none"
+              ),
+              children: /* @__PURE__ */ jsx(ContextMenuContext.Provider, { value: { close }, children: content })
+            }
+          )
+        ]
+      }
+    );
+  }
+);
+ContextMenu.displayName = "ContextMenu";
+var ContextMenuItem = React.forwardRef(
+  ({ icon, trailing, destructive = false, className, children, onClick, ...props }, ref) => {
+    const ctx = React.useContext(ContextMenuContext);
+    return /* @__PURE__ */ jsxs(
+      "button",
+      {
+        ref,
+        type: "button",
+        role: "menuitem",
+        onClick: (e) => {
+          onClick?.(e);
+          if (!e.defaultPrevented) ctx?.close();
+        },
+        className: cn(
+          "flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left text-sm transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 [&_svg]:size-4",
+          destructive ? "text-destructive hover:bg-destructive/10" : "text-foreground hover:bg-accent",
+          className
+        ),
+        ...props,
+        children: [
+          icon && /* @__PURE__ */ jsx("span", { className: "shrink-0", children: icon }),
+          /* @__PURE__ */ jsx("span", { className: "flex-1 truncate", children }),
+          trailing && /* @__PURE__ */ jsx("span", { className: "shrink-0 text-muted-foreground", children: trailing })
+        ]
+      }
+    );
+  }
+);
+ContextMenuItem.displayName = "ContextMenuItem";
+var ContextMenuSeparator = React.forwardRef(
+  ({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, role: "separator", className: cn("-mx-1 my-1 h-px bg-border", className), ...props })
+);
+ContextMenuSeparator.displayName = "ContextMenuSeparator";
+var ContextMenuLabel = React.forwardRef(
+  ({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("px-2 py-1.5 text-xs font-medium text-muted-foreground", className), ...props })
+);
+ContextMenuLabel.displayName = "ContextMenuLabel";
+
+export { ContextMenu, ContextMenuItem, ContextMenuLabel, ContextMenuSeparator };
+//# 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 ContextMenuContextValue {\n  close: () => void;\n}\nconst ContextMenuContext = React.createContext<ContextMenuContextValue | null>(null);\n\nexport interface ContextMenuProps extends Omit<React.HTMLAttributes<HTMLDivElement>, \"content\"> {\n  /** Menu items — compose ContextMenuItem / ContextMenuSeparator / ContextMenuLabel. */\n  content: React.ReactNode;\n  /** The area that opens the menu on right-click. */\n  children: React.ReactNode;\n}\n\n/** Wraps a region so right-clicking it opens a menu at the cursor. */\nexport const ContextMenu = React.forwardRef<HTMLDivElement, ContextMenuProps>(\n  ({ content, children, className, ...props }, ref) => {\n    const [pos, setPos] = React.useState<{ x: number; y: number } | null>(null);\n    const menuRef = React.useRef<HTMLDivElement>(null);\n    const close = React.useCallback(() => setPos(null), []);\n\n    React.useEffect(() => {\n      if (!pos) return;\n      const onDown = (e: MouseEvent) => {\n        if (!menuRef.current?.contains(e.target as Node)) close();\n      };\n      const onKey = (e: KeyboardEvent) => e.key === \"Escape\" && close();\n      const onScroll = () => close();\n      document.addEventListener(\"mousedown\", onDown);\n      document.addEventListener(\"keydown\", onKey);\n      window.addEventListener(\"scroll\", onScroll, true);\n      return () => {\n        document.removeEventListener(\"mousedown\", onDown);\n        document.removeEventListener(\"keydown\", onKey);\n        window.removeEventListener(\"scroll\", onScroll, true);\n      };\n    }, [pos, close]);\n\n    React.useEffect(() => {\n      if (pos) menuRef.current?.focus();\n    }, [pos]);\n\n    return (\n      <div\n        ref={ref}\n        onContextMenu={(e) => {\n          e.preventDefault();\n          setPos({ x: e.clientX, y: e.clientY });\n        }}\n        className={className}\n        {...props}\n      >\n        {children}\n        {pos && (\n          <div\n            ref={menuRef}\n            role=\"menu\"\n            tabIndex={-1}\n            style={{ top: pos.y, left: pos.x }}\n            className={cn(\n              \"fixed z-50 min-w-[12rem] animate-nx-fade-in rounded-lg border border-border bg-background p-1 text-foreground shadow-md outline-none\",\n            )}\n          >\n            <ContextMenuContext.Provider value={{ close }}>{content}</ContextMenuContext.Provider>\n          </div>\n        )}\n      </div>\n    );\n  },\n);\nContextMenu.displayName = \"ContextMenu\";\n\nexport interface ContextMenuItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  icon?: React.ReactNode;\n  trailing?: React.ReactNode;\n  destructive?: boolean;\n}\n\n/** A selectable item inside a {@link ContextMenu}. Closes the menu on click. */\nexport const ContextMenuItem = React.forwardRef<HTMLButtonElement, ContextMenuItemProps>(\n  ({ icon, trailing, destructive = false, className, children, onClick, ...props }, ref) => {\n    const ctx = React.useContext(ContextMenuContext);\n    return (\n      <button\n        ref={ref}\n        type=\"button\"\n        role=\"menuitem\"\n        onClick={(e) => {\n          onClick?.(e);\n          if (!e.defaultPrevented) ctx?.close();\n        }}\n        className={cn(\n          \"flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left text-sm transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 [&_svg]:size-4\",\n          destructive ? \"text-destructive hover:bg-destructive/10\" : \"text-foreground hover:bg-accent\",\n          className,\n        )}\n        {...props}\n      >\n        {icon && <span className=\"shrink-0\">{icon}</span>}\n        <span className=\"flex-1 truncate\">{children}</span>\n        {trailing && <span className=\"shrink-0 text-muted-foreground\">{trailing}</span>}\n      </button>\n    );\n  },\n);\nContextMenuItem.displayName = \"ContextMenuItem\";\n\nexport const ContextMenuSeparator = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(\n  ({ className, ...props }, ref) => (\n    <div ref={ref} role=\"separator\" className={cn(\"-mx-1 my-1 h-px bg-border\", className)} {...props} />\n  ),\n);\nContextMenuSeparator.displayName = \"ContextMenuSeparator\";\n\nexport const ContextMenuLabel = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(\n  ({ className, ...props }, ref) => (\n    <div ref={ref} className={cn(\"px-2 py-1.5 text-xs font-medium text-muted-foreground\", className)} {...props} />\n  ),\n);\nContextMenuLabel.displayName = \"ContextMenuLabel\";\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@nucleux/context-menu",
+  "version": "0.2.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Right-click context menu — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "context-menu"
+  ],
+  "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": {
+    "lucide-react": "^0.469.0",
+    "@nucleux/utils": "0.2.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "@types/react": "^18.3.18",
+    "react": "^18.3.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intelligaia-open-labs/nucleux.git",
+    "directory": "packages/context-menu"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
+}