@bitcobblers/wod-wiki-lang 0.11.43 → 0.35.2115

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

@@ -141,11 +141,22 @@ interface IEffort {
 }
 interface IEffortRegistry {
     resolve(slug: string): IEffort | null;
+    resolveByAlias(label: string): IEffort | null;
     list(): readonly IEffort[];
     listByOrigin(origin: EffortRegistrySource): readonly IEffort[];
     upsert(effort: IEffort): Promise<void>;
     delete(slug: string): Promise<void>;
     loadBundled(): Promise<void>;
+    isInitialized(): boolean;
+}
+/**
+ * Pluggable asynchronous persistence adapter for user-defined efforts.
+ * Implemented by host environments (e.g. IndexedDB in browser, filesystem in CLI).
+ */
+interface EffortStorageAdapter {
+    load(): Promise<IEffort[]>;
+    save(effort: IEffort): Promise<void>;
+    delete(slug: string): Promise<void>;
 }
 interface EffortResolutionOptions {
     /** Attribute metrics from /effort/:slug query params or logged execution metrics. */
@@ -383,14 +394,141 @@ interface IRuntimeMemory {
     release(reference: IMemoryReference): void;
 }
 
+/**
+ * Configuration for method interception behavior.
+ * Defined here (in runtime/contracts) so that both production runtime
+ * code and the testing layer can reference it without creating a
+ * runtime → testing circular dependency.
+ */
+type InterceptMode = 'passthrough' | 'spy' | 'override' | 'ignore';
+/**
+ * Configuration for TestableBlock behavior.
+ * Used by IRuntimeOptions to allow debug-mode block wrapping.
+ */
+interface TestableBlockConfig {
+    /** Custom ID for easy identification in visualizations */
+    testId?: string;
+    /** Custom label override for display purposes */
+    labelOverride?: string;
+    /** Mode for mount() interception */
+    mountMode?: InterceptMode;
+    /** Custom mount implementation when mode is 'override' */
+    mountOverride?: (runtime: IRuntimeActionable) => IRuntimeAction[];
+    /** Mode for next() interception */
+    nextMode?: InterceptMode;
+    /** Custom next implementation when mode is 'override' */
+    nextOverride?: (runtime: IRuntimeActionable) => IRuntimeAction[];
+    /** Mode for inspectNext() interception */
+    inspectNextMode?: InterceptMode;
+    /** Custom inspectNext implementation when mode is 'override' */
+    inspectNextOverride?: (runtime: IRuntimeActionable) => CompletionDecision;
+    /** Mode for unmount() interception */
+    unmountMode?: InterceptMode;
+    /** Custom unmount implementation when mode is 'override' */
+    unmountOverride?: (runtime: IRuntimeActionable) => IRuntimeAction[];
+    /** Mode for dispose() interception */
+    disposeMode?: InterceptMode;
+    /** Custom dispose implementation when mode is 'override' */
+    disposeOverride?: (runtime: IRuntimeActionable) => void;
+}
+
+/**
+ * Factory function type for wrapping blocks in debug mode.
+ * Receives the original block and returns a wrapped version.
+ */
+type BlockWrapperFactory = (block: IRuntimeBlock, config?: TestableBlockConfig) => IRuntimeBlock;
+/**
+ * Configuration options for ScriptRuntime initialization.
+ * These options control debugging, logging, and testing capabilities.
+ */
+interface IRuntimeOptions {
+    /**
+     * Enable debug mode for the runtime.
+     * When true:
+     * - All blocks pushed to the stack are automatically wrapped with TestableBlock
+     * - Additional lifecycle events are logged
+     */
+    debugMode?: boolean;
+    /**
+     * Custom factory for wrapping blocks when debugMode is true.
+     * If not provided, uses the default TestableBlock wrapper with spy mode.
+     */
+    blockWrapperFactory?: BlockWrapperFactory;
+    /**
+     * Default configuration for TestableBlock wrappers.
+     * Applied to all blocks wrapped in debug mode unless overridden.
+     */
+    defaultTestableConfig?: Partial<TestableBlockConfig>;
+    /**
+     * Enable console logging for runtime debug output.
+     * Automatically set to true when debugMode is true.
+     */
+    enableLogging?: boolean;
+    /**
+     * Custom log handler for debug events.
+     * If provided, called in addition to console logging.
+     */
+    onDebugLog?: (event: DebugLogEvent) => void;
+    /**
+     * Maximum depth for nested actions within a single execution turn.
+     * Defaults to 20 if not specified.
+     */
+    maxActionDepth?: number;
+}
+/**
+ * Types of debug log events
+ */
+type DebugLogEventType = 'block-wrapped' | 'block-mount' | 'block-next' | 'block-unmount' | 'block-dispose' | 'stack-push' | 'stack-pop' | 'memory-allocate' | 'memory-release' | 'event-handled';
+/**
+ * Debug log event structure
+ */
+interface DebugLogEvent {
+    type: DebugLogEventType;
+    timestamp: number;
+    blockKey?: string;
+    blockType?: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Default runtime options
+ */
+declare const DEFAULT_RUNTIME_OPTIONS: Required<Omit<IRuntimeOptions, 'blockWrapperFactory' | 'onDebugLog' | 'defaultTestableConfig'>>;
+interface RuntimeStackWrapper {
+    wrap?: (block: IRuntimeBlock, parent?: IRuntimeBlock) => IRuntimeBlock;
+    cleanup?: (block: IRuntimeBlock) => void;
+}
+interface RuntimeStackLogger {
+    debug?: (message: string, details?: Record<string, unknown>) => void;
+    error?: (message: string, error: unknown, details?: Record<string, unknown>) => void;
+}
+interface RuntimeStackHooks {
+    onBeforePush?: (block: IRuntimeBlock, parent?: IRuntimeBlock) => void;
+    onAfterPush?: (block: IRuntimeBlock, parent?: IRuntimeBlock) => void;
+    onBeforePop?: (block: IRuntimeBlock | undefined) => void;
+    onAfterPop?: (block: IRuntimeBlock | undefined) => void;
+    unregisterByOwner?: (ownerKey: string) => void;
+}
+interface RuntimeStackOptions extends IRuntimeOptions {
+    wrapper?: RuntimeStackWrapper;
+    logger?: RuntimeStackLogger;
+    hooks?: RuntimeStackHooks;
+    analyticsOptions?: {
+        effortResolver?: IEffortResolver;
+        userProfile?: {
+            vo2max?: number;
+        };
+    };
+}
+
 declare class TypedMemoryReference<T> implements IMemoryReference {
     private readonly _memory;
     readonly ownerId: string;
     readonly type: string;
     visibility: 'public' | 'private' | 'inherited';
+    private readonly _logger?;
     id: string;
     private _subscriptions;
-    constructor(_memory: IRuntimeMemory, ownerId: string, type: string, visibility?: 'public' | 'private' | 'inherited');
+    constructor(_memory: IRuntimeMemory, ownerId: string, type: string, visibility?: 'public' | 'private' | 'inherited', _logger?: RuntimeStackLogger | undefined);
     /**
      * Get the current value in an untyped manner.
      * Implements IMemoryReference.value() for debugging and inspection.
@@ -804,7 +942,7 @@ declare class TimeSpan implements TimeSpan$1 {
     started: number;
     ended?: number | undefined;
     constructor(started: number, ended?: number | undefined);
-    static fromJSON(json: any): TimeSpan;
+    static fromJSON(json: TimeSpan$1): TimeSpan;
     /**
      * Create a TimeSpan from Date objects (legacy support/compatibility)
      */
@@ -1035,7 +1173,7 @@ type Unsubscribe$1 = () => void;
 /**
  * Event types that behaviors can subscribe to.
  */
-type BehaviorEventType = 'tick' | 'next' | 'timer:complete' | 'pause' | 'resume' | '*';
+type BehaviorEventType = 'tick' | 'next' | 'timer:complete' | 'timer:reset' | 'timer:pause' | 'timer:resume' | 'timer:skip-attempt' | 'pause' | 'resume' | '*';
 /**
  * Listener function for behavior event subscriptions.
  */
@@ -1318,12 +1456,12 @@ interface IRuntimeBehavior {
      * Legacy API: called when a block is pushed onto the stack.
      * Superseded by onMount. Retained for backward-compatible mock behaviors.
      */
-    onPush?(block: any, clock: any): IRuntimeAction[];
+    onPush?(block: IRuntimeBlock, clock: IRuntimeClock): IRuntimeAction[];
     /**
      * Legacy API: called when a block is popped from the stack.
      * Superseded by onUnmount. Retained for backward-compatible mock behaviors.
      */
-    onPop?(block: any, clock: any): IRuntimeAction[];
+    onPop?(block: IRuntimeBlock, clock: IRuntimeClock): IRuntimeAction[];
 }
 
 /**
@@ -1516,7 +1654,7 @@ interface IRuntimeBlock extends IBlockRef {
      * @param behaviorType Constructor/class of the behavior to find
      * @returns The behavior instance or undefined if not found
      */
-    getBehavior<T extends IRuntimeBehavior>(behaviorType: new (...args: any[]) => T): T | undefined;
+    getBehavior<T extends IRuntimeBehavior>(behaviorType: new (...args: unknown[]) => T): T | undefined;
     /**
      * Read-only list of all behaviors attached to this block.
      * Useful for debug/inspection UIs.
@@ -1756,7 +1894,7 @@ interface ProjectionResult {
      */
     origin?: MetricOrigin;
     /** Optional additional metadata for the projection */
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 
 /**
@@ -1787,132 +1925,6 @@ interface IAnalyticsEngine {
     finalize(): IOutputStatement[];
 }
 
-/**
- * Configuration for method interception behavior.
- * Defined here (in runtime/contracts) so that both production runtime
- * code and the testing layer can reference it without creating a
- * runtime → testing circular dependency.
- */
-type InterceptMode = 'passthrough' | 'spy' | 'override' | 'ignore';
-/**
- * Configuration for TestableBlock behavior.
- * Used by IRuntimeOptions to allow debug-mode block wrapping.
- */
-interface TestableBlockConfig {
-    /** Custom ID for easy identification in visualizations */
-    testId?: string;
-    /** Custom label override for display purposes */
-    labelOverride?: string;
-    /** Mode for mount() interception */
-    mountMode?: InterceptMode;
-    /** Custom mount implementation when mode is 'override' */
-    mountOverride?: (runtime: IRuntimeActionable) => IRuntimeAction[];
-    /** Mode for next() interception */
-    nextMode?: InterceptMode;
-    /** Custom next implementation when mode is 'override' */
-    nextOverride?: (runtime: IRuntimeActionable) => IRuntimeAction[];
-    /** Mode for inspectNext() interception */
-    inspectNextMode?: InterceptMode;
-    /** Custom inspectNext implementation when mode is 'override' */
-    inspectNextOverride?: (runtime: IRuntimeActionable) => CompletionDecision;
-    /** Mode for unmount() interception */
-    unmountMode?: InterceptMode;
-    /** Custom unmount implementation when mode is 'override' */
-    unmountOverride?: (runtime: IRuntimeActionable) => IRuntimeAction[];
-    /** Mode for dispose() interception */
-    disposeMode?: InterceptMode;
-    /** Custom dispose implementation when mode is 'override' */
-    disposeOverride?: (runtime: IRuntimeActionable) => void;
-}
-
-/**
- * Factory function type for wrapping blocks in debug mode.
- * Receives the original block and returns a wrapped version.
- */
-type BlockWrapperFactory = (block: IRuntimeBlock, config?: TestableBlockConfig) => IRuntimeBlock;
-/**
- * Configuration options for ScriptRuntime initialization.
- * These options control debugging, logging, and testing capabilities.
- */
-interface IRuntimeOptions {
-    /**
-     * Enable debug mode for the runtime.
-     * When true:
-     * - All blocks pushed to the stack are automatically wrapped with TestableBlock
-     * - Additional lifecycle events are logged
-     */
-    debugMode?: boolean;
-    /**
-     * Custom factory for wrapping blocks when debugMode is true.
-     * If not provided, uses the default TestableBlock wrapper with spy mode.
-     */
-    blockWrapperFactory?: BlockWrapperFactory;
-    /**
-     * Default configuration for TestableBlock wrappers.
-     * Applied to all blocks wrapped in debug mode unless overridden.
-     */
-    defaultTestableConfig?: Partial<TestableBlockConfig>;
-    /**
-     * Enable console logging for runtime debug output.
-     * Automatically set to true when debugMode is true.
-     */
-    enableLogging?: boolean;
-    /**
-     * Custom log handler for debug events.
-     * If provided, called in addition to console logging.
-     */
-    onDebugLog?: (event: DebugLogEvent) => void;
-    /**
-     * Maximum depth for nested actions within a single execution turn.
-     * Defaults to 20 if not specified.
-     */
-    maxActionDepth?: number;
-}
-/**
- * Types of debug log events
- */
-type DebugLogEventType = 'block-wrapped' | 'block-mount' | 'block-next' | 'block-unmount' | 'block-dispose' | 'stack-push' | 'stack-pop' | 'memory-allocate' | 'memory-release' | 'event-handled';
-/**
- * Debug log event structure
- */
-interface DebugLogEvent {
-    type: DebugLogEventType;
-    timestamp: number;
-    blockKey?: string;
-    blockType?: string;
-    details?: Record<string, any>;
-}
-/**
- * Default runtime options
- */
-declare const DEFAULT_RUNTIME_OPTIONS: Required<Omit<IRuntimeOptions, 'blockWrapperFactory' | 'onDebugLog' | 'defaultTestableConfig'>>;
-interface RuntimeStackWrapper {
-    wrap?: (block: IRuntimeBlock, parent?: IRuntimeBlock) => IRuntimeBlock;
-    cleanup?: (block: IRuntimeBlock) => void;
-}
-interface RuntimeStackLogger {
-    debug?: (message: string, details?: Record<string, unknown>) => void;
-    error?: (message: string, error: unknown, details?: Record<string, unknown>) => void;
-}
-interface RuntimeStackHooks {
-    onBeforePush?: (block: IRuntimeBlock, parent?: IRuntimeBlock) => void;
-    onAfterPush?: (block: IRuntimeBlock, parent?: IRuntimeBlock) => void;
-    onBeforePop?: (block: IRuntimeBlock | undefined) => void;
-    onAfterPop?: (block: IRuntimeBlock | undefined) => void;
-    unregisterByOwner?: (ownerKey: string) => void;
-}
-interface RuntimeStackOptions extends IRuntimeOptions {
-    wrapper?: RuntimeStackWrapper;
-    logger?: RuntimeStackLogger;
-    hooks?: RuntimeStackHooks;
-    analyticsOptions?: {
-        effortResolver?: IEffortResolver;
-        userProfile?: {
-            vo2max?: number;
-        };
-    };
-}
-
 /**
  * AnalyticsContext — shared services injected into the analytics pipeline.
  *
@@ -2351,4 +2363,4 @@ declare function getRuntimeNowMs(): number;
 /** Creates an INowProvider that reads the browser sender-clock when available. */
 declare function createBrowserRuntimeNow(): INowProvider;
 
-export { ScriptRuntime 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 IScript as I, type StackObserver as J, type StackSnapshot as K, type StackListener as L, type MemoryTag as M, MemoryTypeEnum as N, type OutputListener as O, type IAnchorValue as P, type ButtonConfig as Q, type ResolvedEffort as R, type SubscribeOptions as S, TimeSpan as T, type Unsubscribe as U, type IEventHandler as V, WhiteboardScript as W, type HandlerScope as X, type IScriptRuntime as Y, type TestableBlockConfig as Z, type IRuntimeOptions as _, type IEffortResolver as a, type EventHandlerOptions as a0, type EventCallback as a1, type TimerState as a2, type IRealtimeProcessor as a3, type ISummaryProcessor as a4, type ProjectionResult as a5, type ButtonVariant as a6, type ButtonsState as a7, type ChildrenStatusState as a8, type CompletionState as a9, VISIBILITY_ICONS as aA, VISIBILITY_LABELS as aB, createBrowserRuntimeNow as aC, disciplineFactorFor as aD, filterTagsByVisibility as aE, frozenNow as aF, getMetricVisibility as aG, getRuntimeNowMs as aH, isEffortDiscipline as aI, isFragmentTag as aJ, wallClockNow as aK, DEFAULT_RESOLVER_OPTIONS as aa, DEFAULT_RUNTIME_OPTIONS as ab, DISCIPLINE_FACTORS as ac, type DisplayState as ad, EFFORT_DISCIPLINES as ae, EFFORT_REGISTRY_ORIGINS as af, type EffortBaseAttributes as ag, type EffortDerivation as ah, type EffortDiscipline as ai, type EffortResolvedFrom as aj, type FenceDialect as ak, type FragmentDisplayState as al, type FragmentState as am, type IAnalyticsProcessorDescriptor as an, INTENSITY_TIERS as ao, type IntensityTier as ap, type InterceptMode as aq, MemoryLocation as ar, type MemoryType as as, type MemoryTypeMap as at, type MemoryValueOf as au, type RoundState as av, type RuntimeState as aw, type ScriptRuntimeDependencies as ax, type StackEvent as ay, type TimerDirection as az, type IEffortRegistry as b, type IEffort as c, type EffortResolutionOptions as d, type EffortRegistrySource 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 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 };