@burdenoff/fe-libs 2026.514.2 → 2026.516.2

package/dist/shared/tours/ToursContext.js

@@ -6,12 +6,14 @@ import { useAppShell as r } from "../providers/shell/AppShellContext.js";
 import { useLogger as i } from "../logger/useLogger.js";
 import "../../shared-logger.js";
 import { detectDeviceType as a } from "./types.js";
-import { createContext as o, useCallback as s, useContext as c, useEffect as l, useMemo as u, useRef as d, useState as f } from "react";
-import { jsx as p } from "react/jsx-runtime";
-import { gql as m } from "@apollo/client/core";
-import { useLocation as h } from "react-router-dom";
+import { isTourVisibleForContext as o } from "./routeCatalog.js";
+import { withTourProgressStatus as s } from "./progress.js";
+import { createContext as c, useCallback as l, useContext as u, useEffect as d, useMemo as f, useRef as p, useState as m } from "react";
+import { jsx as ee } from "react/jsx-runtime";
+import { gql as h } from "@apollo/client/core";
+import { useLocation as te } from "react-router-dom";
 //#region src/shared/tours/ToursContext.tsx
-var g = m`
+var g = h`
   fragment ToursCoreFields on Tour {
     id
     context {
@@ -33,7 +35,7 @@ var g = m`
     priority
     displayOrder
   }
-`, _ = m`
+`, _ = h`
   fragment ToursStepFields on Tour {
     steps {
       id
@@ -69,7 +71,7 @@ var g = m`
       }
     }
   }
-`, v = m`
+`, v = h`
   ${g}
   ${_}
   query GetToursForContext($context: TourContextInput!) {
@@ -82,7 +84,7 @@ var g = m`
       ...ToursStepFields
     }
   }
-`, y = m`
+`, y = h`
   ${g}
   ${_}
   query GetToursForContextFallback($context: TourContextInput!) {
@@ -96,7 +98,7 @@ function b(e) {
 	let t = e instanceof Error || typeof e == "object" && e && "message" in e && typeof e.message == "string" ? e.message : "";
 	return t.includes("myProgress") ? t.includes("Cannot query field") || t.includes("Unknown field") : !1;
 }
-var x = m`
+var ne = h`
   mutation StartTour($tourId: ID!, $userId: ID!, $deviceType: DeviceType) {
     startTour(tourId: $tourId, userId: $userId, deviceType: $deviceType) {
       id
@@ -110,7 +112,7 @@ var x = m`
       lastViewedAt
     }
   }
-`, S = m`
+`, re = h`
   mutation CompleteTour($tourId: ID!, $userId: ID!) {
     completeTour(tourId: $tourId, userId: $userId) {
       id
@@ -124,7 +126,7 @@ var x = m`
       lastViewedAt
     }
   }
-`, ee = m`
+`, ie = h`
   mutation SkipTour($tourId: ID!, $userId: ID!) {
     skipTour(tourId: $tourId, userId: $userId) {
       id
@@ -138,7 +140,7 @@ var x = m`
       lastViewedAt
     }
   }
-`, te = m`
+`, ae = h`
   mutation CompleteStep($tourId: ID!, $stepId: ID!, $userId: ID!) {
     completeStep(tourId: $tourId, stepId: $stepId, userId: $userId) {
       id
@@ -152,7 +154,7 @@ var x = m`
       lastViewedAt
     }
   }
-`, ne = m`
+`, oe = h`
   mutation TrackTourEvent($input: RecordTourAnalyticsInput!) {
     trackTourEvent(input: $input) {
       id
@@ -163,26 +165,26 @@ var x = m`
       timestamp
     }
   }
-`, C = [
+`, x = [
 	"The client has been stopped",
 	"QueryManager stopped",
 	"This Apollo Client has been destroyed",
 	"aborted"
 ];
-function re(e) {
+function se(e) {
 	if (!(e instanceof Error)) return !1;
 	let t = e.message;
-	return e.name === "InvariantError" || t.startsWith("Invariant Violation") ? C.some((e) => t.includes(e)) : !1;
+	return e.name === "InvariantError" || t.startsWith("Invariant Violation") ? x.some((e) => t.includes(e)) : !1;
 }
-function w(e, t) {
+function S(e, t) {
 	let n = e.split("/").filter(Boolean);
 	return n.length === 0 ? t : n[0];
 }
-function T() {
+function C() {
 	let e = a();
 	return e === "mobile" ? "MOBILE" : e === "tablet" ? "TABLET" : "DESKTOP";
 }
-function E() {
+function ce() {
 	let e = "bf-tour-session-id";
 	try {
 		let t = sessionStorage.getItem(e);
@@ -193,8 +195,8 @@ function E() {
 		return `tour-session-${Date.now()}-${Math.random().toString(36).slice(2)}`;
 	}
 }
-function D(e, t, n, r) {
-	let i = e.split("/").filter(Boolean), a = r ? r(e) : w(e, n);
+function w(e, t, n, r) {
+	let i = e.split("/").filter(Boolean), a = r ? r(e) : S(e, n);
 	return i.length === 0 ? {
 		moduleId: t,
 		pageId: a
@@ -206,45 +208,45 @@ function D(e, t, n, r) {
 		pageId: a
 	};
 }
-var O = o(null);
-function k({ children: a, defaultPageId: o = "home", getPageIdFromPath: c, disabled: m = !1 }) {
-	let g = h(), _ = e("global"), { workspaceId: C } = n(), { user: w } = t(), { productSlug: k } = r(), A = i("ToursContext"), j = C ?? void 0, M = m || g.pathname.startsWith("/devportal"), { moduleId: N, pageId: P } = u(() => D(g.pathname, k, o, c), [
-		o,
+var T = c(null);
+function E({ children: a, defaultPageId: c = "home", getPageIdFromPath: u, disabled: h = !1 }) {
+	let g = te(), _ = e("global"), { workspaceId: x } = n(), { user: S } = t(), { productSlug: E } = r(), D = i("ToursContext"), O = x ?? void 0, k = h || g.pathname.startsWith("/devportal"), { moduleId: A, pageId: j } = f(() => w(g.pathname, E, c, u), [
 		c,
+		u,
 		g.pathname,
-		k
-	]), [F, I] = f([]), [L, R] = f(!1), [z, B] = f(null), V = d(void 0), H = d(!1), U = d(!0), W = d(0), G = d(!0);
-	l(() => (U.current = !0, () => {
+		E
+	]), [M, N] = m([]), [P, F] = m(!1), [I, L] = m(null), R = p([]), z = p(0), B = p(/* @__PURE__ */ new Map()), V = p(void 0), H = p(!1), U = p(!0), W = p(0), G = p(!0);
+	d(() => (U.current = !0, () => {
 		U.current = !1;
 	}), []);
-	let K = s(async (e = !1) => {
-		if (M) {
-			U.current && (I([]), R(!1), B(null));
+	let K = l(async (e = !1) => {
+		if (k) {
+			U.current && (N([]), F(!1), L(null));
 			return;
 		}
 		if (!_) return;
-		let t = A.child("fetch", {
-			productSlug: k,
-			moduleId: N,
-			pageId: P,
-			workspaceId: j
-		}), n = T(), r = [
-			k,
-			N,
-			P,
-			j,
+		let t = D.child("fetch", {
+			productSlug: E,
+			workspaceId: O,
+			moduleId: A,
+			pageId: j
+		}), n = C(), r = [
+			E,
+			A ?? "",
+			j ?? "",
+			O,
 			n,
-			w?.id ?? "anonymous"
+			S?.id ?? "anonymous"
 		].join("::");
 		if (!e && H.current && V.current === r) return;
-		U.current && (R(!0), B(null));
+		U.current && (F(!0), L(null));
 		let i = ++W.current;
 		try {
 			let e = { context: {
-				productId: k,
-				moduleId: N,
-				pageId: P,
-				workspaceId: j,
+				productId: E,
+				moduleId: A,
+				pageId: j,
+				workspaceId: O,
 				deviceType: n
 			} }, a = "network-only", o, s = G.current ? v : y;
 			try {
@@ -271,148 +273,178 @@ function k({ children: a, defaultPageId: o = "home", getPageIdFromPath: c, disab
 				else throw n;
 			}
 			let c = (o.data?.toursForContext ?? []).filter((e, t, n) => n.findIndex((t) => t.id === e.id) === t);
-			U.current && i === W.current && (I(c), V.current = r, H.current = !0);
+			U.current && i === W.current && (N(c), V.current = r, H.current = !0);
 		} catch (e) {
-			if (!U.current || i !== W.current || re(e)) return;
+			if (!U.current || i !== W.current || se(e)) return;
 			let n = e instanceof Error ? e : /* @__PURE__ */ Error("Failed to fetch tours");
-			t.error("Failed to fetch tours for context", n), B(n), I([]);
+			t.error("Failed to fetch tours for context", n), L(n), N([]);
 		} finally {
-			U.current && i === W.current && R(!1);
+			U.current && i === W.current && F(!1);
 		}
 	}, [
-		M,
+		k,
 		_,
+		D,
 		A,
-		N,
-		P,
-		k,
 		j,
-		w?.id
-	]), q = d(w?.id);
-	l(() => {
-		q.current !== w?.id && (q.current = w?.id, H.current = !1, V.current = void 0, U.current && I([]));
-	}, [w?.id]), l(() => {
+		E,
+		O,
+		S?.id
+	]), q = p(S?.id);
+	d(() => {
+		q.current !== S?.id && (q.current = S?.id, H.current = !1, V.current = void 0, U.current && N([]));
+	}, [S?.id]), d(() => {
 		K();
-	}, [K]);
-	let J = s(() => {
+	}, [K]), d(() => {
+		R.current = M;
+	}, [M]);
+	let J = l(() => {
 		K(!0);
-	}, [K]), Y = u(() => F.filter((e) => e.isActive && e.steps?.length > 0).sort((e, t) => (t.priority ?? 0) - (e.priority ?? 0)), [F]), X = u(() => Y.find((e) => e.triggerType === "AUTO_FIRST_VISIT" || e.triggerType === "AUTO_ALWAYS") ?? null, [Y]), Z = s(async (e, t, n) => {
-		if (!(!_ || !w?.id)) try {
+	}, [K]), Y = f(() => M.filter((e) => e.isActive && e.steps?.length > 0 && o(e, {
+		productId: E,
+		moduleId: A,
+		pageId: j
+	})).sort((e, t) => (t.priority ?? 0) - (e.priority ?? 0)), [
+		M,
+		A,
+		j,
+		E
+	]), X = f(() => Y.find((e) => e.triggerType === "AUTO_FIRST_VISIT" || e.triggerType === "AUTO_ALWAYS") ?? null, [Y]), Z = l(async (e, t, n) => {
+		if (!_ || !S?.id) return;
+		let r = t === "started" ? "IN_PROGRESS" : t === "completed" ? "COMPLETED" : "SKIPPED", i = R.current.find((t) => t.id === e)?.myProgress, a = z.current + 1;
+		z.current = a, B.current.set(e, a), N((t) => {
+			let n = s(t, e, r);
+			return R.current = n, n;
+		});
+		try {
 			if (t === "started") {
 				await _.mutate({
-					mutation: x,
+					mutation: ne,
 					variables: {
 						tourId: e,
-						userId: w.id,
-						deviceType: T()
+						userId: S.id,
+						deviceType: C()
 					}
 				});
 				return;
 			}
 			if (t === "completed") {
 				await _.mutate({
-					mutation: S,
+					mutation: re,
 					variables: {
 						tourId: e,
-						userId: w.id
+						userId: S.id
 					}
 				});
 				return;
 			}
 			await _.mutate({
-				mutation: ee,
+				mutation: ie,
 				variables: {
 					tourId: e,
-					userId: w.id
+					userId: S.id
 				}
 			});
-		} catch {}
-	}, [_, w?.id]), Q = s(async (e, t) => {
-		if (!(!_ || !w?.id || !t)) try {
+		} catch {
+			if (B.current.get(e) !== a) return;
+			N((t) => {
+				let n = t.map((t) => t.id === e ? {
+					...t,
+					myProgress: i
+				} : t);
+				return R.current = n, n;
+			});
+		} finally {
+			B.current.get(e) === a && B.current.delete(e);
+		}
+	}, [_, S?.id]), Q = l(async (e, t) => {
+		if (!(!_ || !S?.id || !t)) try {
 			await _.mutate({
-				mutation: te,
+				mutation: ae,
 				variables: {
 					tourId: e,
 					stepId: t,
-					userId: w.id
+					userId: S.id
 				}
 			});
 		} catch {}
-	}, [_, w?.id]), $ = s(async (e, t, n) => {
-		if (!(!_ || !w?.id)) try {
+	}, [_, S?.id]), $ = l(async (e, t, n) => {
+		if (!(!_ || !S?.id)) try {
 			await _.mutate({
-				mutation: ne,
+				mutation: oe,
 				variables: { input: {
 					tourId: t,
-					userId: w.id,
-					sessionId: E(),
+					userId: S.id,
+					sessionId: ce(),
 					eventType: e,
 					stepId: n?.stepId,
 					stepOrder: n?.stepOrder,
-					productId: k,
-					moduleId: N,
-					pageId: P,
-					deviceType: T(),
+					productId: E,
+					moduleId: A,
+					pageId: j,
+					deviceType: C(),
 					userAgent: typeof navigator < "u" ? navigator.userAgent : void 0,
 					duration: n?.duration,
 					metadata: n?.metadata,
-					context: j ? {
-						workspaceId: j,
-						productId: k,
-						moduleId: N,
-						pageId: P
+					context: O ? {
+						workspaceId: O,
+						productId: E,
+						moduleId: A,
+						pageId: j
 					} : {
-						productId: k,
-						moduleId: N,
-						pageId: P
+						productId: E,
+						moduleId: A,
+						pageId: j
 					}
 				} }
 			});
 		} catch {}
 	}, [
 		_,
-		N,
-		P,
-		k,
-		w?.id,
-		j
-	]), ie = u(() => ({
-		tours: F,
+		A,
+		j,
+		E,
+		S?.id,
+		O
+	]), le = f(() => ({
+		tours: M,
 		pageTours: Y,
-		loading: L,
-		error: z,
+		loading: P,
+		error: I,
 		refetch: J,
 		trackProgress: Z,
 		recordStepCompletion: Q,
 		trackEvent: $,
 		autoStartTour: X,
-		moduleId: N,
-		pageId: P
+		productId: E,
+		moduleId: A,
+		pageId: j
 	}), [
-		F,
+		M,
 		X,
-		z,
-		L,
-		N,
+		I,
 		P,
+		A,
+		j,
 		Y,
+		E,
 		Q,
 		J,
 		$,
 		Z
 	]);
-	return /* @__PURE__ */ p(O.Provider, {
-		value: ie,
+	return /* @__PURE__ */ ee(T.Provider, {
+		value: le,
 		children: a
 	});
 }
-function A() {
-	let e = c(O);
+function D() {
+	let e = u(T);
 	if (!e) throw Error("useToursContext must be used within a ToursProvider");
 	return e;
 }
-function j() {
-	return c(O) || {
+function O() {
+	return u(T) || {
 		tours: [],
 		pageTours: [],
 		loading: !1,
@@ -422,12 +454,13 @@ function j() {
 		recordStepCompletion: async () => {},
 		trackEvent: async () => {},
 		autoStartTour: null,
+		productId: void 0,
 		moduleId: void 0,
 		pageId: void 0
 	};
 }
-function M() {
-	let e = A();
+function k() {
+	let e = D();
 	return {
 		tours: e.pageTours,
 		loading: e.loading,
@@ -436,8 +469,8 @@ function M() {
 		trackProgress: e.trackProgress
 	};
 }
-function N() {
-	return A().autoStartTour;
+function A() {
+	return D().autoStartTour;
 }
 //#endregion
-export { k as ToursProvider, N as useAutoStartTour, j as useSafeToursContext, M as useTours, A as useToursContext };
+export { E as ToursProvider, A as useAutoStartTour, O as useSafeToursContext, k as useTours, D as useToursContext };

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

@@ -40,8 +40,12 @@ export { TourPlayer, usePlayTour, TourTriggerButton } from './TourPlayer';
 export { TourSpotlight } from './TourSpotlight';
 export { TourTooltip } from './TourTooltip';
 export { useTourPlayer } from './useTourPlayer';
-export type { Tour, TourStep, TourStepMedia, TourStatus, TourTriggerType, StepPlacement, MediaType, MediaPosition, DeviceType, TourPlayerState, TourPlayerActions, TourPlayerContextValue, TourPlayerProviderProps, TourTooltipProps, TourSpotlightProps, } from './types';
+export type { Tour, TourStep, TourStepMedia, TourStatus, TourUserStatus, TourUserProgressSummary, TourTriggerType, StepPlacement, MediaType, MediaPosition, DeviceType, TourPlayerState, TourPlayerActions, TourPlayerContextValue, TourPlayerProviderProps, TourTooltipProps, TourSpotlightProps, } from './types';
 export { getResponsiveSelector, detectDeviceType } from './types';
+export { getTourContextRank, getTourRouteCatalog, getTourRouteModules, getTourRoutePages, isTourVisibleForContext, normalizeTourPath, registerTourRouteCatalog, resolveTourTargetPath, } from './routeCatalog';
+export type { TourCurrentContext, TourContextTarget, TourRouteCatalogEntry, TourRouteModuleOption, TourRoutePageOption, } from './routeCatalog';
+export { withTourProgressStatus } from './progress';
+export type { TourProgressCarrier } from './progress';
 export { ToursProvider, useToursContext, useSafeToursContext, useTours, useAutoStartTour, } from './ToursContext';
 export type { ToursContextValue, ToursProviderProps } from './ToursContext';
 export { TourTrigger } from './TourTrigger';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAGH,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,YAAY,EACV,IAAI,EACJ,QAAQ,EACR,aAAa,EACb,UAAU,EACV,eAAe,EACf,aAAa,EACb,SAAS,EACT,aAAa,EACb,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGlE,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,QAAQ,EACR,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG5E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAGH,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,YAAY,EACV,IAAI,EACJ,QAAQ,EACR,aAAa,EACb,UAAU,EACV,cAAc,EACd,uBAAuB,EACvB,eAAe,EACf,aAAa,EACb,SAAS,EACT,aAAa,EACb,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGtD,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,QAAQ,EACR,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG5E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,7 @@
+import { 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[];
+//# sourceMappingURL=progress.d.ts.map

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

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

package/dist/shared/tours/progress.js

@@ -0,0 +1,12 @@
+//#region src/shared/tours/progress.ts
+function e(e, t, n) {
+	return e.map((e) => e.id === t ? {
+		...e,
+		myProgress: {
+			id: e.myProgress?.id ?? `optimistic-${t}`,
+			status: n
+		}
+	} : e);
+}
+//#endregion
+export { e as withTourProgressStatus };

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

@@ -0,0 +1,42 @@
+export interface TourRouteCatalogEntry {
+    productId: string;
+    moduleId: string;
+    moduleLabel: string;
+    pageId: string;
+    pageLabel: string;
+    path: string;
+    isModuleHome?: boolean;
+}
+export interface TourRouteModuleOption {
+    moduleId: string;
+    label: string;
+    path: string;
+}
+export interface TourRoutePageOption {
+    pageId: string;
+    label: string;
+    path: string;
+}
+export interface TourContextTarget {
+    productId?: string | null;
+    moduleId?: string | null;
+    pageId?: string | null;
+}
+export interface TourCurrentContext {
+    productId: string;
+    moduleId: string | null | undefined;
+    pageId: string | null | undefined;
+}
+export declare function normalizeTourPath(path: string): string;
+/**
+ * Registers an app-owned route catalog for a product. Call the returned cleanup
+ * function from the same React effect that registered it.
+ */
+export declare function registerTourRouteCatalog(productId: string | null | undefined, entries: readonly TourRouteCatalogEntry[]): () => void;
+export declare function getTourRouteCatalog(productId: string | null | undefined): TourRouteCatalogEntry[];
+export declare function getTourRouteModules(productId: string | null | undefined): TourRouteModuleOption[];
+export declare function getTourRoutePages(productId: string | null | undefined, moduleId: string | null | undefined): TourRoutePageOption[];
+export declare function resolveTourTargetPath(tour: TourContextTarget): string | undefined;
+export declare function isTourVisibleForContext(tour: TourContextTarget, context: TourCurrentContext): boolean;
+export declare function getTourContextRank(tour: TourContextTarget, context: TourCurrentContext): number;
+//# sourceMappingURL=routeCatalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routeCatalog.d.ts","sourceRoot":"","sources":["../../../src/shared/tours/routeCatalog.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACnC;AA6LD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,MAAM,IAAI,CAkCZ;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,qBAAqB,EAAE,CAQzB;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,qBAAqB,EAAE,CAezB;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,mBAAmB,EAAE,CAWvB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,GACtB,MAAM,GAAG,SAAS,CAyBpB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAyBT;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAKR"}