@wildo-ai/saas-frontend-lib 1.0.1

package/dist/esm/core/guidance/renderers/GuidanceModal.d.ts

@@ -0,0 +1,10 @@
+/**
+ * GuidanceModal — Modal overlay renderer for guidance elements.
+ *
+ * Uses the engine Dialog component for focus trapping, ESC handling,
+ * accessible overlay, and theme-compliant styling.
+ */
+import React from 'react';
+import type { GuidanceElementRendererProps } from '../../../core/guidance/GuidanceRenderer.js';
+export declare const GuidanceModal: React.FC<GuidanceElementRendererProps>;
+//# sourceMappingURL=GuidanceModal.d.ts.map

package/dist/esm/core/guidance/renderers/GuidanceModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceModal.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceModal.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAsB,MAAM,OAAO,CAAC;AAa3C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAEvG,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CA2FhE,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceModal.js

@@ -0,0 +1,43 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * GuidanceModal — Modal overlay renderer for guidance elements.
+ *
+ * Uses the engine Dialog component for focus trapping, ESC handling,
+ * accessible overlay, and theme-compliant styling.
+ */
+import { useCallback } from 'react';
+import { Dialog, DialogContent, DialogHeader, DialogFooter, DialogTitle, DialogDescription, } from '../../../components/overlays/containers/dialog.js';
+import { Button, ButtonVariants_Variant } from '../../../components/actions/button.js';
+import { ButtonSize } from '@wildo-ai/presets-components-models';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+export const GuidanceModal = ({ element, t, onAction, onDismiss, onComplete, }) => {
+    const { tComponent, isReady } = useI18n({ component: FrontendComponentType.GUIDANCE_MODAL });
+    const el = element;
+    const ctaAction = el.ctaAction;
+    const dismissible = el.dismissible ?? true;
+    const imageUrl = el.imageUrl;
+    const videoUrl = el.videoUrl;
+    const handleCta = useCallback(() => {
+        if (ctaAction) {
+            onAction(ctaAction);
+        }
+        onComplete(element.ref);
+    }, [ctaAction, onAction, onComplete, element.ref]);
+    const handleDismiss = useCallback(() => {
+        onDismiss(element.ref);
+    }, [onDismiss, element.ref]);
+    const handleOpenChange = useCallback((open) => {
+        if (!open && dismissible) {
+            onDismiss(element.ref);
+        }
+    }, [dismissible, onDismiss, element.ref]);
+    if (!isReady)
+        return null;
+    const title = t('title') ?? el.title ?? '';
+    const description = t('description') ?? el.description ?? '';
+    const content = t('content') ?? el.content ?? '';
+    const actionLabel = t('actionLabel') ?? el.ctaText ?? '';
+    return (_jsx(Dialog, { open: true, onOpenChange: handleOpenChange, children: _jsxs(DialogContent, { showCloseButton: dismissible, onPointerDownOutside: dismissible ? undefined : (e) => e.preventDefault(), onEscapeKeyDown: dismissible ? undefined : (e) => e.preventDefault(), className: "max-w-md", children: [videoUrl && (_jsx("video", { src: videoUrl, controls: true, className: "w-full max-h-60 object-cover -mt-6 -mx-6 mb-0 rounded-t-lg", style: { width: 'calc(100% + 3rem)' } })), !videoUrl && imageUrl && (_jsx("img", { src: imageUrl, alt: "", className: "w-full max-h-60 object-cover -mt-6 -mx-6 mb-0 rounded-t-lg", style: { width: 'calc(100% + 3rem)' } })), (title || description) && (_jsxs(DialogHeader, { children: [title && _jsx(DialogTitle, { children: title }), description && _jsx(DialogDescription, { children: description })] })), content && (_jsx("div", { className: "text-sm text-foreground/80 leading-relaxed", children: content })), _jsxs(DialogFooter, { children: [dismissible && (_jsx(Button, { variant: ButtonVariants_Variant.OUTLINE, size: ButtonSize.SM, onClick: handleDismiss, children: tComponent(FrontendComponentType.GUIDANCE_MODAL, 'dismiss') })), actionLabel && (_jsx(Button, { size: ButtonSize.SM, onClick: handleCta, children: actionLabel }))] })] }) }));
+};
+//# sourceMappingURL=GuidanceModal.js.map

package/dist/esm/core/guidance/renderers/GuidanceModal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceModal.js","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceModal.tsx"],"names":[],"mappings":"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"}

package/dist/esm/core/guidance/renderers/GuidanceSurvey.d.ts

@@ -0,0 +1,10 @@
+/**
+ * GuidanceSurvey — Multi-question survey form renderer.
+ *
+ * Uses engine form controls (Input, Textarea, RadioGroup, Checkbox)
+ * for theme-compliant, accessible form elements.
+ */
+import React from 'react';
+import type { GuidanceElementRendererProps } from '../../../core/guidance/GuidanceRenderer.js';
+export declare const GuidanceSurvey: React.FC<GuidanceElementRendererProps>;
+//# sourceMappingURL=GuidanceSurvey.d.ts.map

package/dist/esm/core/guidance/renderers/GuidanceSurvey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceSurvey.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceSurvey.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAgC,MAAM,OAAO,CAAC;AAgBrD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAIvG,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CAqPjE,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceSurvey.js

@@ -0,0 +1,130 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * GuidanceSurvey — Multi-question survey form renderer.
+ *
+ * Uses engine form controls (Input, Textarea, RadioGroup, Checkbox)
+ * for theme-compliant, accessible form elements.
+ */
+import React, { useState, useCallback } from 'react';
+import { z } from 'zod/v4';
+import { OnboardingSurveyQuestionType } from '@wildo-ai/saas-models';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { DisplayDirection } from '@wildo-ai/zod-decorators';
+import { Button, ButtonVariants_Variant } from '../../../components/actions/button.js';
+import { ButtonSize } from '@wildo-ai/presets-components-models';
+import { InputRoot } from '../../../components/form/controls/input.js';
+import { TextareaRoot } from '../../../components/form/controls/string/textarea.js';
+import { RadioGroup } from '../../../components/form/controls/enum/radio.js';
+import { Checkbox } from '../../../components/form/controls/boolean/checkbox.js';
+import { Card, CardHeader, CardContent, CardFooter } from '../../../components/sections/card.js';
+import { Progress } from '../../../components/feedback/progress.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+const STRING_SCHEMA = z.string();
+export const GuidanceSurvey = ({ element, flowRef, t, onComplete, }) => {
+    const guidanceKeys = React.useMemo(() => (flowRef ? [`guidance.${flowRef}`] : []), [flowRef]);
+    const { tComponent, tGuidanceSurveyQuestion, isReady } = useI18n({
+        component: FrontendComponentType.GUIDANCE_SURVEY,
+        keys: guidanceKeys,
+    });
+    const el = element;
+    const questions = el.questions ?? [];
+    const allowSkip = el.allowSkip ?? true;
+    const [currentIndex, setCurrentIndex] = useState(0);
+    const [answers, setAnswers] = useState({});
+    const [validationErrors, setValidationErrors] = useState({});
+    const currentQuestion = questions[currentIndex];
+    const isLast = currentIndex === questions.length - 1;
+    const isFirst = currentIndex === 0;
+    const total = questions.length;
+    const getQuestionText = useCallback((q) => {
+        return tGuidanceSurveyQuestion(flowRef, element.ref, q.id, 'question') ?? q.question;
+    }, [flowRef, element.ref, tGuidanceSurveyQuestion]);
+    const getOptionLabel = useCallback((q, optionRef, fallbackValue) => {
+        return tGuidanceSurveyQuestion(flowRef, element.ref, q.id, `options.${optionRef}.label`) ?? fallbackValue;
+    }, [flowRef, element.ref, tGuidanceSurveyQuestion]);
+    const setAnswer = useCallback((questionId, value) => {
+        setAnswers(prev => ({ ...prev, [questionId]: value }));
+        setValidationErrors(prev => ({ ...prev, [questionId]: false }));
+    }, []);
+    const validateCurrent = useCallback(() => {
+        if (!currentQuestion)
+            return true;
+        if (!currentQuestion.required)
+            return true;
+        const answer = answers[currentQuestion.id];
+        if (answer === undefined || answer === null || answer === '')
+            return false;
+        if (Array.isArray(answer) && answer.length === 0)
+            return false;
+        return true;
+    }, [currentQuestion, answers]);
+    const handleNext = useCallback(() => {
+        if (!validateCurrent()) {
+            if (currentQuestion) {
+                setValidationErrors(prev => ({ ...prev, [currentQuestion.id]: true }));
+            }
+            return;
+        }
+        if (isLast) {
+            onComplete(element.ref, { surveyAnswers: answers });
+        }
+        else {
+            setCurrentIndex(prev => prev + 1);
+        }
+    }, [validateCurrent, isLast, onComplete, element.ref, answers, currentQuestion]);
+    const handlePrevious = useCallback(() => {
+        if (!isFirst)
+            setCurrentIndex(prev => prev - 1);
+    }, [isFirst]);
+    const handleSkip = useCallback(() => {
+        onComplete(element.ref, { surveyAnswers: answers });
+    }, [onComplete, element.ref, answers]);
+    if (!isReady)
+        return null;
+    const renderInput = (q, answer) => {
+        switch (q.type) {
+            case OnboardingSurveyQuestionType.TEXT:
+                return (_jsx(InputRoot, { value: answer ?? '', onChange: (e) => setAnswer(q.id, e.target.value) }));
+            case OnboardingSurveyQuestionType.TEXTAREA:
+                return (_jsx(TextareaRoot, { value: answer ?? '', onChange: (e) => setAnswer(q.id, e.target.value), rows: 3 }));
+            case OnboardingSurveyQuestionType.RADIO:
+            case OnboardingSurveyQuestionType.SINGLE_CHOICE: {
+                const radioOptions = (q.options ?? []).map(opt => ({
+                    value: opt.ref,
+                    label: getOptionLabel(q, opt.ref, opt.value ?? opt.ref),
+                }));
+                return (_jsx(RadioGroup, { schema: STRING_SCHEMA, name: `survey-${q.id}`, value: answer ?? '', onValueChange: (val) => setAnswer(q.id, val), options: radioOptions, orientation: DisplayDirection.VERTICAL }));
+            }
+            case OnboardingSurveyQuestionType.CHECKBOX:
+                return (_jsx("div", { className: "flex flex-col gap-2", children: (q.options ?? []).map(opt => {
+                        const label = getOptionLabel(q, opt.ref, opt.value ?? opt.ref);
+                        const selected = Array.isArray(answer) ? answer : [];
+                        const isChecked = selected.includes(opt.ref);
+                        return (_jsxs("label", { className: "flex items-center gap-2 cursor-pointer rounded-md px-2 py-1.5 text-sm hover:bg-accent/5", children: [_jsx(Checkbox, { name: "__display", schema: z.boolean(), checked: isChecked, onCheckedChange: () => {
+                                        const next = isChecked
+                                            ? selected.filter(r => r !== opt.ref)
+                                            : [...selected, opt.ref];
+                                        setAnswer(q.id, next);
+                                    } }), _jsx("span", { children: label })] }, opt.ref));
+                    }) }));
+            case OnboardingSurveyQuestionType.RATING: {
+                const ratingValue = typeof answer === 'number' ? answer : 0;
+                return (_jsx("div", { className: "flex gap-1", role: "radiogroup", "aria-label": getQuestionText(q), children: [1, 2, 3, 4, 5].map(star => (_jsx(Button, { variant: ButtonVariants_Variant.GHOST, size: ButtonSize.ICON, onClick: () => setAnswer(q.id, star), "aria-label": tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'ratingStar', { star, total: 5 }), className: star <= ratingValue ? 'text-warning' : 'text-muted-foreground/40', children: _jsx("span", { className: "text-xl", children: "\u2605" }) }, star))) }));
+            }
+            default:
+                return null;
+        }
+    };
+    if (questions.length === 0)
+        return null;
+    const title = t('title') ?? el.title ?? '';
+    const description = t('description') ?? el.description ?? '';
+    const progressPercent = total > 0 ? Math.round(((currentIndex + 1) / total) * 100) : 0;
+    return (_jsxs(Card, { className: "pointer-events-auto", children: [(title || description) && (_jsxs(CardHeader, { children: [title && _jsx("h3", { className: "text-base font-semibold", children: title }), description && _jsx("p", { className: "text-xs text-muted-foreground", children: description })] })), _jsxs(CardContent, { className: "flex flex-col gap-4", children: [_jsxs("div", { className: "flex items-center gap-3", children: [_jsx(Progress, { value: progressPercent, className: "flex-1" }), _jsx("span", { className: "text-xs text-muted-foreground shrink-0", children: tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'questionProgress', {
+                                    current: currentIndex + 1,
+                                    total,
+                                }) })] }), currentQuestion && (_jsxs("div", { className: "flex flex-col gap-2.5", children: [_jsxs("label", { className: "text-sm font-medium", children: [getQuestionText(currentQuestion), currentQuestion.required && (_jsx("span", { className: "text-destructive ml-1", children: tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'required') }))] }), renderInput(currentQuestion, answers[currentQuestion.id]), validationErrors[currentQuestion.id] && (_jsx("span", { className: "text-xs text-destructive", children: tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'required') }))] }))] }), _jsxs(CardFooter, { className: "flex justify-between items-center", children: [_jsx("div", { children: !isFirst && (_jsx(Button, { variant: ButtonVariants_Variant.OUTLINE, size: ButtonSize.SM, onClick: handlePrevious, children: tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'previous') })) }), _jsxs("div", { className: "flex gap-2", children: [allowSkip && (_jsx(Button, { variant: ButtonVariants_Variant.GHOST, size: ButtonSize.SM, onClick: handleSkip, children: tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'skip') })), _jsx(Button, { size: ButtonSize.SM, onClick: handleNext, children: isLast
+                                    ? tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'submit')
+                                    : tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'next') })] })] })] }));
+};
+//# sourceMappingURL=GuidanceSurvey.js.map

package/dist/esm/core/guidance/renderers/GuidanceSurvey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceSurvey.js","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceSurvey.tsx"],"names":[],"mappings":"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"}

package/dist/esm/core/guidance/renderers/GuidanceTooltip.d.ts

@@ -0,0 +1,11 @@
+/**
+ * GuidanceTooltip Renderer
+ *
+ * Portal-based tooltip attached to a target element via its
+ * targetSelector. Uses theme recipes for styling, ResizeObserver
+ * for efficient target tracking, and Button for actions.
+ */
+import React from 'react';
+import type { GuidanceElementRendererProps } from '../../../core/guidance/GuidanceRenderer.js';
+export declare const GuidanceTooltip: React.FC<GuidanceElementRendererProps>;
+//# sourceMappingURL=GuidanceTooltip.d.ts.map

package/dist/esm/core/guidance/renderers/GuidanceTooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceTooltip.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceTooltip.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAC;AAUxE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAEvG,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CA0GlE,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceTooltip.js

@@ -0,0 +1,122 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * GuidanceTooltip Renderer
+ *
+ * Portal-based tooltip attached to a target element via its
+ * targetSelector. Uses theme recipes for styling, ResizeObserver
+ * for efficient target tracking, and Button for actions.
+ */
+import { useEffect, useState, useCallback, useRef } from 'react';
+import ReactDOM from 'react-dom';
+import { TourStepPlacement, OnboardingStatus } from '@wildo-ai/saas-models';
+import { FrontendComponentType, UIBehavior, SurfaceVariant } from '@wildo-ai/presets-components-models';
+import { Button, ButtonVariants_Variant } from '../../../components/actions/button.js';
+import { ButtonSize } from '@wildo-ai/presets-components-models';
+import { useUI } from '../../../core/ui/useUI.js';
+import { cn } from '../../../core/ui/cn.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+export const GuidanceTooltip = ({ element, flowRef, state, onComplete, onDismiss, t, }) => {
+    const { tComponent, isReady } = useI18n({ component: FrontendComponentType.GUIDANCE_TOOLTIP });
+    const { getRecipe } = useUI();
+    const tooltip = element;
+    const [targetRect, setTargetRect] = useState(null);
+    const hasAutoCompleted = useRef(false);
+    const observerRef = useRef(null);
+    const surfaceRecipe = getRecipe(UIBehavior.SURFACE, SurfaceVariant.RAISED);
+    useEffect(() => {
+        if (!tooltip.targetSelector)
+            return;
+        const updateRect = () => {
+            const el = document.querySelector(tooltip.targetSelector);
+            if (el) {
+                setTargetRect(el.getBoundingClientRect());
+            }
+            else {
+                setTargetRect(null);
+            }
+        };
+        updateRect();
+        const target = document.querySelector(tooltip.targetSelector);
+        if (target) {
+            observerRef.current = new ResizeObserver(updateRect);
+            observerRef.current.observe(target);
+        }
+        const handleScroll = () => updateRect();
+        const handleResize = () => updateRect();
+        window.addEventListener('resize', handleResize);
+        window.addEventListener('scroll', handleScroll, true);
+        return () => {
+            observerRef.current?.disconnect();
+            window.removeEventListener('resize', handleResize);
+            window.removeEventListener('scroll', handleScroll, true);
+        };
+    }, [tooltip.targetSelector]);
+    useEffect(() => {
+        if (tooltip.showOnce &&
+            !hasAutoCompleted.current &&
+            targetRect &&
+            state?.status !== OnboardingStatus.COMPLETED) {
+            hasAutoCompleted.current = true;
+            onComplete(tooltip.ref);
+        }
+    }, [tooltip.showOnce, tooltip.ref, targetRect, state?.status, onComplete]);
+    const handleDismiss = useCallback(() => {
+        onDismiss(tooltip.ref);
+    }, [onDismiss, tooltip.ref]);
+    const handleGotIt = useCallback(() => {
+        onComplete(tooltip.ref);
+    }, [onComplete, tooltip.ref]);
+    if (!isReady)
+        return null;
+    if (typeof document === 'undefined' || !targetRect)
+        return null;
+    const title = t('title') ?? tooltip.title ?? '';
+    const content = t('content') ?? tooltip.content ?? '';
+    const dismissLabel = tComponent(FrontendComponentType.GUIDANCE_TOOLTIP, 'dismiss');
+    const gotItLabel = tComponent(FrontendComponentType.GUIDANCE_TOOLTIP, 'gotIt');
+    const placement = tooltip.placement ?? TourStepPlacement.BOTTOM;
+    const positionStyle = computeTooltipPosition(placement, targetRect);
+    return ReactDOM.createPortal(_jsxs("div", { style: positionStyle, role: "tooltip", "data-guidance-tooltip": tooltip.ref, className: cn('w-70 max-w-[calc(100vw-2rem)] rounded-xl z-[10002] font-inherit text-sm', surfaceRecipe.base, 'shadow-[var(--shadow-lg)]'), children: [_jsxs("div", { className: "px-4 pt-3.5 pb-2", children: [title && _jsx("div", { className: "font-semibold text-sm mb-1", children: title }), content && _jsx("p", { className: "m-0 text-xs text-muted-foreground leading-normal", children: content })] }), _jsxs("div", { className: "flex justify-end gap-2 px-4 pb-3.5", children: [_jsx(Button, { variant: ButtonVariants_Variant.GHOST, size: ButtonSize.SM, onClick: handleDismiss, children: dismissLabel }), _jsx(Button, { size: ButtonSize.SM, onClick: handleGotIt, children: gotItLabel })] })] }), document.body);
+};
+function computeTooltipPosition(placement, rect) {
+    const GAP = 10;
+    switch (placement) {
+        case TourStepPlacement.TOP:
+            return {
+                position: 'fixed',
+                bottom: window.innerHeight - rect.top + GAP,
+                left: rect.left + rect.width / 2,
+                transform: 'translateX(-50%)',
+            };
+        case TourStepPlacement.BOTTOM:
+            return {
+                position: 'fixed',
+                top: rect.bottom + GAP,
+                left: rect.left + rect.width / 2,
+                transform: 'translateX(-50%)',
+            };
+        case TourStepPlacement.LEFT:
+            return {
+                position: 'fixed',
+                top: rect.top + rect.height / 2,
+                right: window.innerWidth - rect.left + GAP,
+                transform: 'translateY(-50%)',
+            };
+        case TourStepPlacement.RIGHT:
+            return {
+                position: 'fixed',
+                top: rect.top + rect.height / 2,
+                left: rect.right + GAP,
+                transform: 'translateY(-50%)',
+            };
+        case TourStepPlacement.CENTER:
+        default:
+            return {
+                position: 'fixed',
+                top: '50%',
+                left: '50%',
+                transform: 'translate(-50%, -50%)',
+            };
+    }
+}
+//# sourceMappingURL=GuidanceTooltip.js.map

package/dist/esm/core/guidance/renderers/GuidanceTooltip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceTooltip.js","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceTooltip.tsx"],"names":[],"mappings":";AAAA;;;;;;GAMG;AAEH,OAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACxE,OAAO,QAAQ,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACxG,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AAC/F,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC1D,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAGhE,MAAM,CAAC,MAAM,eAAe,GAA2C,CAAC,EACtE,OAAO,EACP,OAAO,EACP,KAAK,EACL,UAAU,EACV,SAAS,EACT,CAAC,GACF,EAAE,EAAE;IACH,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,SAAS,EAAE,qBAAqB,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC/F,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,OAAmC,CAAC;IACpD,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAiB,IAAI,CAAC,CAAC;IACnE,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IAExD,MAAM,aAAa,GAAG,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAE3E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,CAAC,cAAc;YAAE,OAAO;QAEpC,MAAM,UAAU,GAAG,GAAG,EAAE;YACtB,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAC1D,IAAI,EAAE,EAAE,CAAC;gBACP,aAAa,CAAC,EAAE,CAAC,qBAAqB,EAAE,CAAC,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,aAAa,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;QACH,CAAC,CAAC;QAEF,UAAU,EAAE,CAAC;QAEb,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC9D,IAAI,MAAM,EAAE,CAAC;YACX,WAAW,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;YACrD,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;QACxC,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAChD,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;QAEtD,OAAO,GAAG,EAAE;YACV,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;YAClC,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YACnD,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;QAC3D,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,IACE,OAAO,CAAC,QAAQ;YAChB,CAAC,gBAAgB,CAAC,OAAO;YACzB,UAAU;YACV,KAAK,EAAE,MAAM,KAAK,gBAAgB,CAAC,SAAS,EAC5C,CAAC;YACD,gBAAgB,CAAC,OAAO,GAAG,IAAI,CAAC;YAChC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAE3E,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;QACrC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7B,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAE9B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAEhE,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IAChD,MAAM,OAAO,GAAG,CAAC,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACtD,MAAM,YAAY,GAAG,UAAU,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;IACnF,MAAM,UAAU,GAAG,UAAU,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC/E,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,iBAAiB,CAAC,MAAM,CAAC;IAChE,MAAM,aAAa,GAAG,sBAAsB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAEpE,OAAO,QAAQ,CAAC,YAAY,CAC1B,eACE,KAAK,EAAE,aAAa,EACpB,IAAI,EAAC,SAAS,2BACS,OAAO,CAAC,GAAG,EAClC,SAAS,EAAE,EAAE,CACX,yEAAyE,EACzE,aAAa,CAAC,IAAI,EAClB,2BAA2B,CAC5B,aAED,eAAK,SAAS,EAAC,kBAAkB,aAC9B,KAAK,IAAI,cAAK,SAAS,EAAC,4BAA4B,YAAE,KAAK,GAAO,EAClE,OAAO,IAAI,YAAG,SAAS,EAAC,kDAAkD,YAAE,OAAO,GAAK,IACrF,EAEN,eAAK,SAAS,EAAC,oCAAoC,aACjD,KAAC,MAAM,IAAC,OAAO,EAAE,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,aAAa,YACvF,YAAY,GACN,EACT,KAAC,MAAM,IAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,WAAW,YAC9C,UAAU,GACJ,IACL,IACF,EACN,QAAQ,CAAC,IAAI,CACd,CAAC;AACJ,CAAC,CAAC;AAEF,SAAS,sBAAsB,CAC7B,SAA4B,EAC5B,IAAa;IAEb,MAAM,GAAG,GAAG,EAAE,CAAC;IAEf,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,iBAAiB,CAAC,GAAG;YACxB,OAAO;gBACL,QAAQ,EAAE,OAAO;gBACjB,MAAM,EAAE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,GAAG,GAAG;gBAC3C,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC;gBAChC,SAAS,EAAE,kBAAkB;aAC9B,CAAC;QACJ,KAAK,iBAAiB,CAAC,MAAM;YAC3B,OAAO;gBACL,QAAQ,EAAE,OAAO;gBACjB,GAAG,EAAE,IAAI,CAAC,MAAM,GAAG,GAAG;gBACtB,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC;gBAChC,SAAS,EAAE,kBAAkB;aAC9B,CAAC;QACJ,KAAK,iBAAiB,CAAC,IAAI;YACzB,OAAO;gBACL,QAAQ,EAAE,OAAO;gBACjB,GAAG,EAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;gBAC/B,KAAK,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG;gBAC1C,SAAS,EAAE,kBAAkB;aAC9B,CAAC;QACJ,KAAK,iBAAiB,CAAC,KAAK;YAC1B,OAAO;gBACL,QAAQ,EAAE,OAAO;gBACjB,GAAG,EAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;gBAC/B,IAAI,EAAE,IAAI,CAAC,KAAK,GAAG,GAAG;gBACtB,SAAS,EAAE,kBAAkB;aAC9B,CAAC;QACJ,KAAK,iBAAiB,CAAC,MAAM,CAAC;QAC9B;YACE,OAAO;gBACL,QAAQ,EAAE,OAAO;gBACjB,GAAG,EAAE,KAAK;gBACV,IAAI,EAAE,KAAK;gBACX,SAAS,EAAE,uBAAuB;aACnC,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceTour.d.ts

@@ -0,0 +1,10 @@
+/**
+ * GuidanceTour Renderer
+ *
+ * Multi-step spotlight/popover overlay. Uses theme recipes for styling,
+ * ResizeObserver for efficient target tracking, and Button for navigation.
+ */
+import React from 'react';
+import type { GuidanceElementRendererProps } from '../../../core/guidance/GuidanceRenderer.js';
+export declare const GuidanceTour: React.FC<GuidanceElementRendererProps>;
+//# sourceMappingURL=GuidanceTour.d.ts.map

package/dist/esm/core/guidance/renderers/GuidanceTour.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceTour.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceTour.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAC;AAYjF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAEvG,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CAqM/D,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceTour.js

@@ -0,0 +1,165 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * GuidanceTour Renderer
+ *
+ * Multi-step spotlight/popover overlay. Uses theme recipes for styling,
+ * ResizeObserver for efficient target tracking, and Button for navigation.
+ */
+import { useState, useCallback, useEffect, useRef, useMemo } from 'react';
+import ReactDOM from 'react-dom';
+import { TourStepPlacement } from '@wildo-ai/saas-models';
+import { FrontendComponentType, UIBehavior, SurfaceVariant } from '@wildo-ai/presets-components-models';
+import { Button, ButtonVariants_Variant } from '../../../components/actions/button.js';
+import { ButtonSize } from '@wildo-ai/presets-components-models';
+import { useUI } from '../../../core/ui/useUI.js';
+import { useIconRegistry } from '../../../core/icons/useIconRegistry.js';
+import { IconSize, StandardIconReference } from '../../../core/icons/icon-registry.frontend.schemas.js';
+import { cn } from '../../../core/ui/cn.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+export const GuidanceTour = ({ element, flowRef, state, onComplete, onDismiss, t, }) => {
+    const guidanceKeys = useMemo(() => [`guidance.${flowRef}`], [flowRef]);
+    const { tComponent, tGuidanceTourStep, isReady } = useI18n({
+        component: FrontendComponentType.GUIDANCE_TOUR,
+        keys: guidanceKeys,
+    });
+    const { getRecipe } = useUI();
+    const { renderIcon } = useIconRegistry();
+    const tour = element;
+    const surfaceRecipe = getRecipe(UIBehavior.SURFACE, SurfaceVariant.OVERLAY);
+    const sortedSteps = useMemo(() => [...(tour.steps ?? [])].sort((a, b) => a.order - b.order), [tour.steps]);
+    const [currentStepIndex, setCurrentStepIndex] = useState(state?.lastStepIndex ?? 0);
+    const [targetRect, setTargetRect] = useState(null);
+    const popoverRef = useRef(null);
+    const observerRef = useRef(null);
+    const currentStep = sortedSteps[currentStepIndex];
+    const totalSteps = sortedSteps.length;
+    const isLastStep = currentStepIndex === totalSteps - 1;
+    const isFirstStep = currentStepIndex === 0;
+    useEffect(() => {
+        if (!currentStep?.targetSelector) {
+            setTargetRect(null);
+            return;
+        }
+        const updateRect = () => {
+            const el = document.querySelector(currentStep.targetSelector);
+            if (el) {
+                setTargetRect(el.getBoundingClientRect());
+            }
+            else {
+                setTargetRect(null);
+            }
+        };
+        updateRect();
+        const target = document.querySelector(currentStep.targetSelector);
+        if (target) {
+            observerRef.current = new ResizeObserver(updateRect);
+            observerRef.current.observe(target);
+        }
+        const handleScroll = () => updateRect();
+        const handleResize = () => updateRect();
+        window.addEventListener('resize', handleResize);
+        window.addEventListener('scroll', handleScroll, true);
+        return () => {
+            observerRef.current?.disconnect();
+            window.removeEventListener('resize', handleResize);
+            window.removeEventListener('scroll', handleScroll, true);
+        };
+    }, [currentStep?.targetSelector]);
+    const handleNext = useCallback(() => {
+        if (isLastStep) {
+            onComplete(tour.ref, { lastStepIndex: currentStepIndex });
+        }
+        else {
+            setCurrentStepIndex(prev => prev + 1);
+        }
+    }, [isLastStep, onComplete, tour.ref, currentStepIndex]);
+    const handlePrev = useCallback(() => {
+        if (!isFirstStep) {
+            setCurrentStepIndex(prev => prev - 1);
+        }
+    }, [isFirstStep]);
+    const handleSkip = useCallback(() => {
+        onDismiss(tour.ref);
+    }, [onDismiss, tour.ref]);
+    useEffect(() => {
+        const handleKeyDown = (e) => {
+            if (e.key === 'Escape') {
+                handleSkip();
+            }
+        };
+        window.addEventListener('keydown', handleKeyDown);
+        return () => window.removeEventListener('keydown', handleKeyDown);
+    }, [handleSkip]);
+    if (!isReady)
+        return null;
+    const nextLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'next');
+    const prevLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'previous');
+    const skipLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'skip');
+    const finishLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'finish');
+    const closeLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'close');
+    const stepProgress = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'stepProgress', {
+        current: currentStepIndex + 1,
+        total: totalSteps,
+    });
+    const stepTitle = currentStep
+        ? tGuidanceTourStep(flowRef, tour.ref, currentStep.ref, 'title') ?? currentStep.title ?? ''
+        : '';
+    const stepDescription = currentStep
+        ? tGuidanceTourStep(flowRef, tour.ref, currentStep.ref, 'description') ?? currentStep.description ?? ''
+        : '';
+    if (!currentStep || typeof document === 'undefined')
+        return null;
+    const placement = currentStep.placement ?? TourStepPlacement.BOTTOM;
+    const popoverStyle = computePopoverPosition(placement, targetRect);
+    return ReactDOM.createPortal(_jsxs("div", { className: "fixed inset-0 z-[10001] pointer-events-auto", "data-guidance-tour": tour.ref, children: [targetRect && (_jsxs("svg", { className: "fixed inset-0 w-full h-full pointer-events-none", xmlns: "http://www.w3.org/2000/svg", children: [_jsx("defs", { children: _jsxs("mask", { id: `spotlight-${tour.ref}`, children: [_jsx("rect", { x: "0", y: "0", width: "100%", height: "100%", fill: "white" }), _jsx("rect", { x: targetRect.left - 4, y: targetRect.top - 4, width: targetRect.width + 8, height: targetRect.height + 8, rx: "8", fill: "black" })] }) }), _jsx("rect", { x: "0", y: "0", width: "100%", height: "100%", className: "fill-black/50", mask: `url(#spotlight-${tour.ref})` })] })), _jsxs("div", { ref: popoverRef, style: popoverStyle, role: "dialog", "aria-label": stepTitle, className: cn('w-[340px] max-w-[calc(100vw-2rem)] rounded-xl overflow-hidden font-inherit text-sm pointer-events-auto', surfaceRecipe.base, 'shadow-[var(--shadow-xl)]'), children: [_jsx(Button, { variant: ButtonVariants_Variant.GHOST, size: ButtonSize.ICON_SM, onClick: handleSkip, "aria-label": closeLabel, className: "absolute top-2 end-2 z-[1]", children: renderIcon(StandardIconReference.CLOSE, { size: IconSize.SM }) }), _jsxs("div", { className: "px-5 pt-5 pb-3", children: [stepTitle && _jsx("h3", { className: "m-0 text-base font-semibold leading-tight pe-6", children: stepTitle }), stepDescription && _jsx("p", { className: "mt-2 text-xs text-muted-foreground leading-normal", children: stepDescription })] }), _jsxs("div", { className: "flex items-center justify-between px-5 pb-4", children: [_jsx("span", { className: "text-xs text-muted-foreground", children: stepProgress }), _jsxs("div", { className: "flex items-center gap-2", children: [tour.allowSkip && (_jsx(Button, { variant: ButtonVariants_Variant.GHOST, size: ButtonSize.SM, onClick: handleSkip, children: skipLabel })), !isFirstStep && (_jsx(Button, { variant: ButtonVariants_Variant.OUTLINE, size: ButtonSize.SM, onClick: handlePrev, children: prevLabel })), _jsx(Button, { size: ButtonSize.SM, onClick: handleNext, children: isLastStep ? finishLabel : nextLabel })] })] })] })] }), document.body);
+};
+function computePopoverPosition(placement, targetRect) {
+    if (!targetRect) {
+        return {
+            position: 'fixed',
+            top: '50%',
+            left: '50%',
+            transform: 'translate(-50%, -50%)',
+        };
+    }
+    const GAP = 12;
+    switch (placement) {
+        case TourStepPlacement.TOP:
+            return {
+                position: 'fixed',
+                bottom: window.innerHeight - targetRect.top + GAP,
+                left: targetRect.left + targetRect.width / 2,
+                transform: 'translateX(-50%)',
+            };
+        case TourStepPlacement.BOTTOM:
+            return {
+                position: 'fixed',
+                top: targetRect.bottom + GAP,
+                left: targetRect.left + targetRect.width / 2,
+                transform: 'translateX(-50%)',
+            };
+        case TourStepPlacement.LEFT:
+            return {
+                position: 'fixed',
+                top: targetRect.top + targetRect.height / 2,
+                right: window.innerWidth - targetRect.left + GAP,
+                transform: 'translateY(-50%)',
+            };
+        case TourStepPlacement.RIGHT:
+            return {
+                position: 'fixed',
+                top: targetRect.top + targetRect.height / 2,
+                left: targetRect.right + GAP,
+                transform: 'translateY(-50%)',
+            };
+        case TourStepPlacement.CENTER:
+        default:
+            return {
+                position: 'fixed',
+                top: '50%',
+                left: '50%',
+                transform: 'translate(-50%, -50%)',
+            };
+    }
+}
+//# sourceMappingURL=GuidanceTour.js.map

package/dist/esm/core/guidance/renderers/GuidanceTour.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuidanceTour.js","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceTour.tsx"],"names":[],"mappings":"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"}

package/dist/esm/core/guidance/useGuidance.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Guidance Hooks
+ *
+ * Separated from GuidanceContext.tsx for React Fast Refresh compatibility.
+ */
+import { type GuidanceContextValue, type ProgressionContextSlice, type LifecycleContextSlice } from './GuidanceContext.js';
+/**
+ * Hook to access the Guidance context.
+ * Returns safe no-op defaults when called outside provider (safe for SSR/tests).
+ */
+export declare function useGuidance(): GuidanceContextValue;
+/**
+ * Hook to access the Lifecycle slice from GuidanceContext.
+ *
+ * NOTE: The hook-level useMemo here provides marginal benefit on its own because
+ * useContext already triggers a re-render on any context value change. The real
+ * isolation comes from the provider-level useMemo on `lifecycleSlice` (inside
+ * GuidanceContextProvider), which ensures the `lifecycle` reference only changes
+ * when lifecycle data actually changes. This hook-level useMemo acts as a safety
+ * net so callers receive a stable reference even if the context value object is
+ * recreated without lifecycle changes.
+ *
+ * Returns safe no-op defaults when called outside provider.
+ */
+export declare function useLifecycle(): LifecycleContextSlice;
+/**
+ * Hook to access the Progression slice from GuidanceContext.
+ *
+ * NOTE: Same isolation pattern as useLifecycle — the provider-level useMemo on
+ * `progressionSlice` is what prevents unnecessary re-renders. This hook-level
+ * useMemo is a safety net for reference stability.
+ *
+ * Returns safe no-op defaults when called outside provider.
+ */
+export declare function useProgression(): ProgressionContextSlice;
+//# sourceMappingURL=useGuidance.d.ts.map

package/dist/esm/core/guidance/useGuidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGuidance.d.ts","sourceRoot":"","sources":["../../../../src/core/guidance/useGuidance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAmB,KAAK,oBAAoB,EAAE,KAAK,uBAAuB,EAAE,KAAK,qBAAqB,EAA+D,MAAM,mBAAmB,CAAC;AAEtM;;;GAGG;AACH,wBAAgB,WAAW,IAAI,oBAAoB,CAGlD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,IAAI,qBAAqB,CAGpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,uBAAuB,CAGxD"}