@nordcom/nordstar-tooltip 0.0.75

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2023-2026 Filiph Sandström <filfat@hotmail.se>
+Copyright (c) 2023-2024 Nordcom AB <opensource@nordcom.io>
+Copyright (c) 2020 Junior Garcia (Next UI)
+
+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,12 @@
+# [@nordcom/nordstar-tooltip](https://nordcominc.github.io/nordstar/docs/components/tooltip/?utm_source=nordstar&utm_campaign=oss)
+
+A thin rule that divides content visually or semantically.
+
+## Installation
+
+> [!TIP]
+> This is an internal package and should probably not be installed by itself, but rather come as a dependency of `@nordcom/nordstar`.
+
+```sh
+npm install @nordcom/nordstar-tooltip
+```

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { default as Tooltip } from './tooltip';
+export type { TooltipContentProps, TooltipProps } from './tooltip';
+export { Tooltip };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,WAAW,CAAC;AAEhC,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEnE,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+import Tooltip from "./tooltip.js";
+export { Tooltip };

package/dist/tooltip.d.ts

@@ -0,0 +1,34 @@
+import { ComponentPropsWithoutRef, ForwardRefExoticComponent, RefAttributes, FC } from 'react';
+import * as Primitive from '@radix-ui/react-tooltip';
+export type TooltipContentProps = ComponentPropsWithoutRef<typeof Primitive.Content>;
+export type TooltipProps = ComponentPropsWithoutRef<typeof Primitive.Root>;
+/**
+ * `<Tooltip/>`, a floating label that explains an element on hover or keyboard focus.
+ *
+ * Wraps `@radix-ui/react-tooltip` as a compound component: mount `<Tooltip.Provider>` once near the
+ * root of the app (or section) to share open/close timing, then compose `<Tooltip>` with
+ * `<Tooltip.Trigger>` and `<Tooltip.Content>`. Radix handles focus, dismissal, collision-aware
+ * positioning, and the `aria-describedby` wiring; the content is re-fitted to the Nordstar token
+ * contract. Tooltips are supplementary — never put essential or interactive content inside one.
+ *
+ * @param {object} props - Every `@radix-ui/react-tooltip` Root prop (`open`, `defaultOpen`, `delayDuration`, …).
+ * @returns {React.ReactNode} The tooltip root that scopes a single trigger/content pair.
+ *
+ * @example
+ * ```tsx
+ * <Tooltip.Provider>
+ *     <Tooltip>
+ *         <Tooltip.Trigger>Hover me</Tooltip.Trigger>
+ *         <Tooltip.Content>Helpful hint</Tooltip.Content>
+ *     </Tooltip>
+ * </Tooltip.Provider>
+ * ```
+ */
+declare const Tooltip: ((props: TooltipProps) => import("react").JSX.Element) & {
+    Content: ForwardRefExoticComponent<Omit<Primitive.TooltipContentProps & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLDivElement>>;
+    displayName: string;
+    Provider: FC<Primitive.TooltipProviderProps>;
+    Trigger: ForwardRefExoticComponent<Primitive.TooltipTriggerProps & RefAttributes<HTMLButtonElement>>;
+};
+export default Tooltip;
+//# sourceMappingURL=tooltip.d.ts.map

package/dist/tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../src/tooltip.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,KAAK,wBAAwB,EAAiC,MAAM,OAAO,CAAC;AAErF,MAAM,MAAM,mBAAmB,GAAG,wBAAwB,CAAC,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;AA6BrF,MAAM,MAAM,YAAY,GAAG,wBAAwB,CAAC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,QAAA,MAAM,OAAO,WACD,YAAY;;;;;CASvB,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/tooltip.js

@@ -0,0 +1,55 @@
+"use client";
+import { cn } from "@nordcom/nordstar-system";
+import * as Primitive from "@radix-ui/react-tooltip";
+import { forwardRef } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/tooltip.tsx
+/**
+* `<Tooltip.Content/>`, the portal-rendered bubble shown next to the trigger.
+*
+* @param {object} props - Every `@radix-ui/react-tooltip` Content prop.
+* @param {number} [props.sideOffset=6] - Pixel gap between the trigger and the bubble.
+* @returns {React.ReactNode} The portalled tooltip content with a matching arrow.
+*/
+var TooltipContent = forwardRef(({ className, sideOffset = 6, children, ...props }, ref) => /* @__PURE__ */ jsx(Primitive.Portal, { children: /* @__PURE__ */ jsxs(Primitive.Content, {
+	className: cn("z-50 max-w-xs select-none text-balance rounded-sm border-2 border-foreground border-solid bg-foreground px-2 py-1 font-body font-semibold text-background text-xs leading-tight shadow-lg", className),
+	ref,
+	sideOffset,
+	...props,
+	children: [children, /* @__PURE__ */ jsx(Primitive.Arrow, { className: "fill-foreground" })]
+}) }));
+TooltipContent.displayName = "Nordstar.Tooltip.Content";
+/**
+* `<Tooltip/>`, a floating label that explains an element on hover or keyboard focus.
+*
+* Wraps `@radix-ui/react-tooltip` as a compound component: mount `<Tooltip.Provider>` once near the
+* root of the app (or section) to share open/close timing, then compose `<Tooltip>` with
+* `<Tooltip.Trigger>` and `<Tooltip.Content>`. Radix handles focus, dismissal, collision-aware
+* positioning, and the `aria-describedby` wiring; the content is re-fitted to the Nordstar token
+* contract. Tooltips are supplementary — never put essential or interactive content inside one.
+*
+* @param {object} props - Every `@radix-ui/react-tooltip` Root prop (`open`, `defaultOpen`, `delayDuration`, …).
+* @returns {React.ReactNode} The tooltip root that scopes a single trigger/content pair.
+*
+* @example
+* ```tsx
+* <Tooltip.Provider>
+*     <Tooltip>
+*         <Tooltip.Trigger>Hover me</Tooltip.Trigger>
+*         <Tooltip.Content>Helpful hint</Tooltip.Content>
+*     </Tooltip>
+* </Tooltip.Provider>
+* ```
+*/
+var Tooltip = Object.assign((props) => {
+	return /* @__PURE__ */ jsx(Primitive.Root, { ...props });
+}, {
+	Content: TooltipContent,
+	displayName: "Nordstar.Tooltip",
+	Provider: Primitive.Provider,
+	Trigger: Primitive.Trigger
+});
+//#endregion
+export { Tooltip as default };
+
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidG9vbHRpcC5qcyIsIm5hbWVzIjpbXSwic291cmNlcyI6WyIuLi9zcmMvdG9vbHRpcC50c3giXSwic291cmNlc0NvbnRlbnQiOlsiJ3VzZSBjbGllbnQnO1xuXG5pbXBvcnQgeyBjbiB9IGZyb20gJ0Bub3JkY29tL25vcmRzdGFyLXN5c3RlbSc7XG5pbXBvcnQgKiBhcyBQcmltaXRpdmUgZnJvbSAnQHJhZGl4LXVpL3JlYWN0LXRvb2x0aXAnO1xuaW1wb3J0IHsgdHlwZSBDb21wb25lbnRQcm9wc1dpdGhvdXRSZWYsIHR5cGUgQ29tcG9uZW50UmVmLCBmb3J3YXJkUmVmIH0gZnJvbSAncmVhY3QnO1xuXG5leHBvcnQgdHlwZSBUb29sdGlwQ29udGVudFByb3BzID0gQ29tcG9uZW50UHJvcHNXaXRob3V0UmVmPHR5cGVvZiBQcmltaXRpdmUuQ29udGVudD47XG5cbi8qKlxuICogYDxUb29sdGlwLkNvbnRlbnQvPmAsIHRoZSBwb3J0YWwtcmVuZGVyZWQgYnViYmxlIHNob3duIG5leHQgdG8gdGhlIHRyaWdnZXIuXG4gKlxuICogQHBhcmFtIHtvYmplY3R9IHByb3BzIC0gRXZlcnkgYEByYWRpeC11aS9yZWFjdC10b29sdGlwYCBDb250ZW50IHByb3AuXG4gKiBAcGFyYW0ge251bWJlcn0gW3Byb3BzLnNpZGVPZmZzZXQ9Nl0gLSBQaXhlbCBnYXAgYmV0d2VlbiB0aGUgdHJpZ2dlciBhbmQgdGhlIGJ1YmJsZS5cbiAqIEByZXR1cm5zIHtSZWFjdC5SZWFjdE5vZGV9IFRoZSBwb3J0YWxsZWQgdG9vbHRpcCBjb250ZW50IHdpdGggYSBtYXRjaGluZyBhcnJvdy5cbiAqL1xuY29uc3QgVG9vbHRpcENvbnRlbnQgPSBmb3J3YXJkUmVmPENvbXBvbmVudFJlZjx0eXBlb2YgUHJpbWl0aXZlLkNvbnRlbnQ+LCBUb29sdGlwQ29udGVudFByb3BzPihcbiAgICAoeyBjbGFzc05hbWUsIHNpZGVPZmZzZXQgPSA2LCBjaGlsZHJlbiwgLi4ucHJvcHMgfSwgcmVmKSA9PiAoXG4gICAgICAgIDxQcmltaXRpdmUuUG9ydGFsPlxuICAgICAgICAgICAgPFByaW1pdGl2ZS5Db250ZW50XG4gICAgICAgICAgICAgICAgY2xhc3NOYW1lPXtjbihcbiAgICAgICAgICAgICAgICAgICAgJ3otNTAgbWF4LXcteHMgc2VsZWN0LW5vbmUgdGV4dC1iYWxhbmNlIHJvdW5kZWQtc20gYm9yZGVyLTIgYm9yZGVyLWZvcmVncm91bmQgYm9yZGVyLXNvbGlkIGJnLWZvcmVncm91bmQgcHgtMiBweS0xIGZvbnQtYm9keSBmb250LXNlbWlib2xkIHRleHQtYmFja2dyb3VuZCB0ZXh0LXhzIGxlYWRpbmctdGlnaHQgc2hhZG93LWxnJyxcbiAgICAgICAgICAgICAgICAgICAgY2xhc3NOYW1lLFxuICAgICAgICAgICAgICAgICl9XG4gICAgICAgICAgICAgICAgcmVmPXtyZWZ9XG4gICAgICAgICAgICAgICAgc2lkZU9mZnNldD17c2lkZU9mZnNldH1cbiAgICAgICAgICAgICAgICB7Li4ucHJvcHN9XG4gICAgICAgICAgICA+XG4gICAgICAgICAgICAgICAge2NoaWxkcmVufVxuICAgICAgICAgICAgICAgIDxQcmltaXRpdmUuQXJyb3cgY2xhc3NOYW1lPVwiZmlsbC1mb3JlZ3JvdW5kXCIgLz5cbiAgICAgICAgICAgIDwvUHJpbWl0aXZlLkNvbnRlbnQ+XG4gICAgICAgIDwvUHJpbWl0aXZlLlBvcnRhbD5cbiAgICApLFxuKTtcblRvb2x0aXBDb250ZW50LmRpc3BsYXlOYW1lID0gJ05vcmRzdGFyLlRvb2x0aXAuQ29udGVudCc7XG5cbmV4cG9ydCB0eXBlIFRvb2x0aXBQcm9wcyA9IENvbXBvbmVudFByb3BzV2l0aG91dFJlZjx0eXBlb2YgUHJpbWl0aXZlLlJvb3Q+O1xuXG4vKipcbiAqIGA8VG9vbHRpcC8+YCwgYSBmbG9hdGluZyBsYWJlbCB0aGF0IGV4cGxhaW5zIGFuIGVsZW1lbnQgb24gaG92ZXIgb3Iga2V5Ym9hcmQgZm9jdXMuXG4gKlxuICogV3JhcHMgYEByYWRpeC11aS9yZWFjdC10b29sdGlwYCBhcyBhIGNvbXBvdW5kIGNvbXBvbmVudDogbW91bnQgYDxUb29sdGlwLlByb3ZpZGVyPmAgb25jZSBuZWFyIHRoZVxuICogcm9vdCBvZiB0aGUgYXBwIChvciBzZWN0aW9uKSB0byBzaGFyZSBvcGVuL2Nsb3NlIHRpbWluZywgdGhlbiBjb21wb3NlIGA8VG9vbHRpcD5gIHdpdGhcbiAqIGA8VG9vbHRpcC5UcmlnZ2VyPmAgYW5kIGA8VG9vbHRpcC5Db250ZW50PmAuIFJhZGl4IGhhbmRsZXMgZm9jdXMsIGRpc21pc3NhbCwgY29sbGlzaW9uLWF3YXJlXG4gKiBwb3NpdGlvbmluZywgYW5kIHRoZSBgYXJpYS1kZXNjcmliZWRieWAgd2lyaW5nOyB0aGUgY29udGVudCBpcyByZS1maXR0ZWQgdG8gdGhlIE5vcmRzdGFyIHRva2VuXG4gKiBjb250cmFjdC4gVG9vbHRpcHMgYXJlIHN1cHBsZW1lbnRhcnkg4oCUIG5ldmVyIHB1dCBlc3NlbnRpYWwgb3IgaW50ZXJhY3RpdmUgY29udGVudCBpbnNpZGUgb25lLlxuICpcbiAqIEBwYXJhbSB7b2JqZWN0fSBwcm9wcyAtIEV2ZXJ5IGBAcmFkaXgtdWkvcmVhY3QtdG9vbHRpcGAgUm9vdCBwcm9wIChgb3BlbmAsIGBkZWZhdWx0T3BlbmAsIGBkZWxheUR1cmF0aW9uYCwg4oCmKS5cbiAqIEByZXR1cm5zIHtSZWFjdC5SZWFjdE5vZGV9IFRoZSB0b29sdGlwIHJvb3QgdGhhdCBzY29wZXMgYSBzaW5nbGUgdHJpZ2dlci9jb250ZW50IHBhaXIuXG4gKlxuICogQGV4YW1wbGVcbiAqIGBgYHRzeFxuICogPFRvb2x0aXAuUHJvdmlkZXI+XG4gKiAgICAgPFRvb2x0aXA+XG4gKiAgICAgICAgIDxUb29sdGlwLlRyaWdnZXI+SG92ZXIgbWU8L1Rvb2x0aXAuVHJpZ2dlcj5cbiAqICAgICAgICAgPFRvb2x0aXAuQ29udGVudD5IZWxwZnVsIGhpbnQ8L1Rvb2x0aXAuQ29udGVudD5cbiAqICAgICA8L1Rvb2x0aXA+XG4gKiA8L1Rvb2x0aXAuUHJvdmlkZXI+XG4gKiBgYGBcbiAqL1xuY29uc3QgVG9vbHRpcCA9IE9iamVjdC5hc3NpZ24oXG4gICAgKHByb3BzOiBUb29sdGlwUHJvcHMpID0+IHtcbiAgICAgICAgcmV0dXJuIDxQcmltaXRpdmUuUm9vdCB7Li4ucHJvcHN9IC8+O1xuICAgIH0sXG4gICAge1xuICAgICAgICBDb250ZW50OiBUb29sdGlwQ29udGVudCxcbiAgICAgICAgZGlzcGxheU5hbWU6ICdOb3Jkc3Rhci5Ub29sdGlwJyxcbiAgICAgICAgUHJvdmlkZXI6IFByaW1pdGl2ZS5Qcm92aWRlcixcbiAgICAgICAgVHJpZ2dlcjogUHJpbWl0aXZlLlRyaWdnZXIsXG4gICAgfSxcbik7XG5cbmV4cG9ydCBkZWZhdWx0IFRvb2x0aXA7XG4iXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7QUFlQSxJQUFNLGlCQUFpQixZQUNsQixFQUFFLFdBQVcsYUFBYSxHQUFHLFVBQVUsR0FBRyxTQUFTLFFBQ2hELG9CQUFDLFVBQVUsUUFBWCxFQUFBLFVBQ0kscUJBQUMsVUFBVSxTQUFYO0NBQ0ksV0FBVyxHQUNQLDZMQUNBLFNBQ0o7Q0FDSztDQUNPO0NBQ1osR0FBSTtXQVBSLENBU0ssVUFDRCxvQkFBQyxVQUFVLE9BQVgsRUFBaUIsV0FBVSxrQkFBbUIsQ0FBQSxDQUMvQjtHQUNMLENBQUEsQ0FFMUI7QUFDQSxlQUFlLGNBQWM7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBMEI3QixJQUFNLFVBQVUsT0FBTyxRQUNsQixVQUF3QjtDQUNyQixPQUFPLG9CQUFDLFVBQVUsTUFBWCxFQUFnQixHQUFJLE1BQVEsQ0FBQTtBQUN2QyxHQUNBO0NBQ0ksU0FBUztDQUNULGFBQWE7Q0FDYixVQUFVLFVBQVU7Q0FDcEIsU0FBUyxVQUFVO0FBQ3ZCLENBQ0oifQ==

package/package.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "@nordcom/nordstar-tooltip",
+  "type": "module",
+  "version": "0.0.75",
+  "description": "A floating label that explains an element on hover or focus.",
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "keywords": [
+    "nordstar",
+    "nordcom",
+    "component",
+    "react",
+    "tooltip",
+    "popover",
+    "nordstar-tooltip"
+  ],
+  "author": {
+    "name": "Filiph Sandström",
+    "email": "filfat@hotmail.se",
+    "url": "https://github.com/filiphsps/"
+  },
+  "contributors": [
+    {
+      "name": "Filiph Sandström",
+      "email": "filfat@hotmail.se",
+      "url": "https://github.com/filiphsps/"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NordcomInc/nordstar.git",
+    "directory": "packages/components/tooltip"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/NordcomInc/nordstar/issues"
+  },
+  "homepage": "https://nordcominc.github.io/nordstar/docs/components/tooltip/",
+  "dependencies": {
+    "@radix-ui/react-tooltip": "1.2.9",
+    "@nordcom/nordstar-system": "0.0.75"
+  },
+  "peerDependencies": {
+    "react": ">=19",
+    "react-dom": ">=19"
+  },
+  "devDependencies": {
+    "@types/node": "25.9.3",
+    "@types/react": "19.2.17",
+    "@types/react-dom": "19.2.3",
+    "react": "19.2.7",
+    "react-dom": "19.2.7",
+    "typescript": "6.0.3",
+    "vite": "8.0.16",
+    "vite-plugin-dts": "5.0.2"
+  },
+  "scripts": {
+    "build": "tsc && vite build",
+    "dev": "vite build --watch",
+    "clean": "rm -rf dist coverage .turbo .next *.tsbuildinfo *.log",
+    "typecheck": "tsc --noEmit"
+  }
+}