writetrack 0.9.1 → 0.10.0

package/dist/esm/verify.d.ts

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

package/dist/esm/viz.d.ts

@@ -1,5 +1,5 @@
 import { W as WriteTrackDataSchema } from './index-Cy91q_po.js';
-import { S as SessionAnalysis, a as SessionReport, d as IntegrityProof } from './analysis-types-B9TlyYRD.js';
+import { S as SessionAnalysis, a as SessionReport, d as IntegrityProof } from './analysis-types-DvrvSEh0.js';
 
 /**
  * BaseChart — abstract web component base class for WriteTrack visualizations.
@@ -16,10 +16,20 @@ declare abstract class BaseChart<T = unknown> extends HTMLElement {
     private _resizeObserver;
     private _resizeRaf;
     private _themeObserver;
-    private _initialResize;
+    private _lastWidth;
     private _rendered;
     private _internalTheme;
     static get observedAttributes(): string[];
+    /** Whether to render in compact/sparkline mode (no axes, tight margins). */
+    get compact(): boolean;
+    /** Get the chart width — reads --wt-chart-width CSS var (set by scorecard
+     *  bridge), then container/host clientWidth, then fallback. The CSS var
+     *  ensures the chart renders at the correct width even before layout. */
+    protected getChartWidth(fallback: number): number;
+    /** Get the chart height — reads --wt-chart-height CSS var, then explicit
+     *  inline height, then fallback. Avoids reading content-derived clientHeight
+     *  to prevent a resize feedback loop. */
+    protected getChartHeight(fallback: number): number;
     constructor();
     /** Override in subclasses to provide component-specific CSS */
     protected getStylesheet(): string;
@@ -100,34 +110,6 @@ declare class SpeedTimeline extends BaseChart<SessionAnalysis> {
     protected render(): void;
 }
 
-/**
- * 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. */
-declare function extractSegments(analysis: SessionAnalysis): SegmentDatum[];
-/** Extract paste event markers from analysis. */
-declare function extractPasteMarkers(analysis: SessionAnalysis): PasteDatum[];
-declare class CompositionTimeline extends BaseChart<SessionAnalysis> {
-    static tagName: string;
-    protected render(): void;
-}
-
 /**
  * RhythmHeatmap — dwell time vs flight time scatter plot.
  *
@@ -184,26 +166,47 @@ interface GrowthPoint {
 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;
 }
 
 /**
- * DocumentRibbon — keystroke ribbon colored by inter-key gap.
+ * EditBeeswarm — per-keystroke beeswarm visualization.
  *
- * Each bar represents one keystroke. Yellow = short gaps (fast), red = long gaps (slow).
+ * Each dot is a single edit action. Inserts, deletes, pastes, and cuts
+ * are color-coded and dodged vertically by time using Plot.dodgeY.
  * Consumes raw WriteTrackDataSchema (not WASM analysis output).
  */
 
-interface RibbonDatum {
-    start: number;
-    end: number;
-    flight: number;
+type BeeswarmType = 'insert' | 'delete' | 'paste' | 'cut';
+interface BeeswarmDatum {
+    time: number;
+    type: BeeswarmType;
+    chars: number;
+    key: string;
 }
-/** Extract ribbon data from raw keydown events. */
-declare function extractRibbonData(data: WriteTrackDataSchema): RibbonDatum[];
-declare class DocumentRibbon extends BaseChart<WriteTrackDataSchema> {
+/** Extract per-keystroke beeswarm data from raw session events. */
+declare function extractBeeswarmData(data: WriteTrackDataSchema): BeeswarmDatum[];
+declare class EditBeeswarm extends BaseChart<WriteTrackDataSchema> {
     static tagName: string;
+    static get observedAttributes(): string[];
+    /** Whether to render typed characters as letter glyphs instead of dots.
+     *  Internal/experimental — not part of the public API. */
+    get glyphs(): boolean;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     protected render(): void;
+    /** Compact render: binned data, no axes, no tooltips, tight margins. */
+    private renderCompact;
+    /** Dot marks for all event types (default mode). */
+    private buildDotMarks;
+    /** 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). */
+    private cropViewBox;
 }
 
 /**
@@ -243,23 +246,49 @@ interface BubbleDatum {
     time: number;
     chars: number;
     type: EditType;
-    size: number;
 }
 /** Group consecutive keystrokes into edit runs and add paste/cut events. */
 declare function extractCorrectionBubbles(data: WriteTrackDataSchema): BubbleDatum[];
 declare class CorrectionsBubble extends BaseChart<WriteTrackDataSchema> {
     static tagName: string;
     protected render(): void;
+    /** Compact render: 2 lanes if no clipboard events, time-binned if clipboard present. */
+    private renderCompact;
+}
+
+/**
+ * OriginBar — content origin proportion as a horizontal stacked bar.
+ *
+ * Shows typed / pasted / autocompleted as percentages of all content created.
+ */
+
+interface OriginDatum {
+    category: 'origin';
+    segment: string;
+    value: number;
+}
+interface OriginBarColors {
+    typed: string;
+    pasted: string;
+    autocompleted: string;
+}
+/** 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 class WtOriginBar extends BaseChart<SessionAnalysis> {
+    static tagName: string;
+    protected render(): void;
 }
 
 declare class WtScorecard extends BaseChart<SessionReport> {
     static tagName: string;
-    private _activeDetail;
-    constructor();
+    static get observedAttributes(): string[];
+    private _activeCategory;
     /**
      * Override onResize to only re-render charts instead of full re-render.
-     * A full re-render replaces container content → changes height →
-     * triggers ResizeObserver again → infinite loop.
+     * A full re-render replaces container content -> changes height ->
+     * triggers ResizeObserver again -> infinite loop.
      */
     protected onResize(): void;
     protected getStylesheet(): string;
@@ -267,30 +296,27 @@ declare class WtScorecard extends BaseChart<SessionReport> {
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     protected render(): void;
     private buildHeader;
-    private buildSummary;
-    private buildTierLabel;
+    private buildFlags;
+    private buildIntegrityDetails;
     private buildGrid;
     private buildCell;
     private buildCellMetrics;
     private buildDetailPanel;
     private selectCell;
+    private populateAndRenderDetail;
     private populateDetail;
-    private closeDetail;
-    private expandPanel;
-    private collapsePanel;
     private getIndicatorCode;
     private getComputedColors;
-    private getChartWidth;
-    private plotOpts;
-    private plotCategory;
+    /** Render the origin proportion bar into #origin-bar if it exists and data is available. */
+    private renderOriginBarIfPresent;
+    /**
+     * Create a standalone chart component.
+     * Returns { el, init } — append el to DOM first, then call init()
+     * so the chart can measure its real container width.
+     */
+    private createDetailChart;
     private renderAllCharts;
     private rerenderAllCharts;
-    private plotContentOrigin;
-    private plotTimingAuthenticity;
-    private plotRevisionBehavior;
-    private plotSessionContinuity;
-    private plotPhysicalPlausibility;
-    private plotTemporalPatterns;
 }
 
 interface IntegrityFooterData {
@@ -316,8 +342,8 @@ declare function isPass(code: string): boolean;
 declare function getStatus(code: string | undefined): 'pass' | 'flag' | 'unknown';
 /** Display names for SessionAnalysis category fields. */
 declare const CATEGORY_NAMES: Record<string, string>;
-/** All 6 analysis category keys in display order. */
-declare const CATEGORY_KEYS: readonly ["contentOrigin", "timingAuthenticity", "revisionBehavior", "sessionContinuity", "physicalPlausibility", "temporalPatterns"];
+/** All 7 analysis category keys in display order. */
+declare const CATEGORY_KEYS: readonly ["contentOrigin", "timingAuthenticity", "revisionBehavior", "sessionContinuity", "physicalPlausibility", "temporalPatterns", "writingProcess"];
 type CategoryKey = (typeof CATEGORY_KEYS)[number];
 /** Tier 1 categories are expanded by default. */
 declare const TIER1_CATEGORIES: CategoryKey[];
@@ -359,4 +385,36 @@ declare const GLOSSARY: Record<string, GlossaryEntry>;
  */
 declare function wrapTerms(text: string, baseUrl?: string): string;
 
-export { BaseChart, type BubbleDatum, CATEGORY_NAMES, type CategoryKey, CompositionTimeline, CorrectionsBubble, DocumentGrowth, DocumentRibbon, type EditType, EditWaterfall, GLOSSARY, type GlossaryEntry, type GrowthPoint, IntegrityFooter, type PasteDatum, type PauseBin, PauseDistribution, RhythmHeatmap, type RhythmPoint, type RibbonDatum, SEGMENT_COLORS, type ScorecardMetric, type SegmentDatum, Sparkline, type SpeedPoint, SpeedTimeline, TIER1_CATEGORIES, TIER2_CATEGORIES, type WaterfallData, type WaterfallPoint, WtScorecard, extractCorrectionBubbles, extractGrowthData, extractPasteMarkers, extractPauseHistogram, extractRhythmPairs, extractRibbonData, extractSegments, extractSeries, extractSpeedData, extractWaterfallData, formatDuration, generateCaption, generateSummary, getMetrics, getStatus, isPass, wrapTerms };
+/**
+ * StatBadge — compact pill/lozenge badges for at-a-glance session stats.
+ *
+ * Renders a row of inline badges with label + color-coded value.
+ */
+
+type BadgeData = SessionAnalysis;
+type BadgeStatus = 'clear' | 'flag' | 'neutral';
+interface StatBadge {
+    label: string;
+    value: string;
+    status: BadgeStatus;
+    metric: string;
+}
+/** Extract headline stat badges from analysis data. */
+declare function extractStatBadges(analysis: SessionAnalysis): StatBadge[];
+/** Render a row of stat badge pills as a DOM element. */
+declare function renderStatBadges(badges: StatBadge[]): HTMLElement;
+declare class WtBadge extends BaseChart<BadgeData> {
+    static tagName: string;
+    static get observedAttributes(): string[];
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    protected getStylesheet(): string;
+    protected render(): void;
+}
+
+/**
+ * Generate a plain-English summary of a writing session from analysis data.
+ * Returns null if there is insufficient data to summarise.
+ */
+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 };