@burdenoff/fe-libs 2026.1003.4 → 2026.1004.1

package/dist/shared/tours/TourPlayerProvider.js

@@ -5,64 +5,65 @@ import { createContext as r, use as i, useEffect as a } from "react";
 import { Fragment as o, jsx as s, jsxs as c } from "react/jsx-runtime";
 //#region src/shared/tours/TourPlayerProvider.tsx
 var l = r(null);
-function u({ children: r, onTourStart: i, onTourComplete: a, onTourSkip: u, onStepChange: f, onStepComplete: p, zIndex: m = 9998 }) {
-	let h = e({
-		onTourStart: i,
-		onTourComplete: a,
-		onTourSkip: u,
-		onStepChange: f,
-		onStepComplete: p
-	}), g = {
-		isPlaying: h.isPlaying,
-		currentTour: h.currentTour,
-		currentStepIndex: h.currentStepIndex,
-		isPaused: h.isPaused,
-		isCompleted: h.isCompleted,
-		isSkipped: h.isSkipped,
-		currentStep: h.currentStep,
-		totalSteps: h.totalSteps,
-		progress: h.progress,
-		canGoNext: h.canGoNext,
-		canGoPrevious: h.canGoPrevious,
-		startTour: h.startTour,
-		stopTour: h.stopTour,
-		nextStep: h.nextStep,
-		previousStep: h.previousStep,
-		goToStep: h.goToStep,
-		pauseTour: h.pauseTour,
-		resumeTour: h.resumeTour,
-		skipTour: h.skipTour,
-		completeTour: h.completeTour
+function u({ children: r, scopeKey: i, onTourStart: a, onTourComplete: u, onTourSkip: f, onStepChange: p, onStepComplete: m, zIndex: h = 9998 }) {
+	let g = e({
+		scopeKey: i,
+		onTourStart: a,
+		onTourComplete: u,
+		onTourSkip: f,
+		onStepChange: p,
+		onStepComplete: m
+	}), _ = {
+		isPlaying: g.isPlaying,
+		currentTour: g.currentTour,
+		currentStepIndex: g.currentStepIndex,
+		isPaused: g.isPaused,
+		isCompleted: g.isCompleted,
+		isSkipped: g.isSkipped,
+		currentStep: g.currentStep,
+		totalSteps: g.totalSteps,
+		progress: g.progress,
+		canGoNext: g.canGoNext,
+		canGoPrevious: g.canGoPrevious,
+		startTour: g.startTour,
+		stopTour: g.stopTour,
+		nextStep: g.nextStep,
+		previousStep: g.previousStep,
+		goToStep: g.goToStep,
+		pauseTour: g.pauseTour,
+		resumeTour: g.resumeTour,
+		skipTour: g.skipTour,
+		completeTour: g.completeTour
 	};
 	return /* @__PURE__ */ c(l.Provider, {
-		value: g,
-		children: [r, h.isPlaying && !h.isPaused && h.currentStep && /* @__PURE__ */ c(o, { children: [
+		value: _,
+		children: [r, g.isPlaying && !g.isPaused && g.currentStep && /* @__PURE__ */ c(o, { children: [
 			/* @__PURE__ */ s(t, {
-				targetRect: h.targetRect,
-				zIndex: m
+				targetRect: g.targetRect,
+				zIndex: h
 			}),
 			/* @__PURE__ */ s(n, {
-				step: h.currentStep,
-				stepIndex: h.currentStepIndex,
-				totalSteps: h.totalSteps,
-				onNext: h.nextStep,
-				onPrevious: h.previousStep,
-				onSkip: h.skipTour,
-				onComplete: h.completeTour,
-				canGoNext: h.canGoNext,
-				canGoPrevious: h.canGoPrevious,
-				isLastStep: h.isLastStep,
-				placement: h.currentStep.placement,
-				targetRect: h.targetRect
+				step: g.currentStep,
+				stepIndex: g.currentStepIndex,
+				totalSteps: g.totalSteps,
+				onNext: g.nextStep,
+				onPrevious: g.previousStep,
+				onSkip: g.skipTour,
+				onComplete: g.completeTour,
+				canGoNext: g.canGoNext,
+				canGoPrevious: g.canGoPrevious,
+				isLastStep: g.isLastStep,
+				placement: g.currentStep.placement,
+				targetRect: g.targetRect
 			}),
 			/* @__PURE__ */ s(d, {
-				onNext: h.nextStep,
-				onPrevious: h.previousStep,
-				onSkip: h.skipTour,
-				onComplete: h.completeTour,
-				canGoNext: h.canGoNext,
-				canGoPrevious: h.canGoPrevious,
-				isLastStep: h.isLastStep
+				onNext: g.nextStep,
+				onPrevious: g.previousStep,
+				onSkip: g.skipTour,
+				onComplete: g.completeTour,
+				canGoNext: g.canGoNext,
+				canGoPrevious: g.canGoPrevious,
+				isLastStep: g.isLastStep
 			})
 		] })]
 	});

package/dist/shared/tours/TourTrigger.js

@@ -47,7 +47,7 @@ function O({ actions: e }) {
 function k({ pathname: i, navigateTo: a, actions: o }) {
 	let [v, y] = h(!1), [b, T] = h(!1), [D, O] = h(null), k = m(null), A = m(null);
 	t("header-help", v, d(() => y(!1), []));
-	let { pageTours: j, productId: M, moduleId: N, pageId: P, loading: F } = s(), I = n(), L = !!a, R = e()?.pageAccessDenied ?? !1;
+	let { pageTours: j, productId: M, moduleId: N, pageId: P, loading: F, error: I, refetch: L } = s(), R = n(), z = !!a, B = e()?.pageAccessDenied ?? !1;
 	f(() => {
 		let e = () => {
 			T(window.innerWidth < 768);
@@ -66,23 +66,23 @@ function k({ pathname: i, navigateTo: a, actions: o }) {
 		};
 		return v && document.addEventListener("keydown", e), () => document.removeEventListener("keydown", e);
 	}, [v]);
-	let z = (e) => {
+	let V = (e) => {
 		y(!1);
 		let t = E(e, i, {
 			productId: M ?? "",
 			moduleId: N,
 			pageId: P
-		}, L);
+		}, z);
 		if (t.type === "navigate") {
 			O(e.id), a?.(t.targetPath);
 			return;
 		}
 		t.type !== "ignore" && window.setTimeout(() => {
-			I(e);
+			R(e);
 		}, S);
-	}, B = (e) => {
+	}, H = (e) => {
 		y(!1), e.onClick?.();
-	}, V = p(() => ({
+	}, U = p(() => ({
 		productId: M ?? "",
 		moduleId: N,
 		pageId: P
@@ -90,40 +90,40 @@ function k({ pathname: i, navigateTo: a, actions: o }) {
 		N,
 		P,
 		M
-	]), H = p(() => j.filter((e) => w(e, M)).sort((e, t) => {
-		let n = r(e, V) - r(t, V);
+	]), W = p(() => j.filter((e) => w(e, M)).sort((e, t) => {
+		let n = r(e, U) - r(t, U);
 		if (n !== 0) return n;
 		let i = (t.priority ?? 0) - (e.priority ?? 0);
 		return i === 0 ? (e.displayOrder ?? 0) - (t.displayOrder ?? 0) : i;
 	}), [
-		V,
+		U,
 		M,
 		j
 	]);
 	f(() => {
 		if (!D) return;
-		let e = H.find((e) => e.id === D);
+		let e = W.find((e) => e.id === D);
 		if (!e) {
 			O(null);
 			return;
 		}
-		let t = E(e, i, V, L);
+		let t = E(e, i, U, z);
 		if (t.type === "navigate") return;
 		if (t.type === "ignore") {
 			O(null);
 			return;
 		}
 		let n = window.setTimeout(() => {
-			I(e), O(null);
+			R(e), O(null);
 		}, C);
 		return () => window.clearTimeout(n);
 	}, [
-		H,
-		L,
-		V,
+		W,
+		z,
+		U,
 		i,
 		D,
-		I
+		R
 	]), f(() => {
 		if (!D) return;
 		let e = window.setTimeout(() => {
@@ -131,34 +131,38 @@ function k({ pathname: i, navigateTo: a, actions: o }) {
 		}, x);
 		return () => window.clearTimeout(e);
 	}, [D]);
-	let U = H.length > 0, W = R;
+	let G = W.length > 0, K = B;
 	return f(() => {
-		W && v && y(!1);
-	}, [W, v]), W ? null : /* @__PURE__ */ _("div", {
+		K && v && y(!1);
+	}, [K, v]), K ? null : /* @__PURE__ */ _("div", {
 		className: "relative",
 		children: [
 			/* @__PURE__ */ g(c, {
 				ref: k,
 				isOpen: v,
-				hasTours: U,
+				hasTours: G,
 				onClick: () => y(!v)
 			}),
 			v && b && /* @__PURE__ */ g(l, {
 				ref: A,
 				loading: F,
-				tours: H,
+				error: I,
+				onRetry: L,
+				tours: W,
 				onClose: () => y(!1),
-				onStartTour: z,
+				onStartTour: V,
 				actions: o,
-				onAction: B
+				onAction: H
 			}),
 			v && !b && /* @__PURE__ */ g(u, {
 				ref: A,
 				loading: F,
-				tours: H,
-				onStartTour: z,
+				error: I,
+				onRetry: L,
+				tours: W,
+				onStartTour: V,
 				actions: o,
-				onAction: B
+				onAction: H
 			})
 		]
 	});

package/dist/shared/tours/ToursContext.d.ts

@@ -2,6 +2,7 @@ import { ReactNode } from 'react';
 import { Tour } from './types';
 import { TrackEventType, TrackEventOptions } from './toursContext/useTourMutations';
 export interface ToursContextValue {
+    progressScopeKey?: string;
     tours: Tour[];
     pageTours: Tour[];
     loading: boolean;

package/dist/shared/tours/ToursContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToursContext.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/ToursContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAOf,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAOpC,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,SAAS,EAAE,IAAI,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,aAAa,EAAE,CACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,EAC3C,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,UAAU,EAAE,CACV,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,iBAAiB,KACxB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAID,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC7D,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,aAAsB,EACtB,iBAAiB,EACjB,QAAgB,GACjB,EAAE,kBAAkB,2CAuTpB;AAED,wBAAgB,eAAe,IAAI,iBAAiB,CAMnD;AAED,wBAAgB,mBAAmB,IAAI,iBAAiB,CAmBvD;AAED,wBAAgB,QAAQ;;;;mBAzXP,IAAI;4BAET,MAAM,UACN,SAAS,GAAG,WAAW,GAAG,SAAS,WAClC,MAAM,KACZ,OAAO,CAAC,IAAI,CAAC;EA6XnB;AAED,wBAAgB,gBAAgB,IAAI,IAAI,GAAG,IAAI,CAG9C"}
+{"version":3,"file":"ToursContext.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/ToursContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AASf,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAOpC,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,SAAS,EAAE,IAAI,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,aAAa,EAAE,CACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,EAC3C,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,UAAU,EAAE,CACV,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,iBAAiB,KACxB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAID,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC7D,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,aAAsB,EACtB,iBAAiB,EACjB,QAAgB,GACjB,EAAE,kBAAkB,2CA+TpB;AAED,wBAAgB,eAAe,IAAI,iBAAiB,CAMnD;AAED,wBAAgB,mBAAmB,IAAI,iBAAiB,CAmBvD;AAED,wBAAgB,QAAQ;;;;mBAjYP,IAAI;4BAET,MAAM,UACN,SAAS,GAAG,WAAW,GAAG,SAAS,WAClC,MAAM,KACZ,OAAO,CAAC,IAAI,CAAC;EAqYnB;AAED,wBAAgB,gBAAgB,IAAI,IAAI,GAAG,IAAI,CAG9C"}

package/dist/shared/tours/ToursContext.js

@@ -3,172 +3,175 @@ import "../../shared-graphql.js";
 import { useAppShell as t } from "../providers/shell/AppShellContext.js";
 import { useAuth as n } from "../providers/shell/AuthProvider.js";
 import { useActiveContext as r } from "../providers/shell/ActiveContextProvider.js";
-import { useLogger as i } from "../logger/useLogger.js";
+import { useSafePermissions as i } from "../providers/shell/PermissionProvider.js";
+import { useLogger as a } from "../logger/useLogger.js";
 import "../../shared-logger.js";
-import { isTourVisibleForContext as a } from "./routeCatalog.js";
-import { GET_TOURS_FOR_CONTEXT as o, GET_TOURS_FOR_CONTEXT_WITHOUT_PROGRESS as s } from "./toursContext/gql.js";
-import { isMyProgressFieldMissingError as c, isTeardownInvariant as l } from "./toursContext/errors.js";
-import { normalizeDeviceType as u } from "./toursContext/session.js";
-import { deriveRouteContext as d } from "./toursContext/route.js";
-import { useIdleReady as ee } from "./toursContext/useIdleReady.js";
-import { useTourMutations as te } from "./toursContext/useTourMutations.js";
-import { createContext as f, use as p, useCallback as m, useEffect as h, useMemo as g, useRef as _, useState as v } from "react";
-import { jsx as ne } from "react/jsx-runtime";
-import { useLocation as y } from "react-router";
+import { isTourAllowedByPermissions as o } from "./permissions.js";
+import { isTourVisibleForContext as s } from "./routeCatalog.js";
+import { GET_TOURS_FOR_CONTEXT as c, GET_TOURS_FOR_CONTEXT_WITHOUT_PROGRESS as l } from "./toursContext/gql.js";
+import { isMyProgressFieldMissingError as u, isTeardownInvariant as d } from "./toursContext/errors.js";
+import { normalizeDeviceType as ee } from "./toursContext/session.js";
+import { deriveRouteContext as te } from "./toursContext/route.js";
+import { useIdleReady as ne } from "./toursContext/useIdleReady.js";
+import { useTourMutations as re } from "./toursContext/useTourMutations.js";
+import { createContext as ie, use as f, useCallback as p, useEffect as m, useMemo as h, useRef as g, useState as _ } from "react";
+import { jsx as ae } from "react/jsx-runtime";
+import { useLocation as oe } from "react-router";
 //#region src/shared/tours/ToursContext.tsx
-var b = f(null);
-function x({ children: f, defaultPageId: p = "home", getPageIdFromPath: x, disabled: S = !1 }) {
-	let C = y(), w = e("global"), { workspaceId: T } = r(), { user: E } = n(), { productSlug: D } = t(), O = i("ToursContext"), k = T ?? void 0, A = S || C.pathname.startsWith("/devportal"), { moduleId: j, pageId: M } = g(() => d(C.pathname, D, p, x), [
-		p,
-		x,
-		C.pathname,
-		D
-	]), [N, P] = v([]), [F, I] = v(!1), [L, R] = v(null), z = ee(), B = _([]), re = _(0), ie = _(/* @__PURE__ */ new Map()), V = _(void 0), H = _(!1), U = _(!0), W = _(0), G = _(!0);
-	h(() => (U.current = !0, () => {
+var v = ie(null);
+function y({ children: ie, defaultPageId: f = "home", getPageIdFromPath: y, disabled: b = !1 }) {
+	let x = oe(), S = e("global"), { workspaceId: C } = r(), { user: w } = n(), T = i(), { productSlug: E } = t(), D = a("ToursContext"), O = C ?? void 0, k = b || x.pathname.startsWith("/devportal"), { moduleId: A, pageId: j } = h(() => te(x.pathname, E, f, y), [
+		f,
+		y,
+		x.pathname,
+		E
+	]), [M, N] = _([]), [P, F] = _(!1), [I, L] = _(null), R = ne(), z = g([]), se = g(0), B = g(/* @__PURE__ */ new Map()), V = g(void 0), H = g(!1), U = g(!0), W = g(0), G = g(!0);
+	m(() => (U.current = !0, () => {
 		U.current = !1;
 	}), []);
-	let K = m(async (e = !1) => {
-		if (!z && !e) return;
-		if (A) {
-			U.current && (P([]), I(!1), R(null));
+	let K = p(async (e = !1) => {
+		if (!R && !e) return;
+		if (k) {
+			U.current && (N([]), F(!1), L(null));
 			return;
 		}
-		if (!w) return;
-		let t = O.child("fetch", {
-			productSlug: D,
-			workspaceId: k,
-			moduleId: j,
-			pageId: M
-		}), n = u(), r = [
-			D,
+		if (!S) return;
+		let t = D.child("fetch", {
+			productSlug: E,
+			workspaceId: O,
+			moduleId: A,
+			pageId: j
+		}), n = ee(), r = [
+			E,
+			A ?? "",
 			j ?? "",
-			M ?? "",
-			k,
+			O,
 			n,
-			E?.id ?? "anonymous"
+			w?.id ?? "anonymous"
 		].join("::");
 		if (!e && H.current && V.current === r) return;
-		U.current && (I(!0), R(null));
+		U.current && (F(!0), L(null));
 		let i = ++W.current;
 		try {
 			let e = { context: {
-				productId: D,
-				moduleId: j,
-				pageId: M,
-				workspaceId: k,
+				productId: E,
+				moduleId: A,
+				pageId: j,
+				workspaceId: O,
 				deviceType: n
-			} }, a = "network-only", l, u = G.current ? o : s;
+			} }, a = "network-only", o, s = G.current ? c : l;
 			try {
-				l = await w.query({
-					query: u,
+				o = await S.query({
+					query: s,
 					variables: e,
 					fetchPolicy: a,
 					errorPolicy: "none"
 				});
-				let n = l.errors;
-				u === o && n?.some((e) => c(e)) && (G.current = !1, t.warn("[ToursContext] Gateway returned a Tour.myProgress validation error — falling back to query without progress chips until the backend field is published."), l = await w.query({
-					query: s,
+				let n = o.errors;
+				s === c && n?.some((e) => u(e)) && (G.current = !1, t.warn("[ToursContext] Gateway returned a Tour.myProgress validation error — falling back to query without progress chips until the backend field is published."), o = await S.query({
+					query: l,
 					variables: e,
 					fetchPolicy: a,
 					errorPolicy: "none"
 				}));
 			} catch (n) {
-				if (u === o && c(n)) G.current = !1, t.warn("[ToursContext] Gateway does not expose Tour.myProgress yet — falling back to query without progress chips until the backend field is published."), l = await w.query({
-					query: s,
+				if (s === c && u(n)) G.current = !1, t.warn("[ToursContext] Gateway does not expose Tour.myProgress yet — falling back to query without progress chips until the backend field is published."), o = await S.query({
+					query: l,
 					variables: e,
 					fetchPolicy: a,
 					errorPolicy: "none"
 				});
 				else throw n;
 			}
-			let d = (l.data?.toursForContext ?? []).filter((e, t, n) => n.findIndex((t) => t.id === e.id) === t);
-			U.current && i === W.current && (P(d), V.current = r, H.current = !0);
+			let d = (o.data?.toursForContext ?? []).filter((e, t, n) => n.findIndex((t) => t.id === e.id) === t);
+			U.current && i === W.current && (N(d), V.current = r, H.current = !0);
 		} catch (e) {
-			if (!U.current || i !== W.current || l(e)) return;
+			if (!U.current || i !== W.current || d(e)) return;
 			let n = e instanceof Error ? e : /* @__PURE__ */ Error("Failed to fetch tours");
-			t.error("Failed to fetch tours for context", n), R(n), P([]);
+			t.error("Failed to fetch tours for context", n), L(n), N([]);
 		} finally {
-			U.current && i === W.current && I(!1);
+			U.current && i === W.current && F(!1);
 		}
 	}, [
-		z,
+		R,
+		k,
+		S,
+		D,
 		A,
-		w,
-		O,
 		j,
-		M,
-		D,
-		k,
-		E?.id
-	]), q = _(E?.id);
-	h(() => {
-		q.current !== E?.id && (q.current = E?.id, H.current = !1, V.current = void 0, U.current && P([]));
-	}, [E?.id]), h(() => {
+		E,
+		O,
+		w?.id
+	]), q = `${w?.id ?? ""}:${O ?? ""}`, [ce, le] = _(q);
+	ce !== q && (le(q), N([]), F(!0), L(null), z.current = [], H.current = !1, V.current = void 0, W.current += 1, B.current.clear()), m(() => {
 		K();
-	}, [K]), h(() => {
-		B.current = N;
-	}, [N]);
-	let J = m(() => {
+	}, [K]), m(() => {
+		z.current = M;
+	}, [M]);
+	let J = p(() => {
 		K(!0);
-	}, [K]), Y = g(() => N.filter((e) => e.isActive && e.steps?.length > 0 && a(e, {
-		productId: D,
-		moduleId: j,
-		pageId: M
+	}, [K]), Y = h(() => M.filter((e) => o(e, T)), [M, T]), X = h(() => Y.filter((e) => e.isActive && e.steps?.length > 0 && s(e, {
+		productId: E,
+		moduleId: A,
+		pageId: j
 	})).sort((e, t) => (t.priority ?? 0) - (e.priority ?? 0)), [
-		N,
+		Y,
+		A,
 		j,
-		M,
-		D
-	]), X = g(() => z ? Y.find((e) => e.triggerType === "AUTO_FIRST_VISIT" || e.triggerType === "AUTO_ALWAYS") ?? null : null, [Y, z]), { trackProgress: Z, recordStepCompletion: Q, trackEvent: $ } = te({
-		globalClient: w,
-		userId: E?.id,
-		productSlug: D,
-		moduleId: j,
-		pageId: M,
-		workspaceId: k,
-		setAllTours: P,
-		allToursRef: B,
-		progressMutationVersionRef: re,
-		latestProgressMutationByTourRef: ie
-	}), ae = g(() => ({
-		tours: N,
-		pageTours: Y,
-		loading: F,
-		error: L,
+		E
+	]), Z = h(() => R ? X.find((e) => e.triggerType === "AUTO_FIRST_VISIT" || e.triggerType === "AUTO_ALWAYS") ?? null : null, [X, R]), { trackProgress: Q, recordStepCompletion: $, trackEvent: ue } = re({
+		globalClient: S,
+		userId: w?.id,
+		productSlug: E,
+		moduleId: A,
+		pageId: j,
+		workspaceId: O,
+		setAllTours: N,
+		allToursRef: z,
+		progressMutationVersionRef: se,
+		latestProgressMutationByTourRef: B
+	}), de = h(() => ({
+		progressScopeKey: `${w?.id ?? ""}:${O ?? ""}`,
+		tours: Y,
+		pageTours: X,
+		loading: P,
+		error: I,
 		refetch: J,
-		trackProgress: Z,
-		recordStepCompletion: Q,
-		trackEvent: $,
-		autoStartTour: X,
-		productId: D,
-		moduleId: j,
-		pageId: M
+		trackProgress: Q,
+		recordStepCompletion: $,
+		trackEvent: ue,
+		autoStartTour: Z,
+		productId: E,
+		moduleId: A,
+		pageId: j
 	}), [
-		N,
-		X,
-		L,
-		F,
-		j,
-		M,
 		Y,
-		D,
-		Q,
-		J,
+		w?.id,
+		O,
+		Z,
+		I,
+		P,
+		A,
+		j,
+		X,
+		E,
 		$,
-		Z
+		J,
+		ue,
+		Q
 	]);
-	return /* @__PURE__ */ ne(b.Provider, {
-		value: ae,
-		children: f
+	return /* @__PURE__ */ ae(v.Provider, {
+		value: de,
+		children: ie
 	});
 }
-function S() {
-	let e = p(b);
+function b() {
+	let e = f(v);
 	if (!e) throw Error("useToursContext must be used within a ToursProvider");
 	return e;
 }
-function C() {
-	return p(b) || {
+function x() {
+	return f(v) || {
 		tours: [],
 		pageTours: [],
 		loading: !1,
@@ -183,8 +186,8 @@ function C() {
 		pageId: void 0
 	};
 }
-function w() {
-	let e = S();
+function S() {
+	let e = b();
 	return {
 		tours: e.pageTours,
 		loading: e.loading,
@@ -193,8 +196,8 @@ function w() {
 		trackProgress: e.trackProgress
 	};
 }
-function T() {
-	return S().autoStartTour;
+function C() {
+	return b().autoStartTour;
 }
 //#endregion
-export { x as ToursProvider, T as useAutoStartTour, C as useSafeToursContext, w as useTours, S as useToursContext };
+export { y as ToursProvider, C as useAutoStartTour, x as useSafeToursContext, S as useTours, b as useToursContext };

package/dist/shared/tours/permissions.d.ts

@@ -0,0 +1,9 @@
+import { Tour } from './types';
+interface TourPermissions {
+    isLoading: boolean;
+    hasPermission: (permission: string) => boolean;
+}
+/** Tour targeting is guidance; the gateway still authorizes every product action. */
+export declare function isTourAllowedByPermissions(tour: Pick<Tour, 'triggerConfig'>, permissions: TourPermissions | null): boolean;
+export {};
+//# sourceMappingURL=permissions.d.ts.map

package/dist/shared/tours/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,UAAU,eAAe;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;CAChD;AAED,qFAAqF;AACrF,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EACjC,WAAW,EAAE,eAAe,GAAG,IAAI,GAClC,OAAO,CAYT"}

package/dist/shared/tours/permissions.js

@@ -0,0 +1,7 @@
+//#region src/shared/tours/permissions.ts
+function e(e, t) {
+	let n = e.triggerConfig?.requiredPermissions;
+	return n === void 0 ? !0 : !Array.isArray(n) || n.some((e) => typeof e != "string" || !e.trim()) ? !1 : n.length === 0 ? !0 : !t || t.isLoading ? !1 : n.every((e) => t.hasPermission(e));
+}
+//#endregion
+export { e as isTourAllowedByPermissions };

package/dist/shared/tours/progress.d.ts

@@ -1,7 +1,12 @@
-import { TourUserStatus, TourUserProgressSummary } from './types';
+import { TourStep, TourUserStatus, TourUserProgressSummary } from './types';
 export interface TourProgressCarrier {
     id: string;
     myProgress?: TourUserProgressSummary | null;
 }
 export declare function withTourProgressStatus<T extends TourProgressCarrier>(tours: readonly T[], tourId: string, status: TourUserStatus): T[];
+/** Resume only an unfinished tour, using persisted step IDs that still exist. */
+export declare function tourResumeStepIndex(tour: {
+    steps: readonly Pick<TourStep, 'id'>[];
+    myProgress?: TourUserProgressSummary | null;
+}): number;
 //# sourceMappingURL=progress.d.ts.map

package/dist/shared/tours/progress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC7C;AAED,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,mBAAmB,EAClE,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACrB,CAAC,EAAE,CAYL"}
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEjF,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC7C;AAED,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,mBAAmB,EAClE,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACrB,CAAC,EAAE,CAkBL;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,EAAE,SAAS,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;IACvC,UAAU,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC7C,GAAG,MAAM,CAQT"}

package/dist/shared/tours/progress.js

@@ -3,10 +3,20 @@ function e(e, t, n) {
 	return e.map((e) => e.id === t ? {
 		...e,
 		myProgress: {
+			...e.myProgress,
+			...n === "IN_PROGRESS" && e.myProgress?.status !== "IN_PROGRESS" ? {
+				completedSteps: [],
+				currentStepId: null
+			} : {},
 			id: e.myProgress?.id ?? `optimistic-${t}`,
 			status: n
 		}
 	} : e);
 }
+function t(e) {
+	if (e.myProgress?.status !== "IN_PROGRESS") return 0;
+	let t = e.myProgress.completedSteps, n = new Set(Array.isArray(t) ? t.filter((e) => typeof e == "string") : []), r = e.steps.findIndex((e) => !n.has(e.id));
+	return Math.max(0, r);
+}
 //#endregion
-export { e as withTourProgressStatus };
+export { t as tourResumeStepIndex, e as withTourProgressStatus };