@bitcobblers/wod-wiki-lang 0.37.2137 → 0.37.2140

package/dist/{browserRuntimeNow-CoR7dCNU.d.cts → browserRuntimeNow-M4hQ_DTl.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
@@ -82,6 +37,30 @@ type EffortRegistrySource = 'bundled' | 'user' | 'synthetic-unresolved';
 /** Origins that hold real registry records (synthetic-unresolved entries are
  * resolver phantoms, never listed) — the WQL `origin:` filter vocabulary. */
 declare const EFFORT_REGISTRY_ORIGINS: readonly ["bundled", "user"];
+/**
+ * Precedence tiers for resolving collisions across seed catalogs and local edits.
+ * Order: core (0) < community (1) < imported (2) < user (3).
+ */
+type CatalogPrecedenceTier = 'core' | 'community' | 'imported' | 'user';
+declare const CATALOG_PRECEDENCE_RANK: Readonly<Record<CatalogPrecedenceTier, number>>;
+/** Resolve the precedence tier for a seed source id or checkpoint key (`seed:<id>`). */
+declare function resolveSourceTier(sourceIdOrMetaKey?: string | null, explicitTier?: CatalogPrecedenceTier): CatalogPrecedenceTier;
+declare function resolveSourceRank(sourceIdOrMetaKey?: string | null, explicitTier?: CatalogPrecedenceTier): number;
+/** Resolve the precedence tier of an effort/equipment definition record. */
+declare function resolveEntityTier(entity: {
+    registrySource?: string;
+    sourceId?: string | null;
+}): CatalogPrecedenceTier;
+declare function resolveEntityRank(entity: {
+    registrySource?: string;
+    sourceId?: string | null;
+}): number;
+/** Deduplicate definition entities by slug, retaining the highest-precedence record per slug. */
+declare function dedupeEntitiesByPrecedence<T extends {
+    slug: string;
+    registrySource?: string;
+    sourceId?: string | null;
+}>(entities: readonly T[]): T[];
 /** Intensity tiers, low → high — the WQL `intensity:` filter vocabulary. */
 declare const INTENSITY_TIERS: readonly ["low", "moderate", "high"];
 type IntensityTier = (typeof INTENSITY_TIERS)[number];
@@ -122,6 +101,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 +145,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 +252,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 +669,7 @@ interface RuntimeStackOptions extends IRuntimeOptions {
     hooks?: RuntimeStackHooks;
     analyticsOptions?: {
         effortResolver?: IEffortResolver;
+        references?: ReferenceIndex;
         userProfile?: {
             vo2max?: number;
         };
@@ -1936,6 +2092,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 +2521,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, resolveSourceRank 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 InterceptMode as aA, MemoryLocation as aB, type MemoryType as aC, type MemoryTypeMap as aD, type MemoryValueOf as aE, type ReferenceCatalog as aF, type ResolvedReferences as aG, type RoundState as aH, type RuntimeState as aI, type ScriptRuntimeDependencies as aJ, type StackEvent as aK, type TimerDirection as aL, VISIBILITY_ICONS as aM, VISIBILITY_LABELS as aN, createBrowserRuntimeNow as aO, createReferenceIndex as aP, dedupeEntitiesByPrecedence as aQ, disciplineFactorFor as aR, extractStatementRefs as aS, filterTagsByVisibility as aT, frozenNow as aU, getMetricVisibility as aV, getRuntimeNowMs as aW, isEffortDiscipline as aX, isFragmentTag as aY, resolveEntityRank as aZ, resolveEntityTier as a_, type ButtonVariant as aa, type ButtonsState as ab, CATALOG_PRECEDENCE_RANK as ac, type CatalogPrecedenceTier as ad, type ChildrenStatusState as ae, type CompletionState as af, DEFAULT_RESOLVER_OPTIONS as ag, DEFAULT_RUNTIME_OPTIONS as ah, DISCIPLINE_FACTORS as ai, type DisplayState as aj, EFFORT_DISCIPLINES as ak, EFFORT_REGISTRY_ORIGINS as al, type EffortBaseAttributes as am, type EffortDerivation as an, type EffortDiscipline as ao, type EffortMaterializer as ap, type EffortResolvedFrom as aq, type EquipmentStorageAdapter as ar, type FenceDialect as as, type FragmentDisplayState as at, type FragmentState as au, type IAnalyticsProcessorDescriptor as av, type IEquipmentRegistry as aw, INTENSITY_TIERS as ax, type IScript as ay, type IntensityTier as az, type IEffort as b, resolveSourceTier as b0, slugifyRefLabel as b1, wallClockNow as b2, 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-M4hQ_DTl.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
@@ -82,6 +37,30 @@ type EffortRegistrySource = 'bundled' | 'user' | 'synthetic-unresolved';
 /** Origins that hold real registry records (synthetic-unresolved entries are
  * resolver phantoms, never listed) — the WQL `origin:` filter vocabulary. */
 declare const EFFORT_REGISTRY_ORIGINS: readonly ["bundled", "user"];
+/**
+ * Precedence tiers for resolving collisions across seed catalogs and local edits.
+ * Order: core (0) < community (1) < imported (2) < user (3).
+ */
+type CatalogPrecedenceTier = 'core' | 'community' | 'imported' | 'user';
+declare const CATALOG_PRECEDENCE_RANK: Readonly<Record<CatalogPrecedenceTier, number>>;
+/** Resolve the precedence tier for a seed source id or checkpoint key (`seed:<id>`). */
+declare function resolveSourceTier(sourceIdOrMetaKey?: string | null, explicitTier?: CatalogPrecedenceTier): CatalogPrecedenceTier;
+declare function resolveSourceRank(sourceIdOrMetaKey?: string | null, explicitTier?: CatalogPrecedenceTier): number;
+/** Resolve the precedence tier of an effort/equipment definition record. */
+declare function resolveEntityTier(entity: {
+    registrySource?: string;
+    sourceId?: string | null;
+}): CatalogPrecedenceTier;
+declare function resolveEntityRank(entity: {
+    registrySource?: string;
+    sourceId?: string | null;
+}): number;
+/** Deduplicate definition entities by slug, retaining the highest-precedence record per slug. */
+declare function dedupeEntitiesByPrecedence<T extends {
+    slug: string;
+    registrySource?: string;
+    sourceId?: string | null;
+}>(entities: readonly T[]): T[];
 /** Intensity tiers, low → high — the WQL `intensity:` filter vocabulary. */
 declare const INTENSITY_TIERS: readonly ["low", "moderate", "high"];
 type IntensityTier = (typeof INTENSITY_TIERS)[number];
@@ -122,6 +101,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 +145,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 +252,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 +669,7 @@ interface RuntimeStackOptions extends IRuntimeOptions {
     hooks?: RuntimeStackHooks;
     analyticsOptions?: {
         effortResolver?: IEffortResolver;
+        references?: ReferenceIndex;
         userProfile?: {
             vo2max?: number;
         };
@@ -1936,6 +2092,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 +2521,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, resolveSourceRank 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 InterceptMode as aA, MemoryLocation as aB, type MemoryType as aC, type MemoryTypeMap as aD, type MemoryValueOf as aE, type ReferenceCatalog as aF, type ResolvedReferences as aG, type RoundState as aH, type RuntimeState as aI, type ScriptRuntimeDependencies as aJ, type StackEvent as aK, type TimerDirection as aL, VISIBILITY_ICONS as aM, VISIBILITY_LABELS as aN, createBrowserRuntimeNow as aO, createReferenceIndex as aP, dedupeEntitiesByPrecedence as aQ, disciplineFactorFor as aR, extractStatementRefs as aS, filterTagsByVisibility as aT, frozenNow as aU, getMetricVisibility as aV, getRuntimeNowMs as aW, isEffortDiscipline as aX, isFragmentTag as aY, resolveEntityRank as aZ, resolveEntityTier as a_, type ButtonVariant as aa, type ButtonsState as ab, CATALOG_PRECEDENCE_RANK as ac, type CatalogPrecedenceTier as ad, type ChildrenStatusState as ae, type CompletionState as af, DEFAULT_RESOLVER_OPTIONS as ag, DEFAULT_RUNTIME_OPTIONS as ah, DISCIPLINE_FACTORS as ai, type DisplayState as aj, EFFORT_DISCIPLINES as ak, EFFORT_REGISTRY_ORIGINS as al, type EffortBaseAttributes as am, type EffortDerivation as an, type EffortDiscipline as ao, type EffortMaterializer as ap, type EffortResolvedFrom as aq, type EquipmentStorageAdapter as ar, type FenceDialect as as, type FragmentDisplayState as at, type FragmentState as au, type IAnalyticsProcessorDescriptor as av, type IEquipmentRegistry as aw, INTENSITY_TIERS as ax, type IScript as ay, type IntensityTier as az, type IEffort as b, resolveSourceTier as b0, slugifyRefLabel as b1, wallClockNow as b2, 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 };