@sunboard/react 0.6.1 → 0.8.0

package/dist/index.d.mts

@@ -52,6 +52,12 @@ type TourResult = {
   ok: false;
   reason: "not-ready" | "missing-user" | "missing-tour";
 };
+type StepResult = {
+  ok: true;
+} | {
+  ok: false;
+  reason: "not-ready" | "missing-user" | "missing-step" | "not-manual" | "network-error";
+};
 type TooltipResult = {
   ok: true;
 } | {
@@ -106,6 +112,12 @@ type SunboardContextValue = {
   advanceTour: () => Promise<TourResult>;
   navigateToStep: (step: SunboardStep) => Promise<void>;
   startChecklistStep: (step: SunboardStep) => Promise<TourResult | TooltipResult | void>;
+  /**
+   * Complete a checklist step because the user checked it off. Only steps the
+   * spec allows (`manual` not set to false) accept it; the completion is
+   * recorded with a "manual" source, distinct from event/tour completions.
+   */
+  completeChecklistStep: (stepKey: string) => Promise<StepResult>;
   visibleHotspots: Array<{
     key: string;
     hotspot: SunboardHotspot;
@@ -209,6 +221,12 @@ type ChecklistViewStep = {
   description?: string;
   badge?: string;
   actionLabel?: string;
+  /**
+   * True when the user can complete this step by checking it off (the spec
+   * default). False (`manual: false` in the spec) means the step completes
+   * only through its instrumented rule; render its checkbox non-interactive.
+   */
+  manuallyCompletable: boolean;
 };
 type ChecklistCompletion = {
   title: string;
@@ -229,6 +247,11 @@ type UseChecklistResult = {
   isCompleted: (key: string) => boolean;
   hasAction: (step: ChecklistViewStep) => boolean;
   startStep: (step: ChecklistViewStep) => void;
+  /**
+   * Mark the step complete because the user checked it off. A no-op for
+   * steps that are not manually completable or already complete.
+   */
+  completeStep: (step: ChecklistViewStep) => void;
   completion?: ChecklistCompletion;
   dismissCompletion: () => void;
 };
@@ -321,5 +344,5 @@ type UseTooltipsResult = {
  */
 declare function useTooltips(): UseTooltipsResult;
 //#endregion
-export { type ChecklistViewStep, type RuntimeBootstrapRequest, type RuntimeBootstrapResponse, type RuntimeExperience, type RuntimeProgress, type RuntimeTrackRequest, type RuntimeTrackResponse, Sunboard, SunboardChecklist, type SunboardContextValue, SunboardHotspots, SunboardProvider, type SunboardProviderProps, SunboardRuntimeApiError, SunboardRuntimeClient, type SunboardRuntimeClientOptions, SunboardSurvey, SunboardTooltips, SunboardTour, type SunboardUser, type SurveyResult, type SurveyViewOption, type SurveyViewQuestion, type SurveyViewStep, type TooltipResult, type TooltipView, type TourResult, type TrackProperties, type TrackResult, type UseChecklistResult, type UseSurveyResult, type UseTooltipsResult, type VisibleSunboardTooltip, useChecklist, useSunboard, useSurvey, useTooltips };
+export { type ChecklistViewStep, type RuntimeBootstrapRequest, type RuntimeBootstrapResponse, type RuntimeExperience, type RuntimeProgress, type RuntimeTrackRequest, type RuntimeTrackResponse, type StepResult, Sunboard, SunboardChecklist, type SunboardContextValue, SunboardHotspots, SunboardProvider, type SunboardProviderProps, SunboardRuntimeApiError, SunboardRuntimeClient, type SunboardRuntimeClientOptions, SunboardSurvey, SunboardTooltips, SunboardTour, type SunboardUser, type SurveyResult, type SurveyViewOption, type SurveyViewQuestion, type SurveyViewStep, type TooltipResult, type TooltipView, type TourResult, type TrackProperties, type TrackResult, type UseChecklistResult, type UseSurveyResult, type UseTooltipsResult, type VisibleSunboardTooltip, useChecklist, useSunboard, useSurvey, useTooltips };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/adapters/navigation.ts","../src/lib/detect-identities.ts","../src/hooks/sunboard-context.ts","../src/components/SunboardProvider.tsx","../src/components/SunboardHotspots.tsx","../src/components/SunboardTooltips.tsx","../src/components/SunboardTour.tsx","../src/components/Sunboard.tsx","../src/hooks/useSunboard.ts","../src/hooks/useChecklist.ts","../src/hooks/useSurvey.ts","../src/hooks/useTooltips.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/adapters/navigation.ts","../src/lib/detect-identities.ts","../src/hooks/sunboard-context.ts","../src/components/SunboardProvider.tsx","../src/components/SunboardHotspots.tsx","../src/components/SunboardTooltips.tsx","../src/components/SunboardTour.tsx","../src/components/Sunboard.tsx","../src/hooks/useSunboard.ts","../src/hooks/useChecklist.ts","../src/hooks/useSurvey.ts","../src/hooks/useTooltips.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -310,6 +310,52 @@ function SunboardProvider({ spec: specProp, user, loading: loadingProp, route, n
 		user,
 		versionId
 	]);
+	const completeChecklistStep = useCallback(async (stepKey) => {
+		if (resolvedLoading || !resolvedSpec) return {
+			ok: false,
+			reason: "not-ready"
+		};
+		if (!user) return {
+			ok: false,
+			reason: "missing-user"
+		};
+		const step = (resolvedSpec.checklist?.steps ?? []).find((candidate) => candidate.key === stepKey);
+		if (!step) return {
+			ok: false,
+			reason: "missing-step"
+		};
+		if (step.manual === false) return {
+			ok: false,
+			reason: "not-manual"
+		};
+		setCompletedStepKeys((current) => mergeKeys(current, [stepKey]));
+		if (hostedMode && client && experienceKey) try {
+			applyProgress((await client.completeStep({
+				experienceKey,
+				origin: currentOrigin,
+				route: currentRoute,
+				stepKey,
+				user: toRuntimeUser(user),
+				versionId: versionId ?? void 0
+			})).progress, setCompletedStepKeys, setCompletedTourKeys, setDismissedTooltipKeys);
+		} catch {
+			return {
+				ok: false,
+				reason: "network-error"
+			};
+		}
+		return { ok: true };
+	}, [
+		client,
+		currentOrigin,
+		currentRoute,
+		experienceKey,
+		hostedMode,
+		resolvedLoading,
+		resolvedSpec,
+		user,
+		versionId
+	]);
 	const submitSurvey = useCallback(async (answers) => {
 		if (resolvedLoading || !resolvedSpec) return {
 			ok: false,
@@ -632,6 +678,7 @@ function SunboardProvider({ spec: specProp, user, loading: loadingProp, route, n
 		advanceTour,
 		navigateToStep,
 		startChecklistStep,
+		completeChecklistStep,
 		visibleHotspots,
 		dismissedTooltipKeys: effectiveDismissedTooltipKeys,
 		visibleTooltips,
@@ -655,6 +702,7 @@ function SunboardProvider({ spec: specProp, user, loading: loadingProp, route, n
 		advanceTour,
 		navigateToStep,
 		startChecklistStep,
+		completeChecklistStep,
 		visibleHotspots,
 		effectiveDismissedTooltipKeys,
 		visibleTooltips,
@@ -893,7 +941,7 @@ function interpolateOptional$1(text, user) {
 	return interpolateTokens(text, user) || void 0;
 }
 function useChecklist() {
-	const { spec, user, loading, completedStepKeys, completedCount, totalSteps, startChecklistStep } = useSunboard();
+	const { spec, user, loading, completedStepKeys, completedCount, totalSteps, startChecklistStep, completeChecklistStep } = useSunboard();
 	const [dismissedKey, setDismissedKey] = useState(null);
 	const hasChecklist = Boolean(spec && spec.checklist?.steps.length);
 	const allCompleted = totalSteps > 0 && completedCount >= totalSteps;
@@ -932,7 +980,8 @@ function useChecklist() {
 			title: interpolateTokens(step.title, user ?? null),
 			description: step.description ? interpolateTokens(step.description, user ?? null) : void 0,
 			badge: step.badge ? interpolateTokens(step.badge, user ?? null) : void 0,
-			actionLabel: actionLabelFor(step)
+			actionLabel: actionLabelFor(step),
+			manuallyCompletable: step.manual !== false
 		}));
 	}, [rawSteps, user]);
 	const stepsByKey = useMemo(() => {
@@ -961,6 +1010,9 @@ function useChecklist() {
 			const raw = stepsByKey.get(step.key);
 			if (raw) startChecklistStep(raw);
 		},
+		completeStep: (step) => {
+			if (step.manuallyCompletable && !completedStepKeys.has(step.key)) completeChecklistStep(step.key);
+		},
 		completion: showingCompletion ? completion : void 0,
 		dismissCompletion
 	};
@@ -1117,14 +1169,74 @@ const CheckIcon = () => {
 		children: /* @__PURE__ */ jsx("path", { d: "M20 6 9 17l-5-5" })
 	});
 };
+const ListIcon = () => {
+	return /* @__PURE__ */ jsxs("svg", {
+		xmlns: "http://www.w3.org/2000/svg",
+		width: "24",
+		height: "24",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		className: "lucide lucide-list-icon lucide-list",
+		children: [
+			/* @__PURE__ */ jsx("path", { d: "M3 12h.01" }),
+			/* @__PURE__ */ jsx("path", { d: "M3 18h.01" }),
+			/* @__PURE__ */ jsx("path", { d: "M3 6h.01" }),
+			/* @__PURE__ */ jsx("path", { d: "M8 12h13" }),
+			/* @__PURE__ */ jsx("path", { d: "M8 18h13" }),
+			/* @__PURE__ */ jsx("path", { d: "M8 6h13" })
+		]
+	});
+};
+const XIcon = () => {
+	return /* @__PURE__ */ jsxs("svg", {
+		xmlns: "http://www.w3.org/2000/svg",
+		width: "24",
+		height: "24",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		className: "lucide lucide-x-icon lucide-x",
+		children: [/* @__PURE__ */ jsx("path", { d: "M18 6 6 18" }), /* @__PURE__ */ jsx("path", { d: "m6 6 12 12" })]
+	});
+};
+const ChevronRightIcon = () => {
+	return /* @__PURE__ */ jsx("svg", {
+		xmlns: "http://www.w3.org/2000/svg",
+		width: "24",
+		height: "24",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		className: "lucide lucide-chevron-right-icon lucide-chevron-right",
+		children: /* @__PURE__ */ jsx("path", { d: "m9 18 6-6-6-6" })
+	});
+};
 
 //#endregion
 //#region src/components/ChecklistStep.tsx
-function ChecklistStep({ completed, onStart, step }) {
+function ChecklistStep({ completed, onComplete, onStart, step }) {
 	const hasAction = step.actionLabel !== void 0;
-	const status = /* @__PURE__ */ jsx("span", {
+	const checkable = step.manuallyCompletable && !completed;
+	const status = checkable ? /* @__PURE__ */ jsx("button", {
 		className: "sunboard-step-status",
-		"aria-label": completed ? "Completed" : "Incomplete",
+		type: "button",
+		onClick: onComplete,
+		"aria-label": `Mark ${step.title} complete`,
+		children: /* @__PURE__ */ jsx(CheckIcon, {})
+	}) : /* @__PURE__ */ jsx("span", {
+		className: "sunboard-step-status",
+		"data-locked": !completed && !step.manuallyCompletable ? "true" : void 0,
+		"aria-label": completed ? "Completed" : step.manuallyCompletable ? "Incomplete" : "Completes automatically",
 		children: completed ? /* @__PURE__ */ jsx(CheckIcon, {}) : null
 	});
 	const content = /* @__PURE__ */ jsxs("div", {
@@ -1146,15 +1258,20 @@ function ChecklistStep({ completed, onStart, step }) {
 	return /* @__PURE__ */ jsx("li", {
 		className: "sunboard-step",
 		"data-completed": completed,
-		children: hasAction ? /* @__PURE__ */ jsxs("button", {
-			className: "sunboard-step-row",
-			type: "button",
-			onClick: onStart,
-			"aria-label": `${step.actionLabel} ${step.title}`,
-			children: [status, content]
-		}) : /* @__PURE__ */ jsxs("div", {
+		children: /* @__PURE__ */ jsxs("div", {
 			className: "sunboard-step-row",
-			children: [status, content]
+			"data-interactive": hasAction || checkable ? "true" : void 0,
+			children: [status, hasAction ? /* @__PURE__ */ jsxs("button", {
+				className: "sunboard-step-main",
+				type: "button",
+				onClick: onStart,
+				"aria-label": `${step.actionLabel} ${step.title}`,
+				children: [content, /* @__PURE__ */ jsx("span", {
+					className: "sunboard-step-arrow",
+					"aria-hidden": "true",
+					children: /* @__PURE__ */ jsx(ChevronRightIcon, {})
+				})]
+			}) : content]
 		})
 	});
 }
@@ -1556,7 +1673,7 @@ function SunboardTourScrim({ rect }) {
 //#region src/components/Sunboard.tsx
 function SunboardChecklist() {
 	const [open, setOpen] = useState(true);
-	const { visible, title, subtitle, steps, completedCount, totalSteps, remainingCount, progress, isCompleted, startStep, completion, dismissCompletion } = useChecklist();
+	const { visible, title, subtitle, steps, completedCount, totalSteps, remainingCount, progress, isCompleted, startStep, completeStep, completion, dismissCompletion } = useChecklist();
 	useEffect(() => {
 		if (!completion?.dismissAfterMs) return;
 		const handle = window.setTimeout(dismissCompletion, completion.dismissAfterMs);
@@ -1573,7 +1690,7 @@ function SunboardChecklist() {
 			type: "button",
 			onClick: dismissCompletion,
 			"aria-label": "Dismiss completion message",
-			children: "x"
+			children: /* @__PURE__ */ jsx(XIcon, {})
 		}), /* @__PURE__ */ jsxs("div", {
 			className: "sunboard-completion",
 			children: [
@@ -1605,15 +1722,15 @@ function SunboardChecklist() {
 			]
 		})]
 	});
-	if (!open) return /* @__PURE__ */ jsx("button", {
+	if (!open) return /* @__PURE__ */ jsxs("button", {
 		className: "sunboard-launcher",
 		type: "button",
 		onClick: () => setOpen(true),
 		"aria-label": `Open ${title} checklist, ${remainingCount} tasks remaining`,
-		children: /* @__PURE__ */ jsx("span", {
-			className: "sunboard-launcher-count",
+		children: [remainingCount > 0 ? /* @__PURE__ */ jsx("span", {
+			className: "sunboard-launcher-badge",
 			children: remainingCount
-		})
+		}) : null, /* @__PURE__ */ jsx(ListIcon, {})]
 	});
 	return /* @__PURE__ */ jsxs("aside", {
 		className: "sunboard-root",
@@ -1642,7 +1759,7 @@ function SunboardChecklist() {
 						type: "button",
 						onClick: () => setOpen(false),
 						"aria-label": `Close ${title} checklist`,
-						children: "x"
+						children: /* @__PURE__ */ jsx(XIcon, {})
 					})]
 				})]
 			}),
@@ -1662,6 +1779,7 @@ function SunboardChecklist() {
 				className: "sunboard-step-list",
 				children: steps.map((step) => /* @__PURE__ */ jsx(ChecklistStep, {
 					completed: isCompleted(step.key),
+					onComplete: () => completeStep(step),
 					onStart: () => startStep(step),
 					step
 				}, step.key))