@bitcobblers/wod-wiki-lang 0.46.2168 → 0.47.2169

package/dist/{browserRuntimeNow-BpEYjit5.d.cts → browserRuntimeNow-CqyFh_Jd.d.cts}

@@ -847,6 +847,176 @@ interface CalculationDefinition {
     };
 }
 
+/**
+ * Dimension-aware value model for calc evaluation.
+ *
+ * Numbers carry a dimension vector and (optionally) the unit they were
+ * measured in; arithmetic tracks vectors per spec §5.1. `absent` is the
+ * missing-data value: it propagates through arithmetic, reads as `false` in
+ * predicates (applicability decision, #848), and is what `has()` probes.
+ */
+
+type Val = {
+    kind: 'number';
+    value: number;
+    dim: DimVector;
+    unit?: string;
+} | {
+    kind: 'string';
+    value: string;
+} | {
+    kind: 'series';
+    points: Map<number, number>;
+    dim: DimVector;
+    unit?: string;
+} | {
+    kind: 'period';
+    days: number;
+} | {
+    kind: 'absent';
+};
+declare const ABSENT: Val;
+declare function num(value: number, dim?: DimVector, unit?: string): Val;
+declare function str(value: string): Val;
+/** Predicate truthiness: absent → false; numbers → ≠ 0; strings → non-empty. */
+declare function truthy(v: Val): boolean;
+
+/**
+ * Expression evaluator for the composed calculations layer.
+ *
+ * The core owns arithmetic, comparison/logic, and the scalar function table
+ * (min, max, abs, round, floor, ceil, clamp, convert, has). Everything
+ * scope-dependent — metric refs, context nodes, stream aggregates, lookup(),
+ * WQL atoms — resolves through the EvalContext, so the same evaluator serves
+ * segment, workout, and store scopes (spec §3.1).
+ */
+
+declare class CalcEvalError extends Error {
+    constructor(message: string);
+}
+interface EvalContext {
+    /** Resolve a ref atom (metric, context node, library node). ABSENT when missing. */
+    resolveRef(name: string): Val;
+    /**
+     * Extension functions (stream aggregates, lookup). Receives evaluated args
+     * plus the raw arg nodes (aggregates need the filter node unevaluated).
+     * Return undefined to signal "not mine" → CalcEvalError.
+     */
+    callFunction?(name: string, args: Val[], rawArgs: ExprNode[]): Val | undefined;
+    /** Store-scope WQL selections (QueryService). Store scope only. */
+    resolveWql?(node: Extract<ExprNode, {
+        kind: 'wql';
+    }>): Val;
+}
+declare function evaluate(node: ExprNode, ctx: EvalContext): Val;
+
+/**
+ * Lookup table registry (spec §4).
+ *
+ * Tables are adapters over heterogeneous sources (effort resolver, static
+ * maps, user profile) exposing a uniform single-row lookup contract:
+ * `lookup("table", keyExpr, "field")`. Registration is layered —
+ * bundled → dialect → user — with later layers replacing earlier ones
+ * (mirrors the Dialect Stack's personal-overrides-last rule). Miss behavior
+ * is per-table: `absent` yields the absent value; `default-row` yields a
+ * synthetic row so calcs never see a miss.
+ */
+
+interface LookupFieldDef {
+    dimension: DimVector;
+    type: 'number' | 'string';
+}
+interface ILookupTable {
+    readonly id: string;
+    readonly fields: Record<string, LookupFieldDef>;
+    readonly missPolicy: 'absent' | 'default-row';
+    /** Single-row lookup. `absent` tables return undefined on a miss. */
+    get(key: string, field: string): Val | undefined;
+}
+type LookupLayer = 'bundled' | 'dialect' | 'user';
+declare class LookupRegistry {
+    private readonly tables;
+    /** Register a table; a later-or-equal layer replaces the existing entry. */
+    register(table: ILookupTable, layer?: LookupLayer): void;
+    get(tableId: string): ILookupTable | undefined;
+    /** Field dimension for static checking; undefined when table/field unknown. */
+    fieldDim(tableId: string, field: string): DimVector | undefined;
+    /** Runtime lookup honoring the table's miss policy. */
+    lookup(tableId: string, key: string, field: string): Val;
+    /**
+     * EvalContext `callFunction` implementation for `lookup("table", key, "field")`.
+     * Compose with other extension functions (aggregates) at the engine layer.
+     */
+    readonly callFunction: EvalContext['callFunction'];
+}
+
+/**
+ * MetricShakeOutQueue — Two-stage dependency-ordered metric evaluation module.
+ *
+ * Collects static Metrics and statement-level Metric Equations (`metrics:`)
+ * plus workout/query Summary Metrics (`summaries:`) across stacked Property
+ * Notes in specificity precedence:
+ *   Statement/Runtime > Inline Tag > Effort > Equipment > Note Frontmatter > Tag Category
+ *
+ * Stage 1 (`plan`): resolves static metrics and compile-time equations in
+ * topological waves, injects compiler hints, and defers equations whose
+ * required inputs depend on runtime-only atoms (`elapsed`, `spans`, etc.).
+ *
+ * Stage 2 (`log`): resolves all remaining equations against the executed
+ * statement metrics and emits a structured Skipped-Dependency Diagnostic
+ * metric (`origin: 'diagnostic'`, `type: MetricType.Diagnostic`) for any
+ * equation whose required inputs remain absent after the fixed-point pass.
+ */
+
+type PropertySourceLayer = 'statement' | 'tag' | 'effort' | 'equipment' | 'note' | 'category';
+interface PropertyRuleInput {
+    readonly layer: Exclude<PropertySourceLayer, 'statement'>;
+    readonly sourceSlug: string;
+    readonly metrics?: Readonly<Record<string, string | number | readonly string[]>>;
+    readonly summaries?: Readonly<Record<string, string>>;
+    readonly hints?: Readonly<Record<string, unknown>>;
+}
+interface SkippedDependencyDiagnostic {
+    readonly target: string;
+    readonly expression: string;
+    readonly sourceLayer: Exclude<PropertySourceLayer, 'statement'>;
+    readonly sourceSlug: string;
+    readonly missing: readonly string[];
+}
+interface ShakeOutResult {
+    readonly resolved: readonly string[];
+    readonly deferredRuntime: readonly string[];
+    readonly diagnostics: readonly SkippedDependencyDiagnostic[];
+    readonly inferredDims: Readonly<Record<string, DimVector>>;
+}
+interface ShakeOutQueueOptions {
+    readonly stage: 'plan' | 'log';
+    readonly sources: readonly PropertyRuleInput[];
+    readonly lookups?: LookupRegistry;
+    readonly lastEffortSlug?: string;
+}
+/**
+ * Extract `metrics:` and `summaries:` maps from a parsed frontmatter record
+ * (supporting both flat `metrics.foo` / `summaries.bar` keys and nested maps).
+ */
+declare function extractPropertyRulesFromMeta(meta: Readonly<Record<string, unknown>>, layer: Exclude<PropertySourceLayer, 'statement'>, sourceSlug: string): PropertyRuleInput;
+/**
+ * Extract `PropertyRuleInput` records from a `TagIndex` for the given tag slugs.
+ * Supports both statement-level `metrics` (static or equation) and workout-level
+ * `summaries.<key>` contributions on tags (including nested tags).
+ */
+declare function extractTagPropertyRules(tags: TagIndex | undefined, slugs: readonly string[]): PropertyRuleInput[];
+/**
+ * Compile `summaries:` equations across stacked Property Notes into workout-scope
+ * `CalculationDefinition` records. Higher-precedence layers shadow lower layers
+ * when both define the same summary key.
+ */
+declare function compilePropertySummaryCalcs(sources: readonly PropertyRuleInput[]): CalculationDefinition[];
+/**
+ * Run the two-stage Metric Shake-Out Queue on a statement's MetricContainer.
+ */
+declare function runMetricShakeOutQueue(container: MetricContainer, options: ShakeOutQueueOptions): ShakeOutResult;
+
 /**
  * Factory function type for wrapping blocks in debug mode.
  * Receives the original block and returns a wrapped version.
@@ -948,6 +1118,8 @@ interface RuntimeStackOptions extends IRuntimeOptions {
          * bundle a profile applies.
          */
         activeTags?: readonly string[];
+        /** Property Note metric/summary rules active for this run or block. */
+        propertySources?: readonly PropertyRuleInput[];
     };
     /**
      * Sound configuration for this run.
@@ -2819,4 +2991,4 @@ declare function getRuntimeNowMs(): number;
 /** Creates an INowProvider that reads the browser sender-clock when available. */
 declare function createBrowserRuntimeNow(): INowProvider;
 
-export { type SoundProfile as $, type AnalyticsContext as A, type BehaviorEventType as B, type IMemoryLocation as C, type IRuntimeBehavior as D, type EffortResolverOptions as E, type IBlockContext as F, type MetricVisibility as G, type BlockLifecycleOptions as H, type IEquipment as I, type CompletionDecision as J, type IRuntimeMemory as K, TypedMemoryReference as L, type MemoryTag as M, type MemorySearchCriteria as N, type OutputListener as O, type IMemoryReference as P, type RuntimeStackLogger as Q, type ReferenceIndex as R, type SubscribeOptions as S, TimeSpan as T, type Unsubscribe as U, type StackObserver as V, WhiteboardScript as W, type StackSnapshot as X, type StackListener as Y, MemoryTypeEnum as Z, type IAnchorValue as _, type ReferenceResolutionDefaults as a, type SeedPrecedenceTier as a$, type ButtonConfig as a0, type IEventHandler as a1, type HandlerScope as a2, type IScriptRuntime as a3, type TestableBlockConfig as a4, type IRuntimeOptions as a5, ScriptRuntime as a6, type EventHandlerOptions as a7, type EventCallback as a8, type TimerState as a9, type DisplayState as aA, EFFORT_DISCIPLINES as aB, EFFORT_REGISTRY_ORIGINS as aC, type EffortBaseAttributes as aD, type EffortDerivation as aE, type EffortDiscipline as aF, type EffortMaterializer as aG, type EffortResolvedFrom as aH, type FenceDialect as aI, type FragmentDisplayState as aJ, type FragmentState as aK, type IAnalyticsProcessorDescriptor as aL, INTENSITY_TIERS as aM, type IScript as aN, type IntensityTier as aO, type InterceptMode as aP, MemoryLocation as aQ, type MemoryType as aR, type MemoryTypeMap as aS, type MemoryValueOf as aT, NAMED_COMPOUNDS as aU, type ReferenceCatalog as aV, type ResolvedReferences as aW, type RoundState as aX, type RuntimeState as aY, SEED_PRECEDENCE_RANK as aZ, type ScriptRuntimeDependencies as a_, type DimVector as aa, type ExprNode as ab, type CalculationDefinition as ac, type IRealtimeProcessor as ad, type ISummaryProcessor as ae, type CalcLine as af, type CalcScope as ag, type ProjectionResult as ah, type BinaryOp as ai, type ButtonVariant as aj, type ButtonsState as ak, type CalcNode as al, type CalcOrigin as am, type CalcVariant as an, type ChildrenStatusState as ao, type CompletionState as ap, DEFAULT_RESOLVER_OPTIONS as aq, DEFAULT_RUNTIME_OPTIONS as ar, DEFAULT_SOUND_PROFILE as as, DIM_COUNT as at, DIM_ENERGY as au, DIM_LENGTH as av, DIM_MASS as aw, DIM_TIME as ax, DIM_ZERO as ay, DISCIPLINE_FACTORS as az, type IEffort as b, type SoundRule as b0, type SoundTriggerAnchor as b1, type SoundTriggerPoint as b2, type StackEvent as b3, type TimerDirection as b4, VISIBILITY_ICONS as b5, VISIBILITY_LABELS as b6, addDim as b7, compoundName as b8, createBrowserRuntimeNow as b9, createReferenceIndex as ba, dedupeEntitiesByPrecedence as bb, dimEquals as bc, disciplineFactorFor as bd, extractStatementRefs as be, filterTagsByVisibility as bf, formatDim as bg, formatSoundTrigger as bh, frozenNow as bi, getMetricVisibility as bj, getRuntimeNowMs as bk, isDimensionless as bl, isEffortDiscipline as bm, isFragmentTag as bn, parseSoundTrigger as bo, resolveEntityRank as bp, resolveEntityTier as bq, resolveProfileRules as br, resolveSourceRank as bs, resolveSourceTier as bt, slugifyRefLabel as bu, subDim as bv, wallClockNow as bw, type IEffortResolver as c, type IEffortRegistry as d, type EffortResolutionOptions as e, type ResolvedEffort as f, type EffortRegistrySource as g, type IEquipmentRegistry as h, type EquipmentStorageAdapter as i, type EffortStorageAdapter as j, type IRuntimeActionable as k, type IEventBus as l, type IRuntimeStack as m, type IRuntimeClock as n, type IJitCompiler as o, type INowProvider as p, type RuntimeStackOptions as q, type RuntimeError as r, type IEvent as s, type IRuntimeAction as t, type IAnalyticsEngine as u, type IRuntimeBlock as v, type IBehaviorContext as w, type BehaviorEventListener as x, type Unsubscribe$1 as y, type OutputOptions as z };
+export { type SoundProfile as $, type AnalyticsContext as A, type BehaviorEventType as B, type IMemoryLocation as C, type IRuntimeBehavior as D, type EffortResolverOptions as E, type IBlockContext as F, type MetricVisibility as G, type BlockLifecycleOptions as H, type IEquipment as I, type CompletionDecision as J, type IRuntimeMemory as K, TypedMemoryReference as L, type MemoryTag as M, type MemorySearchCriteria as N, type OutputListener as O, type IMemoryReference as P, type RuntimeStackLogger as Q, type ReferenceIndex as R, type SubscribeOptions as S, TimeSpan as T, type Unsubscribe as U, type StackObserver as V, WhiteboardScript as W, type StackSnapshot as X, type StackListener as Y, MemoryTypeEnum as Z, type IAnchorValue as _, type ReferenceResolutionDefaults as a, type MemoryValueOf as a$, type ButtonConfig as a0, type IEventHandler as a1, type HandlerScope as a2, type IScriptRuntime as a3, type TestableBlockConfig as a4, type IRuntimeOptions as a5, ScriptRuntime as a6, type EventHandlerOptions as a7, type EventCallback as a8, type TimerState as a9, DIM_LENGTH as aA, DIM_MASS as aB, DIM_TIME as aC, DIM_ZERO as aD, DISCIPLINE_FACTORS as aE, type DisplayState as aF, EFFORT_DISCIPLINES as aG, EFFORT_REGISTRY_ORIGINS as aH, type EffortBaseAttributes as aI, type EffortDerivation as aJ, type EffortDiscipline as aK, type EffortMaterializer as aL, type EffortResolvedFrom as aM, type EvalContext as aN, type FenceDialect as aO, type FragmentDisplayState as aP, type FragmentState as aQ, type IAnalyticsProcessorDescriptor as aR, INTENSITY_TIERS as aS, type IScript as aT, type IntensityTier as aU, type InterceptMode as aV, type LookupFieldDef as aW, type LookupLayer as aX, MemoryLocation as aY, type MemoryType as aZ, type MemoryTypeMap as a_, type CalculationDefinition as aa, type PropertyRuleInput as ab, type IRealtimeProcessor as ac, type ISummaryProcessor as ad, type DimVector as ae, type CalcLine as af, type ExprNode as ag, type CalcScope as ah, type ILookupTable as ai, LookupRegistry as aj, type ProjectionResult as ak, ABSENT as al, type BinaryOp as am, type ButtonVariant as an, type ButtonsState as ao, CalcEvalError as ap, type CalcNode as aq, type CalcOrigin as ar, type CalcVariant as as, type ChildrenStatusState as at, type CompletionState as au, DEFAULT_RESOLVER_OPTIONS as av, DEFAULT_RUNTIME_OPTIONS as aw, DEFAULT_SOUND_PROFILE as ax, DIM_COUNT as ay, DIM_ENERGY as az, type IEffort as b, NAMED_COMPOUNDS as b0, type PropertySourceLayer as b1, type ReferenceCatalog as b2, type ResolvedReferences as b3, type RoundState as b4, type RuntimeState as b5, SEED_PRECEDENCE_RANK as b6, type ScriptRuntimeDependencies as b7, type SeedPrecedenceTier as b8, type ShakeOutQueueOptions as b9, getMetricVisibility as bA, getRuntimeNowMs as bB, isDimensionless as bC, isEffortDiscipline as bD, isFragmentTag as bE, num as bF, parseSoundTrigger as bG, resolveEntityRank as bH, resolveEntityTier as bI, resolveProfileRules as bJ, resolveSourceRank as bK, resolveSourceTier as bL, runMetricShakeOutQueue as bM, slugifyRefLabel as bN, str as bO, subDim as bP, truthy as bQ, wallClockNow as bR, type ShakeOutResult as ba, type SkippedDependencyDiagnostic as bb, type SoundRule as bc, type SoundTriggerAnchor as bd, type SoundTriggerPoint as be, type StackEvent as bf, type TimerDirection as bg, VISIBILITY_ICONS as bh, VISIBILITY_LABELS as bi, type Val as bj, addDim as bk, compilePropertySummaryCalcs as bl, compoundName as bm, createBrowserRuntimeNow as bn, createReferenceIndex as bo, dedupeEntitiesByPrecedence as bp, dimEquals as bq, disciplineFactorFor as br, evaluate as bs, extractPropertyRulesFromMeta as bt, extractStatementRefs as bu, extractTagPropertyRules as bv, filterTagsByVisibility as bw, formatDim as bx, formatSoundTrigger as by, frozenNow as bz, type IEffortResolver as c, type IEffortRegistry as d, type EffortResolutionOptions as e, type ResolvedEffort as f, type EffortRegistrySource as g, type IEquipmentRegistry as h, type EquipmentStorageAdapter as i, type EffortStorageAdapter as j, type IRuntimeActionable as k, type IEventBus as l, type IRuntimeStack as m, type IRuntimeClock as n, type IJitCompiler as o, type INowProvider as p, type RuntimeStackOptions as q, type RuntimeError as r, type IEvent as s, type IRuntimeAction as t, type IAnalyticsEngine as u, type IRuntimeBlock as v, type IBehaviorContext as w, type BehaviorEventListener as x, type Unsubscribe$1 as y, type OutputOptions as z };

package/dist/{browserRuntimeNow-BpEYjit5.d.ts → browserRuntimeNow-CqyFh_Jd.d.ts}

@@ -847,6 +847,176 @@ interface CalculationDefinition {
     };
 }
 
+/**
+ * Dimension-aware value model for calc evaluation.
+ *
+ * Numbers carry a dimension vector and (optionally) the unit they were
+ * measured in; arithmetic tracks vectors per spec §5.1. `absent` is the
+ * missing-data value: it propagates through arithmetic, reads as `false` in
+ * predicates (applicability decision, #848), and is what `has()` probes.
+ */
+
+type Val = {
+    kind: 'number';
+    value: number;
+    dim: DimVector;
+    unit?: string;
+} | {
+    kind: 'string';
+    value: string;
+} | {
+    kind: 'series';
+    points: Map<number, number>;
+    dim: DimVector;
+    unit?: string;
+} | {
+    kind: 'period';
+    days: number;
+} | {
+    kind: 'absent';
+};
+declare const ABSENT: Val;
+declare function num(value: number, dim?: DimVector, unit?: string): Val;
+declare function str(value: string): Val;
+/** Predicate truthiness: absent → false; numbers → ≠ 0; strings → non-empty. */
+declare function truthy(v: Val): boolean;
+
+/**
+ * Expression evaluator for the composed calculations layer.
+ *
+ * The core owns arithmetic, comparison/logic, and the scalar function table
+ * (min, max, abs, round, floor, ceil, clamp, convert, has). Everything
+ * scope-dependent — metric refs, context nodes, stream aggregates, lookup(),
+ * WQL atoms — resolves through the EvalContext, so the same evaluator serves
+ * segment, workout, and store scopes (spec §3.1).
+ */
+
+declare class CalcEvalError extends Error {
+    constructor(message: string);
+}
+interface EvalContext {
+    /** Resolve a ref atom (metric, context node, library node). ABSENT when missing. */
+    resolveRef(name: string): Val;
+    /**
+     * Extension functions (stream aggregates, lookup). Receives evaluated args
+     * plus the raw arg nodes (aggregates need the filter node unevaluated).
+     * Return undefined to signal "not mine" → CalcEvalError.
+     */
+    callFunction?(name: string, args: Val[], rawArgs: ExprNode[]): Val | undefined;
+    /** Store-scope WQL selections (QueryService). Store scope only. */
+    resolveWql?(node: Extract<ExprNode, {
+        kind: 'wql';
+    }>): Val;
+}
+declare function evaluate(node: ExprNode, ctx: EvalContext): Val;
+
+/**
+ * Lookup table registry (spec §4).
+ *
+ * Tables are adapters over heterogeneous sources (effort resolver, static
+ * maps, user profile) exposing a uniform single-row lookup contract:
+ * `lookup("table", keyExpr, "field")`. Registration is layered —
+ * bundled → dialect → user — with later layers replacing earlier ones
+ * (mirrors the Dialect Stack's personal-overrides-last rule). Miss behavior
+ * is per-table: `absent` yields the absent value; `default-row` yields a
+ * synthetic row so calcs never see a miss.
+ */
+
+interface LookupFieldDef {
+    dimension: DimVector;
+    type: 'number' | 'string';
+}
+interface ILookupTable {
+    readonly id: string;
+    readonly fields: Record<string, LookupFieldDef>;
+    readonly missPolicy: 'absent' | 'default-row';
+    /** Single-row lookup. `absent` tables return undefined on a miss. */
+    get(key: string, field: string): Val | undefined;
+}
+type LookupLayer = 'bundled' | 'dialect' | 'user';
+declare class LookupRegistry {
+    private readonly tables;
+    /** Register a table; a later-or-equal layer replaces the existing entry. */
+    register(table: ILookupTable, layer?: LookupLayer): void;
+    get(tableId: string): ILookupTable | undefined;
+    /** Field dimension for static checking; undefined when table/field unknown. */
+    fieldDim(tableId: string, field: string): DimVector | undefined;
+    /** Runtime lookup honoring the table's miss policy. */
+    lookup(tableId: string, key: string, field: string): Val;
+    /**
+     * EvalContext `callFunction` implementation for `lookup("table", key, "field")`.
+     * Compose with other extension functions (aggregates) at the engine layer.
+     */
+    readonly callFunction: EvalContext['callFunction'];
+}
+
+/**
+ * MetricShakeOutQueue — Two-stage dependency-ordered metric evaluation module.
+ *
+ * Collects static Metrics and statement-level Metric Equations (`metrics:`)
+ * plus workout/query Summary Metrics (`summaries:`) across stacked Property
+ * Notes in specificity precedence:
+ *   Statement/Runtime > Inline Tag > Effort > Equipment > Note Frontmatter > Tag Category
+ *
+ * Stage 1 (`plan`): resolves static metrics and compile-time equations in
+ * topological waves, injects compiler hints, and defers equations whose
+ * required inputs depend on runtime-only atoms (`elapsed`, `spans`, etc.).
+ *
+ * Stage 2 (`log`): resolves all remaining equations against the executed
+ * statement metrics and emits a structured Skipped-Dependency Diagnostic
+ * metric (`origin: 'diagnostic'`, `type: MetricType.Diagnostic`) for any
+ * equation whose required inputs remain absent after the fixed-point pass.
+ */
+
+type PropertySourceLayer = 'statement' | 'tag' | 'effort' | 'equipment' | 'note' | 'category';
+interface PropertyRuleInput {
+    readonly layer: Exclude<PropertySourceLayer, 'statement'>;
+    readonly sourceSlug: string;
+    readonly metrics?: Readonly<Record<string, string | number | readonly string[]>>;
+    readonly summaries?: Readonly<Record<string, string>>;
+    readonly hints?: Readonly<Record<string, unknown>>;
+}
+interface SkippedDependencyDiagnostic {
+    readonly target: string;
+    readonly expression: string;
+    readonly sourceLayer: Exclude<PropertySourceLayer, 'statement'>;
+    readonly sourceSlug: string;
+    readonly missing: readonly string[];
+}
+interface ShakeOutResult {
+    readonly resolved: readonly string[];
+    readonly deferredRuntime: readonly string[];
+    readonly diagnostics: readonly SkippedDependencyDiagnostic[];
+    readonly inferredDims: Readonly<Record<string, DimVector>>;
+}
+interface ShakeOutQueueOptions {
+    readonly stage: 'plan' | 'log';
+    readonly sources: readonly PropertyRuleInput[];
+    readonly lookups?: LookupRegistry;
+    readonly lastEffortSlug?: string;
+}
+/**
+ * Extract `metrics:` and `summaries:` maps from a parsed frontmatter record
+ * (supporting both flat `metrics.foo` / `summaries.bar` keys and nested maps).
+ */
+declare function extractPropertyRulesFromMeta(meta: Readonly<Record<string, unknown>>, layer: Exclude<PropertySourceLayer, 'statement'>, sourceSlug: string): PropertyRuleInput;
+/**
+ * Extract `PropertyRuleInput` records from a `TagIndex` for the given tag slugs.
+ * Supports both statement-level `metrics` (static or equation) and workout-level
+ * `summaries.<key>` contributions on tags (including nested tags).
+ */
+declare function extractTagPropertyRules(tags: TagIndex | undefined, slugs: readonly string[]): PropertyRuleInput[];
+/**
+ * Compile `summaries:` equations across stacked Property Notes into workout-scope
+ * `CalculationDefinition` records. Higher-precedence layers shadow lower layers
+ * when both define the same summary key.
+ */
+declare function compilePropertySummaryCalcs(sources: readonly PropertyRuleInput[]): CalculationDefinition[];
+/**
+ * Run the two-stage Metric Shake-Out Queue on a statement's MetricContainer.
+ */
+declare function runMetricShakeOutQueue(container: MetricContainer, options: ShakeOutQueueOptions): ShakeOutResult;
+
 /**
  * Factory function type for wrapping blocks in debug mode.
  * Receives the original block and returns a wrapped version.
@@ -948,6 +1118,8 @@ interface RuntimeStackOptions extends IRuntimeOptions {
          * bundle a profile applies.
          */
         activeTags?: readonly string[];
+        /** Property Note metric/summary rules active for this run or block. */
+        propertySources?: readonly PropertyRuleInput[];
     };
     /**
      * Sound configuration for this run.
@@ -2819,4 +2991,4 @@ declare function getRuntimeNowMs(): number;
 /** Creates an INowProvider that reads the browser sender-clock when available. */
 declare function createBrowserRuntimeNow(): INowProvider;
 
-export { type SoundProfile as $, type AnalyticsContext as A, type BehaviorEventType as B, type IMemoryLocation as C, type IRuntimeBehavior as D, type EffortResolverOptions as E, type IBlockContext as F, type MetricVisibility as G, type BlockLifecycleOptions as H, type IEquipment as I, type CompletionDecision as J, type IRuntimeMemory as K, TypedMemoryReference as L, type MemoryTag as M, type MemorySearchCriteria as N, type OutputListener as O, type IMemoryReference as P, type RuntimeStackLogger as Q, type ReferenceIndex as R, type SubscribeOptions as S, TimeSpan as T, type Unsubscribe as U, type StackObserver as V, WhiteboardScript as W, type StackSnapshot as X, type StackListener as Y, MemoryTypeEnum as Z, type IAnchorValue as _, type ReferenceResolutionDefaults as a, type SeedPrecedenceTier as a$, type ButtonConfig as a0, type IEventHandler as a1, type HandlerScope as a2, type IScriptRuntime as a3, type TestableBlockConfig as a4, type IRuntimeOptions as a5, ScriptRuntime as a6, type EventHandlerOptions as a7, type EventCallback as a8, type TimerState as a9, type DisplayState as aA, EFFORT_DISCIPLINES as aB, EFFORT_REGISTRY_ORIGINS as aC, type EffortBaseAttributes as aD, type EffortDerivation as aE, type EffortDiscipline as aF, type EffortMaterializer as aG, type EffortResolvedFrom as aH, type FenceDialect as aI, type FragmentDisplayState as aJ, type FragmentState as aK, type IAnalyticsProcessorDescriptor as aL, INTENSITY_TIERS as aM, type IScript as aN, type IntensityTier as aO, type InterceptMode as aP, MemoryLocation as aQ, type MemoryType as aR, type MemoryTypeMap as aS, type MemoryValueOf as aT, NAMED_COMPOUNDS as aU, type ReferenceCatalog as aV, type ResolvedReferences as aW, type RoundState as aX, type RuntimeState as aY, SEED_PRECEDENCE_RANK as aZ, type ScriptRuntimeDependencies as a_, type DimVector as aa, type ExprNode as ab, type CalculationDefinition as ac, type IRealtimeProcessor as ad, type ISummaryProcessor as ae, type CalcLine as af, type CalcScope as ag, type ProjectionResult as ah, type BinaryOp as ai, type ButtonVariant as aj, type ButtonsState as ak, type CalcNode as al, type CalcOrigin as am, type CalcVariant as an, type ChildrenStatusState as ao, type CompletionState as ap, DEFAULT_RESOLVER_OPTIONS as aq, DEFAULT_RUNTIME_OPTIONS as ar, DEFAULT_SOUND_PROFILE as as, DIM_COUNT as at, DIM_ENERGY as au, DIM_LENGTH as av, DIM_MASS as aw, DIM_TIME as ax, DIM_ZERO as ay, DISCIPLINE_FACTORS as az, type IEffort as b, type SoundRule as b0, type SoundTriggerAnchor as b1, type SoundTriggerPoint as b2, type StackEvent as b3, type TimerDirection as b4, VISIBILITY_ICONS as b5, VISIBILITY_LABELS as b6, addDim as b7, compoundName as b8, createBrowserRuntimeNow as b9, createReferenceIndex as ba, dedupeEntitiesByPrecedence as bb, dimEquals as bc, disciplineFactorFor as bd, extractStatementRefs as be, filterTagsByVisibility as bf, formatDim as bg, formatSoundTrigger as bh, frozenNow as bi, getMetricVisibility as bj, getRuntimeNowMs as bk, isDimensionless as bl, isEffortDiscipline as bm, isFragmentTag as bn, parseSoundTrigger as bo, resolveEntityRank as bp, resolveEntityTier as bq, resolveProfileRules as br, resolveSourceRank as bs, resolveSourceTier as bt, slugifyRefLabel as bu, subDim as bv, wallClockNow as bw, type IEffortResolver as c, type IEffortRegistry as d, type EffortResolutionOptions as e, type ResolvedEffort as f, type EffortRegistrySource as g, type IEquipmentRegistry as h, type EquipmentStorageAdapter as i, type EffortStorageAdapter as j, type IRuntimeActionable as k, type IEventBus as l, type IRuntimeStack as m, type IRuntimeClock as n, type IJitCompiler as o, type INowProvider as p, type RuntimeStackOptions as q, type RuntimeError as r, type IEvent as s, type IRuntimeAction as t, type IAnalyticsEngine as u, type IRuntimeBlock as v, type IBehaviorContext as w, type BehaviorEventListener as x, type Unsubscribe$1 as y, type OutputOptions as z };
+export { type SoundProfile as $, type AnalyticsContext as A, type BehaviorEventType as B, type IMemoryLocation as C, type IRuntimeBehavior as D, type EffortResolverOptions as E, type IBlockContext as F, type MetricVisibility as G, type BlockLifecycleOptions as H, type IEquipment as I, type CompletionDecision as J, type IRuntimeMemory as K, TypedMemoryReference as L, type MemoryTag as M, type MemorySearchCriteria as N, type OutputListener as O, type IMemoryReference as P, type RuntimeStackLogger as Q, type ReferenceIndex as R, type SubscribeOptions as S, TimeSpan as T, type Unsubscribe as U, type StackObserver as V, WhiteboardScript as W, type StackSnapshot as X, type StackListener as Y, MemoryTypeEnum as Z, type IAnchorValue as _, type ReferenceResolutionDefaults as a, type MemoryValueOf as a$, type ButtonConfig as a0, type IEventHandler as a1, type HandlerScope as a2, type IScriptRuntime as a3, type TestableBlockConfig as a4, type IRuntimeOptions as a5, ScriptRuntime as a6, type EventHandlerOptions as a7, type EventCallback as a8, type TimerState as a9, DIM_LENGTH as aA, DIM_MASS as aB, DIM_TIME as aC, DIM_ZERO as aD, DISCIPLINE_FACTORS as aE, type DisplayState as aF, EFFORT_DISCIPLINES as aG, EFFORT_REGISTRY_ORIGINS as aH, type EffortBaseAttributes as aI, type EffortDerivation as aJ, type EffortDiscipline as aK, type EffortMaterializer as aL, type EffortResolvedFrom as aM, type EvalContext as aN, type FenceDialect as aO, type FragmentDisplayState as aP, type FragmentState as aQ, type IAnalyticsProcessorDescriptor as aR, INTENSITY_TIERS as aS, type IScript as aT, type IntensityTier as aU, type InterceptMode as aV, type LookupFieldDef as aW, type LookupLayer as aX, MemoryLocation as aY, type MemoryType as aZ, type MemoryTypeMap as a_, type CalculationDefinition as aa, type PropertyRuleInput as ab, type IRealtimeProcessor as ac, type ISummaryProcessor as ad, type DimVector as ae, type CalcLine as af, type ExprNode as ag, type CalcScope as ah, type ILookupTable as ai, LookupRegistry as aj, type ProjectionResult as ak, ABSENT as al, type BinaryOp as am, type ButtonVariant as an, type ButtonsState as ao, CalcEvalError as ap, type CalcNode as aq, type CalcOrigin as ar, type CalcVariant as as, type ChildrenStatusState as at, type CompletionState as au, DEFAULT_RESOLVER_OPTIONS as av, DEFAULT_RUNTIME_OPTIONS as aw, DEFAULT_SOUND_PROFILE as ax, DIM_COUNT as ay, DIM_ENERGY as az, type IEffort as b, NAMED_COMPOUNDS as b0, type PropertySourceLayer as b1, type ReferenceCatalog as b2, type ResolvedReferences as b3, type RoundState as b4, type RuntimeState as b5, SEED_PRECEDENCE_RANK as b6, type ScriptRuntimeDependencies as b7, type SeedPrecedenceTier as b8, type ShakeOutQueueOptions as b9, getMetricVisibility as bA, getRuntimeNowMs as bB, isDimensionless as bC, isEffortDiscipline as bD, isFragmentTag as bE, num as bF, parseSoundTrigger as bG, resolveEntityRank as bH, resolveEntityTier as bI, resolveProfileRules as bJ, resolveSourceRank as bK, resolveSourceTier as bL, runMetricShakeOutQueue as bM, slugifyRefLabel as bN, str as bO, subDim as bP, truthy as bQ, wallClockNow as bR, type ShakeOutResult as ba, type SkippedDependencyDiagnostic as bb, type SoundRule as bc, type SoundTriggerAnchor as bd, type SoundTriggerPoint as be, type StackEvent as bf, type TimerDirection as bg, VISIBILITY_ICONS as bh, VISIBILITY_LABELS as bi, type Val as bj, addDim as bk, compilePropertySummaryCalcs as bl, compoundName as bm, createBrowserRuntimeNow as bn, createReferenceIndex as bo, dedupeEntitiesByPrecedence as bp, dimEquals as bq, disciplineFactorFor as br, evaluate as bs, extractPropertyRulesFromMeta as bt, extractStatementRefs as bu, extractTagPropertyRules as bv, filterTagsByVisibility as bw, formatDim as bx, formatSoundTrigger as by, frozenNow as bz, type IEffortResolver as c, type IEffortRegistry as d, type EffortResolutionOptions as e, type ResolvedEffort as f, type EffortRegistrySource as g, type IEquipmentRegistry as h, type EquipmentStorageAdapter as i, type EffortStorageAdapter as j, type IRuntimeActionable as k, type IEventBus as l, type IRuntimeStack as m, type IRuntimeClock as n, type IJitCompiler as o, type INowProvider as p, type RuntimeStackOptions as q, type RuntimeError as r, type IEvent as s, type IRuntimeAction as t, type IAnalyticsEngine as u, type IRuntimeBlock as v, type IBehaviorContext as w, type BehaviorEventListener as x, type Unsubscribe$1 as y, type OutputOptions as z };

package/dist/index.cjs

@@ -416,12 +416,20 @@ function tagMarkerSlugs(metrics) {
   }
   return slugs;
 }
+function isEquationMetricValue(value) {
+  if (typeof value !== "string") return false;
+  const trimmed = value.trim();
+  if (!trimmed) return false;
+  if (/^[+-]?\d+(?:\.\d+)?(?:\s*[A-Za-z%/][\w%/.-]*)?$/.test(trimmed)) return false;
+  if (/^[a-zA-Z0-9_]+(?:-[a-zA-Z0-9_]+)*$/.test(trimmed)) return false;
+  return /[*/+()]|\s-\s|->|\b(?:convert|sum|avg|min|max|count|last|round|floor|ceil|abs|clamp|lookup|when|and|or)\b/.test(trimmed);
+}
 function tagContributionMetrics(contributions, origin = "parser") {
-  return contributions.map((contribution) => ({
+  return contributions.filter((c) => !c.type.trim().startsWith("summaries.") && !isEquationMetricValue(c.value)).map((contribution) => ({
     type: contribution.type,
     value: contribution.value,
     origin,
-    image: String(contribution.value),
+    image: contribution.unit ? `${String(contribution.value)} ${contribution.unit}` : String(contribution.value),
     ...contribution.unit ? { unit: contribution.unit } : {}
   }));
 }
@@ -9662,6 +9670,37 @@ function isSupportedMetricValue(val) {
 function isPlainObject(val) {
   return Boolean(val) && typeof val === "object" && !Array.isArray(val);
 }
+function extractTagPropertyRules(tags2, slugs) {
+  if (!tags2 || slugs.length === 0) return [];
+  const rules = [];
+  for (const slug of slugs) {
+    const resolved = resolveTagContributions(tags2, slug);
+    if (resolved.metrics.length === 0) continue;
+    const metrics = {};
+    const summaries = {};
+    for (const m of resolved.metrics) {
+      const key = m.type.trim();
+      if (!key) continue;
+      if (key.startsWith("summaries.")) {
+        const subKey = key.slice("summaries.".length).trim();
+        if (subKey && !(subKey in summaries)) {
+          summaries[subKey] = String(m.value);
+        }
+      } else if (!(key in metrics)) {
+        metrics[key] = m.unit ? `${String(m.value)} ${m.unit}` : m.value === null || typeof m.value === "boolean" ? String(m.value) : m.value;
+      }
+    }
+    if (Object.keys(metrics).length > 0 || Object.keys(summaries).length > 0) {
+      rules.push({
+        layer: "tag",
+        sourceSlug: slug,
+        metrics,
+        summaries
+      });
+    }
+  }
+  return rules;
+}
 function compilePropertySummaryCalcs(sources) {
   const ordered = [...sources].sort(
     (a, b) => LAYER_PRECEDENCE[b.layer] - LAYER_PRECEDENCE[a.layer]
@@ -12352,9 +12391,24 @@ var CalcEngine = class {
     const fenced = (d) => !d.fences || d.fences.includes(deps.dialect);
     this.segmentCalcs = registry.byScope("segment").filter(fenced);
     this.workoutCalcs = registry.byScope("workout").filter(fenced);
+    const noteDefinedSummaries = /* @__PURE__ */ new Set();
+    for (const src of deps.propertySources ?? []) {
+      for (const k of Object.keys(src.summaries ?? {})) {
+        noteDefinedSummaries.add(k.trim());
+      }
+    }
     for (const tag of deps.tags?.list() ?? []) {
       const resolved = resolveTagContributions(deps.tags, tag.slug);
-      for (const name2 of resolved.functions) {
+      const carriedNames = [...resolved.functions];
+      for (const m of resolved.metrics) {
+        if (m.type.trim().startsWith("summaries.")) {
+          const summaryId = m.type.trim().slice("summaries.".length).trim();
+          if (summaryId && !noteDefinedSummaries.has(summaryId)) {
+            carriedNames.push(summaryId);
+          }
+        }
+      }
+      for (const name2 of carriedNames) {
         const carriers = this.tagCarriedFunctions.get(name2);
         if (carriers) carriers.add(tag.slug);
         else this.tagCarriedFunctions.set(name2, /* @__PURE__ */ new Set([tag.slug]));
@@ -12417,10 +12471,13 @@ var CalcEngine = class {
     if (output.outputType !== "segment" || !output.isLeaf) return output;
     const effortData = extractEffortData(output.metrics.rawMetrics);
     if (effortData) this.lastSegmentEffort = effortData.resolved.slug;
-    if (this.deps.propertySources && this.deps.propertySources.length > 0) {
+    const appliedTags = this.appliedTags(output);
+    const tagSources = extractTagPropertyRules(this.deps.tags, appliedTags);
+    const allSources = [...tagSources, ...this.deps.propertySources ?? []];
+    if (allSources.length > 0) {
       runMetricShakeOutQueue(output.metrics, {
         stage: "log",
-        sources: this.deps.propertySources,
+        sources: allSources,
         lookups: this.deps.lookups,
         lastEffortSlug: this.lastSegmentEffort
       });
@@ -12439,7 +12496,6 @@ var CalcEngine = class {
     if (climbGrade && typeof climbGrade === "object" && "raw" in climbGrade) {
       effortTags.grade = String(climbGrade.raw);
     }
-    const appliedTags = this.appliedTags(output);
     for (const def of this.segmentCalcs) {
       if (!this.isActive(def, appliedTags)) continue;
       const ctx = this.makeContext(atoms);
@@ -13659,8 +13715,11 @@ function createCalcStack(options) {
   const registry = new CalculationRegistry(lookups);
   for (const def of BUILTIN_CALCS) registry.register(def);
   for (const def of options.calcs ?? []) registry.register(def);
-  if (options.propertySources && options.propertySources.length > 0) {
-    for (const def of compilePropertySummaryCalcs(options.propertySources)) {
+  const allTagSlugs = (options.tags?.list() ?? []).map((t2) => t2.slug);
+  const tagRules = extractTagPropertyRules(options.tags, allTagSlugs);
+  const combinedSources = [...options.propertySources ?? [], ...tagRules];
+  if (combinedSources.length > 0) {
+    for (const def of compilePropertySummaryCalcs(combinedSources)) {
       registry.register(def);
     }
   }
@@ -15978,6 +16037,7 @@ exports.extractStatementRefs = extractStatementRefs;
 exports.extractStatements = extractStatements;
 exports.extractStatementsRaw = extractStatementsRaw;
 exports.extractSyntaxFacts = extractSyntaxFacts;
+exports.extractTagPropertyRules = extractTagPropertyRules;
 exports.filterTagsByVisibility = filterTagsByVisibility;
 exports.findBestFuzzyMatch = findBestFuzzyMatch;
 exports.findTagContributionCycles = findTagContributionCycles;