@burdenoff/fe-libs 2026.1021.7 → 2026.1021.8

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

@@ -42,7 +42,9 @@ export { TourTooltip } from './TourTooltip';
 export { useTourPlayer } from './useTourPlayer';
 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 { createTourPageIdResolver, getTourContextRank, getTourRouteCatalog, getTourRouteCatalogVersion, getTourRouteModules, getTourRoutePages, hasRegisteredTourRouteCatalog, isTourVisibleForContext, normalizeTourPath, registerTourRouteCatalog, resolveTourTargetPath, subscribeTourRouteCatalogs, } from './routeCatalog';
+export { useRegisterTourRouteCatalog, useTourRouteCatalog } from './useTourRouteCatalog';
+export { BIGCONSOLE_TOUR_ROUTE_CATALOG, BUILDMYIQ_TOUR_ROUTE_CATALOG, BUILT_IN_TOUR_ROUTE_CATALOGS, COLLABKIN_TOUR_ROUTE_CATALOG, FLUIDGRIDS_TOUR_ROUTE_CATALOG, getBuiltInTourRouteCatalog, INTELWATCHTOWER_TOUR_ROUTE_CATALOG, listBuiltInTourRouteCatalogProductIds, MANUFACTUREDOPS_TOUR_ROUTE_CATALOG, VIBECONTROLS_TOUR_ROUTE_CATALOG, } from './catalogs';
 export type { TourCurrentContext, TourContextTarget, TourRouteCatalogEntry, TourRouteModuleOption, TourRoutePageOption, } from './routeCatalog';
 export { withTourProgressStatus } from './progress';
 export type { TourProgressCarrier } from './progress';

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

@@ -6,6 +6,13 @@ export interface TourRouteCatalogEntry {
     pageLabel: string;
     path: string;
     isModuleHome?: boolean;
+    /**
+     * Other URLs that render this page, for `createTourPageIdResolver`. Each is a
+     * path prefix matched on segment boundaries; a `:name` segment matches any
+     * single segment. `path` itself always matches, so list only the extras
+     * (aliases, redirects, detail URLs outside `path`).
+     */
+    matchPaths?: readonly string[];
 }
 export interface TourRouteModuleOption {
     moduleId: string;
@@ -27,15 +34,36 @@ export interface TourCurrentContext {
     moduleId: string | null | undefined;
     pageId: string | null | undefined;
 }
+type TourRouteCatalogListener = () => void;
+/**
+ * Subscribes to catalog registrations and cleanups, for `useSyncExternalStore`.
+ * Returns the unsubscribe function.
+ */
+export declare function subscribeTourRouteCatalogs(listener: TourRouteCatalogListener): () => void;
+/** Changes whenever a catalog is registered or cleaned up. */
+export declare function getTourRouteCatalogVersion(): number;
 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;
+/** Whether a shell has registered a catalog for this product. */
+export declare function hasRegisteredTourRouteCatalog(productId: string | null | undefined): boolean;
 export declare function getTourRouteCatalog(productId: string | null | undefined): TourRouteCatalogEntry[];
+/**
+ * Builds a `tourPageIdFromPath` mapper (AppShellConfig) from a route catalog.
+ *
+ * A pathname maps to the pageId of the most specific entry whose `path` or one
+ * of whose `matchPaths` is a segment-wise prefix of it, so
+ * `/workflows/insights/errors` beats `/workflows/insights`, and
+ * `/workflows/listing` does not match `/workflows/list`. Unmatched paths return
+ * `undefined`, which keeps the shell's segment-based default.
+ */
+export declare function createTourPageIdResolver(entries: readonly TourRouteCatalogEntry[]): (pathname: string) => string | undefined;
 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;
+export {};