@robertlinde/react-tour-kit 0.0.1

package/dist/shared/utils/calculate-tooltip-position.util.d.ts

@@ -0,0 +1,14 @@
+import { type Rect } from '../types';
+type TooltipDimensions = {
+    readonly width: number;
+    readonly height: number;
+};
+type ViewportDimensions = {
+    readonly width: number;
+    readonly height: number;
+};
+export declare function calculateTooltipPosition(targetRect: Rect, placement: 'top' | 'bottom' | 'left' | 'right', tooltipDimensions: TooltipDimensions, viewportDimensions: ViewportDimensions): {
+    top: number;
+    left: number;
+};
+export {};

package/dist/shared/utils/calculate-tooltip-position.util.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateTooltipPosition = calculateTooltipPosition;
+const tooltipWidthDesktop = 400;
+const tooltipWidthMobile = 320;
+const mobileBreakpoint = 640;
+const defaultTooltipHeight = 200;
+const tooltipPadding = 16;
+function calculateTooltipPosition(targetRect, placement, tooltipDimensions, viewportDimensions) {
+    const viewportWidth = viewportDimensions.width;
+    const viewportHeight = viewportDimensions.height;
+    const isMobile = viewportWidth < mobileBreakpoint;
+    const defaultWidth = isMobile
+        ? Math.min(tooltipWidthMobile, viewportWidth - tooltipPadding * 2)
+        : tooltipWidthDesktop;
+    const tooltipWidth = tooltipDimensions.width > 0 ? tooltipDimensions.width : defaultWidth;
+    const tooltipHeight = tooltipDimensions.height > 0 ? tooltipDimensions.height : defaultTooltipHeight;
+    let top = 0;
+    let left = 0;
+    switch (placement) {
+        case 'top': {
+            top = targetRect.top - tooltipHeight - tooltipPadding;
+            left = targetRect.left + targetRect.width / 2 - tooltipWidth / 2;
+            break;
+        }
+        case 'bottom': {
+            top = targetRect.bottom + tooltipPadding;
+            left = targetRect.left + targetRect.width / 2 - tooltipWidth / 2;
+            break;
+        }
+        case 'left': {
+            top = targetRect.top + targetRect.height / 2 - tooltipHeight / 2;
+            left = targetRect.left - tooltipWidth - tooltipPadding;
+            break;
+        }
+        case 'right': {
+            top = targetRect.top + targetRect.height / 2 - tooltipHeight / 2;
+            left = targetRect.right + tooltipPadding;
+            break;
+        }
+    }
+    if (left < tooltipPadding) {
+        left = tooltipPadding;
+    }
+    if (left + tooltipWidth > viewportWidth - tooltipPadding) {
+        left = viewportWidth - tooltipWidth - tooltipPadding;
+    }
+    if (top < tooltipPadding) {
+        top = targetRect.bottom + tooltipPadding;
+    }
+    if (top + tooltipHeight > viewportHeight - tooltipPadding) {
+        top = targetRect.top - tooltipHeight - tooltipPadding;
+    }
+    return { top, left };
+}
+//# sourceMappingURL=calculate-tooltip-position.util.js.map

package/dist/shared/utils/calculate-tooltip-position.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate-tooltip-position.util.js","sourceRoot":"","sources":["../../../src/shared/utils/calculate-tooltip-position.util.ts"],"names":[],"mappings":"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"}

package/dist/shared/utils/index.d.ts

@@ -0,0 +1 @@
+export { calculateTooltipPosition } from './calculate-tooltip-position.util';

package/dist/shared/utils/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateTooltipPosition = void 0;
+var calculate_tooltip_position_util_1 = require("./calculate-tooltip-position.util");
+Object.defineProperty(exports, "calculateTooltipPosition", { enumerable: true, get: function () { return calculate_tooltip_position_util_1.calculateTooltipPosition; } });
+//# sourceMappingURL=index.js.map

package/dist/shared/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":";;;AAAA,qFAA2E;AAAnE,2IAAA,wBAAwB,OAAA"}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@robertlinde/react-tour-kit",
+  "version": "0.0.1",
+  "description": "Cross-platform guided tour library for React and React Native. Build interactive onboarding experiences with customizable tooltips, smart positioning, cross-page navigation, and async step actions. Fully themeable with TypeScript support.",
+  "author": "Robert Linde",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/robertlinde/react-tour-kit.git"
+  },
+  "homepage": "https://github.com/robertlinde/react-tour-kit#readme",
+  "bugs": {
+    "url": "https://github.com/robertlinde/react-tour-kit/issues"
+  },
+  "scripts": {
+    "start:dev": "tsc --watch",
+    "build": "tsc",
+    "lint": "xo",
+    "lint:fix": "xo --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepublishOnly": "npm run build",
+    "prepare": "husky || true"
+  },
+  "main": "./dist/react.js",
+  "module": "./dist/react.js",
+  "types": "./dist/react.d.ts",
+  "exports": {
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "require": "./dist/react.js",
+      "import": "./dist/react.js"
+    },
+    "./react-native": {
+      "types": "./dist/react-native.d.ts",
+      "require": "./dist/react-native.js",
+      "import": "./dist/react-native.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "react-native": ">=0.70.0"
+  },
+  "peerDependenciesMeta": {
+    "react-dom": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.0.0",
+    "@commitlint/config-conventional": "^19.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@types/react-native": "^0.72.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.0.0",
+    "prettier": "^3.7.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.7.0",
+    "xo": "^1.2.3"
+  },
+  "keywords": [
+    "react",
+    "react-native",
+    "tour",
+    "guided-tour",
+    "walkthrough",
+    "onboarding",
+    "tooltip",
+    "tutorial",
+    "intro",
+    "product-tour"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}