@vielzeug/beacon 0.0.0-stage → 26.10.17
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/LICENSE +21 -0
- package/README.md +56 -2
- package/dist/_dev.cjs +2 -0
- package/dist/_dev.cjs.map +1 -0
- package/dist/_dev.d.ts +2 -0
- package/dist/_dev.d.ts.map +1 -0
- package/dist/_dev.js +7 -0
- package/dist/_dev.js.map +1 -0
- package/dist/_emit.cjs +2 -0
- package/dist/_emit.cjs.map +1 -0
- package/dist/_emit.d.ts +12 -0
- package/dist/_emit.d.ts.map +1 -0
- package/dist/_emit.js +30 -0
- package/dist/_emit.js.map +1 -0
- package/dist/_scroll.cjs +2 -0
- package/dist/_scroll.cjs.map +1 -0
- package/dist/_scroll.d.ts +14 -0
- package/dist/_scroll.d.ts.map +1 -0
- package/dist/_scroll.js +17 -0
- package/dist/_scroll.js.map +1 -0
- package/dist/_storage.cjs +2 -0
- package/dist/_storage.cjs.map +1 -0
- package/dist/_storage.d.ts +10 -0
- package/dist/_storage.d.ts.map +1 -0
- package/dist/_storage.js +33 -0
- package/dist/_storage.js.map +1 -0
- package/dist/_target.cjs +2 -0
- package/dist/_target.cjs.map +1 -0
- package/dist/_target.d.ts +2 -0
- package/dist/_target.d.ts.map +1 -0
- package/dist/_target.js +32 -0
- package/dist/_target.js.map +1 -0
- package/dist/beacon.cjs +2 -0
- package/dist/beacon.cjs.map +1 -0
- package/dist/beacon.iife.js +2 -0
- package/dist/beacon.iife.js.map +1 -0
- package/dist/beacon.js +486 -0
- package/dist/beacon.js.map +1 -0
- package/dist/coachmark.cjs +2 -0
- package/dist/coachmark.cjs.map +1 -0
- package/dist/coachmark.d.ts +12 -0
- package/dist/coachmark.d.ts.map +1 -0
- package/dist/coachmark.js +125 -0
- package/dist/coachmark.js.map +1 -0
- package/dist/errors.cjs +2 -0
- package/dist/errors.cjs.map +1 -0
- package/dist/errors.d.ts +11 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +10 -0
- package/dist/errors.js.map +1 -0
- package/dist/index.cjs +1 -0
- package/dist/index.d.ts +6 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +5 -0
- package/dist/target.cjs +2 -0
- package/dist/target.cjs.map +1 -0
- package/dist/target.d.ts +15 -0
- package/dist/target.d.ts.map +1 -0
- package/dist/target.js +36 -0
- package/dist/target.js.map +1 -0
- package/dist/tour.cjs +2 -0
- package/dist/tour.cjs.map +1 -0
- package/dist/tour.d.ts +13 -0
- package/dist/tour.d.ts.map +1 -0
- package/dist/tour.js +239 -0
- package/dist/tour.js.map +1 -0
- package/dist/types.d.ts +248 -0
- package/dist/types.d.ts.map +1 -0
- package/package.json +50 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Helmuth Saatkamp
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,57 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @vielzeug/beacon
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> Guided onboarding and contextual product tours for web applications
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
pnpm add @vielzeug/beacon
|
|
9
|
+
npm install @vielzeug/beacon
|
|
10
|
+
yarn add @vielzeug/beacon
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Quick Start
|
|
14
|
+
|
|
15
|
+
```ts
|
|
16
|
+
import { createTour, type BeaconTourConfig } from '@vielzeug/beacon';
|
|
17
|
+
|
|
18
|
+
const tour = createTour({
|
|
19
|
+
id: 'getting-started',
|
|
20
|
+
steps: [
|
|
21
|
+
{ id: 'welcome', title: 'Welcome', description: 'A two-minute look around.' },
|
|
22
|
+
{ id: 'nav', target: '[data-tour="nav"]', title: 'Navigation', placement: 'bottom-start' },
|
|
23
|
+
],
|
|
24
|
+
} satisfies BeaconTourConfig);
|
|
25
|
+
|
|
26
|
+
// Render the live snapshot wherever you like: rect is the anchor, null centers.
|
|
27
|
+
const unsubscribe = tour.current.subscribe(() => renderCard(tour.current.value));
|
|
28
|
+
|
|
29
|
+
tour.start(); // no-op for users who already completed the tour
|
|
30
|
+
|
|
31
|
+
// On teardown:
|
|
32
|
+
unsubscribe();
|
|
33
|
+
tour.dispose();
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Beacon never renders: it owns step order, target waiting, and persisted progress, while your markup — or `@vielzeug/refine`'s `ore-tour` components — presents each step.
|
|
37
|
+
|
|
38
|
+
## Features
|
|
39
|
+
|
|
40
|
+
- `createTour()` runs a sequential, resumable walkthrough over your own DOM.
|
|
41
|
+
- `createCoachmark()` shows a single contextual hint once per user per version.
|
|
42
|
+
- `current` is a live snapshot with the anchor rect kept fresh on scroll and resize.
|
|
43
|
+
- `BeaconStorage` persists progress through any sync or async key-value bridge.
|
|
44
|
+
- `tap()` reports lifecycle events such as `step:start`, `tour:complete`, and `target-missing`.
|
|
45
|
+
- `@vielzeug/refine`'s `ore-tour` renders a handle with one `card.bind(tour)` call.
|
|
46
|
+
|
|
47
|
+
## Documentation
|
|
48
|
+
|
|
49
|
+
- [Overview](https://vielzeug.dev/beacon/)
|
|
50
|
+
- [Usage Guide](https://vielzeug.dev/beacon/usage)
|
|
51
|
+
- [API Reference](https://vielzeug.dev/beacon/api)
|
|
52
|
+
- [Examples](https://vielzeug.dev/beacon/examples)
|
|
53
|
+
- [Migration](https://vielzeug.dev/beacon/migration)
|
|
54
|
+
|
|
55
|
+
## License
|
|
56
|
+
|
|
57
|
+
MIT © [Helmuth Saatkamp](https://github.com/helmuthdu): part of the [Vielzeug](https://github.com/helmuthdu/vielzeug) monorepo.
|
package/dist/_dev.cjs
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_dev.cjs","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["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"],"mappings":"AAGA,SAAgB,KAAK,EAAmB,CAExC,CAGA,SAAgB,QAAQ,EAAsB,CAE9C,C"}
|
package/dist/_dev.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_dev.d.ts","sourceRoot":"","sources":["../src/_dev.ts"],"names":[],"mappings":""}
|
package/dist/_dev.js
ADDED
package/dist/_dev.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_dev.js","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["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"],"mappings":";AAGA,SAAgB,KAAK,GAAmB,CAExC;AAGA,SAAgB,QAAQ,GAAsB,CAE9C"}
|
package/dist/_emit.cjs
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
function createTappers(e){let t=new Set,emit=e=>{if(t.size!==0)for(let n of t)try{n(e)}catch{}},warn=e=>{t.size!==0&&emit({error:e,message:e instanceof Error?e.message:String(e),type:`warning`})},tap=(n,r)=>{if(e.aborted||r?.signal?.aborted)return()=>{};let detach=()=>{t.delete(n)};return t.add(n),e.addEventListener(`abort`,detach,{once:!0}),r?.signal?.addEventListener(`abort`,detach,{once:!0}),detach};return{clear:()=>t.clear(),emit,tap,warn}}exports.createTappers=createTappers;
|
|
2
|
+
//# sourceMappingURL=_emit.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_emit.cjs","names":["tappers","tapper","event","error","signal","options","handler"],"sources":["../src/_emit.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"],"mappings":"AACA,SAAgB,cAAmD,EAAqB,CACtF,IAAMA,EAAU,IAAI,IAEd,KAAQ,GAAmB,CAC/B,GAAIA,EAAQ,OAAS,EACrB,IAAK,IAAMC,KAAUD,EACnB,GAAI,CACFC,EAAOC,CAAK,CACd,MAAQ,CAER,CAEJ,EAEM,KAAQ,GAAyB,CACjCF,EAAQ,OAAS,GACrB,KAAK,CAAE,QAAO,QAASG,aAAiB,MAAQA,EAAM,QAAU,OAAOA,CAAK,EAAG,KAAM,SAAU,CAAiB,CAClH,EAEM,KAAO,EAA6B,IAA8D,CACtG,GAAIC,EAAO,SAAWC,GAAS,QAAQ,QAAS,UAAa,CAAC,EAC9D,IAAM,WAAqB,CACzBL,EAAQ,OAAOM,CAAO,CACxB,EAKA,OAJAN,EAAQ,IAAIM,CAAO,EACnBF,EAAO,iBAAiB,QAAS,OAAQ,CAAE,KAAM,EAAK,CAAC,EACvDC,GAAS,QAAQ,iBAAiB,QAAS,OAAQ,CAAE,KAAM,EAAK,CAAC,EAE1D,MACT,EAEA,MAAO,CAAE,UAAaL,EAAQ,MAAM,EAAG,KAAM,IAAK,IAAK,CACzD,C"}
|
package/dist/_emit.d.ts
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/** Shared tap() plumbing: zero overhead when idle, handler errors swallowed, auto-detach on abort. */
|
|
2
|
+
export declare function createTappers<E extends {
|
|
3
|
+
readonly type: string;
|
|
4
|
+
}>(signal: AbortSignal): {
|
|
5
|
+
clear: () => void;
|
|
6
|
+
emit: (event: E) => void;
|
|
7
|
+
tap: (handler: (event: E) => void, options?: {
|
|
8
|
+
readonly signal?: AbortSignal;
|
|
9
|
+
}) => (() => void);
|
|
10
|
+
warn: (error: unknown) => void;
|
|
11
|
+
};
|
|
12
|
+
//# sourceMappingURL=_emit.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_emit.d.ts","sourceRoot":"","sources":["../src/_emit.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,WAAW;;kBAG/D,CAAC,KAAG,IAAI;mBAgBP,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,YAAY;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAAG,CAAC,MAAM,IAAI,CAAC;kBAL/E,OAAO,KAAG,IAAI;EAkBpC"}
|
package/dist/_emit.js
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
//#region src/_emit.ts
|
|
2
|
+
function createTappers(e) {
|
|
3
|
+
let t = /* @__PURE__ */ new Set(), emit = (e) => {
|
|
4
|
+
if (t.size !== 0) for (let n of t) try {
|
|
5
|
+
n(e);
|
|
6
|
+
} catch {}
|
|
7
|
+
}, warn = (e) => {
|
|
8
|
+
t.size !== 0 && emit({
|
|
9
|
+
error: e,
|
|
10
|
+
message: e instanceof Error ? e.message : String(e),
|
|
11
|
+
type: "warning"
|
|
12
|
+
});
|
|
13
|
+
}, tap = (n, r) => {
|
|
14
|
+
if (e.aborted || r?.signal?.aborted) return () => {};
|
|
15
|
+
let detach = () => {
|
|
16
|
+
t.delete(n);
|
|
17
|
+
};
|
|
18
|
+
return t.add(n), e.addEventListener("abort", detach, { once: !0 }), r?.signal?.addEventListener("abort", detach, { once: !0 }), detach;
|
|
19
|
+
};
|
|
20
|
+
return {
|
|
21
|
+
clear: () => t.clear(),
|
|
22
|
+
emit,
|
|
23
|
+
tap,
|
|
24
|
+
warn
|
|
25
|
+
};
|
|
26
|
+
}
|
|
27
|
+
//#endregion
|
|
28
|
+
export { createTappers };
|
|
29
|
+
|
|
30
|
+
//# sourceMappingURL=_emit.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_emit.js","names":["tappers","tapper","event","error","signal","options","handler"],"sources":["../src/_emit.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"],"mappings":";AACA,SAAgB,cAAmD,GAAqB;CACtF,IAAMA,oBAAU,IAAI,IAAwB,GAEtC,QAAQ,MAAmB;EAC/B,IAAIA,EAAQ,SAAS,GACrB,KAAK,IAAMC,KAAUD,GACnB,IAAI;GACF,EAAOE,CAAK;EACd,QAAQ,CAER;CAEJ,GAEM,QAAQ,MAAyB;EACrC,AAAIF,EAAQ,SAAS,KACrB,KAAK;GAAE;GAAO,SAASG,aAAiB,QAAQA,EAAM,UAAU,OAAOA,CAAK;GAAG,MAAM;EAAU,CAAiB;CAClH,GAEM,OAAO,GAA6B,MAA8D;EACtG,IAAIC,EAAO,WAAWC,GAAS,QAAQ,SAAS,aAAa,CAAC;EAC9D,IAAM,eAAqB;GACzB,EAAQ,OAAOC,CAAO;EACxB;EAKA,OAJAN,EAAQ,IAAIM,CAAO,GACnBF,EAAO,iBAAiB,SAAS,QAAQ,EAAE,MAAM,GAAK,CAAC,GACvDC,GAAS,QAAQ,iBAAiB,SAAS,QAAQ,EAAE,MAAM,GAAK,CAAC,GAE1D;CACT;CAEA,OAAO;EAAE,aAAaL,EAAQ,MAAM;EAAG;EAAM;EAAK;CAAK;AACzD"}
|
package/dist/_scroll.cjs
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
const e=require("./target.cjs");var prefersReducedMotion=()=>typeof matchMedia==`function`&&matchMedia(`(prefers-reduced-motion: reduce)`).matches;function scrollTargetIntoView(t,n={}){if(typeof window>`u`||typeof document>`u`)return!1;let r=e.resolveTarget(t);if(!r)return!1;let i=n.behavior??(prefersReducedMotion()?`auto`:`smooth`),a=window.innerHeight||document.documentElement.clientHeight,o=typeof n.offset==`function`?n.offset():n.offset??0,s=r.y+(globalThis.scrollY??0),c=s-(a-r.height)/2,l=o>0&&s-c<o?s-o:c,u=Math.max(0,document.documentElement.scrollHeight-a),d=Math.min(Math.max(0,l),u);return window.scrollTo({behavior:i,top:d}),!0}exports.scrollTargetIntoView=scrollTargetIntoView;
|
|
2
|
+
//# sourceMappingURL=_scroll.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_scroll.cjs","names":["resolveTarget","require_target","before","target","behavior","options","viewportHeight","reserved","documentTop","idealTop","correctedTop","maxScroll","clampedTop"],"sources":["../src/_scroll.ts"],"sourcesContent":["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"],"mappings":"A,gCAWA,IAAM,yBACJ,OAAO,YAAe,YAAc,WAAW,kCAAkC,CAAC,CAAC,QAMrF,SAAgB,qBAAqB,EAAsB,EAAiC,CAAC,EAAY,CACvG,GAAI,OAAO,OAAW,KAAe,OAAO,SAAa,IAAa,MAAO,GAE7E,IAAME,EAASF,EAAAA,cAAcG,CAAM,EACnC,GAAI,CAACD,EAAQ,MAAO,GAEpB,IAAME,EAAWC,EAAQ,WAAa,qBAAqB,EAAI,OAAS,UAClEC,EAAiB,OAAO,aAAe,SAAS,gBAAgB,aAChEC,EAAW,OAAOF,EAAQ,QAAW,WAAaA,EAAQ,OAAO,EAAKA,EAAQ,QAAU,EAExFG,EAAcN,EAAO,GAAK,WAAW,SAAW,GAGhDO,EAAWD,GAAeF,EAAiBJ,EAAO,QAAU,EAI5DQ,EAAeH,EAAW,GAAKC,EAAcC,EAAWF,EAAWC,EAAcD,EAAWE,EAC5FE,EAAY,KAAK,IAAI,EAAG,SAAS,gBAAgB,aAAeL,CAAc,EAC9EM,EAAa,KAAK,IAAI,KAAK,IAAI,EAAGF,CAAY,EAAGC,CAAS,EAIhE,OAFA,OAAO,SAAS,CAAE,WAAU,IAAKC,CAAW,CAAC,EAEtC,EACT,C"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { BeaconTarget } from './types';
|
|
2
|
+
/** Options for {@link scrollTargetIntoView}. */
|
|
3
|
+
export interface ScrollIntoViewOptions {
|
|
4
|
+
/** Scroll behavior. Default `'smooth'` when the user has not requested reduced motion, else `'auto'`. */
|
|
5
|
+
readonly behavior?: 'auto' | 'instant' | 'smooth';
|
|
6
|
+
/** Pixels reserved at the top of the viewport for sticky headers. Number or a function read at scroll time. Default `0`. */
|
|
7
|
+
readonly offset?: number | (() => number);
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* Centers a target in the viewport, keeping it clear of a sticky header.
|
|
11
|
+
* Returns whether the target was found. No-op without a DOM.
|
|
12
|
+
*/
|
|
13
|
+
export declare function scrollTargetIntoView(target: BeaconTarget, options?: ScrollIntoViewOptions): boolean;
|
|
14
|
+
//# sourceMappingURL=_scroll.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_scroll.d.ts","sourceRoot":"","sources":["../src/_scroll.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,gDAAgD;AAChD,MAAM,WAAW,qBAAqB;IACpC,yGAAyG;IACzG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IAClD,4HAA4H;IAC5H,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;CAC3C;AAKD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAwBvG"}
|
package/dist/_scroll.js
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { resolveTarget as e } from "./target.js";
|
|
2
|
+
//#region src/_scroll.ts
|
|
3
|
+
var prefersReducedMotion = () => typeof matchMedia == "function" && matchMedia("(prefers-reduced-motion: reduce)").matches;
|
|
4
|
+
function scrollTargetIntoView(t, n = {}) {
|
|
5
|
+
if (typeof window > "u" || typeof document > "u") return !1;
|
|
6
|
+
let r = e(t);
|
|
7
|
+
if (!r) return !1;
|
|
8
|
+
let i = n.behavior ?? (prefersReducedMotion() ? "auto" : "smooth"), a = window.innerHeight || document.documentElement.clientHeight, o = typeof n.offset == "function" ? n.offset() : n.offset ?? 0, s = r.y + (globalThis.scrollY ?? 0), c = s - (a - r.height) / 2, l = o > 0 && s - c < o ? s - o : c, u = Math.max(0, document.documentElement.scrollHeight - a), d = Math.min(Math.max(0, l), u);
|
|
9
|
+
return window.scrollTo({
|
|
10
|
+
behavior: i,
|
|
11
|
+
top: d
|
|
12
|
+
}), !0;
|
|
13
|
+
}
|
|
14
|
+
//#endregion
|
|
15
|
+
export { scrollTargetIntoView };
|
|
16
|
+
|
|
17
|
+
//# sourceMappingURL=_scroll.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_scroll.js","names":["before","resolveTarget","target","behavior","options","viewportHeight","reserved","documentTop","idealTop","correctedTop","maxScroll","clampedTop"],"sources":["../src/_scroll.ts"],"sourcesContent":["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"],"mappings":";;AAWA,IAAM,6BACJ,OAAO,cAAe,cAAc,WAAW,kCAAkC,CAAC,CAAC;AAMrF,SAAgB,qBAAqB,GAAsB,IAAiC,CAAC,GAAY;CACvG,IAAI,OAAO,SAAW,OAAe,OAAO,WAAa,KAAa,OAAO;CAE7E,IAAMA,IAASC,EAAcC,CAAM;CACnC,IAAI,CAACF,GAAQ,OAAO;CAEpB,IAAMG,IAAWC,EAAQ,aAAa,qBAAqB,IAAI,SAAS,WAClEC,IAAiB,OAAO,eAAe,SAAS,gBAAgB,cAChEC,IAAW,OAAOF,EAAQ,UAAW,aAAaA,EAAQ,OAAO,IAAKA,EAAQ,UAAU,GAExFG,IAAcP,EAAO,KAAK,WAAW,WAAW,IAGhDQ,IAAWD,KAAeF,IAAiBL,EAAO,UAAU,GAI5DS,IAAeH,IAAW,KAAKC,IAAcC,IAAWF,IAAWC,IAAcD,IAAWE,GAC5FE,IAAY,KAAK,IAAI,GAAG,SAAS,gBAAgB,eAAeL,CAAc,GAC9EM,IAAa,KAAK,IAAI,KAAK,IAAI,GAAGF,CAAY,GAAGC,CAAS;CAIhE,OAFA,OAAO,SAAS;EAAE;EAAU,KAAKC;CAAW,CAAC,GAEtC;AACT"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
var storageKey=e=>`@vielzeug/beacon:${e}`,e=new Set([`active`,`completed`,`dismissed`,`idle`,`paused`]);function parseProgress(t){if(typeof t!=`object`||!t)return null;let n=t;return typeof n.version!=`number`||!Number.isFinite(n.version)||typeof n.stepIndex!=`number`||!Number.isInteger(n.stepIndex)||n.stepIndex<-1||!e.has(n.status)?null:{status:n.status,stepIndex:n.stepIndex,version:n.version}}function createMemoryStorage(){let e=new Map;return{get:t=>e.get(t),remove:t=>{e.delete(t)},set:(t,n)=>{e.set(t,n)}}}exports.createMemoryStorage=createMemoryStorage,exports.parseProgress=parseProgress,exports.storageKey=storageKey;
|
|
2
|
+
//# sourceMappingURL=_storage.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_storage.cjs","names":["id","STATUSES","value","record","entries","key"],"sources":["../src/_storage.ts"],"sourcesContent":["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"],"mappings":"AAGA,IAEa,WAAc,GAAuB,oBAAgBA,IAE5DC,EAAW,IAAI,IAAkB,CAAC,SAAU,YAAa,YAAa,OAAQ,QAAQ,CAAC,EAM7F,SAAgB,cAAc,EAAuC,CACnE,GAAI,OAAOC,GAAU,WAAYA,EAAgB,OAAO,KACxD,IAAMC,EAASD,EAKf,OAJI,OAAOC,EAAO,SAAY,UAAY,CAAC,OAAO,SAASA,EAAO,OAAO,GACrE,OAAOA,EAAO,WAAc,UAAY,CAAC,OAAO,UAAUA,EAAO,SAAS,GAAKA,EAAO,UAAY,IAClG,CAACF,EAAS,IAAIE,EAAO,MAAsB,EAAU,KAElD,CAAE,OAAQA,EAAO,OAAwB,UAAWA,EAAO,UAAW,QAASA,EAAO,OAAQ,CACvG,CAGA,SAAgB,qBAAqC,CACnD,IAAMC,EAAU,IAAI,IAEpB,MAAO,CACL,IAAM,GAAQA,EAAQ,IAAIC,CAAG,EAC7B,OAAS,GAAQ,CACfD,EAAQ,OAAOC,CAAG,CACpB,EACA,KAAM,EAAK,IAAU,CACnBD,EAAQ,IAAIC,EAAKH,CAAK,CACxB,CACF,CACF,C"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { BeaconProgress, BeaconStorage } from './types';
|
|
2
|
+
export declare const storageKey: (id: string) => string;
|
|
3
|
+
/**
|
|
4
|
+
* Validates a record read back from storage. Persisted values cross a trust
|
|
5
|
+
* boundary: a stale, hand-edited, or foreign record must not crash a tour.
|
|
6
|
+
*/
|
|
7
|
+
export declare function parseProgress(value: unknown): BeaconProgress | null;
|
|
8
|
+
/** Progress kept for the lifetime of one handle; the fallback when no storage is configured. */
|
|
9
|
+
export declare function createMemoryStorage(): BeaconStorage;
|
|
10
|
+
//# sourceMappingURL=_storage.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_storage.d.ts","sourceRoot":"","sources":["../src/_storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAgB,aAAa,EAAE,MAAM,SAAS,CAAC;AAK3E,eAAO,MAAM,UAAU,GAAI,IAAI,MAAM,KAAG,MAA8B,CAAC;AAIvE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAQnE;AAED,gGAAgG;AAChG,wBAAgB,mBAAmB,IAAI,aAAa,CAYnD"}
|
package/dist/_storage.js
ADDED
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
//#region src/_storage.ts
|
|
2
|
+
var storageKey = (e) => `@vielzeug/beacon:${e}`, e = /* @__PURE__ */ new Set([
|
|
3
|
+
"active",
|
|
4
|
+
"completed",
|
|
5
|
+
"dismissed",
|
|
6
|
+
"idle",
|
|
7
|
+
"paused"
|
|
8
|
+
]);
|
|
9
|
+
function parseProgress(t) {
|
|
10
|
+
if (typeof t != "object" || !t) return null;
|
|
11
|
+
let n = t;
|
|
12
|
+
return typeof n.version != "number" || !Number.isFinite(n.version) || typeof n.stepIndex != "number" || !Number.isInteger(n.stepIndex) || n.stepIndex < -1 || !e.has(n.status) ? null : {
|
|
13
|
+
status: n.status,
|
|
14
|
+
stepIndex: n.stepIndex,
|
|
15
|
+
version: n.version
|
|
16
|
+
};
|
|
17
|
+
}
|
|
18
|
+
function createMemoryStorage() {
|
|
19
|
+
let e = /* @__PURE__ */ new Map();
|
|
20
|
+
return {
|
|
21
|
+
get: (t) => e.get(t),
|
|
22
|
+
remove: (t) => {
|
|
23
|
+
e.delete(t);
|
|
24
|
+
},
|
|
25
|
+
set: (t, n) => {
|
|
26
|
+
e.set(t, n);
|
|
27
|
+
}
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
//#endregion
|
|
31
|
+
export { createMemoryStorage, parseProgress, storageKey };
|
|
32
|
+
|
|
33
|
+
//# sourceMappingURL=_storage.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_storage.js","names":["id","STATUSES","value","record","entries","key"],"sources":["../src/_storage.ts"],"sourcesContent":["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"],"mappings":";AAGA,IAEa,cAAc,MAAuB,oBAAgBA,KAE5DC,oBAAW,IAAI,IAAkB;CAAC;CAAU;CAAa;CAAa;CAAQ;AAAQ,CAAC;AAM7F,SAAgB,cAAc,GAAuC;CACnE,IAAI,OAAOC,KAAU,aAAYA,GAAgB,OAAO;CACxD,IAAMC,IAASD;CAKf,OAJI,OAAOC,EAAO,WAAY,YAAY,CAAC,OAAO,SAASA,EAAO,OAAO,KACrE,OAAOA,EAAO,aAAc,YAAY,CAAC,OAAO,UAAUA,EAAO,SAAS,KAAKA,EAAO,YAAY,MAClG,CAACF,EAAS,IAAIE,EAAO,MAAsB,IAAU,OAElD;EAAE,QAAQA,EAAO;EAAwB,WAAWA,EAAO;EAAW,SAASA,EAAO;CAAQ;AACvG;AAGA,SAAgB,sBAAqC;CACnD,IAAMC,oBAAU,IAAI,IAA4B;CAEhD,OAAO;EACL,MAAM,MAAQA,EAAQ,IAAIC,CAAG;EAC7B,SAAS,MAAQ;GACf,EAAQ,OAAOA,CAAG;EACpB;EACA,MAAM,GAAK,MAAU;GACnB,EAAQ,IAAIA,GAAKH,CAAK;EACxB;CACF;AACF"}
|
package/dist/_target.cjs
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
const e=require("./target.cjs");function observeTarget(t,n,r){if(e.isStaticTarget(t)||typeof document>`u`||typeof MutationObserver>`u`)return null;let i=e.targetAvailable(t),a=new MutationObserver(()=>{let r=e.targetAvailable(t);r!==i&&(i=r,n())});a.observe(document.documentElement,{attributes:!0,childList:!0,subtree:!0});let stop=()=>{a.disconnect(),r.removeEventListener(`abort`,stop)};return r.addEventListener(`abort`,stop,{once:!0}),stop}function observeTargetLayout(t,n,r){let i=e.targetElement(t);if(!i||typeof document>`u`||typeof ResizeObserver>`u`)return null;let a=new ResizeObserver(n);a.observe(i),a.observe(document.body);let stop=()=>{a.disconnect(),r.removeEventListener(`abort`,stop)};return r.addEventListener(`abort`,stop,{once:!0}),stop}exports.observeTarget=observeTarget,exports.observeTargetLayout=observeTargetLayout;
|
|
2
|
+
//# sourceMappingURL=_target.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_target.cjs","names":["isStaticTarget","targetAvailable","targetElement","require_target","target","lastAvailable","observer","next","onChange","signal","element"],"sources":["../src/_target.ts"],"sourcesContent":["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"],"mappings":"A,gCASA,SAAgB,cAAc,EAAsB,EAAsB,EAA0C,CAElH,GADIA,EAAAA,eAAeI,CAAM,GACrB,OAAO,SAAa,KAAe,OAAO,iBAAqB,IAAa,OAAO,KAEvF,IAAIC,EAAgBJ,EAAAA,gBAAgBG,CAAM,EACpCE,EAAW,IAAI,qBAAuB,CAC1C,IAAMC,EAAON,EAAAA,gBAAgBG,CAAM,EAC/BG,IAASF,IACX,EAAgBE,EAChBC,EAAS,EAEb,CAAC,EAEDF,EAAS,QAAQ,SAAS,gBAAiB,CAAE,WAAY,GAAM,UAAW,GAAM,QAAS,EAAK,CAAC,EAC/F,IAAM,SAAmB,CACvBA,EAAS,WAAW,EACpBG,EAAO,oBAAoB,QAAS,IAAI,CAC1C,EAGA,OAFAA,EAAO,iBAAiB,QAAS,KAAM,CAAE,KAAM,EAAK,CAAC,EAE9C,IACT,CAUA,SAAgB,oBACd,EACA,EACA,EACqB,CACrB,IAAMC,EAAUR,EAAAA,cAAcE,CAAM,EAEpC,GAAI,CAACM,GAAW,OAAO,SAAa,KAAe,OAAO,eAAmB,IAAa,OAAO,KAEjG,IAAMJ,EAAW,IAAI,eAAeE,CAAQ,EAE5CF,EAAS,QAAQI,CAAO,EAGxBJ,EAAS,QAAQ,SAAS,IAAI,EAE9B,IAAM,SAAmB,CACvBA,EAAS,WAAW,EACpBG,EAAO,oBAAoB,QAAS,IAAI,CAC1C,EAGA,OAFAA,EAAO,iBAAiB,QAAS,KAAM,CAAE,KAAM,EAAK,CAAC,EAE9C,IACT,C"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_target.d.ts","sourceRoot":"","sources":["../src/_target.ts"],"names":[],"mappings":""}
|
package/dist/_target.js
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { isStaticTarget as e, targetAvailable as t, targetElement as n } from "./target.js";
|
|
2
|
+
//#region src/_target.ts
|
|
3
|
+
function observeTarget(n, r, i) {
|
|
4
|
+
if (e(n) || typeof document > "u" || typeof MutationObserver > "u") return null;
|
|
5
|
+
let a = t(n), o = new MutationObserver(() => {
|
|
6
|
+
let e = t(n);
|
|
7
|
+
e !== a && (a = e, r());
|
|
8
|
+
});
|
|
9
|
+
o.observe(document.documentElement, {
|
|
10
|
+
attributes: !0,
|
|
11
|
+
childList: !0,
|
|
12
|
+
subtree: !0
|
|
13
|
+
});
|
|
14
|
+
let stop = () => {
|
|
15
|
+
o.disconnect(), i.removeEventListener("abort", stop);
|
|
16
|
+
};
|
|
17
|
+
return i.addEventListener("abort", stop, { once: !0 }), stop;
|
|
18
|
+
}
|
|
19
|
+
function observeTargetLayout(e, t, r) {
|
|
20
|
+
let i = n(e);
|
|
21
|
+
if (!i || typeof document > "u" || typeof ResizeObserver > "u") return null;
|
|
22
|
+
let a = new ResizeObserver(t);
|
|
23
|
+
a.observe(i), a.observe(document.body);
|
|
24
|
+
let stop = () => {
|
|
25
|
+
a.disconnect(), r.removeEventListener("abort", stop);
|
|
26
|
+
};
|
|
27
|
+
return r.addEventListener("abort", stop, { once: !0 }), stop;
|
|
28
|
+
}
|
|
29
|
+
//#endregion
|
|
30
|
+
export { observeTarget, observeTargetLayout };
|
|
31
|
+
|
|
32
|
+
//# sourceMappingURL=_target.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_target.js","names":["isStaticTarget","target","lastAvailable","targetAvailable","observer","next","onChange","signal","element","targetElement"],"sources":["../src/_target.ts"],"sourcesContent":["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"],"mappings":";;AASA,SAAgB,cAAc,GAAsB,GAAsB,GAA0C;CAElH,IADIA,EAAeC,CAAM,KACrB,OAAO,WAAa,OAAe,OAAO,mBAAqB,KAAa,OAAO;CAEvF,IAAIC,IAAgBC,EAAgBF,CAAM,GACpCG,IAAW,IAAI,uBAAuB;EAC1C,IAAMC,IAAOF,EAAgBF,CAAM;EACnC,AAAII,MAASH,MACX,IAAgBG,GAChBC,EAAS;CAEb,CAAC;CAED,EAAS,QAAQ,SAAS,iBAAiB;EAAE,YAAY;EAAM,WAAW;EAAM,SAAS;CAAK,CAAC;CAC/F,IAAM,aAAmB;EAEvB,AADAF,EAAS,WAAW,GACpBG,EAAO,oBAAoB,SAAS,IAAI;CAC1C;CAGA,OAFAA,EAAO,iBAAiB,SAAS,MAAM,EAAE,MAAM,GAAK,CAAC,GAE9C;AACT;AAUA,SAAgB,oBACd,GACA,GACA,GACqB;CACrB,IAAMC,IAAUC,EAAcR,CAAM;CAEpC,IAAI,CAACO,KAAW,OAAO,WAAa,OAAe,OAAO,iBAAmB,KAAa,OAAO;CAEjG,IAAMJ,IAAW,IAAI,eAAeE,CAAQ;CAK5C,AAHAF,EAAS,QAAQI,CAAO,GAGxBJ,EAAS,QAAQ,SAAS,IAAI;CAE9B,IAAM,aAAmB;EAEvB,AADAA,EAAS,WAAW,GACpBG,EAAO,oBAAoB,SAAS,IAAI;CAC1C;CAGA,OAFAA,EAAO,iBAAiB,SAAS,MAAM,EAAE,MAAM,GAAK,CAAC,GAE9C;AACT"}
|
package/dist/beacon.cjs
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@vielzeug/ripple");function createTappers(e){let t=new Set,emit=e=>{if(t.size!==0)for(let n of t)try{n(e)}catch{}},warn=e=>{t.size!==0&&emit({error:e,message:e instanceof Error?e.message:String(e),type:`warning`})},tap=(n,r)=>{if(e.aborted||r?.signal?.aborted)return()=>{};let detach=()=>{t.delete(n)};return t.add(n),e.addEventListener(`abort`,detach,{once:!0}),r?.signal?.addEventListener(`abort`,detach,{once:!0}),detach};return{clear:()=>t.clear(),emit,tap,warn}}var t=`@vielzeug/beacon:`,storageKey=e=>`${t}${e}`,n=new Set([`active`,`completed`,`dismissed`,`idle`,`paused`]);function parseProgress(e){if(typeof e!=`object`||!e)return null;let t=e;return typeof t.version!=`number`||!Number.isFinite(t.version)||typeof t.stepIndex!=`number`||!Number.isInteger(t.stepIndex)||t.stepIndex<-1||!n.has(t.status)?null:{status:t.status,stepIndex:t.stepIndex,version:t.version}}function createMemoryStorage(){let e=new Map;return{get:t=>e.get(t),remove:t=>{e.delete(t)},set:(t,n)=>{e.set(t,n)}}}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=>{if(e===null)return null;if(!isElement(e))return e;let t=e.getBoundingClientRect();return{height:t.height,width:t.width,x:t.x,y:t.y}};function resolveTarget(e){return typeof e==`string`?typeof document>`u`?null:normalize(document.querySelector(e)):normalize(typeof e==`function`?e()??null:e)}function targetAvailable(e){return resolveTarget(e)!==null}function targetElement(e){if(typeof e==`string`)return typeof document>`u`?null:document.querySelector(e);if(typeof e==`function`){let t=e();return t==null||!isElement(t)?null:t}return isElement(e)?e:null}function isStaticTarget(e){return isElement(e)||isRect(e)}function sameRect(e,t){return e===null||t===null?e===t:e.x===t.x&&e.y===t.y&&e.width===t.width&&e.height===t.height}function observeTarget(e,t,n){if(isStaticTarget(e)||typeof document>`u`||typeof MutationObserver>`u`)return null;let r=targetAvailable(e),i=new MutationObserver(()=>{let n=targetAvailable(e);n!==r&&(r=n,t())});i.observe(document.documentElement,{attributes:!0,childList:!0,subtree:!0});let stop=()=>{i.disconnect(),n.removeEventListener(`abort`,stop)};return n.addEventListener(`abort`,stop,{once:!0}),stop}function observeTargetLayout(e,t,n){let r=targetElement(e);if(!r||typeof document>`u`||typeof ResizeObserver>`u`)return null;let i=new ResizeObserver(t);i.observe(r),i.observe(document.body);let stop=()=>{i.disconnect(),n.removeEventListener(`abort`,stop)};return n.addEventListener(`abort`,stop,{once:!0}),stop}var BeaconError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},BeaconConfigError=class extends BeaconError{},BeaconDisposedError=class extends BeaconError{};function createCoachmark(t){if(!t.id)throw new BeaconConfigError(`createCoachmark: "id" must be a non-empty string`);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=(0,e.signal)(!0),p={data:t.data,description:t.description,id:t.id,placement:t.placement??`auto`,presentation:t.presentation??`auto`,target:t.target,title:t.title},m={placement:p.placement??`auto`,presentation:p.presentation??`auto`,rect:null,step:null,stepIndex:0,totalSteps:0},h=(0,e.signal)(m),stopWaiting=null,g=0,disposedError=()=>new BeaconDisposedError(`This coachmark handle has been disposed.`),guard=()=>{if(s.aborted)throw disposedError()},persistSeen=()=>{let e={status:`completed`,stepIndex:0,version:n};try{let t=i.set(a,e);t instanceof Promise&&t.catch(e=>l(e))}catch(e){l(e)}},stopWaitingForTarget=()=>{stopWaiting?.(),stopWaiting=null},showInternal=()=>{if(guard(),!f.peek()||h.peek().step!==null)return;let publish=()=>{h.value={...m,rect:resolveTarget(t.target),step:p},c({type:`coachmark:show`}),watchLayout()},watchLayout=()=>{let onLayout=()=>{let e=resolveTarget(t.target);sameRect(e,h.peek().rect)||(h.value={...h.peek(),rect:e})};window.addEventListener(`scroll`,onLayout,{passive:!0}),window.addEventListener(`resize`,onLayout);let e=observeTargetLayout(t.target,onLayout,s),stop=()=>{window.removeEventListener(`scroll`,onLayout),window.removeEventListener(`resize`,onLayout),e?.()};s.addEventListener(`abort`,stop,{once:!0}),stopWaiting=()=>{stop(),stopWaiting=null}};if(resolveTarget(t.target)){publish();return}let e=!0,n=null;stopWaiting=()=>{e=!1,n?.(),n=null},n=observeTarget(t.target,()=>{e&&f.peek()&&(stopWaitingForTarget(),publish())},s),c({type:`target-waiting`})},_=++g,applyStored=e=>{if(_!==g||s.aborted)return;let t=parseProgress(e);f.value=!(t&&t.version>=n&&t.status===`completed`),f.peek()&&r&&queueMicrotask(()=>{s.aborted||showInternal()})};try{let e=i.get(a);e instanceof Promise?e.then(applyStored,e=>l(e)):applyStored(e)}catch(e){l(e)}return{current:h,dismiss(){guard(),stopWaitingForTarget(),h.value=m,f.value=!1,persistSeen(),c({type:`coachmark:dismiss`})},disposalSignal:s,dispose(){s.aborted||(c({type:`dispose`}),stopWaitingForTarget(),o.abort(),d())},get disposed(){return s.aborted},eligible:f,hide(){guard(),stopWaitingForTarget(),h.value=m},id:t.id,reset(){guard();try{let e=i.remove(a);e instanceof Promise&&e.catch(e=>l(e))}catch(e){l(e)}f.value=!0},show:showInternal,tap:u,[Symbol.dispose](){this.dispose()}}}var prefersReducedMotion=()=>typeof matchMedia==`function`&&matchMedia(`(prefers-reduced-motion: reduce)`).matches;function scrollTargetIntoView(e,t={}){if(typeof window>`u`||typeof document>`u`)return!1;let n=resolveTarget(e);if(!n)return!1;let r=t.behavior??(prefersReducedMotion()?`auto`:`smooth`),i=window.innerHeight||document.documentElement.clientHeight,a=typeof t.offset==`function`?t.offset():t.offset??0,o=n.y+(globalThis.scrollY??0),s=o-(i-n.height)/2,c=a>0&&o-s<a?o-a:s,l=Math.max(0,document.documentElement.scrollHeight-i),u=Math.min(Math.max(0,c),l);return window.scrollTo({behavior:r,top:u}),!0}var validateConfig=e=>{if(!e.id)throw new BeaconConfigError(`createTour: "id" must be a non-empty string`);if(!Array.isArray(e.steps)||e.steps.length===0)throw new 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 BeaconConfigError(`createTour: every step of tour "${e.id}" needs a non-empty id`);if(t.has(n.id))throw new BeaconConfigError(`createTour: duplicate step id "${n.id}" in tour "${e.id}"`);t.add(n.id)}};function createTour(t){validateConfig(t);let n=t.version??1,r=t.targetTimeoutMs??1/0,i=t.autoScroll??!0,a=t.storage??createMemoryStorage(),o=storageKey(t.id),s=new AbortController,{signal:c}=s,{emit:l,warn:u,tap:d,clear:f}=createTappers(c),p=(0,e.signal)(`idle`),m=(0,e.signal)(!0),h=(0,e.signal)({placement:t.placement??`auto`,presentation:t.presentation??`auto`,rect:null,step:null,stepIndex:-1,totalSteps:t.steps.length}),stopWaiting=null,g=0,disposedError=()=>new BeaconDisposedError(`This tour handle has been disposed.`),guard=()=>{if(c.aborted)throw disposedError()},persist=()=>{let e={status:p.peek(),stepIndex:h.peek().stepIndex,version:n};try{let t=a.set(o,e);t instanceof Promise&&t.catch(e=>u(e))}catch(e){u(e)}},clearPersisted=()=>{try{let e=a.remove(o);e instanceof Promise&&e.catch(e=>u(e))}catch(e){u(e)}},setStatus=e=>{p.peek()!==e&&(p.value=e,persist(),l({status:e,type:`status-change`}))},stopTargetWatch=()=>{stopWaiting?.(),stopWaiting=null},refreshActiveRect=()=>{let e=h.peek().step;if(!e?.target)return;let t=resolveTarget(e.target);sameRect(t,h.peek().rect)||(h.value={...h.peek(),rect:t})},watchActiveTarget=e=>{let t=!1,onLayout=()=>{t||refreshActiveRect()};window.addEventListener(`scroll`,onLayout,{passive:!0}),window.addEventListener(`resize`,onLayout);let n=observeTarget(e,onLayout,c),r=observeTargetLayout(e,onLayout,c),stop=()=>{t||(t=!0,window.removeEventListener(`scroll`,onLayout),window.removeEventListener(`resize`,onLayout),n?.(),r?.())};return c.addEventListener(`abort`,stop,{once:!0}),stop},publishStep=e=>{stopTargetWatch();let n=t.steps[e]??null,r=h.peek().step;r&&r!==n&&l({index:h.peek().stepIndex,step:r,type:`step:complete`}),h.value={placement:n?.placement??t.placement??`auto`,presentation:n?.presentation??t.presentation??`auto`,rect:n?.target?resolveTarget(n.target):null,step:n,stepIndex:e,totalSteps:t.steps.length},n&&(l({index:e,step:n,type:`step:start`}),i&&n.target&&scrollTargetIntoView(n.target,{offset:t.scrollOffset}),n.target&&(stopWaiting=watchActiveTarget(n.target)))},finishInternal=e=>{stopTargetWatch();let t=h.peek().step;t&&l({index:h.peek().stepIndex,step:t,type:`step:complete`}),h.value={...h.peek(),rect:null,step:null,stepIndex:-1},setStatus(`completed`),l({reason:e,type:`tour:complete`})},activateStep=e=>{stopTargetWatch();let n=t.steps[e];if(!n)return;if(!n.target||r===0||targetAvailable(n.target)){publishStep(e);return}let i=!0,a=null,o=null,s=n.target;stopWaiting=()=>{i=!1,o?.(),o=null,a!==null&&(clearTimeout(a),a=null)},o=observeTarget(s,()=>{i&&targetAvailable(s)&&publishStep(e)},c),l({index:e,message:`Waiting for step "${n.id}" to become visible.`,step:n,type:`target-waiting`}),Number.isFinite(r)&&(a=setTimeout(()=>{i&&(stopTargetWatch(),l({message:`Skipped step "${n.id}": its target did not appear within ${r}ms.`,type:`target-missing`}),e+1<t.steps.length?activateStep(e+1):finishInternal(`finish`))},r))},advanceTo=e=>{e<0||(e>=t.steps.length?finishInternal(`finish`):(p.peek()!==`active`&&setStatus(`active`),activateStep(e)))},startInternal=()=>{guard();let e=p.peek();if(e===`completed`||e===`dismissed`||e===`active`)return;let t=Math.max(0,h.peek().stepIndex);setStatus(`active`),activateStep(t)},_=++g,applyStored=e=>{if(_!==g||c.aborted)return;let r=parseProgress(e);if(r&&r.version>=n){if(r.status===`completed`||r.status===`dismissed`){p.value=r.status,m.value=!1;return}(r.status===`active`||r.status===`paused`)&&(p.value=`paused`,h.value={...h.peek(),stepIndex:Math.min(r.stepIndex,t.steps.length-1)})}m.value=!0,t.autoStart&&queueMicrotask(()=>{c.aborted||startInternal()})};try{let e=a.get(o);e instanceof Promise?e.then(applyStored,e=>u(e)):applyStored(e)}catch(e){u(e)}return{back(){guard(),advanceTo(h.peek().stepIndex-1)},current:h,dismiss(){guard(),p.peek()!==`completed`&&p.peek()!==`dismissed`&&(stopTargetWatch(),h.value={...h.peek(),rect:null,step:null,stepIndex:-1},setStatus(`dismissed`),l({type:`tour:dismiss`}))},disposalSignal:c,dispose(){c.aborted||(l({type:`dispose`}),stopTargetWatch(),s.abort(),f())},get disposed(){return c.aborted},eligible:m,finish(){guard(),p.peek()!==`completed`&&finishInternal(`finish`)},goto(e){guard();let n=typeof e==`number`?e:t.steps.findIndex(t=>t.id===e);n<0||n>=t.steps.length?`${String(e)}${t.id}`:advanceTo(n)},id:t.id,next(){guard(),advanceTo(h.peek().stepIndex+1)},pause(){guard(),p.peek()===`active`&&(stopTargetWatch(),h.value={...h.peek(),rect:null},setStatus(`paused`))},reset(){guard(),stopTargetWatch(),clearPersisted(),h.value={placement:t.placement??`auto`,presentation:t.presentation??`auto`,rect:null,step:null,stepIndex:-1,totalSteps:t.steps.length},p.value=`idle`,m.value=!0,l({status:`idle`,type:`status-change`})},skip(){guard(),p.peek()!==`completed`&&p.peek()!==`dismissed`&&(stopTargetWatch(),h.value={...h.peek(),rect:null,step:null,stepIndex:-1},setStatus(`dismissed`),l({reason:`skip`,type:`tour:complete`}))},start:startInternal,status:p,steps:t.steps,tap:d,[Symbol.dispose](){this.dispose()}}}exports.BeaconConfigError=BeaconConfigError,exports.BeaconDisposedError=BeaconDisposedError,exports.BeaconError=BeaconError,exports.createCoachmark=createCoachmark,exports.createTour=createTour,exports.resolveTarget=resolveTarget;
|
|
2
|
+
//# sourceMappingURL=beacon.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"beacon.cjs","names":["signal","signal","_vielzeug_ripple","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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"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
var Beacon=(function(e,t){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});function createTappers(e){let t=new Set,emit=e=>{if(t.size!==0)for(let n of t)try{n(e)}catch{}},warn=e=>{t.size!==0&&emit({error:e,message:e instanceof Error?e.message:String(e),type:`warning`})},tap=(n,r)=>{if(e.aborted||r?.signal?.aborted)return()=>{};let detach=()=>{t.delete(n)};return t.add(n),e.addEventListener(`abort`,detach,{once:!0}),r?.signal?.addEventListener(`abort`,detach,{once:!0}),detach};return{clear:()=>t.clear(),emit,tap,warn}}var n=`@vielzeug/beacon:`,storageKey=e=>`${n}${e}`,r=new Set([`active`,`completed`,`dismissed`,`idle`,`paused`]);function parseProgress(e){if(typeof e!=`object`||!e)return null;let t=e;return typeof t.version!=`number`||!Number.isFinite(t.version)||typeof t.stepIndex!=`number`||!Number.isInteger(t.stepIndex)||t.stepIndex<-1||!r.has(t.status)?null:{status:t.status,stepIndex:t.stepIndex,version:t.version}}function createMemoryStorage(){let e=new Map;return{get:t=>e.get(t),remove:t=>{e.delete(t)},set:(t,n)=>{e.set(t,n)}}}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=>{if(e===null)return null;if(!isElement(e))return e;let t=e.getBoundingClientRect();return{height:t.height,width:t.width,x:t.x,y:t.y}};function resolveTarget(e){return typeof e==`string`?typeof document>`u`?null:normalize(document.querySelector(e)):normalize(typeof e==`function`?e()??null:e)}function targetAvailable(e){return resolveTarget(e)!==null}function targetElement(e){if(typeof e==`string`)return typeof document>`u`?null:document.querySelector(e);if(typeof e==`function`){let t=e();return t==null||!isElement(t)?null:t}return isElement(e)?e:null}function isStaticTarget(e){return isElement(e)||isRect(e)}function sameRect(e,t){return e===null||t===null?e===t:e.x===t.x&&e.y===t.y&&e.width===t.width&&e.height===t.height}function observeTarget(e,t,n){if(isStaticTarget(e)||typeof document>`u`||typeof MutationObserver>`u`)return null;let r=targetAvailable(e),i=new MutationObserver(()=>{let n=targetAvailable(e);n!==r&&(r=n,t())});i.observe(document.documentElement,{attributes:!0,childList:!0,subtree:!0});let stop=()=>{i.disconnect(),n.removeEventListener(`abort`,stop)};return n.addEventListener(`abort`,stop,{once:!0}),stop}function observeTargetLayout(e,t,n){let r=targetElement(e);if(!r||typeof document>`u`||typeof ResizeObserver>`u`)return null;let i=new ResizeObserver(t);i.observe(r),i.observe(document.body);let stop=()=>{i.disconnect(),n.removeEventListener(`abort`,stop)};return n.addEventListener(`abort`,stop,{once:!0}),stop}var BeaconError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},BeaconConfigError=class extends BeaconError{},BeaconDisposedError=class extends BeaconError{};function createCoachmark(e){if(!e.id)throw new BeaconConfigError(`createCoachmark: "id" must be a non-empty string`);let n=e.version??1,r=e.autoShow??!0,i=e.storage??createMemoryStorage(),a=storageKey(e.id),o=new AbortController,{signal:s}=o,{emit:c,warn:l,tap:u,clear:d}=createTappers(s),f=(0,t.signal)(!0),p={data:e.data,description:e.description,id:e.id,placement:e.placement??`auto`,presentation:e.presentation??`auto`,target:e.target,title:e.title},m={placement:p.placement??`auto`,presentation:p.presentation??`auto`,rect:null,step:null,stepIndex:0,totalSteps:0},h=(0,t.signal)(m),stopWaiting=null,g=0,disposedError=()=>new BeaconDisposedError(`This coachmark handle has been disposed.`),guard=()=>{if(s.aborted)throw disposedError()},persistSeen=()=>{let e={status:`completed`,stepIndex:0,version:n};try{let t=i.set(a,e);t instanceof Promise&&t.catch(e=>l(e))}catch(e){l(e)}},stopWaitingForTarget=()=>{stopWaiting?.(),stopWaiting=null},showInternal=()=>{if(guard(),!f.peek()||h.peek().step!==null)return;let publish=()=>{h.value={...m,rect:resolveTarget(e.target),step:p},c({type:`coachmark:show`}),watchLayout()},watchLayout=()=>{let onLayout=()=>{let t=resolveTarget(e.target);sameRect(t,h.peek().rect)||(h.value={...h.peek(),rect:t})};window.addEventListener(`scroll`,onLayout,{passive:!0}),window.addEventListener(`resize`,onLayout);let t=observeTargetLayout(e.target,onLayout,s),stop=()=>{window.removeEventListener(`scroll`,onLayout),window.removeEventListener(`resize`,onLayout),t?.()};s.addEventListener(`abort`,stop,{once:!0}),stopWaiting=()=>{stop(),stopWaiting=null}};if(resolveTarget(e.target)){publish();return}let t=!0,n=null;stopWaiting=()=>{t=!1,n?.(),n=null},n=observeTarget(e.target,()=>{t&&f.peek()&&(stopWaitingForTarget(),publish())},s),c({type:`target-waiting`})},_=++g,applyStored=e=>{if(_!==g||s.aborted)return;let t=parseProgress(e);f.value=!(t&&t.version>=n&&t.status===`completed`),f.peek()&&r&&queueMicrotask(()=>{s.aborted||showInternal()})};try{let e=i.get(a);e instanceof Promise?e.then(applyStored,e=>l(e)):applyStored(e)}catch(e){l(e)}return{current:h,dismiss(){guard(),stopWaitingForTarget(),h.value=m,f.value=!1,persistSeen(),c({type:`coachmark:dismiss`})},disposalSignal:s,dispose(){s.aborted||(c({type:`dispose`}),stopWaitingForTarget(),o.abort(),d())},get disposed(){return s.aborted},eligible:f,hide(){guard(),stopWaitingForTarget(),h.value=m},id:e.id,reset(){guard();try{let e=i.remove(a);e instanceof Promise&&e.catch(e=>l(e))}catch(e){l(e)}f.value=!0},show:showInternal,tap:u,[Symbol.dispose](){this.dispose()}}}var prefersReducedMotion=()=>typeof matchMedia==`function`&&matchMedia(`(prefers-reduced-motion: reduce)`).matches;function scrollTargetIntoView(e,t={}){if(typeof window>`u`||typeof document>`u`)return!1;let n=resolveTarget(e);if(!n)return!1;let r=t.behavior??(prefersReducedMotion()?`auto`:`smooth`),i=window.innerHeight||document.documentElement.clientHeight,a=typeof t.offset==`function`?t.offset():t.offset??0,o=n.y+(globalThis.scrollY??0),s=o-(i-n.height)/2,c=a>0&&o-s<a?o-a:s,l=Math.max(0,document.documentElement.scrollHeight-i),u=Math.min(Math.max(0,c),l);return window.scrollTo({behavior:r,top:u}),!0}var validateConfig=e=>{if(!e.id)throw new BeaconConfigError(`createTour: "id" must be a non-empty string`);if(!Array.isArray(e.steps)||e.steps.length===0)throw new 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 BeaconConfigError(`createTour: every step of tour "${e.id}" needs a non-empty id`);if(t.has(n.id))throw new BeaconConfigError(`createTour: duplicate step id "${n.id}" in tour "${e.id}"`);t.add(n.id)}};function createTour(e){validateConfig(e);let n=e.version??1,r=e.targetTimeoutMs??1/0,i=e.autoScroll??!0,a=e.storage??createMemoryStorage(),o=storageKey(e.id),s=new AbortController,{signal:c}=s,{emit:l,warn:u,tap:d,clear:f}=createTappers(c),p=(0,t.signal)(`idle`),m=(0,t.signal)(!0),h=(0,t.signal)({placement:e.placement??`auto`,presentation:e.presentation??`auto`,rect:null,step:null,stepIndex:-1,totalSteps:e.steps.length}),stopWaiting=null,g=0,disposedError=()=>new BeaconDisposedError(`This tour handle has been disposed.`),guard=()=>{if(c.aborted)throw disposedError()},persist=()=>{let e={status:p.peek(),stepIndex:h.peek().stepIndex,version:n};try{let t=a.set(o,e);t instanceof Promise&&t.catch(e=>u(e))}catch(e){u(e)}},clearPersisted=()=>{try{let e=a.remove(o);e instanceof Promise&&e.catch(e=>u(e))}catch(e){u(e)}},setStatus=e=>{p.peek()!==e&&(p.value=e,persist(),l({status:e,type:`status-change`}))},stopTargetWatch=()=>{stopWaiting?.(),stopWaiting=null},refreshActiveRect=()=>{let e=h.peek().step;if(!e?.target)return;let t=resolveTarget(e.target);sameRect(t,h.peek().rect)||(h.value={...h.peek(),rect:t})},watchActiveTarget=e=>{let t=!1,onLayout=()=>{t||refreshActiveRect()};window.addEventListener(`scroll`,onLayout,{passive:!0}),window.addEventListener(`resize`,onLayout);let n=observeTarget(e,onLayout,c),r=observeTargetLayout(e,onLayout,c),stop=()=>{t||(t=!0,window.removeEventListener(`scroll`,onLayout),window.removeEventListener(`resize`,onLayout),n?.(),r?.())};return c.addEventListener(`abort`,stop,{once:!0}),stop},publishStep=t=>{stopTargetWatch();let n=e.steps[t]??null,r=h.peek().step;r&&r!==n&&l({index:h.peek().stepIndex,step:r,type:`step:complete`}),h.value={placement:n?.placement??e.placement??`auto`,presentation:n?.presentation??e.presentation??`auto`,rect:n?.target?resolveTarget(n.target):null,step:n,stepIndex:t,totalSteps:e.steps.length},n&&(l({index:t,step:n,type:`step:start`}),i&&n.target&&scrollTargetIntoView(n.target,{offset:e.scrollOffset}),n.target&&(stopWaiting=watchActiveTarget(n.target)))},finishInternal=e=>{stopTargetWatch();let t=h.peek().step;t&&l({index:h.peek().stepIndex,step:t,type:`step:complete`}),h.value={...h.peek(),rect:null,step:null,stepIndex:-1},setStatus(`completed`),l({reason:e,type:`tour:complete`})},activateStep=t=>{stopTargetWatch();let n=e.steps[t];if(!n)return;if(!n.target||r===0||targetAvailable(n.target)){publishStep(t);return}let i=!0,a=null,o=null,s=n.target;stopWaiting=()=>{i=!1,o?.(),o=null,a!==null&&(clearTimeout(a),a=null)},o=observeTarget(s,()=>{i&&targetAvailable(s)&&publishStep(t)},c),l({index:t,message:`Waiting for step "${n.id}" to become visible.`,step:n,type:`target-waiting`}),Number.isFinite(r)&&(a=setTimeout(()=>{i&&(stopTargetWatch(),l({message:`Skipped step "${n.id}": its target did not appear within ${r}ms.`,type:`target-missing`}),t+1<e.steps.length?activateStep(t+1):finishInternal(`finish`))},r))},advanceTo=t=>{t<0||(t>=e.steps.length?finishInternal(`finish`):(p.peek()!==`active`&&setStatus(`active`),activateStep(t)))},startInternal=()=>{guard();let e=p.peek();if(e===`completed`||e===`dismissed`||e===`active`)return;let t=Math.max(0,h.peek().stepIndex);setStatus(`active`),activateStep(t)},_=++g,applyStored=t=>{if(_!==g||c.aborted)return;let r=parseProgress(t);if(r&&r.version>=n){if(r.status===`completed`||r.status===`dismissed`){p.value=r.status,m.value=!1;return}(r.status===`active`||r.status===`paused`)&&(p.value=`paused`,h.value={...h.peek(),stepIndex:Math.min(r.stepIndex,e.steps.length-1)})}m.value=!0,e.autoStart&&queueMicrotask(()=>{c.aborted||startInternal()})};try{let e=a.get(o);e instanceof Promise?e.then(applyStored,e=>u(e)):applyStored(e)}catch(e){u(e)}return{back(){guard(),advanceTo(h.peek().stepIndex-1)},current:h,dismiss(){guard(),p.peek()!==`completed`&&p.peek()!==`dismissed`&&(stopTargetWatch(),h.value={...h.peek(),rect:null,step:null,stepIndex:-1},setStatus(`dismissed`),l({type:`tour:dismiss`}))},disposalSignal:c,dispose(){c.aborted||(l({type:`dispose`}),stopTargetWatch(),s.abort(),f())},get disposed(){return c.aborted},eligible:m,finish(){guard(),p.peek()!==`completed`&&finishInternal(`finish`)},goto(t){guard();let n=typeof t==`number`?t:e.steps.findIndex(e=>e.id===t);n<0||n>=e.steps.length?`${String(t)}${e.id}`:advanceTo(n)},id:e.id,next(){guard(),advanceTo(h.peek().stepIndex+1)},pause(){guard(),p.peek()===`active`&&(stopTargetWatch(),h.value={...h.peek(),rect:null},setStatus(`paused`))},reset(){guard(),stopTargetWatch(),clearPersisted(),h.value={placement:e.placement??`auto`,presentation:e.presentation??`auto`,rect:null,step:null,stepIndex:-1,totalSteps:e.steps.length},p.value=`idle`,m.value=!0,l({status:`idle`,type:`status-change`})},skip(){guard(),p.peek()!==`completed`&&p.peek()!==`dismissed`&&(stopTargetWatch(),h.value={...h.peek(),rect:null,step:null,stepIndex:-1},setStatus(`dismissed`),l({reason:`skip`,type:`tour:complete`}))},start:startInternal,status:p,steps:e.steps,tap:d,[Symbol.dispose](){this.dispose()}}}return e.BeaconConfigError=BeaconConfigError,e.BeaconDisposedError=BeaconDisposedError,e.BeaconError=BeaconError,e.createCoachmark=createCoachmark,e.createTour=createTour,e.resolveTarget=resolveTarget,e})({},Ripple);
|
|
2
|
+
//# sourceMappingURL=beacon.iife.js.map
|