@bitcobblers/wod-wiki-lang 0.36.2136 → 0.37.2139

package/dist/{browserRuntimeNow-CoR7dCNU.d.cts → browserRuntimeNow-Xsaghuya.d.cts}

@@ -1,49 +1,4 @@
-import { ICodeStatement, ParseError, MetricContainer, IMetric, BlockKey, TimeSpan as TimeSpan$1, OutputStatementType, MetricType, IOutputStatement, MetricOrigin } from '@bitcobblers/wod-wiki-core';
-
-interface IScript {
-    source: string;
-    statements: ICodeStatement[];
-    errors?: ParseError[] | undefined;
-    getIds(ids: number[]): ICodeStatement[];
-    getId(id: number): ICodeStatement | undefined;
-    getAt(index: number): ICodeStatement | undefined;
-}
-declare class WhiteboardScript implements IScript {
-    source: string;
-    statements: ICodeStatement[];
-    errors: ParseError[] | undefined;
-    private _idMap?;
-    constructor(source: string, statements: ICodeStatement[], errors?: ParseError[]);
-    /**
-     * Gets the ID-to-statement Map, building it lazily on first access.
-     * Provides O(1) lookups instead of O(n) find() calls.
-     */
-    private getIdMap;
-    /**
-     * Resolves multiple statement IDs to statements.
-     * Uses cached Map for O(n) performance instead of O(n²).
-     */
-    getIds(ids: number[]): ICodeStatement[];
-    /**
-     * Resolves a single statement ID to a statement.
-     * Uses cached Map for O(1) performance instead of O(n).
-     */
-    getId(id: number): ICodeStatement | undefined;
-    /**
-     * Gets a statement by its array index.
-     */
-    getAt(index: number): ICodeStatement | undefined;
-    /**
-     * Flattens grouped children (number[][]) and resolves to statements.
-     * Convenience wrapper for getIds(children.flat()).
-     */
-    getFlatChildren(children: number[][]): ICodeStatement[];
-    /**
-     * Resolves grouped children while preserving group structure.
-     * Maps each number[] group to ICodeStatement[] group.
-     */
-    getChildGroups(children: number[][]): ICodeStatement[][];
-}
+import { ReferenceMatchKind, ReferenceRef, ReferenceDiagnostic, ICodeStatement, ParseError, MetricContainer, IMetric, BlockKey, TimeSpan as TimeSpan$1, OutputStatementType, MetricType, IOutputStatement, MetricOrigin } from '@bitcobblers/wod-wiki-core';
 
 /**
  * Canonical discipline vocabulary — the single source of truth for effort
@@ -122,6 +77,14 @@ interface IEffort {
     baseAttributes: EffortBaseAttributes;
     /** Where this record came from */
     registrySource: EffortRegistrySource;
+    /** Canonical equipment slugs this effort is typically performed with (ordered, deduped). */
+    equipment?: string[];
+    /** Owning note in the content store, when this record is a note projection. */
+    ownerNoteId?: string;
+    /** Seed/source collection this record was imported from. */
+    sourceId?: string;
+    /** Source file path within the originating collection. */
+    sourcePath?: string;
     /** Clone-based derivation metadata (user efforts only) */
     derivation?: EffortDerivation;
     /** ISO timestamp */
@@ -158,6 +121,56 @@ interface EffortStorageAdapter {
     save(effort: IEffort): Promise<void>;
     delete(slug: string): Promise<void>;
 }
+/**
+ * Canonical equipment entity (dumbbell, rower, kettlebell…).
+ *
+ * Same durable-identity rule as efforts: references point at the slug.
+ * No synthetic tier — unknown equipment stays authored source + diagnostics.
+ */
+interface IEquipment {
+    /** UUID */
+    id: string;
+    /** Canonical identifier — unique, lowercase, hyphenated */
+    slug: string;
+    /** Primary human-readable name */
+    label: string;
+    /** Alternative names for exact matching */
+    aliases: string[];
+    /** Where this record came from */
+    registrySource: 'bundled' | 'user';
+    /** Free-form markdown description / notes */
+    body?: string;
+    /** Owning note in the content store, when this record is a note projection. */
+    ownerNoteId?: string;
+    /** Seed/source collection this record was imported from. */
+    sourceId?: string;
+    /** Source file path within the originating collection. */
+    sourcePath?: string;
+    /** ISO timestamp */
+    createdAt?: string;
+    /** ISO timestamp */
+    updatedAt?: string;
+}
+/** Read/write registry surface for equipment definitions (mirrors IEffortRegistry). */
+interface IEquipmentRegistry {
+    resolve(slug: string): IEquipment | null;
+    resolveByAlias(label: string): IEquipment | null;
+    list(): readonly IEquipment[];
+    listByOrigin(origin: 'bundled' | 'user'): readonly IEquipment[];
+    upsert(equipment: IEquipment): Promise<void>;
+    delete(slug: string): Promise<void>;
+    loadBundled(): Promise<void>;
+    isInitialized(): boolean;
+}
+/**
+ * Pluggable asynchronous persistence adapter for user-defined equipment.
+ * Implemented by host environments (e.g. IndexedDB in browser, filesystem in CLI).
+ */
+interface EquipmentStorageAdapter {
+    load(): Promise<IEquipment[]>;
+    save(equipment: IEquipment): Promise<void>;
+    delete(slug: string): Promise<void>;
+}
 interface EffortResolutionOptions {
     /** Attribute metrics from /effort/:slug query params or logged execution metrics. */
     modifiers?: Record<string, string>;
@@ -215,6 +228,124 @@ interface EffortResolverOptions {
 }
 declare const DEFAULT_RESOLVER_OPTIONS: Required<EffortResolverOptions>;
 
+/**
+ * Shared exact reference resolver — the single door for authored-label →
+ * canonical effort/equipment resolution used by the parser, editor preview,
+ * runtime enrichment, and seed/local indexing.
+ *
+ * Precedence (accepted proposal): explicit JSON ref > exact equipment word
+ * prefix + remaining effort (both must resolve uniquely) > whole-label exact
+ * (slug/alias) > note defaults (empty-movement fill only) > effort-definition
+ * equipment. Fuzzy matching never produces a canonical reference here —
+ * unknown/ambiguous/invalid values retain the authored source and carry a
+ * visible diagnostic instead of falling back.
+ *
+ * The index is built once per catalog (hydration), never per statement.
+ */
+
+/** Catalog collections the resolver resolves against (hydrated from storage/seed). */
+interface ReferenceCatalog {
+    efforts: readonly IEffort[];
+    equipment: readonly IEquipment[];
+}
+/** Note/workout-level reference defaults (`metrics.*` frontmatter). */
+interface ReferenceResolutionDefaults {
+    /** Default effort slug applied when a statement's movement is otherwise missing. */
+    effort?: string;
+    /** Default equipment slugs applied when the line and effort define none. */
+    equipment?: readonly string[];
+}
+/** Result of resolving one authored label. */
+interface ResolvedReferences {
+    matched: ReferenceMatchKind;
+    /** Full authored label — never rewritten. */
+    label: string;
+    /** Materialized effort, or null when unresolved. */
+    effort: ResolvedEffort | null;
+    /** Canonical effort ref, or null. */
+    effortRef: ReferenceRef | null;
+    /** Ordered deduplicated canonical equipment refs. */
+    equipment: ReferenceRef[];
+    /** Remaining movement text after the equipment prefix strip (split path). */
+    remaining: string;
+    /** Unknown/ambiguous/invalid findings — never silently dropped. */
+    diagnostics: ReferenceDiagnostic[];
+}
+/** Materialize an effort definition (MET/derivation math) — pass the legacy EffortResolver in hosts. */
+type EffortMaterializer = (effort: IEffort) => ResolvedEffort;
+interface ReferenceIndex {
+    /** Resolve an authored movement label (statement effort text or frontmatter value). */
+    resolve(label: string, defaults?: ReferenceResolutionDefaults): ResolvedReferences;
+    /** Exact slug/alias effort lookup — no fuzzy, never synthetic. */
+    resolveEffort(slugOrAlias: string): IEffort | null;
+    /** Exact slug/alias equipment lookup — no fuzzy. */
+    resolveEquipment(slugOrAlias: string): IEquipment | null;
+    /** Materialize a resolved definition (wraps the legacy resolver when provided). */
+    materialize(effort: IEffort): ResolvedEffort;
+}
+declare function createReferenceIndex(catalog: ReferenceCatalog, materialize?: EffortMaterializer): ReferenceIndex;
+/**
+ * Canonical statement refs for index/analytics projection — the single shared
+ * replacement for the per-host `extractEffortSlugs` copies.
+ *
+ * ONLY validated durable refs are returned: canonical slugs carried on the
+ * statement's effort/equipment metrics by the shared resolver at parse time.
+ * Unresolved labels yield nothing here (their authored source and diagnostics
+ * stay on the statement) — resolve authored labels through
+ * `ReferenceIndex.resolve` when projecting un-parsed text.
+ */
+declare function extractStatementRefs(statements: readonly ICodeStatement[]): {
+    efforts: string[];
+    equipment: string[];
+};
+/** Canonical slugify for label→candidate-slug hygiene in host projection code. */
+declare function slugifyRefLabel(label: string): string;
+
+interface IScript {
+    source: string;
+    statements: ICodeStatement[];
+    errors?: ParseError[] | undefined;
+    getIds(ids: number[]): ICodeStatement[];
+    getId(id: number): ICodeStatement | undefined;
+    getAt(index: number): ICodeStatement | undefined;
+}
+declare class WhiteboardScript implements IScript {
+    source: string;
+    statements: ICodeStatement[];
+    errors: ParseError[] | undefined;
+    private _idMap?;
+    constructor(source: string, statements: ICodeStatement[], errors?: ParseError[]);
+    /**
+     * Gets the ID-to-statement Map, building it lazily on first access.
+     * Provides O(1) lookups instead of O(n) find() calls.
+     */
+    private getIdMap;
+    /**
+     * Resolves multiple statement IDs to statements.
+     * Uses cached Map for O(n) performance instead of O(n²).
+     */
+    getIds(ids: number[]): ICodeStatement[];
+    /**
+     * Resolves a single statement ID to a statement.
+     * Uses cached Map for O(1) performance instead of O(n).
+     */
+    getId(id: number): ICodeStatement | undefined;
+    /**
+     * Gets a statement by its array index.
+     */
+    getAt(index: number): ICodeStatement | undefined;
+    /**
+     * Flattens grouped children (number[][]) and resolves to statements.
+     * Convenience wrapper for getIds(children.flat()).
+     */
+    getFlatChildren(children: number[][]): ICodeStatement[];
+    /**
+     * Resolves grouped children while preserving group structure.
+     * Maps each number[] group to ICodeStatement[] group.
+     */
+    getChildGroups(children: number[][]): ICodeStatement[][];
+}
+
 /**
  * Minimal executable runtime action shape.
  *
@@ -514,6 +645,7 @@ interface RuntimeStackOptions extends IRuntimeOptions {
     hooks?: RuntimeStackHooks;
     analyticsOptions?: {
         effortResolver?: IEffortResolver;
+        references?: ReferenceIndex;
         userProfile?: {
             vo2max?: number;
         };
@@ -1936,6 +2068,8 @@ interface IAnalyticsEngine {
 interface AnalyticsContext {
     /** Effort resolver for canonical slug and fuzzy alias matching. */
     effortResolver: IEffortResolver;
+    /** Shared reference index for canonical effort/equipment resolution. */
+    references?: ReferenceIndex;
 }
 
 interface IJitCompiler {
@@ -2363,4 +2497,4 @@ declare function getRuntimeNowMs(): number;
 /** Creates an INowProvider that reads the browser sender-clock when available. */
 declare function createBrowserRuntimeNow(): INowProvider;
 
-export { type IRuntimeOptions as $, type AnalyticsContext as A, type BehaviorEventType as B, type CompletionDecision as C, type IRuntimeMemory as D, type EffortResolverOptions as E, TypedMemoryReference as F, type MemorySearchCriteria as G, type IMemoryReference as H, type IEffortResolver as I, type RuntimeStackLogger as J, type StackObserver as K, type StackSnapshot as L, type MemoryTag as M, type StackListener as N, type OutputListener as O, MemoryTypeEnum as P, type IAnchorValue as Q, type ResolvedEffort as R, type SubscribeOptions as S, TimeSpan as T, type Unsubscribe as U, type ButtonConfig as V, WhiteboardScript as W, type IEventHandler as X, type HandlerScope as Y, type IScriptRuntime as Z, type TestableBlockConfig as _, type IEffortRegistry as a, ScriptRuntime as a0, type EventHandlerOptions as a1, type EventCallback as a2, type TimerState as a3, type IRealtimeProcessor as a4, type ISummaryProcessor as a5, type ProjectionResult as a6, type ButtonVariant as a7, type ButtonsState as a8, type ChildrenStatusState as a9, type StackEvent as aA, type TimerDirection as aB, VISIBILITY_ICONS as aC, VISIBILITY_LABELS as aD, createBrowserRuntimeNow as aE, disciplineFactorFor as aF, filterTagsByVisibility as aG, frozenNow as aH, getMetricVisibility as aI, getRuntimeNowMs as aJ, isEffortDiscipline as aK, isFragmentTag as aL, wallClockNow as aM, type CompletionState as aa, DEFAULT_RESOLVER_OPTIONS as ab, DEFAULT_RUNTIME_OPTIONS as ac, DISCIPLINE_FACTORS as ad, type DisplayState as ae, EFFORT_DISCIPLINES as af, EFFORT_REGISTRY_ORIGINS as ag, type EffortBaseAttributes as ah, type EffortDerivation as ai, type EffortDiscipline as aj, type EffortResolvedFrom as ak, type FenceDialect as al, type FragmentDisplayState as am, type FragmentState as an, type IAnalyticsProcessorDescriptor as ao, INTENSITY_TIERS as ap, type IScript as aq, type IntensityTier as ar, type InterceptMode as as, MemoryLocation as at, type MemoryType as au, type MemoryTypeMap as av, type MemoryValueOf as aw, type RoundState as ax, type RuntimeState as ay, type ScriptRuntimeDependencies as az, type IEffort as b, type EffortResolutionOptions as c, type EffortRegistrySource as d, type EffortStorageAdapter as e, type IRuntimeActionable as f, type IEventBus as g, type IRuntimeStack as h, type IRuntimeClock as i, type IJitCompiler as j, type INowProvider as k, type RuntimeStackOptions as l, type RuntimeError as m, type IEvent as n, type IRuntimeAction as o, type IAnalyticsEngine as p, type IRuntimeBlock as q, type IBehaviorContext as r, type BehaviorEventListener as s, type Unsubscribe$1 as t, type OutputOptions as u, type IMemoryLocation as v, type IRuntimeBehavior as w, type IBlockContext as x, type MetricVisibility as y, type BlockLifecycleOptions as z };
+export { type HandlerScope as $, type AnalyticsContext as A, type BehaviorEventType as B, type IBlockContext as C, type MetricVisibility as D, type EffortResolverOptions as E, type BlockLifecycleOptions as F, type CompletionDecision as G, type IRuntimeMemory as H, type IEquipment as I, TypedMemoryReference as J, type MemorySearchCriteria as K, type IMemoryReference as L, type MemoryTag as M, type RuntimeStackLogger as N, type OutputListener as O, type StackObserver as P, type StackSnapshot as Q, type ReferenceIndex as R, type SubscribeOptions as S, TimeSpan as T, type Unsubscribe as U, type StackListener as V, WhiteboardScript as W, MemoryTypeEnum as X, type IAnchorValue as Y, type ButtonConfig as Z, type IEventHandler as _, type ReferenceResolutionDefaults as a, type IScriptRuntime as a0, type TestableBlockConfig as a1, type IRuntimeOptions as a2, ScriptRuntime as a3, type EventHandlerOptions as a4, type EventCallback as a5, type TimerState as a6, type IRealtimeProcessor as a7, type ISummaryProcessor as a8, type ProjectionResult as a9, type MemoryType as aA, type MemoryTypeMap as aB, type MemoryValueOf as aC, type ReferenceCatalog as aD, type ResolvedReferences as aE, type RoundState as aF, type RuntimeState as aG, type ScriptRuntimeDependencies as aH, type StackEvent as aI, type TimerDirection as aJ, VISIBILITY_ICONS as aK, VISIBILITY_LABELS as aL, createBrowserRuntimeNow as aM, createReferenceIndex as aN, disciplineFactorFor as aO, extractStatementRefs as aP, filterTagsByVisibility as aQ, frozenNow as aR, getMetricVisibility as aS, getRuntimeNowMs as aT, isEffortDiscipline as aU, isFragmentTag as aV, slugifyRefLabel as aW, wallClockNow as aX, type ButtonVariant as aa, type ButtonsState as ab, type ChildrenStatusState as ac, type CompletionState as ad, DEFAULT_RESOLVER_OPTIONS as ae, DEFAULT_RUNTIME_OPTIONS as af, DISCIPLINE_FACTORS as ag, type DisplayState as ah, EFFORT_DISCIPLINES as ai, EFFORT_REGISTRY_ORIGINS as aj, type EffortBaseAttributes as ak, type EffortDerivation as al, type EffortDiscipline as am, type EffortMaterializer as an, type EffortResolvedFrom as ao, type EquipmentStorageAdapter as ap, type FenceDialect as aq, type FragmentDisplayState as ar, type FragmentState as as, type IAnalyticsProcessorDescriptor as at, type IEquipmentRegistry as au, INTENSITY_TIERS as av, type IScript as aw, type IntensityTier as ax, type InterceptMode as ay, MemoryLocation as az, type IEffort as b, type IEffortResolver as c, type IEffortRegistry as d, type EffortResolutionOptions as e, type ResolvedEffort as f, type EffortRegistrySource as g, type EffortStorageAdapter as h, type IRuntimeActionable as i, type IEventBus as j, type IRuntimeStack as k, type IRuntimeClock as l, type IJitCompiler as m, type INowProvider as n, type RuntimeStackOptions as o, type RuntimeError as p, type IEvent as q, type IRuntimeAction as r, type IAnalyticsEngine as s, type IRuntimeBlock as t, type IBehaviorContext as u, type BehaviorEventListener as v, type Unsubscribe$1 as w, type OutputOptions as x, type IMemoryLocation as y, type IRuntimeBehavior as z };

package/dist/{browserRuntimeNow-CoR7dCNU.d.ts → browserRuntimeNow-Xsaghuya.d.ts}

@@ -1,49 +1,4 @@
-import { ICodeStatement, ParseError, MetricContainer, IMetric, BlockKey, TimeSpan as TimeSpan$1, OutputStatementType, MetricType, IOutputStatement, MetricOrigin } from '@bitcobblers/wod-wiki-core';
-
-interface IScript {
-    source: string;
-    statements: ICodeStatement[];
-    errors?: ParseError[] | undefined;
-    getIds(ids: number[]): ICodeStatement[];
-    getId(id: number): ICodeStatement | undefined;
-    getAt(index: number): ICodeStatement | undefined;
-}
-declare class WhiteboardScript implements IScript {
-    source: string;
-    statements: ICodeStatement[];
-    errors: ParseError[] | undefined;
-    private _idMap?;
-    constructor(source: string, statements: ICodeStatement[], errors?: ParseError[]);
-    /**
-     * Gets the ID-to-statement Map, building it lazily on first access.
-     * Provides O(1) lookups instead of O(n) find() calls.
-     */
-    private getIdMap;
-    /**
-     * Resolves multiple statement IDs to statements.
-     * Uses cached Map for O(n) performance instead of O(n²).
-     */
-    getIds(ids: number[]): ICodeStatement[];
-    /**
-     * Resolves a single statement ID to a statement.
-     * Uses cached Map for O(1) performance instead of O(n).
-     */
-    getId(id: number): ICodeStatement | undefined;
-    /**
-     * Gets a statement by its array index.
-     */
-    getAt(index: number): ICodeStatement | undefined;
-    /**
-     * Flattens grouped children (number[][]) and resolves to statements.
-     * Convenience wrapper for getIds(children.flat()).
-     */
-    getFlatChildren(children: number[][]): ICodeStatement[];
-    /**
-     * Resolves grouped children while preserving group structure.
-     * Maps each number[] group to ICodeStatement[] group.
-     */
-    getChildGroups(children: number[][]): ICodeStatement[][];
-}
+import { ReferenceMatchKind, ReferenceRef, ReferenceDiagnostic, ICodeStatement, ParseError, MetricContainer, IMetric, BlockKey, TimeSpan as TimeSpan$1, OutputStatementType, MetricType, IOutputStatement, MetricOrigin } from '@bitcobblers/wod-wiki-core';
 
 /**
  * Canonical discipline vocabulary — the single source of truth for effort
@@ -122,6 +77,14 @@ interface IEffort {
     baseAttributes: EffortBaseAttributes;
     /** Where this record came from */
     registrySource: EffortRegistrySource;
+    /** Canonical equipment slugs this effort is typically performed with (ordered, deduped). */
+    equipment?: string[];
+    /** Owning note in the content store, when this record is a note projection. */
+    ownerNoteId?: string;
+    /** Seed/source collection this record was imported from. */
+    sourceId?: string;
+    /** Source file path within the originating collection. */
+    sourcePath?: string;
     /** Clone-based derivation metadata (user efforts only) */
     derivation?: EffortDerivation;
     /** ISO timestamp */
@@ -158,6 +121,56 @@ interface EffortStorageAdapter {
     save(effort: IEffort): Promise<void>;
     delete(slug: string): Promise<void>;
 }
+/**
+ * Canonical equipment entity (dumbbell, rower, kettlebell…).
+ *
+ * Same durable-identity rule as efforts: references point at the slug.
+ * No synthetic tier — unknown equipment stays authored source + diagnostics.
+ */
+interface IEquipment {
+    /** UUID */
+    id: string;
+    /** Canonical identifier — unique, lowercase, hyphenated */
+    slug: string;
+    /** Primary human-readable name */
+    label: string;
+    /** Alternative names for exact matching */
+    aliases: string[];
+    /** Where this record came from */
+    registrySource: 'bundled' | 'user';
+    /** Free-form markdown description / notes */
+    body?: string;
+    /** Owning note in the content store, when this record is a note projection. */
+    ownerNoteId?: string;
+    /** Seed/source collection this record was imported from. */
+    sourceId?: string;
+    /** Source file path within the originating collection. */
+    sourcePath?: string;
+    /** ISO timestamp */
+    createdAt?: string;
+    /** ISO timestamp */
+    updatedAt?: string;
+}
+/** Read/write registry surface for equipment definitions (mirrors IEffortRegistry). */
+interface IEquipmentRegistry {
+    resolve(slug: string): IEquipment | null;
+    resolveByAlias(label: string): IEquipment | null;
+    list(): readonly IEquipment[];
+    listByOrigin(origin: 'bundled' | 'user'): readonly IEquipment[];
+    upsert(equipment: IEquipment): Promise<void>;
+    delete(slug: string): Promise<void>;
+    loadBundled(): Promise<void>;
+    isInitialized(): boolean;
+}
+/**
+ * Pluggable asynchronous persistence adapter for user-defined equipment.
+ * Implemented by host environments (e.g. IndexedDB in browser, filesystem in CLI).
+ */
+interface EquipmentStorageAdapter {
+    load(): Promise<IEquipment[]>;
+    save(equipment: IEquipment): Promise<void>;
+    delete(slug: string): Promise<void>;
+}
 interface EffortResolutionOptions {
     /** Attribute metrics from /effort/:slug query params or logged execution metrics. */
     modifiers?: Record<string, string>;
@@ -215,6 +228,124 @@ interface EffortResolverOptions {
 }
 declare const DEFAULT_RESOLVER_OPTIONS: Required<EffortResolverOptions>;
 
+/**
+ * Shared exact reference resolver — the single door for authored-label →
+ * canonical effort/equipment resolution used by the parser, editor preview,
+ * runtime enrichment, and seed/local indexing.
+ *
+ * Precedence (accepted proposal): explicit JSON ref > exact equipment word
+ * prefix + remaining effort (both must resolve uniquely) > whole-label exact
+ * (slug/alias) > note defaults (empty-movement fill only) > effort-definition
+ * equipment. Fuzzy matching never produces a canonical reference here —
+ * unknown/ambiguous/invalid values retain the authored source and carry a
+ * visible diagnostic instead of falling back.
+ *
+ * The index is built once per catalog (hydration), never per statement.
+ */
+
+/** Catalog collections the resolver resolves against (hydrated from storage/seed). */
+interface ReferenceCatalog {
+    efforts: readonly IEffort[];
+    equipment: readonly IEquipment[];
+}
+/** Note/workout-level reference defaults (`metrics.*` frontmatter). */
+interface ReferenceResolutionDefaults {
+    /** Default effort slug applied when a statement's movement is otherwise missing. */
+    effort?: string;
+    /** Default equipment slugs applied when the line and effort define none. */
+    equipment?: readonly string[];
+}
+/** Result of resolving one authored label. */
+interface ResolvedReferences {
+    matched: ReferenceMatchKind;
+    /** Full authored label — never rewritten. */
+    label: string;
+    /** Materialized effort, or null when unresolved. */
+    effort: ResolvedEffort | null;
+    /** Canonical effort ref, or null. */
+    effortRef: ReferenceRef | null;
+    /** Ordered deduplicated canonical equipment refs. */
+    equipment: ReferenceRef[];
+    /** Remaining movement text after the equipment prefix strip (split path). */
+    remaining: string;
+    /** Unknown/ambiguous/invalid findings — never silently dropped. */
+    diagnostics: ReferenceDiagnostic[];
+}
+/** Materialize an effort definition (MET/derivation math) — pass the legacy EffortResolver in hosts. */
+type EffortMaterializer = (effort: IEffort) => ResolvedEffort;
+interface ReferenceIndex {
+    /** Resolve an authored movement label (statement effort text or frontmatter value). */
+    resolve(label: string, defaults?: ReferenceResolutionDefaults): ResolvedReferences;
+    /** Exact slug/alias effort lookup — no fuzzy, never synthetic. */
+    resolveEffort(slugOrAlias: string): IEffort | null;
+    /** Exact slug/alias equipment lookup — no fuzzy. */
+    resolveEquipment(slugOrAlias: string): IEquipment | null;
+    /** Materialize a resolved definition (wraps the legacy resolver when provided). */
+    materialize(effort: IEffort): ResolvedEffort;
+}
+declare function createReferenceIndex(catalog: ReferenceCatalog, materialize?: EffortMaterializer): ReferenceIndex;
+/**
+ * Canonical statement refs for index/analytics projection — the single shared
+ * replacement for the per-host `extractEffortSlugs` copies.
+ *
+ * ONLY validated durable refs are returned: canonical slugs carried on the
+ * statement's effort/equipment metrics by the shared resolver at parse time.
+ * Unresolved labels yield nothing here (their authored source and diagnostics
+ * stay on the statement) — resolve authored labels through
+ * `ReferenceIndex.resolve` when projecting un-parsed text.
+ */
+declare function extractStatementRefs(statements: readonly ICodeStatement[]): {
+    efforts: string[];
+    equipment: string[];
+};
+/** Canonical slugify for label→candidate-slug hygiene in host projection code. */
+declare function slugifyRefLabel(label: string): string;
+
+interface IScript {
+    source: string;
+    statements: ICodeStatement[];
+    errors?: ParseError[] | undefined;
+    getIds(ids: number[]): ICodeStatement[];
+    getId(id: number): ICodeStatement | undefined;
+    getAt(index: number): ICodeStatement | undefined;
+}
+declare class WhiteboardScript implements IScript {
+    source: string;
+    statements: ICodeStatement[];
+    errors: ParseError[] | undefined;
+    private _idMap?;
+    constructor(source: string, statements: ICodeStatement[], errors?: ParseError[]);
+    /**
+     * Gets the ID-to-statement Map, building it lazily on first access.
+     * Provides O(1) lookups instead of O(n) find() calls.
+     */
+    private getIdMap;
+    /**
+     * Resolves multiple statement IDs to statements.
+     * Uses cached Map for O(n) performance instead of O(n²).
+     */
+    getIds(ids: number[]): ICodeStatement[];
+    /**
+     * Resolves a single statement ID to a statement.
+     * Uses cached Map for O(1) performance instead of O(n).
+     */
+    getId(id: number): ICodeStatement | undefined;
+    /**
+     * Gets a statement by its array index.
+     */
+    getAt(index: number): ICodeStatement | undefined;
+    /**
+     * Flattens grouped children (number[][]) and resolves to statements.
+     * Convenience wrapper for getIds(children.flat()).
+     */
+    getFlatChildren(children: number[][]): ICodeStatement[];
+    /**
+     * Resolves grouped children while preserving group structure.
+     * Maps each number[] group to ICodeStatement[] group.
+     */
+    getChildGroups(children: number[][]): ICodeStatement[][];
+}
+
 /**
  * Minimal executable runtime action shape.
  *
@@ -514,6 +645,7 @@ interface RuntimeStackOptions extends IRuntimeOptions {
     hooks?: RuntimeStackHooks;
     analyticsOptions?: {
         effortResolver?: IEffortResolver;
+        references?: ReferenceIndex;
         userProfile?: {
             vo2max?: number;
         };
@@ -1936,6 +2068,8 @@ interface IAnalyticsEngine {
 interface AnalyticsContext {
     /** Effort resolver for canonical slug and fuzzy alias matching. */
     effortResolver: IEffortResolver;
+    /** Shared reference index for canonical effort/equipment resolution. */
+    references?: ReferenceIndex;
 }
 
 interface IJitCompiler {
@@ -2363,4 +2497,4 @@ declare function getRuntimeNowMs(): number;
 /** Creates an INowProvider that reads the browser sender-clock when available. */
 declare function createBrowserRuntimeNow(): INowProvider;
 
-export { type IRuntimeOptions as $, type AnalyticsContext as A, type BehaviorEventType as B, type CompletionDecision as C, type IRuntimeMemory as D, type EffortResolverOptions as E, TypedMemoryReference as F, type MemorySearchCriteria as G, type IMemoryReference as H, type IEffortResolver as I, type RuntimeStackLogger as J, type StackObserver as K, type StackSnapshot as L, type MemoryTag as M, type StackListener as N, type OutputListener as O, MemoryTypeEnum as P, type IAnchorValue as Q, type ResolvedEffort as R, type SubscribeOptions as S, TimeSpan as T, type Unsubscribe as U, type ButtonConfig as V, WhiteboardScript as W, type IEventHandler as X, type HandlerScope as Y, type IScriptRuntime as Z, type TestableBlockConfig as _, type IEffortRegistry as a, ScriptRuntime as a0, type EventHandlerOptions as a1, type EventCallback as a2, type TimerState as a3, type IRealtimeProcessor as a4, type ISummaryProcessor as a5, type ProjectionResult as a6, type ButtonVariant as a7, type ButtonsState as a8, type ChildrenStatusState as a9, type StackEvent as aA, type TimerDirection as aB, VISIBILITY_ICONS as aC, VISIBILITY_LABELS as aD, createBrowserRuntimeNow as aE, disciplineFactorFor as aF, filterTagsByVisibility as aG, frozenNow as aH, getMetricVisibility as aI, getRuntimeNowMs as aJ, isEffortDiscipline as aK, isFragmentTag as aL, wallClockNow as aM, type CompletionState as aa, DEFAULT_RESOLVER_OPTIONS as ab, DEFAULT_RUNTIME_OPTIONS as ac, DISCIPLINE_FACTORS as ad, type DisplayState as ae, EFFORT_DISCIPLINES as af, EFFORT_REGISTRY_ORIGINS as ag, type EffortBaseAttributes as ah, type EffortDerivation as ai, type EffortDiscipline as aj, type EffortResolvedFrom as ak, type FenceDialect as al, type FragmentDisplayState as am, type FragmentState as an, type IAnalyticsProcessorDescriptor as ao, INTENSITY_TIERS as ap, type IScript as aq, type IntensityTier as ar, type InterceptMode as as, MemoryLocation as at, type MemoryType as au, type MemoryTypeMap as av, type MemoryValueOf as aw, type RoundState as ax, type RuntimeState as ay, type ScriptRuntimeDependencies as az, type IEffort as b, type EffortResolutionOptions as c, type EffortRegistrySource as d, type EffortStorageAdapter as e, type IRuntimeActionable as f, type IEventBus as g, type IRuntimeStack as h, type IRuntimeClock as i, type IJitCompiler as j, type INowProvider as k, type RuntimeStackOptions as l, type RuntimeError as m, type IEvent as n, type IRuntimeAction as o, type IAnalyticsEngine as p, type IRuntimeBlock as q, type IBehaviorContext as r, type BehaviorEventListener as s, type Unsubscribe$1 as t, type OutputOptions as u, type IMemoryLocation as v, type IRuntimeBehavior as w, type IBlockContext as x, type MetricVisibility as y, type BlockLifecycleOptions as z };
+export { type HandlerScope as $, type AnalyticsContext as A, type BehaviorEventType as B, type IBlockContext as C, type MetricVisibility as D, type EffortResolverOptions as E, type BlockLifecycleOptions as F, type CompletionDecision as G, type IRuntimeMemory as H, type IEquipment as I, TypedMemoryReference as J, type MemorySearchCriteria as K, type IMemoryReference as L, type MemoryTag as M, type RuntimeStackLogger as N, type OutputListener as O, type StackObserver as P, type StackSnapshot as Q, type ReferenceIndex as R, type SubscribeOptions as S, TimeSpan as T, type Unsubscribe as U, type StackListener as V, WhiteboardScript as W, MemoryTypeEnum as X, type IAnchorValue as Y, type ButtonConfig as Z, type IEventHandler as _, type ReferenceResolutionDefaults as a, type IScriptRuntime as a0, type TestableBlockConfig as a1, type IRuntimeOptions as a2, ScriptRuntime as a3, type EventHandlerOptions as a4, type EventCallback as a5, type TimerState as a6, type IRealtimeProcessor as a7, type ISummaryProcessor as a8, type ProjectionResult as a9, type MemoryType as aA, type MemoryTypeMap as aB, type MemoryValueOf as aC, type ReferenceCatalog as aD, type ResolvedReferences as aE, type RoundState as aF, type RuntimeState as aG, type ScriptRuntimeDependencies as aH, type StackEvent as aI, type TimerDirection as aJ, VISIBILITY_ICONS as aK, VISIBILITY_LABELS as aL, createBrowserRuntimeNow as aM, createReferenceIndex as aN, disciplineFactorFor as aO, extractStatementRefs as aP, filterTagsByVisibility as aQ, frozenNow as aR, getMetricVisibility as aS, getRuntimeNowMs as aT, isEffortDiscipline as aU, isFragmentTag as aV, slugifyRefLabel as aW, wallClockNow as aX, type ButtonVariant as aa, type ButtonsState as ab, type ChildrenStatusState as ac, type CompletionState as ad, DEFAULT_RESOLVER_OPTIONS as ae, DEFAULT_RUNTIME_OPTIONS as af, DISCIPLINE_FACTORS as ag, type DisplayState as ah, EFFORT_DISCIPLINES as ai, EFFORT_REGISTRY_ORIGINS as aj, type EffortBaseAttributes as ak, type EffortDerivation as al, type EffortDiscipline as am, type EffortMaterializer as an, type EffortResolvedFrom as ao, type EquipmentStorageAdapter as ap, type FenceDialect as aq, type FragmentDisplayState as ar, type FragmentState as as, type IAnalyticsProcessorDescriptor as at, type IEquipmentRegistry as au, INTENSITY_TIERS as av, type IScript as aw, type IntensityTier as ax, type InterceptMode as ay, MemoryLocation as az, type IEffort as b, type IEffortResolver as c, type IEffortRegistry as d, type EffortResolutionOptions as e, type ResolvedEffort as f, type EffortRegistrySource as g, type EffortStorageAdapter as h, type IRuntimeActionable as i, type IEventBus as j, type IRuntimeStack as k, type IRuntimeClock as l, type IJitCompiler as m, type INowProvider as n, type RuntimeStackOptions as o, type RuntimeError as p, type IEvent as q, type IRuntimeAction as r, type IAnalyticsEngine as s, type IRuntimeBlock as t, type IBehaviorContext as u, type BehaviorEventListener as v, type Unsubscribe$1 as w, type OutputOptions as x, type IMemoryLocation as y, type IRuntimeBehavior as z };