writetrack 0.11.0 → 0.12.0

package/dist/esm/index.d.ts

@@ -1,8 +1,8 @@
 import { K as KeystrokeEvent, C as ClipboardEvent, U as UndoRedoEvent, S as SelectionEvent, P as ProgrammaticInsertionEvent, a as CompositionEvent, I as InputSource, W as WriteTrackDataSchema } from './index-Cy91q_po.js';
 export { D as DataQualityMetrics, M as ModifierState, b as SessionMetadata } from './index-Cy91q_po.js';
 import { W as WriteTrackSink } from './types-B8bNI9P5.js';
-import { S as SessionAnalysis, a as SessionReport, I as IndicatorOutput } from './analysis-types-Cg3hzXZX.js';
-export { C as ContentOriginAnalysis, e as PhaseTransition, P as PhysicalPlausibilityAnalysis, R as RevisionBehaviorAnalysis, b as SessionContinuityAnalysis, c as TemporalPatternsAnalysis, T as TimingAuthenticityAnalysis, f as WindowFeatures, W as WritingProcessAnalysis, d as WritingProcessSegment } from './analysis-types-Cg3hzXZX.js';
+import { S as SessionAnalysis, a as SessionReport, I as IndicatorOutput } from './analysis-types-CRB59-1F.js';
+export { A as ActiveTimeResult, g as ActiveTimeWindow, C as ContentOriginAnalysis, e as PhaseTransition, P as PhysicalPlausibilityAnalysis, R as RevisionBehaviorAnalysis, b as SessionContinuityAnalysis, c as TemporalPatternsAnalysis, T as TimingAuthenticityAnalysis, f as WindowFeatures, W as WritingProcessAnalysis, d as WritingProcessSegment } from './analysis-types-CRB59-1F.js';
 export { DatadogClient, DatadogOptions, OTelSpan, OTelTracer, OpenTelemetryOptions, SegmentClient, SegmentOptions, WebhookOptions, datadog, opentelemetry, segment, webhook } from './pipes.js';
 
 interface PersistedSessionInfo {
@@ -282,7 +282,7 @@ declare class WriteTrack {
 
 /** Extract session duration in milliseconds. */
 declare function getSessionDurationMs(analysis: SessionAnalysis): number;
-/** Compute characters-per-minute and words-per-minute from keydown count and session duration. */
+/** Compute characters-per-minute and words-per-minute from keydown count and active duration. */
 declare function getTypingSpeed(analysis: SessionAnalysis): {
     cpm: number;
     wpm: number;
@@ -348,4 +348,69 @@ declare function createSessionReport(rawData: unknown, options?: AnalyzeEventsOp
  */
 declare function getHighResolutionTime(): number;
 
-export { type AnalyzeEventsOptions, ClipboardEvent, CompositionEvent, IndicatorOutput, InputSource, KeystrokeEvent, type PersistedSessionInfo, ProgrammaticInsertionEvent, SelectionEvent, SessionAnalysis, SessionReport, UndoRedoEvent, WriteTrack, WriteTrackDataSchema, type WriteTrackOptions, WriteTrackSink, analyzeEvents, createSessionReport, WriteTrack as default, formatIndicator, getContentOriginBreakdown, getHighResolutionTime, getSessionDurationMs, getTypingSpeed };
+/**
+ * Data passed to the `onTick` callback in all editor bindings.
+ * The core `tick` event emits `{ activeTime, totalTime }` — bindings
+ * wrap it to include the `tracker` instance for convenience.
+ */
+interface OnTickData {
+    activeTime: number;
+    totalTime: number;
+    tracker: WriteTrack;
+}
+/**
+ * Common options shared by all editor binding option interfaces.
+ * Each binding extends this with any binding-specific options.
+ */
+interface BaseBindingOptions {
+    /** WriteTrack license key */
+    license?: string;
+    /** User identifier included in metadata */
+    userId?: string;
+    /** Content identifier included in metadata */
+    contentId?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Auto-start tracking when the editor is ready (default: true) */
+    autoStart?: boolean;
+    /** URL to the WASM binary for analysis. If omitted, uses default loader path. */
+    wasmUrl?: string;
+    /** Enable IndexedDB session persistence and auto-resume. Requires contentId. */
+    persist?: boolean;
+    /** Callback invoked on each tick with activeTime, totalTime, and the tracker instance. */
+    onTick?: (data: OnTickData) => void;
+    /** Callback invoked when the tracker is created and ready (persistence loaded if applicable). */
+    onReady?: (tracker: WriteTrack) => void;
+}
+
+interface ControllerState {
+    tracker: WriteTrack | null;
+    isReady: boolean;
+    isTracking: boolean;
+    analysis: SessionAnalysis | null;
+    error: Error | null;
+}
+interface ControllerOptions {
+    writeTrackOptions: Omit<WriteTrackOptions, 'target'>;
+    target: HTMLElement;
+    autoStart?: boolean;
+    analysis?: boolean;
+    onTick?: (data: OnTickData) => void;
+    onReady?: (tracker: WriteTrack) => void;
+    onStateChange: (state: ControllerState) => void;
+}
+declare class WriteTrackController {
+    private _state;
+    private _opts;
+    private _unsubs;
+    constructor(opts: ControllerOptions);
+    private _init;
+    private _notify;
+    getState(): ControllerState;
+    start(): void;
+    stop(): void;
+    destroy(): Promise<void>;
+    reset(target: HTMLElement, writeTrackOptions?: Omit<WriteTrackOptions, 'target'>): Promise<void>;
+}
+
+export { type AnalyzeEventsOptions, type BaseBindingOptions, ClipboardEvent, CompositionEvent, type ControllerOptions, type ControllerState, IndicatorOutput, InputSource, KeystrokeEvent, type OnTickData, type PersistedSessionInfo, ProgrammaticInsertionEvent, SelectionEvent, SessionAnalysis, SessionReport, UndoRedoEvent, WriteTrack, WriteTrackController, WriteTrackDataSchema, type WriteTrackOptions, WriteTrackSink, analyzeEvents, createSessionReport, WriteTrack as default, formatIndicator, getContentOriginBreakdown, getHighResolutionTime, getSessionDurationMs, getTypingSpeed };