@trailguide/core 0.0.3 → 0.1.0

package/dist/analytics.d.ts

@@ -1,5 +1,5 @@
 import type { AnalyticsConfig } from './types';
-export type AnalyticsEventType = 'trail_started' | 'step_viewed' | 'step_completed' | 'trail_completed' | 'trail_skipped';
+export type AnalyticsEventType = 'trail_started' | 'step_viewed' | 'step_completed' | 'trail_completed' | 'trail_skipped' | 'trail_abandoned';
 export interface AnalyticsEvent {
     event_type: AnalyticsEventType;
     trail_id: string;

package/dist/analytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,aAAa,GACb,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAiBD,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC,CAAC;AAGjG,wBAAsB,SAAS,CAC7B,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAGD,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,aAAa,GACb,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,GACf,iBAAiB,CAAC;AAEtB,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAiBD,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC,CAAC;AAGjG,wBAAsB,SAAS,CAC7B,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAGD,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

package/dist/index.d.ts

@@ -5,5 +5,6 @@ export type { AnalyticsEvent, AnalyticsEventType, } from './analytics';
 export { findElement, isElementVisible, scrollToElement, } from './dom';
 export { theme } from './theme';
 export { validateTrail, logValidationResults, } from './validate';
+export { tourStorage } from './storage';
 export type { ValidationResult, ValidationError, ValidationWarning, } from './validate';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzE,YAAY,EACV,KAAK,EACL,IAAI,EACJ,SAAS,EACT,iBAAiB,EACjB,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,cAAc,EACd,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,eAAe,GAChB,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,OAAO,EACL,aAAa,EACb,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzE,YAAY,EACV,KAAK,EACL,IAAI,EACJ,SAAS,EACT,iBAAiB,EACjB,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,cAAc,EACd,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,eAAe,GAChB,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,OAAO,EACL,aAAa,EACb,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/storage.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Utilities for persisting tour state across page loads.
+ * Used internally by useTrailManager and available for custom integrations.
+ */
+export declare const tourStorage: {
+    /** Returns true if the user has completed or skipped this tour */
+    hasCompleted(trailId: string): boolean;
+    /** Marks the tour as completed so it won't auto-show again */
+    markCompleted(trailId: string): void;
+    /** Returns the last step index the user reached, or null if no progress saved */
+    getProgress(trailId: string): number | null;
+    /** Saves the user's current step so they can resume later */
+    saveProgress(trailId: string, stepIndex: number): void;
+    /** Clears saved progress (but keeps the completion flag) */
+    clearProgress(trailId: string): void;
+    /** Clears both completion and progress state for this tour */
+    reset(trailId: string): void;
+    /** Clears all Trailguide state from localStorage */
+    resetAll(): void;
+};
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,eAAO,MAAM,WAAW;IACtB,kEAAkE;0BAC5C,MAAM,GAAG,OAAO;IAItC,8DAA8D;2BACvC,MAAM,GAAG,IAAI;IAIpC,iFAAiF;yBAC5D,MAAM,GAAG,MAAM,GAAG,IAAI;IAO3C,6DAA6D;0BACvC,MAAM,aAAa,MAAM,GAAG,IAAI;IAItD,4DAA4D;2BACrC,MAAM,GAAG,IAAI;IAIpC,8DAA8D;mBAC/C,MAAM,GAAG,IAAI;IAM5B,oDAAoD;gBACxC,IAAI;CAUjB,CAAC"}

package/dist/trailguide.d.ts

@@ -10,6 +10,7 @@ export declare class Trailguide {
     private cleanupFns;
     private stepCleanupFns;
     private instanceId;
+    private stepTimerId;
     constructor(options?: TrailguideOptions);
     start(trail: Trail): void;
     stop(): void;

package/dist/trailguide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trailguide.d.ts","sourceRoot":"","sources":["../src/trailguide.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAQ,iBAAiB,EAAa,MAAM,SAAS,CAAC;AAIzE,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAyB;IAGxC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAA4B;IAG3C,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,UAAU,CAAwE;gBAE9E,OAAO,GAAE,iBAAsB;IAI3C,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAUzB,IAAI,IAAI,IAAI;IAKZ,IAAI,IAAI,IAAI;IAcZ,IAAI,IAAI,IAAI;IASZ,IAAI,IAAI,IAAI;IAOZ,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ7B,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,aAAa;IAoDrB,OAAO,CAAC,QAAQ;IAuChB,OAAO,CAAC,cAAc;IAoCtB,OAAO,CAAC,eAAe;YAkDT,aAAa;IA0C3B,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,aAAa;CAetB;AAKD,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAO3E;AAED,wBAAgB,IAAI,IAAI,IAAI,CAG3B;AAED,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED,wBAAgB,IAAI,IAAI,IAAI,CAG3B"}
+{"version":3,"file":"trailguide.d.ts","sourceRoot":"","sources":["../src/trailguide.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAQ,iBAAiB,EAAa,MAAM,SAAS,CAAC;AAIzE,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAyB;IAGxC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAA4B;IAG3C,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,UAAU,CAAwE;IAG1F,OAAO,CAAC,WAAW,CAA8C;gBAErD,OAAO,GAAE,iBAAsB;IAI3C,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAUzB,IAAI,IAAI,IAAI;IAWZ,IAAI,IAAI,IAAI;IAaZ,IAAI,IAAI,IAAI;IASZ,IAAI,IAAI,IAAI;IAOZ,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ7B,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,aAAa;IA+CrB,OAAO,CAAC,QAAQ;IA2DhB,OAAO,CAAC,cAAc;IAiCtB,OAAO,CAAC,eAAe;YA+CT,aAAa;IA0C3B,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,aAAa;CAetB;AAKD,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAO3E;AAED,wBAAgB,IAAI,IAAI,IAAI,CAG3B;AAED,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED,wBAAgB,IAAI,IAAI,IAAI,CAG3B"}