writetrack 0.10.3 → 0.12.0

package/dist/esm/pipes.d.ts

@@ -1,12 +1,5 @@
-import { W as WriteTrackDataSchema } from './index-Cy91q_po.js';
-
-/**
- * A WriteTrack output sink receives session data when a session ends.
- */
-interface WriteTrackSink {
-    /** Send session data to the destination. */
-    send(data: WriteTrackDataSchema): Promise<void>;
-}
+import { W as WriteTrackSink } from './types-B8bNI9P5.js';
+import './index-Cy91q_po.js';
 
 interface WebhookOptions {
     /** URL to POST session data to */
@@ -110,4 +103,4 @@ interface OpenTelemetryOptions {
  */
 declare function opentelemetry(options: OpenTelemetryOptions): WriteTrackSink;
 
-export { type DatadogClient, type DatadogOptions, type OTelSpan, type OTelTracer, type OpenTelemetryOptions, type SegmentClient, type SegmentOptions, type WebhookOptions, type WriteTrackSink, datadog, opentelemetry, segment, webhook };
+export { type DatadogClient, type DatadogOptions, type OTelSpan, type OTelTracer, type OpenTelemetryOptions, type SegmentClient, type SegmentOptions, type WebhookOptions, WriteTrackSink, datadog, opentelemetry, segment, webhook };

package/dist/esm/pipes.js

@@ -1 +1 @@
-function p(n){let{url:o,headers:i={},retries:t=0,backoffMs:e=100,maxBackoffMs:a=3e4,keepalive:c=!1}=n;return{async send(f){let u=null;for(let s=0;s<=t;s++){if(s>0){let r=Math.min(e*Math.pow(2,s-1),a);await new Promise(l=>setTimeout(l,r))}try{let r=await fetch(o,{method:"POST",headers:{"Content-Type":"application/json",...i},body:JSON.stringify(f),keepalive:c});if(r.ok)return;u=new Error(`Webhook failed: ${r.status} ${r.statusText}`)}catch(r){u=r instanceof Error?r:new Error(String(r))}}throw u}}}function m(n){return n instanceof Error?n.message:String(n)}function d(n){let{client:o,actionName:i="writetrack_session",tags:t={}}=n;return{async send(e){let a={...t,duration:e.metadata.duration,keystrokeCount:e.session.events.length,qualityLevel:e.quality.qualityLevel,targetElement:e.metadata.targetElement,schemaVersion:e.version};e.metadata.userId&&(a.userId=e.metadata.userId),e.metadata.contentId&&(a.contentId=e.metadata.contentId),e.metadata.custom&&(a.custom=e.metadata.custom);try{o.addAction(i,a)}catch(c){throw new Error(`Datadog addAction failed: ${m(c)}`)}}}}function g(n){let{client:o,eventName:i="WriteTrack Session"}=n;return{async send(t){let e={duration:t.metadata.duration,keystrokeCount:t.session.events.length,qualityLevel:t.quality.qualityLevel,targetElement:t.metadata.targetElement,schemaVersion:t.version};t.metadata.userId&&(e.userId=t.metadata.userId),t.metadata.contentId&&(e.contentId=t.metadata.contentId),t.metadata.custom&&(e.custom=t.metadata.custom),o.track(i,e)}}}function v(n){let{tracer:o,spanName:i="writetrack.session"}=n;return{async send(t){let e=o.startSpan(i);try{e.setAttribute("writetrack.duration",t.metadata.duration),e.setAttribute("writetrack.keystroke_count",t.session.events.length),e.setAttribute("writetrack.quality_level",t.quality.qualityLevel),e.setAttribute("writetrack.target_element",t.metadata.targetElement),e.setAttribute("writetrack.schema_version",t.version),t.metadata.userId&&e.setAttribute("writetrack.user_id",t.metadata.userId),t.metadata.contentId&&e.setAttribute("writetrack.content_id",t.metadata.contentId),e.setStatus({code:1})}finally{e.end()}}}}export{d as datadog,v as opentelemetry,g as segment,p as webhook};
+function p(r){let{url:i,headers:a={},retries:t=0,backoffMs:e=100,maxBackoffMs:o=3e4,keepalive:u=!1}=r;return{async send(f){let m=null;for(let s=0;s<=t;s++){if(s>0){let n=Math.min(e*Math.pow(2,s-1),o);await new Promise(l=>setTimeout(l,n))}try{let n=await fetch(i,{method:"POST",headers:{"Content-Type":"application/json",...a},body:JSON.stringify(f),keepalive:u});if(n.ok)return;m=new Error(`Webhook failed: ${n.status} ${n.statusText}`)}catch(n){m=n instanceof Error?n:new Error(String(n))}}throw m}}}function c(r){return r instanceof Error?r.message:String(r)}function d(r){let{client:i,actionName:a="writetrack_session",tags:t={}}=r;return{async send(e){let o={...t,duration:e.metadata.duration,keystrokeCount:e.session.events.length,qualityLevel:e.quality.qualityLevel,targetElement:e.metadata.targetElement,schemaVersion:e.version};e.metadata.userId&&(o.userId=e.metadata.userId),e.metadata.contentId&&(o.contentId=e.metadata.contentId),e.metadata.custom&&(o.custom=e.metadata.custom);try{i.addAction(a,o)}catch(u){throw new Error(`Datadog addAction failed: ${c(u)}`)}}}}function g(r){let{client:i,eventName:a="WriteTrack Session"}=r;return{async send(t){let e={duration:t.metadata.duration,keystrokeCount:t.session.events.length,qualityLevel:t.quality.qualityLevel,targetElement:t.metadata.targetElement,schemaVersion:t.version};t.metadata.userId&&(e.userId=t.metadata.userId),t.metadata.contentId&&(e.contentId=t.metadata.contentId),t.metadata.custom&&(e.custom=t.metadata.custom);try{i.track(a,e)}catch(o){throw new Error(`Segment track failed: ${c(o)}`)}}}}function v(r){let{tracer:i,spanName:a="writetrack.session"}=r;return{async send(t){let e=i.startSpan(a);try{e.setAttribute("writetrack.duration",t.metadata.duration),e.setAttribute("writetrack.keystroke_count",t.session.events.length),e.setAttribute("writetrack.quality_level",t.quality.qualityLevel),e.setAttribute("writetrack.target_element",t.metadata.targetElement),e.setAttribute("writetrack.schema_version",t.version),t.metadata.userId&&e.setAttribute("writetrack.user_id",t.metadata.userId),t.metadata.contentId&&e.setAttribute("writetrack.content_id",t.metadata.contentId),t.metadata.custom&&e.setAttribute("writetrack.custom",JSON.stringify(t.metadata.custom)),e.setStatus({code:1})}finally{e.end()}}}}export{d as datadog,v as opentelemetry,g as segment,p as webhook};

package/dist/esm/testing.d.ts

@@ -0,0 +1,61 @@
+import { S as SessionAnalysis, a as SessionReport } from './analysis-types-CRB59-1F.js';
+import { W as WriteTrackDataSchema } from './index-Cy91q_po.js';
+import { W as WriteTrackSink } from './types-B8bNI9P5.js';
+
+/**
+ * WriteTrack Test Utilities
+ *
+ * Framework-agnostic factories for creating mock WriteTrack instances
+ * and SessionAnalysis objects in consumer tests.
+ *
+ * @example
+ * ```ts
+ * import { createMockAnalysis, createMockTracker } from 'writetrack/testing';
+ *
+ * const analysis = createMockAnalysis({ keydownCount: 500 });
+ * const tracker = createMockTracker({ analysis });
+ * ```
+ */
+
+/** Recursively makes all properties of T optional. */
+type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+/**
+ * Create a complete SessionAnalysis with sensible defaults.
+ * Accepts deep partial overrides that are merged into the defaults.
+ */
+declare function createMockAnalysis(overrides?: DeepPartial<SessionAnalysis>): SessionAnalysis;
+/** Options for configuring the mock tracker. */
+interface MockTrackerOptions {
+    /** Analysis returned by getAnalysis(). Defaults to a mock analysis. */
+    analysis?: SessionAnalysis | null;
+    /** Partial data merged into the default getData() return value. */
+    data?: DeepPartial<WriteTrackDataSchema>;
+}
+/** The mock tracker interface returned by createMockTracker(). */
+interface MockWriteTrack {
+    getData(): WriteTrackDataSchema;
+    getAnalysis(): Promise<SessionAnalysis | null>;
+    getSessionReport(): Promise<SessionReport>;
+    getText(): string;
+    on(event: string, handler: (...args: unknown[]) => void): () => void;
+    off(event: string, handler: (...args: unknown[]) => void): void;
+    removeAllListeners(event?: string): void;
+    pipe(sink: WriteTrackSink): MockWriteTrack;
+    start(): void;
+    stop(): void;
+    stopAndWait(): Promise<void>;
+    ready: Promise<void>;
+    /** Test-only: fire an event to all registered handlers. */
+    emit(event: string, ...args: unknown[]): void;
+}
+/**
+ * Create a mock object that satisfies the WriteTrack public interface.
+ *
+ * The mock is test-framework-agnostic (no vitest/jest spies).
+ * Use `emit(event, data)` to fire events to registered handlers.
+ */
+declare function createMockTracker(options?: MockTrackerOptions): MockWriteTrack;
+
+export { type DeepPartial, type MockTrackerOptions, type MockWriteTrack, createMockAnalysis, createMockTracker };

package/dist/esm/testing.js

@@ -0,0 +1 @@
+function d(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function c(e,u){let a={...e},i=u;for(let o of Object.keys(i)){let t=i[o],n=a[o];d(t)&&d(n)?a[o]=c(n,t):t!==void 0&&(a[o]=t)}return a}function m(){return{version:"1.0.0",locale:"en",analyzedAt:17e11,sufficientData:!0,keydownCount:420,integrity:{algorithm:"SHA-256",checkpoints:[],finalDigest:"mock-digest-0000",eventCount:450},sessionTimeline:[],initialTextLength:0,initialTextHash:"",finalTextLength:350,finalTextHash:"mock-final-hash",contentOrigin:{indicator:{code:"WT-104",params:{}},pasteReworkIndicator:{code:"WT-104",params:{}},metrics:{charactersByOrigin:{typed:.92,pasted:.06,autocompleted:.02},pasteEvents:[],pasteClassification:{internalPasteRatio:0,externalPasteRatio:.06,unknownPasteRatio:0},pasteEditSummary:{pasteRetentionRate:0,meanModificationDelayMs:0,pasteToTypeRatio:.065,meanReworkRatio:0,pasteLengthMean:0,pasteLengthStd:0,pasteLengthMin:0,pasteLengthMax:0},contentTimeline:{timestamps:[],series:{}}}},timingAuthenticity:{indicator:{code:"WT-204",params:{}},metrics:{dwellTimeDistribution:{mean:85,cv:.35,histogram:[]},flightTimeDistribution:{mean:110,cv:.4,histogram:[]},periodicityScore:.08,entropy:3.8,timingOverTime:{timestamps:[],series:{}}}},sessionContinuity:{indicator:{code:"WT-302",params:{}},metrics:{changePoints:[],tabAwayEvents:[],segmentComparison:{timestamps:[],series:{}},activeTime:{activeDurationMs:3e5,idleDurationMs:0,activeWindows:[],thinkingPauseCount:0,idleBreakCount:0}}},physicalPlausibility:{indicator:{code:"WT-403",params:{}},metrics:{impossibleSequences:{count:0,timeline:{timestamps:[],values:[]},samples:[]},syntheticEventRatio:0,mouseActivityDuringTyping:{periodsWithMouseActivity:.3,longestGapWithoutMouse:12e3},zeroLatencyEventCount:0,unmatchedKeydownCount:2,bulkInsertCharCount:0,modifierEventCount:18,uncoveredCaseCount:0,modifierLateralBalance:.8,modifierCoverage:1,modifierSustainCount:4,nonStandardKeys:[]}},revisionBehavior:{indicator:{code:"WT-503",params:{}},metrics:{correctionRate:.04,correctionCount:17,navigationCount:8,undoRedoCount:2,editPatterns:[],correctionTimeline:{timestamps:[],values:[]},revisionDepth:{maxDepth:3,avgDepth:1.2,regionsRevisedMultipleTimes:2},proportionBehindFrontier:.12,substitutedWordsCount:3,jumpToEditFrequency:.4,jumpDistanceSd:25,revisionAtPriorRatio:.08,revisionAtFrontierRatio:.92,insertionDeletion:{insertionCount:12,totalInsertionChars:380,insertionLengthMean:31.7,insertionLengthMedian:18,deletionCount:8,totalDeletionChars:45,deletionLengthMean:5.6,appendToInsertionRatio:.75},productProcessRatio:.85,pauseLocation:{beforeSentence:{count:5,meanDuration:2800},beforeWord:{count:12,meanDuration:800},withinWord:{count:3,meanDuration:350},afterWord:{count:8,meanDuration:600},betweenWords:{count:15,meanDuration:450}},proportionEventsAfterLastChar:.78,proportionCharsInMultiWordInsert:.04}},temporalPatterns:{indicator:{code:"WT-603",params:{}},metrics:{sessionDurationMs:3e5,speedTimeline:{timestamps:[],values:[]},fatigueRatio:.88,warmupRatio:1.15,pauseDistribution:{histogram:[],count:14,meanDuration:1800},burstPattern:{avgBurstLength:6,avgBurstSpeed:65,burstToTotalRatio:.35,burstDurationSd:480,burstDurationCv:.45},pause200ms:{count:45,meanDuration:350,sdDuration:120,pauseRate:.15},pause2000ms:{count:8,meanDuration:3200,sdDuration:900,pauseRate:.027},shortToLongPauseRatio:5.6,fluencySd5seg:12.5,fluencySd10seg:18.3,burstClassification:{pBurstCount:22,pBurstMedianDuration:4500,rBurstCount:15,rBurstMedianDuration:1200,pToRRatio:1.47}}},writingProcess:{indicator:{code:"WT-700",params:{}},metrics:{segments:[],transitions:[],timeInPhase:{planning:.15,drafting:.7,revision:.15},phaseChangeCount:8,windowDurationMs:3e4,phaseTimeline:{timestamps:[],values:[]}}},activeTime:{activeDurationMs:3e5,idleDurationMs:0,activeWindows:[],thinkingPauseCount:0,idleBreakCount:0},outputSignature:"mock-signature"}}function p(e){return e?c(m(),e):m()}function l(){return{version:"2.0.0",metadata:{tool:{name:"writetrack",version:"0.0.0-mock"},targetElement:"div",timestamp:new Date().toISOString(),duration:0,sessionId:"mock-session-id"},session:{events:[],rawText:"",sessionStartTime:0,sessionEndTime:0},quality:{overallScore:1,completeness:1,sequenceValid:!0,timingValid:!0,sessionDuration:0,eventCount:0,qualityLevel:"GOOD",issues:[],validatedAt:new Date().toISOString()}}}function g(e){let u=(e==null?void 0:e.analysis)!==void 0?e.analysis:p(),a=e!=null&&e.data?c(l(),e.data):l(),i={},o={getData(){return a},getAnalysis(){return Promise.resolve(u)},async getSessionReport(){return{data:a,analysis:u}},getText(){return a.session.rawText??""},on(t,n){return i[t]||(i[t]=[]),i[t].push(n),()=>{let s=i[t];if(s){let r=s.indexOf(n);r!==-1&&s.splice(r,1)}}},off(t,n){let s=i[t];if(s){let r=s.indexOf(n);r!==-1&&s.splice(r,1)}},removeAllListeners(t){if(t)delete i[t];else for(let n of Object.keys(i))delete i[n]},pipe(t){return o},start(){},stop(){},async stopAndWait(){},ready:Promise.resolve(),emit(t,...n){let s=i[t];if(s)for(let r of[...s])r(...n)}};return o}export{p as createMockAnalysis,g as createMockTracker};

package/dist/esm/verify.d.ts

@@ -1,4 +1,4 @@
-import { S as SessionAnalysis } from './analysis-types-Cg3hzXZX.js';
+import { S as SessionAnalysis } from './analysis-types-CRB59-1F.js';
 import './index-Cy91q_po.js';
 
 /**

package/dist/esm/viz.d.ts

@@ -1,5 +1,10 @@
 import { W as WriteTrackDataSchema } from './index-Cy91q_po.js';
-import { S as SessionAnalysis, a as SessionReport, g as IntegrityProof } from './analysis-types-Cg3hzXZX.js';
+import { S as SessionAnalysis, a as SessionReport, h as IntegrityProof } from './analysis-types-CRB59-1F.js';
+
+interface ActiveTimeWindow {
+    startMs: number;
+    endMs: number;
+}
 
 /**
  * BaseChart — abstract web component base class for WriteTrack visualizations.
@@ -7,18 +12,21 @@ import { S as SessionAnalysis, a as SessionReport, g as IntegrityProof } from '.
  * Handles Shadow DOM creation, CSS token injection, data management,
  * resize observation, and provides an abstract render() hook for subclasses.
  */
+
 declare abstract class BaseChart<T = unknown> extends HTMLElement {
     /** Override in subclasses to set the custom element tag name */
     static tagName: string;
     protected shadow: ShadowRoot;
     protected container: HTMLDivElement;
     protected _data: T | null;
+    protected _activeWindows: ActiveTimeWindow[];
     private _resizeObserver;
     private _resizeRaf;
     private _themeObserver;
     private _lastWidth;
     private _rendered;
     private _internalTheme;
+    private _skipTransition;
     static get observedAttributes(): string[];
     /** Whether to render in compact/sparkline mode (no axes, tight margins). */
     get compact(): boolean;
@@ -36,6 +44,8 @@ declare abstract class BaseChart<T = unknown> extends HTMLElement {
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null): void;
+    /** Set active time windows for idle-gap collapse on the time axis. */
+    setActiveWindows(windows: ActiveTimeWindow[]): void;
     /** Set session data and trigger a render */
     setData(data: T): void;
     /** Get the current data */
@@ -52,7 +62,7 @@ declare abstract class BaseChart<T = unknown> extends HTMLElement {
     /** Called on container resize. Override in subclasses that shouldn't full re-render. */
     protected onResize(): void;
     /** Wrap render() in try/catch so subclasses don't need individual error handling */
-    private safeRender;
+    protected safeRender(): void;
     /** Subclasses implement this to draw their visualization */
     protected abstract render(): void;
     /** Register the custom element if not already defined */
@@ -104,8 +114,9 @@ interface SpeedPoint {
     time: number;
     speed: number;
 }
-/** Extract speed timeline data from analysis, converting ms to seconds. */
-declare function extractSpeedData(analysis: SessionAnalysis): SpeedPoint[];
+/** Extract speed timeline data from analysis, converting ms to seconds.
+ *  When activeWindows are provided, idle gaps are collapsed. */
+declare function extractSpeedData(analysis: SessionAnalysis, activeWindows?: ActiveTimeWindow[]): SpeedPoint[];
 declare class SpeedTimeline extends BaseChart<SessionAnalysis> {
     static tagName: string;
     protected render(): void;
@@ -148,32 +159,6 @@ declare class PauseDistribution extends BaseChart<SessionAnalysis> {
     protected render(): void;
 }
 
-/**
- * DocumentGrowth — cumulative character count over time.
- *
- * Vertical jumps indicate paste/cut events. Slope indicates typing speed.
- * Consumes raw WriteTrackDataSchema (not WASM analysis output).
- */
-
-interface GrowthPoint {
-    time: number;
-    chars: number;
-    isPaste: boolean;
-    isCut: boolean;
-    pasteLength?: number;
-    cutLength?: number;
-}
-/** Extract cumulative character growth from raw events. */
-declare function extractGrowthData(data: WriteTrackDataSchema): GrowthPoint[];
-declare class DocumentGrowth extends BaseChart<WriteTrackDataSchema> {
-    static tagName: string;
-    /** Optional change point time (seconds) — renders as a dashed vertical rule. */
-    private _changePointTime;
-    /** Set a change point time (in seconds) to display as a vertical marker. */
-    setChangePoint(timeSec: number | null): void;
-    protected render(): void;
-}
-
 /**
  * EditBeeswarm — per-keystroke beeswarm visualization.
  *
@@ -190,7 +175,7 @@ interface BeeswarmDatum {
     key: string;
 }
 /** Extract per-keystroke beeswarm data from raw session events. */
-declare function extractBeeswarmData(data: WriteTrackDataSchema): BeeswarmDatum[];
+declare function extractBeeswarmData(data: WriteTrackDataSchema, activeWindows?: ActiveTimeWindow[]): BeeswarmDatum[];
 declare class EditBeeswarm extends BaseChart<WriteTrackDataSchema> {
     static tagName: string;
     static get observedAttributes(): string[];
@@ -206,7 +191,7 @@ declare class EditBeeswarm extends BaseChart<WriteTrackDataSchema> {
     /** Glyph marks: single text mark so everything dodges together.
      *  Typed chars as letters, deletes as ×, pastes as 📋, cuts as ✂. */
     private buildGlyphMarks;
-    /** Crop the SVG viewBox top to fit content, preserving the bottom (axis). */
+    /** Crop the SVG viewBox bottom to fit content, preserving the top (axis). */
     private cropViewBox;
 }
 
@@ -228,7 +213,7 @@ interface WaterfallData {
     cuts: WaterfallPoint[];
 }
 /** Extract cursor position data from raw events. */
-declare function extractWaterfallData(data: WriteTrackDataSchema): WaterfallData;
+declare function extractWaterfallData(data: WriteTrackDataSchema, activeWindows?: ActiveTimeWindow[]): WaterfallData;
 declare class EditWaterfall extends BaseChart<WriteTrackDataSchema> {
     static tagName: string;
     protected render(): void;
@@ -249,7 +234,7 @@ interface BubbleDatum {
     type: EditType;
 }
 /** Group consecutive keystrokes into edit runs and add paste/cut events. */
-declare function extractCorrectionBubbles(data: WriteTrackDataSchema): BubbleDatum[];
+declare function extractCorrectionBubbles(data: WriteTrackDataSchema, activeWindows?: ActiveTimeWindow[]): BubbleDatum[];
 declare class CorrectionsBubble extends BaseChart<WriteTrackDataSchema> {
     static tagName: string;
     protected render(): void;
@@ -276,12 +261,54 @@ interface OriginBarColors {
 /** Extract origin proportions from analysis, filtering out 0% segments. */
 declare function extractOriginData(analysis: SessionAnalysis): OriginDatum[];
 /** Render a horizontal stacked bar showing content origin proportions. */
-declare function renderOriginBar(data: OriginDatum[], width: number, colors?: OriginBarColors): SVGSVGElement | null;
+declare function renderOriginBar(data: OriginDatum[], width: number, colors?: OriginBarColors, textColors?: Partial<OriginBarColors>): SVGSVGElement | null;
 declare class WtOriginBar extends BaseChart<SessionAnalysis> {
     static tagName: string;
     protected render(): void;
 }
 
+/**
+ * Session scorecard web component.
+ *
+ * Renders a full-page analysis report with header, stat badges, narrative summary,
+ * origin bar, 6-cell analysis grid, and detail panels with embedded charts.
+ *
+ * @element wt-scorecard
+ *
+ * @attr {string} theme - Color theme: `"light"` or `"dark"`. Overrides ancestor `data-theme` and `prefers-color-scheme`.
+ * @attr {boolean} share - Show share button and make QR code clickable.
+ * @attr {boolean} download - Show download button.
+ * @attr {string} data - JSON-serialized `SessionReport`. Alternative to calling `setData()`.
+ * @attr {boolean} compact - Compact rendering mode (inherited from BaseChart).
+ * @attr {string} label - Custom `aria-label` for accessibility (inherited from BaseChart).
+ *
+ * @fires wt-share - When the share button or QR code is clicked. Detail: `{ report: SessionReport }`.
+ * @fires wt-download - When the download button is clicked. Detail: `{ report: SessionReport }`.
+ * @fires wt-render - When render completes (inherited from BaseChart).
+ *
+ * @csspart page - The root container element.
+ *
+ * @cssprop [--wt-scorecard-bg] - Main background color.
+ * @cssprop [--wt-scorecard-bg-card] - Cell card background color.
+ * @cssprop [--wt-scorecard-bg-card-hover] - Card hover state color.
+ * @cssprop [--wt-scorecard-bg-card-flagged] - Flagged cell background color.
+ * @cssprop [--wt-scorecard-bg-detail] - Detail panel background color.
+ * @cssprop [--wt-scorecard-text] - Primary text color.
+ * @cssprop [--wt-scorecard-text-secondary] - Secondary text color.
+ * @cssprop [--wt-scorecard-text-tertiary] - Tertiary/muted text color.
+ * @cssprop [--wt-scorecard-border] - Border color.
+ * @cssprop [--wt-scorecard-border-heavy] - Heavy border color.
+ * @cssprop [--wt-scorecard-status-clear] - Pass/clear status color.
+ * @cssprop [--wt-scorecard-status-flagged] - Flagged/fail status color.
+ * @cssprop [--wt-scorecard-chart-line] - Chart line color.
+ * @cssprop [--wt-scorecard-chart-accent] - Chart accent color.
+ * @cssprop [--wt-scorecard-chart-flagged] - Chart flagged color.
+ * @cssprop [--wt-scorecard-chart-tertiary] - Chart tertiary color.
+ * @cssprop [--wt-scorecard-chart-cyan] - Chart cyan (paste) color.
+ * @cssprop [--wt-scorecard-font-display] - Display font (titles, headers).
+ * @cssprop [--wt-scorecard-font-body] - Body text font.
+ * @cssprop [--wt-scorecard-font-data] - Data/code font.
+ */
 declare class WtScorecard extends BaseChart<SessionReport> {
     static tagName: string;
     static get observedAttributes(): string[];
@@ -295,7 +322,21 @@ declare class WtScorecard extends BaseChart<SessionReport> {
     protected getStylesheet(): string;
     /** Override to handle theme changes without full re-render. */
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    connectedCallback(): void;
     protected render(): void;
+    /**
+     * Update existing DOM in place without tearing it down. Called on
+     * subsequent setData() calls after the initial render. Updates:
+     * badges, narrative, grid cell metrics/status, flags, charts, origin bar.
+     */
+    private updateInPlace;
+    /**
+     * Update existing chart elements with new data instead of recreating them.
+     * Falls back to full re-render for charts that don't exist yet.
+     */
+    private updateChartsInPlace;
+    /** Feed new data to an existing chart element based on its category. */
+    private feedChartData;
     private buildHeader;
     private buildFlags;
     private buildIntegrityDetails;
@@ -369,7 +410,7 @@ interface ScorecardMetric {
  * directly available and diagnostically meaningful for automation detection.
  */
 declare function getMetrics(category: string, analysis: SessionAnalysis): ScorecardMetric[];
-/** Format milliseconds to human-readable duration. */
+/** Format milliseconds to human-readable duration (e.g. "2h 3m", "3d 2h"). */
 declare function formatDuration(ms: number): string;
 
 interface GlossaryEntry {
@@ -418,4 +459,83 @@ declare class WtBadge extends BaseChart<BadgeData> {
  */
 declare function generateWritingSummary(analysis: SessionAnalysis): string | null;
 
-export { type BadgeData, type BadgeStatus, BaseChart, type BeeswarmDatum, type BeeswarmType, type BubbleDatum, CATEGORY_NAMES, type CategoryKey, CorrectionsBubble, DocumentGrowth, EditBeeswarm, type EditType, EditWaterfall, GLOSSARY, type GlossaryEntry, type GrowthPoint, IntegrityFooter, type OriginBarColors, type OriginDatum, type PauseBin, PauseDistribution, RhythmHeatmap, type RhythmPoint, type ScorecardMetric, Sparkline, type SpeedPoint, SpeedTimeline, type StatBadge, TIER1_CATEGORIES, TIER2_CATEGORIES, type WaterfallData, type WaterfallPoint, WtBadge, WtOriginBar, WtScorecard, extractBeeswarmData, extractCorrectionBubbles, extractGrowthData, extractOriginData, extractPauseHistogram, extractRhythmPairs, extractSeries, extractSpeedData, extractStatBadges, extractWaterfallData, formatDuration, generateCaption, generateSummary, generateWritingSummary, getMetrics, getStatus, isPass, renderOriginBar, renderStatBadges, wrapTerms };
+/**
+ * CompositionTimeline — session activity segments over time.
+ *
+ * Shows typing/paste/pause/tabAway segments as colored horizontal bars
+ * and paste events as dots scaled by character count.
+ */
+
+declare const SEGMENT_COLORS: Record<string, string>;
+interface SegmentDatum {
+    start: number;
+    end: number;
+    type: string;
+    color: string;
+}
+interface PasteDatum {
+    time: number;
+    chars: number;
+    source: string;
+}
+/** Extract activity segments from analysis, converting ms to seconds.
+ *  When activeWindows are provided, idle gaps are collapsed. */
+declare function extractSegments(analysis: SessionAnalysis, activeWindows?: ActiveTimeWindow[]): SegmentDatum[];
+/** Extract paste event markers from analysis. */
+declare function extractPasteMarkers(analysis: SessionAnalysis, activeWindows?: ActiveTimeWindow[]): PasteDatum[];
+/** Extract only tab-away segments (for mode="focus" rendering). */
+declare function extractFocusSegments(analysis: SessionAnalysis, activeWindows?: ActiveTimeWindow[]): SegmentDatum[];
+declare class CompositionTimeline extends BaseChart<SessionAnalysis> {
+    static tagName: string;
+    static get observedAttributes(): string[];
+    get mode(): string;
+    protected render(): void;
+    private _renderFocus;
+}
+
+/**
+ * DocumentGrowth — writing process chart.
+ *
+ * By default shows net document length (product) over time as a line + area fill.
+ * Opt-in attributes enable additional series:
+ *   process  — cumulative total input activity (always increasing)
+ *   cursor   — cursor position in the document over time
+ *   pauses   — orange dots sized by inter-keystroke gap duration
+ *
+ * Consumes raw WriteTrackDataSchema (not WASM analysis output).
+ */
+
+interface ProcessPoint {
+    time: number;
+    process: number;
+    product: number;
+    cursor: number;
+}
+interface PauseDot {
+    time: number;
+    product: number;
+    pauseMs: number;
+}
+interface ProcessGraphData {
+    points: ProcessPoint[];
+    pauses: PauseDot[];
+}
+/** Extract process/product data from raw keystroke events. */
+declare function extractProcessData(data: WriteTrackDataSchema, minPauseMs?: number, activeWindows?: ActiveTimeWindow[]): ProcessGraphData;
+declare class DocumentGrowth extends BaseChart<WriteTrackDataSchema> {
+    static tagName: string;
+    private _changePointTime;
+    /** Set a change point time (in seconds) to display as a vertical marker. */
+    setChangePoint(timeSec: number | null): void;
+    static get observedAttributes(): string[];
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    protected render(): void;
+}
+/** @deprecated Use DocumentGrowth */
+declare const ProcessGraph: typeof DocumentGrowth;
+/** @deprecated Use extractProcessData */
+declare const extractGrowthData: typeof extractProcessData;
+/** @deprecated Use ProcessPoint */
+type GrowthPoint = ProcessPoint;
+
+export { type BadgeData, type BadgeStatus, BaseChart, type BeeswarmDatum, type BeeswarmType, type BubbleDatum, CATEGORY_NAMES, type CategoryKey, CompositionTimeline, CorrectionsBubble, DocumentGrowth, EditBeeswarm, type EditType, EditWaterfall, GLOSSARY, type GlossaryEntry, type GrowthPoint, IntegrityFooter, type OriginBarColors, type OriginDatum, type PasteDatum, type PauseBin, PauseDistribution, type PauseDot, ProcessGraph, type ProcessGraphData, type ProcessPoint, RhythmHeatmap, type RhythmPoint, SEGMENT_COLORS, type ScorecardMetric, type SegmentDatum, Sparkline, type SpeedPoint, SpeedTimeline, type StatBadge, TIER1_CATEGORIES, TIER2_CATEGORIES, type WaterfallData, type WaterfallPoint, WtBadge, WtOriginBar, WtScorecard, extractBeeswarmData, extractCorrectionBubbles, extractFocusSegments, extractGrowthData, extractOriginData, extractPasteMarkers, extractPauseHistogram, extractProcessData, extractRhythmPairs, extractSegments, extractSeries, extractSpeedData, extractStatBadges, extractWaterfallData, formatDuration, generateCaption, generateSummary, generateWritingSummary, getMetrics, getStatus, isPass, renderOriginBar, renderStatBadges, wrapTerms };