@harmonia-core/ui 1.0.0

package/dist/capacity/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../lib/capacity/provider.tsx"],"names":[],"mappings":"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"}

package/dist/capacity/signals/aggregator.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @file Aggregates signals from all detectors into a suggested CapacityField.
+ *
+ * Bug fixes vs. original:
+ * - detect() now returns SignalReading[] so readings.push(...) spreads the array.
+ * - getDetectorWeight() now uses a per-detector/dimension lookup table instead of
+ *   ignoring the dimension parameter.
+ * - destroy() uses the optional-chaining destroy?() instead of (detector as any).destroy().
+ */
+import { CapacityField } from '../types';
+export declare class SignalAggregator {
+    private detectors;
+    /**
+     * Per-detector, per-dimension weight overrides.
+     * Falls back to detector.weight for any unlisted combination.
+     *
+     * Rationale for asymmetries:
+     * - TimeDetector: cognitive signal is stronger (diurnal pattern) than temporal
+     *   (weekday/weekend is coarser)
+     * - EnvironmentDetector: emotional signal (color scheme) is a stronger explicit
+     *   preference than temporal (reduced-motion)
+     */
+    private static readonly DIMENSION_WEIGHTS;
+    constructor();
+    /**
+     * Collects signal readings from all detectors and aggregates them into a
+     * confidence-weighted CapacityField.
+     */
+    aggregateSignals(): Promise<CapacityField>;
+    /**
+     * Returns the effective weight for a detector/dimension pair.
+     * Checks DIMENSION_WEIGHTS first; falls back to detector.weight.
+     */
+    private getDetectorWeight;
+    /** Cleans up all detector resources (event listeners, timers). */
+    destroy(): void;
+}
+//# sourceMappingURL=aggregator.d.ts.map

package/dist/capacity/signals/aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregator.d.ts","sourceRoot":"","sources":["../../../lib/capacity/signals/aggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAQzC,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAmB;IAEpC;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CASvC;;IAaF;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC;IA8BhD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IASzB,kEAAkE;IAClE,OAAO;CAKR"}

package/dist/capacity/signals/detectors/environment-detector.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @file Implements signal detectors for environmental preferences.
+ * Reads prefers-reduced-motion (→ temporal) and prefers-color-scheme (→ emotional).
+ *
+ * Bug fixes vs. original:
+ * - Memory leak: stored MediaQueryList refs so removeEventListener unregisters the
+ *   exact same handler that was registered (arrow-function class properties create a
+ *   new reference on each access, so calling this.detect would never unregister).
+ * - Discarded temporal dimension: now returns both temporal and emotional readings.
+ */
+import { SignalDetector, SignalReading } from './types';
+export declare class EnvironmentDetector implements SignalDetector {
+    readonly name = "EnvironmentDetector";
+    readonly weight = 0.8;
+    private mqlReducedMotion;
+    private mqlDarkMode;
+    private readonly handleChange;
+    constructor();
+    /**
+     * Returns two readings:
+     * - temporal:  based on prefers-reduced-motion (low → less time pressure on animations)
+     * - emotional: based on prefers-color-scheme   (dark → slightly lower emotional load)
+     */
+    detect(): SignalReading[];
+    /**
+     * Removes the event listeners registered in the constructor.
+     * Uses the stored refs so the same function reference is unregistered.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=environment-detector.d.ts.map

package/dist/capacity/signals/detectors/environment-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-detector.d.ts","sourceRoot":"","sources":["../../../../lib/capacity/signals/detectors/environment-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD,qBAAa,mBAAoB,YAAW,cAAc;IACxD,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,MAAM,OAAO;IAEtB,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,WAAW,CAA+B;IAIlD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAa;;IAY1C;;;;OAIG;IACH,MAAM,IAAI,aAAa,EAAE;IAqCzB;;;OAGG;IACH,OAAO;CAMR"}

package/dist/capacity/signals/detectors/input-detector.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @file Implements a signal detector for user input patterns (typing speed + error rate).
+ * Assesses cognitive capacity based on typing behaviour.
+ *
+ * Bug fix vs. original:
+ * - errorCount / lastErrorTime tracked errors since an arbitrary past reset; old
+ *   errors counted the same as current ones → replaced with an errorTimes[] sliding
+ *   window so only errors within ERROR_CHECK_WINDOW (5 s) are counted.
+ * - Inference now uses recentErrorCount (integer) instead of a boolean, letting the
+ *   code distinguish a single correction from repeated fumbling.
+ */
+import { SignalDetector, SignalReading } from './types';
+export declare class InputDetector implements SignalDetector {
+    readonly name = "InputDetector";
+    readonly weight = 0.6;
+    private keyPressTimes;
+    private errorTimes;
+    constructor();
+    private handleKeyDown;
+    detect(): SignalReading[];
+    destroy(): void;
+}
+//# sourceMappingURL=input-detector.d.ts.map

package/dist/capacity/signals/detectors/input-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-detector.d.ts","sourceRoot":"","sources":["../../../../lib/capacity/signals/detectors/input-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAKxD,qBAAa,aAAc,YAAW,cAAc;IAClD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,MAAM,OAAO;IAEtB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,UAAU,CAAgB;;IAQlC,OAAO,CAAC,aAAa,CAWnB;IAEF,MAAM,IAAI,aAAa,EAAE;IA4CzB,OAAO;CAKR"}

package/dist/capacity/signals/detectors/interaction-detector.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @file Implements a signal detector for user interaction patterns.
+ * Assesses cognitive capacity from click rate and precision using a rolling window.
+ *
+ * Bug fixes vs. original:
+ * - clickCount / totalClickDistance accumulated forever → replaced with a 60-second
+ *   rolling window so recent behaviour dominates over historical averages.
+ * - IDLE_THRESHOLD_MS was 3 s (too aggressive for focused reading) → raised to 15 s.
+ */
+import { SignalDetector, SignalReading } from './types';
+export declare class InteractionDetector implements SignalDetector {
+    readonly name = "InteractionDetector";
+    readonly weight = 0.7;
+    private lastMouseMoveTime;
+    private lastClickTime;
+    private lastClickPosition;
+    private clickHistory;
+    private idleTimer;
+    private isIdle;
+    constructor();
+    private resetIdleTimer;
+    private handleMouseMove;
+    private handleClick;
+    detect(): SignalReading[];
+    destroy(): void;
+}
+//# sourceMappingURL=interaction-detector.d.ts.map

package/dist/capacity/signals/detectors/interaction-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-detector.d.ts","sourceRoot":"","sources":["../../../../lib/capacity/signals/detectors/interaction-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAWxD,qBAAa,mBAAoB,YAAW,cAAc;IACxD,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,MAAM,OAAO;IAEtB,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,iBAAiB,CAAyC;IAClE,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,MAAM,CAAS;;IAUvB,OAAO,CAAC,cAAc,CAIpB;IAEF,OAAO,CAAC,eAAe,CAGrB;IAEF,OAAO,CAAC,WAAW,CAajB;IAEF,MAAM,IAAI,aAAa,EAAE;IA4CzB,OAAO;CAOR"}

package/dist/capacity/signals/detectors/scroll-detector.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @file Implements a signal detector for scroll velocity.
+ * This detector assesses cognitive capacity based on the user's scrolling behavior.
+ */
+import { SignalDetector, SignalReading } from './types';
+/**
+ * The ScrollDetector class implements the SignalDetector interface
+ * to provide signal readings based on scroll velocity.
+ */
+export declare class ScrollDetector implements SignalDetector {
+    readonly name = "ScrollDetector";
+    readonly weight = 0.5;
+    private lastScrollY;
+    private lastScrollTime;
+    private scrollVelocity;
+    private timeoutId;
+    constructor();
+    /**
+     * Handles the scroll event, debouncing it and calculating scroll velocity.
+     * @private
+     */
+    private handleScroll;
+    /**
+     * Detects and returns a SignalReading based on the current scroll velocity.
+     * It provides insights into the cognitive dimension.
+     *
+     * @returns {SignalReading} A reading indicating the inferred capacity.
+     */
+    detect(): SignalReading[];
+    /**
+     * Cleans up the scroll event listener when the detector is no longer needed.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=scroll-detector.d.ts.map

package/dist/capacity/signals/detectors/scroll-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-detector.d.ts","sourceRoot":"","sources":["../../../../lib/capacity/signals/detectors/scroll-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAIxD;;;GAGG;AACH,qBAAa,cAAe,YAAW,cAAc;IACnD,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,MAAM,OAAO;IAEtB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAA+B;;IAQhD;;;OAGG;IACH,OAAO,CAAC,YAAY,CAsBlB;IAEF;;;;;OAKG;IACH,MAAM,IAAI,aAAa,EAAE;IA6BzB;;OAEG;IACH,OAAO;CAQR"}

package/dist/capacity/signals/detectors/session-detector.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @file Implements a signal detector for session duration.
+ * This detector assesses temporal capacity based on how long the user has been active in the current session.
+ */
+import { SignalDetector, SignalReading } from './types';
+/**
+ * The SessionDetector class implements the SignalDetector interface
+ * to provide signal readings based on the current session duration.
+ */
+export declare class SessionDetector implements SignalDetector {
+    readonly name = "SessionDetector";
+    readonly weight = 0.7;
+    private sessionStartTime;
+    constructor();
+    /**
+     * Detects and returns a SignalReading based on the current session duration.
+     * It provides insights into the temporal dimension.
+     *
+     * @returns {SignalReading} A reading indicating the inferred capacity.
+     */
+    detect(): SignalReading[];
+}
+//# sourceMappingURL=session-detector.d.ts.map

package/dist/capacity/signals/detectors/session-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-detector.d.ts","sourceRoot":"","sources":["../../../../lib/capacity/signals/detectors/session-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD;;;GAGG;AACH,qBAAa,eAAgB,YAAW,cAAc;IACpD,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,MAAM,OAAO;IACtB,OAAO,CAAC,gBAAgB,CAAS;;IAMjC;;;;;OAKG;IACH,MAAM,IAAI,aAAa,EAAE;CA8B1B"}

package/dist/capacity/signals/detectors/time-detector.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @file Implements a signal detector for time-based capacity.
+ * Emits two readings per detect() call: cognitive (hour-of-day diurnal pattern)
+ * and temporal (weekday vs. weekend).
+ */
+import { SignalDetector, SignalReading } from './types';
+/**
+ * The TimeDetector class implements the SignalDetector interface
+ * to provide signal readings based on the current time and day.
+ */
+export declare class TimeDetector implements SignalDetector {
+    readonly name = "TimeDetector";
+    readonly weight = 0.6;
+    /**
+     * Detects and returns SignalReadings based on the current time and day.
+     * Returns two readings: cognitive (hour-of-day) and temporal (weekday/weekend).
+     */
+    detect(): SignalReading[];
+}
+//# sourceMappingURL=time-detector.d.ts.map

package/dist/capacity/signals/detectors/time-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-detector.d.ts","sourceRoot":"","sources":["../../../../lib/capacity/signals/detectors/time-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD;;;GAGG;AACH,qBAAa,YAAa,YAAW,cAAc;IACjD,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,MAAM,OAAO;IAEtB;;;OAGG;IACH,MAAM,IAAI,aAAa,EAAE;CAyC1B"}

package/dist/capacity/signals/detectors/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @file Defines the interfaces for signal detectors and their readings.
+ */
+/**
+ * Represents a signal detector that can detect a specific aspect of user capacity.
+ * detect() returns an array to allow a single detector to emit readings for multiple
+ * dimensions (e.g. TimeDetector emits both cognitive and temporal).
+ */
+export interface SignalDetector {
+    name: string;
+    weight: number;
+    detect(): SignalReading[] | Promise<SignalReading[]>;
+    destroy?(): void;
+}
+/**
+ * Represents a single reading from a signal detector.
+ */
+export interface SignalReading {
+    dimension: 'cognitive' | 'temporal' | 'emotional' | 'valence';
+    value: number;
+    confidence: number;
+    timestamp: number;
+    detectorName: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/capacity/signals/detectors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../lib/capacity/signals/detectors/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,IAAI,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/capacity/signals/signal-bus.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Signal Bus - Type-safe pub/sub for inter-component communication
+ *
+ * Components emit signals, never directly call each other
+ */
+import type { SignalHandler, Unsubscribe, SignalPriority } from "../types";
+declare class SignalBusClass {
+    private handlers;
+    private signalQueue;
+    private processing;
+    /**
+     * Emit a signal to all subscribed handlers
+     */
+    emit<T = unknown>(type: string, payload: T, priority?: SignalPriority, source?: string): void;
+    /**
+     * Subscribe to a specific signal type
+     */
+    subscribe<T = unknown>(type: string, handler: SignalHandler<T>): Unsubscribe;
+    /**
+     * Subscribe to multiple signal types with same handler
+     */
+    subscribeMultiple<T = unknown>(types: string[], handler: SignalHandler<T>): Unsubscribe;
+    /**
+     * Process signal queue
+     */
+    private processQueue;
+    /**
+     * Get count of handlers for a signal type
+     */
+    getHandlerCount(type: string): number;
+    /**
+     * Clear all handlers (useful for testing)
+     */
+    clear(): void;
+}
+export declare const SignalBus: SignalBusClass;
+export declare const SIGNAL_TYPES: {
+    readonly FIELD_ENERGY_CHANGED: "field:energy:changed";
+    readonly FIELD_ATTENTION_CHANGED: "field:attention:changed";
+    readonly FIELD_VALENCE_CHANGED: "field:valence:changed";
+    readonly USER_INTERACTION_START: "user:interaction:start";
+    readonly USER_INTERACTION_END: "user:interaction:end";
+    readonly USER_FOCUS_CHANGED: "user:focus:changed";
+    readonly COMPONENT_MOUNTED: "component:mounted";
+    readonly COMPONENT_UNMOUNTED: "component:unmounted";
+    readonly A11Y_ANNOUNCE: "a11y:announce";
+    readonly A11Y_FOCUS_TRAP: "a11y:focus:trap";
+};
+export {};
+//# sourceMappingURL=signal-bus.d.ts.map

package/dist/capacity/signals/signal-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-bus.d.ts","sourceRoot":"","sources":["../../../lib/capacity/signals/signal-bus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAU,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAMlF,cAAM,cAAc;IAClB,OAAO,CAAC,QAAQ,CAA6C;IAC7D,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,UAAU,CAAQ;IAE1B;;OAEG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,GAAE,cAAyB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAoBvG;;OAEG;IACH,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,WAAW;IAiB5E;;OAEG;IACH,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,WAAW;IAQvF;;OAEG;YACW,YAAY;IAyB1B;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIrC;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAGD,eAAO,MAAM,SAAS,gBAAuB,CAAA;AAM7C,eAAO,MAAM,YAAY;;;;;;;;;;;CAkBf,CAAA"}

package/dist/capacity/types.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Core Types for Capacity-Adaptive UI Framework
+ *
+ * Type definitions that govern the capacity-adaptive system
+ */
+/**
+ * CapacityField - The 4-input model that drives the entire framework
+ *
+ * This is the FIRST-CLASS input object. Everything else derives from this.
+ * - cognitive, temporal, emotional: 0-1 (capacity dimensions)
+ * - valence: -1 to +1 (emotional direction)
+ *
+ * Field → Mode → Tokens → Components is the pipeline.
+ */
+export interface CapacityField {
+    /** Cognitive bandwidth available (0 = overwhelmed, 1 = sharp) */
+    cognitive: number;
+    /** Time/effort budget (0 = rushed, 1 = abundant) */
+    temporal: number;
+    /** Emotional load tolerance (0 = fragile, 1 = resilient) */
+    emotional: number;
+    /** Emotional direction (-1 = negative, 0 = neutral, +1 = positive) */
+    valence: number;
+    /** Energy/activation level (0 = calm, 1 = activated) — Phase 3 */
+    arousal?: number;
+}
+/**
+ * Density modes - How much information to show
+ */
+export type DensityMode = "low" | "medium" | "high";
+/**
+ * Guidance modes - How much explanation/help to provide
+ */
+export type GuidanceMode = "low" | "medium" | "high";
+/**
+ * Motion modes - Animation intensity
+ *
+ * off:        No decorative motion (protective, exhausted)
+ * soothing:   Slow rhythmic motion only (breathe, float, gentle-fade)
+ * subtle:     Grounded, low-amplitude (sacred-fade, hover-lift, bloom)
+ * expressive: Full animation suite (vortex, spiral, morph, helix, vibrate)
+ */
+export type MotionMode = "off" | "soothing" | "subtle" | "expressive";
+/**
+ * Contrast modes - Visual contrast level
+ */
+export type ContrastMode = "standard" | "boosted";
+/**
+ * Choice load modes - Number of options/decisions
+ */
+export type ChoiceLoadMode = "minimal" | "normal";
+/**
+ * Arousal (pace) modes - Animation pacing from arousal level
+ *
+ * calm:      Low arousal (< 0.35) — slow, deliberate pacing
+ * neutral:   Normal arousal (0.35–0.65) — standard pacing
+ * activated: High arousal (> 0.65) — faster, energetic pacing
+ */
+export type ArousalMode = "calm" | "neutral" | "activated";
+/**
+ * Focus modes - Attention guidance for important elements
+ *
+ * default:  No special treatment for important elements
+ * gentle:   Soft highlight on important elements (muted glow, border accent)
+ *           Activated at medium cognitive capacity (calm users)
+ * guided:   Strong attention-drawing animation + contrast boost
+ *           Activated at low cognitive capacity (distracted users)
+ */
+export type FocusMode = "default" | "gentle" | "guided";
+/**
+ * InterfaceMode - The coherent UI state derived from CapacityField
+ *
+ * This prevents "sliders controlling random stuff" and instead gives
+ * "sliders selecting a coherent state"
+ */
+export interface InterfaceMode {
+    density: DensityMode;
+    guidance: GuidanceMode;
+    motion: MotionMode;
+    contrast: ContrastMode;
+    choiceLoad: ChoiceLoadMode;
+    focus: FocusMode;
+    /** Animation pacing derived from arousal (Phase 3) */
+    pace: ArousalMode;
+}
+/**
+ * Human-readable mode labels for UI display
+ */
+export type InterfaceModeLabel = "Calm" | "Focused" | "Exploratory" | "Minimal";
+/**
+ * Three-dimensional model of user capacity
+ * All values normalized to 0-1 range
+ */
+export interface UserCapacity {
+    /** Cognitive bandwidth available (attention, working memory) */
+    cognitive: number;
+    /** Time pressure inverse (1 = abundant time, 0 = urgent) */
+    temporal: number;
+    /** Emotional regulation capacity (1 = regulated, 0 = dysregulated) */
+    emotional: number;
+}
+/**
+ * Two-dimensional affect model (Russell's Circumplex)
+ * Note: Arousal is Phase 2+. Phase 1 uses only valence.
+ */
+export interface EmotionalState {
+    /** Positive/negative affect (-1 to +1) */
+    valence: number;
+    /** Energy/activation level (0 to 1) - Phase 2+ */
+    arousal: number;
+}
+/**
+ * Field value wrapper that tracks change over time
+ * Enables anticipatory component responses
+ */
+export interface FieldValue<T> {
+    /** Current value */
+    value: T;
+    /** Timestamp of last change (ms) */
+    lastChange: number;
+    /** Trend direction: 'rising' | 'falling' | 'stable' */
+    trend: "rising" | "falling" | "stable";
+    /** Rate of change per second (for numeric values) */
+    velocity?: number;
+}
+/**
+ * Priority levels for signal routing
+ */
+export type SignalPriority = "critical" | "high" | "normal" | "low";
+/**
+ * Type-safe signal for inter-component communication
+ */
+export interface Signal<T = unknown> {
+    /** Signal type identifier */
+    type: string;
+    /** Signal payload */
+    payload: T;
+    /** Timestamp of emission */
+    timestamp: number;
+    /** Priority level */
+    priority: SignalPriority;
+    /** Optional source component identifier */
+    source?: string;
+}
+/**
+ * Signal subscription handler
+ */
+export type SignalHandler<T = unknown> = (signal: Signal<T>) => void;
+/**
+ * Cleanup function returned by subscriptions
+ */
+export type Unsubscribe = () => void;
+/**
+ * Multi-modal response specification for components
+ * Components declare how they respond across sensory dimensions
+ */
+export interface ComponentResponse {
+    /** Visual adaptations (color, opacity, scale) */
+    visual: {
+        opacityRange: [number, number];
+        scaleRange: [number, number];
+        colorShift?: {
+            hue?: number;
+            chroma?: number;
+            lightness?: number;
+        };
+    };
+    /** Spatial adaptations (spacing, density) */
+    spatial: {
+        densityRange: [number, number];
+        spacingMultiplier: [number, number];
+    };
+    /** Sonic adaptations (frequency, amplitude) */
+    sonic: {
+        enabled: boolean;
+        frequencyHz?: number;
+        amplitude?: number;
+    };
+    /** Semantic adaptations (verbosity, urgency framing) */
+    semantic: {
+        verbosityLevel: "minimal" | "concise" | "detailed";
+        urgencyFraming: "calm" | "neutral" | "urgent";
+    };
+}
+/**
+ * Energy field - composite of all capacity dimensions
+ * Primary driver of animation intensity and complexity
+ */
+export type EnergyFieldValue = FieldValue<number>;
+/**
+ * Attention field - temporal pressure + focus
+ * Influences information density and urgency cues
+ */
+export type AttentionFieldValue = FieldValue<number>;
+/**
+ * Emotional valence field - affect direction
+ * Influences color warmth and message framing
+ */
+export type EmotionalValenceFieldValue = FieldValue<number>;
+/**
+ * Configuration for field behavior
+ */
+export interface FieldConfig {
+    /** Smoothing factor for field transitions (0-1) */
+    smoothing: number;
+    /** Velocity threshold for trend detection */
+    velocityThreshold: number;
+    /** Debounce time for rapid changes (ms) */
+    debounceMs: number;
+}
+/**
+ * The ambient context every component can read
+ * Components subscribe to specific fields, never the whole context
+ */
+export interface AmbientContext {
+    energy: EnergyFieldValue;
+    attention: AttentionFieldValue;
+    emotionalValence: EmotionalValenceFieldValue;
+    /** Raw user capacity (before field derivation) */
+    userCapacity: UserCapacity;
+    /** Raw emotional state (before field derivation) */
+    emotionalState: EmotionalState;
+}
+/**
+ * Typography roles in the UI hierarchy
+ * Maps to semantic HTML elements
+ */
+export type TypographyRole = "h1" | "h2" | "h3" | "h4" | "body" | "caption" | "label";
+/**
+ * Energy levels derived from EnergyField
+ * Influences sizing bias for cognitive adaptation
+ */
+export type EnergyLevel = "low" | "medium" | "high";
+/**
+ * Attention levels derived from AttentionField
+ * Influences weight and spacing for focus
+ */
+export type AttentionLevel = "low" | "medium" | "high";
+//# sourceMappingURL=types.d.ts.map

package/dist/capacity/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../lib/capacity/types.ts"],"names":[],"mappings":"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"}

package/dist/capacity/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Capacity-Adaptive UI Utilities
+ *
+ * Foundation utilities for proportional design transformations
+ */
+export * from "./typography";
+//# sourceMappingURL=index.d.ts.map

package/dist/capacity/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/capacity/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,cAAc,CAAA"}