@dofek/scoring 0.1.0

package/dist/scoring.d.ts.map

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

package/dist/scoring.js

@@ -0,0 +1,325 @@
+import { statusColors, textColors } from "./colors.js";
+/**
+ * Whoop-like 0–21 strain score with display classification.
+ *
+ * Construct directly with a strain value or use `fromRawLoad()` to convert
+ * raw daily training load (duration_min × avg_hr/max_hr) using logarithmic
+ * scaling that produces diminishing returns at higher loads.
+ */
+export class StrainScore {
+    static #SCALE_FACTOR = 2.775;
+    static #MAX = 21;
+    static #ACUTE_LOAD_DAYS = 7;
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    get color() {
+        if (this.value > 17)
+            return statusColors.danger;
+        if (this.value >= 14)
+            return statusColors.warning;
+        if (this.value >= 10)
+            return statusColors.positive;
+        return textColors.secondary;
+    }
+    get label() {
+        if (this.value > 17)
+            return "All Out";
+        if (this.value >= 14)
+            return "High";
+        if (this.value >= 10)
+            return "Moderate";
+        return "Light";
+    }
+    get description() {
+        if (this.value > 17)
+            return "Maximum effort reached. Prioritize recovery tonight.";
+        if (this.value >= 14)
+            return "Significant training load. Monitor fatigue closely.";
+        if (this.value >= 10)
+            return "A productive training day with manageable load.";
+        return "Low load day. You have room for more intensity.";
+    }
+    static fromRawLoad(rawLoad) {
+        if (rawLoad <= 0)
+            return new StrainScore(0);
+        const strain = StrainScore.#SCALE_FACTOR * Math.log(1 + rawLoad);
+        const value = Math.round(Math.min(strain, StrainScore.#MAX) * 10) / 10;
+        return new StrainScore(value);
+    }
+    static fromPhysiologicalLoad(physiologicalLoad) {
+        return StrainScore.fromRawLoad(physiologicalLoad);
+    }
+    static fromAcuteLoad(acuteLoad) {
+        return StrainScore.fromRawLoad(acuteLoad / StrainScore.#ACUTE_LOAD_DAYS);
+    }
+}
+/** Get the color for a recovery/readiness score (0-100) */
+export const SCORE_WARNING_THRESHOLD = 50;
+export const SCORE_RECOVERED_THRESHOLD = 70;
+/** Visual score zones used by charts and cards to keep threshold bands consistent. */
+export const SCORE_ZONES = [
+    { min: 0, max: SCORE_WARNING_THRESHOLD, status: "danger" },
+    { min: SCORE_WARNING_THRESHOLD, max: SCORE_RECOVERED_THRESHOLD, status: "warning" },
+    { min: SCORE_RECOVERED_THRESHOLD, max: 100, status: "positive" },
+];
+export function scoreColor(score) {
+    if (score > SCORE_RECOVERED_THRESHOLD)
+        return statusColors.positive;
+    if (score >= SCORE_WARNING_THRESHOLD)
+        return statusColors.warning;
+    return statusColors.danger;
+}
+/** Get a human-readable label for a recovery score (0-100) */
+export function scoreLabel(score) {
+    if (score > SCORE_RECOVERED_THRESHOLD)
+        return "Recovered";
+    if (score >= SCORE_WARNING_THRESHOLD)
+        return "Moderate";
+    return "Poor";
+}
+/** Get a contextual description for a recovery score explaining what it means */
+export function scoreDescription(score) {
+    if (score > SCORE_RECOVERED_THRESHOLD)
+        return "You're well recovered and ready for high-intensity training.";
+    if (score >= SCORE_WARNING_THRESHOLD)
+        return "Your body is at a moderate recovery level. Steady effort is recommended.";
+    return "Recovery is low. Focus on rest and keep today's effort light.";
+}
+/** Strain zone classification with display properties. */
+export class StrainZone {
+    zone;
+    constructor(zone) {
+        this.zone = zone;
+    }
+    get color() {
+        if (this.zone === "optimal")
+            return statusColors.positive;
+        if (this.zone === "overreaching")
+            return statusColors.danger;
+        if (this.zone === "restoring")
+            return statusColors.info;
+        return textColors.secondary;
+    }
+    get label() {
+        if (this.zone === "optimal")
+            return "Optimal";
+        if (this.zone === "overreaching")
+            return "Overreaching";
+        if (this.zone === "restoring")
+            return "Restoring";
+        return this.zone;
+    }
+}
+/** Workload ratio (ACWR) with display classification. */
+export class WorkloadRatio {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    get color() {
+        if (this.value == null)
+            return textColors.secondary;
+        if (this.value >= 0.8 && this.value <= 1.3)
+            return statusColors.positive;
+        if (this.value >= 0.5 && this.value <= 1.5)
+            return statusColors.warning;
+        return statusColors.danger;
+    }
+    get hint() {
+        if (this.value == null)
+            return null;
+        if (this.value >= 0.8 && this.value <= 1.3)
+            return "Optimal training zone";
+        if (this.value < 0.8)
+            return "Detraining risk - increase load gradually";
+        if (this.value <= 1.5)
+            return "High load - monitor recovery closely";
+        return "Injury risk zone - consider rest";
+    }
+}
+/** Aggregate weekly volume rows into a summary with relative fractions */
+export function aggregateWeeklyVolume(rows) {
+    const weekMap = new Map();
+    for (const row of rows) {
+        weekMap.set(row.week, (weekMap.get(row.week) ?? 0) + row.hours);
+    }
+    const entries = Array.from(weekMap.entries())
+        .sort(([a], [b]) => a.localeCompare(b))
+        .slice(-4);
+    const maxHours = Math.max(...entries.map(([, h]) => h), 1);
+    return entries.map(([week, hours]) => ({
+        week,
+        hours,
+        fraction: hours / maxHours,
+    }));
+}
+/** Determine trend direction from two values */
+export function trendDirection(current, previous) {
+    if (current > previous)
+        return "up";
+    if (current < previous)
+        return "down";
+    return "stable";
+}
+/** Stress score (0-3 Whoop-like scale) with display classification. */
+export class StressScore {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    get color() {
+        if (this.value <= 0.5)
+            return statusColors.positive;
+        if (this.value <= 1.5)
+            return statusColors.warning;
+        if (this.value <= 2.5)
+            return statusColors.elevated;
+        return statusColors.danger;
+    }
+    get label() {
+        if (this.value <= 0.5)
+            return "Low";
+        if (this.value <= 1.5)
+            return "Moderate";
+        if (this.value <= 2.5)
+            return "High";
+        return "Very High";
+    }
+}
+/** Get the color for a trend direction */
+export function trendColor(trend) {
+    if (trend === "improving")
+        return statusColors.positive;
+    if (trend === "worsening" || trend === "declining")
+        return statusColors.danger;
+    return textColors.neutral;
+}
+/** Get the color for a categorical readiness level (high/moderate/low) */
+export function readinessLevelColor(level) {
+    if (level === "high")
+        return statusColors.positive;
+    if (level === "moderate")
+        return statusColors.warning;
+    if (level === "low")
+        return statusColors.danger;
+    return textColors.neutral;
+}
+/** Get the color for a health metric status (excellent/good/fair/poor) */
+export function healthStatusColor(status) {
+    if (status === "excellent")
+        return statusColors.positive;
+    if (status === "good")
+        return statusColors.info;
+    if (status === "fair")
+        return statusColors.warning;
+    return statusColors.danger;
+}
+/** Get the color for a ramp rate value (always uses absolute value) */
+export function rampRateColor(rate) {
+    const absRate = Math.abs(rate);
+    if (absRate < 5)
+        return statusColors.positive;
+    if (absRate <= 7)
+        return statusColors.warning;
+    return statusColors.danger;
+}
+/**
+ * Map a z-score to a 0-100 recovery score using an asymmetric sigmoid.
+ * Tuned to match Whoop's recovery scoring:
+ *   z=0 (at baseline mean) → 62 (average day feels "recovered")
+ *   z=+1 → ~80, z=-1 → ~40
+ *   z=+2 → ~93, z=-2 → ~18
+ * Uses separate scales for positive/negative z to handle the asymmetric center.
+ */
+export function zScoreToRecoveryScore(zScore) {
+    const center = 62;
+    const sigmoidSteepness = 1.1;
+    const sigmoid = 1 / (1 + Math.exp(-zScore * sigmoidSteepness));
+    const scaleUp = 100 - center; // 38: maps sigmoid 0.5→1.0 to 62→100
+    const scaleDown = center; // 62: maps sigmoid 0.0→0.5 to 0→62
+    const score = sigmoid >= 0.5
+        ? center + scaleUp * ((sigmoid - 0.5) / 0.5)
+        : center - scaleDown * ((0.5 - sigmoid) / 0.5);
+    return Math.max(0, Math.min(100, Math.round(score)));
+}
+/** Get the color for a sleep performance tier */
+export function sleepTierColor(tier) {
+    if (tier === "Excellent")
+        return statusColors.positive;
+    if (tier === "Good")
+        return statusColors.info;
+    if (tier === "Fair")
+        return statusColors.warning;
+    return statusColors.danger;
+}
+/** Get a contextual description for a sleep performance tier */
+export function sleepTierDescription(tier) {
+    if (tier === "Excellent")
+        return "Exceptional sleep that fully supports recovery.";
+    if (tier === "Good")
+        return "Solid sleep. You got most of what your body needed.";
+    if (tier === "Fair")
+        return "Below your sleep need. Recovery may be impacted.";
+    return "Significantly short on sleep. Prioritize rest tonight.";
+}
+/** Get the color for sleep debt in minutes */
+export function sleepDebtColor(minutes) {
+    if (minutes <= 0)
+        return statusColors.positive;
+    if (minutes < 120)
+        return statusColors.warning;
+    return statusColors.danger;
+}
+/** Get the color for a sleep performance percentage (actual vs target) */
+export function sleepPerformanceColor(percentage) {
+    if (percentage >= 95)
+        return statusColors.positive;
+    if (percentage >= 85)
+        return statusColors.warning;
+    return statusColors.danger;
+}
+/** Form zone boundaries (intervals.icu defaults) */
+export const FORM_ZONE_TRANSITION = 25;
+export const FORM_ZONE_FRESH = 5;
+export const FORM_ZONE_GREY = -10;
+export const FORM_ZONE_OPTIMAL = -30;
+/** Colors for form (training stress balance) zones */
+export const FORM_ZONE_COLORS = {
+    transition: "#60a5fa",
+    fresh: statusColors.positive,
+    grey: "#a1a1aa",
+    optimal: statusColors.positive,
+    highRisk: statusColors.danger,
+};
+/** Form zone (training stress balance) classification with display properties. */
+export class FormZone {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    get color() {
+        if (this.value > FORM_ZONE_TRANSITION)
+            return FORM_ZONE_COLORS.transition;
+        if (this.value > FORM_ZONE_FRESH)
+            return FORM_ZONE_COLORS.fresh;
+        if (this.value > FORM_ZONE_GREY)
+            return FORM_ZONE_COLORS.grey;
+        if (this.value > FORM_ZONE_OPTIMAL)
+            return FORM_ZONE_COLORS.optimal;
+        return FORM_ZONE_COLORS.highRisk;
+    }
+    get label() {
+        if (this.value > FORM_ZONE_TRANSITION)
+            return "Transition";
+        if (this.value > FORM_ZONE_FRESH)
+            return "Fresh";
+        if (this.value > FORM_ZONE_GREY)
+            return "Grey Zone";
+        if (this.value > FORM_ZONE_OPTIMAL)
+            return "Optimal";
+        return "High Risk";
+    }
+}
+//# sourceMappingURL=scoring.js.map

package/dist/scoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.js","sourceRoot":"","sources":["../src/scoring.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IACtB,MAAM,CAAU,aAAa,GAAG,KAAK,CAAC;IACtC,MAAM,CAAU,IAAI,GAAG,EAAE,CAAC;IAC1B,MAAM,CAAU,gBAAgB,GAAG,CAAC,CAAC;IAE5B,KAAK,CAAS;IACvB,YAAY,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI,KAAK;QACP,IAAI,IAAI,CAAC,KAAK,GAAG,EAAE;YAAE,OAAO,YAAY,CAAC,MAAM,CAAC;QAChD,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE;YAAE,OAAO,YAAY,CAAC,OAAO,CAAC;QAClD,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE;YAAE,OAAO,YAAY,CAAC,QAAQ,CAAC;QACnD,OAAO,UAAU,CAAC,SAAS,CAAC;IAC9B,CAAC;IAED,IAAI,KAAK;QACP,IAAI,IAAI,CAAC,KAAK,GAAG,EAAE;YAAE,OAAO,SAAS,CAAC;QACtC,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE;YAAE,OAAO,MAAM,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE;YAAE,OAAO,UAAU,CAAC;QACxC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,WAAW;QACb,IAAI,IAAI,CAAC,KAAK,GAAG,EAAE;YAAE,OAAO,sDAAsD,CAAC;QACnF,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE;YAAE,OAAO,qDAAqD,CAAC;QACnF,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE;YAAE,OAAO,iDAAiD,CAAC;QAC/E,OAAO,iDAAiD,CAAC;IAC3D,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,OAAe;QAChC,IAAI,OAAO,IAAI,CAAC;YAAE,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,WAAW,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;QACvE,OAAO,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,qBAAqB,CAAC,iBAAyB;QACpD,OAAO,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,CAAC,aAAa,CAAC,SAAiB;QACpC,OAAO,WAAW,CAAC,WAAW,CAAC,SAAS,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAC3E,CAAC;;AAGH,2DAA2D;AAC3D,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAU5C,sFAAsF;AACtF,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,uBAAuB,EAAE,MAAM,EAAE,QAAQ,EAAE;IAC1D,EAAE,GAAG,EAAE,uBAAuB,EAAE,GAAG,EAAE,yBAAyB,EAAE,MAAM,EAAE,SAAS,EAAE;IACnF,EAAE,GAAG,EAAE,yBAAyB,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE;CACjE,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,GAAG,yBAAyB;QAAE,OAAO,YAAY,CAAC,QAAQ,CAAC;IACpE,IAAI,KAAK,IAAI,uBAAuB;QAAE,OAAO,YAAY,CAAC,OAAO,CAAC;IAClE,OAAO,YAAY,CAAC,MAAM,CAAC;AAC7B,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,GAAG,yBAAyB;QAAE,OAAO,WAAW,CAAC;IAC1D,IAAI,KAAK,IAAI,uBAAuB;QAAE,OAAO,UAAU,CAAC;IACxD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,IAAI,KAAK,GAAG,yBAAyB;QACnC,OAAO,8DAA8D,CAAC;IACxE,IAAI,KAAK,IAAI,uBAAuB;QAClC,OAAO,0EAA0E,CAAC;IACpF,OAAO,+DAA+D,CAAC;AACzE,CAAC;AAED,0DAA0D;AAC1D,MAAM,OAAO,UAAU;IACZ,IAAI,CAAS;IACtB,YAAY,IAAY;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,KAAK;QACP,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,YAAY,CAAC,QAAQ,CAAC;QAC1D,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc;YAAE,OAAO,YAAY,CAAC,MAAM,CAAC;QAC7D,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,YAAY,CAAC,IAAI,CAAC;QACxD,OAAO,UAAU,CAAC,SAAS,CAAC;IAC9B,CAAC;IAED,IAAI,KAAK;QACP,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc;YAAE,OAAO,cAAc,CAAC;QACxD,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,WAAW,CAAC;QAClD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF;AAED,yDAAyD;AACzD,MAAM,OAAO,aAAa;IACf,KAAK,CAAgB;IAC9B,YAAY,KAAoB;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI,KAAK;QACP,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI;YAAE,OAAO,UAAU,CAAC,SAAS,CAAC;QACpD,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG;YAAE,OAAO,YAAY,CAAC,QAAQ,CAAC;QACzE,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG;YAAE,OAAO,YAAY,CAAC,OAAO,CAAC;QACxE,OAAO,YAAY,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,IAAI,IAAI;QACN,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG;YAAE,OAAO,uBAAuB,CAAC;QAC3E,IAAI,IAAI,CAAC,KAAK,GAAG,GAAG;YAAE,OAAO,2CAA2C,CAAC;QACzE,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG;YAAE,OAAO,sCAAsC,CAAC;QACrE,OAAO,kCAAkC,CAAC;IAC5C,CAAC;CACF;AAQD,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CAAC,IAA4C;IAChF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;SAC1C,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SACtC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACb,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACrC,IAAI;QACJ,KAAK;QACL,QAAQ,EAAE,KAAK,GAAG,QAAQ;KAC3B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,QAAgB;IAC9D,IAAI,OAAO,GAAG,QAAQ;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,OAAO,GAAG,QAAQ;QAAE,OAAO,MAAM,CAAC;IACtC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,uEAAuE;AACvE,MAAM,OAAO,WAAW;IACb,KAAK,CAAS;IACvB,YAAY,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI,KAAK;QACP,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG;YAAE,OAAO,YAAY,CAAC,QAAQ,CAAC;QACpD,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG;YAAE,OAAO,YAAY,CAAC,OAAO,CAAC;QACnD,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG;YAAE,OAAO,YAAY,CAAC,QAAQ,CAAC;QACpD,OAAO,YAAY,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,IAAI,KAAK;QACP,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG;YAAE,OAAO,KAAK,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG;YAAE,OAAO,UAAU,CAAC;QACzC,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG;YAAE,OAAO,MAAM,CAAC;QACrC,OAAO,WAAW,CAAC;IACrB,CAAC;CACF;AAED,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CAAC,KAAyD;IAClF,IAAI,KAAK,KAAK,WAAW;QAAE,OAAO,YAAY,CAAC,QAAQ,CAAC;IACxD,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,WAAW;QAAE,OAAO,YAAY,CAAC,MAAM,CAAC;IAC/E,OAAO,UAAU,CAAC,OAAO,CAAC;AAC5B,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB,CAAC,KAA8C;IAChF,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,YAAY,CAAC,QAAQ,CAAC;IACnD,IAAI,KAAK,KAAK,UAAU;QAAE,OAAO,YAAY,CAAC,OAAO,CAAC;IACtD,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,YAAY,CAAC,MAAM,CAAC;IAChD,OAAO,UAAU,CAAC,OAAO,CAAC;AAC5B,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,iBAAiB,CAAC,MAA8C;IAC9E,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,YAAY,CAAC,QAAQ,CAAC;IACzD,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,YAAY,CAAC,IAAI,CAAC;IAChD,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,YAAY,CAAC,OAAO,CAAC;IACnD,OAAO,YAAY,CAAC,MAAM,CAAC;AAC7B,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,YAAY,CAAC,QAAQ,CAAC;IAC9C,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,YAAY,CAAC,OAAO,CAAC;IAC9C,OAAO,YAAY,CAAC,MAAM,CAAC;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,MAAM,gBAAgB,GAAG,GAAG,CAAC;IAC7B,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC,qCAAqC;IACnE,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,mCAAmC;IAC7D,MAAM,KAAK,GACT,OAAO,IAAI,GAAG;QACZ,CAAC,CAAC,MAAM,GAAG,OAAO,GAAG,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC5C,CAAC,CAAC,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,cAAc,CAAC,IAA4C;IACzE,IAAI,IAAI,KAAK,WAAW;QAAE,OAAO,YAAY,CAAC,QAAQ,CAAC;IACvD,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,YAAY,CAAC,IAAI,CAAC;IAC9C,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,YAAY,CAAC,OAAO,CAAC;IACjD,OAAO,YAAY,CAAC,MAAM,CAAC;AAC7B,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,oBAAoB,CAAC,IAA4C;IAC/E,IAAI,IAAI,KAAK,WAAW;QAAE,OAAO,iDAAiD,CAAC;IACnF,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,qDAAqD,CAAC;IAClF,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,kDAAkD,CAAC;IAC/E,OAAO,wDAAwD,CAAC;AAClE,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,YAAY,CAAC,QAAQ,CAAC;IAC/C,IAAI,OAAO,GAAG,GAAG;QAAE,OAAO,YAAY,CAAC,OAAO,CAAC;IAC/C,OAAO,YAAY,CAAC,MAAM,CAAC;AAC7B,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CAAC,UAAkB;IACtD,IAAI,UAAU,IAAI,EAAE;QAAE,OAAO,YAAY,CAAC,QAAQ,CAAC;IACnD,IAAI,UAAU,IAAI,EAAE;QAAE,OAAO,YAAY,CAAC,OAAO,CAAC;IAClD,OAAO,YAAY,CAAC,MAAM,CAAC;AAC7B,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAE,CAAC;AAClC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,EAAE,CAAC;AAErC,sDAAsD;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,SAAS;IACrB,KAAK,EAAE,YAAY,CAAC,QAAQ;IAC5B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,YAAY,CAAC,QAAQ;IAC9B,QAAQ,EAAE,YAAY,CAAC,MAAM;CACrB,CAAC;AAEX,kFAAkF;AAClF,MAAM,OAAO,QAAQ;IACV,KAAK,CAAS;IACvB,YAAY,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI,KAAK;QACP,IAAI,IAAI,CAAC,KAAK,GAAG,oBAAoB;YAAE,OAAO,gBAAgB,CAAC,UAAU,CAAC;QAC1E,IAAI,IAAI,CAAC,KAAK,GAAG,eAAe;YAAE,OAAO,gBAAgB,CAAC,KAAK,CAAC;QAChE,IAAI,IAAI,CAAC,KAAK,GAAG,cAAc;YAAE,OAAO,gBAAgB,CAAC,IAAI,CAAC;QAC9D,IAAI,IAAI,CAAC,KAAK,GAAG,iBAAiB;YAAE,OAAO,gBAAgB,CAAC,OAAO,CAAC;QACpE,OAAO,gBAAgB,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,IAAI,KAAK;QACP,IAAI,IAAI,CAAC,KAAK,GAAG,oBAAoB;YAAE,OAAO,YAAY,CAAC;QAC3D,IAAI,IAAI,CAAC,KAAK,GAAG,eAAe;YAAE,OAAO,OAAO,CAAC;QACjD,IAAI,IAAI,CAAC,KAAK,GAAG,cAAc;YAAE,OAAO,WAAW,CAAC;QACpD,IAAI,IAAI,CAAC,KAAK,GAAG,iBAAiB;YAAE,OAAO,SAAS,CAAC;QACrD,OAAO,WAAW,CAAC;IACrB,CAAC;CACF"}

package/dist/sleep-performance.d.ts

@@ -0,0 +1,36 @@
+export type SleepTier = "Excellent" | "Good" | "Fair" | "Poor";
+export interface SleepPerformanceResult {
+    /** Performance score 0-100 */
+    score: number;
+    /** Tier label */
+    tier: SleepTier;
+    /** Component scores used to calculate performance */
+    components?: SleepPerformanceComponents;
+}
+export interface SleepPerformanceComponents {
+    hours: number;
+    efficiency: number;
+    consistency: number | null;
+    lowStress: number | null;
+}
+export interface SleepPerformanceComponentInput {
+    consistency?: number | null;
+    lowStress?: number | null;
+}
+/**
+ * Compute sleep performance from actual vs needed sleep and efficiency.
+ * When consistency and stress components are supplied, score is the equal
+ * average of all available provider-agnostic component scores.
+ * Otherwise, preserves the original 70% sufficiency + 30% efficiency blend.
+ * Tiers: Excellent (90+), Good (70-89), Fair (50-69), Poor (<50).
+ */
+export declare function computeSleepPerformance(actualMinutes: number, neededMinutes: number, efficiency: number, componentInput?: SleepPerformanceComponentInput): SleepPerformanceResult;
+/**
+ * Compute recommended bedtime given a wake time and sleep need.
+ * @param wakeTime - Wake time in "HH:MM" format
+ * @param sleepNeedMinutes - Total sleep need in minutes
+ * @param fallAsleepMinutes - Estimated time to fall asleep (default 15)
+ * @returns Recommended bedtime in "HH:MM" format
+ */
+export declare function computeRecommendedBedtime(wakeTime: string, sleepNeedMinutes: number, fallAsleepMinutes?: number): string;
+//# sourceMappingURL=sleep-performance.d.ts.map

package/dist/sleep-performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep-performance.d.ts","sourceRoot":"","sources":["../src/sleep-performance.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,qDAAqD;IACrD,UAAU,CAAC,EAAE,0BAA0B,CAAC;CACzC;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,8BAA8B;IAC7C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAaD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,8BAA8B,GAC9C,sBAAsB,CA6BxB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,SAAK,GACrB,MAAM,CAWR"}

package/dist/sleep-performance.js

@@ -0,0 +1,59 @@
+function clampPercent(value) {
+    return Math.min(Math.max(value, 0), 100);
+}
+function tierFromScore(score) {
+    if (score >= 90)
+        return "Excellent";
+    if (score >= 70)
+        return "Good";
+    if (score >= 50)
+        return "Fair";
+    return "Poor";
+}
+/**
+ * Compute sleep performance from actual vs needed sleep and efficiency.
+ * When consistency and stress components are supplied, score is the equal
+ * average of all available provider-agnostic component scores.
+ * Otherwise, preserves the original 70% sufficiency + 30% efficiency blend.
+ * Tiers: Excellent (90+), Good (70-89), Fair (50-69), Poor (<50).
+ */
+export function computeSleepPerformance(actualMinutes, neededMinutes, efficiency, componentInput) {
+    const rawSufficiency = neededMinutes > 0 ? Math.min(actualMinutes / neededMinutes, 1) * 100 : 100;
+    const hours = Math.round(rawSufficiency);
+    const normalizedEfficiency = Math.round(clampPercent(efficiency));
+    const consistency = componentInput?.consistency != null
+        ? Math.round(clampPercent(componentInput.consistency))
+        : null;
+    const lowStress = componentInput?.lowStress != null ? Math.round(clampPercent(componentInput.lowStress)) : null;
+    const components = {
+        hours,
+        efficiency: normalizedEfficiency,
+        consistency,
+        lowStress,
+    };
+    const componentScores = [hours, normalizedEfficiency, consistency, lowStress].filter((value) => value != null);
+    const hasExtraComponents = consistency != null || lowStress != null;
+    const score = !hasExtraComponents
+        ? Math.round(rawSufficiency * 0.7 + normalizedEfficiency * 0.3)
+        : Math.round(componentScores.reduce((sum, value) => sum + value, 0) / componentScores.length);
+    const clampedScore = Math.min(Math.max(score, 0), 100);
+    return { score: clampedScore, tier: tierFromScore(clampedScore), components };
+}
+/**
+ * Compute recommended bedtime given a wake time and sleep need.
+ * @param wakeTime - Wake time in "HH:MM" format
+ * @param sleepNeedMinutes - Total sleep need in minutes
+ * @param fallAsleepMinutes - Estimated time to fall asleep (default 15)
+ * @returns Recommended bedtime in "HH:MM" format
+ */
+export function computeRecommendedBedtime(wakeTime, sleepNeedMinutes, fallAsleepMinutes = 15) {
+    const [wakeHours, wakeMinutes] = wakeTime.split(":").map(Number);
+    const wakeTotalMinutes = (wakeHours ?? 0) * 60 + (wakeMinutes ?? 0);
+    const bedtimeTotalMinutes = wakeTotalMinutes - sleepNeedMinutes - fallAsleepMinutes;
+    // Normalize to 0-1440 range (wrap around midnight)
+    const normalized = ((bedtimeTotalMinutes % 1440) + 1440) % 1440;
+    const hours = Math.floor(normalized / 60);
+    const minutes = normalized % 60;
+    return `${hours.toString().padStart(2, "0")}:${minutes.toString().padStart(2, "0")}`;
+}
+//# sourceMappingURL=sleep-performance.js.map

package/dist/sleep-performance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep-performance.js","sourceRoot":"","sources":["../src/sleep-performance.ts"],"names":[],"mappings":"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"}

package/dist/strain-target.d.ts

@@ -0,0 +1,18 @@
+export interface StrainTargetResult {
+    /** Recommended strain target for the day (0-21 scale) */
+    targetStrain: number;
+    /** Zone label */
+    zone: "Push" | "Maintain" | "Recovery";
+    /** Human-readable explanation */
+    explanation: string;
+}
+/**
+ * Compute a daily strain target based on readiness, chronic load, and acute load.
+ *
+ * - High readiness (70+): target 14-18, Push zone
+ * - Moderate readiness (50-69): target 10-14, Maintain zone
+ * - Low readiness (<50): target 4-10, Recovery zone
+ * - If ACWR (acute/chronic) > 1.3, caps the target to prevent injury
+ */
+export declare function computeStrainTarget(readinessScore: number, chronicLoad: number, acuteLoad: number): StrainTargetResult;
+//# sourceMappingURL=strain-target.d.ts.map

package/dist/strain-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strain-target.d.ts","sourceRoot":"","sources":["../src/strain-target.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;IACvC,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,kBAAkB,CAoDpB"}

package/dist/strain-target.js

@@ -0,0 +1,59 @@
+/**
+ * Compute a daily strain target based on readiness, chronic load, and acute load.
+ *
+ * - High readiness (70+): target 14-18, Push zone
+ * - Moderate readiness (50-69): target 10-14, Maintain zone
+ * - Low readiness (<50): target 4-10, Recovery zone
+ * - If ACWR (acute/chronic) > 1.3, caps the target to prevent injury
+ */
+export function computeStrainTarget(readinessScore, chronicLoad, acuteLoad) {
+    let zone;
+    let minStrain;
+    let maxStrain;
+    if (readinessScore >= 70) {
+        zone = "Push";
+        minStrain = 14;
+        maxStrain = 18;
+    }
+    else if (readinessScore >= 50) {
+        zone = "Maintain";
+        minStrain = 10;
+        maxStrain = 14;
+    }
+    else {
+        zone = "Recovery";
+        minStrain = 4;
+        maxStrain = 10;
+    }
+    // Interpolate within the zone based on readiness
+    const zoneReadinessMin = zone === "Push" ? 70 : zone === "Maintain" ? 50 : 0;
+    const zoneReadinessMax = zone === "Push" ? 100 : zone === "Maintain" ? 69 : 49;
+    const fraction = Math.min(1, Math.max(0, (readinessScore - zoneReadinessMin) / (zoneReadinessMax - zoneReadinessMin)));
+    let targetStrain = minStrain + fraction * (maxStrain - minStrain);
+    // Cap if ACWR is too high (injury risk)
+    let explanation;
+    const acwr = chronicLoad > 0 ? acuteLoad / chronicLoad : 0;
+    if (acwr > 1.3 && chronicLoad > 0) {
+        const cappedTarget = Math.min(targetStrain, 12);
+        if (cappedTarget < targetStrain) {
+            targetStrain = cappedTarget;
+            zone = targetStrain < 10 ? "Recovery" : "Maintain";
+        }
+        explanation = `Your acute:chronic workload ratio (${acwr.toFixed(2)}) is elevated. Strain target capped to reduce injury risk.`;
+    }
+    else if (zone === "Push") {
+        explanation = `Recovery is strong (${readinessScore}). Push for a high-strain day to build fitness.`;
+    }
+    else if (zone === "Maintain") {
+        explanation = `Moderate recovery (${readinessScore}). Aim for a steady training day.`;
+    }
+    else {
+        explanation = `Recovery is low (${readinessScore}). Keep it light and focus on restoration.`;
+    }
+    return {
+        targetStrain: Math.round(targetStrain * 10) / 10,
+        zone,
+        explanation,
+    };
+}
+//# sourceMappingURL=strain-target.js.map

package/dist/strain-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strain-target.js","sourceRoot":"","sources":["../src/strain-target.ts"],"names":[],"mappings":"AASA;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,cAAsB,EACtB,WAAmB,EACnB,SAAiB;IAEjB,IAAI,IAAgC,CAAC;IACrC,IAAI,SAAiB,CAAC;IACtB,IAAI,SAAiB,CAAC;IAEtB,IAAI,cAAc,IAAI,EAAE,EAAE,CAAC;QACzB,IAAI,GAAG,MAAM,CAAC;QACd,SAAS,GAAG,EAAE,CAAC;QACf,SAAS,GAAG,EAAE,CAAC;IACjB,CAAC;SAAM,IAAI,cAAc,IAAI,EAAE,EAAE,CAAC;QAChC,IAAI,GAAG,UAAU,CAAC;QAClB,SAAS,GAAG,EAAE,CAAC;QACf,SAAS,GAAG,EAAE,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,UAAU,CAAC;QAClB,SAAS,GAAG,CAAC,CAAC;QACd,SAAS,GAAG,EAAE,CAAC;IACjB,CAAC;IAED,iDAAiD;IACjD,MAAM,gBAAgB,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,gBAAgB,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CACvB,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,cAAc,GAAG,gBAAgB,CAAC,GAAG,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,CACzF,CAAC;IACF,IAAI,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAElE,wCAAwC;IACxC,IAAI,WAAmB,CAAC;IACxB,MAAM,IAAI,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3D,IAAI,IAAI,GAAG,GAAG,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAChD,IAAI,YAAY,GAAG,YAAY,EAAE,CAAC;YAChC,YAAY,GAAG,YAAY,CAAC;YAC5B,IAAI,GAAG,YAAY,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QACrD,CAAC;QACD,WAAW,GAAG,sCAAsC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,4DAA4D,CAAC;IAClI,CAAC;SAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,WAAW,GAAG,uBAAuB,cAAc,iDAAiD,CAAC;IACvG,CAAC;SAAM,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,WAAW,GAAG,sBAAsB,cAAc,mCAAmC,CAAC;IACxF,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,oBAAoB,cAAc,4CAA4C,CAAC;IAC/F,CAAC;IAED,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,GAAG,EAAE;QAChD,IAAI;QACJ,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/tokens.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Design tokens shared across web and iOS.
+ *
+ * Platform-agnostic values — no React, no HTML, no React Native.
+ * Web uses these via Tailwind @theme + CSS. iOS uses them in StyleSheets.
+ *
+ * Colors live in ./colors.ts (separate module for historical reasons).
+ */
+export declare const fontFamily: {
+    /** Body text — Inter on web, system default on iOS until fonts load */
+    readonly body: "Inter";
+    /** Monospace for numbers, metrics, code — DM Mono on web, Menlo on iOS */
+    readonly mono: "DM Mono";
+};
+export declare const fontSize: {
+    readonly xs: 11;
+    readonly sm: 13;
+    readonly base: 14;
+    readonly lg: 16;
+    readonly xl: 20;
+    readonly "2xl": 24;
+    readonly "3xl": 30;
+    readonly "4xl": 36;
+    readonly "5xl": 48;
+};
+export declare const fontWeight: {
+    readonly normal: "400";
+    readonly medium: "500";
+    readonly semibold: "600";
+    readonly bold: "700";
+    readonly extrabold: "800";
+};
+export declare const duration: {
+    /** Micro-interactions: hover, press, toggle */
+    readonly fast: 150;
+    /** Standard transitions: fade, slide */
+    readonly normal: 300;
+    /** Content reveals: card appear, section expand */
+    readonly slow: 500;
+    /** Count-up numbers */
+    readonly countUp: 800;
+    /** Ring draw-in, chart bars grow */
+    readonly chart: 1200;
+    /** Logo heartbeat cycle */
+    readonly heartbeat: 3000;
+};
+export declare const easing: {
+    /** Standard ease-out for most transitions */
+    readonly out: "cubic-bezier(0.16, 1, 0.3, 1)";
+    /** Ease-in-out for looping animations */
+    readonly inOut: "cubic-bezier(0.4, 0, 0.2, 1)";
+    /** ECharts cubic out */
+    readonly echartsOut: "cubicOut";
+};
+export declare const spacing: {
+    /** Tight: between related items (icon + label) */
+    readonly xs: 4;
+    /** Default gap between cards in a row */
+    readonly sm: 8;
+    /** Section padding, card internal spacing */
+    readonly md: 16;
+    /** Between dashboard sections */
+    readonly lg: 24;
+    /** Page margins */
+    readonly xl: 32;
+};
+export declare const radius: {
+    /** Pill shapes, status dots */
+    readonly full: 9999;
+    /** Cards, major containers */
+    readonly xl: 16;
+    /** Secondary containers, modals */
+    readonly lg: 12;
+    /** Buttons, inputs */
+    readonly md: 8;
+    /** Small elements, badges */
+    readonly sm: 4;
+};
+export declare const chart: {
+    /** Default chart height in px */
+    readonly defaultHeight: 250;
+    /** Stagger delay between bar animations (ms) */
+    readonly barStaggerDelay: 50;
+    /** Grid padding defaults (px) */
+    readonly grid: {
+        readonly top: 30;
+        readonly right: 12;
+        readonly bottom: 30;
+        readonly left: 40;
+    };
+    /** Grid padding when chart has dual y-axes */
+    readonly gridDualAxis: {
+        readonly top: 30;
+        readonly right: 60;
+        readonly bottom: 30;
+        readonly left: 50;
+    };
+};
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,UAAU;IACrB,uEAAuE;;IAEvE,0EAA0E;;CAElE,CAAC;AAEX,eAAO,MAAM,QAAQ;;;;;;;;;;CAUX,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;;CAMb,CAAC;AAIX,eAAO,MAAM,QAAQ;IACnB,+CAA+C;;IAE/C,wCAAwC;;IAExC,mDAAmD;;IAEnD,uBAAuB;;IAEvB,oCAAoC;;IAEpC,2BAA2B;;CAEnB,CAAC;AAEX,eAAO,MAAM,MAAM;IACjB,6CAA6C;;IAE7C,yCAAyC;;IAEzC,wBAAwB;;CAEhB,CAAC;AAIX,eAAO,MAAM,OAAO;IAClB,kDAAkD;;IAElD,yCAAyC;;IAEzC,6CAA6C;;IAE7C,iCAAiC;;IAEjC,mBAAmB;;CAEX,CAAC;AAIX,eAAO,MAAM,MAAM;IACjB,+BAA+B;;IAE/B,8BAA8B;;IAE9B,mCAAmC;;IAEnC,sBAAsB;;IAEtB,6BAA6B;;CAErB,CAAC;AAMX,eAAO,MAAM,KAAK;IAChB,iCAAiC;;IAEjC,gDAAgD;;IAEhD,iCAAiC;;;;;;;IAOjC,8CAA8C;;;;;;;CAOtC,CAAC"}