@korsolutions/guidon 1.0.1 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (143) hide show
  1. package/dist/commonjs/babel.config.js +15 -0
  2. package/dist/commonjs/babel.config.js.map +1 -0
  3. package/dist/commonjs/bob.config.js +11 -0
  4. package/dist/commonjs/bob.config.js.map +1 -0
  5. package/dist/commonjs/components/GuidonOverlay.js +206 -0
  6. package/dist/commonjs/components/GuidonOverlay.js.map +1 -0
  7. package/dist/commonjs/components/GuidonProvider.js +157 -0
  8. package/dist/commonjs/components/GuidonProvider.js.map +1 -0
  9. package/dist/commonjs/components/GuidonTarget.js +110 -0
  10. package/dist/commonjs/components/GuidonTarget.js.map +1 -0
  11. package/dist/commonjs/components/GuidonTooltip.js +422 -0
  12. package/dist/commonjs/components/GuidonTooltip.js.map +1 -0
  13. package/dist/commonjs/components/index.js +40 -0
  14. package/dist/commonjs/components/index.js.map +1 -0
  15. package/dist/commonjs/hooks/index.js +13 -0
  16. package/dist/commonjs/hooks/index.js.map +1 -0
  17. package/dist/commonjs/hooks/useGuidonRef.js +132 -0
  18. package/dist/commonjs/hooks/useGuidonRef.js.map +1 -0
  19. package/dist/commonjs/index.js +143 -0
  20. package/dist/commonjs/index.js.map +1 -0
  21. package/dist/commonjs/package.json +1 -0
  22. package/dist/commonjs/persistence/adapters.js +213 -0
  23. package/dist/commonjs/persistence/adapters.js.map +1 -0
  24. package/dist/commonjs/persistence/hooks.js +153 -0
  25. package/dist/commonjs/persistence/hooks.js.map +1 -0
  26. package/dist/commonjs/persistence/index.js +28 -0
  27. package/dist/commonjs/persistence/index.js.map +1 -0
  28. package/dist/commonjs/store.js +314 -0
  29. package/dist/commonjs/store.js.map +1 -0
  30. package/dist/commonjs/tsconfig.json +32 -0
  31. package/dist/commonjs/types.js +6 -0
  32. package/dist/commonjs/types.js.map +1 -0
  33. package/dist/module/babel.config.js +15 -0
  34. package/dist/module/babel.config.js.map +1 -0
  35. package/dist/module/bob.config.js +11 -0
  36. package/dist/module/bob.config.js.map +1 -0
  37. package/dist/module/components/GuidonOverlay.js +201 -0
  38. package/dist/module/components/GuidonOverlay.js.map +1 -0
  39. package/dist/module/components/GuidonProvider.js +152 -0
  40. package/dist/module/components/GuidonProvider.js.map +1 -0
  41. package/dist/module/components/GuidonTarget.js +106 -0
  42. package/dist/module/components/GuidonTarget.js.map +1 -0
  43. package/dist/module/components/GuidonTooltip.js +417 -0
  44. package/dist/module/components/GuidonTooltip.js.map +1 -0
  45. package/dist/module/components/index.js +7 -0
  46. package/dist/module/components/index.js.map +1 -0
  47. package/dist/module/hooks/index.js +4 -0
  48. package/dist/module/hooks/index.js.map +1 -0
  49. package/dist/module/hooks/useGuidonRef.js +129 -0
  50. package/dist/module/hooks/useGuidonRef.js.map +1 -0
  51. package/dist/module/index.js +17 -0
  52. package/dist/module/index.js.map +1 -0
  53. package/dist/module/package.json +1 -0
  54. package/dist/module/persistence/adapters.js +203 -0
  55. package/dist/module/persistence/adapters.js.map +1 -0
  56. package/dist/module/persistence/hooks.js +148 -0
  57. package/dist/module/persistence/hooks.js.map +1 -0
  58. package/dist/module/persistence/index.js +5 -0
  59. package/dist/module/persistence/index.js.map +1 -0
  60. package/dist/module/store.js +304 -0
  61. package/dist/module/store.js.map +1 -0
  62. package/dist/module/tsconfig.json +32 -0
  63. package/dist/module/types.js +4 -0
  64. package/dist/module/types.js.map +1 -0
  65. package/dist/typescript/commonjs/components/GuidonOverlay.d.ts +9 -0
  66. package/dist/typescript/commonjs/components/GuidonOverlay.d.ts.map +1 -0
  67. package/dist/typescript/commonjs/components/GuidonProvider.d.ts +14 -0
  68. package/dist/typescript/commonjs/components/GuidonProvider.d.ts.map +1 -0
  69. package/dist/typescript/commonjs/components/GuidonTarget.d.ts +7 -0
  70. package/dist/typescript/commonjs/components/GuidonTarget.d.ts.map +1 -0
  71. package/dist/typescript/commonjs/components/GuidonTooltip.d.ts +24 -0
  72. package/dist/typescript/commonjs/components/GuidonTooltip.d.ts.map +1 -0
  73. package/dist/typescript/commonjs/components/index.d.ts +5 -0
  74. package/dist/typescript/commonjs/components/index.d.ts.map +1 -0
  75. package/dist/typescript/commonjs/hooks/index.d.ts +2 -0
  76. package/dist/typescript/commonjs/hooks/index.d.ts.map +1 -0
  77. package/dist/typescript/commonjs/hooks/useGuidonRef.d.ts +35 -0
  78. package/dist/typescript/commonjs/hooks/useGuidonRef.d.ts.map +1 -0
  79. package/dist/typescript/commonjs/index.d.ts +7 -0
  80. package/dist/typescript/commonjs/index.d.ts.map +1 -0
  81. package/dist/typescript/commonjs/package.json +1 -0
  82. package/dist/typescript/commonjs/persistence/adapters.d.ts +57 -0
  83. package/dist/typescript/commonjs/persistence/adapters.d.ts.map +1 -0
  84. package/dist/typescript/commonjs/persistence/hooks.d.ts +29 -0
  85. package/dist/typescript/commonjs/persistence/hooks.d.ts.map +1 -0
  86. package/dist/typescript/commonjs/persistence/index.d.ts +3 -0
  87. package/dist/typescript/commonjs/persistence/index.d.ts.map +1 -0
  88. package/dist/typescript/commonjs/store.d.ts +89 -0
  89. package/dist/typescript/commonjs/store.d.ts.map +1 -0
  90. package/dist/{index-D_JFvCIg.d.mts → typescript/commonjs/types.d.ts} +40 -104
  91. package/dist/typescript/commonjs/types.d.ts.map +1 -0
  92. package/dist/typescript/module/components/GuidonOverlay.d.ts +9 -0
  93. package/dist/typescript/module/components/GuidonOverlay.d.ts.map +1 -0
  94. package/dist/typescript/module/components/GuidonProvider.d.ts +14 -0
  95. package/dist/typescript/module/components/GuidonProvider.d.ts.map +1 -0
  96. package/dist/typescript/module/components/GuidonTarget.d.ts +7 -0
  97. package/dist/typescript/module/components/GuidonTarget.d.ts.map +1 -0
  98. package/dist/typescript/module/components/GuidonTooltip.d.ts +24 -0
  99. package/dist/typescript/module/components/GuidonTooltip.d.ts.map +1 -0
  100. package/dist/typescript/module/components/index.d.ts +5 -0
  101. package/dist/typescript/module/components/index.d.ts.map +1 -0
  102. package/dist/typescript/module/hooks/index.d.ts +2 -0
  103. package/dist/typescript/module/hooks/index.d.ts.map +1 -0
  104. package/dist/typescript/module/hooks/useGuidonRef.d.ts +35 -0
  105. package/dist/typescript/module/hooks/useGuidonRef.d.ts.map +1 -0
  106. package/dist/typescript/module/index.d.ts +7 -0
  107. package/dist/typescript/module/index.d.ts.map +1 -0
  108. package/dist/typescript/module/package.json +1 -0
  109. package/dist/typescript/module/persistence/adapters.d.ts +57 -0
  110. package/dist/typescript/module/persistence/adapters.d.ts.map +1 -0
  111. package/dist/typescript/module/persistence/hooks.d.ts +29 -0
  112. package/dist/typescript/module/persistence/hooks.d.ts.map +1 -0
  113. package/dist/typescript/module/persistence/index.d.ts +3 -0
  114. package/dist/typescript/module/persistence/index.d.ts.map +1 -0
  115. package/dist/typescript/module/store.d.ts +89 -0
  116. package/dist/typescript/module/store.d.ts.map +1 -0
  117. package/dist/{index-D_JFvCIg.d.ts → typescript/module/types.d.ts} +40 -104
  118. package/dist/typescript/module/types.d.ts.map +1 -0
  119. package/package.json +25 -13
  120. package/src/babel.config.js +18 -0
  121. package/src/bob.config.js +14 -0
  122. package/src/components/GuidonOverlay.tsx +60 -4
  123. package/src/components/GuidonProvider.tsx +29 -1
  124. package/src/components/GuidonTarget.tsx +41 -25
  125. package/src/components/GuidonTooltip.tsx +143 -9
  126. package/src/hooks/index.ts +1 -0
  127. package/src/hooks/useGuidonRef.ts +154 -0
  128. package/src/index.ts +6 -0
  129. package/src/store.ts +68 -15
  130. package/src/tsconfig.json +32 -0
  131. package/src/types.ts +32 -2
  132. package/dist/index.d.mts +0 -128
  133. package/dist/index.d.ts +0 -128
  134. package/dist/index.js +0 -1097
  135. package/dist/index.js.map +0 -1
  136. package/dist/index.mjs +0 -1072
  137. package/dist/index.mjs.map +0 -1
  138. package/dist/persistence/index.d.mts +0 -2
  139. package/dist/persistence/index.d.ts +0 -2
  140. package/dist/persistence/index.js +0 -300
  141. package/dist/persistence/index.js.map +0 -1
  142. package/dist/persistence/index.mjs +0 -291
  143. package/dist/persistence/index.mjs.map +0 -1
@@ -0,0 +1,15 @@
1
+ "use strict";
2
+
3
+ module.exports = function (api) {
4
+ api.cache(true);
5
+ return {
6
+ presets: ["module:react-native-builder-bob/babel-preset"],
7
+ plugins: [[require.resolve("babel-plugin-module-resolver"), {
8
+ root: ["./src"],
9
+ alias: {
10
+ "@": "./src"
11
+ }
12
+ }]]
13
+ };
14
+ };
15
+ //# sourceMappingURL=babel.config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"names":["module","exports","api","cache","presets","plugins","require","resolve","root","alias"],"sourceRoot":"../../src","sources":["babel.config.js"],"mappings":";;AAAAA,MAAM,CAACC,OAAO,GAAG,UAAUC,GAAG,EAAE;EAC9BA,GAAG,CAACC,KAAK,CAAC,IAAI,CAAC;EAEf,OAAO;IACLC,OAAO,EAAE,CAAC,8CAA8C,CAAC;IACzDC,OAAO,EAAE,CACP,CACEC,OAAO,CAACC,OAAO,CAAC,8BAA8B,CAAC,EAC/C;MACEC,IAAI,EAAE,CAAC,OAAO,CAAC;MACfC,KAAK,EAAE;QACL,GAAG,EAAE;MACP;IACF,CAAC,CACF;EAEL,CAAC;AACH,CAAC","ignoreList":[]}
@@ -0,0 +1,11 @@
1
+ "use strict";
2
+
3
+ module.exports = {
4
+ source: "src",
5
+ output: "dist",
6
+ targets: [["module", {
7
+ esm: true,
8
+ configFile: true
9
+ }], "typescript"]
10
+ };
11
+ //# sourceMappingURL=bob.config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"names":["module","exports","source","output","targets","esm","configFile"],"sourceRoot":"../../src","sources":["bob.config.js"],"mappings":";;AAAAA,MAAM,CAACC,OAAO,GAAG;EACfC,MAAM,EAAE,KAAK;EACbC,MAAM,EAAE,MAAM;EACdC,OAAO,EAAE,CACP,CACE,QAAQ,EACR;IACEC,GAAG,EAAE,IAAI;IACTC,UAAU,EAAE;EACd,CAAC,CACF,EACD,YAAY;AAEhB,CAAC","ignoreList":[]}
@@ -0,0 +1,206 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.GuidonOverlay = GuidonOverlay;
7
+ var _react = require("react");
8
+ var _reactNative = require("react-native");
9
+ var _reactNativeReanimated = _interopRequireWildcard(require("react-native-reanimated"));
10
+ var _reactNativeSvg = _interopRequireWildcard(require("react-native-svg"));
11
+ var _store = require("../store.js");
12
+ var _jsxRuntime = require("react/jsx-runtime");
13
+ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
14
+ const AnimatedSvg = _reactNativeReanimated.default.createAnimatedComponent(_reactNativeSvg.default);
15
+ const DEFAULT_THEME = {
16
+ backdropColor: '#000000',
17
+ backdropOpacity: 0.75,
18
+ spotlightBorderRadius: 8,
19
+ spotlightPadding: 8
20
+ };
21
+ function GuidonOverlay({
22
+ theme = {},
23
+ animationDuration = 300,
24
+ onBackdropPress
25
+ }) {
26
+ const isActive = (0, _store.useGuidonStore)(state => state.isActive);
27
+ const config = (0, _store.useGuidonStore)(state => state.config);
28
+ const currentStepIndex = (0, _store.useGuidonStore)(state => state.currentStepIndex);
29
+ const targetMeasurements = (0, _store.useGuidonStore)(state => state.targetMeasurements);
30
+
31
+ // Check for floating or waiting states
32
+ const isFloatingStep = (0, _store.useIsFloatingStep)();
33
+ const waitingState = (0, _store.useWaitingState)();
34
+ const isWaiting = waitingState?.isWaiting ?? false;
35
+ const mergedTheme = {
36
+ ...DEFAULT_THEME,
37
+ ...theme
38
+ };
39
+ const {
40
+ width: screenWidth,
41
+ height: screenHeight
42
+ } = _reactNative.Dimensions.get('window');
43
+
44
+ // Get current step's target measurements
45
+ const currentStep = config?.steps[currentStepIndex];
46
+ const currentTargetId = currentStep?.targetId;
47
+ const measurements = currentTargetId ? targetMeasurements[currentTargetId] : undefined;
48
+
49
+ // Determine if we should show full backdrop (no spotlight cutout)
50
+ const showFullBackdrop = isFloatingStep || isWaiting;
51
+
52
+ // Calculate spotlight dimensions with padding
53
+ const spotlight = (0, _react.useMemo)(() => {
54
+ if (!measurements) {
55
+ return {
56
+ x: 0,
57
+ y: 0,
58
+ width: 0,
59
+ height: 0
60
+ };
61
+ }
62
+ return {
63
+ x: measurements.x - mergedTheme.spotlightPadding,
64
+ y: measurements.y - mergedTheme.spotlightPadding,
65
+ width: measurements.width + mergedTheme.spotlightPadding * 2,
66
+ height: measurements.height + mergedTheme.spotlightPadding * 2
67
+ };
68
+ }, [measurements, mergedTheme.spotlightPadding]);
69
+
70
+ // Animated styles for fade in/out
71
+ // Show backdrop for: normal steps with measurements, floating steps, or waiting states
72
+ const shouldShow = isActive && (measurements || showFullBackdrop);
73
+ const animatedStyle = (0, _reactNativeReanimated.useAnimatedStyle)(() => {
74
+ return {
75
+ opacity: (0, _reactNativeReanimated.withTiming)(shouldShow ? 1 : 0, {
76
+ duration: animationDuration,
77
+ easing: _reactNativeReanimated.Easing.inOut(_reactNativeReanimated.Easing.ease)
78
+ })
79
+ };
80
+ }, [shouldShow, animationDuration]);
81
+ if (!isActive) {
82
+ return null;
83
+ }
84
+
85
+ // Render full backdrop without spotlight for floating steps or waiting states
86
+ if (showFullBackdrop) {
87
+ if (_reactNative.Platform.OS === 'web') {
88
+ return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableWithoutFeedback, {
89
+ onPress: onBackdropPress,
90
+ children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeReanimated.default.View, {
91
+ style: [styles.container, animatedStyle],
92
+ children: /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
93
+ style: {
94
+ position: 'absolute',
95
+ inset: 0,
96
+ backgroundColor: mergedTheme.backdropColor,
97
+ opacity: mergedTheme.backdropOpacity
98
+ }
99
+ })
100
+ })
101
+ });
102
+ }
103
+
104
+ // Native: full backdrop without cutout
105
+ return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableWithoutFeedback, {
106
+ onPress: onBackdropPress,
107
+ children: /*#__PURE__*/(0, _jsxRuntime.jsx)(AnimatedSvg, {
108
+ style: [styles.container, animatedStyle],
109
+ width: screenWidth,
110
+ height: screenHeight,
111
+ viewBox: `0 0 ${screenWidth} ${screenHeight}`,
112
+ children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Rect, {
113
+ x: "0",
114
+ y: "0",
115
+ width: "100%",
116
+ height: "100%",
117
+ fill: mergedTheme.backdropColor,
118
+ fillOpacity: mergedTheme.backdropOpacity
119
+ })
120
+ })
121
+ });
122
+ }
123
+
124
+ // If we have a target but no measurements yet, don't render anything
125
+ if (!measurements) {
126
+ return null;
127
+ }
128
+
129
+ // For web, use a different approach with CSS
130
+ if (_reactNative.Platform.OS === 'web') {
131
+ return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableWithoutFeedback, {
132
+ onPress: onBackdropPress,
133
+ children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeReanimated.default.View, {
134
+ style: [styles.container, animatedStyle],
135
+ children: /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
136
+ style: {
137
+ position: 'absolute',
138
+ inset: 0,
139
+ backgroundColor: mergedTheme.backdropColor,
140
+ opacity: mergedTheme.backdropOpacity,
141
+ clipPath: `polygon(
142
+ 0% 0%,
143
+ 0% 100%,
144
+ ${spotlight.x}px 100%,
145
+ ${spotlight.x}px ${spotlight.y}px,
146
+ ${spotlight.x + spotlight.width}px ${spotlight.y}px,
147
+ ${spotlight.x + spotlight.width}px ${spotlight.y + spotlight.height}px,
148
+ ${spotlight.x}px ${spotlight.y + spotlight.height}px,
149
+ ${spotlight.x}px 100%,
150
+ 100% 100%,
151
+ 100% 0%
152
+ )`
153
+ }
154
+ })
155
+ })
156
+ });
157
+ }
158
+
159
+ // Native implementation using SVG mask
160
+ return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableWithoutFeedback, {
161
+ onPress: onBackdropPress,
162
+ children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(AnimatedSvg, {
163
+ style: [styles.container, animatedStyle],
164
+ width: screenWidth,
165
+ height: screenHeight,
166
+ viewBox: `0 0 ${screenWidth} ${screenHeight}`,
167
+ children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Defs, {
168
+ children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNativeSvg.Mask, {
169
+ id: "spotlight-mask",
170
+ children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Rect, {
171
+ x: "0",
172
+ y: "0",
173
+ width: "100%",
174
+ height: "100%",
175
+ fill: "white"
176
+ }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Rect, {
177
+ x: spotlight.x,
178
+ y: spotlight.y,
179
+ width: spotlight.width,
180
+ height: spotlight.height,
181
+ rx: mergedTheme.spotlightBorderRadius,
182
+ ry: mergedTheme.spotlightBorderRadius,
183
+ fill: "black"
184
+ })]
185
+ })
186
+ }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.G, {
187
+ mask: "url(#spotlight-mask)",
188
+ children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Rect, {
189
+ x: "0",
190
+ y: "0",
191
+ width: "100%",
192
+ height: "100%",
193
+ fill: mergedTheme.backdropColor,
194
+ fillOpacity: mergedTheme.backdropOpacity
195
+ })
196
+ })]
197
+ })
198
+ });
199
+ }
200
+ const styles = _reactNative.StyleSheet.create({
201
+ container: {
202
+ ..._reactNative.StyleSheet.absoluteFillObject,
203
+ zIndex: 999
204
+ }
205
+ });
206
+ //# sourceMappingURL=GuidonOverlay.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"names":["_react","require","_reactNative","_reactNativeReanimated","_interopRequireWildcard","_reactNativeSvg","_store","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","AnimatedSvg","Animated","createAnimatedComponent","Svg","DEFAULT_THEME","backdropColor","backdropOpacity","spotlightBorderRadius","spotlightPadding","GuidonOverlay","theme","animationDuration","onBackdropPress","isActive","useGuidonStore","state","config","currentStepIndex","targetMeasurements","isFloatingStep","useIsFloatingStep","waitingState","useWaitingState","isWaiting","mergedTheme","width","screenWidth","height","screenHeight","Dimensions","currentStep","steps","currentTargetId","targetId","measurements","undefined","showFullBackdrop","spotlight","useMemo","x","y","shouldShow","animatedStyle","useAnimatedStyle","opacity","withTiming","duration","easing","Easing","inOut","ease","Platform","OS","jsx","TouchableWithoutFeedback","onPress","children","View","style","styles","container","position","inset","backgroundColor","viewBox","Rect","fill","fillOpacity","clipPath","jsxs","Defs","Mask","id","rx","ry","G","mask","StyleSheet","create","absoluteFillObject","zIndex"],"sourceRoot":"../../../src","sources":["components/GuidonOverlay.tsx"],"mappings":"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","ignoreList":[]}
@@ -0,0 +1,157 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.GuidonProvider = GuidonProvider;
7
+ exports.useGuidonContext = useGuidonContext;
8
+ var _react = require("react");
9
+ var _store = require("../store.js");
10
+ var _hooks = require("../persistence/hooks.js");
11
+ var _GuidonOverlay = require("./GuidonOverlay.js");
12
+ var _GuidonTooltip = require("./GuidonTooltip.js");
13
+ var _jsxRuntime = require("react/jsx-runtime");
14
+ const GuidonContext = /*#__PURE__*/(0, _react.createContext)(null);
15
+ function useGuidonContext() {
16
+ const context = (0, _react.useContext)(GuidonContext);
17
+ if (!context) {
18
+ throw new Error('useGuidonContext must be used within a GuidonProvider');
19
+ }
20
+ return context;
21
+ }
22
+ function GuidonProvider({
23
+ children,
24
+ config,
25
+ autoStart = true,
26
+ shouldStart,
27
+ persistenceAdapter,
28
+ portalComponent: Portal,
29
+ renderTooltip,
30
+ tooltipLabels,
31
+ onBackdropPress
32
+ }) {
33
+ const hasInitialized = (0, _react.useRef)(false);
34
+ const isActive = (0, _store.useGuidonStore)(state => state.isActive);
35
+ const storeIsCompleted = (0, _store.useGuidonStore)(state => state.isCompleted);
36
+ const currentStepIndex = (0, _store.useGuidonStore)(state => state.currentStepIndex);
37
+ const configure = (0, _store.useGuidonStore)(state => state.configure);
38
+ const start = (0, _store.useGuidonStore)(state => state.start);
39
+ const next = (0, _store.useGuidonStore)(state => state.next);
40
+ const skip = (0, _store.useGuidonStore)(state => state.skip);
41
+ const reset = (0, _store.useGuidonStore)(state => state.reset);
42
+
43
+ // Check for waiting state (target element not mounted)
44
+ const waitingState = (0, _store.useWaitingState)();
45
+ const {
46
+ isLoading,
47
+ isCompleted: persistedCompleted,
48
+ markCompleted,
49
+ markStepViewed,
50
+ clearProgress
51
+ } = (0, _hooks.useGuidonPersistence)(persistenceAdapter, config.id);
52
+ const isCompleted = storeIsCompleted || persistedCompleted;
53
+ (0, _react.useEffect)(() => {
54
+ const enhancedConfig = {
55
+ ...config,
56
+ onComplete: async () => {
57
+ config.onComplete?.();
58
+ if (persistenceAdapter) {
59
+ await markCompleted();
60
+ }
61
+ },
62
+ onSkip: async () => {
63
+ config.onSkip?.();
64
+ if (persistenceAdapter) {
65
+ await markStepViewed(currentStepIndex);
66
+ }
67
+ },
68
+ onStepChange: async (stepIndex, step) => {
69
+ config.onStepChange?.(stepIndex, step);
70
+ if (persistenceAdapter) {
71
+ await markStepViewed(stepIndex);
72
+ }
73
+ }
74
+ };
75
+ configure(enhancedConfig);
76
+ }, [config, configure, persistenceAdapter, markCompleted, markStepViewed, currentStepIndex]);
77
+ (0, _react.useEffect)(() => {
78
+ if (!autoStart || hasInitialized.current || isLoading) return;
79
+ const checkAndStart = async () => {
80
+ hasInitialized.current = true;
81
+ if (persistedCompleted) return;
82
+ if (shouldStart) {
83
+ const should = await shouldStart();
84
+ if (!should) return;
85
+ }
86
+ setTimeout(() => {
87
+ start();
88
+ }, 500);
89
+ };
90
+ checkAndStart();
91
+ }, [autoStart, isLoading, persistedCompleted, shouldStart, start]);
92
+
93
+ // Handle wait timeout - auto-skip to next step if waiting too long
94
+ (0, _react.useEffect)(() => {
95
+ const currentStep = config.steps[currentStepIndex];
96
+ const waitTimeout = currentStep?.waitTimeout;
97
+
98
+ // Only set timeout if:
99
+ // - We have a timeout configured
100
+ // - The timeout is greater than 0
101
+ // - We are currently waiting for a target
102
+ if (!waitTimeout || waitTimeout <= 0 || !waitingState?.isWaiting) {
103
+ return;
104
+ }
105
+ const timer = setTimeout(() => {
106
+ // Check if we're still waiting when the timeout fires
107
+ const stillWaiting = _store.useGuidonStore.getState().targetMeasurements[currentStep.targetId] === undefined;
108
+ if (stillWaiting) {
109
+ next(); // Skip to next step
110
+ }
111
+ }, waitTimeout);
112
+ return () => clearTimeout(timer);
113
+ }, [currentStepIndex, config.steps, waitingState?.isWaiting, next]);
114
+ const replay = (0, _react.useCallback)(async () => {
115
+ if (persistenceAdapter) {
116
+ await clearProgress();
117
+ }
118
+ reset();
119
+ hasInitialized.current = false;
120
+ setTimeout(() => {
121
+ start();
122
+ }, 100);
123
+ }, [persistenceAdapter, clearProgress, reset, start]);
124
+ const manualStart = (0, _react.useCallback)(() => {
125
+ if (!isActive && !isLoading) {
126
+ start();
127
+ }
128
+ }, [isActive, isLoading, start]);
129
+ const contextValue = {
130
+ start: manualStart,
131
+ skip,
132
+ reset,
133
+ replay,
134
+ isActive,
135
+ isCompleted,
136
+ isLoading
137
+ };
138
+ const overlayContent = /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
139
+ children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_GuidonOverlay.GuidonOverlay, {
140
+ theme: config.theme,
141
+ animationDuration: config.animationDuration,
142
+ onBackdropPress: onBackdropPress
143
+ }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_GuidonTooltip.GuidonTooltip, {
144
+ theme: config.theme,
145
+ animationDuration: config.animationDuration,
146
+ renderCustomTooltip: renderTooltip,
147
+ labels: tooltipLabels
148
+ })]
149
+ });
150
+ return /*#__PURE__*/(0, _jsxRuntime.jsxs)(GuidonContext.Provider, {
151
+ value: contextValue,
152
+ children: [children, Portal ? /*#__PURE__*/(0, _jsxRuntime.jsx)(Portal, {
153
+ children: overlayContent
154
+ }) : overlayContent]
155
+ });
156
+ }
157
+ //# sourceMappingURL=GuidonProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"names":["_react","require","_store","_hooks","_GuidonOverlay","_GuidonTooltip","_jsxRuntime","GuidonContext","createContext","useGuidonContext","context","useContext","Error","GuidonProvider","children","config","autoStart","shouldStart","persistenceAdapter","portalComponent","Portal","renderTooltip","tooltipLabels","onBackdropPress","hasInitialized","useRef","isActive","useGuidonStore","state","storeIsCompleted","isCompleted","currentStepIndex","configure","start","next","skip","reset","waitingState","useWaitingState","isLoading","persistedCompleted","markCompleted","markStepViewed","clearProgress","useGuidonPersistence","id","useEffect","enhancedConfig","onComplete","onSkip","onStepChange","stepIndex","step","current","checkAndStart","should","setTimeout","currentStep","steps","waitTimeout","isWaiting","timer","stillWaiting","getState","targetMeasurements","targetId","undefined","clearTimeout","replay","useCallback","manualStart","contextValue","overlayContent","jsxs","Fragment","jsx","GuidonOverlay","theme","animationDuration","GuidonTooltip","renderCustomTooltip","labels","Provider","value"],"sourceRoot":"../../../src","sources":["components/GuidonProvider.tsx"],"mappings":"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","ignoreList":[]}
@@ -0,0 +1,110 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.GuidonTarget = GuidonTarget;
7
+ var _react = require("react");
8
+ var _reactNative = require("react-native");
9
+ var _store = require("../store.js");
10
+ var _jsxRuntime = require("react/jsx-runtime");
11
+ /**
12
+ * Wrapper component that marks an element as a walkthrough target
13
+ * Automatically measures and reports its position to the walkthrough store
14
+ */
15
+ function GuidonTarget({
16
+ children,
17
+ targetId,
18
+ active = true
19
+ }) {
20
+ const viewRef = (0, _react.useRef)(null);
21
+ const registerTarget = (0, _store.useGuidonStore)(state => state.registerTarget);
22
+ const unregisterTarget = (0, _store.useGuidonStore)(state => state.unregisterTarget);
23
+ const isActive = (0, _store.useGuidonStore)(state => state.isActive);
24
+ const config = (0, _store.useGuidonStore)(state => state.config);
25
+
26
+ // Check if this target is needed for the current walkthrough
27
+ const isTargetNeeded = isActive && config?.steps.some(step => step.targetId === targetId);
28
+ const measureElement = (0, _react.useCallback)(() => {
29
+ if (!viewRef.current || !active || !isTargetNeeded) return;
30
+ if (_reactNative.Platform.OS === "web") {
31
+ // Web measurement using getBoundingClientRect
32
+ const element = viewRef.current;
33
+ if (element && typeof element.getBoundingClientRect === "function") {
34
+ const rect = element.getBoundingClientRect();
35
+ const measurements = {
36
+ x: rect.left + window.scrollX,
37
+ y: rect.top + window.scrollY,
38
+ width: rect.width,
39
+ height: rect.height
40
+ };
41
+ registerTarget(targetId, measurements);
42
+ }
43
+ } else {
44
+ // Native measurement using measureInWindow
45
+ // Cast to access the native measureInWindow method
46
+ const nativeRef = viewRef.current;
47
+ nativeRef.measureInWindow((x, y, width, height) => {
48
+ if (width > 0 && height > 0) {
49
+ const measurements = {
50
+ x,
51
+ y,
52
+ width,
53
+ height
54
+ };
55
+ registerTarget(targetId, measurements);
56
+ }
57
+ });
58
+ }
59
+ }, [targetId, active, isTargetNeeded, registerTarget]);
60
+
61
+ // Measure on layout change
62
+ const handleLayout = (0, _react.useCallback)(_event => {
63
+ // Small delay to ensure layout is complete
64
+ requestAnimationFrame(() => {
65
+ measureElement();
66
+ });
67
+ }, [measureElement]);
68
+
69
+ // Re-measure when walkthrough becomes active or when this target becomes relevant
70
+ (0, _react.useEffect)(() => {
71
+ if (!isTargetNeeded) return;
72
+
73
+ // Delay to ensure the element is rendered
74
+ const timer = setTimeout(() => {
75
+ measureElement();
76
+ }, 100);
77
+ return () => clearTimeout(timer);
78
+ }, [isTargetNeeded, measureElement]);
79
+
80
+ // Re-measure on scroll (web only)
81
+ (0, _react.useEffect)(() => {
82
+ if (_reactNative.Platform.OS !== "web" || !isTargetNeeded) return;
83
+ const handleScroll = () => {
84
+ measureElement();
85
+ };
86
+ window.addEventListener("scroll", handleScroll, true);
87
+ window.addEventListener("resize", handleScroll);
88
+ return () => {
89
+ window.removeEventListener("scroll", handleScroll, true);
90
+ window.removeEventListener("resize", handleScroll);
91
+ };
92
+ }, [isTargetNeeded, measureElement]);
93
+
94
+ // Unregister on unmount
95
+ (0, _react.useEffect)(() => {
96
+ return () => {
97
+ unregisterTarget(targetId);
98
+ };
99
+ }, [targetId, unregisterTarget]);
100
+ return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
101
+ ref: viewRef,
102
+ onLayout: handleLayout,
103
+ collapsable: false,
104
+ style: {
105
+ alignSelf: "flex-start"
106
+ },
107
+ children: children
108
+ });
109
+ }
110
+ //# sourceMappingURL=GuidonTarget.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"names":["_react","require","_reactNative","_store","_jsxRuntime","GuidonTarget","children","targetId","active","viewRef","useRef","registerTarget","useGuidonStore","state","unregisterTarget","isActive","config","isTargetNeeded","steps","some","step","measureElement","useCallback","current","Platform","OS","element","getBoundingClientRect","rect","measurements","x","left","window","scrollX","y","top","scrollY","width","height","nativeRef","measureInWindow","handleLayout","_event","requestAnimationFrame","useEffect","timer","setTimeout","clearTimeout","handleScroll","addEventListener","removeEventListener","jsx","View","ref","onLayout","collapsable","style","alignSelf"],"sourceRoot":"../../../src","sources":["components/GuidonTarget.tsx"],"mappings":"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","ignoreList":[]}