@korsolutions/guidon 1.0.7 → 1.0.8
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.
- package/dist/commonjs/hooks/index.js +0 -6
- package/dist/commonjs/hooks/index.js.map +1 -1
- package/dist/commonjs/hooks/useGuidonRef.js +4 -106
- package/dist/commonjs/hooks/useGuidonRef.js.map +1 -1
- package/dist/commonjs/index.js +0 -6
- package/dist/commonjs/index.js.map +1 -1
- package/dist/commonjs/store.js +3 -1
- package/dist/commonjs/store.js.map +1 -1
- package/dist/module/hooks/index.js +1 -1
- package/dist/module/hooks/index.js.map +1 -1
- package/dist/module/hooks/useGuidonRef.js +4 -105
- package/dist/module/hooks/useGuidonRef.js.map +1 -1
- package/dist/module/index.js +1 -1
- package/dist/module/index.js.map +1 -1
- package/dist/module/store.js +3 -1
- package/dist/module/store.js.map +1 -1
- package/dist/typescript/commonjs/hooks/index.d.ts +1 -1
- package/dist/typescript/commonjs/hooks/index.d.ts.map +1 -1
- package/dist/typescript/commonjs/hooks/useGuidonRef.d.ts +4 -14
- package/dist/typescript/commonjs/hooks/useGuidonRef.d.ts.map +1 -1
- package/dist/typescript/commonjs/index.d.ts +1 -1
- package/dist/typescript/commonjs/index.d.ts.map +1 -1
- package/dist/typescript/module/hooks/index.d.ts +1 -1
- package/dist/typescript/module/hooks/index.d.ts.map +1 -1
- package/dist/typescript/module/hooks/useGuidonRef.d.ts +4 -14
- package/dist/typescript/module/hooks/useGuidonRef.d.ts.map +1 -1
- package/dist/typescript/module/index.d.ts +1 -1
- package/dist/typescript/module/index.d.ts.map +1 -1
- package/package.json +1 -1
- package/src/hooks/index.ts +1 -1
- package/src/hooks/useGuidonRef.ts +6 -129
- package/src/index.ts +1 -1
- package/src/store.ts +1 -1
|
@@ -9,11 +9,5 @@ Object.defineProperty(exports, "useGuidon", {
|
|
|
9
9
|
return _useGuidonRef.useGuidon;
|
|
10
10
|
}
|
|
11
11
|
});
|
|
12
|
-
Object.defineProperty(exports, "useGuidonRef", {
|
|
13
|
-
enumerable: true,
|
|
14
|
-
get: function () {
|
|
15
|
-
return _useGuidonRef.useGuidonRef;
|
|
16
|
-
}
|
|
17
|
-
});
|
|
18
12
|
var _useGuidonRef = require("./useGuidonRef.js");
|
|
19
13
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["_useGuidonRef","require"],"sourceRoot":"../../../src","sources":["hooks/index.ts"],"mappings":"
|
|
1
|
+
{"version":3,"names":["_useGuidonRef","require"],"sourceRoot":"../../../src","sources":["hooks/index.ts"],"mappings":";;;;;;;;;;;AAAA,IAAAA,aAAA,GAAAC,OAAA","ignoreList":[]}
|
|
@@ -4,7 +4,6 @@ Object.defineProperty(exports, "__esModule", {
|
|
|
4
4
|
value: true
|
|
5
5
|
});
|
|
6
6
|
exports.useGuidon = useGuidon;
|
|
7
|
-
exports.useGuidonRef = useGuidonRef;
|
|
8
7
|
exports.useGuidonRegister = useGuidonRegister;
|
|
9
8
|
var _react = require("react");
|
|
10
9
|
var _reactNative = require("react-native");
|
|
@@ -15,122 +14,21 @@ var _store = require("../store.js");
|
|
|
15
14
|
*/
|
|
16
15
|
|
|
17
16
|
/**
|
|
18
|
-
* Hook that returns a
|
|
17
|
+
* Hook that returns a function to attach to an element for guidon targeting.
|
|
19
18
|
* Alternative to the GuidonTarget wrapper component.
|
|
20
19
|
*
|
|
21
20
|
* @param targetId - The target ID that matches a step's targetId
|
|
22
|
-
* @returns A
|
|
21
|
+
* @returns A function that will register the target element
|
|
23
22
|
*
|
|
24
23
|
* @example
|
|
25
24
|
* ```tsx
|
|
26
25
|
* function MyComponent() {
|
|
27
|
-
* const
|
|
28
|
-
* return <Button ref={
|
|
29
|
-
* }
|
|
30
|
-
* ```
|
|
31
|
-
*
|
|
32
|
-
* @example Web usage
|
|
33
|
-
* ```tsx
|
|
34
|
-
* function MyComponent() {
|
|
35
|
-
* const divRef = useGuidonRef<HTMLDivElement>('my-div');
|
|
36
|
-
* return <div ref={divRef}>Highlight me</div>;
|
|
26
|
+
* const {register} = useGuidon();
|
|
27
|
+
* return <Button ref={register('my-button')}>Click me</Button>;
|
|
37
28
|
* }
|
|
38
29
|
* ```
|
|
39
30
|
*/
|
|
40
|
-
function useGuidonRef(targetId) {
|
|
41
|
-
const ref = (0, _react.useRef)(null);
|
|
42
|
-
const measurementFrameRef = (0, _react.useRef)(null);
|
|
43
|
-
const registerTarget = (0, _store.useGuidonStore)(state => state.registerTarget);
|
|
44
|
-
const unregisterTarget = (0, _store.useGuidonStore)(state => state.unregisterTarget);
|
|
45
|
-
const isActive = (0, _store.useGuidonStore)(state => state.isActive);
|
|
46
|
-
const config = (0, _store.useGuidonStore)(state => state.config);
|
|
47
|
-
const currentStepIndex = (0, _store.useGuidonStore)(state => state.currentStepIndex);
|
|
48
|
-
|
|
49
|
-
// Check if this target is needed anywhere in the walkthrough
|
|
50
|
-
const isTargetNeeded = isActive && config?.steps.some(step => step.targetId === targetId);
|
|
51
|
-
|
|
52
|
-
// Check if this specific target is needed for the current step
|
|
53
|
-
const isCurrentTarget = config?.steps[currentStepIndex]?.targetId === targetId;
|
|
54
|
-
const measureElement = (0, _react.useCallback)(() => {
|
|
55
|
-
if (!ref.current || !isTargetNeeded) return;
|
|
56
|
-
if (_reactNative.Platform.OS === "web") {
|
|
57
|
-
// Web measurement using getBoundingClientRect
|
|
58
|
-
const element = ref.current;
|
|
59
|
-
if (element && typeof element.getBoundingClientRect === "function") {
|
|
60
|
-
const rect = element.getBoundingClientRect();
|
|
61
|
-
const measurements = {
|
|
62
|
-
x: rect.left + window.scrollX,
|
|
63
|
-
y: rect.top + window.scrollY,
|
|
64
|
-
width: rect.width,
|
|
65
|
-
height: rect.height
|
|
66
|
-
};
|
|
67
|
-
registerTarget(targetId, measurements);
|
|
68
|
-
}
|
|
69
|
-
} else {
|
|
70
|
-
// Native measurement using measureInWindow
|
|
71
|
-
const nativeRef = ref.current;
|
|
72
|
-
if (nativeRef && typeof nativeRef.measureInWindow === "function") {
|
|
73
|
-
nativeRef.measureInWindow((x, y, width, height) => {
|
|
74
|
-
if (width > 0 && height > 0) {
|
|
75
|
-
const measurements = {
|
|
76
|
-
x,
|
|
77
|
-
y,
|
|
78
|
-
width,
|
|
79
|
-
height
|
|
80
|
-
};
|
|
81
|
-
registerTarget(targetId, measurements);
|
|
82
|
-
}
|
|
83
|
-
});
|
|
84
|
-
}
|
|
85
|
-
}
|
|
86
|
-
}, [targetId, isTargetNeeded, registerTarget]);
|
|
87
|
-
|
|
88
|
-
// Measure when guidon becomes active or when this target becomes relevant
|
|
89
|
-
(0, _react.useEffect)(() => {
|
|
90
|
-
if (!isTargetNeeded) return;
|
|
91
|
-
|
|
92
|
-
// Use requestAnimationFrame to ensure layout is complete
|
|
93
|
-
measurementFrameRef.current = requestAnimationFrame(() => {
|
|
94
|
-
measureElement();
|
|
95
|
-
});
|
|
96
|
-
return () => {
|
|
97
|
-
if (measurementFrameRef.current) {
|
|
98
|
-
cancelAnimationFrame(measurementFrameRef.current);
|
|
99
|
-
}
|
|
100
|
-
};
|
|
101
|
-
}, [isTargetNeeded, measureElement]);
|
|
102
|
-
|
|
103
|
-
// Re-measure when this target becomes the current step
|
|
104
|
-
(0, _react.useEffect)(() => {
|
|
105
|
-
if (!isCurrentTarget) return;
|
|
106
|
-
const timer = setTimeout(() => {
|
|
107
|
-
measureElement();
|
|
108
|
-
}, 50);
|
|
109
|
-
return () => clearTimeout(timer);
|
|
110
|
-
}, [isCurrentTarget, measureElement]);
|
|
111
|
-
|
|
112
|
-
// Web: handle scroll and resize
|
|
113
|
-
(0, _react.useEffect)(() => {
|
|
114
|
-
if (_reactNative.Platform.OS !== "web" || !isTargetNeeded) return;
|
|
115
|
-
const handleScrollOrResize = () => {
|
|
116
|
-
measureElement();
|
|
117
|
-
};
|
|
118
|
-
window.addEventListener("scroll", handleScrollOrResize, true);
|
|
119
|
-
window.addEventListener("resize", handleScrollOrResize);
|
|
120
|
-
return () => {
|
|
121
|
-
window.removeEventListener("scroll", handleScrollOrResize, true);
|
|
122
|
-
window.removeEventListener("resize", handleScrollOrResize);
|
|
123
|
-
};
|
|
124
|
-
}, [isTargetNeeded, measureElement]);
|
|
125
31
|
|
|
126
|
-
// Unregister on unmount
|
|
127
|
-
(0, _react.useEffect)(() => {
|
|
128
|
-
return () => {
|
|
129
|
-
unregisterTarget(targetId);
|
|
130
|
-
};
|
|
131
|
-
}, [targetId, unregisterTarget]);
|
|
132
|
-
return ref;
|
|
133
|
-
}
|
|
134
32
|
function useGuidon() {
|
|
135
33
|
const register = useGuidonRegister();
|
|
136
34
|
return {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["_react","require","_reactNative","_store","
|
|
1
|
+
{"version":3,"names":["_react","require","_reactNative","_store","useGuidon","register","useGuidonRegister","elementsRef","useRef","Map","rafRef","registerTarget","useGuidonStore","state","unregisterTarget","isActive","config","currentStepIndex","measure","useCallback","targetId","node","isTargetUsed","steps","some","step","Platform","OS","el","getBoundingClientRect","rect","style","window","getComputedStyle","paddingLeft","parseFloat","paddingRight","paddingTop","paddingBottom","borderLeft","borderLeftWidth","borderRight","borderRightWidth","borderTop","borderTopWidth","borderBottom","borderBottomWidth","x","left","scrollX","y","top","scrollY","width","height","native","measureInWindow","current","set","raf","requestAnimationFrame","delete","get","cancelAnimationFrame","useEffect","handler","forEach","id","addEventListener","removeEventListener"],"sourceRoot":"../../../src","sources":["hooks/useGuidonRef.ts"],"mappings":"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","ignoreList":[]}
|
package/dist/commonjs/index.js
CHANGED
|
@@ -99,12 +99,6 @@ Object.defineProperty(exports, "useGuidonProgress", {
|
|
|
99
99
|
return _store.useGuidonProgress;
|
|
100
100
|
}
|
|
101
101
|
});
|
|
102
|
-
Object.defineProperty(exports, "useGuidonRef", {
|
|
103
|
-
enumerable: true,
|
|
104
|
-
get: function () {
|
|
105
|
-
return _index2.useGuidonRef;
|
|
106
|
-
}
|
|
107
|
-
});
|
|
108
102
|
Object.defineProperty(exports, "useGuidonStep", {
|
|
109
103
|
enumerable: true,
|
|
110
104
|
get: function () {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["_index","require","_index2","_store","_adapters","_hooks"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"
|
|
1
|
+
{"version":3,"names":["_index","require","_index2","_store","_adapters","_hooks"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,IAAAA,MAAA,GAAAC,OAAA;AASA,IAAAC,OAAA,GAAAD,OAAA;AAGA,IAAAE,MAAA,GAAAF,OAAA;AA+BA,IAAAG,SAAA,GAAAH,OAAA;AASA,IAAAI,MAAA,GAAAJ,OAAA","ignoreList":[]}
|
package/dist/commonjs/store.js
CHANGED
|
@@ -76,7 +76,9 @@ const useGuidonStore = exports.useGuidonStore = (0, _zustand.create)((set, get)
|
|
|
76
76
|
const nextStep = config.steps[nextIndex];
|
|
77
77
|
console.log("[Guidon] advancing to step", nextIndex, nextStep?.id ?? "undefined");
|
|
78
78
|
set({
|
|
79
|
-
|
|
79
|
+
config,
|
|
80
|
+
currentStepIndex: nextIndex,
|
|
81
|
+
isActive
|
|
80
82
|
});
|
|
81
83
|
nextStep?.onStepEnter?.();
|
|
82
84
|
if (nextStep) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["_zustand","require","_shallow","initialState","config","isActive","currentStepIndex","isCompleted","targetMeasurements","isLoading","error","waitingForTarget","waitingTargetId","useGuidonStore","exports","create","set","get","configure","start","console","log","hasConfig","stepCount","steps","length","map","s","id","firstStep","onStepEnter","onStepChange","next","totalSteps","currentStep","onStepExit","nextIndex","nextStep","complete","previous","prevIndex","prevStep","goToStep","index","targetStep","skip","onSkip","onComplete","reset","registerTarget","targetId","measurements","state","unregisterTarget","_","rest","setLoading","setError","Guidon","getState","getCurrentStepIndex","getCurrentStep","getSteps","subscribe","useGuidonActive","useGuidonStep","useGuidonProgress","useShallow","percentage","useTargetMeasurements","useWaitingState","hasMeasurements","isWaiting","message","waitingMessage","useIsFloatingStep"],"sourceRoot":"../../src","sources":["store.ts"],"mappings":"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
|
|
1
|
+
{"version":3,"names":["_zustand","require","_shallow","initialState","config","isActive","currentStepIndex","isCompleted","targetMeasurements","isLoading","error","waitingForTarget","waitingTargetId","useGuidonStore","exports","create","set","get","configure","start","console","log","hasConfig","stepCount","steps","length","map","s","id","firstStep","onStepEnter","onStepChange","next","totalSteps","currentStep","onStepExit","nextIndex","nextStep","complete","previous","prevIndex","prevStep","goToStep","index","targetStep","skip","onSkip","onComplete","reset","registerTarget","targetId","measurements","state","unregisterTarget","_","rest","setLoading","setError","Guidon","getState","getCurrentStepIndex","getCurrentStep","getSteps","subscribe","useGuidonActive","useGuidonStep","useGuidonProgress","useShallow","percentage","useTargetMeasurements","useWaitingState","hasMeasurements","isWaiting","message","waitingMessage","useIsFloatingStep"],"sourceRoot":"../../src","sources":["store.ts"],"mappings":";;;;;;AAAA,IAAAA,QAAA,GAAAC,OAAA;AACA,IAAAC,QAAA,GAAAD,OAAA;AAGA,MAAME,YAAY,GAAG;EACnBC,MAAM,EAAE,IAAI;EACZC,QAAQ,EAAE,KAAK;EACfC,gBAAgB,EAAE,CAAC;EACnBC,WAAW,EAAE,KAAK;EAClBC,kBAAkB,EAAE,CAAC,CAAC;EACtBC,SAAS,EAAE,KAAK;EAChBC,KAAK,EAAE,IAAI;EACXC,gBAAgB,EAAE,KAAK;EACvBC,eAAe,EAAE;AACnB,CAAC;AAEM,MAAMC,cAAc,GAAAC,OAAA,CAAAD,cAAA,GAAG,IAAAE,eAAM,EAAc,CAACC,GAAG,EAAEC,GAAG,MAAM;EAC/D,GAAGd,YAAY;EAEfe,SAAS,EAAGd,MAAoB,IAAK;IACnCY,GAAG,CAAC;MAAEZ,MAAM;MAAEE,gBAAgB,EAAE,CAAC;MAAEC,WAAW,EAAE;IAAM,CAAC,CAAC;EAC1D,CAAC;EAEDY,KAAK,EAAEA,CAAA,KAAM;IACX,MAAM;MAAEf;IAAO,CAAC,GAAGa,GAAG,CAAC,CAAC;IACxBG,OAAO,CAACC,GAAG,CAAC,yBAAyB,EAAE;MACrCC,SAAS,EAAE,CAAC,CAAClB,MAAM;MACnBmB,SAAS,EAAEnB,MAAM,EAAEoB,KAAK,CAACC,MAAM,IAAI;IACrC,CAAC,CAAC;IAEF,IAAI,CAACrB,MAAM,IAAIA,MAAM,CAACoB,KAAK,CAACC,MAAM,KAAK,CAAC,EAAE;MACxCL,OAAO,CAACC,GAAG,CAAC,uDAAuD,CAAC;MACpE;IACF;IAEAD,OAAO,CAACC,GAAG,CACT,2CAA2C,EAC3CjB,MAAM,CAACoB,KAAK,CAACE,GAAG,CAAEC,CAAC,IAAKA,CAAC,CAACC,EAAE,CAC9B,CAAC;IACDZ,GAAG,CAAC;MAAEX,QAAQ,EAAE,IAAI;MAAEC,gBAAgB,EAAE,CAAC;MAAEC,WAAW,EAAE;IAAM,CAAC,CAAC;;IAEhE;IACA,MAAMsB,SAAS,GAAGzB,MAAM,CAACoB,KAAK,CAAC,CAAC,CAAC;IACjCK,SAAS,EAAEC,WAAW,GAAG,CAAC;IAC1B,IAAID,SAAS,EAAE;MACbzB,MAAM,CAAC2B,YAAY,GAAG,CAAC,EAAEF,SAAS,CAAC;IACrC;EACF,CAAC;EAEDG,IAAI,EAAEA,CAAA,KAAM;IACV,MAAM;MAAE5B,MAAM;MAAEE,gBAAgB;MAAED;IAAS,CAAC,GAAGY,GAAG,CAAC,CAAC;IACpDG,OAAO,CAACC,GAAG,CAAC,wBAAwB,EAAE;MACpCC,SAAS,EAAE,CAAC,CAAClB,MAAM;MACnBE,gBAAgB;MAChBD,QAAQ;MACR4B,UAAU,EAAE7B,MAAM,EAAEoB,KAAK,CAACC,MAAM,IAAI;IACtC,CAAC,CAAC;IAEF,IAAI,CAACrB,MAAM,IAAI,CAACC,QAAQ,EAAE;MACxBe,OAAO,CAACC,GAAG,CAAC,4DAA4D,CAAC;MACzE;IACF;IAEA,MAAMa,WAAW,GAAG9B,MAAM,CAACoB,KAAK,CAAClB,gBAAgB,CAAC;IAClDc,OAAO,CAACC,GAAG,CAAC,wBAAwB,EAAEa,WAAW,EAAEN,EAAE,IAAI,WAAW,CAAC;IACrEM,WAAW,EAAEC,UAAU,GAAG,CAAC;IAE3B,IAAI7B,gBAAgB,GAAGF,MAAM,CAACoB,KAAK,CAACC,MAAM,GAAG,CAAC,EAAE;MAC9C,MAAMW,SAAS,GAAG9B,gBAAgB,GAAG,CAAC;MACtC,MAAM+B,QAAQ,GAAGjC,MAAM,CAACoB,KAAK,CAACY,SAAS,CAAC;MAExChB,OAAO,CAACC,GAAG,CACT,4BAA4B,EAC5Be,SAAS,EACTC,QAAQ,EAAET,EAAE,IAAI,WAClB,CAAC;MACDZ,GAAG,CAAC;QAAEZ,MAAM;QAAEE,gBAAgB,EAAE8B,SAAS;QAAE/B;MAAS,CAAC,CAAC;MAEtDgC,QAAQ,EAAEP,WAAW,GAAG,CAAC;MACzB,IAAIO,QAAQ,EAAE;QACZjB,OAAO,CAACC,GAAG,CACT,4BAA4B,EAC5Be,SAAS,EACTC,QAAQ,EAAET,EAAE,IAAI,WAClB,CAAC;QAEDxB,MAAM,CAAC2B,YAAY,GAAGK,SAAS,EAAEC,QAAQ,CAAC;MAC5C;IACF,CAAC,MAAM;MACLjB,OAAO,CAACC,GAAG,CAAC,oDAAoD,CAAC;MACjE;MACAJ,GAAG,CAAC,CAAC,CAACqB,QAAQ,CAAC,CAAC;IAClB;EACF,CAAC;EAEDC,QAAQ,EAAEA,CAAA,KAAM;IACd,MAAM;MAAEnC,MAAM;MAAEE,gBAAgB;MAAED;IAAS,CAAC,GAAGY,GAAG,CAAC,CAAC;IACpD,IAAI,CAACb,MAAM,IAAI,CAACC,QAAQ,IAAIC,gBAAgB,KAAK,CAAC,EAAE;IAEpD,MAAM4B,WAAW,GAAG9B,MAAM,CAACoB,KAAK,CAAClB,gBAAgB,CAAC;IAClD4B,WAAW,EAAEC,UAAU,GAAG,CAAC;IAE3B,MAAMK,SAAS,GAAGlC,gBAAgB,GAAG,CAAC;IACtC,MAAMmC,QAAQ,GAAGrC,MAAM,CAACoB,KAAK,CAACgB,SAAS,CAAC;IAExCxB,GAAG,CAAC;MAAEV,gBAAgB,EAAEkC;IAAU,CAAC,CAAC;IAEpCC,QAAQ,EAAEX,WAAW,GAAG,CAAC;IACzB,IAAIW,QAAQ,EAAE;MACZrC,MAAM,CAAC2B,YAAY,GAAGS,SAAS,EAAEC,QAAQ,CAAC;IAC5C;EACF,CAAC;EAEDC,QAAQ,EAAGC,KAAa,IAAK;IAC3B,MAAM;MAAEvC,MAAM;MAAEE,gBAAgB;MAAED;IAAS,CAAC,GAAGY,GAAG,CAAC,CAAC;IACpD,IAAI,CAACb,MAAM,IAAI,CAACC,QAAQ,EAAE;IAC1B,IAAIsC,KAAK,GAAG,CAAC,IAAIA,KAAK,IAAIvC,MAAM,CAACoB,KAAK,CAACC,MAAM,EAAE;IAE/C,MAAMS,WAAW,GAAG9B,MAAM,CAACoB,KAAK,CAAClB,gBAAgB,CAAC;IAClD4B,WAAW,EAAEC,UAAU,GAAG,CAAC;IAE3B,MAAMS,UAAU,GAAGxC,MAAM,CAACoB,KAAK,CAACmB,KAAK,CAAC;IAEtC3B,GAAG,CAAC;MAAEV,gBAAgB,EAAEqC;IAAM,CAAC,CAAC;IAEhCC,UAAU,EAAEd,WAAW,GAAG,CAAC;IAC3B,IAAIc,UAAU,EAAE;MACdxC,MAAM,CAAC2B,YAAY,GAAGY,KAAK,EAAEC,UAAU,CAAC;IAC1C;EACF,CAAC;EAEDC,IAAI,EAAEA,CAAA,KAAM;IACV,MAAM;MAAEzC,MAAM;MAAEE;IAAiB,CAAC,GAAGW,GAAG,CAAC,CAAC;IAC1C,IAAI,CAACb,MAAM,EAAE;IAEb,MAAM8B,WAAW,GAAG9B,MAAM,CAACoB,KAAK,CAAClB,gBAAgB,CAAC;IAClD4B,WAAW,EAAEC,UAAU,GAAG,CAAC;IAE3BnB,GAAG,CAAC;MAAEX,QAAQ,EAAE,KAAK;MAAEE,WAAW,EAAE;IAAM,CAAC,CAAC;IAC5CH,MAAM,CAAC0C,MAAM,GAAG,CAAC;EACnB,CAAC;EAEDR,QAAQ,EAAEA,CAAA,KAAM;IACd,MAAM;MAAElC,MAAM;MAAEE;IAAiB,CAAC,GAAGW,GAAG,CAAC,CAAC;IAC1C,IAAI,CAACb,MAAM,EAAE;IAEb,MAAM8B,WAAW,GAAG9B,MAAM,CAACoB,KAAK,CAAClB,gBAAgB,CAAC;IAClD4B,WAAW,EAAEC,UAAU,GAAG,CAAC;IAE3BnB,GAAG,CAAC;MAAEX,QAAQ,EAAE,KAAK;MAAEE,WAAW,EAAE;IAAK,CAAC,CAAC;IAC3CH,MAAM,CAAC2C,UAAU,GAAG,CAAC;EACvB,CAAC;EAEDC,KAAK,EAAEA,CAAA,KAAM;IACXhC,GAAG,CAACb,YAAY,CAAC;EACnB,CAAC;EAED8C,cAAc,EAAEA,CAACC,QAAgB,EAAEC,YAAgC,KAAK;IACtE,MAAM;MAAEvC;IAAgB,CAAC,GAAGK,GAAG,CAAC,CAAC;IACjCD,GAAG,CAAEoC,KAAkB,KAAM;MAC3B5C,kBAAkB,EAAE;QAClB,GAAG4C,KAAK,CAAC5C,kBAAkB;QAC3B,CAAC0C,QAAQ,GAAGC;MACd,CAAC;MACD;MACAxC,gBAAgB,EACdC,eAAe,KAAKsC,QAAQ,GAAG,KAAK,GAAGE,KAAK,CAACzC,gBAAgB;MAC/DC,eAAe,EACbA,eAAe,KAAKsC,QAAQ,GAAG,IAAI,GAAGE,KAAK,CAACxC;IAChD,CAAC,CAAC,CAAC;EACL,CAAC;EAEDyC,gBAAgB,EAAGH,QAAgB,IAAK;IACtClC,GAAG,CAAEoC,KAAkB,IAAK;MAC1B,MAAM;QAAE,CAACF,QAAQ,GAAGI,CAAC;QAAE,GAAGC;MAAK,CAAC,GAAGH,KAAK,CAAC5C,kBAAkB;MAC3D,OAAO;QAAEA,kBAAkB,EAAE+C;MAAK,CAAC;IACrC,CAAC,CAAC;EACJ,CAAC;EAEDC,UAAU,EAAG/C,SAAkB,IAAK;IAClCO,GAAG,CAAC;MAAEP;IAAU,CAAC,CAAC;EACpB,CAAC;EAEDgD,QAAQ,EAAG/C,KAAoB,IAAK;IAClCM,GAAG,CAAC;MAAEN;IAAM,CAAC,CAAC;EAChB;AACF,CAAC,CAAC,CAAC;;AAEH;AACA;AACA;AACA;AACO,MAAMgD,MAAM,GAAA5C,OAAA,CAAA4C,MAAA,GAAG;EACpB;AACF;AACA;EACExC,SAAS,EAAGd,MAAoB,IAAK;IACnCS,cAAc,CAAC8C,QAAQ,CAAC,CAAC,CAACzC,SAAS,CAACd,MAAM,CAAC;EAC7C,CAAC;EAED;AACF;AACA;EACEe,KAAK,EAAEA,CAAA,KAAM;IACXN,cAAc,CAAC8C,QAAQ,CAAC,CAAC,CAACxC,KAAK,CAAC,CAAC;EACnC,CAAC;EAED;AACF;AACA;EACEa,IAAI,EAAEA,CAAA,KAAM;IACVnB,cAAc,CAAC8C,QAAQ,CAAC,CAAC,CAAC3B,IAAI,CAAC,CAAC;EAClC,CAAC;EAED;AACF;AACA;EACEO,QAAQ,EAAEA,CAAA,KAAM;IACd1B,cAAc,CAAC8C,QAAQ,CAAC,CAAC,CAACpB,QAAQ,CAAC,CAAC;EACtC,CAAC;EAED;AACF;AACA;EACEG,QAAQ,EAAGC,KAAa,IAAK;IAC3B9B,cAAc,CAAC8C,QAAQ,CAAC,CAAC,CAACjB,QAAQ,CAACC,KAAK,CAAC;EAC3C,CAAC;EAED;AACF;AACA;EACEE,IAAI,EAAEA,CAAA,KAAM;IACVhC,cAAc,CAAC8C,QAAQ,CAAC,CAAC,CAACd,IAAI,CAAC,CAAC;EAClC,CAAC;EAED;AACF;AACA;EACEP,QAAQ,EAAEA,CAAA,KAAM;IACdzB,cAAc,CAAC8C,QAAQ,CAAC,CAAC,CAACrB,QAAQ,CAAC,CAAC;EACtC,CAAC;EAED;AACF;AACA;EACEU,KAAK,EAAEA,CAAA,KAAM;IACXnC,cAAc,CAAC8C,QAAQ,CAAC,CAAC,CAACX,KAAK,CAAC,CAAC;EACnC,CAAC;EAED;AACF;AACA;EACE3C,QAAQ,EAAEA,CAAA,KAAM;IACd,OAAOQ,cAAc,CAAC8C,QAAQ,CAAC,CAAC,CAACtD,QAAQ;EAC3C,CAAC;EAED;AACF;AACA;EACEE,WAAW,EAAEA,CAAA,KAAM;IACjB,OAAOM,cAAc,CAAC8C,QAAQ,CAAC,CAAC,CAACpD,WAAW;EAC9C,CAAC;EAED;AACF;AACA;EACEqD,mBAAmB,EAAEA,CAAA,KAAM;IACzB,OAAO/C,cAAc,CAAC8C,QAAQ,CAAC,CAAC,CAACrD,gBAAgB;EACnD,CAAC;EAED;AACF;AACA;EACEuD,cAAc,EAAEA,CAAA,KAAM;IACpB,MAAMT,KAAK,GAAGvC,cAAc,CAAC8C,QAAQ,CAAC,CAAC;IACvC,OAAOP,KAAK,CAAChD,MAAM,EAAEoB,KAAK,CAAC4B,KAAK,CAAC9C,gBAAgB,CAAC,IAAI,IAAI;EAC5D,CAAC;EAED;AACF;AACA;EACEwD,QAAQ,EAAEA,CAAA,KAAM;IACd,OAAOjD,cAAc,CAAC8C,QAAQ,CAAC,CAAC,CAACvD,MAAM,EAAEoB,KAAK,IAAI,EAAE;EACtD,CAAC;EAED;AACF;AACA;EACEuC,SAAS,EAAElD,cAAc,CAACkD;AAC5B,CAAC;;AAED;AACA;AACA;AACO,MAAMC,eAAe,GAAGA,CAAA,KAC7BnD,cAAc,CAAEuC,KAAkB,IAAKA,KAAK,CAAC/C,QAAQ,CAAC;AAACS,OAAA,CAAAkD,eAAA,GAAAA,eAAA;AAElD,MAAMC,aAAa,GAAGA,CAAA,KAC3BpD,cAAc,CAAEuC,KAAkB,IAAK;EACrC,IAAI,CAACA,KAAK,CAAChD,MAAM,IAAI,CAACgD,KAAK,CAAC/C,QAAQ,EAAE,OAAO,IAAI;EACjD,OAAO+C,KAAK,CAAChD,MAAM,CAACoB,KAAK,CAAC4B,KAAK,CAAC9C,gBAAgB,CAAC;AACnD,CAAC,CAAC;AAACQ,OAAA,CAAAmD,aAAA,GAAAA,aAAA;AAEE,MAAMC,iBAAiB,GAAGA,CAAA,KAC/BrD,cAAc,CACZ,IAAAsD,mBAAU,EAAEf,KAAkB,KAAM;EAClClB,WAAW,EAAEkB,KAAK,CAAC9C,gBAAgB,GAAG,CAAC;EACvC2B,UAAU,EAAEmB,KAAK,CAAChD,MAAM,EAAEoB,KAAK,CAACC,MAAM,IAAI,CAAC;EAC3C2C,UAAU,EAAEhB,KAAK,CAAChD,MAAM,GACnB,CAACgD,KAAK,CAAC9C,gBAAgB,GAAG,CAAC,IAAI8C,KAAK,CAAChD,MAAM,CAACoB,KAAK,CAACC,MAAM,GAAI,GAAG,GAChE;AACN,CAAC,CAAC,CACJ,CAAC;AAACX,OAAA,CAAAoD,iBAAA,GAAAA,iBAAA;AAEG,MAAMG,qBAAqB,GAAInB,QAAgB,IACpDrC,cAAc,CAAEuC,KAAkB,IAAKA,KAAK,CAAC5C,kBAAkB,CAAC0C,QAAQ,CAAC,CAAC;;AAE5E;AACA;AACA;AACA;AAHApC,OAAA,CAAAuD,qBAAA,GAAAA,qBAAA;AAIO,MAAMC,eAAe,GAAGA,CAAA,KAC7BzD,cAAc,CACZ,IAAAsD,mBAAU,EAAEf,KAAkB,IAAK;EACjC,IAAI,CAACA,KAAK,CAAC/C,QAAQ,IAAI,CAAC+C,KAAK,CAAChD,MAAM,EAAE,OAAO,IAAI;EAEjD,MAAM8B,WAAW,GAAGkB,KAAK,CAAChD,MAAM,CAACoB,KAAK,CAAC4B,KAAK,CAAC9C,gBAAgB,CAAC;EAC9D,MAAM4C,QAAQ,GAAGhB,WAAW,EAAEgB,QAAQ;;EAEtC;EACA,IAAI,CAACA,QAAQ,EAAE,OAAO,IAAI;EAE1B,MAAMqB,eAAe,GAAG,CAAC,CAACnB,KAAK,CAAC5C,kBAAkB,CAAC0C,QAAQ,CAAC;EAE5D,OAAO;IACLsB,SAAS,EAAE,CAACD,eAAe;IAC3BrB,QAAQ,EAAEqB,eAAe,GAAG,IAAI,GAAGrB,QAAQ;IAC3CuB,OAAO,EAAEvC,WAAW,EAAEwC,cAAc,IAAI;EAC1C,CAAC;AACH,CAAC,CACH,CAAC;;AAEH;AACA;AACA;AAFA5D,OAAA,CAAAwD,eAAA,GAAAA,eAAA;AAGO,MAAMK,iBAAiB,GAAGA,CAAA,KAC/B9D,cAAc,CAAEuC,KAAkB,IAAK;EACrC,IAAI,CAACA,KAAK,CAAChD,MAAM,IAAI,CAACgD,KAAK,CAAC/C,QAAQ,EAAE,OAAO,KAAK;EAClD,OAAO,CAAC+C,KAAK,CAAChD,MAAM,CAACoB,KAAK,CAAC4B,KAAK,CAAC9C,gBAAgB,CAAC,EAAE4C,QAAQ;AAC9D,CAAC,CAAC;AAACpC,OAAA,CAAA6D,iBAAA,GAAAA,iBAAA","ignoreList":[]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["
|
|
1
|
+
{"version":3,"names":["useGuidon"],"sourceRoot":"../../../src","sources":["hooks/index.ts"],"mappings":";;AAAA,SAASA,SAAS,QAAQ,mBAAgB","ignoreList":[]}
|
|
@@ -10,122 +10,21 @@ import { useGuidonStore } from "../store.js";
|
|
|
10
10
|
*/
|
|
11
11
|
|
|
12
12
|
/**
|
|
13
|
-
* Hook that returns a
|
|
13
|
+
* Hook that returns a function to attach to an element for guidon targeting.
|
|
14
14
|
* Alternative to the GuidonTarget wrapper component.
|
|
15
15
|
*
|
|
16
16
|
* @param targetId - The target ID that matches a step's targetId
|
|
17
|
-
* @returns A
|
|
17
|
+
* @returns A function that will register the target element
|
|
18
18
|
*
|
|
19
19
|
* @example
|
|
20
20
|
* ```tsx
|
|
21
21
|
* function MyComponent() {
|
|
22
|
-
* const
|
|
23
|
-
* return <Button ref={
|
|
24
|
-
* }
|
|
25
|
-
* ```
|
|
26
|
-
*
|
|
27
|
-
* @example Web usage
|
|
28
|
-
* ```tsx
|
|
29
|
-
* function MyComponent() {
|
|
30
|
-
* const divRef = useGuidonRef<HTMLDivElement>('my-div');
|
|
31
|
-
* return <div ref={divRef}>Highlight me</div>;
|
|
22
|
+
* const {register} = useGuidon();
|
|
23
|
+
* return <Button ref={register('my-button')}>Click me</Button>;
|
|
32
24
|
* }
|
|
33
25
|
* ```
|
|
34
26
|
*/
|
|
35
|
-
export function useGuidonRef(targetId) {
|
|
36
|
-
const ref = useRef(null);
|
|
37
|
-
const measurementFrameRef = useRef(null);
|
|
38
|
-
const registerTarget = useGuidonStore(state => state.registerTarget);
|
|
39
|
-
const unregisterTarget = useGuidonStore(state => state.unregisterTarget);
|
|
40
|
-
const isActive = useGuidonStore(state => state.isActive);
|
|
41
|
-
const config = useGuidonStore(state => state.config);
|
|
42
|
-
const currentStepIndex = useGuidonStore(state => state.currentStepIndex);
|
|
43
|
-
|
|
44
|
-
// Check if this target is needed anywhere in the walkthrough
|
|
45
|
-
const isTargetNeeded = isActive && config?.steps.some(step => step.targetId === targetId);
|
|
46
|
-
|
|
47
|
-
// Check if this specific target is needed for the current step
|
|
48
|
-
const isCurrentTarget = config?.steps[currentStepIndex]?.targetId === targetId;
|
|
49
|
-
const measureElement = useCallback(() => {
|
|
50
|
-
if (!ref.current || !isTargetNeeded) return;
|
|
51
|
-
if (Platform.OS === "web") {
|
|
52
|
-
// Web measurement using getBoundingClientRect
|
|
53
|
-
const element = ref.current;
|
|
54
|
-
if (element && typeof element.getBoundingClientRect === "function") {
|
|
55
|
-
const rect = element.getBoundingClientRect();
|
|
56
|
-
const measurements = {
|
|
57
|
-
x: rect.left + window.scrollX,
|
|
58
|
-
y: rect.top + window.scrollY,
|
|
59
|
-
width: rect.width,
|
|
60
|
-
height: rect.height
|
|
61
|
-
};
|
|
62
|
-
registerTarget(targetId, measurements);
|
|
63
|
-
}
|
|
64
|
-
} else {
|
|
65
|
-
// Native measurement using measureInWindow
|
|
66
|
-
const nativeRef = ref.current;
|
|
67
|
-
if (nativeRef && typeof nativeRef.measureInWindow === "function") {
|
|
68
|
-
nativeRef.measureInWindow((x, y, width, height) => {
|
|
69
|
-
if (width > 0 && height > 0) {
|
|
70
|
-
const measurements = {
|
|
71
|
-
x,
|
|
72
|
-
y,
|
|
73
|
-
width,
|
|
74
|
-
height
|
|
75
|
-
};
|
|
76
|
-
registerTarget(targetId, measurements);
|
|
77
|
-
}
|
|
78
|
-
});
|
|
79
|
-
}
|
|
80
|
-
}
|
|
81
|
-
}, [targetId, isTargetNeeded, registerTarget]);
|
|
82
|
-
|
|
83
|
-
// Measure when guidon becomes active or when this target becomes relevant
|
|
84
|
-
useEffect(() => {
|
|
85
|
-
if (!isTargetNeeded) return;
|
|
86
|
-
|
|
87
|
-
// Use requestAnimationFrame to ensure layout is complete
|
|
88
|
-
measurementFrameRef.current = requestAnimationFrame(() => {
|
|
89
|
-
measureElement();
|
|
90
|
-
});
|
|
91
|
-
return () => {
|
|
92
|
-
if (measurementFrameRef.current) {
|
|
93
|
-
cancelAnimationFrame(measurementFrameRef.current);
|
|
94
|
-
}
|
|
95
|
-
};
|
|
96
|
-
}, [isTargetNeeded, measureElement]);
|
|
97
|
-
|
|
98
|
-
// Re-measure when this target becomes the current step
|
|
99
|
-
useEffect(() => {
|
|
100
|
-
if (!isCurrentTarget) return;
|
|
101
|
-
const timer = setTimeout(() => {
|
|
102
|
-
measureElement();
|
|
103
|
-
}, 50);
|
|
104
|
-
return () => clearTimeout(timer);
|
|
105
|
-
}, [isCurrentTarget, measureElement]);
|
|
106
|
-
|
|
107
|
-
// Web: handle scroll and resize
|
|
108
|
-
useEffect(() => {
|
|
109
|
-
if (Platform.OS !== "web" || !isTargetNeeded) return;
|
|
110
|
-
const handleScrollOrResize = () => {
|
|
111
|
-
measureElement();
|
|
112
|
-
};
|
|
113
|
-
window.addEventListener("scroll", handleScrollOrResize, true);
|
|
114
|
-
window.addEventListener("resize", handleScrollOrResize);
|
|
115
|
-
return () => {
|
|
116
|
-
window.removeEventListener("scroll", handleScrollOrResize, true);
|
|
117
|
-
window.removeEventListener("resize", handleScrollOrResize);
|
|
118
|
-
};
|
|
119
|
-
}, [isTargetNeeded, measureElement]);
|
|
120
27
|
|
|
121
|
-
// Unregister on unmount
|
|
122
|
-
useEffect(() => {
|
|
123
|
-
return () => {
|
|
124
|
-
unregisterTarget(targetId);
|
|
125
|
-
};
|
|
126
|
-
}, [targetId, unregisterTarget]);
|
|
127
|
-
return ref;
|
|
128
|
-
}
|
|
129
28
|
export function useGuidon() {
|
|
130
29
|
const register = useGuidonRegister();
|
|
131
30
|
return {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["useCallback","useEffect","useRef","Platform","useGuidonStore","
|
|
1
|
+
{"version":3,"names":["useCallback","useEffect","useRef","Platform","useGuidonStore","useGuidon","register","useGuidonRegister","elementsRef","Map","rafRef","registerTarget","state","unregisterTarget","isActive","config","currentStepIndex","measure","targetId","node","isTargetUsed","steps","some","step","OS","el","getBoundingClientRect","rect","style","window","getComputedStyle","paddingLeft","parseFloat","paddingRight","paddingTop","paddingBottom","borderLeft","borderLeftWidth","borderRight","borderRightWidth","borderTop","borderTopWidth","borderBottom","borderBottomWidth","x","left","scrollX","y","top","scrollY","width","height","native","measureInWindow","current","set","raf","requestAnimationFrame","delete","get","cancelAnimationFrame","handler","forEach","id","addEventListener","removeEventListener"],"sourceRoot":"../../../src","sources":["hooks/useGuidonRef.ts"],"mappings":"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","ignoreList":[]}
|
package/dist/module/index.js
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
export { GuidonTarget, GuidonOverlay, GuidonTooltip, GuidonProvider, useGuidonContext } from "./components/index.js";
|
|
5
5
|
|
|
6
6
|
// Hooks
|
|
7
|
-
export {
|
|
7
|
+
export { useGuidon } from "./hooks/index.js";
|
|
8
8
|
|
|
9
9
|
// Store and API
|
|
10
10
|
export { useGuidonStore, Guidon, useGuidonActive, useGuidonStep, useGuidonProgress, useTargetMeasurements, useWaitingState, useIsFloatingStep } from "./store.js";
|
package/dist/module/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["GuidonTarget","GuidonOverlay","GuidonTooltip","GuidonProvider","useGuidonContext","
|
|
1
|
+
{"version":3,"names":["GuidonTarget","GuidonOverlay","GuidonTooltip","GuidonProvider","useGuidonContext","useGuidon","useGuidonStore","Guidon","useGuidonActive","useGuidonStep","useGuidonProgress","useTargetMeasurements","useWaitingState","useIsFloatingStep","createNoopAdapter","createMemoryAdapter","createLocalStorageAdapter","createAsyncStorageAdapter","createApiAdapter","createCompositeAdapter","useGuidonPersistence","useShouldShowGuidon"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA,SACEA,YAAY,EACZC,aAAa,EACbC,aAAa,EACbC,cAAc,EACdC,gBAAgB,QACX,uBAAc;;AAErB;AACA,SAASC,SAAS,QAAQ,kBAAS;;AAEnC;AACA,SACEC,cAAc,EACdC,MAAM,EACNC,eAAe,EACfC,aAAa,EACbC,iBAAiB,EACjBC,qBAAqB,EACrBC,eAAe,EACfC,iBAAiB,QACZ,YAAS;;AAEhB;;AAmBA;AACA,SACEC,iBAAiB,EACjBC,mBAAmB,EACnBC,yBAAyB,EACzBC,yBAAyB,EACzBC,gBAAgB,EAChBC,sBAAsB,QACjB,2BAAwB;AAE/B,SAASC,oBAAoB,EAAEC,mBAAmB,QAAQ,wBAAqB","ignoreList":[]}
|
package/dist/module/store.js
CHANGED
|
@@ -72,7 +72,9 @@ export const useGuidonStore = create((set, get) => ({
|
|
|
72
72
|
const nextStep = config.steps[nextIndex];
|
|
73
73
|
console.log("[Guidon] advancing to step", nextIndex, nextStep?.id ?? "undefined");
|
|
74
74
|
set({
|
|
75
|
-
|
|
75
|
+
config,
|
|
76
|
+
currentStepIndex: nextIndex,
|
|
77
|
+
isActive
|
|
76
78
|
});
|
|
77
79
|
nextStep?.onStepEnter?.();
|
|
78
80
|
if (nextStep) {
|
package/dist/module/store.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"names":["create","useShallow","initialState","config","isActive","currentStepIndex","isCompleted","targetMeasurements","isLoading","error","waitingForTarget","waitingTargetId","useGuidonStore","set","get","configure","start","console","log","hasConfig","stepCount","steps","length","map","s","id","firstStep","onStepEnter","onStepChange","next","totalSteps","currentStep","onStepExit","nextIndex","nextStep","complete","previous","prevIndex","prevStep","goToStep","index","targetStep","skip","onSkip","onComplete","reset","registerTarget","targetId","measurements","state","unregisterTarget","_","rest","setLoading","setError","Guidon","getState","getCurrentStepIndex","getCurrentStep","getSteps","subscribe","useGuidonActive","useGuidonStep","useGuidonProgress","percentage","useTargetMeasurements","useWaitingState","hasMeasurements","isWaiting","message","waitingMessage","useIsFloatingStep"],"sourceRoot":"../../src","sources":["store.ts"],"mappings":"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
|
|
1
|
+
{"version":3,"names":["create","useShallow","initialState","config","isActive","currentStepIndex","isCompleted","targetMeasurements","isLoading","error","waitingForTarget","waitingTargetId","useGuidonStore","set","get","configure","start","console","log","hasConfig","stepCount","steps","length","map","s","id","firstStep","onStepEnter","onStepChange","next","totalSteps","currentStep","onStepExit","nextIndex","nextStep","complete","previous","prevIndex","prevStep","goToStep","index","targetStep","skip","onSkip","onComplete","reset","registerTarget","targetId","measurements","state","unregisterTarget","_","rest","setLoading","setError","Guidon","getState","getCurrentStepIndex","getCurrentStep","getSteps","subscribe","useGuidonActive","useGuidonStep","useGuidonProgress","percentage","useTargetMeasurements","useWaitingState","hasMeasurements","isWaiting","message","waitingMessage","useIsFloatingStep"],"sourceRoot":"../../src","sources":["store.ts"],"mappings":"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","ignoreList":[]}
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export {
|
|
1
|
+
export { useGuidon } from "./useGuidonRef";
|
|
2
2
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}
|
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
import { type RefObject } from "react";
|
|
2
1
|
/**
|
|
3
2
|
* Element type that can be measured
|
|
4
3
|
* Supports both web elements and React Native Views
|
|
@@ -8,29 +7,20 @@ type MeasurableElement = {
|
|
|
8
7
|
measureInWindow?: (callback: (x: number, y: number, width: number, height: number) => void) => void;
|
|
9
8
|
};
|
|
10
9
|
/**
|
|
11
|
-
* Hook that returns a
|
|
10
|
+
* Hook that returns a function to attach to an element for guidon targeting.
|
|
12
11
|
* Alternative to the GuidonTarget wrapper component.
|
|
13
12
|
*
|
|
14
13
|
* @param targetId - The target ID that matches a step's targetId
|
|
15
|
-
* @returns A
|
|
14
|
+
* @returns A function that will register the target element
|
|
16
15
|
*
|
|
17
16
|
* @example
|
|
18
17
|
* ```tsx
|
|
19
18
|
* function MyComponent() {
|
|
20
|
-
* const
|
|
21
|
-
* return <Button ref={
|
|
22
|
-
* }
|
|
23
|
-
* ```
|
|
24
|
-
*
|
|
25
|
-
* @example Web usage
|
|
26
|
-
* ```tsx
|
|
27
|
-
* function MyComponent() {
|
|
28
|
-
* const divRef = useGuidonRef<HTMLDivElement>('my-div');
|
|
29
|
-
* return <div ref={divRef}>Highlight me</div>;
|
|
19
|
+
* const {register} = useGuidon();
|
|
20
|
+
* return <Button ref={register('my-button')}>Click me</Button>;
|
|
30
21
|
* }
|
|
31
22
|
* ```
|
|
32
23
|
*/
|
|
33
|
-
export declare function useGuidonRef<T extends MeasurableElement>(targetId: string): RefObject<T | null>;
|
|
34
24
|
export declare function useGuidon(): {
|
|
35
25
|
register: (targetId: string) => (node: MeasurableElement | null) => void;
|
|
36
26
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"useGuidonRef.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useGuidonRef.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"useGuidonRef.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useGuidonRef.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,KAAK,iBAAiB,GAAG;IACvB,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC;IACtC,eAAe,CAAC,EAAE,CAChB,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,KACpE,IAAI,CAAC;CACX,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AAEH,wBAAgB,SAAS;yBA2EV,MAAM,YACD,iBAAiB,GAAG,IAAI;EAzE3C;AAED,wBAAgB,iBAAiB,eAsElB,MAAM,YACD,iBAAiB,GAAG,IAAI,UAwD3C"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
export { GuidonTarget, GuidonOverlay, GuidonTooltip, GuidonProvider, useGuidonContext, } from "./components";
|
|
2
|
-
export {
|
|
2
|
+
export { useGuidon } from "./hooks";
|
|
3
3
|
export { useGuidonStore, Guidon, useGuidonActive, useGuidonStep, useGuidonProgress, useTargetMeasurements, useWaitingState, useIsFloatingStep, } from "./store";
|
|
4
4
|
export type { GuidonStep, GuidonConfig, GuidonTheme, GuidonProgress, GuidonPersistenceAdapter, GuidonProviderProps, GuidonTargetProps, GuidonTooltipLabels, GuidonTooltipRenderProps, TooltipPosition, FloatingPosition, TargetMeasurements, GuidonState, GuidonActions, GuidonStore, } from "./types";
|
|
5
5
|
export { createNoopAdapter, createMemoryAdapter, createLocalStorageAdapter, createAsyncStorageAdapter, createApiAdapter, createCompositeAdapter, } from "./persistence/adapters";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,OAAO,EACL,cAAc,EACd,MAAM,EACN,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export {
|
|
1
|
+
export { useGuidon } from "./useGuidonRef";
|
|
2
2
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}
|
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
import { type RefObject } from "react";
|
|
2
1
|
/**
|
|
3
2
|
* Element type that can be measured
|
|
4
3
|
* Supports both web elements and React Native Views
|
|
@@ -8,29 +7,20 @@ type MeasurableElement = {
|
|
|
8
7
|
measureInWindow?: (callback: (x: number, y: number, width: number, height: number) => void) => void;
|
|
9
8
|
};
|
|
10
9
|
/**
|
|
11
|
-
* Hook that returns a
|
|
10
|
+
* Hook that returns a function to attach to an element for guidon targeting.
|
|
12
11
|
* Alternative to the GuidonTarget wrapper component.
|
|
13
12
|
*
|
|
14
13
|
* @param targetId - The target ID that matches a step's targetId
|
|
15
|
-
* @returns A
|
|
14
|
+
* @returns A function that will register the target element
|
|
16
15
|
*
|
|
17
16
|
* @example
|
|
18
17
|
* ```tsx
|
|
19
18
|
* function MyComponent() {
|
|
20
|
-
* const
|
|
21
|
-
* return <Button ref={
|
|
22
|
-
* }
|
|
23
|
-
* ```
|
|
24
|
-
*
|
|
25
|
-
* @example Web usage
|
|
26
|
-
* ```tsx
|
|
27
|
-
* function MyComponent() {
|
|
28
|
-
* const divRef = useGuidonRef<HTMLDivElement>('my-div');
|
|
29
|
-
* return <div ref={divRef}>Highlight me</div>;
|
|
19
|
+
* const {register} = useGuidon();
|
|
20
|
+
* return <Button ref={register('my-button')}>Click me</Button>;
|
|
30
21
|
* }
|
|
31
22
|
* ```
|
|
32
23
|
*/
|
|
33
|
-
export declare function useGuidonRef<T extends MeasurableElement>(targetId: string): RefObject<T | null>;
|
|
34
24
|
export declare function useGuidon(): {
|
|
35
25
|
register: (targetId: string) => (node: MeasurableElement | null) => void;
|
|
36
26
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"useGuidonRef.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useGuidonRef.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"useGuidonRef.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useGuidonRef.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,KAAK,iBAAiB,GAAG;IACvB,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC;IACtC,eAAe,CAAC,EAAE,CAChB,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,KACpE,IAAI,CAAC;CACX,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AAEH,wBAAgB,SAAS;yBA2EV,MAAM,YACD,iBAAiB,GAAG,IAAI;EAzE3C;AAED,wBAAgB,iBAAiB,eAsElB,MAAM,YACD,iBAAiB,GAAG,IAAI,UAwD3C"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
export { GuidonTarget, GuidonOverlay, GuidonTooltip, GuidonProvider, useGuidonContext, } from "./components";
|
|
2
|
-
export {
|
|
2
|
+
export { useGuidon } from "./hooks";
|
|
3
3
|
export { useGuidonStore, Guidon, useGuidonActive, useGuidonStep, useGuidonProgress, useTargetMeasurements, useWaitingState, useIsFloatingStep, } from "./store";
|
|
4
4
|
export type { GuidonStep, GuidonConfig, GuidonTheme, GuidonProgress, GuidonPersistenceAdapter, GuidonProviderProps, GuidonTargetProps, GuidonTooltipLabels, GuidonTooltipRenderProps, TooltipPosition, FloatingPosition, TargetMeasurements, GuidonState, GuidonActions, GuidonStore, } from "./types";
|
|
5
5
|
export { createNoopAdapter, createMemoryAdapter, createLocalStorageAdapter, createAsyncStorageAdapter, createApiAdapter, createCompositeAdapter, } from "./persistence/adapters";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,OAAO,EACL,cAAc,EACd,MAAM,EACN,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@korsolutions/guidon",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.8",
|
|
4
4
|
"description": "A cross-platform walkthrough/onboarding component library for React Native with web support. Features spotlight effects, customizable tooltips, and flexible persistence options. ",
|
|
5
5
|
"repository": "https://github.com/KorSoftwareSolutions/guidon.git",
|
|
6
6
|
"author": "Christian Jimenez <christianjimenezfael@gmail.com>",
|
package/src/hooks/index.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export {
|
|
1
|
+
export { useGuidon } from "./useGuidonRef";
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import { useCallback, useEffect, useRef
|
|
1
|
+
import { useCallback, useEffect, useRef } from "react";
|
|
2
2
|
import { Platform } from "react-native";
|
|
3
3
|
import { useGuidonStore } from "../store";
|
|
4
|
-
import type {
|
|
4
|
+
import type { GuidonStore } from "../types";
|
|
5
5
|
|
|
6
6
|
/**
|
|
7
7
|
* Element type that can be measured
|
|
@@ -15,143 +15,20 @@ type MeasurableElement = {
|
|
|
15
15
|
};
|
|
16
16
|
|
|
17
17
|
/**
|
|
18
|
-
* Hook that returns a
|
|
18
|
+
* Hook that returns a function to attach to an element for guidon targeting.
|
|
19
19
|
* Alternative to the GuidonTarget wrapper component.
|
|
20
20
|
*
|
|
21
21
|
* @param targetId - The target ID that matches a step's targetId
|
|
22
|
-
* @returns A
|
|
22
|
+
* @returns A function that will register the target element
|
|
23
23
|
*
|
|
24
24
|
* @example
|
|
25
25
|
* ```tsx
|
|
26
26
|
* function MyComponent() {
|
|
27
|
-
* const
|
|
28
|
-
* return <Button ref={
|
|
29
|
-
* }
|
|
30
|
-
* ```
|
|
31
|
-
*
|
|
32
|
-
* @example Web usage
|
|
33
|
-
* ```tsx
|
|
34
|
-
* function MyComponent() {
|
|
35
|
-
* const divRef = useGuidonRef<HTMLDivElement>('my-div');
|
|
36
|
-
* return <div ref={divRef}>Highlight me</div>;
|
|
27
|
+
* const {register} = useGuidon();
|
|
28
|
+
* return <Button ref={register('my-button')}>Click me</Button>;
|
|
37
29
|
* }
|
|
38
30
|
* ```
|
|
39
31
|
*/
|
|
40
|
-
export function useGuidonRef<T extends MeasurableElement>(
|
|
41
|
-
targetId: string,
|
|
42
|
-
): RefObject<T | null> {
|
|
43
|
-
const ref = useRef<T>(null);
|
|
44
|
-
const measurementFrameRef = useRef<number | null>(null);
|
|
45
|
-
|
|
46
|
-
const registerTarget = useGuidonStore(
|
|
47
|
-
(state: GuidonStore) => state.registerTarget,
|
|
48
|
-
);
|
|
49
|
-
const unregisterTarget = useGuidonStore(
|
|
50
|
-
(state: GuidonStore) => state.unregisterTarget,
|
|
51
|
-
);
|
|
52
|
-
const isActive = useGuidonStore((state: GuidonStore) => state.isActive);
|
|
53
|
-
const config = useGuidonStore((state: GuidonStore) => state.config);
|
|
54
|
-
const currentStepIndex = useGuidonStore(
|
|
55
|
-
(state: GuidonStore) => state.currentStepIndex,
|
|
56
|
-
);
|
|
57
|
-
|
|
58
|
-
// Check if this target is needed anywhere in the walkthrough
|
|
59
|
-
const isTargetNeeded =
|
|
60
|
-
isActive &&
|
|
61
|
-
config?.steps.some((step: GuidonStep) => step.targetId === targetId);
|
|
62
|
-
|
|
63
|
-
// Check if this specific target is needed for the current step
|
|
64
|
-
const isCurrentTarget =
|
|
65
|
-
config?.steps[currentStepIndex]?.targetId === targetId;
|
|
66
|
-
|
|
67
|
-
const measureElement = useCallback(() => {
|
|
68
|
-
if (!ref.current || !isTargetNeeded) return;
|
|
69
|
-
|
|
70
|
-
if (Platform.OS === "web") {
|
|
71
|
-
// Web measurement using getBoundingClientRect
|
|
72
|
-
const element = ref.current as unknown as HTMLElement;
|
|
73
|
-
if (element && typeof element.getBoundingClientRect === "function") {
|
|
74
|
-
const rect = element.getBoundingClientRect();
|
|
75
|
-
const measurements: TargetMeasurements = {
|
|
76
|
-
x: rect.left + window.scrollX,
|
|
77
|
-
y: rect.top + window.scrollY,
|
|
78
|
-
width: rect.width,
|
|
79
|
-
height: rect.height,
|
|
80
|
-
};
|
|
81
|
-
registerTarget(targetId, measurements);
|
|
82
|
-
}
|
|
83
|
-
} else {
|
|
84
|
-
// Native measurement using measureInWindow
|
|
85
|
-
const nativeRef = ref.current as unknown as {
|
|
86
|
-
measureInWindow: (
|
|
87
|
-
cb: (x: number, y: number, w: number, h: number) => void,
|
|
88
|
-
) => void;
|
|
89
|
-
};
|
|
90
|
-
|
|
91
|
-
if (nativeRef && typeof nativeRef.measureInWindow === "function") {
|
|
92
|
-
nativeRef.measureInWindow((x, y, width, height) => {
|
|
93
|
-
if (width > 0 && height > 0) {
|
|
94
|
-
const measurements: TargetMeasurements = { x, y, width, height };
|
|
95
|
-
registerTarget(targetId, measurements);
|
|
96
|
-
}
|
|
97
|
-
});
|
|
98
|
-
}
|
|
99
|
-
}
|
|
100
|
-
}, [targetId, isTargetNeeded, registerTarget]);
|
|
101
|
-
|
|
102
|
-
// Measure when guidon becomes active or when this target becomes relevant
|
|
103
|
-
useEffect(() => {
|
|
104
|
-
if (!isTargetNeeded) return;
|
|
105
|
-
|
|
106
|
-
// Use requestAnimationFrame to ensure layout is complete
|
|
107
|
-
measurementFrameRef.current = requestAnimationFrame(() => {
|
|
108
|
-
measureElement();
|
|
109
|
-
});
|
|
110
|
-
|
|
111
|
-
return () => {
|
|
112
|
-
if (measurementFrameRef.current) {
|
|
113
|
-
cancelAnimationFrame(measurementFrameRef.current);
|
|
114
|
-
}
|
|
115
|
-
};
|
|
116
|
-
}, [isTargetNeeded, measureElement]);
|
|
117
|
-
|
|
118
|
-
// Re-measure when this target becomes the current step
|
|
119
|
-
useEffect(() => {
|
|
120
|
-
if (!isCurrentTarget) return;
|
|
121
|
-
|
|
122
|
-
const timer = setTimeout(() => {
|
|
123
|
-
measureElement();
|
|
124
|
-
}, 50);
|
|
125
|
-
|
|
126
|
-
return () => clearTimeout(timer);
|
|
127
|
-
}, [isCurrentTarget, measureElement]);
|
|
128
|
-
|
|
129
|
-
// Web: handle scroll and resize
|
|
130
|
-
useEffect(() => {
|
|
131
|
-
if (Platform.OS !== "web" || !isTargetNeeded) return;
|
|
132
|
-
|
|
133
|
-
const handleScrollOrResize = () => {
|
|
134
|
-
measureElement();
|
|
135
|
-
};
|
|
136
|
-
|
|
137
|
-
window.addEventListener("scroll", handleScrollOrResize, true);
|
|
138
|
-
window.addEventListener("resize", handleScrollOrResize);
|
|
139
|
-
|
|
140
|
-
return () => {
|
|
141
|
-
window.removeEventListener("scroll", handleScrollOrResize, true);
|
|
142
|
-
window.removeEventListener("resize", handleScrollOrResize);
|
|
143
|
-
};
|
|
144
|
-
}, [isTargetNeeded, measureElement]);
|
|
145
|
-
|
|
146
|
-
// Unregister on unmount
|
|
147
|
-
useEffect(() => {
|
|
148
|
-
return () => {
|
|
149
|
-
unregisterTarget(targetId);
|
|
150
|
-
};
|
|
151
|
-
}, [targetId, unregisterTarget]);
|
|
152
|
-
|
|
153
|
-
return ref;
|
|
154
|
-
}
|
|
155
32
|
|
|
156
33
|
export function useGuidon() {
|
|
157
34
|
const register = useGuidonRegister();
|
package/src/index.ts
CHANGED
package/src/store.ts
CHANGED
|
@@ -74,7 +74,7 @@ export const useGuidonStore = create<GuidonStore>((set, get) => ({
|
|
|
74
74
|
nextIndex,
|
|
75
75
|
nextStep?.id ?? "undefined",
|
|
76
76
|
);
|
|
77
|
-
set({ currentStepIndex: nextIndex });
|
|
77
|
+
set({ config, currentStepIndex: nextIndex, isActive });
|
|
78
78
|
|
|
79
79
|
nextStep?.onStepEnter?.();
|
|
80
80
|
if (nextStep) {
|