@shaxpir/duiduidui-models 1.17.2 → 1.17.3

package/dist/models/CognitiveLoad.d.ts

@@ -81,6 +81,34 @@ export declare class CognitiveLoadModel {
      * @returns Capacity value (higher = can manage more cards)
      */
     static calculateCapacity(skillLevel: number): number;
+    /**
+     * Calculate the skill-independent "raw" contribution of a single card.
+     *
+     * This is the numerator of the per-card load formula, factoring out the
+     * skill-dependent divisor so that a running sum can be maintained incrementally.
+     *
+     * Formula: raw = attention(α,β) × mastery(θ) × √difficulty
+     *
+     * The full card load is: raw / effectiveSkill^1.1
+     * (where 1.1 = 0.5 from relativeWeight's sqrt + 0.6 from capacity)
+     *
+     * @returns Non-negative raw contribution
+     */
+    static calculateRawContribution(card: CognitiveLoadCard): number;
+    /**
+     * Convert a raw load sum to a total cognitive load using the current skill level.
+     *
+     * Formula: totalLoad = rawLoadSum / effectiveSkill^1.1
+     *
+     * @returns Total load (0.0 = no cards, 0.8 = near capacity, >1.0 = overloaded)
+     */
+    static totalLoadFromRawSum(rawLoadSum: number, skillLevel: number): number;
+    /**
+     * Calculate the raw load sum for a full set of cards (used for initial seeding).
+     *
+     * @returns The sum of raw contributions across all cards
+     */
+    static calculateRawLoadSum(cards: CognitiveLoadCard[]): number;
     /**
      * Calculate the cognitive load contribution of a single card.
      *

package/dist/models/CognitiveLoad.js

@@ -87,6 +87,47 @@ class CognitiveLoadModel {
         const effectiveSkill = Math.max(skillLevel, exports.MIN_SKILL);
         return Math.pow(effectiveSkill, exports.CAPACITY_EXPONENT);
     }
+    /**
+     * Calculate the skill-independent "raw" contribution of a single card.
+     *
+     * This is the numerator of the per-card load formula, factoring out the
+     * skill-dependent divisor so that a running sum can be maintained incrementally.
+     *
+     * Formula: raw = attention(α,β) × mastery(θ) × √difficulty
+     *
+     * The full card load is: raw / effectiveSkill^1.1
+     * (where 1.1 = 0.5 from relativeWeight's sqrt + 0.6 from capacity)
+     *
+     * @returns Non-negative raw contribution
+     */
+    static calculateRawContribution(card) {
+        const attention = CognitiveLoadModel.calculateAttention(card.alpha, card.beta);
+        const masteryFactor = CognitiveLoadModel.calculateMasteryFactor(card.theta);
+        return attention * masteryFactor * Math.sqrt(card.difficulty);
+    }
+    /**
+     * Convert a raw load sum to a total cognitive load using the current skill level.
+     *
+     * Formula: totalLoad = rawLoadSum / effectiveSkill^1.1
+     *
+     * @returns Total load (0.0 = no cards, 0.8 = near capacity, >1.0 = overloaded)
+     */
+    static totalLoadFromRawSum(rawLoadSum, skillLevel) {
+        const effectiveSkill = Math.max(skillLevel, exports.MIN_SKILL);
+        return rawLoadSum / Math.pow(effectiveSkill, exports.CAPACITY_EXPONENT + 0.5);
+    }
+    /**
+     * Calculate the raw load sum for a full set of cards (used for initial seeding).
+     *
+     * @returns The sum of raw contributions across all cards
+     */
+    static calculateRawLoadSum(cards) {
+        let total = 0;
+        for (const card of cards) {
+            total += CognitiveLoadModel.calculateRawContribution(card);
+        }
+        return total;
+    }
     /**
      * Calculate the cognitive load contribution of a single card.
      *

package/dist/models/Progress.d.ts

@@ -24,6 +24,7 @@ export interface StreakData {
 export interface ProgressPayload {
     skill_level: SkillLevel;
     cognitive_load: number;
+    raw_load_sum?: number;
     streaks?: StreakData;
     total_review_count: number;
 }
@@ -47,6 +48,8 @@ export declare class Progress extends Content {
     setSkillLevelMu(mu: number): void;
     setSkillLevelSigma(sigma: number): void;
     setCognitiveLoad(value: number): void;
+    getRawLoadSum(): number | undefined;
+    setRawLoadSum(value: number): void;
     getStreaks(): StreakData | undefined;
     setStreaks(streaks: StreakData): void;
     getTotalReviewCount(): number;

package/dist/models/Progress.js

@@ -102,6 +102,18 @@ class Progress extends Content_1.Content {
             batch.commit();
         }
     }
+    getRawLoadSum() {
+        this.checkDisposed("Progress.getRawLoadSum");
+        return this.payload.raw_load_sum;
+    }
+    setRawLoadSum(value) {
+        this.checkDisposed("Progress.setRawLoadSum");
+        if (this.payload.raw_load_sum !== value) {
+            const batch = new Operation_1.BatchOperation(this);
+            batch.setPathValue(['payload', 'raw_load_sum'], value);
+            batch.commit();
+        }
+    }
     getStreaks() {
         this.checkDisposed("Progress.getStreaks");
         return this.payload.streaks ? shaxpir_common_1.Struct.clone(this.payload.streaks) : undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shaxpir/duiduidui-models",
-  "version": "1.17.2",
+  "version": "1.17.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/shaxpir/duiduidui-models"