@bitcobblers/wod-wiki-lang 0.11.43 → 0.35.2115

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { IMetric, MetricContainer, MetricOrigin, MetricType, IDialect, ICodeStatement, DialectAnalysis, ParsedCodeStatement, IOutputStatement, OutputStatementType, BlockKey, ScriptBlock, FenceDialect, Segment, AnalyticsGroup, StoredOutputStatement, OutputStatement } from '@bitcobblers/wod-wiki-core';
 export { ParseError } from '@bitcobblers/wod-wiki-core';
 import { Tree } from '@lezer/common';
-import { W as WhiteboardScript, I as IScript, a as IEffortResolver, b as IEffortRegistry, E as EffortResolverOptions, c as IEffort, d as EffortResolutionOptions, R as ResolvedEffort, e as EffortRegistrySource, f as IRuntimeActionable, g as IEventBus, h as IRuntimeStack, i as IRuntimeClock, j as IJitCompiler, k as INowProvider, l as RuntimeStackOptions, m as RuntimeError, A as AnalyticsContext, n as IEvent, o as IRuntimeAction, O as OutputListener, U as Unsubscribe, p as IAnalyticsEngine, q as IRuntimeBlock, r as IBehaviorContext, B as BehaviorEventType, s as BehaviorEventListener, S as SubscribeOptions, t as Unsubscribe$1, u as OutputOptions, M as MemoryTag, v as IMemoryLocation, w as IRuntimeBehavior, x as IBlockContext, y as MetricVisibility, z as BlockLifecycleOptions, C as CompletionDecision, T as TimeSpan, D as IRuntimeMemory, F as TypedMemoryReference, G as MemorySearchCriteria, H as IMemoryReference, J as StackObserver, K as StackSnapshot, L as StackListener, N as MemoryTypeEnum, P as IAnchorValue, Q as ButtonConfig, V as IEventHandler, X as HandlerScope, Y as IScriptRuntime, Z as TestableBlockConfig, _ as IRuntimeOptions, $ as ScriptRuntime, a0 as EventHandlerOptions, a1 as EventCallback, a2 as TimerState, a3 as IRealtimeProcessor, a4 as ISummaryProcessor, a5 as ProjectionResult } from './browserRuntimeNow-je1Vb5bU.js';
-export { a6 as ButtonVariant, a7 as ButtonsState, a8 as ChildrenStatusState, a9 as CompletionState, aa as DEFAULT_RESOLVER_OPTIONS, ab as DEFAULT_RUNTIME_OPTIONS, ac as DISCIPLINE_FACTORS, ad as DisplayState, ae as EFFORT_DISCIPLINES, af as EFFORT_REGISTRY_ORIGINS, ag as EffortBaseAttributes, ah as EffortDerivation, ai as EffortDiscipline, aj as EffortResolvedFrom, ak as FenceDialect, al as FragmentDisplayState, am as FragmentState, an as IAnalyticsProcessorDescriptor, ao as INTENSITY_TIERS, ap as IntensityTier, aq as InterceptMode, ar as MemoryLocation, as as MemoryType, at as MemoryTypeMap, au as MemoryValueOf, av as RoundState, aw as RuntimeState, ax as ScriptRuntimeDependencies, ay as StackEvent, az as TimerDirection, aA as VISIBILITY_ICONS, aB as VISIBILITY_LABELS, aC as createBrowserRuntimeNow, aD as disciplineFactorFor, aE as filterTagsByVisibility, aF as frozenNow, aG as getMetricVisibility, aH as getRuntimeNowMs, aI as isEffortDiscipline, aJ as isFragmentTag, aK as wallClockNow } from './browserRuntimeNow-je1Vb5bU.js';
+import { W as WhiteboardScript, I as IEffortResolver, a as IEffortRegistry, E as EffortResolverOptions, b as IEffort, c as EffortResolutionOptions, R as ResolvedEffort, d as EffortRegistrySource, e as EffortStorageAdapter, f as IRuntimeActionable, g as IEventBus, h as IRuntimeStack, i as IRuntimeClock, j as IJitCompiler, k as INowProvider, l as RuntimeStackOptions, m as RuntimeError, A as AnalyticsContext, n as IEvent, o as IRuntimeAction, O as OutputListener, U as Unsubscribe, p as IAnalyticsEngine, q as IRuntimeBlock, r as IBehaviorContext, B as BehaviorEventType, s as BehaviorEventListener, S as SubscribeOptions, t as Unsubscribe$1, u as OutputOptions, M as MemoryTag, v as IMemoryLocation, w as IRuntimeBehavior, x as IBlockContext, y as MetricVisibility, z as BlockLifecycleOptions, C as CompletionDecision, T as TimeSpan, D as IRuntimeMemory, F as TypedMemoryReference, G as MemorySearchCriteria, H as IMemoryReference, J as RuntimeStackLogger, K as StackObserver, L as StackSnapshot, N as StackListener, P as MemoryTypeEnum, Q as IAnchorValue, V as ButtonConfig, X as IEventHandler, Y as HandlerScope, Z as IScriptRuntime, _ as TestableBlockConfig, $ as IRuntimeOptions, a0 as ScriptRuntime, a1 as EventHandlerOptions, a2 as EventCallback, a3 as TimerState, a4 as IRealtimeProcessor, a5 as ISummaryProcessor, a6 as ProjectionResult } from './browserRuntimeNow-CoR7dCNU.js';
+export { a7 as ButtonVariant, a8 as ButtonsState, a9 as ChildrenStatusState, aa as CompletionState, ab as DEFAULT_RESOLVER_OPTIONS, ac as DEFAULT_RUNTIME_OPTIONS, ad as DISCIPLINE_FACTORS, ae as DisplayState, af as EFFORT_DISCIPLINES, ag as EFFORT_REGISTRY_ORIGINS, ah as EffortBaseAttributes, ai as EffortDerivation, aj as EffortDiscipline, ak as EffortResolvedFrom, al as FenceDialect, am as FragmentDisplayState, an as FragmentState, ao as IAnalyticsProcessorDescriptor, ap as INTENSITY_TIERS, aq as IScript, ar as IntensityTier, as as InterceptMode, at as MemoryLocation, au as MemoryType, av as MemoryTypeMap, aw as MemoryValueOf, ax as RoundState, ay as RuntimeState, az as ScriptRuntimeDependencies, aA as StackEvent, aB as TimerDirection, aC as VISIBILITY_ICONS, aD as VISIBILITY_LABELS, aE as createBrowserRuntimeNow, aF as disciplineFactorFor, aG as filterTagsByVisibility, aH as frozenNow, aI as getMetricVisibility, aJ as getRuntimeNowMs, aK as isEffortDiscipline, aL as isFragmentTag, aM as wallClockNow } from './browserRuntimeNow-CoR7dCNU.js';
 import { LanguageSupport, LRLanguage } from '@codemirror/language';
 import { LRParser } from '@lezer/lr';
 
@@ -126,8 +126,8 @@ interface MetricBearing {
     rawMetrics?: IMetric[];
     metrics?: MetricContainer | IMetric[];
 }
-/** Create a single hint metric. */
-declare function hintMetric(hint: string, origin?: MetricOrigin): IMetric;
+/** Create a single hint metric. `icon` opts the hint into display: icon-only chip, hint text on hover. */
+declare function hintMetric(hint: string, origin?: MetricOrigin, icon?: string): IMetric;
 /**
  * Build (or extend) a {@link MetricContainer} of hint metrics from a list of
  * hint strings. Duplicate hint strings are collapsed.
@@ -587,7 +587,7 @@ interface SyntaxMeta {
     raw: string;
 }
 interface BasePrimitive {
-    kind: 'lap' | 'duration' | 'rounds' | 'action' | 'text' | 'heading' | 'quantity' | 'effort' | 'property' | 'metric_object';
+    kind: 'lap' | 'duration' | 'rounds' | 'round_scheme' | 'action' | 'text' | 'heading' | 'quantity' | 'effort' | 'property' | 'metric_object';
     raw: string;
     meta: SyntaxMeta;
 }
@@ -613,6 +613,15 @@ interface RoundsPrimitive extends BasePrimitive {
     sequence?: number[];
     label?: string;
 }
+/**
+ * Inline NxM rounds scheme — `5x5` or `5 x 5` — lexed as one token so a bare
+ * `x` inside effort words is never stolen. N rounds x M reps per round.
+ */
+interface RoundSchemePrimitive extends BasePrimitive {
+    kind: 'round_scheme';
+    rounds: number;
+    reps: number;
+}
 interface ActionPrimitive extends BasePrimitive {
     kind: 'action';
     hasColonPrefix: boolean;
@@ -645,7 +654,7 @@ interface PropertyPrimitive extends BasePrimitive {
     valueRaw: string;
     value: string | number | boolean | null;
 }
-type SyntaxPrimitive = LapPrimitive | DurationPrimitive | RoundsPrimitive | ActionPrimitive | TextPrimitive | HeadingPrimitive | QuantityPrimitive | EffortPrimitive | PropertyPrimitive | MetricObjectPrimitive;
+type SyntaxPrimitive = LapPrimitive | DurationPrimitive | RoundsPrimitive | RoundSchemePrimitive | ActionPrimitive | TextPrimitive | HeadingPrimitive | QuantityPrimitive | EffortPrimitive | PropertyPrimitive | MetricObjectPrimitive;
 interface SyntaxStatement {
     id: number;
     line: number;
@@ -690,8 +699,11 @@ type SourceInput = string | {
  * Extract statements WITHOUT running the Dialect Stack.
  *
  * Used by the parser test harness (which applies its own Dialect set) and by
- * any consumer that needs the raw classified statements before Dialect
+ * any consumer that needs the classified statements without Dialect
  * processing. Production consumers should use {@link extractStatements}.
+ *
+ * Inline rounds normalization still runs here so every parser entrypoint —
+ * with or without dialects — produces the same deterministic Statement tree.
  */
 declare function extractStatementsRaw(sourceOrTree: SourceInput, treeArg?: Tree): ICodeStatement[];
 /**
@@ -731,12 +743,12 @@ declare class MdTimerRuntime {
      *
      * @param sport - The block's `:sport` fence suffix (` ```log:climbing `).
      */
-    read(inputText: string, sport?: string): IScript;
+    read(inputText: string, sport?: string): WhiteboardScript;
     /**
      * Parse without running the Dialect Stack. Used by the parser test harness
      * which applies its own Dialect set. Production consumers should use {@link read}.
      */
-    readWithoutDialects(inputText: string): IScript;
+    readWithoutDialects(inputText: string): WhiteboardScript;
 }
 
 declare function createParser(): MdTimerRuntime;
@@ -791,14 +803,55 @@ declare class EffortResolver implements IEffortResolver {
 declare class InMemoryEffortRegistry implements IEffortRegistry {
     private efforts;
     private sourceFilter;
+    private initialized;
     constructor(sourceFilter?: EffortRegistrySource);
     /** Seed with bundled efforts */
     loadBundled(): Promise<void>;
+    isInitialized(): boolean;
     /** Seed with arbitrary efforts (useful for tests) */
     seed(efforts: readonly IEffort[]): void;
     /** Clear all efforts */
     clear(): void;
     resolve(slug: string): IEffort | null;
+    resolveByAlias(label: string): IEffort | null;
+    list(): readonly IEffort[];
+    listByOrigin(origin: EffortRegistrySource): readonly IEffort[];
+    upsert(effort: IEffort): Promise<void>;
+    delete(slug: string): Promise<void>;
+}
+
+interface CompositeEffortRegistryOptions {
+    /** Custom bundled efforts to seed the read-only tier (defaults to built-in bundled efforts). */
+    bundled?: Iterable<IEffort>;
+    /** Optional persistence adapter for user-defined efforts. */
+    storage?: EffortStorageAdapter;
+}
+/**
+ * Composite Effort Registry — Two-Tier Lookup
+ *
+ * 1. User tier: loaded from storage adapter into memory
+ * 2. Bundled tier: shipped as read-only seed
+ *
+ * Lookup order: user wins over bundled.
+ * All lookups are O(1) in-memory after initialization.
+ */
+declare class CompositeEffortRegistry implements IEffortRegistry {
+    private readonly userEfforts;
+    private readonly bundledEfforts;
+    private initialized;
+    private readonly initialBundled?;
+    private readonly storage?;
+    constructor(options?: CompositeEffortRegistryOptions);
+    /**
+     * Initialize the registry:
+     * 1. Load bundled efforts into memory
+     * 2. Load user efforts from storage adapter into memory
+     */
+    loadBundled(customBundled?: Iterable<IEffort>): Promise<void>;
+    /** True after loadBundled() has resolved */
+    isInitialized(): boolean;
+    resolve(slug: string): IEffort | null;
+    resolveByAlias(label: string): IEffort | null;
     list(): readonly IEffort[];
     listByOrigin(origin: EffortRegistrySource): readonly IEffort[];
     upsert(effort: IEffort): Promise<void>;
@@ -867,6 +920,18 @@ declare const bundledEfforts: readonly IEffort[];
 /** Number of bundled efforts */
 declare const BUNDLED_EFFORT_COUNT: number;
 
+/**
+ * Add an alias to an existing effort.
+ *
+ * If the effort is bundled, clones it into a user-tier override record with
+ * the same slug and derivation from the bundled parent, then adds the alias.
+ * If the effort is already a user record, appends the alias and updates it.
+ *
+ * Idempotent: if the alias is already present (by normalized comparison),
+ * returns the existing record without mutation.
+ */
+declare function addAliasToEffort(registry: IEffortRegistry, targetSlug: string, newAlias: string): Promise<IEffort>;
+
 /**
  * IRuntimeContext — what the execution world (actions, blocks, behaviors)
  * receives. The runtime's collaborators (the "bag") plus the verbs to enqueue
@@ -1105,6 +1170,9 @@ declare class OutputEmitter {
      * Reads the attached clock and stack count; only the block crosses the seam.
      */
     emitCompilerBlock(block: IRuntimeBlock): void;
+    /** Options-built outputs carry only sourceStatementId — copy the source
+     *  statement's line/text/dialect so persisted logs stay joinable by line. */
+    private _propagateSourceLine;
 }
 
 /**
@@ -1319,7 +1387,7 @@ declare class RuntimeBlock implements IRuntimeBlock {
     /**
      * Gets a specific behavior by type from the behaviors array.
      */
-    getBehavior<T extends IRuntimeBehavior>(behaviorType: new (...args: any[]) => T): T | undefined;
+    getBehavior<T extends IRuntimeBehavior>(behaviorType: new (...args: unknown[]) => T): T | undefined;
     /**
      * Emit a system output for next lifecycle event.
      * Called directly from next() to ensure accurate timing.
@@ -1467,6 +1535,7 @@ interface RuntimeLogEntry {
     data?: Record<string, unknown>;
 }
 declare class RuntimeLoggerImpl {
+    private readonly _console;
     private _enabled;
     private _history;
     private _maxHistory;
@@ -1501,8 +1570,19 @@ declare class RuntimeLoggerImpl {
      * Log action execution (verbose, under a group)
      */
     logAction(action: IRuntimeAction, depth: number): void;
+    /**
+     * General-purpose message log for runtime consumers.
+     * Gates on _enabled; writes to the console sink and history.
+     */
+    logMessage(level: LogLevel, category: string, message: string, data?: Record<string, unknown>): void;
+    /**
+     * Always-on variant of `logMessage`. Use sparingly for errors/warnings that
+     * must be visible even when debug logging is disabled.
+     */
+    logAlways(level: LogLevel, category: string, message: string, data?: Record<string, unknown>): void;
     private getBehaviorNames;
     private summarizeObject;
+    private styleFor;
     private addToHistory;
 }
 declare const RuntimeLogger: RuntimeLoggerImpl;
@@ -1568,6 +1648,8 @@ declare class RuntimeMemory implements IRuntimeMemory {
  */
 declare class RuntimeObservers {
     private readonly _stackObservers;
+    private readonly _logger?;
+    constructor(logger?: RuntimeStackLogger);
     /**
      * Subscribe to stack snapshots. The collaborator does NOT emit an
      * `'initial'` snapshot automatically — the calling adapter is
@@ -2231,6 +2313,15 @@ interface RepeaterConfig {
     addCompletion?: boolean;
 }
 
+/**
+ * Constructor capture for behavior lookups. `any[]` is the TS idiom that both
+ * accepts class constructors of any arity and infers the concrete behavior
+ * from the argument (callers read concrete members, e.g.
+ * ChildrenStrategy accesses `countdown.config`); `unknown[]` would lose that
+ * inference. The storage map is keyed by `behavior.constructor`, so its key
+ * type is simply `Function`.
+ */
+type BehaviorConstructor<T extends IRuntimeBehavior> = new (...args: any[]) => T;
 declare class BlockBuilder {
     private runtime;
     private behaviors;
@@ -2273,7 +2364,7 @@ declare class BlockBuilder {
      * directly — see §2.3 of docs/architectural-cleanup-tier-2-consolidations.md.
      */
     private moveBehaviorLast;
-    hasBehavior<T extends IRuntimeBehavior>(type: new (...args: any[]) => T): boolean;
+    hasBehavior<T extends IRuntimeBehavior>(type: BehaviorConstructor<T>): boolean;
     /**
      * Declare the block's exit intent. Strategies call this instead of adding
      * or removing ExitBehavior across each other. 'deferred' supersedes
@@ -2283,7 +2374,7 @@ declare class BlockBuilder {
     declareExit(mode: 'immediate' | 'deferred'): BlockBuilder;
     /** The declared exit intent (resolved into a single ExitBehavior in build). */
     get exitMode(): 'immediate' | 'deferred' | undefined;
-    getBehavior<T extends IRuntimeBehavior>(type: new (...args: any[]) => T): T | undefined;
+    getBehavior<T extends IRuntimeBehavior>(type: BehaviorConstructor<T>): T | undefined;
     setContext(context: IBlockContext): BlockBuilder;
     setKey(key: BlockKey): BlockBuilder;
     setLabel(label: string): BlockBuilder;
@@ -3911,7 +4002,7 @@ type BlockStatus = 'pending' | 'active' | 'running' | 'complete' | 'error';
 type MemoryType = 'metric' | 'timer-state' | 'loop-state' | 'group-state' | 'handler' | 'span' | 'unknown';
 type MemoryGrouping = 'owner' | 'type' | 'none';
 interface MetricValue {
-    value: any;
+    value: unknown;
     unit?: string;
     formatted: string;
 }
@@ -3958,7 +4049,7 @@ interface MemoryEntry {
     ownerId: string;
     ownerLabel?: string;
     type: MemoryType;
-    value: any;
+    value: unknown;
     valueFormatted: string;
     label: string;
     groupLabel?: string;
@@ -4004,9 +4095,9 @@ interface ExecutionSnapshot {
  * Converts ScriptRuntime state to ExecutionSnapshot
  */
 interface IRuntimeAdapter {
-    createSnapshot(runtime: any): ExecutionSnapshot;
-    extractStackBlocks(runtime: any): RuntimeStackBlock[];
-    extractMemoryEntries(runtime: any): MemoryEntry[];
+    createSnapshot(runtime: IScriptRuntime): ExecutionSnapshot;
+    extractStackBlocks(runtime: IScriptRuntime): RuntimeStackBlock[];
+    extractMemoryEntries(runtime: IScriptRuntime): MemoryEntry[];
     groupMemoryEntries(entries: MemoryEntry[], groupBy: MemoryGrouping): Map<string, MemoryEntry[]>;
 }
 
@@ -4375,7 +4466,7 @@ interface SegmentWithMetadata extends Segment {
     metrics?: MetricContainer;
     tags?: string[];
     spanType?: string;
-    context?: Record<string, any>;
+    context?: Record<string, unknown>;
 }
 /**
  * AnalyticsTransformer - Transforms OutputStatements into UI-ready analytics data.
@@ -4423,21 +4514,16 @@ interface AnalyticsResult {
  */
 declare function getAnalyticsFromRuntime(runtime: IScriptRuntime | null): AnalyticsResult;
 /**
- * Derive analytics segments from a stored workout log.
+ * Derive analytics segments from a statement stream.
  *
  * This is the **canonical read path** for all analytics derived from a
- * completed workout. WorkoutResult.data.logs (StoredOutputStatement[]) is
- * the source of truth; call this function to obtain Segment[] for display,
- * review grids, or trend summaries.
- *
- * Relationship to the analytics IDB store:
- *   The `analytics` IndexedDB store holds AnalyticsDataPoint[] summary fact
- *   rows written by normalizeSummaryFacts() from Tier-2 outputs in data.logs.
- *   They are NOT required for any current display feature. If they disagree
- *   with logs, logs win. Use this function — not the analytics store — to
- *   obtain segment data for display.
- *
- * @param outputs - StoredOutputStatement[] from WorkoutResult.data.logs
+ * completed workout. Under V21 the statement stream is reconstructed from
+ * the session's event rows (`eventsToStoredLogs`); the live runtime passes
+ * its in-memory stream directly. Call this function to obtain Segment[] for
+ * display, review grids, or trend summaries.
+ *
+ * @param outputs - StoredOutputStatement[] (runtime stream, or event rows
+ *   reconstructed via `eventsToStoredLogs`)
  * @param workoutStartTime - Optional workout start timestamp (ms). Used to
  *   anchor relative timing in the segment timeline.
  * @param now - Optional clock provider; defaults to wall-clock.
@@ -5125,16 +5211,82 @@ declare function computeWorkloadRollups(loads: ReadonlyMap<number, number>, thro
 declare function toStoredOutputStatement(output: IOutputStatement | OutputStatement): StoredOutputStatement;
 
 /**
- * Auto-generated build version metadata.
- * Do not edit directly; updated by scripts/stamp-version.ts
+ * Metric-line DSL parser for parser fixture files (spec: wayfinder
+ * test-validation-harness asset 001).
+ *
+ * Grammar: `- <Type> <value> [@<origin>]`
+ *  - Type: PascalCase or kebab-case; canonicalized to kebab.
+ *  - Value literals: time (`5:00` → ms), number, quoted string, bare token,
+ *    amount+unit sugar (`225 lb`), object tails (`raw:V5 system:v-scale`).
+ *  - `@origin` pins the metric origin; omitted means any origin.
+ */
+type LiteralKind = 'number' | 'string' | 'amountUnit' | 'object' | 'undefined';
+interface MetricLine {
+    /** Canonical kebab-case metric type. */
+    type: string;
+    kind: LiteralKind;
+    /** number/string literal value. */
+    value?: number | string;
+    /** amountUnit sugar assertions. */
+    amount?: number;
+    unit?: string;
+    /** object tails: asserted fields of an object-valued metric. */
+    fields?: Record<string, string | number>;
+    /** Raw line text, for diagnostics. */
+    source: string;
+    origin?: string;
+}
+declare class FixtureSyntaxError extends Error {
+    constructor(message: string);
+}
+/** `ClimbSendType` → `climb-send-type`; kebab input passes through. */
+declare function canonicalizeType(token: string): string;
+/**
+ * Parse one `- …` expectation line.
+ * @param where file name + line for diagnostics.
  */
-declare const VERSION = "0.11.43";
-declare const GIT_SHA = "ed28149";
-declare const BUILD_TIME = "2026-08-26T16:34:15.927Z";
-declare const SEMVER: {
-    readonly version: "0.11.43";
-    readonly gitSha: "ed28149";
-    readonly buildTime: "2026-08-26T16:34:15.927Z";
-};
+declare function parseMetricLine(line: string, file: string, lineNo: number): MetricLine;
+
+/**
+ * Semantic comparator for parser fixtures (spec: wayfinder
+ * test-validation-harness asset 001).
+ *
+ * Match rules per metric line: canonical kebab type equality, literal check
+ * (number / string / amount+unit sugar / object tails), origin pinned only
+ * when written. Always ignored: timestamp, sourceBlockKey, image, name,
+ * metadata, action.
+ *
+ * Modes: `closed` = exact multiset (extra actual metric fails);
+ * `subset` = every expectation matches, extras pass. When an expectation
+ * fails to match, its diff already names what the statement carries, so
+ * leftover actuals are only reported when every expectation matched.
+ *
+ * Consumed by the vitest fixture catalog and the Storybook parser-test
+ * builder/runner (`apps/storybook/src/parser-tests`).
+ */
+
+type MatchMode = 'closed' | 'subset';
+/** Render an actual metric in DSL-like form for readable diagnostics. */
+declare function renderMetric(m: IMetric): string;
+/**
+ * Structured one-statement diff: which expectations matched which actual
+ * metrics, which expectations found no match, and which actual metrics
+ * remain unmatched (extras — failures only in `closed` mode).
+ */
+interface StatementMetricDiff {
+    matched: Array<{
+        expected: MetricLine;
+        actual: IMetric;
+    }>;
+    missingExpected: MetricLine[];
+    extraActual: IMetric[];
+}
+/** Pair expectations against actual metrics (greedy first-match consumption). */
+declare function diffStatement(expected: MetricLine[], actual: readonly IMetric[]): StatementMetricDiff;
+/**
+ * Compare one statement's expectations against its actual metrics.
+ * Returns human-readable diffs (empty = pass).
+ */
+declare function compareStatement(expectations: MetricLine[], actual: readonly IMetric[], mode: MatchMode): string[];
 
-export { ABSENT, AGGREGATE_BUILTINS, AUTHORITATIVE_CASTS, AbortSessionAction, type ActionDescriptor, type ActionPrimitive, AmrapLogicStrategy, AnalyticsContext, AnalyticsEngine, type AnalyticsProfileContext, type AnalyticsResult, AnalyticsTransformer, BUILD_TIME, BUILTIN_CALCS, BUNDLED_EFFORT_COUNT, BehaviorContext, BehaviorEventListener, BehaviorEventType, type BinaryOp, BlockBuilder, BlockContext, BlockLifecycleOptions, ButtonBehavior, ButtonConfig, CONSUMED_HINTS, CONSUMED_HINT_KEYS, CONTEXT_ATOMS, type CalcAnalysis, type CalculationDefinition$1 as CalcDefinition, type CalcDiagnostic, CalcEngine, type CalcEngineDeps, CalcEvalError, type CalcLine, type CalcNode, type CalcOrigin, CalcParseError, CalcRegistrationError, type CalcScope, type CalcStack, type CalcStackOptions, type UnitDef as CalcUnitDef, CalcUnitError, type CalcVariant, type CalculationDefinition as CalculateBlockDefinition, type CalculateBlockParseError, type CalculateBlockParseResult, CalculateBlockProcessor, type CalculationDefinition$1 as CalculationDefinition, CalculationRegistry, CardioDialect, ChildSelectionBehavior, type ChildSelectionConfig, type ChildSelectionLoopCondition, ChildrenStrategy, ChoiceGroupMetric, ClearChildrenAction, ClimbDialect, type ClimbGradeMetricValue, type ClimbGradeSystem, ClimbMetricType, CompileAndPushBlockAction, type CompiledLineForm, CompletionDecision, CompletionTimestampBehavior, type ControlsConfig, type CountdownMode, CountdownTimerBehavior, type CountdownTimerConfig, CountupTimerBehavior, type CountupTimerConfig, type CreateAnalyticsEngineOptions, type CreateAnalyticsEngineResult, CrossFitDialect, DAY, DEFAULT_UNRESOLVED_EFFORT_MET, DIM_COUNT, DIM_ENERGY, DIM_LENGTH, DIM_MASS, DIM_TIME, DIM_ZERO, type DayRollup, DialectStack, type DimVector, type Dimension, type DurationPrimitive, EFFORT_DATA_METRIC_TYPE, EffortBlock, type EffortBlockConfig, EffortFallbackStrategy, type EffortPrimitive, EffortRegistrySource, EffortResolutionOptions, EffortResolver, EffortResolverOptions, EmitEventAction, EmitSystemOutputAction, ErrorAction, type EvalContext, EventBus, EventCallback, EventHandlerOptions, type EventHandlerRegistration, ExecutionContext, type ExecutionSnapshot, type ExecutionStatus, ExitBehavior, type ExitConfig, type ExprNode, type FuzzyCandidate, GIT_SHA, GenericGroupStrategy, GenericLoopStrategy, GenericTimerStrategy, HabitsDialect, type HeadingPrimitive, IAnalyticsEngine, type IAnalyticsProfile, IAnchorValue, IBehaviorContext, IBlockContext, type ICastSubscription, IEffort, IEffortRegistry, IEffortResolver, IEvent, IEventBus, IEventHandler, IJitCompiler, type ILookupTable, IMemoryLocation, IMemoryReference, type IMetricPresentationPolicy, INowProvider, type IProfileSource, IRealtimeProcessor, IRuntimeAction, IRuntimeActionable, IRuntimeBehavior, IRuntimeBlock, type IRuntimeBlockStrategy, IRuntimeClock, type IRuntimeEventProvider, type IRuntimeFactory, IRuntimeMemory, IRuntimeStack, type IRuntimeSubscription, IScript, IScriptRuntime, ISummaryProcessor, InMemoryEffortRegistry, IntervalLogicStrategy, JitCompiler, LabelingBehavior, type LabelingConfig, type LapPrimitive, type LineFormScope, type LineLocator, LocalEventProvider, LocalRuntimeSubscription, type LogLevel, type LookupFieldDef, type LookupLayer, LookupRegistry, MdTimerRuntime, type MemoryEntry, MemoryTag, MemoryTypeEnum, type MetricObjectPrimitive, type MetricPresentationSurface, type MetricPresentationToken, MetricPromotionBehavior, type MetricPromotionConfig, type MetricRenderKind, type MetricTone, MetricVisibility, type MockClock, NAMED_COMPOUNDS, NextAction, NextEvent, NextEventHandler, OutputEmitter, OutputListener, PREDEFINED_SOUNDS, PRODUCTION_STRATEGIES, type ParseOptions, PlaySoundAction, PopBlockAction, type PredefinedSoundName, ProjectionResult, type PromotionRule, type PropertyPrimitive, PushBlockAction, PushRestBlockAction, type QuantityPrimitive, REST_EXCLUSION, RPE_LABELS, RegisterEventHandlerAction, Registry, ReportOutputBehavior, type ReportOutputConfig, ReportOutputStrategy, ResolvedEffort, type ResolvedEffortData, RestBlock, type RestBlockConfig, RoundsMetric, type RoundsPrimitive, RuntimeAdapter, RuntimeBlock, type RuntimeBlockOptions, RuntimeBuilder, type RuntimeButton, RuntimeClock, type RuntimeController, type RuntimeControls, RuntimeError, RuntimeFactory, type RuntimeLogEntry, RuntimeLogger, RuntimeMemory, type RuntimeMemoryLocation, RuntimeObservers, RuntimeStack, RuntimeStackOptions, SEMVER, STANDARD_UNITS, STORE_CALCS, STREAM_ATOMS, ScriptRuntime, type SegmentWithMetadata, SessionRootBlock, type SessionRootConfig, SessionRootStrategy, SnapshotClock, type SoundBehaviorConfig, type SoundCue, SoundCueBehavior, type SoundCueConfig, type SoundCueState, type SoundState, SoundStrategy, type SourceInput, type SpanList, SpanTrackingBehavior, StackListener, StackObserver, StackSnapshot, StandardAnalyticsProfile, StartSessionAction, type StartSessionOptions, StartWorkoutAction, type StartWorkoutOptions, type StaticEnv, type StreamAtomDef, SubscribeOptions, SubscriptionManager, type SyntaxFacts, type SyntaxMeta, type SyntaxPrimitive, type SyntaxStatement, TestableBlockConfig, type TextPrimitive, ThrowError, ThrowErrorAction, TimeSpan, TimerState, TwoPassEffortResolutionProcess, TypedMemoryReference, UNITS, type UnitDef$1 as UnitDef, type UnitMatch, UnitRegistry, UnitSet, UnitsDialect, UnregisterEventHandlerAction, Unsubscribe, UpdateNextPreviewAction, VERSION, type Val, WaitingToStartBlock, WaitingToStartInjectorBehavior, WhiteboardScript, WodDialect, YogaDialect, addDim, buildStaticLookups, buildTooltip, bundledEfforts, calculateElapsed, checkCalcLine, classifyStatements, closeCurrentSpan, collapseUnresolvedChoices, commonFixtureSet, compileLineForm, composeDivUnit, composeMulUnit, compoundName, computeColumnLabel, computeLabel, computeWorkloadRollups, convertScalar, createAnalyticsEngineForBlock, createCalcEngine, createCalcStack, createCompiler, createDialectStack, createDisciplinesTable, createEffortTable, createLineLocator, createPolicy as createMetricPresentationPolicy, createMockClock, createParser, createProfileTable, createRpeLabelsTable, dailySessionLoads, dayBucket, dialectRegistry, dialectStack, dimEquals, evaluate, evaluateCalculateDefinitions, extractEffortData, extractMetrics, extractStatements, extractStatementsRaw, extractSyntaxFacts, findBestFuzzyMatch, findUnresolvedChoices, fixtureBackSquat, fixtureBurpee, fixturePlank, fixtureRowing, fixtureRunning, fixtureUserCustom, fixtureUserOverride, formatDim, formatDuration, metricsToLabel as fragmentsToLabel, fullFixtureSet, fuseUnits, fuseUnitsInMetrics, getAnalyticsFromLogs, getAnalyticsFromRuntime, getHints, getUnit, hasHint, hintMetric, hintsToContainer, inferDim, isCastSubscription, isChoiceResolved, isDimensionless, isTimeLikeMetric, isWithinThreshold, levenshteinDistance, metricPresentation, mutateTimerSpans, normalizeForFuzzy, num, openSpan, outputNodeId, outputNodeIds, parseCalcLine, parseCalculateBlock, parseExpression, parseScript, printCalculation, readTimer, realtimeProcessorRegistry, resolveDominantOrigin, sharedParser, startSpan, str, strategyRegistry, subDim, summaryProcessorRegistry, toStoredOutputStatement, truthy, validateOutputUnit, parser as whiteboardParser, whiteboardScript, whiteboardScriptLanguage, writeChoiceSelection };
+export { ABSENT, AGGREGATE_BUILTINS, AUTHORITATIVE_CASTS, AbortSessionAction, type ActionDescriptor, type ActionPrimitive, AmrapLogicStrategy, AnalyticsContext, AnalyticsEngine, type AnalyticsProfileContext, type AnalyticsResult, AnalyticsTransformer, BUILTIN_CALCS, BUNDLED_EFFORT_COUNT, BehaviorContext, BehaviorEventListener, BehaviorEventType, type BinaryOp, BlockBuilder, BlockContext, BlockLifecycleOptions, ButtonBehavior, ButtonConfig, CONSUMED_HINTS, CONSUMED_HINT_KEYS, CONTEXT_ATOMS, type CalcAnalysis, type CalculationDefinition$1 as CalcDefinition, type CalcDiagnostic, CalcEngine, type CalcEngineDeps, CalcEvalError, type CalcLine, type CalcNode, type CalcOrigin, CalcParseError, CalcRegistrationError, type CalcScope, type CalcStack, type CalcStackOptions, type UnitDef as CalcUnitDef, CalcUnitError, type CalcVariant, type CalculationDefinition as CalculateBlockDefinition, type CalculateBlockParseError, type CalculateBlockParseResult, CalculateBlockProcessor, type CalculationDefinition$1 as CalculationDefinition, CalculationRegistry, CardioDialect, ChildSelectionBehavior, type ChildSelectionConfig, type ChildSelectionLoopCondition, ChildrenStrategy, ChoiceGroupMetric, ClearChildrenAction, ClimbDialect, type ClimbGradeMetricValue, type ClimbGradeSystem, ClimbMetricType, CompileAndPushBlockAction, type CompiledLineForm, CompletionDecision, CompletionTimestampBehavior, CompositeEffortRegistry, type CompositeEffortRegistryOptions, type ControlsConfig, type CountdownMode, CountdownTimerBehavior, type CountdownTimerConfig, CountupTimerBehavior, type CountupTimerConfig, type CreateAnalyticsEngineOptions, type CreateAnalyticsEngineResult, CrossFitDialect, DAY, DEFAULT_UNRESOLVED_EFFORT_MET, DIM_COUNT, DIM_ENERGY, DIM_LENGTH, DIM_MASS, DIM_TIME, DIM_ZERO, type DayRollup, DialectStack, type DimVector, type Dimension, type DurationPrimitive, EFFORT_DATA_METRIC_TYPE, EffortBlock, type EffortBlockConfig, EffortFallbackStrategy, type EffortPrimitive, EffortRegistrySource, EffortResolutionOptions, EffortResolver, EffortResolverOptions, EffortStorageAdapter, EmitEventAction, EmitSystemOutputAction, ErrorAction, type EvalContext, EventBus, EventCallback, EventHandlerOptions, type EventHandlerRegistration, ExecutionContext, type ExecutionSnapshot, type ExecutionStatus, ExitBehavior, type ExitConfig, type ExprNode, FixtureSyntaxError, type FuzzyCandidate, GenericGroupStrategy, GenericLoopStrategy, GenericTimerStrategy, HabitsDialect, type HeadingPrimitive, IAnalyticsEngine, type IAnalyticsProfile, IAnchorValue, IBehaviorContext, IBlockContext, type ICastSubscription, IEffort, IEffortRegistry, IEffortResolver, IEvent, IEventBus, IEventHandler, IJitCompiler, type ILookupTable, IMemoryLocation, IMemoryReference, type IMetricPresentationPolicy, INowProvider, type IProfileSource, IRealtimeProcessor, IRuntimeAction, IRuntimeActionable, IRuntimeBehavior, IRuntimeBlock, type IRuntimeBlockStrategy, IRuntimeClock, type IRuntimeEventProvider, type IRuntimeFactory, IRuntimeMemory, IRuntimeStack, type IRuntimeSubscription, IScriptRuntime, ISummaryProcessor, InMemoryEffortRegistry, IntervalLogicStrategy, JitCompiler, LabelingBehavior, type LabelingConfig, type LapPrimitive, type LineFormScope, type LineLocator, type LiteralKind, LocalEventProvider, LocalRuntimeSubscription, type LogLevel, type LookupFieldDef, type LookupLayer, LookupRegistry, type MatchMode, MdTimerRuntime, type MemoryEntry, MemoryTag, MemoryTypeEnum, type MetricLine, type MetricObjectPrimitive, type MetricPresentationSurface, type MetricPresentationToken, MetricPromotionBehavior, type MetricPromotionConfig, type MetricRenderKind, type MetricTone, MetricVisibility, type MockClock, NAMED_COMPOUNDS, NextAction, NextEvent, NextEventHandler, OutputEmitter, OutputListener, PREDEFINED_SOUNDS, PRODUCTION_STRATEGIES, type ParseOptions, PlaySoundAction, PopBlockAction, type PredefinedSoundName, ProjectionResult, type PromotionRule, type PropertyPrimitive, PushBlockAction, PushRestBlockAction, type QuantityPrimitive, REST_EXCLUSION, RPE_LABELS, RegisterEventHandlerAction, Registry, ReportOutputBehavior, type ReportOutputConfig, ReportOutputStrategy, ResolvedEffort, type ResolvedEffortData, RestBlock, type RestBlockConfig, type RoundSchemePrimitive, RoundsMetric, type RoundsPrimitive, RuntimeAdapter, RuntimeBlock, type RuntimeBlockOptions, RuntimeBuilder, type RuntimeButton, RuntimeClock, type RuntimeController, type RuntimeControls, RuntimeError, RuntimeFactory, type RuntimeLogEntry, RuntimeLogger, RuntimeMemory, type RuntimeMemoryLocation, RuntimeObservers, RuntimeStack, RuntimeStackOptions, STANDARD_UNITS, STORE_CALCS, STREAM_ATOMS, ScriptRuntime, type SegmentWithMetadata, SessionRootBlock, type SessionRootConfig, SessionRootStrategy, SnapshotClock, type SoundBehaviorConfig, type SoundCue, SoundCueBehavior, type SoundCueConfig, type SoundCueState, type SoundState, SoundStrategy, type SourceInput, type SpanList, SpanTrackingBehavior, StackListener, StackObserver, StackSnapshot, StandardAnalyticsProfile, StartSessionAction, type StartSessionOptions, StartWorkoutAction, type StartWorkoutOptions, type StatementMetricDiff, type StaticEnv, type StreamAtomDef, SubscribeOptions, SubscriptionManager, type SyntaxFacts, type SyntaxMeta, type SyntaxPrimitive, type SyntaxStatement, TestableBlockConfig, type TextPrimitive, ThrowError, ThrowErrorAction, TimeSpan, TimerState, TwoPassEffortResolutionProcess, TypedMemoryReference, UNITS, type UnitDef$1 as UnitDef, type UnitMatch, UnitRegistry, UnitSet, UnitsDialect, UnregisterEventHandlerAction, Unsubscribe, UpdateNextPreviewAction, type Val, WaitingToStartBlock, WaitingToStartInjectorBehavior, WhiteboardScript, WodDialect, YogaDialect, addAliasToEffort, addDim, buildStaticLookups, buildTooltip, bundledEfforts, calculateElapsed, canonicalizeType, checkCalcLine, classifyStatements, closeCurrentSpan, collapseUnresolvedChoices, commonFixtureSet, compareStatement, compileLineForm, composeDivUnit, composeMulUnit, compoundName, computeColumnLabel, computeLabel, computeWorkloadRollups, convertScalar, createAnalyticsEngineForBlock, createCalcEngine, createCalcStack, createCompiler, createDialectStack, createDisciplinesTable, createEffortTable, createLineLocator, createPolicy as createMetricPresentationPolicy, createMockClock, createParser, createProfileTable, createRpeLabelsTable, dailySessionLoads, dayBucket, dialectRegistry, dialectStack, diffStatement, dimEquals, evaluate, evaluateCalculateDefinitions, extractEffortData, extractMetrics, extractStatements, extractStatementsRaw, extractSyntaxFacts, findBestFuzzyMatch, findUnresolvedChoices, fixtureBackSquat, fixtureBurpee, fixturePlank, fixtureRowing, fixtureRunning, fixtureUserCustom, fixtureUserOverride, formatDim, formatDuration, metricsToLabel as fragmentsToLabel, fullFixtureSet, fuseUnits, fuseUnitsInMetrics, getAnalyticsFromLogs, getAnalyticsFromRuntime, getHints, getUnit, hasHint, hintMetric, hintsToContainer, inferDim, isCastSubscription, isChoiceResolved, isDimensionless, isTimeLikeMetric, isWithinThreshold, levenshteinDistance, metricPresentation, mutateTimerSpans, normalizeForFuzzy, num, openSpan, outputNodeId, outputNodeIds, parseCalcLine, parseCalculateBlock, parseExpression, parseMetricLine, parseScript, printCalculation, readTimer, realtimeProcessorRegistry, renderMetric, resolveDominantOrigin, sharedParser, startSpan, str, strategyRegistry, subDim, summaryProcessorRegistry, toStoredOutputStatement, truthy, validateOutputUnit, parser as whiteboardParser, whiteboardScript, whiteboardScriptLanguage, writeChoiceSelection };