npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.3 → 1.1.5 - Mend

@wildo-ai/saas-frontend-lib 1.1.3 → 1.1.5

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.

Files changed (2521) hide show

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

	@@ -1 +1 @@
1	- {"version":3,"file":"GuidanceSurvey.js","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceSurvey.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n GuidanceSurvey — Multi-question survey form renderer.\n \n Uses engine form controls (Input, Textarea, RadioGroup, Checkbox)\n * for theme-compliant, accessible form elements.\n /\n\nimport React, { useState, useCallback } from 'react';\nimport { z } from 'zod/v4';\nimport { OnboardingSurveyQuestionType } from '@wildo-ai/saas-models';\nimport type { OnboardingSurveyQuestion } from '@wildo-ai/saas-models';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { DisplayDirection } from '@wildo-ai/zod-decorators';\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { ButtonSize } from '@wildo-ai/presets-components-models';\nimport { InputRoot } from '~wildo-frontend-lib/components/form/controls/input';\nimport { TextareaRoot } from '~wildo-frontend-lib/components/form/controls/string/textarea';\nimport { RadioGroup } from '~wildo-frontend-lib/components/form/controls/enum/radio';\nimport { Checkbox } from '~wildo-frontend-lib/components/form/controls/boolean/checkbox';\nimport { Card, CardHeader, CardContent, CardFooter } from '~wildo-frontend-lib/components/sections/card';\nimport { Progress } from '~wildo-frontend-lib/components/feedback/progress';\nimport type { FieldOption } from '~wildo-frontend-lib/components/form/form-field-types';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport type { GuidanceElementRendererProps } from '~wildo-frontend-lib/core/guidance/GuidanceRenderer';\n\nconst STRING_SCHEMA = z.string();\n\nexport const GuidanceSurvey: React.FC<GuidanceElementRendererProps> = ({\n element,\n flowRef,\n t,\n onComplete,\n}) => {\n const guidanceKeys = React.useMemo(\n () => (flowRef ? [`guidance.${flowRef}`] : []),\n [flowRef],\n );\n const { tComponent, tGuidanceSurveyQuestion, isReady } = useI18n({\n component: FrontendComponentType.GUIDANCE_SURVEY,\n keys: guidanceKeys,\n });\n const el = element as Extract<typeof element, { type: 'survey' }>;\n\n const questions = el.questions ?? [];\n const allowSkip = el.allowSkip ?? true;\n\n const [currentIndex, setCurrentIndex] = useState(0);\n const [answers, setAnswers] = useState<Record<string, unknown>>({});\n const [validationErrors, setValidationErrors] = useState<Record<string, boolean>>({});\n\n const currentQuestion = questions[currentIndex] as OnboardingSurveyQuestion \| undefined;\n const isLast = currentIndex === questions.length - 1;\n const isFirst = currentIndex === 0;\n const total = questions.length;\n\n const getQuestionText = useCallback(\n (q: OnboardingSurveyQuestion): string => {\n return tGuidanceSurveyQuestion(flowRef, element.ref, q.id, 'question');\n },\n [flowRef, element.ref, tGuidanceSurveyQuestion],\n );\n\n const getOptionLabel = useCallback(\n (q: OnboardingSurveyQuestion, optionRef: string): string => {\n return tGuidanceSurveyQuestion(flowRef, element.ref, q.id, `options.${optionRef}.label`);\n },\n [flowRef, element.ref, tGuidanceSurveyQuestion],\n );\n\n const setAnswer = useCallback((questionId: string, value: unknown) => {\n setAnswers(prev => ({ ...prev, [questionId]: value }));\n setValidationErrors(prev => ({ ...prev, [questionId]: false }));\n }, []);\n\n const validateCurrent = useCallback((): boolean => {\n if (!currentQuestion) return true;\n if (!currentQuestion.required) return true;\n const answer = answers[currentQuestion.id];\n if (answer === undefined \|\| answer === null \|\| answer === '') return false;\n if (Array.isArray(answer) && answer.length === 0) return false;\n return true;\n }, [currentQuestion, answers]);\n\n const handleNext = useCallback(() => {\n if (!validateCurrent()) {\n if (currentQuestion) {\n setValidationErrors(prev => ({ ...prev, [currentQuestion.id]: true }));\n }\n return;\n }\n if (isLast) {\n onComplete(element.ref, { surveyAnswers: answers });\n } else {\n setCurrentIndex(prev => prev + 1);\n }\n }, [validateCurrent, isLast, onComplete, element.ref, answers, currentQuestion]);\n\n const handlePrevious = useCallback(() => {\n if (!isFirst) setCurrentIndex(prev => prev - 1);\n }, [isFirst]);\n\n const handleSkip = useCallback(() => {\n onComplete(element.ref, { surveyAnswers: answers });\n }, [onComplete, element.ref, answers]);\n\n if (!isReady) return null;\n\n const renderInput = (q: OnboardingSurveyQuestion, answer: unknown) => {\n switch (q.type) {\n case OnboardingSurveyQuestionType.TEXT:\n return (\n <InputRoot\n value={(answer as string) ?? ''}\n onChange={(e) => setAnswer(q.id, e.target.value)}\n />\n );\n\n case OnboardingSurveyQuestionType.TEXTAREA:\n return (\n <TextareaRoot\n value={(answer as string) ?? ''}\n onChange={(e) => setAnswer(q.id, e.target.value)}\n rows={3}\n />\n );\n\n case OnboardingSurveyQuestionType.RADIO:\n case OnboardingSurveyQuestionType.SINGLE_CHOICE: {\n const radioOptions: FieldOption<string>[] = (q.options ?? []).map(opt => ({\n value: opt.ref,\n label: getOptionLabel(q, opt.ref),\n }));\n return (\n <RadioGroup\n schema={STRING_SCHEMA}\n name={`survey-${q.id}`}\n value={(answer as string) ?? ''}\n onValueChange={(val) => setAnswer(q.id, val)}\n options={radioOptions}\n orientation={DisplayDirection.VERTICAL}\n />\n );\n }\n\n case OnboardingSurveyQuestionType.CHECKBOX:\n return (\n <div className=\"flex flex-col gap-2\">\n {(q.options ?? []).map(opt => {\n const label = getOptionLabel(q, opt.ref);\n const selected = Array.isArray(answer) ? (answer as string[]) : [];\n const isChecked = selected.includes(opt.ref);\n return (\n <label\n key={opt.ref}\n className=\"flex items-center gap-2 cursor-pointer rounded-md px-2 py-1.5 text-sm hover:bg-accent/5\"\n >\n <Checkbox\n name=\"__display\"\n schema={z.boolean()}\n checked={isChecked}\n onCheckedChange={() => {\n const next = isChecked\n ? selected.filter(r => r !== opt.ref)\n : [...selected, opt.ref];\n setAnswer(q.id, next);\n }}\n />\n <span>{label}</span>\n </label>\n );\n })}\n </div>\n );\n\n case OnboardingSurveyQuestionType.RATING: {\n const ratingValue = typeof answer === 'number' ? answer : 0;\n return (\n <div className=\"flex gap-1\" role=\"radiogroup\" aria-label={getQuestionText(q)}>\n {[1, 2, 3, 4, 5].map(star => (\n <Button\n key={star}\n variant={ButtonVariants_Variant.GHOST}\n size={ButtonSize.ICON}\n onClick={() => setAnswer(q.id, star)}\n aria-label={tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'ratingStar', { star, total: 5 })}\n className={star <= ratingValue ? 'text-warning' : 'text-muted-foreground/40'}\n >\n <span className=\"text-xl\">★</span>\n </Button>\n ))}\n </div>\n );\n }\n\n default:\n return null;\n }\n };\n\n if (questions.length === 0) return null;\n\n const title = t('title');\n const description = t('description');\n const progressPercent = total > 0 ? Math.round(((currentIndex + 1) / total) 100) : 0;\n\n return (\n <Card className=\"pointer-events-auto\">\n {(title \|\| description) && (\n <CardHeader>\n {title && <h3 className=\"text-base font-semibold\">{title}</h3>}\n {description && <p className=\"text-xs text-muted-foreground\">{description}</p>}\n </CardHeader>\n )}\n\n <CardContent className=\"flex flex-col gap-4\">\n <div className=\"flex items-center gap-3\">\n <Progress value={progressPercent} className=\"flex-1\" />\n <span className=\"text-xs text-muted-foreground shrink-0\">\n {tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'questionProgress', {\n current: currentIndex + 1,\n total,\n })}\n </span>\n </div>\n\n {currentQuestion && (\n <div className=\"flex flex-col gap-2.5\">\n <label className=\"text-sm font-medium\">\n {getQuestionText(currentQuestion)}\n {currentQuestion.required && (\n <span className=\"text-destructive ml-1\">\n {tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'required')}\n </span>\n )}\n </label>\n\n {renderInput(currentQuestion, answers[currentQuestion.id])}\n\n {validationErrors[currentQuestion.id] && (\n <span className=\"text-xs text-destructive\">\n {tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'required')}\n </span>\n )}\n </div>\n )}\n </CardContent>\n\n <CardFooter className=\"flex justify-between items-center\">\n <div>\n {!isFirst && (\n <Button variant={ButtonVariants_Variant.OUTLINE} size={ButtonSize.SM} onClick={handlePrevious}>\n {tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'previous')}\n </Button>\n )}\n </div>\n\n <div className=\"flex gap-2\">\n {allowSkip && (\n <Button variant={ButtonVariants_Variant.GHOST} size={ButtonSize.SM} onClick={handleSkip}>\n {tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'skip')}\n </Button>\n )}\n\n <Button size={ButtonSize.SM} onClick={handleNext}>\n {isLast\n ? tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'submit')\n : tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'next')}\n </Button>\n </div>\n </CardFooter>\n </Card>\n );\n};\n"]}
1	+ {"version":3,"file":"GuidanceSurvey.js","sourceRoot":"","sources":["../../../../../../src/core/guidance/renderers/GuidanceSurvey.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n GuidanceSurvey — Multi-question survey form renderer.\n \n Uses engine form controls (Input, Textarea, RadioGroup, Checkbox)\n * for theme-compliant, accessible form elements.\n /\n\nimport React, { useState, useCallback } from 'react';\nimport { z } from 'zod/v4';\nimport { OnboardingSurveyQuestionType } from '@wildo-ai/saas-models';\nimport type { OnboardingSurveyQuestion } from '@wildo-ai/saas-models';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { DisplayDirection } from '@wildo-ai/zod-decorators';\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { ButtonSize } from '@wildo-ai/presets-components-models';\nimport { InputRoot } from '~wildo-frontend-lib/components/form/controls/input';\nimport { TextareaRoot } from '~wildo-frontend-lib/components/form/controls/string/textarea';\nimport { RadioGroup } from '~wildo-frontend-lib/components/form/controls/enum/radio';\nimport { Checkbox } from '~wildo-frontend-lib/components/form/controls/boolean/checkbox';\nimport { Card, CardHeader, CardContent, CardFooter } from '~wildo-frontend-lib/components/sections/card';\nimport { Progress } from '~wildo-frontend-lib/components/feedback/progress';\nimport { Alert, AlertDescription } from '~wildo-frontend-lib/components/overlays/containers/alert';\nimport type { FieldOption } from '~wildo-frontend-lib/components/form/form-field-types';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport type { GuidanceElementRendererProps } from '~wildo-frontend-lib/core/guidance/GuidanceRenderer';\n\nconst STRING_SCHEMA = z.string();\n\nexport const GuidanceSurvey: React.FC<GuidanceElementRendererProps> = ({\n element,\n flowRef,\n t,\n onComplete,\n}) => {\n const guidanceKeys = React.useMemo(\n () => (flowRef ? [`guidance.${flowRef}`] : []),\n [flowRef],\n );\n const { tComponent, tGuidanceSurveyQuestion, isReady } = useI18n({\n component: FrontendComponentType.GUIDANCE_SURVEY,\n keys: guidanceKeys,\n });\n const el = element as Extract<typeof element, { type: 'survey' }>;\n\n const questions = el.questions ?? [];\n const allowSkip = el.allowSkip ?? true;\n\n const [currentIndex, setCurrentIndex] = useState(0);\n const [answers, setAnswers] = useState<Record<string, unknown>>({});\n const [validationErrors, setValidationErrors] = useState<Record<string, boolean>>({});\n /\n * Set when a BOUND survey's write was refused (#1372). The survey stays open with every answer\n * intact and nothing is recorded, so this is an invitation to retry, not a report of loss.\n /\n const [submissionFailed, setSubmissionFailed] = useState(false);\n\n const currentQuestion = questions[currentIndex] as OnboardingSurveyQuestion \| undefined;\n const isLast = currentIndex === questions.length - 1;\n const isFirst = currentIndex === 0;\n const total = questions.length;\n\n const getQuestionText = useCallback(\n (q: OnboardingSurveyQuestion): string => {\n return tGuidanceSurveyQuestion(flowRef, element.ref, q.id, 'question');\n },\n [flowRef, element.ref, tGuidanceSurveyQuestion],\n );\n\n const getOptionLabel = useCallback(\n (q: OnboardingSurveyQuestion, optionRef: string): string => {\n return tGuidanceSurveyQuestion(flowRef, element.ref, q.id, `options.${optionRef}.label`);\n },\n [flowRef, element.ref, tGuidanceSurveyQuestion],\n );\n\n const setAnswer = useCallback((questionId: string, value: unknown) => {\n setAnswers(prev => ({ ...prev, [questionId]: value }));\n setValidationErrors(prev => ({ ...prev, [questionId]: false }));\n }, []);\n\n const validateCurrent = useCallback((): boolean => {\n if (!currentQuestion) return true;\n if (!currentQuestion.required) return true;\n const answer = answers[currentQuestion.id];\n if (answer === undefined \|\| answer === null \|\| answer === '') return false;\n if (Array.isArray(answer) && answer.length === 0) return false;\n return true;\n }, [currentQuestion, answers]);\n\n const handleNext = useCallback(async () => {\n if (!validateCurrent()) {\n if (currentQuestion) {\n setValidationErrors(prev => ({ ...prev, [currentQuestion.id]: true }));\n }\n return;\n }\n if (isLast) {\n setSubmissionFailed(false);\n // A bound survey REJECTS when its write is refused, and records nothing — so the form must\n // stay exactly as the person left it. An unbound survey never rejects and this costs nothing.\n try {\n await onComplete(element.ref, { surveyAnswers: answers });\n } catch {\n setSubmissionFailed(true);\n }\n } else {\n setCurrentIndex(prev => prev + 1);\n }\n }, [validateCurrent, isLast, onComplete, element.ref, answers, currentQuestion]);\n\n const handlePrevious = useCallback(() => {\n if (!isFirst) setCurrentIndex(prev => prev - 1);\n }, [isFirst]);\n\n /\n * Skipping NEVER writes to the bound resource, and therefore can never fail.\n \n The alternative — skip writes whatever was answered — traps a person whose write is refused\n * inside a survey they have explicitly declined, which is a worse outcome than the partial answers\n * it would have saved. A SUBMITTED survey writes; a SKIPPED one leaves its answers as telemetry on\n * the guidance row, where they were already going anyway.\n /\n const handleSkip = useCallback(async () => {\n setSubmissionFailed(false);\n await onComplete(element.ref, { surveyAnswers: answers, declineResourceBinding: true });\n }, [onComplete, element.ref, answers]);\n\n if (!isReady) return null;\n\n const renderInput = (q: OnboardingSurveyQuestion, answer: unknown) => {\n switch (q.type) {\n case OnboardingSurveyQuestionType.TEXT:\n return (\n <InputRoot\n value={(answer as string) ?? ''}\n onChange={(e) => setAnswer(q.id, e.target.value)}\n />\n );\n\n case OnboardingSurveyQuestionType.TEXTAREA:\n return (\n <TextareaRoot\n value={(answer as string) ?? ''}\n onChange={(e) => setAnswer(q.id, e.target.value)}\n rows={3}\n />\n );\n\n case OnboardingSurveyQuestionType.RADIO:\n case OnboardingSurveyQuestionType.SINGLE_CHOICE: {\n const radioOptions: FieldOption<string>[] = (q.options ?? []).map(opt => ({\n value: opt.ref,\n label: getOptionLabel(q, opt.ref),\n }));\n return (\n <RadioGroup\n schema={STRING_SCHEMA}\n name={`survey-${q.id}`}\n value={(answer as string) ?? ''}\n onValueChange={(val) => setAnswer(q.id, val)}\n options={radioOptions}\n orientation={DisplayDirection.VERTICAL}\n />\n );\n }\n\n case OnboardingSurveyQuestionType.CHECKBOX:\n return (\n <div className=\"flex flex-col gap-2\">\n {(q.options ?? []).map(opt => {\n const label = getOptionLabel(q, opt.ref);\n const selected = Array.isArray(answer) ? (answer as string[]) : [];\n const isChecked = selected.includes(opt.ref);\n return (\n <label\n key={opt.ref}\n className=\"flex items-center gap-2 cursor-pointer rounded-md px-2 py-1.5 text-sm hover:bg-accent/5\"\n >\n <Checkbox\n name=\"__display\"\n schema={z.boolean()}\n checked={isChecked}\n onCheckedChange={() => {\n const next = isChecked\n ? selected.filter(r => r !== opt.ref)\n : [...selected, opt.ref];\n setAnswer(q.id, next);\n }}\n />\n <span>{label}</span>\n </label>\n );\n })}\n </div>\n );\n\n case OnboardingSurveyQuestionType.RATING: {\n const ratingValue = typeof answer === 'number' ? answer : 0;\n return (\n <div className=\"flex gap-1\" role=\"radiogroup\" aria-label={getQuestionText(q)}>\n {[1, 2, 3, 4, 5].map(star => (\n <Button\n key={star}\n variant={ButtonVariants_Variant.GHOST}\n size={ButtonSize.ICON}\n onClick={() => setAnswer(q.id, star)}\n aria-label={tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'ratingStar', { star, total: 5 })}\n className={star <= ratingValue ? 'text-warning' : 'text-muted-foreground/40'}\n >\n <span className=\"text-xl\">★</span>\n </Button>\n ))}\n </div>\n );\n }\n\n default:\n return null;\n }\n };\n\n if (questions.length === 0) return null;\n\n const title = t('title');\n const description = t('description');\n const progressPercent = total > 0 ? Math.round(((currentIndex + 1) / total) 100) : 0;\n\n return (\n <Card className=\"pointer-events-auto\">\n {(title \|\| description) && (\n <CardHeader>\n {title && <h3 className=\"text-base font-semibold\">{title}</h3>}\n {description && <p className=\"text-xs text-muted-foreground\">{description}</p>}\n </CardHeader>\n )}\n\n <CardContent className=\"flex flex-col gap-4\">\n <div className=\"flex items-center gap-3\">\n <Progress value={progressPercent} className=\"flex-1\" />\n <span className=\"text-xs text-muted-foreground shrink-0\">\n {tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'questionProgress', {\n current: currentIndex + 1,\n total,\n })}\n </span>\n </div>\n\n {currentQuestion && (\n <div className=\"flex flex-col gap-2.5\">\n <label className=\"text-sm font-medium\">\n {getQuestionText(currentQuestion)}\n {currentQuestion.required && (\n <span className=\"text-destructive ml-1\">\n {tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'required')}\n </span>\n )}\n </label>\n\n {renderInput(currentQuestion, answers[currentQuestion.id])}\n\n {validationErrors[currentQuestion.id] && (\n <span className=\"text-xs text-destructive\">\n {tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'required')}\n </span>\n )}\n </div>\n )}\n\n {submissionFailed && (\n <Alert variant=\"destructive\" role=\"alert\">\n <AlertDescription>\n {tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'submissionFailed')}\n </AlertDescription>\n </Alert>\n )}\n </CardContent>\n\n <CardFooter className=\"flex justify-between items-center\">\n <div>\n {!isFirst && (\n <Button variant={ButtonVariants_Variant.OUTLINE} size={ButtonSize.SM} onClick={handlePrevious}>\n {tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'previous')}\n </Button>\n )}\n </div>\n\n <div className=\"flex gap-2\">\n {allowSkip && (\n <Button variant={ButtonVariants_Variant.GHOST} size={ButtonSize.SM} onClick={handleSkip}>\n {tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'skip')}\n </Button>\n )}\n\n <Button size={ButtonSize.SM} onClick={handleNext}>\n {isLast\n ? tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'submit')\n : tComponent(FrontendComponentType.GUIDANCE_SURVEY, 'next')}\n </Button>\n </div>\n </CardFooter>\n </Card>\n );\n};\n"]}

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

	@@ -1 +1 @@
1	- {"version":3,"file":"GuidanceSurvey.labels.d.ts","sourceRoot":"","sources":["~~../../../../../~~src/core/guidance/renderers/GuidanceSurvey.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,oBAAoB,EAAE,mBAAmB,~~EAwBrD~~,CAAC"}
1	+ {"version":3,"file":"GuidanceSurvey.labels.d.ts","sourceRoot":"","sources":["../../../../../../src/core/guidance/renderers/GuidanceSurvey.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,oBAAoB,EAAE,mBAAmB,EAiCrD,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceSurvey.labels.js CHANGED Viewed

@@ -8,6 +8,14 @@ export const GuidanceSurveyLabels = [
     { ref: 'next', kind: LabelKind.BUTTON, purpose: 'Action that advances to the next survey question' },
     { ref: 'previous', kind: LabelKind.BUTTON, purpose: 'Action that returns to the previous survey question' },
     { ref: 'required', kind: LabelKind.LABEL, purpose: 'Marker indicating the current question must be answered' },
+    {
+        ref: 'submissionFailed',
+        kind: LabelKind.MESSAGE,
+        purpose: 'Shown in place of nothing happening when a survey whose answers are written to a resource could not write them, '
+            + 'e.g. "We could not save your answers. Your responses are still here — try again." The survey stays open with '
+            + 'every answer intact, so the words must invite a retry rather than report a loss: nothing the person typed has '
+            + 'been discarded, and the survey has NOT been recorded as completed.',
+    },
     {
         ref: 'questionProgress',
         kind: LabelKind.LABEL,

package/dist/esm/core/guidance/renderers/GuidanceSurvey.labels.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"GuidanceSurvey.labels.js","sourceRoot":"","sources":["~~../../../../../~~src/core/guidance/renderers/GuidanceSurvey.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE1I,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,oBAAoB,GAA0B;IACzD,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,oDAAoD,EAAE;IACxG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,iDAAiD,EAAE;IACnG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,kDAAkD,EAAE;IACpG,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,qDAAqD,EAAE;IAC3G,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,yDAAyD,EAAE;IAC9G;QACE,GAAG,EAAE,kBAAkB;QACvB,IAAI,EAAE,SAAS,CAAC,KAAK;QACrB,OAAO,EAAE,oDAAoD;QAC7D,MAAM,EAAE;YACN,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,2CAA2C,EAAE;YACxE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,yCAAyC,EAAE;SACrE;KACF;IACD;QACE,GAAG,EAAE,YAAY;QACjB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,OAAO,EAAE,iEAAiE;QAC1E,MAAM,EAAE;YACN,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,4CAA4C,EAAE;YACtE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,2CAA2C,EAAE;SACvE;KACF;CACF,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, LabelKind, type LabellingUnitaryDef, registerComponentLabels } from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const GuidanceSurveyLabels: LabellingUnitaryDef[] = [\n { ref: 'submit', kind: LabelKind.BUTTON, purpose: 'Action that submits the completed survey responses' },\n { ref: 'skip', kind: LabelKind.BUTTON, purpose: 'Action that skips the survey without submitting' },\n { ref: 'next', kind: LabelKind.BUTTON, purpose: 'Action that advances to the next survey question' },\n { ref: 'previous', kind: LabelKind.BUTTON, purpose: 'Action that returns to the previous survey question' },\n { ref: 'required', kind: LabelKind.LABEL, purpose: 'Marker indicating the current question must be answered' },\n {\n ref: 'questionProgress',\n kind: LabelKind.LABEL,\n purpose: 'Position of the current question within the survey',\n params: [\n { key: 'current', meaning: '1-based index of the question being shown' },\n { key: 'total', meaning: 'total number of questions in the survey' },\n ],\n },\n {\n ref: 'ratingStar',\n kind: LabelKind.ARIA,\n purpose: 'Screen-reader label for an individual star in a rating question',\n params: [\n { key: 'star', meaning: '1-based position of this star in the scale' },\n { key: 'total', meaning: 'total number of stars in the rating scale' },\n ],\n },\n];\nregisterComponentLabels(FrontendComponentType.GUIDANCE_SURVEY, GuidanceSurveyLabels);\n"]}
1	+ {"version":3,"file":"GuidanceSurvey.labels.js","sourceRoot":"","sources":["../../../../../../src/core/guidance/renderers/GuidanceSurvey.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE1I,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,oBAAoB,GAA0B;IACzD,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,oDAAoD,EAAE;IACxG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,iDAAiD,EAAE;IACnG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,kDAAkD,EAAE;IACpG,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,qDAAqD,EAAE;IAC3G,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,yDAAyD,EAAE;IAC9G;QACE,GAAG,EAAE,kBAAkB;QACvB,IAAI,EAAE,SAAS,CAAC,OAAO;QACvB,OAAO,EACL,kHAAkH;cAChH,+GAA+G;cAC/G,gHAAgH;cAChH,oEAAoE;KACzE;IACD;QACE,GAAG,EAAE,kBAAkB;QACvB,IAAI,EAAE,SAAS,CAAC,KAAK;QACrB,OAAO,EAAE,oDAAoD;QAC7D,MAAM,EAAE;YACN,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,2CAA2C,EAAE;YACxE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,yCAAyC,EAAE;SACrE;KACF;IACD;QACE,GAAG,EAAE,YAAY;QACjB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,OAAO,EAAE,iEAAiE;QAC1E,MAAM,EAAE;YACN,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,4CAA4C,EAAE;YACtE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,2CAA2C,EAAE;SACvE;KACF;CACF,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, LabelKind, type LabellingUnitaryDef, registerComponentLabels } from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const GuidanceSurveyLabels: LabellingUnitaryDef[] = [\n { ref: 'submit', kind: LabelKind.BUTTON, purpose: 'Action that submits the completed survey responses' },\n { ref: 'skip', kind: LabelKind.BUTTON, purpose: 'Action that skips the survey without submitting' },\n { ref: 'next', kind: LabelKind.BUTTON, purpose: 'Action that advances to the next survey question' },\n { ref: 'previous', kind: LabelKind.BUTTON, purpose: 'Action that returns to the previous survey question' },\n { ref: 'required', kind: LabelKind.LABEL, purpose: 'Marker indicating the current question must be answered' },\n {\n ref: 'submissionFailed',\n kind: LabelKind.MESSAGE,\n purpose:\n 'Shown in place of nothing happening when a survey whose answers are written to a resource could not write them, '\n + 'e.g. \"We could not save your answers. Your responses are still here — try again.\" The survey stays open with '\n + 'every answer intact, so the words must invite a retry rather than report a loss: nothing the person typed has '\n + 'been discarded, and the survey has NOT been recorded as completed.',\n },\n {\n ref: 'questionProgress',\n kind: LabelKind.LABEL,\n purpose: 'Position of the current question within the survey',\n params: [\n { key: 'current', meaning: '1-based index of the question being shown' },\n { key: 'total', meaning: 'total number of questions in the survey' },\n ],\n },\n {\n ref: 'ratingStar',\n kind: LabelKind.ARIA,\n purpose: 'Screen-reader label for an individual star in a rating question',\n params: [\n { key: 'star', meaning: '1-based position of this star in the scale' },\n { key: 'total', meaning: 'total number of stars in the rating scale' },\n ],\n },\n];\nregisterComponentLabels(FrontendComponentType.GUIDANCE_SURVEY, GuidanceSurveyLabels);\n"]}

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

	@@ -1 +1 @@
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;AAIvG,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,~~CA8GlE~~,CAAC"}
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;AAIvG,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CA2HlE,CAAC"}

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

@@ -80,7 +80,20 @@ export const GuidanceTooltip = ({ element, flowRef, state, onComplete, onDismiss
     const gotItLabel = tComponent(FrontendComponentType.GUIDANCE_TOOLTIP, 'gotIt');
     const placement = tooltip.placement ?? TourStepPlacement.BOTTOM;
     const positionStyle = computeTooltipPosition(placement, targetRect);
-    return ReactDOM.createPortal(_jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.RAISED, children: _jsxs("div", { style: positionStyle, role: "tooltip", "data-guidance-tooltip": tooltip.ref, className: cn('w-70 max-w-[calc(100vw-2rem)] rounded-xl z-[calc(var(--z-guidance)+2)] 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 })] })] }) }), portalTarget);
+    return ReactDOM.createPortal(_jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.RAISED, children: _jsxs("div", { style: positionStyle,
+            /**
+             * `role="dialog"`, not `role="tooltip"`.
+             *
+             * This container holds two BUTTONS (dismiss and acknowledge), and the `tooltip` role must
+             * not contain interactive content — assistive technology does not expose controls inside
+             * one, so the two actions this element exists to offer were unreachable. A small,
+             * non-modal dialog is what it actually is: it is anchored to a target, it can be dismissed,
+             * and it owns its own controls.
+             *
+             * Not `aria-modal`: unlike the tour it draws no scrim and does not block the page, so
+             * claiming modality would be the inverse of the defect being fixed here.
+             */
+            role: "dialog", "aria-label": title || content || undefined, "data-guidance-tooltip": tooltip.ref, className: cn('w-70 max-w-[calc(100vw-2rem)] rounded-xl z-[calc(var(--z-guidance)+2)] 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 })] })] }) }), portalTarget);
 };
 function computeTooltipPosition(placement, rect) {
     const GAP = 10;

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

	@@ -1 +1 @@
1	- {"version":3,"file":"GuidanceTooltip.js","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceTooltip.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n GuidanceTooltip Renderer\n \n Portal-based tooltip attached to a target element via its\n * targetSelector. Uses theme recipes for styling, ResizeObserver\n * for efficient target tracking, and Button for actions.\n */\n\nimport React, { useEffect, useState, useCallback, useRef } from 'react';\nimport ReactDOM from 'react-dom';\nimport type { OnboardingTooltipElement } from '@wildo-ai/saas-models';\nimport { TourStepPlacement, OnboardingStatus } from '@wildo-ai/saas-models';\nimport { FrontendComponentType, SurfaceVariant, UIBehavior } from '@wildo-ai/presets-components-models';\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { ButtonSize } from '@wildo-ai/presets-components-models';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport type { GuidanceElementRendererProps } from '~wildo-frontend-lib/core/guidance/GuidanceRenderer';\nimport { Surface } from '~wildo-frontend-lib/components/sections/surface';\nimport { usePortalContainer } from '~wildo-frontend-lib/core/app-shell/PortalContainerContext';\n\nexport const GuidanceTooltip: React.FC<GuidanceElementRendererProps> = ({\n element,\n flowRef,\n state,\n onComplete,\n onDismiss,\n t,\n}) => {\n const { tComponent, isReady } = useI18n({ component: FrontendComponentType.GUIDANCE_TOOLTIP });\n const { getRecipe } = useUI();\n const portalContainer = usePortalContainer();\n const tooltip = element as OnboardingTooltipElement;\n const [targetRect, setTargetRect] = useState<DOMRect \| null>(null);\n const hasAutoCompleted = useRef(false);\n const observerRef = useRef<ResizeObserver \| null>(null);\n\n const surfaceRecipe = getRecipe(UIBehavior.SURFACE, SurfaceVariant.RAISED);\n\n useEffect(() => {\n if (!tooltip.targetSelector) return;\n\n const updateRect = () => {\n const el = document.querySelector(tooltip.targetSelector);\n if (el) {\n setTargetRect(el.getBoundingClientRect());\n } else {\n setTargetRect(null);\n }\n };\n\n updateRect();\n\n const target = document.querySelector(tooltip.targetSelector);\n if (target) {\n observerRef.current = new ResizeObserver(updateRect);\n observerRef.current.observe(target);\n }\n\n const handleScroll = () => updateRect();\n const handleResize = () => updateRect();\n window.addEventListener('resize', handleResize);\n window.addEventListener('scroll', handleScroll, true);\n\n return () => {\n observerRef.current?.disconnect();\n window.removeEventListener('resize', handleResize);\n window.removeEventListener('scroll', handleScroll, true);\n };\n }, [tooltip.targetSelector]);\n\n useEffect(() => {\n if (\n tooltip.showOnce &&\n !hasAutoCompleted.current &&\n targetRect &&\n state?.status !== OnboardingStatus.COMPLETED\n ) {\n hasAutoCompleted.current = true;\n onComplete(tooltip.ref);\n }\n }, [tooltip.showOnce, tooltip.ref, targetRect, state?.status, onComplete]);\n\n const handleDismiss = useCallback(() => {\n onDismiss(tooltip.ref);\n }, [onDismiss, tooltip.ref]);\n\n const handleGotIt = useCallback(() => {\n onComplete(tooltip.ref);\n }, [onComplete, tooltip.ref]);\n\n if (!isReady) return null;\n if (typeof document === 'undefined' \|\| !targetRect) return null;\n const portalTarget = portalContainer ?? document.body;\n\n const title = t('title');\n const content = t('content');\n const dismissLabel = tComponent(FrontendComponentType.GUIDANCE_TOOLTIP, 'dismiss');\n const gotItLabel = tComponent(FrontendComponentType.GUIDANCE_TOOLTIP, 'gotIt');\n const placement = tooltip.placement ?? TourStepPlacement.BOTTOM;\n const positionStyle = computeTooltipPosition(placement, targetRect);\n\n return ReactDOM.createPortal(\n <Surface asChild emitPolicyVars={false} variant={SurfaceVariant.RAISED}>\n <div\n style={positionStyle}\n role=\"tooltip\"\n data-guidance-tooltip={tooltip.ref}\n className={cn(\n 'w-70 max-w-[calc(100vw-2rem)] rounded-xl z-[calc(var(--z-guidance)+2)] font-inherit text-sm',\n surfaceRecipe.base,\n 'shadow-[var(--shadow-lg)]',\n )}\n >\n <div className=\"px-4 pt-3.5 pb-2\">\n {title && <div className=\"font-semibold text-sm mb-1\">{title}</div>}\n {content && <p className=\"m-0 text-xs text-muted-foreground leading-normal\">{content}</p>}\n </div>\n\n <div className=\"flex justify-end gap-2 px-4 pb-3.5\">\n <Button variant={ButtonVariants_Variant.GHOST} size={ButtonSize.SM} onClick={handleDismiss}>\n {dismissLabel}\n </Button>\n <Button size={ButtonSize.SM} onClick={handleGotIt}>\n {gotItLabel}\n </Button>\n </div>\n </div>\n </Surface>,\n portalTarget,\n );\n};\n\nfunction computeTooltipPosition(\n placement: TourStepPlacement,\n rect: DOMRect,\n): React.CSSProperties {\n const GAP = 10;\n\n switch (placement) {\n case TourStepPlacement.TOP:\n return {\n position: 'fixed',\n bottom: window.innerHeight - rect.top + GAP,\n left: rect.left + rect.width / 2,\n transform: 'translateX(-50%)',\n };\n case TourStepPlacement.BOTTOM:\n return {\n position: 'fixed',\n top: rect.bottom + GAP,\n left: rect.left + rect.width / 2,\n transform: 'translateX(-50%)',\n };\n case TourStepPlacement.LEFT:\n return {\n position: 'fixed',\n top: rect.top + rect.height / 2,\n right: window.innerWidth - rect.left + GAP,\n transform: 'translateY(-50%)',\n };\n case TourStepPlacement.RIGHT:\n return {\n position: 'fixed',\n top: rect.top + rect.height / 2,\n left: rect.right + GAP,\n transform: 'translateY(-50%)',\n };\n case TourStepPlacement.CENTER:\n default:\n return {\n position: 'fixed',\n top: '50%',\n left: '50%',\n transform: 'translate(-50%, -50%)',\n };\n }\n}\n"]}
1	+ {"version":3,"file":"GuidanceTooltip.js","sourceRoot":"","sources":["../../../../../../src/core/guidance/renderers/GuidanceTooltip.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n GuidanceTooltip Renderer\n \n Portal-based tooltip attached to a target element via its\n * targetSelector. Uses theme recipes for styling, ResizeObserver\n * for efficient target tracking, and Button for actions.\n /\n\nimport React, { useEffect, useState, useCallback, useRef } from 'react';\nimport ReactDOM from 'react-dom';\nimport type { OnboardingTooltipElement } from '@wildo-ai/saas-models';\nimport { TourStepPlacement, OnboardingStatus } from '@wildo-ai/saas-models';\nimport { FrontendComponentType, SurfaceVariant, UIBehavior } from '@wildo-ai/presets-components-models';\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { ButtonSize } from '@wildo-ai/presets-components-models';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport type { GuidanceElementRendererProps } from '~wildo-frontend-lib/core/guidance/GuidanceRenderer';\nimport { Surface } from '~wildo-frontend-lib/components/sections/surface';\nimport { usePortalContainer } from '~wildo-frontend-lib/core/app-shell/PortalContainerContext';\n\nexport const GuidanceTooltip: React.FC<GuidanceElementRendererProps> = ({\n element,\n flowRef,\n state,\n onComplete,\n onDismiss,\n t,\n}) => {\n const { tComponent, isReady } = useI18n({ component: FrontendComponentType.GUIDANCE_TOOLTIP });\n const { getRecipe } = useUI();\n const portalContainer = usePortalContainer();\n const tooltip = element as OnboardingTooltipElement;\n const [targetRect, setTargetRect] = useState<DOMRect \| null>(null);\n const hasAutoCompleted = useRef(false);\n const observerRef = useRef<ResizeObserver \| null>(null);\n\n const surfaceRecipe = getRecipe(UIBehavior.SURFACE, SurfaceVariant.RAISED);\n\n useEffect(() => {\n if (!tooltip.targetSelector) return;\n\n const updateRect = () => {\n const el = document.querySelector(tooltip.targetSelector);\n if (el) {\n setTargetRect(el.getBoundingClientRect());\n } else {\n setTargetRect(null);\n }\n };\n\n updateRect();\n\n const target = document.querySelector(tooltip.targetSelector);\n if (target) {\n observerRef.current = new ResizeObserver(updateRect);\n observerRef.current.observe(target);\n }\n\n const handleScroll = () => updateRect();\n const handleResize = () => updateRect();\n window.addEventListener('resize', handleResize);\n window.addEventListener('scroll', handleScroll, true);\n\n return () => {\n observerRef.current?.disconnect();\n window.removeEventListener('resize', handleResize);\n window.removeEventListener('scroll', handleScroll, true);\n };\n }, [tooltip.targetSelector]);\n\n useEffect(() => {\n if (\n tooltip.showOnce &&\n !hasAutoCompleted.current &&\n targetRect &&\n state?.status !== OnboardingStatus.COMPLETED\n ) {\n hasAutoCompleted.current = true;\n onComplete(tooltip.ref);\n }\n }, [tooltip.showOnce, tooltip.ref, targetRect, state?.status, onComplete]);\n\n const handleDismiss = useCallback(() => {\n onDismiss(tooltip.ref);\n }, [onDismiss, tooltip.ref]);\n\n const handleGotIt = useCallback(() => {\n onComplete(tooltip.ref);\n }, [onComplete, tooltip.ref]);\n\n if (!isReady) return null;\n if (typeof document === 'undefined' \|\| !targetRect) return null;\n const portalTarget = portalContainer ?? document.body;\n\n const title = t('title');\n const content = t('content');\n const dismissLabel = tComponent(FrontendComponentType.GUIDANCE_TOOLTIP, 'dismiss');\n const gotItLabel = tComponent(FrontendComponentType.GUIDANCE_TOOLTIP, 'gotIt');\n const placement = tooltip.placement ?? TourStepPlacement.BOTTOM;\n const positionStyle = computeTooltipPosition(placement, targetRect);\n\n return ReactDOM.createPortal(\n <Surface asChild emitPolicyVars={false} variant={SurfaceVariant.RAISED}>\n <div\n style={positionStyle}\n /\n `role=\"dialog\"`, not `role=\"tooltip\"`.\n \n This container holds two BUTTONS (dismiss and acknowledge), and the `tooltip` role must\n * not contain interactive content — assistive technology does not expose controls inside\n * one, so the two actions this element exists to offer were unreachable. A small,\n * non-modal dialog is what it actually is: it is anchored to a target, it can be dismissed,\n * and it owns its own controls.\n \n Not `aria-modal`: unlike the tour it draws no scrim and does not block the page, so\n * claiming modality would be the inverse of the defect being fixed here.\n */\n role=\"dialog\"\n aria-label={title \|\| content \|\| undefined}\n data-guidance-tooltip={tooltip.ref}\n className={cn(\n 'w-70 max-w-[calc(100vw-2rem)] rounded-xl z-[calc(var(--z-guidance)+2)] font-inherit text-sm',\n surfaceRecipe.base,\n 'shadow-[var(--shadow-lg)]',\n )}\n >\n <div className=\"px-4 pt-3.5 pb-2\">\n {title && <div className=\"font-semibold text-sm mb-1\">{title}</div>}\n {content && <p className=\"m-0 text-xs text-muted-foreground leading-normal\">{content}</p>}\n </div>\n\n <div className=\"flex justify-end gap-2 px-4 pb-3.5\">\n <Button variant={ButtonVariants_Variant.GHOST} size={ButtonSize.SM} onClick={handleDismiss}>\n {dismissLabel}\n </Button>\n <Button size={ButtonSize.SM} onClick={handleGotIt}>\n {gotItLabel}\n </Button>\n </div>\n </div>\n </Surface>,\n portalTarget,\n );\n};\n\nfunction computeTooltipPosition(\n placement: TourStepPlacement,\n rect: DOMRect,\n): React.CSSProperties {\n const GAP = 10;\n\n switch (placement) {\n case TourStepPlacement.TOP:\n return {\n position: 'fixed',\n bottom: window.innerHeight - rect.top + GAP,\n left: rect.left + rect.width / 2,\n transform: 'translateX(-50%)',\n };\n case TourStepPlacement.BOTTOM:\n return {\n position: 'fixed',\n top: rect.bottom + GAP,\n left: rect.left + rect.width / 2,\n transform: 'translateX(-50%)',\n };\n case TourStepPlacement.LEFT:\n return {\n position: 'fixed',\n top: rect.top + rect.height / 2,\n right: window.innerWidth - rect.left + GAP,\n transform: 'translateY(-50%)',\n };\n case TourStepPlacement.RIGHT:\n return {\n position: 'fixed',\n top: rect.top + rect.height / 2,\n left: rect.right + GAP,\n transform: 'translateY(-50%)',\n };\n case TourStepPlacement.CENTER:\n default:\n return {\n position: 'fixed',\n top: '50%',\n left: '50%',\n transform: 'translate(-50%, -50%)',\n };\n }\n}\n"]}

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

	@@ -1 +1 @@
1	- {"version":3,"file":"GuidanceTooltip.labels.d.ts","sourceRoot":"","sources":["~~../../../../../~~src/core/guidance/renderers/GuidanceTooltip.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,qBAAqB,EAAE,mBAAmB,EAGtD,CAAC"}
1	+ {"version":3,"file":"GuidanceTooltip.labels.d.ts","sourceRoot":"","sources":["../../../../../../src/core/guidance/renderers/GuidanceTooltip.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,qBAAqB,EAAE,mBAAmB,EAGtD,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceTooltip.labels.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"GuidanceTooltip.labels.js","sourceRoot":"","sources":["~~../../../../../~~src/core/guidance/renderers/GuidanceTooltip.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE1I,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,qBAAqB,GAA0B;IAC1D,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,+DAA+D,EAAE;IACpH,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,oDAAoD,EAAE;CACxG,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, LabelKind, type LabellingUnitaryDef, registerComponentLabels } from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const GuidanceTooltipLabels: LabellingUnitaryDef[] = [\n { ref: 'dismiss', kind: LabelKind.BUTTON, purpose: 'Action that closes the guidance tooltip without acknowledging' },\n { ref: 'gotIt', kind: LabelKind.BUTTON, purpose: 'Confirmation action acknowledging the tooltip hint' },\n];\nregisterComponentLabels(FrontendComponentType.GUIDANCE_TOOLTIP, GuidanceTooltipLabels);\n"]}
1	+ {"version":3,"file":"GuidanceTooltip.labels.js","sourceRoot":"","sources":["../../../../../../src/core/guidance/renderers/GuidanceTooltip.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE1I,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,qBAAqB,GAA0B;IAC1D,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,+DAA+D,EAAE;IACpH,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,oDAAoD,EAAE;CACxG,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, LabelKind, type LabellingUnitaryDef, registerComponentLabels } from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const GuidanceTooltipLabels: LabellingUnitaryDef[] = [\n { ref: 'dismiss', kind: LabelKind.BUTTON, purpose: 'Action that closes the guidance tooltip without acknowledging' },\n { ref: 'gotIt', kind: LabelKind.BUTTON, purpose: 'Confirmation action acknowledging the tooltip hint' },\n];\nregisterComponentLabels(FrontendComponentType.GUIDANCE_TOOLTIP, GuidanceTooltipLabels);\n"]}

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

	@@ -1 +1 @@
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;AAIvG,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,~~CAyM~~/D,CAAC"}
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;AAajF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAIvG,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CAkO/D,CAAC"}

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

@@ -15,6 +15,7 @@ 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 { useSurfaceFocusTrap } from '../../../core/ui/surface-a11y.utils.js';
 import { useI18n } from '../../../core/i18n/useI18n.js';
 import { Surface } from '../../../components/sections/surface.js';
 import { usePortalContainer } from '../../../core/app-shell/PortalContainerContext.js';
@@ -84,15 +85,37 @@ export const GuidanceTour = ({ element, flowRef, state, onComplete, onDismiss, t
     const handleSkip = useCallback(() => {
         onDismiss(tour.ref);
     }, [onDismiss, tour.ref]);
+    /**
+     * Escape closes the tour, bound to the POPOVER rather than the window.
+     *
+     * It listened on `window` for as long as the tour was mounted, so an Escape meant for anything
+     * else — dismissing a native autocomplete, clearing a search input, closing an unrelated
+     * popover — cancelled the tour instead. The tour is modal (it draws a scrim and now traps
+     * focus), so the popover is where the keystroke belongs: focus cannot be outside it.
+     */
     useEffect(() => {
+        const popover = popoverRef.current;
+        if (!popover)
+            return undefined;
         const handleKeyDown = (e) => {
             if (e.key === 'Escape') {
+                e.stopPropagation();
                 handleSkip();
             }
         };
-        window.addEventListener('keydown', handleKeyDown);
-        return () => window.removeEventListener('keydown', handleKeyDown);
+        popover.addEventListener('keydown', handleKeyDown);
+        return () => popover.removeEventListener('keydown', handleKeyDown);
     }, [handleSkip]);
+    /**
+     * The tour DRAWS a scrim over the page, so it is modal in fact; it simply never said so or acted
+     * on it. `role="dialog"` with no `aria-modal`, no initial focus and no containment told assistive
+     * technology nothing while letting a keyboard user tab straight behind the scrim into controls
+     * they could see were dimmed.
+     *
+     * Reuses the engine's existing trap rather than adding a second one — it already handles initial
+     * focus, Tab cycling and restoring focus to whatever was focused before.
+     */
+    useSurfaceFocusTrap(popoverRef, true);
     if (!isReady)
         return null;
     const nextLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'next');
@@ -115,7 +138,7 @@ export const GuidanceTour = ({ element, flowRef, state, onComplete, onDismiss, t
     const placement = currentStep.placement ?? TourStepPlacement.BOTTOM;
     const popoverStyle = computePopoverPosition(placement, targetRect);
     const portalTarget = portalContainer ?? document.body;
-    return ReactDOM.createPortal(_jsxs("div", { className: "fixed inset-0 z-[calc(var(--z-guidance)+1)] 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})` })] })), _jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.OVERLAY, children: _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-[calc(var(--z-guidance)+2)]", 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 })] })] })] }) })] }), portalTarget);
+    return ReactDOM.createPortal(_jsxs("div", { className: "fixed inset-0 z-[calc(var(--z-guidance)+1)] 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})` })] })), _jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.OVERLAY, children: _jsxs("div", { ref: popoverRef, style: popoverStyle, role: "dialog", "aria-modal": "true", tabIndex: -1, "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-[calc(var(--z-guidance)+2)]", 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 })] })] })] }) })] }), portalTarget);
 };
 function computePopoverPosition(placement, targetRect) {
     if (!targetRect) {

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

	@@ -1 +1 @@
1	- {"version":3,"file":"GuidanceTour.js","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceTour.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n GuidanceTour Renderer\n \n Multi-step spotlight/popover overlay. Uses theme recipes for styling,\n * ResizeObserver for efficient target tracking, and Button for navigation.\n */\n\nimport React, { useState, useCallback, useEffect, useRef, useMemo } from 'react';\nimport ReactDOM from 'react-dom';\nimport type { OnboardingTourElement, OnboardingTourStep } from '@wildo-ai/saas-models';\nimport { TourStepPlacement } from '@wildo-ai/saas-models';\nimport { FrontendComponentType, SurfaceVariant, UIBehavior } from '@wildo-ai/presets-components-models';\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { ButtonSize } from '@wildo-ai/presets-components-models';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { useIconRegistry } from '~wildo-frontend-lib/core/icons/useIconRegistry';\nimport { IconSize, StandardIconReference } from '~wildo-frontend-lib/core/icons/icon-registry.frontend.schemas';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport type { GuidanceElementRendererProps } from '~wildo-frontend-lib/core/guidance/GuidanceRenderer';\nimport { Surface } from '~wildo-frontend-lib/components/sections/surface';\nimport { usePortalContainer } from '~wildo-frontend-lib/core/app-shell/PortalContainerContext';\n\nexport const GuidanceTour: React.FC<GuidanceElementRendererProps> = ({\n element,\n flowRef,\n state,\n onComplete,\n onDismiss,\n t,\n}) => {\n const guidanceKeys = useMemo(() => [`guidance.${flowRef}`], [flowRef]);\n const { tComponent, tGuidanceTourStep, isReady } = useI18n({\n component: FrontendComponentType.GUIDANCE_TOUR,\n keys: guidanceKeys,\n });\n const { getRecipe } = useUI();\n const { renderIcon } = useIconRegistry();\n const portalContainer = usePortalContainer();\n const tour = element as OnboardingTourElement;\n\n const surfaceRecipe = getRecipe(UIBehavior.SURFACE, SurfaceVariant.OVERLAY);\n\n const sortedSteps = useMemo(\n () => [...(tour.steps ?? [])].sort((a, b) => a.order - b.order),\n [tour.steps],\n );\n\n const [currentStepIndex, setCurrentStepIndex] = useState(state?.lastStepIndex ?? 0);\n const [targetRect, setTargetRect] = useState<DOMRect \| null>(null);\n const popoverRef = useRef<HTMLDivElement>(null);\n const observerRef = useRef<ResizeObserver \| null>(null);\n\n const currentStep: OnboardingTourStep \| undefined = sortedSteps[currentStepIndex];\n const totalSteps = sortedSteps.length;\n const isLastStep = currentStepIndex === totalSteps - 1;\n const isFirstStep = currentStepIndex === 0;\n\n useEffect(() => {\n if (!currentStep?.targetSelector) {\n setTargetRect(null);\n return;\n }\n\n const updateRect = () => {\n const el = document.querySelector(currentStep.targetSelector!);\n if (el) {\n setTargetRect(el.getBoundingClientRect());\n } else {\n setTargetRect(null);\n }\n };\n\n updateRect();\n\n const target = document.querySelector(currentStep.targetSelector!);\n if (target) {\n observerRef.current = new ResizeObserver(updateRect);\n observerRef.current.observe(target);\n }\n\n const handleScroll = () => updateRect();\n const handleResize = () => updateRect();\n window.addEventListener('resize', handleResize);\n window.addEventListener('scroll', handleScroll, true);\n\n return () => {\n observerRef.current?.disconnect();\n window.removeEventListener('resize', handleResize);\n window.removeEventListener('scroll', handleScroll, true);\n };\n }, [currentStep?.targetSelector]);\n\n const handleNext = useCallback(() => {\n if (isLastStep) {\n onComplete(tour.ref, { lastStepIndex: currentStepIndex });\n } else {\n setCurrentStepIndex(prev => prev + 1);\n }\n }, [isLastStep, onComplete, tour.ref, currentStepIndex]);\n\n const handlePrev = useCallback(() => {\n if (!isFirstStep) {\n setCurrentStepIndex(prev => prev - 1);\n }\n }, [isFirstStep]);\n\n const handleSkip = useCallback(() => {\n onDismiss(tour.ref);\n }, [onDismiss, tour.ref]);\n\n useEffect(() => {\n const handleKeyDown = (e: KeyboardEvent) => {\n if (e.key === 'Escape') {\n handleSkip();\n }\n };\n window.addEventListener('keydown', handleKeyDown);\n return () => window.removeEventListener('keydown', handleKeyDown);\n }, [handleSkip]);\n\n if (!isReady) return null;\n\n const nextLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'next');\n const prevLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'previous');\n const skipLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'skip');\n const finishLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'finish');\n const closeLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'close');\n const stepProgress = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'stepProgress', {\n current: currentStepIndex + 1,\n total: totalSteps,\n });\n\n const stepTitle = currentStep\n ? tGuidanceTourStep(flowRef, tour.ref, currentStep.ref, 'title')\n : '';\n const stepDescription = currentStep\n ? tGuidanceTourStep(flowRef, tour.ref, currentStep.ref, 'description')\n : '';\n\n if (!currentStep \|\| typeof document === 'undefined') return null;\n\n const placement = currentStep.placement ?? TourStepPlacement.BOTTOM;\n const popoverStyle = computePopoverPosition(placement, targetRect);\n const portalTarget = portalContainer ?? document.body;\n\n return ReactDOM.createPortal(\n <div className=\"fixed inset-0 z-[calc(var(--z-guidance)+1)] pointer-events-auto\" data-guidance-tour={tour.ref}>\n {targetRect && (\n <svg className=\"fixed inset-0 w-full h-full pointer-events-none\" xmlns=\"http://www.w3.org/2000/svg\">\n <defs>\n <mask id={`spotlight-${tour.ref}`}>\n <rect x=\"0\" y=\"0\" width=\"100%\" height=\"100%\" fill=\"white\" />\n <rect\n x={targetRect.left - 4}\n y={targetRect.top - 4}\n width={targetRect.width + 8}\n height={targetRect.height + 8}\n rx=\"8\"\n fill=\"black\"\n />\n </mask>\n </defs>\n <rect\n x=\"0\"\n y=\"0\"\n width=\"100%\"\n height=\"100%\"\n className=\"fill-black/50\"\n mask={`url(#spotlight-${tour.ref})`}\n />\n </svg>\n )}\n\n <Surface asChild emitPolicyVars={false} variant={SurfaceVariant.OVERLAY}>\n <div\n ref={popoverRef}\n style={popoverStyle}\n role=\"dialog\"\n aria-label={stepTitle}\n className={cn(\n 'w-[340px] max-w-[calc(100vw-2rem)] rounded-xl overflow-hidden font-inherit text-sm pointer-events-auto',\n surfaceRecipe.base,\n 'shadow-[var(--shadow-xl)]',\n )}\n >\n <Button\n variant={ButtonVariants_Variant.GHOST}\n size={ButtonSize.ICON_SM}\n onClick={handleSkip}\n aria-label={closeLabel}\n className=\"absolute top-2 end-2 z-[calc(var(--z-guidance)+2)]\"\n >\n {renderIcon(StandardIconReference.CLOSE, { size: IconSize.SM })}\n </Button>\n\n <div className=\"px-5 pt-5 pb-3\">\n {stepTitle && <h3 className=\"m-0 text-base font-semibold leading-tight pe-6\">{stepTitle}</h3>}\n {stepDescription && <p className=\"mt-2 text-xs text-muted-foreground leading-normal\">{stepDescription}</p>}\n </div>\n\n <div className=\"flex items-center justify-between px-5 pb-4\">\n <span className=\"text-xs text-muted-foreground\">{stepProgress}</span>\n <div className=\"flex items-center gap-2\">\n {tour.allowSkip && (\n <Button variant={ButtonVariants_Variant.GHOST} size={ButtonSize.SM} onClick={handleSkip}>\n {skipLabel}\n </Button>\n )}\n {!isFirstStep && (\n <Button variant={ButtonVariants_Variant.OUTLINE} size={ButtonSize.SM} onClick={handlePrev}>\n {prevLabel}\n </Button>\n )}\n <Button size={ButtonSize.SM} onClick={handleNext}>\n {isLastStep ? finishLabel : nextLabel}\n </Button>\n </div>\n </div>\n </div>\n </Surface>\n </div>,\n portalTarget,\n );\n};\n\nfunction computePopoverPosition(\n placement: TourStepPlacement,\n targetRect: DOMRect \| null,\n): React.CSSProperties {\n if (!targetRect) {\n return {\n position: 'fixed',\n top: '50%',\n left: '50%',\n transform: 'translate(-50%, -50%)',\n };\n }\n\n const GAP = 12;\n switch (placement) {\n case TourStepPlacement.TOP:\n return {\n position: 'fixed',\n bottom: window.innerHeight - targetRect.top + GAP,\n left: targetRect.left + targetRect.width / 2,\n transform: 'translateX(-50%)',\n };\n case TourStepPlacement.BOTTOM:\n return {\n position: 'fixed',\n top: targetRect.bottom + GAP,\n left: targetRect.left + targetRect.width / 2,\n transform: 'translateX(-50%)',\n };\n case TourStepPlacement.LEFT:\n return {\n position: 'fixed',\n top: targetRect.top + targetRect.height / 2,\n right: window.innerWidth - targetRect.left + GAP,\n transform: 'translateY(-50%)',\n };\n case TourStepPlacement.RIGHT:\n return {\n position: 'fixed',\n top: targetRect.top + targetRect.height / 2,\n left: targetRect.right + GAP,\n transform: 'translateY(-50%)',\n };\n case TourStepPlacement.CENTER:\n default:\n return {\n position: 'fixed',\n top: '50%',\n left: '50%',\n transform: 'translate(-50%, -50%)',\n };\n }\n}\n"]}
1	+ {"version":3,"file":"GuidanceTour.js","sourceRoot":"","sources":["../../../../../../src/core/guidance/renderers/GuidanceTour.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n GuidanceTour Renderer\n \n Multi-step spotlight/popover overlay. Uses theme recipes for styling,\n * ResizeObserver for efficient target tracking, and Button for navigation.\n /\n\nimport React, { useState, useCallback, useEffect, useRef, useMemo } from 'react';\nimport ReactDOM from 'react-dom';\nimport type { OnboardingTourElement, OnboardingTourStep } from '@wildo-ai/saas-models';\nimport { TourStepPlacement } from '@wildo-ai/saas-models';\nimport { FrontendComponentType, SurfaceVariant, UIBehavior } from '@wildo-ai/presets-components-models';\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { ButtonSize } from '@wildo-ai/presets-components-models';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { useIconRegistry } from '~wildo-frontend-lib/core/icons/useIconRegistry';\nimport { IconSize, StandardIconReference } from '~wildo-frontend-lib/core/icons/icon-registry.frontend.schemas';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { useSurfaceFocusTrap } from '~wildo-frontend-lib/core/ui/surface-a11y.utils';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport type { GuidanceElementRendererProps } from '~wildo-frontend-lib/core/guidance/GuidanceRenderer';\nimport { Surface } from '~wildo-frontend-lib/components/sections/surface';\nimport { usePortalContainer } from '~wildo-frontend-lib/core/app-shell/PortalContainerContext';\n\nexport const GuidanceTour: React.FC<GuidanceElementRendererProps> = ({\n element,\n flowRef,\n state,\n onComplete,\n onDismiss,\n t,\n}) => {\n const guidanceKeys = useMemo(() => [`guidance.${flowRef}`], [flowRef]);\n const { tComponent, tGuidanceTourStep, isReady } = useI18n({\n component: FrontendComponentType.GUIDANCE_TOUR,\n keys: guidanceKeys,\n });\n const { getRecipe } = useUI();\n const { renderIcon } = useIconRegistry();\n const portalContainer = usePortalContainer();\n const tour = element as OnboardingTourElement;\n\n const surfaceRecipe = getRecipe(UIBehavior.SURFACE, SurfaceVariant.OVERLAY);\n\n const sortedSteps = useMemo(\n () => [...(tour.steps ?? [])].sort((a, b) => a.order - b.order),\n [tour.steps],\n );\n\n const [currentStepIndex, setCurrentStepIndex] = useState(state?.lastStepIndex ?? 0);\n const [targetRect, setTargetRect] = useState<DOMRect \| null>(null);\n const popoverRef = useRef<HTMLDivElement>(null);\n const observerRef = useRef<ResizeObserver \| null>(null);\n\n const currentStep: OnboardingTourStep \| undefined = sortedSteps[currentStepIndex];\n const totalSteps = sortedSteps.length;\n const isLastStep = currentStepIndex === totalSteps - 1;\n const isFirstStep = currentStepIndex === 0;\n\n useEffect(() => {\n if (!currentStep?.targetSelector) {\n setTargetRect(null);\n return;\n }\n\n const updateRect = () => {\n const el = document.querySelector(currentStep.targetSelector!);\n if (el) {\n setTargetRect(el.getBoundingClientRect());\n } else {\n setTargetRect(null);\n }\n };\n\n updateRect();\n\n const target = document.querySelector(currentStep.targetSelector!);\n if (target) {\n observerRef.current = new ResizeObserver(updateRect);\n observerRef.current.observe(target);\n }\n\n const handleScroll = () => updateRect();\n const handleResize = () => updateRect();\n window.addEventListener('resize', handleResize);\n window.addEventListener('scroll', handleScroll, true);\n\n return () => {\n observerRef.current?.disconnect();\n window.removeEventListener('resize', handleResize);\n window.removeEventListener('scroll', handleScroll, true);\n };\n }, [currentStep?.targetSelector]);\n\n const handleNext = useCallback(() => {\n if (isLastStep) {\n onComplete(tour.ref, { lastStepIndex: currentStepIndex });\n } else {\n setCurrentStepIndex(prev => prev + 1);\n }\n }, [isLastStep, onComplete, tour.ref, currentStepIndex]);\n\n const handlePrev = useCallback(() => {\n if (!isFirstStep) {\n setCurrentStepIndex(prev => prev - 1);\n }\n }, [isFirstStep]);\n\n const handleSkip = useCallback(() => {\n onDismiss(tour.ref);\n }, [onDismiss, tour.ref]);\n\n /\n Escape closes the tour, bound to the POPOVER rather than the window.\n \n It listened on `window` for as long as the tour was mounted, so an Escape meant for anything\n * else — dismissing a native autocomplete, clearing a search input, closing an unrelated\n * popover — cancelled the tour instead. The tour is modal (it draws a scrim and now traps\n * focus), so the popover is where the keystroke belongs: focus cannot be outside it.\n /\n useEffect(() => {\n const popover = popoverRef.current;\n if (!popover) return undefined;\n\n const handleKeyDown = (e: KeyboardEvent) => {\n if (e.key === 'Escape') {\n e.stopPropagation();\n handleSkip();\n }\n };\n popover.addEventListener('keydown', handleKeyDown);\n return () => popover.removeEventListener('keydown', handleKeyDown);\n }, [handleSkip]);\n\n /\n The tour DRAWS a scrim over the page, so it is modal in fact; it simply never said so or acted\n * on it. `role=\"dialog\"` with no `aria-modal`, no initial focus and no containment told assistive\n * technology nothing while letting a keyboard user tab straight behind the scrim into controls\n * they could see were dimmed.\n \n Reuses the engine's existing trap rather than adding a second one — it already handles initial\n * focus, Tab cycling and restoring focus to whatever was focused before.\n */\n useSurfaceFocusTrap(popoverRef, true);\n\n if (!isReady) return null;\n\n const nextLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'next');\n const prevLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'previous');\n const skipLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'skip');\n const finishLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'finish');\n const closeLabel = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'close');\n const stepProgress = tComponent(FrontendComponentType.GUIDANCE_TOUR, 'stepProgress', {\n current: currentStepIndex + 1,\n total: totalSteps,\n });\n\n const stepTitle = currentStep\n ? tGuidanceTourStep(flowRef, tour.ref, currentStep.ref, 'title')\n : '';\n const stepDescription = currentStep\n ? tGuidanceTourStep(flowRef, tour.ref, currentStep.ref, 'description')\n : '';\n\n if (!currentStep \|\| typeof document === 'undefined') return null;\n\n const placement = currentStep.placement ?? TourStepPlacement.BOTTOM;\n const popoverStyle = computePopoverPosition(placement, targetRect);\n const portalTarget = portalContainer ?? document.body;\n\n return ReactDOM.createPortal(\n <div className=\"fixed inset-0 z-[calc(var(--z-guidance)+1)] pointer-events-auto\" data-guidance-tour={tour.ref}>\n {targetRect && (\n <svg className=\"fixed inset-0 w-full h-full pointer-events-none\" xmlns=\"http://www.w3.org/2000/svg\">\n <defs>\n <mask id={`spotlight-${tour.ref}`}>\n <rect x=\"0\" y=\"0\" width=\"100%\" height=\"100%\" fill=\"white\" />\n <rect\n x={targetRect.left - 4}\n y={targetRect.top - 4}\n width={targetRect.width + 8}\n height={targetRect.height + 8}\n rx=\"8\"\n fill=\"black\"\n />\n </mask>\n </defs>\n <rect\n x=\"0\"\n y=\"0\"\n width=\"100%\"\n height=\"100%\"\n className=\"fill-black/50\"\n mask={`url(#spotlight-${tour.ref})`}\n />\n </svg>\n )}\n\n <Surface asChild emitPolicyVars={false} variant={SurfaceVariant.OVERLAY}>\n <div\n ref={popoverRef}\n style={popoverStyle}\n role=\"dialog\"\n aria-modal=\"true\"\n tabIndex={-1}\n aria-label={stepTitle}\n className={cn(\n 'w-[340px] max-w-[calc(100vw-2rem)] rounded-xl overflow-hidden font-inherit text-sm pointer-events-auto',\n surfaceRecipe.base,\n 'shadow-[var(--shadow-xl)]',\n )}\n >\n <Button\n variant={ButtonVariants_Variant.GHOST}\n size={ButtonSize.ICON_SM}\n onClick={handleSkip}\n aria-label={closeLabel}\n className=\"absolute top-2 end-2 z-[calc(var(--z-guidance)+2)]\"\n >\n {renderIcon(StandardIconReference.CLOSE, { size: IconSize.SM })}\n </Button>\n\n <div className=\"px-5 pt-5 pb-3\">\n {stepTitle && <h3 className=\"m-0 text-base font-semibold leading-tight pe-6\">{stepTitle}</h3>}\n {stepDescription && <p className=\"mt-2 text-xs text-muted-foreground leading-normal\">{stepDescription}</p>}\n </div>\n\n <div className=\"flex items-center justify-between px-5 pb-4\">\n <span className=\"text-xs text-muted-foreground\">{stepProgress}</span>\n <div className=\"flex items-center gap-2\">\n {tour.allowSkip && (\n <Button variant={ButtonVariants_Variant.GHOST} size={ButtonSize.SM} onClick={handleSkip}>\n {skipLabel}\n </Button>\n )}\n {!isFirstStep && (\n <Button variant={ButtonVariants_Variant.OUTLINE} size={ButtonSize.SM} onClick={handlePrev}>\n {prevLabel}\n </Button>\n )}\n <Button size={ButtonSize.SM} onClick={handleNext}>\n {isLastStep ? finishLabel : nextLabel}\n </Button>\n </div>\n </div>\n </div>\n </Surface>\n </div>,\n portalTarget,\n );\n};\n\nfunction computePopoverPosition(\n placement: TourStepPlacement,\n targetRect: DOMRect \| null,\n): React.CSSProperties {\n if (!targetRect) {\n return {\n position: 'fixed',\n top: '50%',\n left: '50%',\n transform: 'translate(-50%, -50%)',\n };\n }\n\n const GAP = 12;\n switch (placement) {\n case TourStepPlacement.TOP:\n return {\n position: 'fixed',\n bottom: window.innerHeight - targetRect.top + GAP,\n left: targetRect.left + targetRect.width / 2,\n transform: 'translateX(-50%)',\n };\n case TourStepPlacement.BOTTOM:\n return {\n position: 'fixed',\n top: targetRect.bottom + GAP,\n left: targetRect.left + targetRect.width / 2,\n transform: 'translateX(-50%)',\n };\n case TourStepPlacement.LEFT:\n return {\n position: 'fixed',\n top: targetRect.top + targetRect.height / 2,\n right: window.innerWidth - targetRect.left + GAP,\n transform: 'translateY(-50%)',\n };\n case TourStepPlacement.RIGHT:\n return {\n position: 'fixed',\n top: targetRect.top + targetRect.height / 2,\n left: targetRect.right + GAP,\n transform: 'translateY(-50%)',\n };\n case TourStepPlacement.CENTER:\n default:\n return {\n position: 'fixed',\n top: '50%',\n left: '50%',\n transform: 'translate(-50%, -50%)',\n };\n }\n}\n"]}

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

	@@ -1 +1 @@
1	- {"version":3,"file":"GuidanceTour.labels.d.ts","sourceRoot":"","sources":["~~../../../../../~~src/core/guidance/renderers/GuidanceTour.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,kBAAkB,EAAE,mBAAmB,EAenD,CAAC"}
1	+ {"version":3,"file":"GuidanceTour.labels.d.ts","sourceRoot":"","sources":["../../../../../../src/core/guidance/renderers/GuidanceTour.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,kBAAkB,EAAE,mBAAmB,EAenD,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceTour.labels.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"GuidanceTour.labels.js","sourceRoot":"","sources":["~~../../../../../~~src/core/guidance/renderers/GuidanceTour.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE1I,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,kBAAkB,GAA0B;IACvD,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,4CAA4C,EAAE;IAC9F,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,+CAA+C,EAAE;IACrG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,6CAA6C,EAAE;IAC/F,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,kDAAkD,EAAE;IACtG,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,qCAAqC,EAAE;IACxF;QACE,GAAG,EAAE,cAAc;QACnB,IAAI,EAAE,SAAS,CAAC,KAAK;QACrB,OAAO,EAAE,8CAA8C;QACvD,MAAM,EAAE;YACN,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,uCAAuC,EAAE;YACpE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,mCAAmC,EAAE;SAC/D;KACF;CACF,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, LabelKind, type LabellingUnitaryDef, registerComponentLabels } from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const GuidanceTourLabels: LabellingUnitaryDef[] = [\n { ref: 'next', kind: LabelKind.BUTTON, purpose: 'Action that advances to the next tour step' },\n { ref: 'previous', kind: LabelKind.BUTTON, purpose: 'Action that returns to the previous tour step' },\n { ref: 'skip', kind: LabelKind.BUTTON, purpose: 'Action that skips the remainder of the tour' },\n { ref: 'finish', kind: LabelKind.BUTTON, purpose: 'Action that completes the tour on its final step' },\n { ref: 'close', kind: LabelKind.BUTTON, purpose: 'Action that closes the tour overlay' },\n {\n ref: 'stepProgress',\n kind: LabelKind.LABEL,\n purpose: 'Position of the current step within the tour',\n params: [\n { key: 'current', meaning: '1-based index of the step being shown' },\n { key: 'total', meaning: 'total number of steps in the tour' },\n ],\n },\n];\nregisterComponentLabels(FrontendComponentType.GUIDANCE_TOUR, GuidanceTourLabels);\n"]}
1	+ {"version":3,"file":"GuidanceTour.labels.js","sourceRoot":"","sources":["../../../../../../src/core/guidance/renderers/GuidanceTour.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE1I,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,kBAAkB,GAA0B;IACvD,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,4CAA4C,EAAE;IAC9F,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,+CAA+C,EAAE;IACrG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,6CAA6C,EAAE;IAC/F,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,kDAAkD,EAAE;IACtG,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,qCAAqC,EAAE;IACxF;QACE,GAAG,EAAE,cAAc;QACnB,IAAI,EAAE,SAAS,CAAC,KAAK;QACrB,OAAO,EAAE,8CAA8C;QACvD,MAAM,EAAE;YACN,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,uCAAuC,EAAE;YACpE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,mCAAmC,EAAE;SAC/D;KACF;CACF,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, LabelKind, type LabellingUnitaryDef, registerComponentLabels } from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const GuidanceTourLabels: LabellingUnitaryDef[] = [\n { ref: 'next', kind: LabelKind.BUTTON, purpose: 'Action that advances to the next tour step' },\n { ref: 'previous', kind: LabelKind.BUTTON, purpose: 'Action that returns to the previous tour step' },\n { ref: 'skip', kind: LabelKind.BUTTON, purpose: 'Action that skips the remainder of the tour' },\n { ref: 'finish', kind: LabelKind.BUTTON, purpose: 'Action that completes the tour on its final step' },\n { ref: 'close', kind: LabelKind.BUTTON, purpose: 'Action that closes the tour overlay' },\n {\n ref: 'stepProgress',\n kind: LabelKind.LABEL,\n purpose: 'Position of the current step within the tour',\n params: [\n { key: 'current', meaning: '1-based index of the step being shown' },\n { key: 'total', meaning: 'total number of steps in the tour' },\n ],\n },\n];\nregisterComponentLabels(FrontendComponentType.GUIDANCE_TOUR, GuidanceTourLabels);\n"]}

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

	@@ -1 +1 @@
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"}
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"}

package/dist/esm/core/guidance/useGuidance.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useGuidance.js","sourceRoot":"","sources":["~~../../../../~~src/core/guidance/useGuidance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAuF,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEtM;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IACxC,OAAO,GAAG,IAAI,iBAAiB,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,SAAS,IAAI,kBAAkB,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,WAAW,IAAI,oBAAoB,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;AACrF,CAAC","sourcesContent":["/*\n Guidance Hooks\n * \n * Separated from GuidanceContext.tsx for React Fast Refresh compatibility.\n /\n\nimport { useContext, useMemo } from 'react';\nimport { GuidanceContext, type GuidanceContextValue, type ProgressionContextSlice, type LifecycleContextSlice, GUIDANCE_FALLBACK, LIFECYCLE_DEFAULTS, PROGRESSION_DEFAULTS } from './GuidanceContext';\n\n/\n Hook to access the Guidance context.\n * Returns safe no-op defaults when called outside provider (safe for SSR/tests).\n /\nexport function useGuidance(): GuidanceContextValue {\n const ctx = useContext(GuidanceContext);\n return ctx ?? GUIDANCE_FALLBACK;\n}\n\n/\n Hook to access the Lifecycle slice from GuidanceContext.\n \n NOTE: The hook-level useMemo here provides marginal benefit on its own because\n * useContext already triggers a re-render on any context value change. The real\n * isolation comes from the provider-level useMemo on `lifecycleSlice` (inside\n * GuidanceContextProvider), which ensures the `lifecycle` reference only changes\n * when lifecycle data actually changes. This hook-level useMemo acts as a safety\n * net so callers receive a stable reference even if the context value object is\n * recreated without lifecycle changes.\n \n Returns safe no-op defaults when called outside provider.\n /\nexport function useLifecycle(): LifecycleContextSlice {\n const ctx = useContext(GuidanceContext);\n return useMemo(() => ctx?.lifecycle ?? LIFECYCLE_DEFAULTS, [ctx?.lifecycle]);\n}\n\n/\n Hook to access the Progression slice from GuidanceContext.\n \n NOTE: Same isolation pattern as useLifecycle — the provider-level useMemo on\n * `progressionSlice` is what prevents unnecessary re-renders. This hook-level\n * useMemo is a safety net for reference stability.\n \n Returns safe no-op defaults when called outside provider.\n */\nexport function useProgression(): ProgressionContextSlice {\n const ctx = useContext(GuidanceContext);\n return useMemo(() => ctx?.progression ?? PROGRESSION_DEFAULTS, [ctx?.progression]);\n}\n"]}
1	+ {"version":3,"file":"useGuidance.js","sourceRoot":"","sources":["../../../../../src/core/guidance/useGuidance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAuF,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEtM;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IACxC,OAAO,GAAG,IAAI,iBAAiB,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,SAAS,IAAI,kBAAkB,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,WAAW,IAAI,oBAAoB,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;AACrF,CAAC","sourcesContent":["/*\n Guidance Hooks\n * \n * Separated from GuidanceContext.tsx for React Fast Refresh compatibility.\n /\n\nimport { useContext, useMemo } from 'react';\nimport { GuidanceContext, type GuidanceContextValue, type ProgressionContextSlice, type LifecycleContextSlice, GUIDANCE_FALLBACK, LIFECYCLE_DEFAULTS, PROGRESSION_DEFAULTS } from './GuidanceContext';\n\n/\n Hook to access the Guidance context.\n * Returns safe no-op defaults when called outside provider (safe for SSR/tests).\n /\nexport function useGuidance(): GuidanceContextValue {\n const ctx = useContext(GuidanceContext);\n return ctx ?? GUIDANCE_FALLBACK;\n}\n\n/\n Hook to access the Lifecycle slice from GuidanceContext.\n \n NOTE: The hook-level useMemo here provides marginal benefit on its own because\n * useContext already triggers a re-render on any context value change. The real\n * isolation comes from the provider-level useMemo on `lifecycleSlice` (inside\n * GuidanceContextProvider), which ensures the `lifecycle` reference only changes\n * when lifecycle data actually changes. This hook-level useMemo acts as a safety\n * net so callers receive a stable reference even if the context value object is\n * recreated without lifecycle changes.\n \n Returns safe no-op defaults when called outside provider.\n /\nexport function useLifecycle(): LifecycleContextSlice {\n const ctx = useContext(GuidanceContext);\n return useMemo(() => ctx?.lifecycle ?? LIFECYCLE_DEFAULTS, [ctx?.lifecycle]);\n}\n\n/\n Hook to access the Progression slice from GuidanceContext.\n \n NOTE: Same isolation pattern as useLifecycle — the provider-level useMemo on\n * `progressionSlice` is what prevents unnecessary re-renders. This hook-level\n * useMemo is a safety net for reference stability.\n \n Returns safe no-op defaults when called outside provider.\n */\nexport function useProgression(): ProgressionContextSlice {\n const ctx = useContext(GuidanceContext);\n return useMemo(() => ctx?.progression ?? PROGRESSION_DEFAULTS, [ctx?.progression]);\n}\n"]}

package/dist/esm/core/hotkey/DefaultHotkeyHandler.d.ts CHANGED Viewed

@@ -28,11 +28,15 @@ import { type HotkeyEmitShortcut } from '../../core/config/app-level-components.
  *     owns it through `[COMMAND_MENU].openShortcut`, and double-registering it is the collision
  *     this issue's other half exists to arbitrate.
  *   - `Mod+I` — inbox, Linear's mnemonic for the notification surface.
- *   - `Shift+?` — the universal "show shortcuts" chord (GitHub, Slack, Gmail, Linear).
+ *   - `?` — the universal "show shortcuts" chord (GitHub, Slack, Gmail, Linear).
  *
- * `Shift+?` is spelled with its modifier deliberately. Matching is strict, and typing `?` raises
- * `shiftKey`, so a chord written `?` alone can never match — it would have shipped a help dialog
- * that still could not be opened, which is the exact defect being closed.
+ * `?` is spelled WITHOUT a Shift modifier, and this replaces a `Shift+?` that shipped from
+ * 2026-09-08 to 2026-09-15. That spelling reasoned from a US keyboard — typing `?` there raises
+ * `shiftKey`, and the matcher compared it strictly — and rendered `⇧?` in the shortcuts dialog. But
+ * whether Shift is part of typing `?` is a property of the LAYOUT, not of the chord, so Shift is
+ * not a modifier axis for a glyph key at all: `parseShortcut` normalizes it away and
+ * `matchesShortcut` ignores `shiftKey` for one (see `isGlyphKey`). The chord is `?` on every
+ * keyboard, and the dialog shows exactly the key the reader types.
  */
 export declare const ENGINE_DEFAULT_HOTKEY_EMIT_SHORTCUTS: readonly HotkeyEmitShortcut[];
 /**

package/dist/esm/core/hotkey/DefaultHotkeyHandler.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"DefaultHotkeyHandler.d.ts","sourceRoot":"","sources":["~~../../../../~~src/core/hotkey/DefaultHotkeyHandler.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,uEAAuE,CAAC;AA8B/E~~;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG~~;AACH,eAAO,MAAM,oCAAoC,EAAE,SAAS,kBAAkB,EAyB7E,CAAC;AAyBF;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CA+G3C"}
1	+ {"version":3,"file":"DefaultHotkeyHandler.d.ts","sourceRoot":"","sources":["../../../../../src/core/hotkey/DefaultHotkeyHandler.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,uEAAuE,CAAC;AA8B/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,oCAAoC,EAAE,SAAS,kBAAkB,EAyB7E,CAAC;AAyBF;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CA+G3C"}

package/dist/esm/core/hotkey/DefaultHotkeyHandler.js CHANGED Viewed

@@ -46,11 +46,15 @@ const DEFAULT_EMIT_DESCRIPTION_KEYS = {
  *     owns it through `[COMMAND_MENU].openShortcut`, and double-registering it is the collision
  *     this issue's other half exists to arbitrate.
  *   - `Mod+I` — inbox, Linear's mnemonic for the notification surface.
- *   - `Shift+?` — the universal "show shortcuts" chord (GitHub, Slack, Gmail, Linear).
+ *   - `?` — the universal "show shortcuts" chord (GitHub, Slack, Gmail, Linear).
  *
- * `Shift+?` is spelled with its modifier deliberately. Matching is strict, and typing `?` raises
- * `shiftKey`, so a chord written `?` alone can never match — it would have shipped a help dialog
- * that still could not be opened, which is the exact defect being closed.
+ * `?` is spelled WITHOUT a Shift modifier, and this replaces a `Shift+?` that shipped from
+ * 2026-09-08 to 2026-09-15. That spelling reasoned from a US keyboard — typing `?` there raises
+ * `shiftKey`, and the matcher compared it strictly — and rendered `⇧?` in the shortcuts dialog. But
+ * whether Shift is part of typing `?` is a property of the LAYOUT, not of the chord, so Shift is
+ * not a modifier axis for a glyph key at all: `parseShortcut` normalizes it away and
+ * `matchesShortcut` ignores `shiftKey` for one (see `isGlyphKey`). The chord is `?` on every
+ * keyboard, and the dialog shows exactly the key the reader types.
  */
 export const ENGINE_DEFAULT_HOTKEY_EMIT_SHORTCUTS = [
     {
@@ -73,7 +77,7 @@ export const ENGINE_DEFAULT_HOTKEY_EMIT_SHORTCUTS = [
     },
     {
         event: HotkeyDispatchableEvent.HOTKEY_SHORTCUTS_HELP,
-        shortcut: 'Shift+?',
+        shortcut: '?',
         scope: HotkeyScope.GLOBAL,
         group: HotkeyGroup.HELP,
     },