@vielzeug/beacon 26.11.5 → 26.11.6
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/_dev.js +1 -2
- package/dist/_emit.js +1 -2
- package/dist/_scroll.js +1 -2
- package/dist/_storage.js +1 -2
- package/dist/_target.js +1 -2
- package/dist/beacon.js +8 -16
- package/dist/beacon.js.map +1 -1
- package/dist/coachmark.cjs +1 -1
- package/dist/coachmark.cjs.map +1 -1
- package/dist/coachmark.js +12 -13
- package/dist/errors.js +1 -2
- package/dist/index.cjs +1 -1
- package/dist/index.js +3 -3
- package/dist/target.js +1 -2
- package/dist/tour.cjs +1 -1
- package/dist/tour.cjs.map +1 -1
- package/dist/tour.js +49 -50
- package/package.json +8 -8
package/dist/_dev.js
CHANGED
package/dist/_emit.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
|
|
1
|
+
// src/_emit.ts
|
|
2
2
|
function createTappers(e) {
|
|
3
3
|
let t = /* @__PURE__ */ new Set(), emit = (e) => {
|
|
4
4
|
if (t.size !== 0) for (let n of t) try {
|
|
@@ -24,7 +24,6 @@ function createTappers(e) {
|
|
|
24
24
|
warn
|
|
25
25
|
};
|
|
26
26
|
}
|
|
27
|
-
//#endregion
|
|
28
27
|
export { createTappers };
|
|
29
28
|
|
|
30
29
|
//# sourceMappingURL=_emit.js.map
|
package/dist/_scroll.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { resolveTarget as e } from "./target.js";
|
|
2
|
-
|
|
2
|
+
// src/_scroll.ts
|
|
3
3
|
var prefersReducedMotion = () => typeof matchMedia == "function" && matchMedia("(prefers-reduced-motion: reduce)").matches;
|
|
4
4
|
function scrollTargetIntoView(t, n = {}) {
|
|
5
5
|
if (typeof window > "u" || typeof document > "u") return !1;
|
|
@@ -11,7 +11,6 @@ function scrollTargetIntoView(t, n = {}) {
|
|
|
11
11
|
top: d
|
|
12
12
|
}), !0;
|
|
13
13
|
}
|
|
14
|
-
//#endregion
|
|
15
14
|
export { scrollTargetIntoView };
|
|
16
15
|
|
|
17
16
|
//# sourceMappingURL=_scroll.js.map
|
package/dist/_storage.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
|
|
1
|
+
// src/_storage.ts
|
|
2
2
|
var storageKey = (e) => `@vielzeug/beacon:${e}`, e = /* @__PURE__ */ new Set([
|
|
3
3
|
"active",
|
|
4
4
|
"completed",
|
|
@@ -27,7 +27,6 @@ function createMemoryStorage() {
|
|
|
27
27
|
}
|
|
28
28
|
};
|
|
29
29
|
}
|
|
30
|
-
//#endregion
|
|
31
30
|
export { createMemoryStorage, parseProgress, storageKey };
|
|
32
31
|
|
|
33
32
|
//# sourceMappingURL=_storage.js.map
|
package/dist/_target.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { isStaticTarget as e, targetAvailable as t, targetElement as n } from "./target.js";
|
|
2
|
-
|
|
2
|
+
// src/_target.ts
|
|
3
3
|
function observeTarget(n, r, i) {
|
|
4
4
|
if (e(n) || typeof document > "u" || typeof MutationObserver > "u") return null;
|
|
5
5
|
let a = t(n), o = new MutationObserver(() => {
|
|
@@ -26,7 +26,6 @@ function observeTargetLayout(e, t, r) {
|
|
|
26
26
|
};
|
|
27
27
|
return r.addEventListener("abort", stop, { once: !0 }), stop;
|
|
28
28
|
}
|
|
29
|
-
//#endregion
|
|
30
29
|
export { observeTarget, observeTargetLayout };
|
|
31
30
|
|
|
32
31
|
//# sourceMappingURL=_target.js.map
|
package/dist/beacon.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { signal as e } from "@vielzeug/ripple";
|
|
2
|
-
|
|
2
|
+
// src/_emit.ts
|
|
3
3
|
function createTappers(e) {
|
|
4
4
|
let t = /* @__PURE__ */ new Set(), emit = (e) => {
|
|
5
5
|
if (t.size !== 0) for (let n of t) try {
|
|
@@ -25,8 +25,7 @@ function createTappers(e) {
|
|
|
25
25
|
warn
|
|
26
26
|
};
|
|
27
27
|
}
|
|
28
|
-
|
|
29
|
-
//#region src/_storage.ts
|
|
28
|
+
// src/_storage.ts
|
|
30
29
|
var t = "@vielzeug/beacon:", storageKey = (e) => `${t}${e}`, n = /* @__PURE__ */ new Set([
|
|
31
30
|
"active",
|
|
32
31
|
"completed",
|
|
@@ -55,8 +54,7 @@ function createMemoryStorage() {
|
|
|
55
54
|
}
|
|
56
55
|
};
|
|
57
56
|
}
|
|
58
|
-
|
|
59
|
-
//#region src/target.ts
|
|
57
|
+
// src/target.ts
|
|
60
58
|
var isElement = (e) => typeof Element < "u" && e instanceof Element, isRect = (e) => typeof e == "object" && !!e && typeof e.x == "number" && typeof e.y == "number" && typeof e.width == "number" && typeof e.height == "number", normalize = (e) => {
|
|
61
59
|
if (e === null) return null;
|
|
62
60
|
if (!isElement(e)) return e;
|
|
@@ -88,8 +86,7 @@ function isStaticTarget(e) {
|
|
|
88
86
|
function sameRect(e, t) {
|
|
89
87
|
return e === null || t === null ? e === t : e.x === t.x && e.y === t.y && e.width === t.width && e.height === t.height;
|
|
90
88
|
}
|
|
91
|
-
|
|
92
|
-
//#region src/_target.ts
|
|
89
|
+
// src/_target.ts
|
|
93
90
|
function observeTarget(e, t, n) {
|
|
94
91
|
if (isStaticTarget(e) || typeof document > "u" || typeof MutationObserver > "u") return null;
|
|
95
92
|
let r = targetAvailable(e), i = new MutationObserver(() => {
|
|
@@ -116,15 +113,13 @@ function observeTargetLayout(e, t, n) {
|
|
|
116
113
|
};
|
|
117
114
|
return n.addEventListener("abort", stop, { once: !0 }), stop;
|
|
118
115
|
}
|
|
119
|
-
|
|
120
|
-
//#region src/errors.ts
|
|
116
|
+
// src/errors.ts
|
|
121
117
|
var BeaconError = class extends Error {
|
|
122
118
|
constructor(e, t) {
|
|
123
119
|
super(e, t), this.name = new.target.name, Object.setPrototypeOf(this, new.target.prototype);
|
|
124
120
|
}
|
|
125
121
|
}, BeaconConfigError = class extends BeaconError {}, BeaconDisposedError = class extends BeaconError {};
|
|
126
|
-
|
|
127
|
-
//#region src/coachmark.ts
|
|
122
|
+
// src/coachmark.ts
|
|
128
123
|
function createCoachmark(t) {
|
|
129
124
|
if (!t.id) throw new BeaconConfigError("createCoachmark: \"id\" must be a non-empty string");
|
|
130
125
|
let n = t.version ?? 1, r = t.autoShow ?? !0, i = t.storage ?? createMemoryStorage(), a = storageKey(t.id), o = new AbortController(), { signal: s } = o, { emit: c, warn: l, tap: u, clear: d } = createTappers(s), f = e(!0), p = {
|
|
@@ -239,8 +234,7 @@ function createCoachmark(t) {
|
|
|
239
234
|
}
|
|
240
235
|
};
|
|
241
236
|
}
|
|
242
|
-
|
|
243
|
-
//#region src/_scroll.ts
|
|
237
|
+
// src/_scroll.ts
|
|
244
238
|
var prefersReducedMotion = () => typeof matchMedia == "function" && matchMedia("(prefers-reduced-motion: reduce)").matches;
|
|
245
239
|
function scrollTargetIntoView(e, t = {}) {
|
|
246
240
|
if (typeof window > "u" || typeof document > "u") return !1;
|
|
@@ -252,8 +246,7 @@ function scrollTargetIntoView(e, t = {}) {
|
|
|
252
246
|
top: u
|
|
253
247
|
}), !0;
|
|
254
248
|
}
|
|
255
|
-
|
|
256
|
-
//#region src/tour.ts
|
|
249
|
+
// src/tour.ts
|
|
257
250
|
var validateConfig = (e) => {
|
|
258
251
|
if (!e.id) throw new BeaconConfigError("createTour: \"id\" must be a non-empty string");
|
|
259
252
|
if (!Array.isArray(e.steps) || e.steps.length === 0) throw new BeaconConfigError(`createTour: tour "${e.id}" must have at least one step`);
|
|
@@ -480,7 +473,6 @@ function createTour(t) {
|
|
|
480
473
|
}
|
|
481
474
|
};
|
|
482
475
|
}
|
|
483
|
-
//#endregion
|
|
484
476
|
export { BeaconConfigError, BeaconDisposedError, BeaconError, createCoachmark, createTour, resolveTarget };
|
|
485
477
|
|
|
486
478
|
//# sourceMappingURL=beacon.js.map
|
package/dist/beacon.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"beacon.js","names":["tappers","tapper","event","error","signal","options","handler","KEY_PREFIX","id","STATUSES","value","record","entries","key","box","target","resolved","a","b","lastAvailable","observer","next","onChange","element","message","opts","config","version","autoShow","storage","controller","disposal","warnTap","clearTappers","eligible","step","HIDDEN","current","loadSequence","result","emit","rect","stopObserver","waiting","sequence","stored","raw","loaded","before","behavior","viewportHeight","reserved","documentTop","idealTop","correctedTop","maxScroll","clampedTop","seen","targetTimeoutMs","autoScroll","status","stopped","stopLayout","index","previous","timer","s","resumeAt","candidate"],"sources":["../src/_emit.ts","../src/_storage.ts","../src/target.ts","../src/_target.ts","../src/errors.ts","../src/coachmark.ts","../src/_dev.ts","../src/_scroll.ts","../src/tour.ts"],"sourcesContent":["/** Shared tap() plumbing: zero overhead when idle, handler errors swallowed, auto-detach on abort. */\nexport function createTappers<E extends { readonly type: string }>(signal: AbortSignal) {\n const tappers = new Set<(event: E) => void>();\n\n const emit = (event: E): void => {\n if (tappers.size === 0) return;\n for (const tapper of tappers) {\n try {\n tapper(event);\n } catch {\n // Observability must not affect tour behavior.\n }\n }\n };\n\n const warn = (error: unknown): void => {\n if (tappers.size === 0) return;\n emit({ error, message: error instanceof Error ? error.message : String(error), type: 'warning' } as unknown as E);\n };\n\n const tap = (handler: (event: E) => void, options?: { readonly signal?: AbortSignal }): (() => void) => {\n if (signal.aborted || options?.signal?.aborted) return () => {};\n const detach = (): void => {\n tappers.delete(handler);\n };\n tappers.add(handler);\n signal.addEventListener('abort', detach, { once: true });\n options?.signal?.addEventListener('abort', detach, { once: true });\n\n return detach;\n };\n\n return { clear: () => tappers.clear(), emit, tap, warn };\n}\n","import type { BeaconProgress, BeaconStatus, BeaconStorage } from './types';\n\n/** Prefix keeps beacon records from colliding with an app's other storage keys. */\nconst KEY_PREFIX = '@vielzeug/beacon:';\n\nexport const storageKey = (id: string): string => `${KEY_PREFIX}${id}`;\n\nconst STATUSES = new Set<BeaconStatus>(['active', 'completed', 'dismissed', 'idle', 'paused']);\n\n/**\n * Validates a record read back from storage. Persisted values cross a trust\n * boundary: a stale, hand-edited, or foreign record must not crash a tour.\n */\nexport function parseProgress(value: unknown): BeaconProgress | null {\n if (typeof value !== 'object' || value === null) return null;\n const record = value as Record<string, unknown>;\n if (typeof record.version !== 'number' || !Number.isFinite(record.version)) return null;\n if (typeof record.stepIndex !== 'number' || !Number.isInteger(record.stepIndex) || record.stepIndex < -1) return null;\n if (!STATUSES.has(record.status as BeaconStatus)) return null;\n\n return { status: record.status as BeaconStatus, stepIndex: record.stepIndex, version: record.version };\n}\n\n/** Progress kept for the lifetime of one handle; the fallback when no storage is configured. */\nexport function createMemoryStorage(): BeaconStorage {\n const entries = new Map<string, BeaconProgress>();\n\n return {\n get: (key) => entries.get(key),\n remove: (key) => {\n entries.delete(key);\n },\n set: (key, value) => {\n entries.set(key, value);\n },\n };\n}\n","import type { BeaconRect, BeaconTarget, BeaconTargetResolver } from './types';\n\nconst isElement = (value: unknown): value is Element => typeof Element !== 'undefined' && value instanceof Element;\n\nconst isRect = (value: unknown): value is BeaconRect =>\n typeof value === 'object' &&\n value !== null &&\n typeof (value as BeaconRect).x === 'number' &&\n typeof (value as BeaconRect).y === 'number' &&\n typeof (value as BeaconRect).width === 'number' &&\n typeof (value as BeaconRect).height === 'number';\n\n/** Copies into a plain rect: a DOMRect carries methods and a prototype the contract does not promise. */\nconst normalize = (value: Element | BeaconRect | null): BeaconRect | null => {\n if (value === null) return null;\n if (!isElement(value)) return value;\n const box = value.getBoundingClientRect();\n\n return { height: box.height, width: box.width, x: box.x, y: box.y };\n};\n\n/**\n * Resolves a target to a viewport-space rect, or `null` when it is not available\n * yet. The shape matches `getBoundingClientRect()` and `@vielzeug/orbit`'s\n * `Rect`, so a presentation layer can anchor an orbit positioner with:\n *\n * ```ts\n * const reference = { getBoundingClientRect: () => resolveTarget(step.target) ?? ZERO_RECT };\n * ```\n *\n * Call it on every position update rather than caching the result: a target\n * moves when the page scrolls, and the panel has to follow.\n */\nexport function resolveTarget(target: BeaconTarget): BeaconRect | null {\n if (typeof target === 'string') {\n if (typeof document === 'undefined') return null;\n\n return normalize(document.querySelector(target));\n }\n\n if (typeof target === 'function') {\n const resolved = (target as BeaconTargetResolver)();\n\n return normalize(resolved === null || resolved === undefined ? null : resolved);\n }\n\n return normalize(target);\n}\n\n/** @internal Whether a target currently resolves; decides whether observation is needed. */\nexport function targetAvailable(target: BeaconTarget): boolean {\n return resolveTarget(target) !== null;\n}\n\n/**\n * @internal The live element a target points at, or `null` when it resolves to a\n * bare rect or is not in the document. Layout observation needs the element:\n * a rect has no box to watch, so those targets stay scroll/resize-only.\n */\nexport function targetElement(target: BeaconTarget): Element | null {\n if (typeof target === 'string') {\n return typeof document === 'undefined' ? null : document.querySelector(target);\n }\n\n if (typeof target === 'function') {\n const resolved = (target as BeaconTargetResolver)();\n\n return resolved === null || resolved === undefined || !isElement(resolved) ? null : resolved;\n }\n\n return isElement(target) ? target : null;\n}\n\n/** @internal Static targets never change availability, so there is nothing to observe. */\nexport function isStaticTarget(target: BeaconTarget): boolean {\n return isElement(target) || isRect(target);\n}\n\n/** @internal Value equality for rects, so a layout refresh that changed nothing republishes nothing. */\nexport function sameRect(a: BeaconRect | null, b: BeaconRect | null): boolean {\n if (a === null || b === null) return a === b;\n\n return a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height;\n}\n","import { isStaticTarget, targetAvailable, targetElement } from './target';\nimport type { BeaconTarget } from './types';\n\n/**\n * @internal Calls `onChange` whenever a target's availability flips: element\n * added, removed, or a resolver's result changing. Selector and resolver targets\n * are polled on DOM mutations; static element and rect targets never change\n * availability, so there is nothing to observe and this returns `null`.\n */\nexport function observeTarget(target: BeaconTarget, onChange: () => void, signal: AbortSignal): (() => void) | null {\n if (isStaticTarget(target)) return null;\n if (typeof document === 'undefined' || typeof MutationObserver === 'undefined') return null;\n\n let lastAvailable = targetAvailable(target);\n const observer = new MutationObserver(() => {\n const next = targetAvailable(target);\n if (next !== lastAvailable) {\n lastAvailable = next;\n onChange();\n }\n });\n\n observer.observe(document.documentElement, { attributes: true, childList: true, subtree: true });\n const stop = (): void => {\n observer.disconnect();\n signal.removeEventListener('abort', stop);\n };\n signal.addEventListener('abort', stop, { once: true });\n\n return stop;\n}\n\n/**\n * @internal Calls `onChange` whenever a target's box moves or resizes without a\n * window scroll or resize: content added above it, a grid reflow, a collapsing\n * menu. Watches the resolved element itself and `document.body`, so both the\n * element's own size changes and sibling/parent growth that pushes it around\n * report. Rect targets have no element to watch and return `null`; they stay\n * scroll/resize-only.\n */\nexport function observeTargetLayout(\n target: BeaconTarget,\n onChange: () => void,\n signal: AbortSignal,\n): (() => void) | null {\n const element = targetElement(target);\n\n if (!element || typeof document === 'undefined' || typeof ResizeObserver === 'undefined') return null;\n\n const observer = new ResizeObserver(onChange);\n\n observer.observe(element);\n // The body watch is the sibling-growth catch: adding a tile below a target\n // does not resize the target, but it resizes the page.\n observer.observe(document.body);\n\n const stop = (): void => {\n observer.disconnect();\n signal.removeEventListener('abort', stop);\n };\n signal.addEventListener('abort', stop, { once: true });\n\n return stop;\n}\n","/** Base class for all beacon errors. Use `instanceof BeaconError` to catch any beacon-originated error. */\nexport class BeaconError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when tour or coachmark configuration is invalid, such as an empty `steps` array or duplicate step ids. */\nexport class BeaconConfigError extends BeaconError {}\n\n/** Thrown when a disposed handle is used after {@link BeaconTourHandle.dispose}. */\nexport class BeaconDisposedError extends BeaconError {}\n","import { signal } from '@vielzeug/ripple';\nimport { createTappers } from './_emit';\nimport { createMemoryStorage, parseProgress, storageKey } from './_storage';\nimport { observeTarget, observeTargetLayout } from './_target';\nimport { BeaconConfigError, BeaconDisposedError } from './errors';\nimport { resolveTarget, sameRect } from './target';\nimport type {\n BeaconCoachmarkConfig,\n BeaconCoachmarkEvent,\n BeaconCoachmarkHandle,\n BeaconCurrentStep,\n BeaconProgress,\n BeaconStep,\n} from './types';\n\n/**\n * Creates a coachmark: a single contextual hint anchored to one target, shown\n * the first time a user reaches that feature and dismissed permanently after.\n * The same \"explain this button once\" pattern that makes tours worth keeping\n * after launch week, without sequencing anything.\n *\n * Like tours, coachmarks version: bumping `version` re-shows a hint users\n * already saw, which covers a button whose meaning changed.\n */\nexport function createCoachmark(config: BeaconCoachmarkConfig): BeaconCoachmarkHandle {\n if (!config.id) throw new BeaconConfigError('createCoachmark: \"id\" must be a non-empty string');\n\n const version = config.version ?? 1;\n const autoShow = config.autoShow ?? true;\n const storage = config.storage ?? createMemoryStorage();\n const key = storageKey(config.id);\n\n const controller = new AbortController();\n const { signal: disposal } = controller;\n const { emit, warn: warnTap, tap, clear: clearTappers } = createTappers<BeaconCoachmarkEvent>(disposal);\n\n const eligible = signal(true);\n\n const step: BeaconStep = {\n data: config.data,\n description: config.description,\n id: config.id,\n placement: config.placement ?? 'auto',\n presentation: config.presentation ?? 'auto',\n target: config.target,\n title: config.title,\n };\n\n const HIDDEN: BeaconCurrentStep = {\n placement: step.placement ?? 'auto',\n presentation: step.presentation ?? 'auto',\n rect: null,\n step: null,\n stepIndex: 0,\n totalSteps: 0,\n };\n\n const current = signal<BeaconCurrentStep>(HIDDEN);\n\n let stopWaiting: (() => void) | null = null;\n let loadSequence = 0;\n\n const disposedError = (): BeaconDisposedError => new BeaconDisposedError('This coachmark handle has been disposed.');\n const guard = (): void => {\n if (disposal.aborted) throw disposedError();\n };\n\n const persistSeen = (): void => {\n const record: BeaconProgress = { status: 'completed', stepIndex: 0, version };\n\n try {\n const result = storage.set(key, record) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n };\n\n const stopWaitingForTarget = (): void => {\n stopWaiting?.();\n stopWaiting = null;\n };\n\n const showInternal = (): void => {\n guard();\n if (!eligible.peek() || current.peek().step !== null) return;\n\n const publish = (): void => {\n current.value = { ...HIDDEN, rect: resolveTarget(config.target), step };\n emit({ type: 'coachmark:show' });\n watchLayout();\n };\n\n // Keep the rect honest while the hint is up: scroll and resize move the\n // target, the target's box can resize, and page growth can push it around;\n // a target that leaves the document drops the rect to null.\n const watchLayout = (): void => {\n const onLayout = (): void => {\n const rect = resolveTarget(config.target);\n if (sameRect(rect, current.peek().rect)) return;\n current.value = { ...current.peek(), rect };\n };\n\n window.addEventListener('scroll', onLayout, { passive: true });\n window.addEventListener('resize', onLayout);\n const stopObserver = observeTargetLayout(config.target, onLayout, disposal);\n const stop = (): void => {\n window.removeEventListener('scroll', onLayout);\n window.removeEventListener('resize', onLayout);\n stopObserver?.();\n };\n disposal.addEventListener('abort', stop, { once: true });\n stopWaiting = (): void => {\n stop();\n stopWaiting = null;\n };\n };\n\n if (resolveTarget(config.target)) {\n publish();\n return;\n }\n\n // Target not mounted yet: wait for it so the hint appears when the user reaches the feature.\n let waiting = true;\n let stopObserver: (() => void) | null = null;\n stopWaiting = (): void => {\n waiting = false;\n stopObserver?.();\n stopObserver = null;\n };\n stopObserver = observeTarget(\n config.target,\n () => {\n if (!waiting || !eligible.peek()) return;\n stopWaitingForTarget();\n publish();\n },\n disposal,\n );\n emit({ type: 'target-waiting' });\n };\n\n // Boot: read the seen-record, then optionally auto-show.\n const sequence = ++loadSequence;\n const applyStored = (raw: unknown): void => {\n if (sequence !== loadSequence || disposal.aborted) return;\n const stored = parseProgress(raw);\n eligible.value = !(stored && stored.version >= version && stored.status === 'completed');\n if (eligible.peek() && autoShow) {\n queueMicrotask(() => {\n if (!disposal.aborted) showInternal();\n });\n }\n };\n\n try {\n const loaded = storage.get(key) as unknown;\n if (loaded instanceof Promise) loaded.then(applyStored, (error: unknown) => warnTap(error));\n else applyStored(loaded);\n } catch (error) {\n warnTap(error);\n }\n\n return {\n current,\n dismiss(): void {\n guard();\n stopWaitingForTarget();\n current.value = HIDDEN;\n eligible.value = false;\n persistSeen();\n emit({ type: 'coachmark:dismiss' });\n },\n disposalSignal: disposal,\n dispose(): void {\n if (disposal.aborted) return;\n emit({ type: 'dispose' });\n stopWaitingForTarget();\n controller.abort();\n clearTappers();\n },\n get disposed(): boolean {\n return disposal.aborted;\n },\n eligible,\n hide(): void {\n guard();\n stopWaitingForTarget();\n current.value = HIDDEN;\n },\n id: config.id,\n reset(): void {\n guard();\n try {\n const result = storage.remove(key) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n eligible.value = true;\n },\n show: showInternal,\n tap,\n [Symbol.dispose](): void {\n this.dispose();\n },\n };\n}\n","const isDev = !(globalThis as { __BEACON_PROD__?: boolean }).__BEACON_PROD__;\n\n/** @internal @security Messages may include user-supplied data. */\nexport function warn(msg: string): void {\n if (isDev) console.warn(`[@vielzeug/beacon] ${msg}`);\n}\n\n/** @internal Multi-step development-only logic; skipped entirely in production builds. */\nexport function devOnly(fn: () => void): void {\n if (isDev) fn();\n}\n","import { resolveTarget } from './target';\nimport type { BeaconTarget } from './types';\n\n/** Options for {@link scrollTargetIntoView}. */\nexport interface ScrollIntoViewOptions {\n /** Scroll behavior. Default `'smooth'` when the user has not requested reduced motion, else `'auto'`. */\n readonly behavior?: 'auto' | 'instant' | 'smooth';\n /** Pixels reserved at the top of the viewport for sticky headers. Number or a function read at scroll time. Default `0`. */\n readonly offset?: number | (() => number);\n}\n\nconst prefersReducedMotion = (): boolean =>\n typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches;\n\n/**\n * Centers a target in the viewport, keeping it clear of a sticky header.\n * Returns whether the target was found. No-op without a DOM.\n */\nexport function scrollTargetIntoView(target: BeaconTarget, options: ScrollIntoViewOptions = {}): boolean {\n if (typeof window === 'undefined' || typeof document === 'undefined') return false;\n\n const before = resolveTarget(target);\n if (!before) return false;\n\n const behavior = options.behavior ?? (prefersReducedMotion() ? 'auto' : 'smooth');\n const viewportHeight = window.innerHeight || document.documentElement.clientHeight;\n const reserved = typeof options.offset === 'function' ? options.offset() : (options.offset ?? 0);\n // The rect is viewport-space; scrolling answers in document space.\n const documentTop = before.y + (globalThis.scrollY ?? 0);\n\n // Center first: the cheapest correct default for tall and short targets alike.\n const idealTop = documentTop - (viewportHeight - before.height) / 2;\n // A sticky header covers the top `reserved` px: when the target's top edge\n // would land inside that band, sit it just below the reserved area instead.\n // One scrollTo: a second smooth scroll would interrupt the first mid-flight.\n const correctedTop = reserved > 0 && documentTop - idealTop < reserved ? documentTop - reserved : idealTop;\n const maxScroll = Math.max(0, document.documentElement.scrollHeight - viewportHeight);\n const clampedTop = Math.min(Math.max(0, correctedTop), maxScroll);\n\n window.scrollTo({ behavior, top: clampedTop });\n\n return true;\n}\n","import { signal } from '@vielzeug/ripple';\nimport { devOnly, warn } from './_dev';\nimport { createTappers } from './_emit';\nimport { scrollTargetIntoView } from './_scroll';\nimport { createMemoryStorage, parseProgress, storageKey } from './_storage';\nimport { observeTarget, observeTargetLayout } from './_target';\nimport { BeaconConfigError, BeaconDisposedError } from './errors';\nimport { resolveTarget, sameRect, targetAvailable } from './target';\nimport type {\n BeaconCurrentStep,\n BeaconProgress,\n BeaconStatus,\n BeaconTarget,\n BeaconTourConfig,\n BeaconTourEvent,\n BeaconTourHandle,\n} from './types';\n\nconst validateConfig = (config: BeaconTourConfig): void => {\n if (!config.id) throw new BeaconConfigError('createTour: \"id\" must be a non-empty string');\n if (!Array.isArray(config.steps) || config.steps.length === 0) {\n throw new BeaconConfigError(`createTour: tour \"${config.id}\" must have at least one step`);\n }\n\n const seen = new Set<string>();\n for (const step of config.steps) {\n if (!step.id) throw new BeaconConfigError(`createTour: every step of tour \"${config.id}\" needs a non-empty id`);\n if (seen.has(step.id)) {\n throw new BeaconConfigError(`createTour: duplicate step id \"${step.id}\" in tour \"${config.id}\"`);\n }\n seen.add(step.id);\n }\n};\n\n/**\n * Creates a guided tour: a sequential, resumable walkthrough over the app's own\n * DOM. The engine owns step order, target waiting, persistence, and events; a\n * presentation layer (refine's tour components or the app's markup) renders\n * `current` wherever it likes.\n *\n * Progress persists under the tour's id. A stored record written under an older\n * `version` makes the tour eligible again, which is how feature announcements\n * re-reach users who finished the original tour.\n */\nexport function createTour(config: BeaconTourConfig): BeaconTourHandle {\n validateConfig(config);\n\n const version = config.version ?? 1;\n const targetTimeoutMs = config.targetTimeoutMs ?? Number.POSITIVE_INFINITY;\n const autoScroll = config.autoScroll ?? true;\n const storage = config.storage ?? createMemoryStorage();\n const key = storageKey(config.id);\n\n const controller = new AbortController();\n const { signal: disposal } = controller;\n const { emit, warn: warnTap, tap, clear: clearTappers } = createTappers<BeaconTourEvent>(disposal);\n\n const status = signal<BeaconStatus>('idle');\n const eligible = signal(true);\n const current = signal<BeaconCurrentStep>({\n placement: config.placement ?? 'auto',\n presentation: config.presentation ?? 'auto',\n rect: null,\n step: null,\n stepIndex: -1,\n totalSteps: config.steps.length,\n });\n\n let stopWaiting: (() => void) | null = null;\n let loadSequence = 0;\n\n const disposedError = (): BeaconDisposedError => new BeaconDisposedError('This tour handle has been disposed.');\n const guard = (): void => {\n if (disposal.aborted) throw disposedError();\n };\n\n const persist = (): void => {\n const record: BeaconProgress = { status: status.peek(), stepIndex: current.peek().stepIndex, version };\n\n try {\n const result = storage.set(key, record) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n };\n\n const clearPersisted = (): void => {\n try {\n const result = storage.remove(key) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n };\n\n const setStatus = (next: BeaconStatus): void => {\n if (status.peek() === next) return;\n status.value = next;\n persist();\n emit({ status: next, type: 'status-change' });\n };\n\n const stopTargetWatch = (): void => {\n stopWaiting?.();\n stopWaiting = null;\n };\n\n /** Re-reads the active step's rect; republishes only when it actually moved. */\n const refreshActiveRect = (): void => {\n const step = current.peek().step;\n if (!step?.target) return;\n const rect = resolveTarget(step.target);\n if (sameRect(rect, current.peek().rect)) return;\n current.value = { ...current.peek(), rect };\n };\n\n /**\n * Keeps the active step's rect honest for as long as the step is visible:\n * scroll and resize move the target, the target's own box can resize, and\n * content added elsewhere on the page can push it around without either —\n * all of which refresh the rect. A target that leaves the document\n * (collapsed menu, route change) drops the rect to `null` instead of\n * anchoring the card to a ghost. The card's positioner re-measures on the\n * repaint the rect write triggers, so no extra listener is needed there.\n */\n const watchActiveTarget = (target: BeaconTarget): (() => void) => {\n let stopped = false;\n const onLayout = (): void => {\n if (!stopped) refreshActiveRect();\n };\n\n window.addEventListener('scroll', onLayout, { passive: true });\n window.addEventListener('resize', onLayout);\n const stopObserver = observeTarget(target, onLayout, disposal);\n const stopLayout = observeTargetLayout(target, onLayout, disposal);\n const stop = (): void => {\n if (stopped) return;\n stopped = true;\n window.removeEventListener('scroll', onLayout);\n window.removeEventListener('resize', onLayout);\n stopObserver?.();\n stopLayout?.();\n };\n disposal.addEventListener('abort', stop, { once: true });\n\n return stop;\n };\n\n /** Publishes `index` as the visible step: completes the previous step, emits step:start, scrolls. */\n const publishStep = (index: number): void => {\n stopTargetWatch();\n const step = config.steps[index] ?? null;\n const previous = current.peek().step;\n if (previous && previous !== step) emit({ index: current.peek().stepIndex, step: previous, type: 'step:complete' });\n\n current.value = {\n placement: step?.placement ?? config.placement ?? 'auto',\n presentation: step?.presentation ?? config.presentation ?? 'auto',\n rect: step?.target ? resolveTarget(step.target) : null,\n step,\n stepIndex: index,\n totalSteps: config.steps.length,\n };\n\n if (step) {\n emit({ index, step, type: 'step:start' });\n if (autoScroll && step.target) scrollTargetIntoView(step.target, { offset: config.scrollOffset });\n if (step.target) stopWaiting = watchActiveTarget(step.target);\n }\n };\n\n const finishInternal = (reason: 'finish' | 'skip'): void => {\n stopTargetWatch();\n const step = current.peek().step;\n if (step) emit({ index: current.peek().stepIndex, step, type: 'step:complete' });\n current.value = { ...current.peek(), rect: null, step: null, stepIndex: -1 };\n setStatus('completed');\n emit({ reason, type: 'tour:complete' });\n };\n\n /**\n * Makes `index` the active step, waiting for its target when it is not on\n * screen yet (lazy route, closed dialog) and reporting `target-waiting` so a\n * presentation can say \"continue when you're ready\" instead of looking\n * frozen. A step without a target (intro or outro) and a `targetTimeoutMs`\n * of `0` publish immediately.\n */\n const activateStep = (index: number): void => {\n stopTargetWatch();\n const step = config.steps[index];\n if (!step) return;\n\n if (!step.target || targetTimeoutMs === 0 || targetAvailable(step.target)) {\n publishStep(index);\n return;\n }\n\n let waiting = true;\n let timer: ReturnType<typeof setTimeout> | null = null;\n let stopObserver: (() => void) | null = null;\n const target = step.target;\n stopWaiting = (): void => {\n waiting = false;\n stopObserver?.();\n stopObserver = null;\n if (timer !== null) {\n clearTimeout(timer);\n timer = null;\n }\n };\n\n stopObserver = observeTarget(\n target,\n () => {\n if (waiting && targetAvailable(target)) {\n publishStep(index);\n }\n },\n disposal,\n );\n\n if (!stopObserver) {\n devOnly(() => warn(`step \"${step.id}\" of tour \"${config.id}\" has a static target that is not in the document`));\n }\n\n emit({ index, message: `Waiting for step \"${step.id}\" to become visible.`, step, type: 'target-waiting' });\n\n if (Number.isFinite(targetTimeoutMs)) {\n timer = setTimeout(() => {\n if (!waiting) return;\n stopTargetWatch();\n emit({\n message: `Skipped step \"${step.id}\": its target did not appear within ${targetTimeoutMs}ms.`,\n type: 'target-missing',\n });\n if (index + 1 < config.steps.length) activateStep(index + 1);\n else finishInternal('finish');\n }, targetTimeoutMs);\n }\n };\n\n const advanceTo = (index: number): void => {\n if (index < 0) return;\n if (index >= config.steps.length) {\n finishInternal('finish');\n return;\n }\n if (status.peek() !== 'active') setStatus('active');\n activateStep(index);\n };\n\n const startInternal = (): void => {\n guard();\n const s = status.peek();\n if (s === 'completed' || s === 'dismissed' || s === 'active') return;\n const resumeAt = Math.max(0, current.peek().stepIndex);\n setStatus('active');\n activateStep(resumeAt);\n };\n\n // Boot: load persisted progress, then decide eligibility and optional autoStart.\n const sequence = ++loadSequence;\n const applyStored = (raw: unknown): void => {\n if (sequence !== loadSequence || disposal.aborted) return;\n const stored = parseProgress(raw);\n\n if (stored && stored.version >= version) {\n if (stored.status === 'completed' || stored.status === 'dismissed') {\n status.value = stored.status;\n eligible.value = false;\n return;\n }\n if (stored.status === 'active' || stored.status === 'paused') {\n status.value = 'paused';\n current.value = { ...current.peek(), stepIndex: Math.min(stored.stepIndex, config.steps.length - 1) };\n }\n }\n // Fresh, paused, or superseded by a newer version: eligible.\n eligible.value = true;\n if (config.autoStart) {\n queueMicrotask(() => {\n if (!disposal.aborted) startInternal();\n });\n }\n };\n\n try {\n const loaded = storage.get(key) as unknown;\n if (loaded instanceof Promise) loaded.then(applyStored, (error: unknown) => warnTap(error));\n else applyStored(loaded);\n } catch (error) {\n warnTap(error);\n }\n\n return {\n back(): void {\n guard();\n advanceTo(current.peek().stepIndex - 1);\n },\n current,\n dismiss(): void {\n guard();\n if (status.peek() === 'completed' || status.peek() === 'dismissed') return;\n stopTargetWatch();\n current.value = { ...current.peek(), rect: null, step: null, stepIndex: -1 };\n setStatus('dismissed');\n emit({ type: 'tour:dismiss' });\n },\n disposalSignal: disposal,\n dispose(): void {\n if (disposal.aborted) return;\n emit({ type: 'dispose' });\n stopTargetWatch();\n controller.abort();\n clearTappers();\n },\n get disposed(): boolean {\n return disposal.aborted;\n },\n eligible,\n finish(): void {\n guard();\n if (status.peek() === 'completed') return;\n finishInternal('finish');\n },\n goto(step: number | string): void {\n guard();\n const index = typeof step === 'number' ? step : config.steps.findIndex((candidate) => candidate.id === step);\n if (index < 0 || index >= config.steps.length) {\n warn(`goto: step \"${String(step)}\" is not part of tour \"${config.id}\"`);\n return;\n }\n advanceTo(index);\n },\n id: config.id,\n next(): void {\n guard();\n advanceTo(current.peek().stepIndex + 1);\n },\n pause(): void {\n guard();\n if (status.peek() !== 'active') return;\n stopTargetWatch();\n current.value = { ...current.peek(), rect: null };\n setStatus('paused');\n },\n reset(): void {\n guard();\n stopTargetWatch();\n clearPersisted();\n current.value = {\n placement: config.placement ?? 'auto',\n presentation: config.presentation ?? 'auto',\n rect: null,\n step: null,\n stepIndex: -1,\n totalSteps: config.steps.length,\n };\n status.value = 'idle';\n eligible.value = true;\n emit({ status: 'idle', type: 'status-change' });\n },\n skip(): void {\n guard();\n if (status.peek() === 'completed' || status.peek() === 'dismissed') return;\n stopTargetWatch();\n current.value = { ...current.peek(), rect: null, step: null, stepIndex: -1 };\n setStatus('dismissed');\n emit({ reason: 'skip', type: 'tour:complete' });\n },\n start: startInternal,\n status,\n steps: config.steps,\n tap,\n [Symbol.dispose](): void {\n this.dispose();\n },\n };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"beacon.js","names":["tappers","tapper","event","error","signal","options","handler","KEY_PREFIX","id","STATUSES","value","record","entries","key","box","target","resolved","a","b","lastAvailable","observer","next","onChange","element","message","opts","config","version","autoShow","storage","controller","disposal","warnTap","clearTappers","eligible","step","HIDDEN","current","loadSequence","result","emit","rect","stopObserver","waiting","sequence","stored","raw","loaded","before","behavior","viewportHeight","reserved","documentTop","idealTop","correctedTop","maxScroll","clampedTop","seen","targetTimeoutMs","autoScroll","status","stopped","stopLayout","index","previous","timer","s","resumeAt","candidate"],"sources":["../src/_emit.ts","../src/_storage.ts","../src/target.ts","../src/_target.ts","../src/errors.ts","../src/coachmark.ts","../src/_dev.ts","../src/_scroll.ts","../src/tour.ts"],"sourcesContent":["/** Shared tap() plumbing: zero overhead when idle, handler errors swallowed, auto-detach on abort. */\nexport function createTappers<E extends { readonly type: string }>(signal: AbortSignal) {\n const tappers = new Set<(event: E) => void>();\n\n const emit = (event: E): void => {\n if (tappers.size === 0) return;\n for (const tapper of tappers) {\n try {\n tapper(event);\n } catch {\n // Observability must not affect tour behavior.\n }\n }\n };\n\n const warn = (error: unknown): void => {\n if (tappers.size === 0) return;\n emit({ error, message: error instanceof Error ? error.message : String(error), type: 'warning' } as unknown as E);\n };\n\n const tap = (handler: (event: E) => void, options?: { readonly signal?: AbortSignal }): (() => void) => {\n if (signal.aborted || options?.signal?.aborted) return () => {};\n const detach = (): void => {\n tappers.delete(handler);\n };\n tappers.add(handler);\n signal.addEventListener('abort', detach, { once: true });\n options?.signal?.addEventListener('abort', detach, { once: true });\n\n return detach;\n };\n\n return { clear: () => tappers.clear(), emit, tap, warn };\n}\n","import type { BeaconProgress, BeaconStatus, BeaconStorage } from './types';\n\n/** Prefix keeps beacon records from colliding with an app's other storage keys. */\nconst KEY_PREFIX = '@vielzeug/beacon:';\n\nexport const storageKey = (id: string): string => `${KEY_PREFIX}${id}`;\n\nconst STATUSES = new Set<BeaconStatus>(['active', 'completed', 'dismissed', 'idle', 'paused']);\n\n/**\n * Validates a record read back from storage. Persisted values cross a trust\n * boundary: a stale, hand-edited, or foreign record must not crash a tour.\n */\nexport function parseProgress(value: unknown): BeaconProgress | null {\n if (typeof value !== 'object' || value === null) return null;\n const record = value as Record<string, unknown>;\n if (typeof record.version !== 'number' || !Number.isFinite(record.version)) return null;\n if (typeof record.stepIndex !== 'number' || !Number.isInteger(record.stepIndex) || record.stepIndex < -1) return null;\n if (!STATUSES.has(record.status as BeaconStatus)) return null;\n\n return { status: record.status as BeaconStatus, stepIndex: record.stepIndex, version: record.version };\n}\n\n/** Progress kept for the lifetime of one handle; the fallback when no storage is configured. */\nexport function createMemoryStorage(): BeaconStorage {\n const entries = new Map<string, BeaconProgress>();\n\n return {\n get: (key) => entries.get(key),\n remove: (key) => {\n entries.delete(key);\n },\n set: (key, value) => {\n entries.set(key, value);\n },\n };\n}\n","import type { BeaconRect, BeaconTarget, BeaconTargetResolver } from './types';\n\nconst isElement = (value: unknown): value is Element => typeof Element !== 'undefined' && value instanceof Element;\n\nconst isRect = (value: unknown): value is BeaconRect =>\n typeof value === 'object' &&\n value !== null &&\n typeof (value as BeaconRect).x === 'number' &&\n typeof (value as BeaconRect).y === 'number' &&\n typeof (value as BeaconRect).width === 'number' &&\n typeof (value as BeaconRect).height === 'number';\n\n/** Copies into a plain rect: a DOMRect carries methods and a prototype the contract does not promise. */\nconst normalize = (value: Element | BeaconRect | null): BeaconRect | null => {\n if (value === null) return null;\n if (!isElement(value)) return value;\n const box = value.getBoundingClientRect();\n\n return { height: box.height, width: box.width, x: box.x, y: box.y };\n};\n\n/**\n * Resolves a target to a viewport-space rect, or `null` when it is not available\n * yet. The shape matches `getBoundingClientRect()` and `@vielzeug/orbit`'s\n * `Rect`, so a presentation layer can anchor an orbit positioner with:\n *\n * ```ts\n * const reference = { getBoundingClientRect: () => resolveTarget(step.target) ?? ZERO_RECT };\n * ```\n *\n * Call it on every position update rather than caching the result: a target\n * moves when the page scrolls, and the panel has to follow.\n */\nexport function resolveTarget(target: BeaconTarget): BeaconRect | null {\n if (typeof target === 'string') {\n if (typeof document === 'undefined') return null;\n\n return normalize(document.querySelector(target));\n }\n\n if (typeof target === 'function') {\n const resolved = (target as BeaconTargetResolver)();\n\n return normalize(resolved === null || resolved === undefined ? null : resolved);\n }\n\n return normalize(target);\n}\n\n/** @internal Whether a target currently resolves; decides whether observation is needed. */\nexport function targetAvailable(target: BeaconTarget): boolean {\n return resolveTarget(target) !== null;\n}\n\n/**\n * @internal The live element a target points at, or `null` when it resolves to a\n * bare rect or is not in the document. Layout observation needs the element:\n * a rect has no box to watch, so those targets stay scroll/resize-only.\n */\nexport function targetElement(target: BeaconTarget): Element | null {\n if (typeof target === 'string') {\n return typeof document === 'undefined' ? null : document.querySelector(target);\n }\n\n if (typeof target === 'function') {\n const resolved = (target as BeaconTargetResolver)();\n\n return resolved === null || resolved === undefined || !isElement(resolved) ? null : resolved;\n }\n\n return isElement(target) ? target : null;\n}\n\n/** @internal Static targets never change availability, so there is nothing to observe. */\nexport function isStaticTarget(target: BeaconTarget): boolean {\n return isElement(target) || isRect(target);\n}\n\n/** @internal Value equality for rects, so a layout refresh that changed nothing republishes nothing. */\nexport function sameRect(a: BeaconRect | null, b: BeaconRect | null): boolean {\n if (a === null || b === null) return a === b;\n\n return a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height;\n}\n","import { isStaticTarget, targetAvailable, targetElement } from './target';\nimport type { BeaconTarget } from './types';\n\n/**\n * @internal Calls `onChange` whenever a target's availability flips: element\n * added, removed, or a resolver's result changing. Selector and resolver targets\n * are polled on DOM mutations; static element and rect targets never change\n * availability, so there is nothing to observe and this returns `null`.\n */\nexport function observeTarget(target: BeaconTarget, onChange: () => void, signal: AbortSignal): (() => void) | null {\n if (isStaticTarget(target)) return null;\n if (typeof document === 'undefined' || typeof MutationObserver === 'undefined') return null;\n\n let lastAvailable = targetAvailable(target);\n const observer = new MutationObserver(() => {\n const next = targetAvailable(target);\n if (next !== lastAvailable) {\n lastAvailable = next;\n onChange();\n }\n });\n\n observer.observe(document.documentElement, { attributes: true, childList: true, subtree: true });\n const stop = (): void => {\n observer.disconnect();\n signal.removeEventListener('abort', stop);\n };\n signal.addEventListener('abort', stop, { once: true });\n\n return stop;\n}\n\n/**\n * @internal Calls `onChange` whenever a target's box moves or resizes without a\n * window scroll or resize: content added above it, a grid reflow, a collapsing\n * menu. Watches the resolved element itself and `document.body`, so both the\n * element's own size changes and sibling/parent growth that pushes it around\n * report. Rect targets have no element to watch and return `null`; they stay\n * scroll/resize-only.\n */\nexport function observeTargetLayout(\n target: BeaconTarget,\n onChange: () => void,\n signal: AbortSignal,\n): (() => void) | null {\n const element = targetElement(target);\n\n if (!element || typeof document === 'undefined' || typeof ResizeObserver === 'undefined') return null;\n\n const observer = new ResizeObserver(onChange);\n\n observer.observe(element);\n // The body watch is the sibling-growth catch: adding a tile below a target\n // does not resize the target, but it resizes the page.\n observer.observe(document.body);\n\n const stop = (): void => {\n observer.disconnect();\n signal.removeEventListener('abort', stop);\n };\n signal.addEventListener('abort', stop, { once: true });\n\n return stop;\n}\n","/** Base class for all beacon errors. Use `instanceof BeaconError` to catch any beacon-originated error. */\nexport class BeaconError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when tour or coachmark configuration is invalid, such as an empty `steps` array or duplicate step ids. */\nexport class BeaconConfigError extends BeaconError {}\n\n/** Thrown when a disposed handle is used after {@link BeaconTourHandle.dispose}. */\nexport class BeaconDisposedError extends BeaconError {}\n","import { signal } from '@vielzeug/ripple';\nimport { createTappers } from './_emit';\nimport { createMemoryStorage, parseProgress, storageKey } from './_storage';\nimport { observeTarget, observeTargetLayout } from './_target';\nimport { BeaconConfigError, BeaconDisposedError } from './errors';\nimport { resolveTarget, sameRect } from './target';\nimport type {\n BeaconCoachmarkConfig,\n BeaconCoachmarkEvent,\n BeaconCoachmarkHandle,\n BeaconCurrentStep,\n BeaconProgress,\n BeaconStep,\n} from './types';\n\n/**\n * Creates a coachmark: a single contextual hint anchored to one target, shown\n * the first time a user reaches that feature and dismissed permanently after.\n * The same \"explain this button once\" pattern that makes tours worth keeping\n * after launch week, without sequencing anything.\n *\n * Like tours, coachmarks version: bumping `version` re-shows a hint users\n * already saw, which covers a button whose meaning changed.\n */\nexport function createCoachmark(config: BeaconCoachmarkConfig): BeaconCoachmarkHandle {\n if (!config.id) throw new BeaconConfigError('createCoachmark: \"id\" must be a non-empty string');\n\n const version = config.version ?? 1;\n const autoShow = config.autoShow ?? true;\n const storage = config.storage ?? createMemoryStorage();\n const key = storageKey(config.id);\n\n const controller = new AbortController();\n const { signal: disposal } = controller;\n const { emit, warn: warnTap, tap, clear: clearTappers } = createTappers<BeaconCoachmarkEvent>(disposal);\n\n const eligible = signal(true);\n\n const step: BeaconStep = {\n data: config.data,\n description: config.description,\n id: config.id,\n placement: config.placement ?? 'auto',\n presentation: config.presentation ?? 'auto',\n target: config.target,\n title: config.title,\n };\n\n const HIDDEN: BeaconCurrentStep = {\n placement: step.placement ?? 'auto',\n presentation: step.presentation ?? 'auto',\n rect: null,\n step: null,\n stepIndex: 0,\n totalSteps: 0,\n };\n\n const current = signal<BeaconCurrentStep>(HIDDEN);\n\n let stopWaiting: (() => void) | null = null;\n let loadSequence = 0;\n\n const disposedError = (): BeaconDisposedError => new BeaconDisposedError('This coachmark handle has been disposed.');\n const guard = (): void => {\n if (disposal.aborted) throw disposedError();\n };\n\n const persistSeen = (): void => {\n const record: BeaconProgress = { status: 'completed', stepIndex: 0, version };\n\n try {\n const result = storage.set(key, record) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n };\n\n const stopWaitingForTarget = (): void => {\n stopWaiting?.();\n stopWaiting = null;\n };\n\n const showInternal = (): void => {\n guard();\n if (!eligible.peek() || current.peek().step !== null) return;\n\n const publish = (): void => {\n current.value = { ...HIDDEN, rect: resolveTarget(config.target), step };\n emit({ type: 'coachmark:show' });\n watchLayout();\n };\n\n // Keep the rect honest while the hint is up: scroll and resize move the\n // target, the target's box can resize, and page growth can push it around;\n // a target that leaves the document drops the rect to null.\n const watchLayout = (): void => {\n const onLayout = (): void => {\n const rect = resolveTarget(config.target);\n if (sameRect(rect, current.peek().rect)) return;\n current.value = { ...current.peek(), rect };\n };\n\n window.addEventListener('scroll', onLayout, { passive: true });\n window.addEventListener('resize', onLayout);\n const stopObserver = observeTargetLayout(config.target, onLayout, disposal);\n const stop = (): void => {\n window.removeEventListener('scroll', onLayout);\n window.removeEventListener('resize', onLayout);\n stopObserver?.();\n };\n disposal.addEventListener('abort', stop, { once: true });\n stopWaiting = (): void => {\n stop();\n stopWaiting = null;\n };\n };\n\n if (resolveTarget(config.target)) {\n publish();\n return;\n }\n\n // Target not mounted yet: wait for it so the hint appears when the user reaches the feature.\n let waiting = true;\n let stopObserver: (() => void) | null = null;\n stopWaiting = (): void => {\n waiting = false;\n stopObserver?.();\n stopObserver = null;\n };\n stopObserver = observeTarget(\n config.target,\n () => {\n if (!waiting || !eligible.peek()) return;\n stopWaitingForTarget();\n publish();\n },\n disposal,\n );\n emit({ type: 'target-waiting' });\n };\n\n // Boot: read the seen-record, then optionally auto-show.\n const sequence = ++loadSequence;\n const applyStored = (raw: unknown): void => {\n if (sequence !== loadSequence || disposal.aborted) return;\n const stored = parseProgress(raw);\n eligible.value = !(stored && stored.version >= version && stored.status === 'completed');\n if (eligible.peek() && autoShow) {\n queueMicrotask(() => {\n if (!disposal.aborted) showInternal();\n });\n }\n };\n\n try {\n const loaded = storage.get(key) as unknown;\n if (loaded instanceof Promise) loaded.then(applyStored, (error: unknown) => warnTap(error));\n else applyStored(loaded);\n } catch (error) {\n warnTap(error);\n }\n\n return {\n current,\n dismiss(): void {\n guard();\n stopWaitingForTarget();\n current.value = HIDDEN;\n eligible.value = false;\n persistSeen();\n emit({ type: 'coachmark:dismiss' });\n },\n disposalSignal: disposal,\n dispose(): void {\n if (disposal.aborted) return;\n emit({ type: 'dispose' });\n stopWaitingForTarget();\n controller.abort();\n clearTappers();\n },\n get disposed(): boolean {\n return disposal.aborted;\n },\n eligible,\n hide(): void {\n guard();\n stopWaitingForTarget();\n current.value = HIDDEN;\n },\n id: config.id,\n reset(): void {\n guard();\n try {\n const result = storage.remove(key) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n eligible.value = true;\n },\n show: showInternal,\n tap,\n [Symbol.dispose](): void {\n this.dispose();\n },\n };\n}\n","const isDev = !(globalThis as { __BEACON_PROD__?: boolean }).__BEACON_PROD__;\n\n/** @internal @security Messages may include user-supplied data. */\nexport function warn(msg: string): void {\n if (isDev) console.warn(`[@vielzeug/beacon] ${msg}`);\n}\n\n/** @internal Multi-step development-only logic; skipped entirely in production builds. */\nexport function devOnly(fn: () => void): void {\n if (isDev) fn();\n}\n","import { resolveTarget } from './target';\nimport type { BeaconTarget } from './types';\n\n/** Options for {@link scrollTargetIntoView}. */\nexport interface ScrollIntoViewOptions {\n /** Scroll behavior. Default `'smooth'` when the user has not requested reduced motion, else `'auto'`. */\n readonly behavior?: 'auto' | 'instant' | 'smooth';\n /** Pixels reserved at the top of the viewport for sticky headers. Number or a function read at scroll time. Default `0`. */\n readonly offset?: number | (() => number);\n}\n\nconst prefersReducedMotion = (): boolean =>\n typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches;\n\n/**\n * Centers a target in the viewport, keeping it clear of a sticky header.\n * Returns whether the target was found. No-op without a DOM.\n */\nexport function scrollTargetIntoView(target: BeaconTarget, options: ScrollIntoViewOptions = {}): boolean {\n if (typeof window === 'undefined' || typeof document === 'undefined') return false;\n\n const before = resolveTarget(target);\n if (!before) return false;\n\n const behavior = options.behavior ?? (prefersReducedMotion() ? 'auto' : 'smooth');\n const viewportHeight = window.innerHeight || document.documentElement.clientHeight;\n const reserved = typeof options.offset === 'function' ? options.offset() : (options.offset ?? 0);\n // The rect is viewport-space; scrolling answers in document space.\n const documentTop = before.y + (globalThis.scrollY ?? 0);\n\n // Center first: the cheapest correct default for tall and short targets alike.\n const idealTop = documentTop - (viewportHeight - before.height) / 2;\n // A sticky header covers the top `reserved` px: when the target's top edge\n // would land inside that band, sit it just below the reserved area instead.\n // One scrollTo: a second smooth scroll would interrupt the first mid-flight.\n const correctedTop = reserved > 0 && documentTop - idealTop < reserved ? documentTop - reserved : idealTop;\n const maxScroll = Math.max(0, document.documentElement.scrollHeight - viewportHeight);\n const clampedTop = Math.min(Math.max(0, correctedTop), maxScroll);\n\n window.scrollTo({ behavior, top: clampedTop });\n\n return true;\n}\n","import { signal } from '@vielzeug/ripple';\nimport { devOnly, warn } from './_dev';\nimport { createTappers } from './_emit';\nimport { scrollTargetIntoView } from './_scroll';\nimport { createMemoryStorage, parseProgress, storageKey } from './_storage';\nimport { observeTarget, observeTargetLayout } from './_target';\nimport { BeaconConfigError, BeaconDisposedError } from './errors';\nimport { resolveTarget, sameRect, targetAvailable } from './target';\nimport type {\n BeaconCurrentStep,\n BeaconProgress,\n BeaconStatus,\n BeaconTarget,\n BeaconTourConfig,\n BeaconTourEvent,\n BeaconTourHandle,\n} from './types';\n\nconst validateConfig = (config: BeaconTourConfig): void => {\n if (!config.id) throw new BeaconConfigError('createTour: \"id\" must be a non-empty string');\n if (!Array.isArray(config.steps) || config.steps.length === 0) {\n throw new BeaconConfigError(`createTour: tour \"${config.id}\" must have at least one step`);\n }\n\n const seen = new Set<string>();\n for (const step of config.steps) {\n if (!step.id) throw new BeaconConfigError(`createTour: every step of tour \"${config.id}\" needs a non-empty id`);\n if (seen.has(step.id)) {\n throw new BeaconConfigError(`createTour: duplicate step id \"${step.id}\" in tour \"${config.id}\"`);\n }\n seen.add(step.id);\n }\n};\n\n/**\n * Creates a guided tour: a sequential, resumable walkthrough over the app's own\n * DOM. The engine owns step order, target waiting, persistence, and events; a\n * presentation layer (refine's tour components or the app's markup) renders\n * `current` wherever it likes.\n *\n * Progress persists under the tour's id. A stored record written under an older\n * `version` makes the tour eligible again, which is how feature announcements\n * re-reach users who finished the original tour.\n */\nexport function createTour(config: BeaconTourConfig): BeaconTourHandle {\n validateConfig(config);\n\n const version = config.version ?? 1;\n const targetTimeoutMs = config.targetTimeoutMs ?? Number.POSITIVE_INFINITY;\n const autoScroll = config.autoScroll ?? true;\n const storage = config.storage ?? createMemoryStorage();\n const key = storageKey(config.id);\n\n const controller = new AbortController();\n const { signal: disposal } = controller;\n const { emit, warn: warnTap, tap, clear: clearTappers } = createTappers<BeaconTourEvent>(disposal);\n\n const status = signal<BeaconStatus>('idle');\n const eligible = signal(true);\n const current = signal<BeaconCurrentStep>({\n placement: config.placement ?? 'auto',\n presentation: config.presentation ?? 'auto',\n rect: null,\n step: null,\n stepIndex: -1,\n totalSteps: config.steps.length,\n });\n\n let stopWaiting: (() => void) | null = null;\n let loadSequence = 0;\n\n const disposedError = (): BeaconDisposedError => new BeaconDisposedError('This tour handle has been disposed.');\n const guard = (): void => {\n if (disposal.aborted) throw disposedError();\n };\n\n const persist = (): void => {\n const record: BeaconProgress = { status: status.peek(), stepIndex: current.peek().stepIndex, version };\n\n try {\n const result = storage.set(key, record) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n };\n\n const clearPersisted = (): void => {\n try {\n const result = storage.remove(key) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n };\n\n const setStatus = (next: BeaconStatus): void => {\n if (status.peek() === next) return;\n status.value = next;\n persist();\n emit({ status: next, type: 'status-change' });\n };\n\n const stopTargetWatch = (): void => {\n stopWaiting?.();\n stopWaiting = null;\n };\n\n /** Re-reads the active step's rect; republishes only when it actually moved. */\n const refreshActiveRect = (): void => {\n const step = current.peek().step;\n if (!step?.target) return;\n const rect = resolveTarget(step.target);\n if (sameRect(rect, current.peek().rect)) return;\n current.value = { ...current.peek(), rect };\n };\n\n /**\n * Keeps the active step's rect honest for as long as the step is visible:\n * scroll and resize move the target, the target's own box can resize, and\n * content added elsewhere on the page can push it around without either —\n * all of which refresh the rect. A target that leaves the document\n * (collapsed menu, route change) drops the rect to `null` instead of\n * anchoring the card to a ghost. The card's positioner re-measures on the\n * repaint the rect write triggers, so no extra listener is needed there.\n */\n const watchActiveTarget = (target: BeaconTarget): (() => void) => {\n let stopped = false;\n const onLayout = (): void => {\n if (!stopped) refreshActiveRect();\n };\n\n window.addEventListener('scroll', onLayout, { passive: true });\n window.addEventListener('resize', onLayout);\n const stopObserver = observeTarget(target, onLayout, disposal);\n const stopLayout = observeTargetLayout(target, onLayout, disposal);\n const stop = (): void => {\n if (stopped) return;\n stopped = true;\n window.removeEventListener('scroll', onLayout);\n window.removeEventListener('resize', onLayout);\n stopObserver?.();\n stopLayout?.();\n };\n disposal.addEventListener('abort', stop, { once: true });\n\n return stop;\n };\n\n /** Publishes `index` as the visible step: completes the previous step, emits step:start, scrolls. */\n const publishStep = (index: number): void => {\n stopTargetWatch();\n const step = config.steps[index] ?? null;\n const previous = current.peek().step;\n if (previous && previous !== step) emit({ index: current.peek().stepIndex, step: previous, type: 'step:complete' });\n\n current.value = {\n placement: step?.placement ?? config.placement ?? 'auto',\n presentation: step?.presentation ?? config.presentation ?? 'auto',\n rect: step?.target ? resolveTarget(step.target) : null,\n step,\n stepIndex: index,\n totalSteps: config.steps.length,\n };\n\n if (step) {\n emit({ index, step, type: 'step:start' });\n if (autoScroll && step.target) scrollTargetIntoView(step.target, { offset: config.scrollOffset });\n if (step.target) stopWaiting = watchActiveTarget(step.target);\n }\n };\n\n const finishInternal = (reason: 'finish' | 'skip'): void => {\n stopTargetWatch();\n const step = current.peek().step;\n if (step) emit({ index: current.peek().stepIndex, step, type: 'step:complete' });\n current.value = { ...current.peek(), rect: null, step: null, stepIndex: -1 };\n setStatus('completed');\n emit({ reason, type: 'tour:complete' });\n };\n\n /**\n * Makes `index` the active step, waiting for its target when it is not on\n * screen yet (lazy route, closed dialog) and reporting `target-waiting` so a\n * presentation can say \"continue when you're ready\" instead of looking\n * frozen. A step without a target (intro or outro) and a `targetTimeoutMs`\n * of `0` publish immediately.\n */\n const activateStep = (index: number): void => {\n stopTargetWatch();\n const step = config.steps[index];\n if (!step) return;\n\n if (!step.target || targetTimeoutMs === 0 || targetAvailable(step.target)) {\n publishStep(index);\n return;\n }\n\n let waiting = true;\n let timer: ReturnType<typeof setTimeout> | null = null;\n let stopObserver: (() => void) | null = null;\n const target = step.target;\n stopWaiting = (): void => {\n waiting = false;\n stopObserver?.();\n stopObserver = null;\n if (timer !== null) {\n clearTimeout(timer);\n timer = null;\n }\n };\n\n stopObserver = observeTarget(\n target,\n () => {\n if (waiting && targetAvailable(target)) {\n publishStep(index);\n }\n },\n disposal,\n );\n\n if (!stopObserver) {\n devOnly(() => warn(`step \"${step.id}\" of tour \"${config.id}\" has a static target that is not in the document`));\n }\n\n emit({ index, message: `Waiting for step \"${step.id}\" to become visible.`, step, type: 'target-waiting' });\n\n if (Number.isFinite(targetTimeoutMs)) {\n timer = setTimeout(() => {\n if (!waiting) return;\n stopTargetWatch();\n emit({\n message: `Skipped step \"${step.id}\": its target did not appear within ${targetTimeoutMs}ms.`,\n type: 'target-missing',\n });\n if (index + 1 < config.steps.length) activateStep(index + 1);\n else finishInternal('finish');\n }, targetTimeoutMs);\n }\n };\n\n const advanceTo = (index: number): void => {\n if (index < 0) return;\n if (index >= config.steps.length) {\n finishInternal('finish');\n return;\n }\n if (status.peek() !== 'active') setStatus('active');\n activateStep(index);\n };\n\n const startInternal = (): void => {\n guard();\n const s = status.peek();\n if (s === 'completed' || s === 'dismissed' || s === 'active') return;\n const resumeAt = Math.max(0, current.peek().stepIndex);\n setStatus('active');\n activateStep(resumeAt);\n };\n\n // Boot: load persisted progress, then decide eligibility and optional autoStart.\n const sequence = ++loadSequence;\n const applyStored = (raw: unknown): void => {\n if (sequence !== loadSequence || disposal.aborted) return;\n const stored = parseProgress(raw);\n\n if (stored && stored.version >= version) {\n if (stored.status === 'completed' || stored.status === 'dismissed') {\n status.value = stored.status;\n eligible.value = false;\n return;\n }\n if (stored.status === 'active' || stored.status === 'paused') {\n status.value = 'paused';\n current.value = { ...current.peek(), stepIndex: Math.min(stored.stepIndex, config.steps.length - 1) };\n }\n }\n // Fresh, paused, or superseded by a newer version: eligible.\n eligible.value = true;\n if (config.autoStart) {\n queueMicrotask(() => {\n if (!disposal.aborted) startInternal();\n });\n }\n };\n\n try {\n const loaded = storage.get(key) as unknown;\n if (loaded instanceof Promise) loaded.then(applyStored, (error: unknown) => warnTap(error));\n else applyStored(loaded);\n } catch (error) {\n warnTap(error);\n }\n\n return {\n back(): void {\n guard();\n advanceTo(current.peek().stepIndex - 1);\n },\n current,\n dismiss(): void {\n guard();\n if (status.peek() === 'completed' || status.peek() === 'dismissed') return;\n stopTargetWatch();\n current.value = { ...current.peek(), rect: null, step: null, stepIndex: -1 };\n setStatus('dismissed');\n emit({ type: 'tour:dismiss' });\n },\n disposalSignal: disposal,\n dispose(): void {\n if (disposal.aborted) return;\n emit({ type: 'dispose' });\n stopTargetWatch();\n controller.abort();\n clearTappers();\n },\n get disposed(): boolean {\n return disposal.aborted;\n },\n eligible,\n finish(): void {\n guard();\n if (status.peek() === 'completed') return;\n finishInternal('finish');\n },\n goto(step: number | string): void {\n guard();\n const index = typeof step === 'number' ? step : config.steps.findIndex((candidate) => candidate.id === step);\n if (index < 0 || index >= config.steps.length) {\n warn(`goto: step \"${String(step)}\" is not part of tour \"${config.id}\"`);\n return;\n }\n advanceTo(index);\n },\n id: config.id,\n next(): void {\n guard();\n advanceTo(current.peek().stepIndex + 1);\n },\n pause(): void {\n guard();\n if (status.peek() !== 'active') return;\n stopTargetWatch();\n current.value = { ...current.peek(), rect: null };\n setStatus('paused');\n },\n reset(): void {\n guard();\n stopTargetWatch();\n clearPersisted();\n current.value = {\n placement: config.placement ?? 'auto',\n presentation: config.presentation ?? 'auto',\n rect: null,\n step: null,\n stepIndex: -1,\n totalSteps: config.steps.length,\n };\n status.value = 'idle';\n eligible.value = true;\n emit({ status: 'idle', type: 'status-change' });\n },\n skip(): void {\n guard();\n if (status.peek() === 'completed' || status.peek() === 'dismissed') return;\n stopTargetWatch();\n current.value = { ...current.peek(), rect: null, step: null, stepIndex: -1 };\n setStatus('dismissed');\n emit({ reason: 'skip', type: 'tour:complete' });\n },\n start: startInternal,\n status,\n steps: config.steps,\n tap,\n [Symbol.dispose](): void {\n this.dispose();\n },\n };\n}\n"],"mappings":"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"}
|
package/dist/coachmark.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
const e=require("./_emit.cjs"),t=require("./_storage.cjs"),n=require("./
|
|
1
|
+
const e=require("./_emit.cjs"),t=require("./_storage.cjs"),n=require("./_target.cjs"),r=require("./errors.cjs"),i=require("./target.cjs");let a=require("@vielzeug/ripple");function createCoachmark(o){if(!o.id)throw new r.BeaconConfigError(`createCoachmark: "id" must be a non-empty string`);let s=o.version??1,c=o.autoShow??!0,l=o.storage??t.createMemoryStorage(),u=t.storageKey(o.id),d=new AbortController,{signal:f}=d,{emit:p,warn:m,tap:h,clear:g}=e.createTappers(f),_=(0,a.signal)(!0),v={data:o.data,description:o.description,id:o.id,placement:o.placement??`auto`,presentation:o.presentation??`auto`,target:o.target,title:o.title},y={placement:v.placement??`auto`,presentation:v.presentation??`auto`,rect:null,step:null,stepIndex:0,totalSteps:0},b=(0,a.signal)(y),stopWaiting=null,x=0,disposedError=()=>new r.BeaconDisposedError(`This coachmark handle has been disposed.`),guard=()=>{if(f.aborted)throw disposedError()},persistSeen=()=>{let e={status:`completed`,stepIndex:0,version:s};try{let t=l.set(u,e);t instanceof Promise&&t.catch(e=>m(e))}catch(e){m(e)}},stopWaitingForTarget=()=>{stopWaiting?.(),stopWaiting=null},showInternal=()=>{if(guard(),!_.peek()||b.peek().step!==null)return;let publish=()=>{b.value={...y,rect:i.resolveTarget(o.target),step:v},p({type:`coachmark:show`}),watchLayout()},watchLayout=()=>{let onLayout=()=>{let e=i.resolveTarget(o.target);i.sameRect(e,b.peek().rect)||(b.value={...b.peek(),rect:e})};window.addEventListener(`scroll`,onLayout,{passive:!0}),window.addEventListener(`resize`,onLayout);let e=n.observeTargetLayout(o.target,onLayout,f),stop=()=>{window.removeEventListener(`scroll`,onLayout),window.removeEventListener(`resize`,onLayout),e?.()};f.addEventListener(`abort`,stop,{once:!0}),stopWaiting=()=>{stop(),stopWaiting=null}};if(i.resolveTarget(o.target)){publish();return}let e=!0,t=null;stopWaiting=()=>{e=!1,t?.(),t=null},t=n.observeTarget(o.target,()=>{e&&_.peek()&&(stopWaitingForTarget(),publish())},f),p({type:`target-waiting`})},S=++x,applyStored=e=>{if(S!==x||f.aborted)return;let n=t.parseProgress(e);_.value=!(n&&n.version>=s&&n.status===`completed`),_.peek()&&c&&queueMicrotask(()=>{f.aborted||showInternal()})};try{let e=l.get(u);e instanceof Promise?e.then(applyStored,e=>m(e)):applyStored(e)}catch(e){m(e)}return{current:b,dismiss(){guard(),stopWaitingForTarget(),b.value=y,_.value=!1,persistSeen(),p({type:`coachmark:dismiss`})},disposalSignal:f,dispose(){f.aborted||(p({type:`dispose`}),stopWaitingForTarget(),d.abort(),g())},get disposed(){return f.aborted},eligible:_,hide(){guard(),stopWaitingForTarget(),b.value=y},id:o.id,reset(){guard();try{let e=l.remove(u);e instanceof Promise&&e.catch(e=>m(e))}catch(e){m(e)}_.value=!0},show:showInternal,tap:h,[Symbol.dispose](){this.dispose()}}}exports.createCoachmark=createCoachmark;
|
|
2
2
|
//# sourceMappingURL=coachmark.cjs.map
|
package/dist/coachmark.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"coachmark.cjs","names":["BeaconConfigError","createMemoryStorage","storageKey","createTappers","signal","BeaconDisposedError","resolveTarget","sameRect","observeTargetLayout","observeTarget","parseProgress","require__emit","require__storage","require_target","require__target","require_errors","_vielzeug_ripple","config","version","autoShow","storage","key","controller","disposal","warnTap","clearTappers","eligible","step","HIDDEN","current","loadSequence","record","result","error","emit","rect","stopObserver","waiting","sequence","stored","raw","loaded"],"sources":["../src/coachmark.ts"],"sourcesContent":["import { signal } from '@vielzeug/ripple';\nimport { createTappers } from './_emit';\nimport { createMemoryStorage, parseProgress, storageKey } from './_storage';\nimport { observeTarget, observeTargetLayout } from './_target';\nimport { BeaconConfigError, BeaconDisposedError } from './errors';\nimport { resolveTarget, sameRect } from './target';\nimport type {\n BeaconCoachmarkConfig,\n BeaconCoachmarkEvent,\n BeaconCoachmarkHandle,\n BeaconCurrentStep,\n BeaconProgress,\n BeaconStep,\n} from './types';\n\n/**\n * Creates a coachmark: a single contextual hint anchored to one target, shown\n * the first time a user reaches that feature and dismissed permanently after.\n * The same \"explain this button once\" pattern that makes tours worth keeping\n * after launch week, without sequencing anything.\n *\n * Like tours, coachmarks version: bumping `version` re-shows a hint users\n * already saw, which covers a button whose meaning changed.\n */\nexport function createCoachmark(config: BeaconCoachmarkConfig): BeaconCoachmarkHandle {\n if (!config.id) throw new BeaconConfigError('createCoachmark: \"id\" must be a non-empty string');\n\n const version = config.version ?? 1;\n const autoShow = config.autoShow ?? true;\n const storage = config.storage ?? createMemoryStorage();\n const key = storageKey(config.id);\n\n const controller = new AbortController();\n const { signal: disposal } = controller;\n const { emit, warn: warnTap, tap, clear: clearTappers } = createTappers<BeaconCoachmarkEvent>(disposal);\n\n const eligible = signal(true);\n\n const step: BeaconStep = {\n data: config.data,\n description: config.description,\n id: config.id,\n placement: config.placement ?? 'auto',\n presentation: config.presentation ?? 'auto',\n target: config.target,\n title: config.title,\n };\n\n const HIDDEN: BeaconCurrentStep = {\n placement: step.placement ?? 'auto',\n presentation: step.presentation ?? 'auto',\n rect: null,\n step: null,\n stepIndex: 0,\n totalSteps: 0,\n };\n\n const current = signal<BeaconCurrentStep>(HIDDEN);\n\n let stopWaiting: (() => void) | null = null;\n let loadSequence = 0;\n\n const disposedError = (): BeaconDisposedError => new BeaconDisposedError('This coachmark handle has been disposed.');\n const guard = (): void => {\n if (disposal.aborted) throw disposedError();\n };\n\n const persistSeen = (): void => {\n const record: BeaconProgress = { status: 'completed', stepIndex: 0, version };\n\n try {\n const result = storage.set(key, record) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n };\n\n const stopWaitingForTarget = (): void => {\n stopWaiting?.();\n stopWaiting = null;\n };\n\n const showInternal = (): void => {\n guard();\n if (!eligible.peek() || current.peek().step !== null) return;\n\n const publish = (): void => {\n current.value = { ...HIDDEN, rect: resolveTarget(config.target), step };\n emit({ type: 'coachmark:show' });\n watchLayout();\n };\n\n // Keep the rect honest while the hint is up: scroll and resize move the\n // target, the target's box can resize, and page growth can push it around;\n // a target that leaves the document drops the rect to null.\n const watchLayout = (): void => {\n const onLayout = (): void => {\n const rect = resolveTarget(config.target);\n if (sameRect(rect, current.peek().rect)) return;\n current.value = { ...current.peek(), rect };\n };\n\n window.addEventListener('scroll', onLayout, { passive: true });\n window.addEventListener('resize', onLayout);\n const stopObserver = observeTargetLayout(config.target, onLayout, disposal);\n const stop = (): void => {\n window.removeEventListener('scroll', onLayout);\n window.removeEventListener('resize', onLayout);\n stopObserver?.();\n };\n disposal.addEventListener('abort', stop, { once: true });\n stopWaiting = (): void => {\n stop();\n stopWaiting = null;\n };\n };\n\n if (resolveTarget(config.target)) {\n publish();\n return;\n }\n\n // Target not mounted yet: wait for it so the hint appears when the user reaches the feature.\n let waiting = true;\n let stopObserver: (() => void) | null = null;\n stopWaiting = (): void => {\n waiting = false;\n stopObserver?.();\n stopObserver = null;\n };\n stopObserver = observeTarget(\n config.target,\n () => {\n if (!waiting || !eligible.peek()) return;\n stopWaitingForTarget();\n publish();\n },\n disposal,\n );\n emit({ type: 'target-waiting' });\n };\n\n // Boot: read the seen-record, then optionally auto-show.\n const sequence = ++loadSequence;\n const applyStored = (raw: unknown): void => {\n if (sequence !== loadSequence || disposal.aborted) return;\n const stored = parseProgress(raw);\n eligible.value = !(stored && stored.version >= version && stored.status === 'completed');\n if (eligible.peek() && autoShow) {\n queueMicrotask(() => {\n if (!disposal.aborted) showInternal();\n });\n }\n };\n\n try {\n const loaded = storage.get(key) as unknown;\n if (loaded instanceof Promise) loaded.then(applyStored, (error: unknown) => warnTap(error));\n else applyStored(loaded);\n } catch (error) {\n warnTap(error);\n }\n\n return {\n current,\n dismiss(): void {\n guard();\n stopWaitingForTarget();\n current.value = HIDDEN;\n eligible.value = false;\n persistSeen();\n emit({ type: 'coachmark:dismiss' });\n },\n disposalSignal: disposal,\n dispose(): void {\n if (disposal.aborted) return;\n emit({ type: 'dispose' });\n stopWaitingForTarget();\n controller.abort();\n clearTappers();\n },\n get disposed(): boolean {\n return disposal.aborted;\n },\n eligible,\n hide(): void {\n guard();\n stopWaitingForTarget();\n current.value = HIDDEN;\n },\n id: config.id,\n reset(): void {\n guard();\n try {\n const result = storage.remove(key) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n eligible.value = true;\n },\n show: showInternal,\n tap,\n [Symbol.dispose](): void {\n this.dispose();\n },\n };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"coachmark.cjs","names":["BeaconConfigError","createMemoryStorage","storageKey","createTappers","signal","BeaconDisposedError","resolveTarget","sameRect","observeTargetLayout","observeTarget","parseProgress","require__emit","require__storage","require__target","require_errors","require_target","_vielzeug_ripple","config","version","autoShow","storage","key","controller","disposal","warnTap","clearTappers","eligible","step","HIDDEN","current","loadSequence","record","result","error","emit","rect","stopObserver","waiting","sequence","stored","raw","loaded"],"sources":["../src/coachmark.ts"],"sourcesContent":["import { signal } from '@vielzeug/ripple';\nimport { createTappers } from './_emit';\nimport { createMemoryStorage, parseProgress, storageKey } from './_storage';\nimport { observeTarget, observeTargetLayout } from './_target';\nimport { BeaconConfigError, BeaconDisposedError } from './errors';\nimport { resolveTarget, sameRect } from './target';\nimport type {\n BeaconCoachmarkConfig,\n BeaconCoachmarkEvent,\n BeaconCoachmarkHandle,\n BeaconCurrentStep,\n BeaconProgress,\n BeaconStep,\n} from './types';\n\n/**\n * Creates a coachmark: a single contextual hint anchored to one target, shown\n * the first time a user reaches that feature and dismissed permanently after.\n * The same \"explain this button once\" pattern that makes tours worth keeping\n * after launch week, without sequencing anything.\n *\n * Like tours, coachmarks version: bumping `version` re-shows a hint users\n * already saw, which covers a button whose meaning changed.\n */\nexport function createCoachmark(config: BeaconCoachmarkConfig): BeaconCoachmarkHandle {\n if (!config.id) throw new BeaconConfigError('createCoachmark: \"id\" must be a non-empty string');\n\n const version = config.version ?? 1;\n const autoShow = config.autoShow ?? true;\n const storage = config.storage ?? createMemoryStorage();\n const key = storageKey(config.id);\n\n const controller = new AbortController();\n const { signal: disposal } = controller;\n const { emit, warn: warnTap, tap, clear: clearTappers } = createTappers<BeaconCoachmarkEvent>(disposal);\n\n const eligible = signal(true);\n\n const step: BeaconStep = {\n data: config.data,\n description: config.description,\n id: config.id,\n placement: config.placement ?? 'auto',\n presentation: config.presentation ?? 'auto',\n target: config.target,\n title: config.title,\n };\n\n const HIDDEN: BeaconCurrentStep = {\n placement: step.placement ?? 'auto',\n presentation: step.presentation ?? 'auto',\n rect: null,\n step: null,\n stepIndex: 0,\n totalSteps: 0,\n };\n\n const current = signal<BeaconCurrentStep>(HIDDEN);\n\n let stopWaiting: (() => void) | null = null;\n let loadSequence = 0;\n\n const disposedError = (): BeaconDisposedError => new BeaconDisposedError('This coachmark handle has been disposed.');\n const guard = (): void => {\n if (disposal.aborted) throw disposedError();\n };\n\n const persistSeen = (): void => {\n const record: BeaconProgress = { status: 'completed', stepIndex: 0, version };\n\n try {\n const result = storage.set(key, record) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n };\n\n const stopWaitingForTarget = (): void => {\n stopWaiting?.();\n stopWaiting = null;\n };\n\n const showInternal = (): void => {\n guard();\n if (!eligible.peek() || current.peek().step !== null) return;\n\n const publish = (): void => {\n current.value = { ...HIDDEN, rect: resolveTarget(config.target), step };\n emit({ type: 'coachmark:show' });\n watchLayout();\n };\n\n // Keep the rect honest while the hint is up: scroll and resize move the\n // target, the target's box can resize, and page growth can push it around;\n // a target that leaves the document drops the rect to null.\n const watchLayout = (): void => {\n const onLayout = (): void => {\n const rect = resolveTarget(config.target);\n if (sameRect(rect, current.peek().rect)) return;\n current.value = { ...current.peek(), rect };\n };\n\n window.addEventListener('scroll', onLayout, { passive: true });\n window.addEventListener('resize', onLayout);\n const stopObserver = observeTargetLayout(config.target, onLayout, disposal);\n const stop = (): void => {\n window.removeEventListener('scroll', onLayout);\n window.removeEventListener('resize', onLayout);\n stopObserver?.();\n };\n disposal.addEventListener('abort', stop, { once: true });\n stopWaiting = (): void => {\n stop();\n stopWaiting = null;\n };\n };\n\n if (resolveTarget(config.target)) {\n publish();\n return;\n }\n\n // Target not mounted yet: wait for it so the hint appears when the user reaches the feature.\n let waiting = true;\n let stopObserver: (() => void) | null = null;\n stopWaiting = (): void => {\n waiting = false;\n stopObserver?.();\n stopObserver = null;\n };\n stopObserver = observeTarget(\n config.target,\n () => {\n if (!waiting || !eligible.peek()) return;\n stopWaitingForTarget();\n publish();\n },\n disposal,\n );\n emit({ type: 'target-waiting' });\n };\n\n // Boot: read the seen-record, then optionally auto-show.\n const sequence = ++loadSequence;\n const applyStored = (raw: unknown): void => {\n if (sequence !== loadSequence || disposal.aborted) return;\n const stored = parseProgress(raw);\n eligible.value = !(stored && stored.version >= version && stored.status === 'completed');\n if (eligible.peek() && autoShow) {\n queueMicrotask(() => {\n if (!disposal.aborted) showInternal();\n });\n }\n };\n\n try {\n const loaded = storage.get(key) as unknown;\n if (loaded instanceof Promise) loaded.then(applyStored, (error: unknown) => warnTap(error));\n else applyStored(loaded);\n } catch (error) {\n warnTap(error);\n }\n\n return {\n current,\n dismiss(): void {\n guard();\n stopWaitingForTarget();\n current.value = HIDDEN;\n eligible.value = false;\n persistSeen();\n emit({ type: 'coachmark:dismiss' });\n },\n disposalSignal: disposal,\n dispose(): void {\n if (disposal.aborted) return;\n emit({ type: 'dispose' });\n stopWaitingForTarget();\n controller.abort();\n clearTappers();\n },\n get disposed(): boolean {\n return disposal.aborted;\n },\n eligible,\n hide(): void {\n guard();\n stopWaitingForTarget();\n current.value = HIDDEN;\n },\n id: config.id,\n reset(): void {\n guard();\n try {\n const result = storage.remove(key) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n eligible.value = true;\n },\n show: showInternal,\n tap,\n [Symbol.dispose](): void {\n this.dispose();\n },\n };\n}\n"],"mappings":"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"}
|
package/dist/coachmark.js
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
import { createTappers as e } from "./_emit.js";
|
|
2
2
|
import { createMemoryStorage as t, parseProgress as n, storageKey as r } from "./_storage.js";
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
3
|
+
import { observeTarget as i, observeTargetLayout as a } from "./_target.js";
|
|
4
|
+
import { BeaconConfigError as o, BeaconDisposedError as s } from "./errors.js";
|
|
5
|
+
import { resolveTarget as c, sameRect as l } from "./target.js";
|
|
6
6
|
import { signal as u } from "@vielzeug/ripple";
|
|
7
|
-
|
|
7
|
+
// src/coachmark.ts
|
|
8
8
|
function createCoachmark(d) {
|
|
9
|
-
if (!d.id) throw new
|
|
9
|
+
if (!d.id) throw new o("createCoachmark: \"id\" must be a non-empty string");
|
|
10
10
|
let f = d.version ?? 1, p = d.autoShow ?? !0, m = d.storage ?? t(), h = r(d.id), g = new AbortController(), { signal: _ } = g, { emit: v, warn: y, tap: b, clear: x } = e(_), S = u(!0), C = {
|
|
11
11
|
data: d.data,
|
|
12
12
|
description: d.description,
|
|
@@ -22,7 +22,7 @@ function createCoachmark(d) {
|
|
|
22
22
|
step: null,
|
|
23
23
|
stepIndex: 0,
|
|
24
24
|
totalSteps: 0
|
|
25
|
-
}, T = u(w), stopWaiting = null, E = 0, disposedError = () => new
|
|
25
|
+
}, T = u(w), stopWaiting = null, E = 0, disposedError = () => new s("This coachmark handle has been disposed."), guard = () => {
|
|
26
26
|
if (_.aborted) throw disposedError();
|
|
27
27
|
}, persistSeen = () => {
|
|
28
28
|
let e = {
|
|
@@ -43,33 +43,33 @@ function createCoachmark(d) {
|
|
|
43
43
|
let publish = () => {
|
|
44
44
|
T.value = {
|
|
45
45
|
...w,
|
|
46
|
-
rect:
|
|
46
|
+
rect: c(d.target),
|
|
47
47
|
step: C
|
|
48
48
|
}, v({ type: "coachmark:show" }), watchLayout();
|
|
49
49
|
}, watchLayout = () => {
|
|
50
50
|
let onLayout = () => {
|
|
51
|
-
let e =
|
|
52
|
-
|
|
51
|
+
let e = c(d.target);
|
|
52
|
+
l(e, T.peek().rect) || (T.value = {
|
|
53
53
|
...T.peek(),
|
|
54
54
|
rect: e
|
|
55
55
|
});
|
|
56
56
|
};
|
|
57
57
|
window.addEventListener("scroll", onLayout, { passive: !0 }), window.addEventListener("resize", onLayout);
|
|
58
|
-
let e =
|
|
58
|
+
let e = a(d.target, onLayout, _), stop = () => {
|
|
59
59
|
window.removeEventListener("scroll", onLayout), window.removeEventListener("resize", onLayout), e?.();
|
|
60
60
|
};
|
|
61
61
|
_.addEventListener("abort", stop, { once: !0 }), stopWaiting = () => {
|
|
62
62
|
stop(), stopWaiting = null;
|
|
63
63
|
};
|
|
64
64
|
};
|
|
65
|
-
if (
|
|
65
|
+
if (c(d.target)) {
|
|
66
66
|
publish();
|
|
67
67
|
return;
|
|
68
68
|
}
|
|
69
69
|
let e = !0, t = null;
|
|
70
70
|
stopWaiting = () => {
|
|
71
71
|
e = !1, t?.(), t = null;
|
|
72
|
-
}, t =
|
|
72
|
+
}, t = i(d.target, () => {
|
|
73
73
|
e && S.peek() && (stopWaitingForTarget(), publish());
|
|
74
74
|
}, _), v({ type: "target-waiting" });
|
|
75
75
|
}, D = ++E, applyStored = (e) => {
|
|
@@ -119,7 +119,6 @@ function createCoachmark(d) {
|
|
|
119
119
|
}
|
|
120
120
|
};
|
|
121
121
|
}
|
|
122
|
-
//#endregion
|
|
123
122
|
export { createCoachmark };
|
|
124
123
|
|
|
125
124
|
//# sourceMappingURL=coachmark.js.map
|
package/dist/errors.js
CHANGED
|
@@ -1,10 +1,9 @@
|
|
|
1
|
-
|
|
1
|
+
// src/errors.ts
|
|
2
2
|
var BeaconError = class extends Error {
|
|
3
3
|
constructor(e, t) {
|
|
4
4
|
super(e, t), this.name = new.target.name, Object.setPrototypeOf(this, new.target.prototype);
|
|
5
5
|
}
|
|
6
6
|
}, BeaconConfigError = class extends BeaconError {}, BeaconDisposedError = class extends BeaconError {};
|
|
7
|
-
//#endregion
|
|
8
7
|
export { BeaconConfigError, BeaconDisposedError, BeaconError };
|
|
9
8
|
|
|
10
9
|
//# sourceMappingURL=errors.js.map
|
package/dist/index.cjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./coachmark.cjs"),t=require("./errors.cjs"),n=require("./target.cjs"),r=require("./tour.cjs");exports.BeaconConfigError=t.BeaconConfigError,exports.BeaconDisposedError=t.BeaconDisposedError,exports.BeaconError=t.BeaconError,exports.createCoachmark=e.createCoachmark,exports.createTour=r.createTour,exports.resolveTarget=n.resolveTarget;
|
package/dist/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { createCoachmark as e } from "./coachmark.js";
|
|
2
2
|
import { BeaconConfigError as t, BeaconDisposedError as n, BeaconError as r } from "./errors.js";
|
|
3
|
-
import {
|
|
3
|
+
import { resolveTarget as i } from "./target.js";
|
|
4
4
|
import { createTour as a } from "./tour.js";
|
|
5
|
-
export { t as BeaconConfigError, n as BeaconDisposedError, r as BeaconError,
|
|
5
|
+
export { t as BeaconConfigError, n as BeaconDisposedError, r as BeaconError, e as createCoachmark, a as createTour, i as resolveTarget };
|
package/dist/target.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
|
|
1
|
+
// src/target.ts
|
|
2
2
|
var isElement = (e) => typeof Element < "u" && e instanceof Element, isRect = (e) => typeof e == "object" && !!e && typeof e.x == "number" && typeof e.y == "number" && typeof e.width == "number" && typeof e.height == "number", normalize = (e) => {
|
|
3
3
|
if (e === null) return null;
|
|
4
4
|
if (!isElement(e)) return e;
|
|
@@ -30,7 +30,6 @@ function isStaticTarget(e) {
|
|
|
30
30
|
function sameRect(e, t) {
|
|
31
31
|
return e === null || t === null ? e === t : e.x === t.x && e.y === t.y && e.width === t.width && e.height === t.height;
|
|
32
32
|
}
|
|
33
|
-
//#endregion
|
|
34
33
|
export { isStaticTarget, resolveTarget, sameRect, targetAvailable, targetElement };
|
|
35
34
|
|
|
36
35
|
//# sourceMappingURL=target.js.map
|
package/dist/tour.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
const e=require("./_emit.cjs"),t=require("./
|
|
1
|
+
require("./_dev.cjs");const e=require("./_emit.cjs"),t=require("./_scroll.cjs"),n=require("./_storage.cjs"),r=require("./_target.cjs"),i=require("./errors.cjs"),a=require("./target.cjs");let o=require("@vielzeug/ripple");var validateConfig=e=>{if(!e.id)throw new i.BeaconConfigError(`createTour: "id" must be a non-empty string`);if(!Array.isArray(e.steps)||e.steps.length===0)throw new i.BeaconConfigError(`createTour: tour "${e.id}" must have at least one step`);let t=new Set;for(let n of e.steps){if(!n.id)throw new i.BeaconConfigError(`createTour: every step of tour "${e.id}" needs a non-empty id`);if(t.has(n.id))throw new i.BeaconConfigError(`createTour: duplicate step id "${n.id}" in tour "${e.id}"`);t.add(n.id)}};function createTour(s){validateConfig(s);let c=s.version??1,l=s.targetTimeoutMs??1/0,u=s.autoScroll??!0,d=s.storage??n.createMemoryStorage(),f=n.storageKey(s.id),p=new AbortController,{signal:m}=p,{emit:h,warn:g,tap:_,clear:v}=e.createTappers(m),y=(0,o.signal)(`idle`),b=(0,o.signal)(!0),x=(0,o.signal)({placement:s.placement??`auto`,presentation:s.presentation??`auto`,rect:null,step:null,stepIndex:-1,totalSteps:s.steps.length}),stopWaiting=null,S=0,disposedError=()=>new i.BeaconDisposedError(`This tour handle has been disposed.`),guard=()=>{if(m.aborted)throw disposedError()},persist=()=>{let e={status:y.peek(),stepIndex:x.peek().stepIndex,version:c};try{let t=d.set(f,e);t instanceof Promise&&t.catch(e=>g(e))}catch(e){g(e)}},clearPersisted=()=>{try{let e=d.remove(f);e instanceof Promise&&e.catch(e=>g(e))}catch(e){g(e)}},setStatus=e=>{y.peek()!==e&&(y.value=e,persist(),h({status:e,type:`status-change`}))},stopTargetWatch=()=>{stopWaiting?.(),stopWaiting=null},refreshActiveRect=()=>{let e=x.peek().step;if(!e?.target)return;let t=a.resolveTarget(e.target);a.sameRect(t,x.peek().rect)||(x.value={...x.peek(),rect:t})},watchActiveTarget=e=>{let t=!1,onLayout=()=>{t||refreshActiveRect()};window.addEventListener(`scroll`,onLayout,{passive:!0}),window.addEventListener(`resize`,onLayout);let n=r.observeTarget(e,onLayout,m),i=r.observeTargetLayout(e,onLayout,m),stop=()=>{t||(t=!0,window.removeEventListener(`scroll`,onLayout),window.removeEventListener(`resize`,onLayout),n?.(),i?.())};return m.addEventListener(`abort`,stop,{once:!0}),stop},publishStep=e=>{stopTargetWatch();let n=s.steps[e]??null,r=x.peek().step;r&&r!==n&&h({index:x.peek().stepIndex,step:r,type:`step:complete`}),x.value={placement:n?.placement??s.placement??`auto`,presentation:n?.presentation??s.presentation??`auto`,rect:n?.target?a.resolveTarget(n.target):null,step:n,stepIndex:e,totalSteps:s.steps.length},n&&(h({index:e,step:n,type:`step:start`}),u&&n.target&&t.scrollTargetIntoView(n.target,{offset:s.scrollOffset}),n.target&&(stopWaiting=watchActiveTarget(n.target)))},finishInternal=e=>{stopTargetWatch();let t=x.peek().step;t&&h({index:x.peek().stepIndex,step:t,type:`step:complete`}),x.value={...x.peek(),rect:null,step:null,stepIndex:-1},setStatus(`completed`),h({reason:e,type:`tour:complete`})},activateStep=e=>{stopTargetWatch();let t=s.steps[e];if(!t)return;if(!t.target||l===0||a.targetAvailable(t.target)){publishStep(e);return}let n=!0,i=null,o=null,c=t.target;stopWaiting=()=>{n=!1,o?.(),o=null,i!==null&&(clearTimeout(i),i=null)},o=r.observeTarget(c,()=>{n&&a.targetAvailable(c)&&publishStep(e)},m),h({index:e,message:`Waiting for step "${t.id}" to become visible.`,step:t,type:`target-waiting`}),Number.isFinite(l)&&(i=setTimeout(()=>{n&&(stopTargetWatch(),h({message:`Skipped step "${t.id}": its target did not appear within ${l}ms.`,type:`target-missing`}),e+1<s.steps.length?activateStep(e+1):finishInternal(`finish`))},l))},advanceTo=e=>{e<0||(e>=s.steps.length?finishInternal(`finish`):(y.peek()!==`active`&&setStatus(`active`),activateStep(e)))},startInternal=()=>{guard();let e=y.peek();if(e===`completed`||e===`dismissed`||e===`active`)return;let t=Math.max(0,x.peek().stepIndex);setStatus(`active`),activateStep(t)},C=++S,applyStored=e=>{if(C!==S||m.aborted)return;let t=n.parseProgress(e);if(t&&t.version>=c){if(t.status===`completed`||t.status===`dismissed`){y.value=t.status,b.value=!1;return}(t.status===`active`||t.status===`paused`)&&(y.value=`paused`,x.value={...x.peek(),stepIndex:Math.min(t.stepIndex,s.steps.length-1)})}b.value=!0,s.autoStart&&queueMicrotask(()=>{m.aborted||startInternal()})};try{let e=d.get(f);e instanceof Promise?e.then(applyStored,e=>g(e)):applyStored(e)}catch(e){g(e)}return{back(){guard(),advanceTo(x.peek().stepIndex-1)},current:x,dismiss(){guard(),y.peek()!==`completed`&&y.peek()!==`dismissed`&&(stopTargetWatch(),x.value={...x.peek(),rect:null,step:null,stepIndex:-1},setStatus(`dismissed`),h({type:`tour:dismiss`}))},disposalSignal:m,dispose(){m.aborted||(h({type:`dispose`}),stopTargetWatch(),p.abort(),v())},get disposed(){return m.aborted},eligible:b,finish(){guard(),y.peek()!==`completed`&&finishInternal(`finish`)},goto(e){guard();let t=typeof e==`number`?e:s.steps.findIndex(t=>t.id===e);t<0||t>=s.steps.length?`${String(e)}${s.id}`:advanceTo(t)},id:s.id,next(){guard(),advanceTo(x.peek().stepIndex+1)},pause(){guard(),y.peek()===`active`&&(stopTargetWatch(),x.value={...x.peek(),rect:null},setStatus(`paused`))},reset(){guard(),stopTargetWatch(),clearPersisted(),x.value={placement:s.placement??`auto`,presentation:s.presentation??`auto`,rect:null,step:null,stepIndex:-1,totalSteps:s.steps.length},y.value=`idle`,b.value=!0,h({status:`idle`,type:`status-change`})},skip(){guard(),y.peek()!==`completed`&&y.peek()!==`dismissed`&&(stopTargetWatch(),x.value={...x.peek(),rect:null,step:null,stepIndex:-1},setStatus(`dismissed`),h({reason:`skip`,type:`tour:complete`}))},start:startInternal,status:y,steps:s.steps,tap:_,[Symbol.dispose](){this.dispose()}}}exports.createTour=createTour;
|
|
2
2
|
//# sourceMappingURL=tour.cjs.map
|
package/dist/tour.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tour.cjs","names":["BeaconConfigError","createMemoryStorage","storageKey","createTappers","signal","BeaconDisposedError","resolveTarget","sameRect","observeTarget","observeTargetLayout","targetAvailable","parseProgress","require__emit","require__storage","require_target","require__target","require_errors","require__scroll","_vielzeug_ripple","config","seen","step","version","targetTimeoutMs","autoScroll","storage","key","controller","disposal","warnTap","clearTappers","status","eligible","current","loadSequence","record","result","error","next","emit","rect","stopped","stopObserver","target","stopLayout","index","previous","waiting","timer","s","resumeAt","sequence","stored","raw","loaded","candidate"],"sources":["../src/tour.ts"],"sourcesContent":["import { signal } from '@vielzeug/ripple';\nimport { devOnly, warn } from './_dev';\nimport { createTappers } from './_emit';\nimport { scrollTargetIntoView } from './_scroll';\nimport { createMemoryStorage, parseProgress, storageKey } from './_storage';\nimport { observeTarget, observeTargetLayout } from './_target';\nimport { BeaconConfigError, BeaconDisposedError } from './errors';\nimport { resolveTarget, sameRect, targetAvailable } from './target';\nimport type {\n BeaconCurrentStep,\n BeaconProgress,\n BeaconStatus,\n BeaconTarget,\n BeaconTourConfig,\n BeaconTourEvent,\n BeaconTourHandle,\n} from './types';\n\nconst validateConfig = (config: BeaconTourConfig): void => {\n if (!config.id) throw new BeaconConfigError('createTour: \"id\" must be a non-empty string');\n if (!Array.isArray(config.steps) || config.steps.length === 0) {\n throw new BeaconConfigError(`createTour: tour \"${config.id}\" must have at least one step`);\n }\n\n const seen = new Set<string>();\n for (const step of config.steps) {\n if (!step.id) throw new BeaconConfigError(`createTour: every step of tour \"${config.id}\" needs a non-empty id`);\n if (seen.has(step.id)) {\n throw new BeaconConfigError(`createTour: duplicate step id \"${step.id}\" in tour \"${config.id}\"`);\n }\n seen.add(step.id);\n }\n};\n\n/**\n * Creates a guided tour: a sequential, resumable walkthrough over the app's own\n * DOM. The engine owns step order, target waiting, persistence, and events; a\n * presentation layer (refine's tour components or the app's markup) renders\n * `current` wherever it likes.\n *\n * Progress persists under the tour's id. A stored record written under an older\n * `version` makes the tour eligible again, which is how feature announcements\n * re-reach users who finished the original tour.\n */\nexport function createTour(config: BeaconTourConfig): BeaconTourHandle {\n validateConfig(config);\n\n const version = config.version ?? 1;\n const targetTimeoutMs = config.targetTimeoutMs ?? Number.POSITIVE_INFINITY;\n const autoScroll = config.autoScroll ?? true;\n const storage = config.storage ?? createMemoryStorage();\n const key = storageKey(config.id);\n\n const controller = new AbortController();\n const { signal: disposal } = controller;\n const { emit, warn: warnTap, tap, clear: clearTappers } = createTappers<BeaconTourEvent>(disposal);\n\n const status = signal<BeaconStatus>('idle');\n const eligible = signal(true);\n const current = signal<BeaconCurrentStep>({\n placement: config.placement ?? 'auto',\n presentation: config.presentation ?? 'auto',\n rect: null,\n step: null,\n stepIndex: -1,\n totalSteps: config.steps.length,\n });\n\n let stopWaiting: (() => void) | null = null;\n let loadSequence = 0;\n\n const disposedError = (): BeaconDisposedError => new BeaconDisposedError('This tour handle has been disposed.');\n const guard = (): void => {\n if (disposal.aborted) throw disposedError();\n };\n\n const persist = (): void => {\n const record: BeaconProgress = { status: status.peek(), stepIndex: current.peek().stepIndex, version };\n\n try {\n const result = storage.set(key, record) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n };\n\n const clearPersisted = (): void => {\n try {\n const result = storage.remove(key) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n };\n\n const setStatus = (next: BeaconStatus): void => {\n if (status.peek() === next) return;\n status.value = next;\n persist();\n emit({ status: next, type: 'status-change' });\n };\n\n const stopTargetWatch = (): void => {\n stopWaiting?.();\n stopWaiting = null;\n };\n\n /** Re-reads the active step's rect; republishes only when it actually moved. */\n const refreshActiveRect = (): void => {\n const step = current.peek().step;\n if (!step?.target) return;\n const rect = resolveTarget(step.target);\n if (sameRect(rect, current.peek().rect)) return;\n current.value = { ...current.peek(), rect };\n };\n\n /**\n * Keeps the active step's rect honest for as long as the step is visible:\n * scroll and resize move the target, the target's own box can resize, and\n * content added elsewhere on the page can push it around without either —\n * all of which refresh the rect. A target that leaves the document\n * (collapsed menu, route change) drops the rect to `null` instead of\n * anchoring the card to a ghost. The card's positioner re-measures on the\n * repaint the rect write triggers, so no extra listener is needed there.\n */\n const watchActiveTarget = (target: BeaconTarget): (() => void) => {\n let stopped = false;\n const onLayout = (): void => {\n if (!stopped) refreshActiveRect();\n };\n\n window.addEventListener('scroll', onLayout, { passive: true });\n window.addEventListener('resize', onLayout);\n const stopObserver = observeTarget(target, onLayout, disposal);\n const stopLayout = observeTargetLayout(target, onLayout, disposal);\n const stop = (): void => {\n if (stopped) return;\n stopped = true;\n window.removeEventListener('scroll', onLayout);\n window.removeEventListener('resize', onLayout);\n stopObserver?.();\n stopLayout?.();\n };\n disposal.addEventListener('abort', stop, { once: true });\n\n return stop;\n };\n\n /** Publishes `index` as the visible step: completes the previous step, emits step:start, scrolls. */\n const publishStep = (index: number): void => {\n stopTargetWatch();\n const step = config.steps[index] ?? null;\n const previous = current.peek().step;\n if (previous && previous !== step) emit({ index: current.peek().stepIndex, step: previous, type: 'step:complete' });\n\n current.value = {\n placement: step?.placement ?? config.placement ?? 'auto',\n presentation: step?.presentation ?? config.presentation ?? 'auto',\n rect: step?.target ? resolveTarget(step.target) : null,\n step,\n stepIndex: index,\n totalSteps: config.steps.length,\n };\n\n if (step) {\n emit({ index, step, type: 'step:start' });\n if (autoScroll && step.target) scrollTargetIntoView(step.target, { offset: config.scrollOffset });\n if (step.target) stopWaiting = watchActiveTarget(step.target);\n }\n };\n\n const finishInternal = (reason: 'finish' | 'skip'): void => {\n stopTargetWatch();\n const step = current.peek().step;\n if (step) emit({ index: current.peek().stepIndex, step, type: 'step:complete' });\n current.value = { ...current.peek(), rect: null, step: null, stepIndex: -1 };\n setStatus('completed');\n emit({ reason, type: 'tour:complete' });\n };\n\n /**\n * Makes `index` the active step, waiting for its target when it is not on\n * screen yet (lazy route, closed dialog) and reporting `target-waiting` so a\n * presentation can say \"continue when you're ready\" instead of looking\n * frozen. A step without a target (intro or outro) and a `targetTimeoutMs`\n * of `0` publish immediately.\n */\n const activateStep = (index: number): void => {\n stopTargetWatch();\n const step = config.steps[index];\n if (!step) return;\n\n if (!step.target || targetTimeoutMs === 0 || targetAvailable(step.target)) {\n publishStep(index);\n return;\n }\n\n let waiting = true;\n let timer: ReturnType<typeof setTimeout> | null = null;\n let stopObserver: (() => void) | null = null;\n const target = step.target;\n stopWaiting = (): void => {\n waiting = false;\n stopObserver?.();\n stopObserver = null;\n if (timer !== null) {\n clearTimeout(timer);\n timer = null;\n }\n };\n\n stopObserver = observeTarget(\n target,\n () => {\n if (waiting && targetAvailable(target)) {\n publishStep(index);\n }\n },\n disposal,\n );\n\n if (!stopObserver) {\n devOnly(() => warn(`step \"${step.id}\" of tour \"${config.id}\" has a static target that is not in the document`));\n }\n\n emit({ index, message: `Waiting for step \"${step.id}\" to become visible.`, step, type: 'target-waiting' });\n\n if (Number.isFinite(targetTimeoutMs)) {\n timer = setTimeout(() => {\n if (!waiting) return;\n stopTargetWatch();\n emit({\n message: `Skipped step \"${step.id}\": its target did not appear within ${targetTimeoutMs}ms.`,\n type: 'target-missing',\n });\n if (index + 1 < config.steps.length) activateStep(index + 1);\n else finishInternal('finish');\n }, targetTimeoutMs);\n }\n };\n\n const advanceTo = (index: number): void => {\n if (index < 0) return;\n if (index >= config.steps.length) {\n finishInternal('finish');\n return;\n }\n if (status.peek() !== 'active') setStatus('active');\n activateStep(index);\n };\n\n const startInternal = (): void => {\n guard();\n const s = status.peek();\n if (s === 'completed' || s === 'dismissed' || s === 'active') return;\n const resumeAt = Math.max(0, current.peek().stepIndex);\n setStatus('active');\n activateStep(resumeAt);\n };\n\n // Boot: load persisted progress, then decide eligibility and optional autoStart.\n const sequence = ++loadSequence;\n const applyStored = (raw: unknown): void => {\n if (sequence !== loadSequence || disposal.aborted) return;\n const stored = parseProgress(raw);\n\n if (stored && stored.version >= version) {\n if (stored.status === 'completed' || stored.status === 'dismissed') {\n status.value = stored.status;\n eligible.value = false;\n return;\n }\n if (stored.status === 'active' || stored.status === 'paused') {\n status.value = 'paused';\n current.value = { ...current.peek(), stepIndex: Math.min(stored.stepIndex, config.steps.length - 1) };\n }\n }\n // Fresh, paused, or superseded by a newer version: eligible.\n eligible.value = true;\n if (config.autoStart) {\n queueMicrotask(() => {\n if (!disposal.aborted) startInternal();\n });\n }\n };\n\n try {\n const loaded = storage.get(key) as unknown;\n if (loaded instanceof Promise) loaded.then(applyStored, (error: unknown) => warnTap(error));\n else applyStored(loaded);\n } catch (error) {\n warnTap(error);\n }\n\n return {\n back(): void {\n guard();\n advanceTo(current.peek().stepIndex - 1);\n },\n current,\n dismiss(): void {\n guard();\n if (status.peek() === 'completed' || status.peek() === 'dismissed') return;\n stopTargetWatch();\n current.value = { ...current.peek(), rect: null, step: null, stepIndex: -1 };\n setStatus('dismissed');\n emit({ type: 'tour:dismiss' });\n },\n disposalSignal: disposal,\n dispose(): void {\n if (disposal.aborted) return;\n emit({ type: 'dispose' });\n stopTargetWatch();\n controller.abort();\n clearTappers();\n },\n get disposed(): boolean {\n return disposal.aborted;\n },\n eligible,\n finish(): void {\n guard();\n if (status.peek() === 'completed') return;\n finishInternal('finish');\n },\n goto(step: number | string): void {\n guard();\n const index = typeof step === 'number' ? step : config.steps.findIndex((candidate) => candidate.id === step);\n if (index < 0 || index >= config.steps.length) {\n warn(`goto: step \"${String(step)}\" is not part of tour \"${config.id}\"`);\n return;\n }\n advanceTo(index);\n },\n id: config.id,\n next(): void {\n guard();\n advanceTo(current.peek().stepIndex + 1);\n },\n pause(): void {\n guard();\n if (status.peek() !== 'active') return;\n stopTargetWatch();\n current.value = { ...current.peek(), rect: null };\n setStatus('paused');\n },\n reset(): void {\n guard();\n stopTargetWatch();\n clearPersisted();\n current.value = {\n placement: config.placement ?? 'auto',\n presentation: config.presentation ?? 'auto',\n rect: null,\n step: null,\n stepIndex: -1,\n totalSteps: config.steps.length,\n };\n status.value = 'idle';\n eligible.value = true;\n emit({ status: 'idle', type: 'status-change' });\n },\n skip(): void {\n guard();\n if (status.peek() === 'completed' || status.peek() === 'dismissed') return;\n stopTargetWatch();\n current.value = { ...current.peek(), rect: null, step: null, stepIndex: -1 };\n setStatus('dismissed');\n emit({ reason: 'skip', type: 'tour:complete' });\n },\n start: startInternal,\n status,\n steps: config.steps,\n tap,\n [Symbol.dispose](): void {\n this.dispose();\n },\n };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"tour.cjs","names":["BeaconConfigError","createMemoryStorage","storageKey","createTappers","signal","BeaconDisposedError","resolveTarget","sameRect","observeTarget","observeTargetLayout","targetAvailable","parseProgress","require__emit","require__scroll","require__storage","require__target","require_errors","require_target","_vielzeug_ripple","config","seen","step","version","targetTimeoutMs","autoScroll","storage","key","controller","disposal","warnTap","clearTappers","status","eligible","current","loadSequence","record","result","error","next","emit","rect","stopped","stopObserver","target","stopLayout","index","previous","waiting","timer","s","resumeAt","sequence","stored","raw","loaded","candidate"],"sources":["../src/tour.ts"],"sourcesContent":["import { signal } from '@vielzeug/ripple';\nimport { devOnly, warn } from './_dev';\nimport { createTappers } from './_emit';\nimport { scrollTargetIntoView } from './_scroll';\nimport { createMemoryStorage, parseProgress, storageKey } from './_storage';\nimport { observeTarget, observeTargetLayout } from './_target';\nimport { BeaconConfigError, BeaconDisposedError } from './errors';\nimport { resolveTarget, sameRect, targetAvailable } from './target';\nimport type {\n BeaconCurrentStep,\n BeaconProgress,\n BeaconStatus,\n BeaconTarget,\n BeaconTourConfig,\n BeaconTourEvent,\n BeaconTourHandle,\n} from './types';\n\nconst validateConfig = (config: BeaconTourConfig): void => {\n if (!config.id) throw new BeaconConfigError('createTour: \"id\" must be a non-empty string');\n if (!Array.isArray(config.steps) || config.steps.length === 0) {\n throw new BeaconConfigError(`createTour: tour \"${config.id}\" must have at least one step`);\n }\n\n const seen = new Set<string>();\n for (const step of config.steps) {\n if (!step.id) throw new BeaconConfigError(`createTour: every step of tour \"${config.id}\" needs a non-empty id`);\n if (seen.has(step.id)) {\n throw new BeaconConfigError(`createTour: duplicate step id \"${step.id}\" in tour \"${config.id}\"`);\n }\n seen.add(step.id);\n }\n};\n\n/**\n * Creates a guided tour: a sequential, resumable walkthrough over the app's own\n * DOM. The engine owns step order, target waiting, persistence, and events; a\n * presentation layer (refine's tour components or the app's markup) renders\n * `current` wherever it likes.\n *\n * Progress persists under the tour's id. A stored record written under an older\n * `version` makes the tour eligible again, which is how feature announcements\n * re-reach users who finished the original tour.\n */\nexport function createTour(config: BeaconTourConfig): BeaconTourHandle {\n validateConfig(config);\n\n const version = config.version ?? 1;\n const targetTimeoutMs = config.targetTimeoutMs ?? Number.POSITIVE_INFINITY;\n const autoScroll = config.autoScroll ?? true;\n const storage = config.storage ?? createMemoryStorage();\n const key = storageKey(config.id);\n\n const controller = new AbortController();\n const { signal: disposal } = controller;\n const { emit, warn: warnTap, tap, clear: clearTappers } = createTappers<BeaconTourEvent>(disposal);\n\n const status = signal<BeaconStatus>('idle');\n const eligible = signal(true);\n const current = signal<BeaconCurrentStep>({\n placement: config.placement ?? 'auto',\n presentation: config.presentation ?? 'auto',\n rect: null,\n step: null,\n stepIndex: -1,\n totalSteps: config.steps.length,\n });\n\n let stopWaiting: (() => void) | null = null;\n let loadSequence = 0;\n\n const disposedError = (): BeaconDisposedError => new BeaconDisposedError('This tour handle has been disposed.');\n const guard = (): void => {\n if (disposal.aborted) throw disposedError();\n };\n\n const persist = (): void => {\n const record: BeaconProgress = { status: status.peek(), stepIndex: current.peek().stepIndex, version };\n\n try {\n const result = storage.set(key, record) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n };\n\n const clearPersisted = (): void => {\n try {\n const result = storage.remove(key) as unknown;\n if (result instanceof Promise) result.catch((error: unknown) => warnTap(error));\n } catch (error) {\n warnTap(error);\n }\n };\n\n const setStatus = (next: BeaconStatus): void => {\n if (status.peek() === next) return;\n status.value = next;\n persist();\n emit({ status: next, type: 'status-change' });\n };\n\n const stopTargetWatch = (): void => {\n stopWaiting?.();\n stopWaiting = null;\n };\n\n /** Re-reads the active step's rect; republishes only when it actually moved. */\n const refreshActiveRect = (): void => {\n const step = current.peek().step;\n if (!step?.target) return;\n const rect = resolveTarget(step.target);\n if (sameRect(rect, current.peek().rect)) return;\n current.value = { ...current.peek(), rect };\n };\n\n /**\n * Keeps the active step's rect honest for as long as the step is visible:\n * scroll and resize move the target, the target's own box can resize, and\n * content added elsewhere on the page can push it around without either —\n * all of which refresh the rect. A target that leaves the document\n * (collapsed menu, route change) drops the rect to `null` instead of\n * anchoring the card to a ghost. The card's positioner re-measures on the\n * repaint the rect write triggers, so no extra listener is needed there.\n */\n const watchActiveTarget = (target: BeaconTarget): (() => void) => {\n let stopped = false;\n const onLayout = (): void => {\n if (!stopped) refreshActiveRect();\n };\n\n window.addEventListener('scroll', onLayout, { passive: true });\n window.addEventListener('resize', onLayout);\n const stopObserver = observeTarget(target, onLayout, disposal);\n const stopLayout = observeTargetLayout(target, onLayout, disposal);\n const stop = (): void => {\n if (stopped) return;\n stopped = true;\n window.removeEventListener('scroll', onLayout);\n window.removeEventListener('resize', onLayout);\n stopObserver?.();\n stopLayout?.();\n };\n disposal.addEventListener('abort', stop, { once: true });\n\n return stop;\n };\n\n /** Publishes `index` as the visible step: completes the previous step, emits step:start, scrolls. */\n const publishStep = (index: number): void => {\n stopTargetWatch();\n const step = config.steps[index] ?? null;\n const previous = current.peek().step;\n if (previous && previous !== step) emit({ index: current.peek().stepIndex, step: previous, type: 'step:complete' });\n\n current.value = {\n placement: step?.placement ?? config.placement ?? 'auto',\n presentation: step?.presentation ?? config.presentation ?? 'auto',\n rect: step?.target ? resolveTarget(step.target) : null,\n step,\n stepIndex: index,\n totalSteps: config.steps.length,\n };\n\n if (step) {\n emit({ index, step, type: 'step:start' });\n if (autoScroll && step.target) scrollTargetIntoView(step.target, { offset: config.scrollOffset });\n if (step.target) stopWaiting = watchActiveTarget(step.target);\n }\n };\n\n const finishInternal = (reason: 'finish' | 'skip'): void => {\n stopTargetWatch();\n const step = current.peek().step;\n if (step) emit({ index: current.peek().stepIndex, step, type: 'step:complete' });\n current.value = { ...current.peek(), rect: null, step: null, stepIndex: -1 };\n setStatus('completed');\n emit({ reason, type: 'tour:complete' });\n };\n\n /**\n * Makes `index` the active step, waiting for its target when it is not on\n * screen yet (lazy route, closed dialog) and reporting `target-waiting` so a\n * presentation can say \"continue when you're ready\" instead of looking\n * frozen. A step without a target (intro or outro) and a `targetTimeoutMs`\n * of `0` publish immediately.\n */\n const activateStep = (index: number): void => {\n stopTargetWatch();\n const step = config.steps[index];\n if (!step) return;\n\n if (!step.target || targetTimeoutMs === 0 || targetAvailable(step.target)) {\n publishStep(index);\n return;\n }\n\n let waiting = true;\n let timer: ReturnType<typeof setTimeout> | null = null;\n let stopObserver: (() => void) | null = null;\n const target = step.target;\n stopWaiting = (): void => {\n waiting = false;\n stopObserver?.();\n stopObserver = null;\n if (timer !== null) {\n clearTimeout(timer);\n timer = null;\n }\n };\n\n stopObserver = observeTarget(\n target,\n () => {\n if (waiting && targetAvailable(target)) {\n publishStep(index);\n }\n },\n disposal,\n );\n\n if (!stopObserver) {\n devOnly(() => warn(`step \"${step.id}\" of tour \"${config.id}\" has a static target that is not in the document`));\n }\n\n emit({ index, message: `Waiting for step \"${step.id}\" to become visible.`, step, type: 'target-waiting' });\n\n if (Number.isFinite(targetTimeoutMs)) {\n timer = setTimeout(() => {\n if (!waiting) return;\n stopTargetWatch();\n emit({\n message: `Skipped step \"${step.id}\": its target did not appear within ${targetTimeoutMs}ms.`,\n type: 'target-missing',\n });\n if (index + 1 < config.steps.length) activateStep(index + 1);\n else finishInternal('finish');\n }, targetTimeoutMs);\n }\n };\n\n const advanceTo = (index: number): void => {\n if (index < 0) return;\n if (index >= config.steps.length) {\n finishInternal('finish');\n return;\n }\n if (status.peek() !== 'active') setStatus('active');\n activateStep(index);\n };\n\n const startInternal = (): void => {\n guard();\n const s = status.peek();\n if (s === 'completed' || s === 'dismissed' || s === 'active') return;\n const resumeAt = Math.max(0, current.peek().stepIndex);\n setStatus('active');\n activateStep(resumeAt);\n };\n\n // Boot: load persisted progress, then decide eligibility and optional autoStart.\n const sequence = ++loadSequence;\n const applyStored = (raw: unknown): void => {\n if (sequence !== loadSequence || disposal.aborted) return;\n const stored = parseProgress(raw);\n\n if (stored && stored.version >= version) {\n if (stored.status === 'completed' || stored.status === 'dismissed') {\n status.value = stored.status;\n eligible.value = false;\n return;\n }\n if (stored.status === 'active' || stored.status === 'paused') {\n status.value = 'paused';\n current.value = { ...current.peek(), stepIndex: Math.min(stored.stepIndex, config.steps.length - 1) };\n }\n }\n // Fresh, paused, or superseded by a newer version: eligible.\n eligible.value = true;\n if (config.autoStart) {\n queueMicrotask(() => {\n if (!disposal.aborted) startInternal();\n });\n }\n };\n\n try {\n const loaded = storage.get(key) as unknown;\n if (loaded instanceof Promise) loaded.then(applyStored, (error: unknown) => warnTap(error));\n else applyStored(loaded);\n } catch (error) {\n warnTap(error);\n }\n\n return {\n back(): void {\n guard();\n advanceTo(current.peek().stepIndex - 1);\n },\n current,\n dismiss(): void {\n guard();\n if (status.peek() === 'completed' || status.peek() === 'dismissed') return;\n stopTargetWatch();\n current.value = { ...current.peek(), rect: null, step: null, stepIndex: -1 };\n setStatus('dismissed');\n emit({ type: 'tour:dismiss' });\n },\n disposalSignal: disposal,\n dispose(): void {\n if (disposal.aborted) return;\n emit({ type: 'dispose' });\n stopTargetWatch();\n controller.abort();\n clearTappers();\n },\n get disposed(): boolean {\n return disposal.aborted;\n },\n eligible,\n finish(): void {\n guard();\n if (status.peek() === 'completed') return;\n finishInternal('finish');\n },\n goto(step: number | string): void {\n guard();\n const index = typeof step === 'number' ? step : config.steps.findIndex((candidate) => candidate.id === step);\n if (index < 0 || index >= config.steps.length) {\n warn(`goto: step \"${String(step)}\" is not part of tour \"${config.id}\"`);\n return;\n }\n advanceTo(index);\n },\n id: config.id,\n next(): void {\n guard();\n advanceTo(current.peek().stepIndex + 1);\n },\n pause(): void {\n guard();\n if (status.peek() !== 'active') return;\n stopTargetWatch();\n current.value = { ...current.peek(), rect: null };\n setStatus('paused');\n },\n reset(): void {\n guard();\n stopTargetWatch();\n clearPersisted();\n current.value = {\n placement: config.placement ?? 'auto',\n presentation: config.presentation ?? 'auto',\n rect: null,\n step: null,\n stepIndex: -1,\n totalSteps: config.steps.length,\n };\n status.value = 'idle';\n eligible.value = true;\n emit({ status: 'idle', type: 'status-change' });\n },\n skip(): void {\n guard();\n if (status.peek() === 'completed' || status.peek() === 'dismissed') return;\n stopTargetWatch();\n current.value = { ...current.peek(), rect: null, step: null, stepIndex: -1 };\n setStatus('dismissed');\n emit({ reason: 'skip', type: 'tour:complete' });\n },\n start: startInternal,\n status,\n steps: config.steps,\n tap,\n [Symbol.dispose](): void {\n this.dispose();\n },\n };\n}\n"],"mappings":"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"}
|
package/dist/tour.js
CHANGED
|
@@ -1,32 +1,32 @@
|
|
|
1
|
-
import { createTappers as e } from "./_emit.js";
|
|
2
|
-
import { createMemoryStorage as t, parseProgress as n, storageKey as r } from "./_storage.js";
|
|
3
|
-
import { resolveTarget as i, sameRect as a, targetAvailable as o } from "./target.js";
|
|
4
|
-
import { observeTarget as s, observeTargetLayout as c } from "./_target.js";
|
|
5
|
-
import { BeaconConfigError as l, BeaconDisposedError as u } from "./errors.js";
|
|
6
1
|
import "./_dev.js";
|
|
7
|
-
import {
|
|
2
|
+
import { createTappers as e } from "./_emit.js";
|
|
3
|
+
import { scrollTargetIntoView as t } from "./_scroll.js";
|
|
4
|
+
import { createMemoryStorage as n, parseProgress as r, storageKey as i } from "./_storage.js";
|
|
5
|
+
import { observeTarget as a, observeTargetLayout as o } from "./_target.js";
|
|
6
|
+
import { BeaconConfigError as s, BeaconDisposedError as c } from "./errors.js";
|
|
7
|
+
import { resolveTarget as l, sameRect as u, targetAvailable as d } from "./target.js";
|
|
8
8
|
import { signal as f } from "@vielzeug/ripple";
|
|
9
|
-
|
|
9
|
+
// src/tour.ts
|
|
10
10
|
var validateConfig = (e) => {
|
|
11
|
-
if (!e.id) throw new
|
|
12
|
-
if (!Array.isArray(e.steps) || e.steps.length === 0) throw new
|
|
11
|
+
if (!e.id) throw new s("createTour: \"id\" must be a non-empty string");
|
|
12
|
+
if (!Array.isArray(e.steps) || e.steps.length === 0) throw new s(`createTour: tour "${e.id}" must have at least one step`);
|
|
13
13
|
let t = /* @__PURE__ */ new Set();
|
|
14
14
|
for (let n of e.steps) {
|
|
15
|
-
if (!n.id) throw new
|
|
16
|
-
if (t.has(n.id)) throw new
|
|
15
|
+
if (!n.id) throw new s(`createTour: every step of tour "${e.id}" needs a non-empty id`);
|
|
16
|
+
if (t.has(n.id)) throw new s(`createTour: duplicate step id "${n.id}" in tour "${e.id}"`);
|
|
17
17
|
t.add(n.id);
|
|
18
18
|
}
|
|
19
19
|
};
|
|
20
|
-
function createTour(
|
|
21
|
-
validateConfig(
|
|
22
|
-
let p =
|
|
23
|
-
placement:
|
|
24
|
-
presentation:
|
|
20
|
+
function createTour(s) {
|
|
21
|
+
validateConfig(s);
|
|
22
|
+
let p = s.version ?? 1, m = s.targetTimeoutMs ?? Infinity, h = s.autoScroll ?? !0, g = s.storage ?? n(), _ = i(s.id), v = new AbortController(), { signal: y } = v, { emit: b, warn: x, tap: S, clear: C } = e(y), w = f("idle"), T = f(!0), E = f({
|
|
23
|
+
placement: s.placement ?? "auto",
|
|
24
|
+
presentation: s.presentation ?? "auto",
|
|
25
25
|
rect: null,
|
|
26
26
|
step: null,
|
|
27
27
|
stepIndex: -1,
|
|
28
|
-
totalSteps:
|
|
29
|
-
}), stopWaiting = null, D = 0, disposedError = () => new
|
|
28
|
+
totalSteps: s.steps.length
|
|
29
|
+
}), stopWaiting = null, D = 0, disposedError = () => new c("This tour handle has been disposed."), guard = () => {
|
|
30
30
|
if (y.aborted) throw disposedError();
|
|
31
31
|
}, persist = () => {
|
|
32
32
|
let e = {
|
|
@@ -57,8 +57,8 @@ function createTour(l) {
|
|
|
57
57
|
}, refreshActiveRect = () => {
|
|
58
58
|
let e = E.peek().step;
|
|
59
59
|
if (!e?.target) return;
|
|
60
|
-
let t =
|
|
61
|
-
|
|
60
|
+
let t = l(e.target);
|
|
61
|
+
u(t, E.peek().rect) || (E.value = {
|
|
62
62
|
...E.peek(),
|
|
63
63
|
rect: t
|
|
64
64
|
});
|
|
@@ -67,29 +67,29 @@ function createTour(l) {
|
|
|
67
67
|
t || refreshActiveRect();
|
|
68
68
|
};
|
|
69
69
|
window.addEventListener("scroll", onLayout, { passive: !0 }), window.addEventListener("resize", onLayout);
|
|
70
|
-
let n =
|
|
70
|
+
let n = a(e, onLayout, y), r = o(e, onLayout, y), stop = () => {
|
|
71
71
|
t || (t = !0, window.removeEventListener("scroll", onLayout), window.removeEventListener("resize", onLayout), n?.(), r?.());
|
|
72
72
|
};
|
|
73
73
|
return y.addEventListener("abort", stop, { once: !0 }), stop;
|
|
74
74
|
}, publishStep = (e) => {
|
|
75
75
|
stopTargetWatch();
|
|
76
|
-
let
|
|
77
|
-
|
|
76
|
+
let n = s.steps[e] ?? null, r = E.peek().step;
|
|
77
|
+
r && r !== n && b({
|
|
78
78
|
index: E.peek().stepIndex,
|
|
79
|
-
step:
|
|
79
|
+
step: r,
|
|
80
80
|
type: "step:complete"
|
|
81
81
|
}), E.value = {
|
|
82
|
-
placement:
|
|
83
|
-
presentation:
|
|
84
|
-
rect:
|
|
85
|
-
step:
|
|
82
|
+
placement: n?.placement ?? s.placement ?? "auto",
|
|
83
|
+
presentation: n?.presentation ?? s.presentation ?? "auto",
|
|
84
|
+
rect: n?.target ? l(n.target) : null,
|
|
85
|
+
step: n,
|
|
86
86
|
stepIndex: e,
|
|
87
|
-
totalSteps:
|
|
88
|
-
},
|
|
87
|
+
totalSteps: s.steps.length
|
|
88
|
+
}, n && (b({
|
|
89
89
|
index: e,
|
|
90
|
-
step:
|
|
90
|
+
step: n,
|
|
91
91
|
type: "step:start"
|
|
92
|
-
}), h &&
|
|
92
|
+
}), h && n.target && t(n.target, { offset: s.scrollOffset }), n.target && (stopWaiting = watchActiveTarget(n.target)));
|
|
93
93
|
}, finishInternal = (e) => {
|
|
94
94
|
stopTargetWatch();
|
|
95
95
|
let t = E.peek().step;
|
|
@@ -108,17 +108,17 @@ function createTour(l) {
|
|
|
108
108
|
});
|
|
109
109
|
}, activateStep = (e) => {
|
|
110
110
|
stopTargetWatch();
|
|
111
|
-
let t =
|
|
111
|
+
let t = s.steps[e];
|
|
112
112
|
if (!t) return;
|
|
113
|
-
if (!t.target || m === 0 ||
|
|
113
|
+
if (!t.target || m === 0 || d(t.target)) {
|
|
114
114
|
publishStep(e);
|
|
115
115
|
return;
|
|
116
116
|
}
|
|
117
|
-
let n = !0, r = null, i = null,
|
|
117
|
+
let n = !0, r = null, i = null, o = t.target;
|
|
118
118
|
stopWaiting = () => {
|
|
119
119
|
n = !1, i?.(), i = null, r !== null && (clearTimeout(r), r = null);
|
|
120
|
-
}, i =
|
|
121
|
-
n && o
|
|
120
|
+
}, i = a(o, () => {
|
|
121
|
+
n && d(o) && publishStep(e);
|
|
122
122
|
}, y), b({
|
|
123
123
|
index: e,
|
|
124
124
|
message: `Waiting for step "${t.id}" to become visible.`,
|
|
@@ -128,10 +128,10 @@ function createTour(l) {
|
|
|
128
128
|
n && (stopTargetWatch(), b({
|
|
129
129
|
message: `Skipped step "${t.id}": its target did not appear within ${m}ms.`,
|
|
130
130
|
type: "target-missing"
|
|
131
|
-
}), e + 1 <
|
|
131
|
+
}), e + 1 < s.steps.length ? activateStep(e + 1) : finishInternal("finish"));
|
|
132
132
|
}, m));
|
|
133
133
|
}, advanceTo = (e) => {
|
|
134
|
-
e < 0 || (e >=
|
|
134
|
+
e < 0 || (e >= s.steps.length ? finishInternal("finish") : (w.peek() !== "active" && setStatus("active"), activateStep(e)));
|
|
135
135
|
}, startInternal = () => {
|
|
136
136
|
guard();
|
|
137
137
|
let e = w.peek();
|
|
@@ -140,7 +140,7 @@ function createTour(l) {
|
|
|
140
140
|
setStatus("active"), activateStep(t);
|
|
141
141
|
}, O = ++D, applyStored = (e) => {
|
|
142
142
|
if (O !== D || y.aborted) return;
|
|
143
|
-
let t =
|
|
143
|
+
let t = r(e);
|
|
144
144
|
if (t && t.version >= p) {
|
|
145
145
|
if (t.status === "completed" || t.status === "dismissed") {
|
|
146
146
|
w.value = t.status, T.value = !1;
|
|
@@ -148,10 +148,10 @@ function createTour(l) {
|
|
|
148
148
|
}
|
|
149
149
|
(t.status === "active" || t.status === "paused") && (w.value = "paused", E.value = {
|
|
150
150
|
...E.peek(),
|
|
151
|
-
stepIndex: Math.min(t.stepIndex,
|
|
151
|
+
stepIndex: Math.min(t.stepIndex, s.steps.length - 1)
|
|
152
152
|
});
|
|
153
153
|
}
|
|
154
|
-
T.value = !0,
|
|
154
|
+
T.value = !0, s.autoStart && queueMicrotask(() => {
|
|
155
155
|
y.aborted || startInternal();
|
|
156
156
|
});
|
|
157
157
|
};
|
|
@@ -187,10 +187,10 @@ function createTour(l) {
|
|
|
187
187
|
},
|
|
188
188
|
goto(e) {
|
|
189
189
|
guard();
|
|
190
|
-
let t = typeof e == "number" ? e :
|
|
191
|
-
t < 0 || t >=
|
|
190
|
+
let t = typeof e == "number" ? e : s.steps.findIndex((t) => t.id === e);
|
|
191
|
+
t < 0 || t >= s.steps.length ? `${String(e)}${s.id}` : advanceTo(t);
|
|
192
192
|
},
|
|
193
|
-
id:
|
|
193
|
+
id: s.id,
|
|
194
194
|
next() {
|
|
195
195
|
guard(), advanceTo(E.peek().stepIndex + 1);
|
|
196
196
|
},
|
|
@@ -202,12 +202,12 @@ function createTour(l) {
|
|
|
202
202
|
},
|
|
203
203
|
reset() {
|
|
204
204
|
guard(), stopTargetWatch(), clearPersisted(), E.value = {
|
|
205
|
-
placement:
|
|
206
|
-
presentation:
|
|
205
|
+
placement: s.placement ?? "auto",
|
|
206
|
+
presentation: s.presentation ?? "auto",
|
|
207
207
|
rect: null,
|
|
208
208
|
step: null,
|
|
209
209
|
stepIndex: -1,
|
|
210
|
-
totalSteps:
|
|
210
|
+
totalSteps: s.steps.length
|
|
211
211
|
}, w.value = "idle", T.value = !0, b({
|
|
212
212
|
status: "idle",
|
|
213
213
|
type: "status-change"
|
|
@@ -226,14 +226,13 @@ function createTour(l) {
|
|
|
226
226
|
},
|
|
227
227
|
start: startInternal,
|
|
228
228
|
status: w,
|
|
229
|
-
steps:
|
|
229
|
+
steps: s.steps,
|
|
230
230
|
tap: S,
|
|
231
231
|
[Symbol.dispose]() {
|
|
232
232
|
this.dispose();
|
|
233
233
|
}
|
|
234
234
|
};
|
|
235
235
|
}
|
|
236
|
-
//#endregion
|
|
237
236
|
export { createTour };
|
|
238
237
|
|
|
239
238
|
//# sourceMappingURL=tour.js.map
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vielzeug/beacon",
|
|
3
|
-
"version": "26.11.
|
|
3
|
+
"version": "26.11.6",
|
|
4
4
|
"description": "Guided onboarding and contextual product tours for web applications",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -31,22 +31,22 @@
|
|
|
31
31
|
"registry": "https://registry.npmjs.org/"
|
|
32
32
|
},
|
|
33
33
|
"scripts": {
|
|
34
|
-
"build": "vite build &&
|
|
34
|
+
"build": "vite build && bun run --silent build:bundle && bun run --silent build:types",
|
|
35
35
|
"build:bundle": "vite build --config vite.bundle.config.ts",
|
|
36
36
|
"build:types": "tsc -p tsconfig.declarations.json",
|
|
37
37
|
"fix": "biome check --write src",
|
|
38
38
|
"lint": "biome ci src",
|
|
39
|
-
"prepublishOnly": "
|
|
39
|
+
"prepublishOnly": "bun run --silent build",
|
|
40
40
|
"test": "vitest"
|
|
41
41
|
},
|
|
42
42
|
"dependencies": {
|
|
43
|
-
"@vielzeug/ripple": "26.11.
|
|
43
|
+
"@vielzeug/ripple": "26.11.6"
|
|
44
44
|
},
|
|
45
45
|
"devDependencies": {
|
|
46
|
-
"@types/node": "^26.6.
|
|
47
|
-
"jsdom": "^
|
|
46
|
+
"@types/node": "^26.6.6",
|
|
47
|
+
"jsdom": "^31.0.0",
|
|
48
48
|
"typescript": "^6.0.3",
|
|
49
|
-
"vite": "^8.3.
|
|
50
|
-
"vitest": "^5.0
|
|
49
|
+
"vite": "^8.3.6",
|
|
50
|
+
"vitest": "^5.1.0"
|
|
51
51
|
}
|
|
52
52
|
}
|