@lincyaw/aegis-ui 0.23.1 → 0.24.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/components/ui/Tour.cjs +2 -0
- package/dist/components/ui/Tour.cjs.map +1 -0
- package/dist/components/ui/Tour.d.ts +56 -0
- package/dist/components/ui/Tour.js +241 -0
- package/dist/components/ui/Tour.js.map +1 -0
- package/dist/components/ui/index.d.ts +4 -0
- package/dist/components/ui/useTour.cjs +2 -0
- package/dist/components/ui/useTour.cjs.map +1 -0
- package/dist/components/ui/useTour.d.ts +28 -0
- package/dist/components/ui/useTour.js +62 -0
- package/dist/components/ui/useTour.js.map +1 -0
- package/dist/index.cjs +1 -1
- package/dist/index.js +71 -66
- package/dist/index.js.map +1 -1
- package/dist/locale/strings.cjs +1 -1
- package/dist/locale/strings.cjs.map +1 -1
- package/dist/locale/strings.d.ts +7 -0
- package/dist/locale/strings.js +10 -0
- package/dist/locale/strings.js.map +1 -1
- package/dist/style.css +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("react/jsx-runtime"),s=require("react"),T=require("antd"),M=require("../../hooks/useIsomorphicLayoutEffect.cjs"),P=require("./Button.cjs");;/* empty css */const z=require("../../locale/useStrings.cjs");function q(t){let e;return typeof t=="string"?e=document.querySelector(t):typeof t=="function"?e=t():e=t.current,!e?.isConnected||e.getClientRects().length===0?null:e}function A(t){return t.flatMap((e,n)=>q(e.target)?[n]:[])}function B(t,e){return t.length===e.length&&t.every((n,f)=>n===e[f])}function j(t){return Number.parseFloat(getComputedStyle(document.documentElement).getPropertyValue(t))}const b={prev:"aegis-tour__action--prev",next:"aegis-tour__action--next",finish:"aegis-tour__action--finish",skip:"aegis-tour__action--skip"},O=["prev","next","finish","skip"];function $({title:t,description:e,position:n,total:f,labels:i,regionLabel:c,actionHref:p,linkComponent:v,onAction:k}){const _=s.useId(),h=s.useId(),R=s.useRef(null),a=s.useRef(null),S=n===f-1,y=S?"finish":"next";s.useEffect(()=>{R.current?.querySelector(`.${b[y]}`)?.focus({preventScroll:!0})},[y]);const E=s.useRef(k);E.current=k;const d=p!==void 0;s.useEffect(()=>{const o=a.current;if(!d||o===null)return;const g=u=>{if(!(u.target instanceof Element))return;const w=O.find(C=>u.target instanceof Element&&u.target.closest(`.${b[C]}`)!==null);w!==void 0&&E.current(w)};return o.addEventListener("click",g),()=>{o.removeEventListener("click",g)}},[d]);const x=(o,g,u)=>p===void 0?m.jsx(P.Button,{tone:g,className:b[o],onClick:()=>{k(o)},children:u}):m.jsx(P.ButtonLink,{to:p(o),tone:g,className:b[o],linkComponent:v,children:u}),I=c===void 0?{role:"dialog","aria-labelledby":_,"aria-describedby":e===void 0?void 0:h}:{role:"region","aria-label":c};return m.jsxs("div",{ref:R,...I,className:"aegis-tour__panel",children:[m.jsx("h2",{id:_,className:"aegis-tour__title",children:t}),e!==void 0&&m.jsx("div",{id:h,className:"aegis-tour__description",children:e}),m.jsxs("div",{className:"aegis-tour__footer",children:[m.jsx("span",{className:"aegis-tour__progress",children:i.progress(n+1,f)}),m.jsxs("div",{ref:a,className:"aegis-tour__actions",children:[x("skip","ghost",i.skip),n>0&&x("prev","secondary",i.previous),x(y,"primary",S?i.finish:i.next)]})]})]})}function F(t){for(let e=t.parentElement;e!==null;e=e.parentElement){const{overflowY:n}=getComputedStyle(e);if((n==="auto"||n==="scroll")&&e.scrollHeight>e.clientHeight)return e}return document.scrollingElement??document.body}function H(t,e){const n=j("--space-4"),f=t.getBoundingClientRect(),i=e.getBoundingClientRect(),c=Math.min(f.top,i.top),p=Math.max(f.top,i.bottom);let v=0;return c<n?v=c-n:p>window.innerHeight-n&&(v=Math.min(p-(window.innerHeight-n),c-n)),Math.abs(v)<1?!1:(F(t).scrollBy({top:v}),window.dispatchEvent(new Event("resize")),!0)}function D(t){return t.closest("main")??document.querySelector("main")??document.body}function V(t,e){return`${String(t)} / ${String(e)}`}function K({open:t,steps:e,current:n,onChange:f,onClose:i,labels:c,inline:p=!1,label:v,actionHref:k,linkComponent:_}){const h=z.useStrings(),R={previous:c?.previous??h.tourPrevious,next:c?.next??h.tourNext,skip:c?.skip??h.tourSkip,finish:c?.finish??h.tourFinish,progress:c?.progress??V},[a,S]=s.useState([]);M.useIsomorphicLayoutEffect(()=>{const r=t?A(e):[];S(l=>B(l,r)?l:r)},[t,e,n]);const y=a.findIndex(r=>r>=n),E=y===-1?a.length-1:y,d=t&&a.length>0,x=s.useRef(i);x.current=i,s.useEffect(()=>{if(!d)return;const r=l=>{l.key==="Escape"&&(l.preventDefault(),x.current("skip"))};return document.addEventListener("keydown",r),()=>{document.removeEventListener("keydown",r)}},[d]);const I=s.useRef(null);s.useEffect(()=>{if(d)return I.current=document.activeElement instanceof HTMLElement?document.activeElement:null,()=>{const r=I.current;r?.isConnected&&r.focus({preventScroll:!0})}},[d]);const o=s.useMemo(()=>d?{zIndex:j("--z-modal"),gap:{offset:j("--space-1"),radius:j("--radius-md")}}:null,[d]),g=s.useRef(null),u=d?a[E]:null;s.useEffect(()=>{g.current=null},[u]);const w=r=>{if(u===null||g.current===u)return;const l=q(e[u].target);(l===null||!H(l,r))&&(g.current=u)};if(!d||o===null)return null;const C=a.map((r,l)=>{const N=e[r];return{target:()=>q(N.target)??document.body,placement:N.placement,title:null,description:m.jsx($,{title:N.title,description:N.description,position:l,total:a.length,labels:R,regionLabel:p?v??h.tour:void 0,actionHref:k,linkComponent:_,onAction:L=>{switch(L){case"prev":f(a[l-1]);break;case"next":f(a[l+1]);break;case"finish":case"skip":i(L);break}}},r)}});return m.jsx(T.Tour,{open:!0,steps:C,current:E,rootClassName:"aegis-tour",closable:!1,zIndex:o.zIndex,gap:o.gap,indicatorsRender:()=>null,actionsRender:()=>null,getPopupContainer:p?D:void 0,mask:p?{style:{zIndex:o.zIndex-1}}:!0,onPopupAlign:w})}exports.Tour=K;
|
|
2
|
+
//# sourceMappingURL=Tour.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Tour.cjs","sources":["../../../src/components/ui/Tour.tsx"],"sourcesContent":["import {\n type ReactNode,\n type RefObject,\n useEffect,\n useId,\n useMemo,\n useRef,\n useState,\n} from 'react';\n\nimport { Tour as AntdTour, type TourProps as AntdTourProps } from 'antd';\n\nimport { useIsomorphicLayoutEffect } from '../../hooks/useIsomorphicLayoutEffect';\nimport { useStrings } from '../../locale';\nimport { Button, ButtonLink } from './Button';\nimport './Tour.css';\nimport type { LinkComponent } from './linkComponent';\n\n/** The element a step points at: a ref, a CSS selector, or a lookup. */\nexport type TourTarget =\n | RefObject<HTMLElement | null>\n | string\n | (() => HTMLElement | null);\n\nexport type TourPlacement = 'top' | 'bottom' | 'left' | 'right';\n\nexport interface TourStep {\n target: TourTarget;\n title: ReactNode;\n description?: ReactNode;\n /** Side of the target the popover opens on; it flips when there is no room. */\n placement?: TourPlacement;\n}\n\n/** `finish` is the last step's done button; `skip` is the skip button or Escape. */\nexport type TourCloseReason = 'finish' | 'skip';\n\nexport interface TourLabels {\n previous: string;\n next: string;\n skip: string;\n finish: string;\n /** The position line, e.g. \"2 / 3\"; `position` counts from 1. */\n progress: (position: number, total: number) => string;\n}\n\n/** What a Tour control does; `actionHref` gives each one's link. */\nexport type TourAction = 'prev' | 'next' | 'finish' | 'skip';\n\nexport interface TourProps {\n open: boolean;\n steps: readonly TourStep[];\n /** Index into `steps`. A step whose target is missing shows the next present one. */\n current: number;\n onChange: (current: number) => void;\n onClose: (reason: TourCloseReason) => void;\n labels?: Partial<TourLabels>;\n /**\n * Draws the panel inside the page's `<main>` (the target's nearest, else\n * the document's first) instead of a portal on `document.body`, as a\n * `role=\"region\"` named by `label` rather than a dialog.\n */\n inline?: boolean;\n /** The inline panel's accessible name; defaults to the locale's `tour`. */\n label?: string;\n /**\n * Turns the controls into links to these hrefs, rendered by\n * `linkComponent`. A click still calls `onChange` or `onClose` as the\n * button would.\n */\n actionHref?: (action: TourAction) => string;\n /** Renders the action links; routed apps pass their Link adapter. */\n linkComponent?: LinkComponent;\n}\n\nfunction resolveTarget(target: TourTarget): HTMLElement | null {\n let element: HTMLElement | null;\n if (typeof target === 'string') {\n element = document.querySelector<HTMLElement>(target);\n } else if (typeof target === 'function') {\n element = target();\n } else {\n element = target.current;\n }\n // A target hidden by layout (display: none, a collapsed drawer) is missing too.\n if (!element?.isConnected || element.getClientRects().length === 0) {\n return null;\n }\n return element;\n}\n\nfunction presentSteps(steps: readonly TourStep[]): number[] {\n return steps.flatMap((step, index) =>\n resolveTarget(step.target) ? [index] : [],\n );\n}\n\nfunction sameIndices(a: readonly number[], b: readonly number[]): boolean {\n return a.length === b.length && a.every((value, i) => value === b[i]);\n}\n\nfunction cssNumber(name: string): number {\n return Number.parseFloat(\n getComputedStyle(document.documentElement).getPropertyValue(name),\n );\n}\n\ninterface TourPanelProps {\n title: ReactNode;\n description: ReactNode;\n position: number;\n total: number;\n labels: TourLabels;\n /** Set for an inline panel: a region with this name. */\n regionLabel: string | undefined;\n actionHref: ((action: TourAction) => string) | undefined;\n linkComponent: LinkComponent | undefined;\n onAction: (action: TourAction) => void;\n}\n\nconst ACTION_CLASS: Readonly<Record<TourAction, string>> = {\n prev: 'aegis-tour__action--prev',\n next: 'aegis-tour__action--next',\n finish: 'aegis-tour__action--finish',\n skip: 'aegis-tour__action--skip',\n};\n\nconst ACTIONS: readonly TourAction[] = ['prev', 'next', 'finish', 'skip'];\n\nfunction TourPanel({\n title,\n description,\n position,\n total,\n labels,\n regionLabel,\n actionHref,\n linkComponent,\n onAction,\n}: TourPanelProps) {\n const titleId = useId();\n const descriptionId = useId();\n const panelRef = useRef<HTMLDivElement>(null);\n const actionsRef = useRef<HTMLDivElement>(null);\n const last = position === total - 1;\n const primary: TourAction = last ? 'finish' : 'next';\n\n useEffect(() => {\n panelRef.current\n ?.querySelector<HTMLElement>(`.${ACTION_CLASS[primary]}`)\n ?.focus({ preventScroll: true });\n }, [primary]);\n\n // A link adapter takes no click handler, so link clicks are heard here.\n const onActionRef = useRef(onAction);\n onActionRef.current = onAction;\n const linked = actionHref !== undefined;\n useEffect(() => {\n const actions = actionsRef.current;\n if (!linked || actions === null) {\n return undefined;\n }\n const onClick = (event: MouseEvent): void => {\n if (!(event.target instanceof Element)) {\n return;\n }\n const hit = ACTIONS.find(\n (action) =>\n event.target instanceof Element &&\n event.target.closest(`.${ACTION_CLASS[action]}`) !== null,\n );\n if (hit !== undefined) {\n onActionRef.current(hit);\n }\n };\n actions.addEventListener('click', onClick);\n return () => {\n actions.removeEventListener('click', onClick);\n };\n }, [linked]);\n\n const control = (\n action: TourAction,\n tone: 'primary' | 'secondary' | 'ghost',\n text: string,\n ): ReactNode =>\n actionHref === undefined ? (\n <Button\n tone={tone}\n className={ACTION_CLASS[action]}\n onClick={() => {\n onAction(action);\n }}\n >\n {text}\n </Button>\n ) : (\n <ButtonLink\n to={actionHref(action)}\n tone={tone}\n className={ACTION_CLASS[action]}\n linkComponent={linkComponent}\n >\n {text}\n </ButtonLink>\n );\n\n const roleProps =\n regionLabel === undefined\n ? {\n role: 'dialog',\n 'aria-labelledby': titleId,\n 'aria-describedby':\n description === undefined ? undefined : descriptionId,\n }\n : { role: 'region', 'aria-label': regionLabel };\n\n return (\n <div ref={panelRef} {...roleProps} className=\"aegis-tour__panel\">\n <h2 id={titleId} className=\"aegis-tour__title\">\n {title}\n </h2>\n {description !== undefined && (\n <div id={descriptionId} className=\"aegis-tour__description\">\n {description}\n </div>\n )}\n <div className=\"aegis-tour__footer\">\n <span className=\"aegis-tour__progress\">\n {labels.progress(position + 1, total)}\n </span>\n <div ref={actionsRef} className=\"aegis-tour__actions\">\n {control('skip', 'ghost', labels.skip)}\n {position > 0 && control('prev', 'secondary', labels.previous)}\n {control(primary, 'primary', last ? labels.finish : labels.next)}\n </div>\n </div>\n </div>\n );\n}\n\nfunction scrollParent(element: HTMLElement): HTMLElement {\n for (\n let parent = element.parentElement;\n parent !== null;\n parent = parent.parentElement\n ) {\n const { overflowY } = getComputedStyle(parent);\n if (\n (overflowY === 'auto' || overflowY === 'scroll') &&\n parent.scrollHeight > parent.clientHeight\n ) {\n return parent;\n }\n }\n return (document.scrollingElement as HTMLElement | null) ?? document.body;\n}\n\n/**\n * Scrolls so the panel lies wholly in the viewport, never pushing the\n * target's top out of it. Returns whether it scrolled.\n */\nfunction keepInView(target: HTMLElement, panel: HTMLElement): boolean {\n const margin = cssNumber('--space-4');\n const targetRect = target.getBoundingClientRect();\n const panelRect = panel.getBoundingClientRect();\n const top = Math.min(targetRect.top, panelRect.top);\n const bottom = Math.max(targetRect.top, panelRect.bottom);\n let delta = 0;\n if (top < margin) {\n delta = top - margin;\n } else if (bottom > window.innerHeight - margin) {\n delta = Math.min(bottom - (window.innerHeight - margin), top - margin);\n }\n if (Math.abs(delta) < 1) {\n return false;\n }\n scrollParent(target).scrollBy({ top: delta });\n // antd measures the spotlight only on resize; the scroll moved the target.\n window.dispatchEvent(new Event('resize'));\n return true;\n}\n\nfunction mainOf(node: HTMLElement): HTMLElement {\n return (\n node.closest('main') ?? document.querySelector('main') ?? document.body\n );\n}\n\nfunction defaultProgress(position: number, total: number): string {\n return `${String(position)} / ${String(total)}`;\n}\n\n/**\n * A guided tour: a spotlight on each step's target and a popover dialog\n * beside it. Steps whose target is missing or hidden are left out of the\n * tour and of its count. Escape skips. Wraps antd's Tour, so it follows the\n * `getAegisTheme` ConfigProvider; the panel itself is drawn from tokens.\n */\nexport function Tour({\n open,\n steps,\n current,\n onChange,\n onClose,\n labels,\n inline = false,\n label,\n actionHref,\n linkComponent,\n}: TourProps) {\n const strings = useStrings();\n const mergedLabels: TourLabels = {\n previous: labels?.previous ?? strings.tourPrevious,\n next: labels?.next ?? strings.tourNext,\n skip: labels?.skip ?? strings.tourSkip,\n finish: labels?.finish ?? strings.tourFinish,\n progress: labels?.progress ?? defaultProgress,\n };\n const [present, setPresent] = useState<number[]>([]);\n\n // After commit, so refs are set; moving to another step looks again, so\n // a target that appeared since joins the tour.\n useIsomorphicLayoutEffect(() => {\n const next = open ? presentSteps(steps) : [];\n setPresent((previous) => (sameIndices(previous, next) ? previous : next));\n }, [open, steps, current]);\n\n const firstAtOrAfter = present.findIndex((index) => index >= current);\n const position = firstAtOrAfter === -1 ? present.length - 1 : firstAtOrAfter;\n const visible = open && present.length > 0;\n\n const onCloseRef = useRef(onClose);\n onCloseRef.current = onClose;\n useEffect(() => {\n if (!visible) {\n return undefined;\n }\n const onKeyDown = (event: KeyboardEvent): void => {\n if (event.key === 'Escape') {\n event.preventDefault();\n onCloseRef.current('skip');\n }\n };\n document.addEventListener('keydown', onKeyDown);\n return () => {\n document.removeEventListener('keydown', onKeyDown);\n };\n }, [visible]);\n\n const returnFocusRef = useRef<HTMLElement | null>(null);\n useEffect(() => {\n if (!visible) {\n return undefined;\n }\n returnFocusRef.current =\n document.activeElement instanceof HTMLElement\n ? document.activeElement\n : null;\n return () => {\n const element = returnFocusRef.current;\n if (element?.isConnected) {\n element.focus({ preventScroll: true });\n }\n };\n }, [visible]);\n\n const geometry = useMemo(\n () =>\n visible\n ? {\n zIndex: cssNumber('--z-modal'),\n gap: {\n offset: cssNumber('--space-1'),\n radius: cssNumber('--radius-md'),\n },\n }\n : null,\n [visible],\n );\n\n // Adjusts the scroll after the step's first alignments, until nothing\n // needs to move; later alignments (the reader scrolling) are left alone.\n const settledRef = useRef<number | null>(null);\n const shownIndex = visible ? present[position] : null;\n useEffect(() => {\n settledRef.current = null;\n }, [shownIndex]);\n const onPopupAlign = (popup: HTMLElement): void => {\n if (shownIndex === null || settledRef.current === shownIndex) {\n return;\n }\n const target = resolveTarget(steps[shownIndex].target);\n if (target === null || !keepInView(target, popup)) {\n settledRef.current = shownIndex;\n }\n };\n\n if (!visible || geometry === null) {\n return null;\n }\n\n const antdSteps: AntdTourProps['steps'] = present.map((index, at) => {\n const step = steps[index];\n return {\n target: () => resolveTarget(step.target) ?? document.body,\n placement: step.placement,\n title: null,\n description: (\n <TourPanel\n key={index}\n title={step.title}\n description={step.description}\n position={at}\n total={present.length}\n labels={mergedLabels}\n regionLabel={inline ? (label ?? strings.tour) : undefined}\n actionHref={actionHref}\n linkComponent={linkComponent}\n onAction={(action) => {\n switch (action) {\n case 'prev':\n onChange(present[at - 1]);\n break;\n case 'next':\n onChange(present[at + 1]);\n break;\n case 'finish':\n case 'skip':\n onClose(action);\n break;\n }\n }}\n />\n ),\n };\n });\n\n return (\n <AntdTour\n open\n steps={antdSteps}\n current={position}\n rootClassName=\"aegis-tour\"\n closable={false}\n zIndex={geometry.zIndex}\n gap={geometry.gap}\n indicatorsRender={() => null}\n actionsRender={() => null}\n getPopupContainer={inline ? mainOf : undefined}\n // The mask is portalled after main; one layer lower, it stays under\n // a panel drawn inside main.\n mask={inline ? { style: { zIndex: geometry.zIndex - 1 } } : true}\n onPopupAlign={onPopupAlign}\n />\n );\n}\n"],"names":["resolveTarget","target","element","presentSteps","steps","step","index","sameIndices","a","b","value","i","cssNumber","name","ACTION_CLASS","ACTIONS","TourPanel","title","description","position","total","labels","regionLabel","actionHref","linkComponent","onAction","titleId","useId","descriptionId","panelRef","useRef","actionsRef","last","primary","useEffect","onActionRef","linked","actions","onClick","event","hit","action","control","tone","text","jsx","Button","ButtonLink","roleProps","jsxs","scrollParent","parent","overflowY","keepInView","panel","margin","targetRect","panelRect","top","bottom","delta","mainOf","node","defaultProgress","Tour","open","current","onChange","onClose","inline","label","strings","useStrings","mergedLabels","present","setPresent","useState","useIsomorphicLayoutEffect","next","previous","firstAtOrAfter","visible","onCloseRef","onKeyDown","returnFocusRef","geometry","useMemo","settledRef","shownIndex","onPopupAlign","popup","antdSteps","at","AntdTour"],"mappings":"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"}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import { ReactNode, RefObject } from 'react';
|
|
2
|
+
import { LinkComponent } from './linkComponent';
|
|
3
|
+
/** The element a step points at: a ref, a CSS selector, or a lookup. */
|
|
4
|
+
export type TourTarget = RefObject<HTMLElement | null> | string | (() => HTMLElement | null);
|
|
5
|
+
export type TourPlacement = 'top' | 'bottom' | 'left' | 'right';
|
|
6
|
+
export interface TourStep {
|
|
7
|
+
target: TourTarget;
|
|
8
|
+
title: ReactNode;
|
|
9
|
+
description?: ReactNode;
|
|
10
|
+
/** Side of the target the popover opens on; it flips when there is no room. */
|
|
11
|
+
placement?: TourPlacement;
|
|
12
|
+
}
|
|
13
|
+
/** `finish` is the last step's done button; `skip` is the skip button or Escape. */
|
|
14
|
+
export type TourCloseReason = 'finish' | 'skip';
|
|
15
|
+
export interface TourLabels {
|
|
16
|
+
previous: string;
|
|
17
|
+
next: string;
|
|
18
|
+
skip: string;
|
|
19
|
+
finish: string;
|
|
20
|
+
/** The position line, e.g. "2 / 3"; `position` counts from 1. */
|
|
21
|
+
progress: (position: number, total: number) => string;
|
|
22
|
+
}
|
|
23
|
+
/** What a Tour control does; `actionHref` gives each one's link. */
|
|
24
|
+
export type TourAction = 'prev' | 'next' | 'finish' | 'skip';
|
|
25
|
+
export interface TourProps {
|
|
26
|
+
open: boolean;
|
|
27
|
+
steps: readonly TourStep[];
|
|
28
|
+
/** Index into `steps`. A step whose target is missing shows the next present one. */
|
|
29
|
+
current: number;
|
|
30
|
+
onChange: (current: number) => void;
|
|
31
|
+
onClose: (reason: TourCloseReason) => void;
|
|
32
|
+
labels?: Partial<TourLabels>;
|
|
33
|
+
/**
|
|
34
|
+
* Draws the panel inside the page's `<main>` (the target's nearest, else
|
|
35
|
+
* the document's first) instead of a portal on `document.body`, as a
|
|
36
|
+
* `role="region"` named by `label` rather than a dialog.
|
|
37
|
+
*/
|
|
38
|
+
inline?: boolean;
|
|
39
|
+
/** The inline panel's accessible name; defaults to the locale's `tour`. */
|
|
40
|
+
label?: string;
|
|
41
|
+
/**
|
|
42
|
+
* Turns the controls into links to these hrefs, rendered by
|
|
43
|
+
* `linkComponent`. A click still calls `onChange` or `onClose` as the
|
|
44
|
+
* button would.
|
|
45
|
+
*/
|
|
46
|
+
actionHref?: (action: TourAction) => string;
|
|
47
|
+
/** Renders the action links; routed apps pass their Link adapter. */
|
|
48
|
+
linkComponent?: LinkComponent;
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* A guided tour: a spotlight on each step's target and a popover dialog
|
|
52
|
+
* beside it. Steps whose target is missing or hidden are left out of the
|
|
53
|
+
* tour and of its count. Escape skips. Wraps antd's Tour, so it follows the
|
|
54
|
+
* `getAegisTheme` ConfigProvider; the panel itself is drawn from tokens.
|
|
55
|
+
*/
|
|
56
|
+
export declare function Tour({ open, steps, current, onChange, onClose, labels, inline, label, actionHref, linkComponent, }: TourProps): import("react/jsx-runtime").JSX.Element | null;
|
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
import { jsx as v, jsxs as T } from "react/jsx-runtime";
|
|
2
|
+
import { useState as B, useRef as k, useEffect as E, useMemo as $, useId as A } from "react";
|
|
3
|
+
import { Tour as O } from "antd";
|
|
4
|
+
import { useIsomorphicLayoutEffect as q } from "../../hooks/useIsomorphicLayoutEffect.js";
|
|
5
|
+
import { Button as F, ButtonLink as H } from "./Button.js";
|
|
6
|
+
/* empty css */
|
|
7
|
+
import { useStrings as j } from "../../locale/useStrings.js";
|
|
8
|
+
function z(t) {
|
|
9
|
+
let e;
|
|
10
|
+
return typeof t == "string" ? e = document.querySelector(t) : typeof t == "function" ? e = t() : e = t.current, !e?.isConnected || e.getClientRects().length === 0 ? null : e;
|
|
11
|
+
}
|
|
12
|
+
function D(t) {
|
|
13
|
+
return t.flatMap(
|
|
14
|
+
(e, n) => z(e.target) ? [n] : []
|
|
15
|
+
);
|
|
16
|
+
}
|
|
17
|
+
function V(t, e) {
|
|
18
|
+
return t.length === e.length && t.every((n, d) => n === e[d]);
|
|
19
|
+
}
|
|
20
|
+
function b(t) {
|
|
21
|
+
return Number.parseFloat(
|
|
22
|
+
getComputedStyle(document.documentElement).getPropertyValue(t)
|
|
23
|
+
);
|
|
24
|
+
}
|
|
25
|
+
const C = {
|
|
26
|
+
prev: "aegis-tour__action--prev",
|
|
27
|
+
next: "aegis-tour__action--next",
|
|
28
|
+
finish: "aegis-tour__action--finish",
|
|
29
|
+
skip: "aegis-tour__action--skip"
|
|
30
|
+
}, K = ["prev", "next", "finish", "skip"];
|
|
31
|
+
function Y({
|
|
32
|
+
title: t,
|
|
33
|
+
description: e,
|
|
34
|
+
position: n,
|
|
35
|
+
total: d,
|
|
36
|
+
labels: i,
|
|
37
|
+
regionLabel: s,
|
|
38
|
+
actionHref: f,
|
|
39
|
+
linkComponent: m,
|
|
40
|
+
onAction: _
|
|
41
|
+
}) {
|
|
42
|
+
const S = A(), g = A(), I = k(null), l = k(null), w = n === d - 1, h = w ? "finish" : "next";
|
|
43
|
+
E(() => {
|
|
44
|
+
I.current?.querySelector(`.${C[h]}`)?.focus({ preventScroll: !0 });
|
|
45
|
+
}, [h]);
|
|
46
|
+
const x = k(_);
|
|
47
|
+
x.current = _;
|
|
48
|
+
const a = f !== void 0;
|
|
49
|
+
E(() => {
|
|
50
|
+
const o = l.current;
|
|
51
|
+
if (!a || o === null)
|
|
52
|
+
return;
|
|
53
|
+
const p = (c) => {
|
|
54
|
+
if (!(c.target instanceof Element))
|
|
55
|
+
return;
|
|
56
|
+
const N = K.find(
|
|
57
|
+
(L) => c.target instanceof Element && c.target.closest(`.${C[L]}`) !== null
|
|
58
|
+
);
|
|
59
|
+
N !== void 0 && x.current(N);
|
|
60
|
+
};
|
|
61
|
+
return o.addEventListener("click", p), () => {
|
|
62
|
+
o.removeEventListener("click", p);
|
|
63
|
+
};
|
|
64
|
+
}, [a]);
|
|
65
|
+
const y = (o, p, c) => f === void 0 ? /* @__PURE__ */ v(
|
|
66
|
+
F,
|
|
67
|
+
{
|
|
68
|
+
tone: p,
|
|
69
|
+
className: C[o],
|
|
70
|
+
onClick: () => {
|
|
71
|
+
_(o);
|
|
72
|
+
},
|
|
73
|
+
children: c
|
|
74
|
+
}
|
|
75
|
+
) : /* @__PURE__ */ v(
|
|
76
|
+
H,
|
|
77
|
+
{
|
|
78
|
+
to: f(o),
|
|
79
|
+
tone: p,
|
|
80
|
+
className: C[o],
|
|
81
|
+
linkComponent: m,
|
|
82
|
+
children: c
|
|
83
|
+
}
|
|
84
|
+
);
|
|
85
|
+
return /* @__PURE__ */ T("div", { ref: I, ...s === void 0 ? {
|
|
86
|
+
role: "dialog",
|
|
87
|
+
"aria-labelledby": S,
|
|
88
|
+
"aria-describedby": e === void 0 ? void 0 : g
|
|
89
|
+
} : { role: "region", "aria-label": s }, className: "aegis-tour__panel", children: [
|
|
90
|
+
/* @__PURE__ */ v("h2", { id: S, className: "aegis-tour__title", children: t }),
|
|
91
|
+
e !== void 0 && /* @__PURE__ */ v("div", { id: g, className: "aegis-tour__description", children: e }),
|
|
92
|
+
/* @__PURE__ */ T("div", { className: "aegis-tour__footer", children: [
|
|
93
|
+
/* @__PURE__ */ v("span", { className: "aegis-tour__progress", children: i.progress(n + 1, d) }),
|
|
94
|
+
/* @__PURE__ */ T("div", { ref: l, className: "aegis-tour__actions", children: [
|
|
95
|
+
y("skip", "ghost", i.skip),
|
|
96
|
+
n > 0 && y("prev", "secondary", i.previous),
|
|
97
|
+
y(h, "primary", w ? i.finish : i.next)
|
|
98
|
+
] })
|
|
99
|
+
] })
|
|
100
|
+
] });
|
|
101
|
+
}
|
|
102
|
+
function G(t) {
|
|
103
|
+
for (let e = t.parentElement; e !== null; e = e.parentElement) {
|
|
104
|
+
const { overflowY: n } = getComputedStyle(e);
|
|
105
|
+
if ((n === "auto" || n === "scroll") && e.scrollHeight > e.clientHeight)
|
|
106
|
+
return e;
|
|
107
|
+
}
|
|
108
|
+
return document.scrollingElement ?? document.body;
|
|
109
|
+
}
|
|
110
|
+
function J(t, e) {
|
|
111
|
+
const n = b("--space-4"), d = t.getBoundingClientRect(), i = e.getBoundingClientRect(), s = Math.min(d.top, i.top), f = Math.max(d.top, i.bottom);
|
|
112
|
+
let m = 0;
|
|
113
|
+
return s < n ? m = s - n : f > window.innerHeight - n && (m = Math.min(f - (window.innerHeight - n), s - n)), Math.abs(m) < 1 ? !1 : (G(t).scrollBy({ top: m }), window.dispatchEvent(new Event("resize")), !0);
|
|
114
|
+
}
|
|
115
|
+
function Q(t) {
|
|
116
|
+
return t.closest("main") ?? document.querySelector("main") ?? document.body;
|
|
117
|
+
}
|
|
118
|
+
function U(t, e) {
|
|
119
|
+
return `${String(t)} / ${String(e)}`;
|
|
120
|
+
}
|
|
121
|
+
function oe({
|
|
122
|
+
open: t,
|
|
123
|
+
steps: e,
|
|
124
|
+
current: n,
|
|
125
|
+
onChange: d,
|
|
126
|
+
onClose: i,
|
|
127
|
+
labels: s,
|
|
128
|
+
inline: f = !1,
|
|
129
|
+
label: m,
|
|
130
|
+
actionHref: _,
|
|
131
|
+
linkComponent: S
|
|
132
|
+
}) {
|
|
133
|
+
const g = j(), I = {
|
|
134
|
+
previous: s?.previous ?? g.tourPrevious,
|
|
135
|
+
next: s?.next ?? g.tourNext,
|
|
136
|
+
skip: s?.skip ?? g.tourSkip,
|
|
137
|
+
finish: s?.finish ?? g.tourFinish,
|
|
138
|
+
progress: s?.progress ?? U
|
|
139
|
+
}, [l, w] = B([]);
|
|
140
|
+
q(() => {
|
|
141
|
+
const r = t ? D(e) : [];
|
|
142
|
+
w((u) => V(u, r) ? u : r);
|
|
143
|
+
}, [t, e, n]);
|
|
144
|
+
const h = l.findIndex((r) => r >= n), x = h === -1 ? l.length - 1 : h, a = t && l.length > 0, y = k(i);
|
|
145
|
+
y.current = i, E(() => {
|
|
146
|
+
if (!a)
|
|
147
|
+
return;
|
|
148
|
+
const r = (u) => {
|
|
149
|
+
u.key === "Escape" && (u.preventDefault(), y.current("skip"));
|
|
150
|
+
};
|
|
151
|
+
return document.addEventListener("keydown", r), () => {
|
|
152
|
+
document.removeEventListener("keydown", r);
|
|
153
|
+
};
|
|
154
|
+
}, [a]);
|
|
155
|
+
const P = k(null);
|
|
156
|
+
E(() => {
|
|
157
|
+
if (a)
|
|
158
|
+
return P.current = document.activeElement instanceof HTMLElement ? document.activeElement : null, () => {
|
|
159
|
+
const r = P.current;
|
|
160
|
+
r?.isConnected && r.focus({ preventScroll: !0 });
|
|
161
|
+
};
|
|
162
|
+
}, [a]);
|
|
163
|
+
const o = $(
|
|
164
|
+
() => a ? {
|
|
165
|
+
zIndex: b("--z-modal"),
|
|
166
|
+
gap: {
|
|
167
|
+
offset: b("--space-1"),
|
|
168
|
+
radius: b("--radius-md")
|
|
169
|
+
}
|
|
170
|
+
} : null,
|
|
171
|
+
[a]
|
|
172
|
+
), p = k(null), c = a ? l[x] : null;
|
|
173
|
+
E(() => {
|
|
174
|
+
p.current = null;
|
|
175
|
+
}, [c]);
|
|
176
|
+
const N = (r) => {
|
|
177
|
+
if (c === null || p.current === c)
|
|
178
|
+
return;
|
|
179
|
+
const u = z(e[c].target);
|
|
180
|
+
(u === null || !J(u, r)) && (p.current = c);
|
|
181
|
+
};
|
|
182
|
+
if (!a || o === null)
|
|
183
|
+
return null;
|
|
184
|
+
const L = l.map((r, u) => {
|
|
185
|
+
const R = e[r];
|
|
186
|
+
return {
|
|
187
|
+
target: () => z(R.target) ?? document.body,
|
|
188
|
+
placement: R.placement,
|
|
189
|
+
title: null,
|
|
190
|
+
description: /* @__PURE__ */ v(
|
|
191
|
+
Y,
|
|
192
|
+
{
|
|
193
|
+
title: R.title,
|
|
194
|
+
description: R.description,
|
|
195
|
+
position: u,
|
|
196
|
+
total: l.length,
|
|
197
|
+
labels: I,
|
|
198
|
+
regionLabel: f ? m ?? g.tour : void 0,
|
|
199
|
+
actionHref: _,
|
|
200
|
+
linkComponent: S,
|
|
201
|
+
onAction: (M) => {
|
|
202
|
+
switch (M) {
|
|
203
|
+
case "prev":
|
|
204
|
+
d(l[u - 1]);
|
|
205
|
+
break;
|
|
206
|
+
case "next":
|
|
207
|
+
d(l[u + 1]);
|
|
208
|
+
break;
|
|
209
|
+
case "finish":
|
|
210
|
+
case "skip":
|
|
211
|
+
i(M);
|
|
212
|
+
break;
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
},
|
|
216
|
+
r
|
|
217
|
+
)
|
|
218
|
+
};
|
|
219
|
+
});
|
|
220
|
+
return /* @__PURE__ */ v(
|
|
221
|
+
O,
|
|
222
|
+
{
|
|
223
|
+
open: !0,
|
|
224
|
+
steps: L,
|
|
225
|
+
current: x,
|
|
226
|
+
rootClassName: "aegis-tour",
|
|
227
|
+
closable: !1,
|
|
228
|
+
zIndex: o.zIndex,
|
|
229
|
+
gap: o.gap,
|
|
230
|
+
indicatorsRender: () => null,
|
|
231
|
+
actionsRender: () => null,
|
|
232
|
+
getPopupContainer: f ? Q : void 0,
|
|
233
|
+
mask: f ? { style: { zIndex: o.zIndex - 1 } } : !0,
|
|
234
|
+
onPopupAlign: N
|
|
235
|
+
}
|
|
236
|
+
);
|
|
237
|
+
}
|
|
238
|
+
export {
|
|
239
|
+
oe as Tour
|
|
240
|
+
};
|
|
241
|
+
//# sourceMappingURL=Tour.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Tour.js","sources":["../../../src/components/ui/Tour.tsx"],"sourcesContent":["import {\n type ReactNode,\n type RefObject,\n useEffect,\n useId,\n useMemo,\n useRef,\n useState,\n} from 'react';\n\nimport { Tour as AntdTour, type TourProps as AntdTourProps } from 'antd';\n\nimport { useIsomorphicLayoutEffect } from '../../hooks/useIsomorphicLayoutEffect';\nimport { useStrings } from '../../locale';\nimport { Button, ButtonLink } from './Button';\nimport './Tour.css';\nimport type { LinkComponent } from './linkComponent';\n\n/** The element a step points at: a ref, a CSS selector, or a lookup. */\nexport type TourTarget =\n | RefObject<HTMLElement | null>\n | string\n | (() => HTMLElement | null);\n\nexport type TourPlacement = 'top' | 'bottom' | 'left' | 'right';\n\nexport interface TourStep {\n target: TourTarget;\n title: ReactNode;\n description?: ReactNode;\n /** Side of the target the popover opens on; it flips when there is no room. */\n placement?: TourPlacement;\n}\n\n/** `finish` is the last step's done button; `skip` is the skip button or Escape. */\nexport type TourCloseReason = 'finish' | 'skip';\n\nexport interface TourLabels {\n previous: string;\n next: string;\n skip: string;\n finish: string;\n /** The position line, e.g. \"2 / 3\"; `position` counts from 1. */\n progress: (position: number, total: number) => string;\n}\n\n/** What a Tour control does; `actionHref` gives each one's link. */\nexport type TourAction = 'prev' | 'next' | 'finish' | 'skip';\n\nexport interface TourProps {\n open: boolean;\n steps: readonly TourStep[];\n /** Index into `steps`. A step whose target is missing shows the next present one. */\n current: number;\n onChange: (current: number) => void;\n onClose: (reason: TourCloseReason) => void;\n labels?: Partial<TourLabels>;\n /**\n * Draws the panel inside the page's `<main>` (the target's nearest, else\n * the document's first) instead of a portal on `document.body`, as a\n * `role=\"region\"` named by `label` rather than a dialog.\n */\n inline?: boolean;\n /** The inline panel's accessible name; defaults to the locale's `tour`. */\n label?: string;\n /**\n * Turns the controls into links to these hrefs, rendered by\n * `linkComponent`. A click still calls `onChange` or `onClose` as the\n * button would.\n */\n actionHref?: (action: TourAction) => string;\n /** Renders the action links; routed apps pass their Link adapter. */\n linkComponent?: LinkComponent;\n}\n\nfunction resolveTarget(target: TourTarget): HTMLElement | null {\n let element: HTMLElement | null;\n if (typeof target === 'string') {\n element = document.querySelector<HTMLElement>(target);\n } else if (typeof target === 'function') {\n element = target();\n } else {\n element = target.current;\n }\n // A target hidden by layout (display: none, a collapsed drawer) is missing too.\n if (!element?.isConnected || element.getClientRects().length === 0) {\n return null;\n }\n return element;\n}\n\nfunction presentSteps(steps: readonly TourStep[]): number[] {\n return steps.flatMap((step, index) =>\n resolveTarget(step.target) ? [index] : [],\n );\n}\n\nfunction sameIndices(a: readonly number[], b: readonly number[]): boolean {\n return a.length === b.length && a.every((value, i) => value === b[i]);\n}\n\nfunction cssNumber(name: string): number {\n return Number.parseFloat(\n getComputedStyle(document.documentElement).getPropertyValue(name),\n );\n}\n\ninterface TourPanelProps {\n title: ReactNode;\n description: ReactNode;\n position: number;\n total: number;\n labels: TourLabels;\n /** Set for an inline panel: a region with this name. */\n regionLabel: string | undefined;\n actionHref: ((action: TourAction) => string) | undefined;\n linkComponent: LinkComponent | undefined;\n onAction: (action: TourAction) => void;\n}\n\nconst ACTION_CLASS: Readonly<Record<TourAction, string>> = {\n prev: 'aegis-tour__action--prev',\n next: 'aegis-tour__action--next',\n finish: 'aegis-tour__action--finish',\n skip: 'aegis-tour__action--skip',\n};\n\nconst ACTIONS: readonly TourAction[] = ['prev', 'next', 'finish', 'skip'];\n\nfunction TourPanel({\n title,\n description,\n position,\n total,\n labels,\n regionLabel,\n actionHref,\n linkComponent,\n onAction,\n}: TourPanelProps) {\n const titleId = useId();\n const descriptionId = useId();\n const panelRef = useRef<HTMLDivElement>(null);\n const actionsRef = useRef<HTMLDivElement>(null);\n const last = position === total - 1;\n const primary: TourAction = last ? 'finish' : 'next';\n\n useEffect(() => {\n panelRef.current\n ?.querySelector<HTMLElement>(`.${ACTION_CLASS[primary]}`)\n ?.focus({ preventScroll: true });\n }, [primary]);\n\n // A link adapter takes no click handler, so link clicks are heard here.\n const onActionRef = useRef(onAction);\n onActionRef.current = onAction;\n const linked = actionHref !== undefined;\n useEffect(() => {\n const actions = actionsRef.current;\n if (!linked || actions === null) {\n return undefined;\n }\n const onClick = (event: MouseEvent): void => {\n if (!(event.target instanceof Element)) {\n return;\n }\n const hit = ACTIONS.find(\n (action) =>\n event.target instanceof Element &&\n event.target.closest(`.${ACTION_CLASS[action]}`) !== null,\n );\n if (hit !== undefined) {\n onActionRef.current(hit);\n }\n };\n actions.addEventListener('click', onClick);\n return () => {\n actions.removeEventListener('click', onClick);\n };\n }, [linked]);\n\n const control = (\n action: TourAction,\n tone: 'primary' | 'secondary' | 'ghost',\n text: string,\n ): ReactNode =>\n actionHref === undefined ? (\n <Button\n tone={tone}\n className={ACTION_CLASS[action]}\n onClick={() => {\n onAction(action);\n }}\n >\n {text}\n </Button>\n ) : (\n <ButtonLink\n to={actionHref(action)}\n tone={tone}\n className={ACTION_CLASS[action]}\n linkComponent={linkComponent}\n >\n {text}\n </ButtonLink>\n );\n\n const roleProps =\n regionLabel === undefined\n ? {\n role: 'dialog',\n 'aria-labelledby': titleId,\n 'aria-describedby':\n description === undefined ? undefined : descriptionId,\n }\n : { role: 'region', 'aria-label': regionLabel };\n\n return (\n <div ref={panelRef} {...roleProps} className=\"aegis-tour__panel\">\n <h2 id={titleId} className=\"aegis-tour__title\">\n {title}\n </h2>\n {description !== undefined && (\n <div id={descriptionId} className=\"aegis-tour__description\">\n {description}\n </div>\n )}\n <div className=\"aegis-tour__footer\">\n <span className=\"aegis-tour__progress\">\n {labels.progress(position + 1, total)}\n </span>\n <div ref={actionsRef} className=\"aegis-tour__actions\">\n {control('skip', 'ghost', labels.skip)}\n {position > 0 && control('prev', 'secondary', labels.previous)}\n {control(primary, 'primary', last ? labels.finish : labels.next)}\n </div>\n </div>\n </div>\n );\n}\n\nfunction scrollParent(element: HTMLElement): HTMLElement {\n for (\n let parent = element.parentElement;\n parent !== null;\n parent = parent.parentElement\n ) {\n const { overflowY } = getComputedStyle(parent);\n if (\n (overflowY === 'auto' || overflowY === 'scroll') &&\n parent.scrollHeight > parent.clientHeight\n ) {\n return parent;\n }\n }\n return (document.scrollingElement as HTMLElement | null) ?? document.body;\n}\n\n/**\n * Scrolls so the panel lies wholly in the viewport, never pushing the\n * target's top out of it. Returns whether it scrolled.\n */\nfunction keepInView(target: HTMLElement, panel: HTMLElement): boolean {\n const margin = cssNumber('--space-4');\n const targetRect = target.getBoundingClientRect();\n const panelRect = panel.getBoundingClientRect();\n const top = Math.min(targetRect.top, panelRect.top);\n const bottom = Math.max(targetRect.top, panelRect.bottom);\n let delta = 0;\n if (top < margin) {\n delta = top - margin;\n } else if (bottom > window.innerHeight - margin) {\n delta = Math.min(bottom - (window.innerHeight - margin), top - margin);\n }\n if (Math.abs(delta) < 1) {\n return false;\n }\n scrollParent(target).scrollBy({ top: delta });\n // antd measures the spotlight only on resize; the scroll moved the target.\n window.dispatchEvent(new Event('resize'));\n return true;\n}\n\nfunction mainOf(node: HTMLElement): HTMLElement {\n return (\n node.closest('main') ?? document.querySelector('main') ?? document.body\n );\n}\n\nfunction defaultProgress(position: number, total: number): string {\n return `${String(position)} / ${String(total)}`;\n}\n\n/**\n * A guided tour: a spotlight on each step's target and a popover dialog\n * beside it. Steps whose target is missing or hidden are left out of the\n * tour and of its count. Escape skips. Wraps antd's Tour, so it follows the\n * `getAegisTheme` ConfigProvider; the panel itself is drawn from tokens.\n */\nexport function Tour({\n open,\n steps,\n current,\n onChange,\n onClose,\n labels,\n inline = false,\n label,\n actionHref,\n linkComponent,\n}: TourProps) {\n const strings = useStrings();\n const mergedLabels: TourLabels = {\n previous: labels?.previous ?? strings.tourPrevious,\n next: labels?.next ?? strings.tourNext,\n skip: labels?.skip ?? strings.tourSkip,\n finish: labels?.finish ?? strings.tourFinish,\n progress: labels?.progress ?? defaultProgress,\n };\n const [present, setPresent] = useState<number[]>([]);\n\n // After commit, so refs are set; moving to another step looks again, so\n // a target that appeared since joins the tour.\n useIsomorphicLayoutEffect(() => {\n const next = open ? presentSteps(steps) : [];\n setPresent((previous) => (sameIndices(previous, next) ? previous : next));\n }, [open, steps, current]);\n\n const firstAtOrAfter = present.findIndex((index) => index >= current);\n const position = firstAtOrAfter === -1 ? present.length - 1 : firstAtOrAfter;\n const visible = open && present.length > 0;\n\n const onCloseRef = useRef(onClose);\n onCloseRef.current = onClose;\n useEffect(() => {\n if (!visible) {\n return undefined;\n }\n const onKeyDown = (event: KeyboardEvent): void => {\n if (event.key === 'Escape') {\n event.preventDefault();\n onCloseRef.current('skip');\n }\n };\n document.addEventListener('keydown', onKeyDown);\n return () => {\n document.removeEventListener('keydown', onKeyDown);\n };\n }, [visible]);\n\n const returnFocusRef = useRef<HTMLElement | null>(null);\n useEffect(() => {\n if (!visible) {\n return undefined;\n }\n returnFocusRef.current =\n document.activeElement instanceof HTMLElement\n ? document.activeElement\n : null;\n return () => {\n const element = returnFocusRef.current;\n if (element?.isConnected) {\n element.focus({ preventScroll: true });\n }\n };\n }, [visible]);\n\n const geometry = useMemo(\n () =>\n visible\n ? {\n zIndex: cssNumber('--z-modal'),\n gap: {\n offset: cssNumber('--space-1'),\n radius: cssNumber('--radius-md'),\n },\n }\n : null,\n [visible],\n );\n\n // Adjusts the scroll after the step's first alignments, until nothing\n // needs to move; later alignments (the reader scrolling) are left alone.\n const settledRef = useRef<number | null>(null);\n const shownIndex = visible ? present[position] : null;\n useEffect(() => {\n settledRef.current = null;\n }, [shownIndex]);\n const onPopupAlign = (popup: HTMLElement): void => {\n if (shownIndex === null || settledRef.current === shownIndex) {\n return;\n }\n const target = resolveTarget(steps[shownIndex].target);\n if (target === null || !keepInView(target, popup)) {\n settledRef.current = shownIndex;\n }\n };\n\n if (!visible || geometry === null) {\n return null;\n }\n\n const antdSteps: AntdTourProps['steps'] = present.map((index, at) => {\n const step = steps[index];\n return {\n target: () => resolveTarget(step.target) ?? document.body,\n placement: step.placement,\n title: null,\n description: (\n <TourPanel\n key={index}\n title={step.title}\n description={step.description}\n position={at}\n total={present.length}\n labels={mergedLabels}\n regionLabel={inline ? (label ?? strings.tour) : undefined}\n actionHref={actionHref}\n linkComponent={linkComponent}\n onAction={(action) => {\n switch (action) {\n case 'prev':\n onChange(present[at - 1]);\n break;\n case 'next':\n onChange(present[at + 1]);\n break;\n case 'finish':\n case 'skip':\n onClose(action);\n break;\n }\n }}\n />\n ),\n };\n });\n\n return (\n <AntdTour\n open\n steps={antdSteps}\n current={position}\n rootClassName=\"aegis-tour\"\n closable={false}\n zIndex={geometry.zIndex}\n gap={geometry.gap}\n indicatorsRender={() => null}\n actionsRender={() => null}\n getPopupContainer={inline ? mainOf : undefined}\n // The mask is portalled after main; one layer lower, it stays under\n // a panel drawn inside main.\n mask={inline ? { style: { zIndex: geometry.zIndex - 1 } } : true}\n onPopupAlign={onPopupAlign}\n />\n );\n}\n"],"names":["resolveTarget","target","element","presentSteps","steps","step","index","sameIndices","a","b","value","i","cssNumber","name","ACTION_CLASS","ACTIONS","TourPanel","title","description","position","total","labels","regionLabel","actionHref","linkComponent","onAction","titleId","useId","descriptionId","panelRef","useRef","actionsRef","last","primary","useEffect","onActionRef","linked","actions","onClick","event","hit","action","control","tone","text","jsx","Button","ButtonLink","jsxs","scrollParent","parent","overflowY","keepInView","panel","margin","targetRect","panelRect","top","bottom","delta","mainOf","node","defaultProgress","Tour","open","current","onChange","onClose","inline","label","strings","useStrings","mergedLabels","present","setPresent","useState","useIsomorphicLayoutEffect","next","previous","firstAtOrAfter","visible","onCloseRef","onKeyDown","returnFocusRef","geometry","useMemo","settledRef","shownIndex","onPopupAlign","popup","antdSteps","at","AntdTour"],"mappings":"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"}
|
|
@@ -96,6 +96,10 @@ export { DetailBeside } from './DetailBeside';
|
|
|
96
96
|
export type { DetailBesideColumnsProps, DetailBesidePane, DetailBesidePanesProps, DetailBesideProps, } from './DetailBeside';
|
|
97
97
|
export { PickerField } from './PickerField';
|
|
98
98
|
export { Dialog } from './Dialog';
|
|
99
|
+
export { Tour } from './Tour';
|
|
100
|
+
export type { TourAction, TourCloseReason, TourLabels, TourPlacement, TourProps, TourStep, TourTarget, } from './Tour';
|
|
101
|
+
export { useTour, useTourLauncher } from './useTour';
|
|
102
|
+
export type { TourLauncher, UseTourOptions, UseTourResult } from './useTour';
|
|
99
103
|
export { SectionDivider } from './SectionDivider';
|
|
100
104
|
export { KeyValueList } from './KeyValueList';
|
|
101
105
|
export type { KeyValueItem, KeyValueListSurface } from './KeyValueList';
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("react"),p=require("../../hooks/useStorageItem.cjs"),n=[],l=new Set;function f(){for(const e of l)e()}function y(e){return l.add(e),()=>{l.delete(e)}}function C(){return n.length>0?n[n.length-1]:null}function L(){return null}function T(e){return`aegis-ui:tour:${e}`}function k(e){return e==="finish"||e==="skip"?e:null}function m(e,u,{autoStart:a=!0}={}){const[d,i]=p.useStorageItem(T(e)),s=k(d),[S,o]=t.useState(!1),[h,c]=t.useState(0);t.useEffect(()=>{a&&s===null&&(c(0),o(!0))},[a,s]);const r=t.useCallback(()=>{c(0),o(!0)},[]);t.useEffect(()=>(n.push(r),f(),()=>{n.splice(n.lastIndexOf(r),1),f()}),[r]);const b=t.useCallback(g=>{o(!1),i(g)},[i]);return{tourProps:{open:S,steps:u,current:h,onChange:c,onClose:b},start:r,ended:s}}function E(){const e=t.useSyncExternalStore(y,C,L),u=t.useCallback(()=>{e?.()},[e]);return{available:e!==null,start:u}}exports.useTour=m;exports.useTourLauncher=E;
|
|
2
|
+
//# sourceMappingURL=useTour.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"useTour.cjs","sources":["../../../src/components/ui/useTour.ts"],"sourcesContent":["import { useCallback, useEffect, useState, useSyncExternalStore } from 'react';\n\nimport { useStorageItem } from '../../hooks/useStorageItem';\nimport type { TourCloseReason, TourProps, TourStep } from './Tour';\n\nexport interface UseTourOptions {\n /** Opens the tour on the first visit, until it is finished or skipped. Default true. */\n autoStart?: boolean;\n}\n\nexport interface UseTourResult {\n /** Spread onto `<Tour>`. */\n tourProps: TourProps;\n /** Opens the tour at its first step, whether or not it was seen. */\n start: () => void;\n /** How the tour last ended, remembered across visits; null before that. */\n ended: TourCloseReason | null;\n}\n\nexport interface TourLauncher {\n /** False while no mounted `useTour` is there to start. */\n available: boolean;\n start: () => void;\n}\n\n/** The `start` of every mounted `useTour`, most recently mounted last. */\nconst mounted: Array<() => void> = [];\nconst launcherListeners = new Set<() => void>();\n\nfunction notifyLaunchers(): void {\n for (const listener of launcherListeners) {\n listener();\n }\n}\n\nfunction subscribeLaunchers(onChange: () => void): () => void {\n launcherListeners.add(onChange);\n return () => {\n launcherListeners.delete(onChange);\n };\n}\n\nfunction latestStart(): (() => void) | null {\n return mounted.length > 0 ? mounted[mounted.length - 1] : null;\n}\n\nfunction serverStart(): null {\n return null;\n}\n\nfunction storageKey(key: string): string {\n return `aegis-ui:tour:${key}`;\n}\n\nfunction readEnded(value: string | null): TourCloseReason | null {\n return value === 'finish' || value === 'skip' ? value : null;\n}\n\n/**\n * Runs one page's tour. It opens by itself on the first visit and\n * remembers in localStorage (`aegis-ui:tour:<key>`) that it was finished\n * or skipped, so it does not open again; `start()` replays it. While\n * mounted, its `start` is what `useTourLauncher` starts, so a control in\n * the shell can replay the current page's tour.\n */\nexport function useTour(\n key: string,\n steps: readonly TourStep[],\n { autoStart = true }: UseTourOptions = {},\n): UseTourResult {\n const [stored, setStored] = useStorageItem(storageKey(key));\n const ended = readEnded(stored);\n const [open, setOpen] = useState(false);\n const [current, setCurrent] = useState(0);\n\n useEffect(() => {\n if (autoStart && ended === null) {\n setCurrent(0);\n setOpen(true);\n }\n }, [autoStart, ended]);\n\n const start = useCallback(() => {\n setCurrent(0);\n setOpen(true);\n }, []);\n\n useEffect(() => {\n mounted.push(start);\n notifyLaunchers();\n return () => {\n mounted.splice(mounted.lastIndexOf(start), 1);\n notifyLaunchers();\n };\n }, [start]);\n\n const onClose = useCallback(\n (reason: TourCloseReason) => {\n setOpen(false);\n setStored(reason);\n },\n [setStored],\n );\n\n return {\n tourProps: { open, steps, current, onChange: setCurrent, onClose },\n start,\n ended,\n };\n}\n\n/** Starts the tour of the most recently mounted `useTour`, e.g. from a shell's 引导 button. */\nexport function useTourLauncher(): TourLauncher {\n const latest = useSyncExternalStore(\n subscribeLaunchers,\n latestStart,\n serverStart,\n );\n const start = useCallback(() => {\n latest?.();\n }, [latest]);\n return { available: latest !== null, start };\n}\n"],"names":["mounted","launcherListeners","notifyLaunchers","listener","subscribeLaunchers","onChange","latestStart","serverStart","storageKey","key","readEnded","value","useTour","steps","autoStart","stored","setStored","useStorageItem","ended","open","setOpen","useState","current","setCurrent","useEffect","start","useCallback","onClose","reason","useTourLauncher","latest","useSyncExternalStore"],"mappings":"qJA0BMA,EAA6B,CAAA,EAC7BC,MAAwB,IAE9B,SAASC,GAAwB,CAC/B,UAAWC,KAAYF,EACrBE,EAAA,CAEJ,CAEA,SAASC,EAAmBC,EAAkC,CAC5D,OAAAJ,EAAkB,IAAII,CAAQ,EACvB,IAAM,CACXJ,EAAkB,OAAOI,CAAQ,CACnC,CACF,CAEA,SAASC,GAAmC,CAC1C,OAAON,EAAQ,OAAS,EAAIA,EAAQA,EAAQ,OAAS,CAAC,EAAI,IAC5D,CAEA,SAASO,GAAoB,CAC3B,OAAO,IACT,CAEA,SAASC,EAAWC,EAAqB,CACvC,MAAO,iBAAiBA,CAAG,EAC7B,CAEA,SAASC,EAAUC,EAA8C,CAC/D,OAAOA,IAAU,UAAYA,IAAU,OAASA,EAAQ,IAC1D,CASO,SAASC,EACdH,EACAI,EACA,CAAE,UAAAC,EAAY,EAAA,EAAyB,GACxB,CACf,KAAM,CAACC,EAAQC,CAAS,EAAIC,EAAAA,eAAeT,EAAWC,CAAG,CAAC,EACpDS,EAAQR,EAAUK,CAAM,EACxB,CAACI,EAAMC,CAAO,EAAIC,EAAAA,SAAS,EAAK,EAChC,CAACC,EAASC,CAAU,EAAIF,EAAAA,SAAS,CAAC,EAExCG,EAAAA,UAAU,IAAM,CACVV,GAAaI,IAAU,OACzBK,EAAW,CAAC,EACZH,EAAQ,EAAI,EAEhB,EAAG,CAACN,EAAWI,CAAK,CAAC,EAErB,MAAMO,EAAQC,EAAAA,YAAY,IAAM,CAC9BH,EAAW,CAAC,EACZH,EAAQ,EAAI,CACd,EAAG,CAAA,CAAE,EAELI,EAAAA,UAAU,KACRxB,EAAQ,KAAKyB,CAAK,EAClBvB,EAAA,EACO,IAAM,CACXF,EAAQ,OAAOA,EAAQ,YAAYyB,CAAK,EAAG,CAAC,EAC5CvB,EAAA,CACF,GACC,CAACuB,CAAK,CAAC,EAEV,MAAME,EAAUD,EAAAA,YACbE,GAA4B,CAC3BR,EAAQ,EAAK,EACbJ,EAAUY,CAAM,CAClB,EACA,CAACZ,CAAS,CAAA,EAGZ,MAAO,CACL,UAAW,CAAE,KAAAG,EAAM,MAAAN,EAAO,QAAAS,EAAS,SAAUC,EAAY,QAAAI,CAAA,EACzD,MAAAF,EACA,MAAAP,CAAA,CAEJ,CAGO,SAASW,GAAgC,CAC9C,MAAMC,EAASC,EAAAA,qBACb3B,EACAE,EACAC,CAAA,EAEIkB,EAAQC,EAAAA,YAAY,IAAM,CAC9BI,IAAA,CACF,EAAG,CAACA,CAAM,CAAC,EACX,MAAO,CAAE,UAAWA,IAAW,KAAM,MAAAL,CAAA,CACvC"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { TourCloseReason, TourProps, TourStep } from './Tour';
|
|
2
|
+
export interface UseTourOptions {
|
|
3
|
+
/** Opens the tour on the first visit, until it is finished or skipped. Default true. */
|
|
4
|
+
autoStart?: boolean;
|
|
5
|
+
}
|
|
6
|
+
export interface UseTourResult {
|
|
7
|
+
/** Spread onto `<Tour>`. */
|
|
8
|
+
tourProps: TourProps;
|
|
9
|
+
/** Opens the tour at its first step, whether or not it was seen. */
|
|
10
|
+
start: () => void;
|
|
11
|
+
/** How the tour last ended, remembered across visits; null before that. */
|
|
12
|
+
ended: TourCloseReason | null;
|
|
13
|
+
}
|
|
14
|
+
export interface TourLauncher {
|
|
15
|
+
/** False while no mounted `useTour` is there to start. */
|
|
16
|
+
available: boolean;
|
|
17
|
+
start: () => void;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Runs one page's tour. It opens by itself on the first visit and
|
|
21
|
+
* remembers in localStorage (`aegis-ui:tour:<key>`) that it was finished
|
|
22
|
+
* or skipped, so it does not open again; `start()` replays it. While
|
|
23
|
+
* mounted, its `start` is what `useTourLauncher` starts, so a control in
|
|
24
|
+
* the shell can replay the current page's tour.
|
|
25
|
+
*/
|
|
26
|
+
export declare function useTour(key: string, steps: readonly TourStep[], { autoStart }?: UseTourOptions): UseTourResult;
|
|
27
|
+
/** Starts the tour of the most recently mounted `useTour`, e.g. from a shell's 引导 button. */
|
|
28
|
+
export declare function useTourLauncher(): TourLauncher;
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import { useState as f, useEffect as d, useCallback as c, useSyncExternalStore as L } from "react";
|
|
2
|
+
import { useStorageItem as x } from "../../hooks/useStorageItem.js";
|
|
3
|
+
const e = [], l = /* @__PURE__ */ new Set();
|
|
4
|
+
function p() {
|
|
5
|
+
for (const t of l)
|
|
6
|
+
t();
|
|
7
|
+
}
|
|
8
|
+
function y(t) {
|
|
9
|
+
return l.add(t), () => {
|
|
10
|
+
l.delete(t);
|
|
11
|
+
};
|
|
12
|
+
}
|
|
13
|
+
function C() {
|
|
14
|
+
return e.length > 0 ? e[e.length - 1] : null;
|
|
15
|
+
}
|
|
16
|
+
function E() {
|
|
17
|
+
return null;
|
|
18
|
+
}
|
|
19
|
+
function k(t) {
|
|
20
|
+
return `aegis-ui:tour:${t}`;
|
|
21
|
+
}
|
|
22
|
+
function I(t) {
|
|
23
|
+
return t === "finish" || t === "skip" ? t : null;
|
|
24
|
+
}
|
|
25
|
+
function w(t, r, { autoStart: i = !0 } = {}) {
|
|
26
|
+
const [h, a] = x(k(t)), s = I(h), [S, u] = f(!1), [m, o] = f(0);
|
|
27
|
+
d(() => {
|
|
28
|
+
i && s === null && (o(0), u(!0));
|
|
29
|
+
}, [i, s]);
|
|
30
|
+
const n = c(() => {
|
|
31
|
+
o(0), u(!0);
|
|
32
|
+
}, []);
|
|
33
|
+
d(() => (e.push(n), p(), () => {
|
|
34
|
+
e.splice(e.lastIndexOf(n), 1), p();
|
|
35
|
+
}), [n]);
|
|
36
|
+
const g = c(
|
|
37
|
+
(b) => {
|
|
38
|
+
u(!1), a(b);
|
|
39
|
+
},
|
|
40
|
+
[a]
|
|
41
|
+
);
|
|
42
|
+
return {
|
|
43
|
+
tourProps: { open: S, steps: r, current: m, onChange: o, onClose: g },
|
|
44
|
+
start: n,
|
|
45
|
+
ended: s
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
function K() {
|
|
49
|
+
const t = L(
|
|
50
|
+
y,
|
|
51
|
+
C,
|
|
52
|
+
E
|
|
53
|
+
), r = c(() => {
|
|
54
|
+
t?.();
|
|
55
|
+
}, [t]);
|
|
56
|
+
return { available: t !== null, start: r };
|
|
57
|
+
}
|
|
58
|
+
export {
|
|
59
|
+
w as useTour,
|
|
60
|
+
K as useTourLauncher
|
|
61
|
+
};
|
|
62
|
+
//# sourceMappingURL=useTour.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"useTour.js","sources":["../../../src/components/ui/useTour.ts"],"sourcesContent":["import { useCallback, useEffect, useState, useSyncExternalStore } from 'react';\n\nimport { useStorageItem } from '../../hooks/useStorageItem';\nimport type { TourCloseReason, TourProps, TourStep } from './Tour';\n\nexport interface UseTourOptions {\n /** Opens the tour on the first visit, until it is finished or skipped. Default true. */\n autoStart?: boolean;\n}\n\nexport interface UseTourResult {\n /** Spread onto `<Tour>`. */\n tourProps: TourProps;\n /** Opens the tour at its first step, whether or not it was seen. */\n start: () => void;\n /** How the tour last ended, remembered across visits; null before that. */\n ended: TourCloseReason | null;\n}\n\nexport interface TourLauncher {\n /** False while no mounted `useTour` is there to start. */\n available: boolean;\n start: () => void;\n}\n\n/** The `start` of every mounted `useTour`, most recently mounted last. */\nconst mounted: Array<() => void> = [];\nconst launcherListeners = new Set<() => void>();\n\nfunction notifyLaunchers(): void {\n for (const listener of launcherListeners) {\n listener();\n }\n}\n\nfunction subscribeLaunchers(onChange: () => void): () => void {\n launcherListeners.add(onChange);\n return () => {\n launcherListeners.delete(onChange);\n };\n}\n\nfunction latestStart(): (() => void) | null {\n return mounted.length > 0 ? mounted[mounted.length - 1] : null;\n}\n\nfunction serverStart(): null {\n return null;\n}\n\nfunction storageKey(key: string): string {\n return `aegis-ui:tour:${key}`;\n}\n\nfunction readEnded(value: string | null): TourCloseReason | null {\n return value === 'finish' || value === 'skip' ? value : null;\n}\n\n/**\n * Runs one page's tour. It opens by itself on the first visit and\n * remembers in localStorage (`aegis-ui:tour:<key>`) that it was finished\n * or skipped, so it does not open again; `start()` replays it. While\n * mounted, its `start` is what `useTourLauncher` starts, so a control in\n * the shell can replay the current page's tour.\n */\nexport function useTour(\n key: string,\n steps: readonly TourStep[],\n { autoStart = true }: UseTourOptions = {},\n): UseTourResult {\n const [stored, setStored] = useStorageItem(storageKey(key));\n const ended = readEnded(stored);\n const [open, setOpen] = useState(false);\n const [current, setCurrent] = useState(0);\n\n useEffect(() => {\n if (autoStart && ended === null) {\n setCurrent(0);\n setOpen(true);\n }\n }, [autoStart, ended]);\n\n const start = useCallback(() => {\n setCurrent(0);\n setOpen(true);\n }, []);\n\n useEffect(() => {\n mounted.push(start);\n notifyLaunchers();\n return () => {\n mounted.splice(mounted.lastIndexOf(start), 1);\n notifyLaunchers();\n };\n }, [start]);\n\n const onClose = useCallback(\n (reason: TourCloseReason) => {\n setOpen(false);\n setStored(reason);\n },\n [setStored],\n );\n\n return {\n tourProps: { open, steps, current, onChange: setCurrent, onClose },\n start,\n ended,\n };\n}\n\n/** Starts the tour of the most recently mounted `useTour`, e.g. from a shell's 引导 button. */\nexport function useTourLauncher(): TourLauncher {\n const latest = useSyncExternalStore(\n subscribeLaunchers,\n latestStart,\n serverStart,\n );\n const start = useCallback(() => {\n latest?.();\n }, [latest]);\n return { available: latest !== null, start };\n}\n"],"names":["mounted","launcherListeners","notifyLaunchers","listener","subscribeLaunchers","onChange","latestStart","serverStart","storageKey","key","readEnded","value","useTour","steps","autoStart","stored","setStored","useStorageItem","ended","open","setOpen","useState","current","setCurrent","useEffect","start","useCallback","onClose","reason","useTourLauncher","latest","useSyncExternalStore"],"mappings":";;AA0BA,MAAMA,IAA6B,CAAA,GAC7BC,wBAAwB,IAAA;AAE9B,SAASC,IAAwB;AAC/B,aAAWC,KAAYF;AACrB,IAAAE,EAAA;AAEJ;AAEA,SAASC,EAAmBC,GAAkC;AAC5D,SAAAJ,EAAkB,IAAII,CAAQ,GACvB,MAAM;AACX,IAAAJ,EAAkB,OAAOI,CAAQ;AAAA,EACnC;AACF;AAEA,SAASC,IAAmC;AAC1C,SAAON,EAAQ,SAAS,IAAIA,EAAQA,EAAQ,SAAS,CAAC,IAAI;AAC5D;AAEA,SAASO,IAAoB;AAC3B,SAAO;AACT;AAEA,SAASC,EAAWC,GAAqB;AACvC,SAAO,iBAAiBA,CAAG;AAC7B;AAEA,SAASC,EAAUC,GAA8C;AAC/D,SAAOA,MAAU,YAAYA,MAAU,SAASA,IAAQ;AAC1D;AASO,SAASC,EACdH,GACAI,GACA,EAAE,WAAAC,IAAY,GAAA,IAAyB,IACxB;AACf,QAAM,CAACC,GAAQC,CAAS,IAAIC,EAAeT,EAAWC,CAAG,CAAC,GACpDS,IAAQR,EAAUK,CAAM,GACxB,CAACI,GAAMC,CAAO,IAAIC,EAAS,EAAK,GAChC,CAACC,GAASC,CAAU,IAAIF,EAAS,CAAC;AAExC,EAAAG,EAAU,MAAM;AACd,IAAIV,KAAaI,MAAU,SACzBK,EAAW,CAAC,GACZH,EAAQ,EAAI;AAAA,EAEhB,GAAG,CAACN,GAAWI,CAAK,CAAC;AAErB,QAAMO,IAAQC,EAAY,MAAM;AAC9B,IAAAH,EAAW,CAAC,GACZH,EAAQ,EAAI;AAAA,EACd,GAAG,CAAA,CAAE;AAEL,EAAAI,EAAU,OACRxB,EAAQ,KAAKyB,CAAK,GAClBvB,EAAA,GACO,MAAM;AACX,IAAAF,EAAQ,OAAOA,EAAQ,YAAYyB,CAAK,GAAG,CAAC,GAC5CvB,EAAA;AAAA,EACF,IACC,CAACuB,CAAK,CAAC;AAEV,QAAME,IAAUD;AAAA,IACd,CAACE,MAA4B;AAC3B,MAAAR,EAAQ,EAAK,GACbJ,EAAUY,CAAM;AAAA,IAClB;AAAA,IACA,CAACZ,CAAS;AAAA,EAAA;AAGZ,SAAO;AAAA,IACL,WAAW,EAAE,MAAAG,GAAM,OAAAN,GAAO,SAAAS,GAAS,UAAUC,GAAY,SAAAI,EAAA;AAAA,IACzD,OAAAF;AAAA,IACA,OAAAP;AAAA,EAAA;AAEJ;AAGO,SAASW,IAAgC;AAC9C,QAAMC,IAASC;AAAA,IACb3B;AAAA,IACAE;AAAA,IACAC;AAAA,EAAA,GAEIkB,IAAQC,EAAY,MAAM;AAC9B,IAAAI,IAAA;AAAA,EACF,GAAG,CAACA,CAAM,CAAC;AACX,SAAO,EAAE,WAAWA,MAAW,MAAM,OAAAL,EAAA;AACvC;"}
|