@shaxpir/duiduidui-models 1.17.1 → 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/dist/util/PinyinValidator.js

@@ -19,6 +19,7 @@ const VALID_SYLLABLES = new Set([
     // === Zero-initial (standalone vowel syllables) ===
     'a', 'ai', 'an', 'ang', 'ao',
     'e', 'ei', 'en', 'eng', 'er',
+    'ng', // 嗯 (nasal interjection, sometimes written ǹg or ńg)
     'o', 'ou',
     // === y- initial (represents i-/ü- standalone) ===
     'ya', 'yao', 'yan', 'yang',
@@ -188,14 +189,15 @@ const UMLAUT_VARIANT_MAP = (() => {
     return map;
 })();
 // Tone marks that might appear in pinyin (including v with combining tone marks)
-const TONE_MARKS = /[āáǎàēéěèīíǐìōóǒòūúǔùǖǘǚǜ]|v[\u0301\u030C\u0300]?/g;
+const TONE_MARKS = /[āáǎàēéěèīíǐìōóǒòūúǔùǖǘǚǜńňǹ]|v[\u0301\u030C\u0300]?/g;
 const TONE_MAP = {
     'ā': 'a', 'á': 'a', 'ǎ': 'a', 'à': 'a',
     'ē': 'e', 'é': 'e', 'ě': 'e', 'è': 'e',
     'ī': 'i', 'í': 'i', 'ǐ': 'i', 'ì': 'i',
     'ō': 'o', 'ó': 'o', 'ǒ': 'o', 'ò': 'o',
     'ū': 'u', 'ú': 'u', 'ǔ': 'u', 'ù': 'u',
-    'ǖ': 'ü', 'ǘ': 'ü', 'ǚ': 'ü', 'ǜ': 'ü'
+    'ǖ': 'ü', 'ǘ': 'ü', 'ǚ': 'ü', 'ǜ': 'ü',
+    'ń': 'n', 'ň': 'n', 'ǹ': 'n'
 };
 // Maps toned vowels to base letters with ü→v (pipeline convention)
 // Includes both lowercase and uppercase variants.

package/package.json

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