ts-fsrs 3.0.5 → 3.1.0-beta1

package/dist/default.js

@@ -29,7 +29,7 @@ exports.default_w = exports.envParams.FSRS_W || [
     0.34, 1.26, 0.29, 2.61,
 ];
 exports.default_enable_fuzz = exports.envParams.FSRS_ENABLE_FUZZ || false;
-exports.FSRSVersion = "3.0.5";
+exports.FSRSVersion = "3.1.0-beta1";
 const generatorParameters = (props) => {
     return {
         request_retention: props?.request_retention || exports.default_request_retention,
@@ -49,6 +49,7 @@ const createEmptyCard = (now) => {
         reps: 0,
         lapses: 0,
         state: index_1.State.New,
+        last_review: undefined,
     };
 };
 exports.createEmptyCard = createEmptyCard;

package/dist/fsrs.d.ts

@@ -1,11 +1,11 @@
-import { FSRSParameters, Card, CardInput, DateInput, RecordLog } from "./models";
+import { Card, CardInput, DateInput, FSRSParameters, RecordLog, ReviewLogInput } from "./models";
 import { FSRSAlgorithm } from "./algorithm";
 export declare class FSRS extends FSRSAlgorithm {
     constructor(param: Partial<FSRSParameters>);
-    preProcess(_card: CardInput, _now: DateInput): {
-        card: Card;
-        now: Date;
-    };
+    private preProcessCard;
+    private preProcessDate;
+    private preProcessLog;
     repeat: (card: CardInput, now: DateInput) => RecordLog;
     get_retrievability: (card: Card, now: Date) => undefined | string;
+    rollback: (card: CardInput, log: ReviewLogInput) => Card;
 }

package/dist/fsrs.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FSRS = void 0;
-const index_1 = require("./index");
+const scheduler_1 = require("./scheduler");
 const help_1 = require("./help");
 const models_1 = require("./models");
 const algorithm_1 = require("./algorithm");
@@ -9,26 +9,30 @@ class FSRS extends algorithm_1.FSRSAlgorithm {
     constructor(param) {
         super(param);
     }
-    preProcess(_card, _now) {
-        const card = {
+    preProcessCard(_card) {
+        return {
             ..._card,
             state: (0, help_1.fixState)(_card.state),
             due: (0, help_1.fixDate)(_card.due),
             last_review: _card.last_review ? (0, help_1.fixDate)(_card.last_review) : undefined,
         };
-        const now = (0, help_1.fixDate)(_now);
-        return { card, now };
+    }
+    preProcessDate(_date) {
+        return (0, help_1.fixDate)(_date);
+    }
+    preProcessLog(_log) {
+        return {
+            ..._log,
+            rating: (0, help_1.fixRating)(_log.rating),
+            state: (0, help_1.fixState)(_log.state),
+            review: (0, help_1.fixDate)(_log.review),
+        };
     }
     repeat = (card, now) => {
-        const process = this.preProcess(card, now);
-        card = process.card;
-        now = process.now;
-        card.elapsed_days =
-            card.state === models_1.State.New ? 0 : now.diff(card.last_review, "days"); //相距时间
-        card.last_review = now; // 上次复习时间
-        card.reps += 1;
-        const s = new index_1.SchedulingCard(card).update_state(card.state);
-        this.seed = String(card.last_review.getTime()) + String(card.elapsed_days);
+        card = this.preProcessCard(card);
+        now = this.preProcessDate(now);
+        const s = new scheduler_1.SchedulingCard(card, now).update_state(card.state);
+        this.seed = String(now.getTime()) + String(card.reps);
         let easy_interval, good_interval, hard_interval;
         switch (card.state) {
             case models_1.State.New:
@@ -65,14 +69,46 @@ class FSRS extends algorithm_1.FSRSAlgorithm {
         return s.record_log(card, now);
     };
     get_retrievability = (card, now) => {
-        const process = this.preProcess(card, now);
-        card = process.card;
-        now = process.now;
+        card = this.preProcessCard(card);
+        now = this.preProcessDate(now);
         if (card.state !== models_1.State.Review) {
             return undefined;
         }
         const t = Math.max(now.diff(card.last_review, "days"), 0);
         return ((this.current_retrievability(t, card.stability) * 100).toFixed(2) + "%");
     };
+    rollback = (card, log) => {
+        card = this.preProcessCard(card);
+        log = this.preProcessLog(log);
+        let last_due, last_review, last_lapses;
+        switch (log.state) {
+            case models_1.State.New:
+                last_due = log.due;
+                last_review = undefined;
+                last_lapses = 0;
+                break;
+            case models_1.State.Learning:
+            case models_1.State.Relearning:
+            case models_1.State.Review:
+                last_due = log.review;
+                last_review = log.due;
+                last_lapses =
+                    card.lapses -
+                        (log.rating === models_1.Rating.Again && log.state === models_1.State.Review ? 1 : 0);
+                break;
+        }
+        return {
+            ...card,
+            due: last_due,
+            stability: log.stability,
+            difficulty: log.difficulty,
+            elapsed_days: log.elapsed_days,
+            scheduled_days: log.scheduled_days,
+            reps: Math.max(0, card.reps - 1),
+            lapses: Math.max(0, last_lapses),
+            state: log.state,
+            last_review: last_review,
+        };
+    };
 }
 exports.FSRS = FSRS;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { SchedulingCard } from "./scheduler";
-export { default_request_retention, default_maximum_interval, default_w, default_enable_fuzz, FSRSVersion, generatorParameters, createEmptyCard, fsrs, envParams } from "./default";
+export { default_request_retention, default_maximum_interval, default_w, default_enable_fuzz, FSRSVersion, generatorParameters, createEmptyCard, fsrs, envParams, } from "./default";
 export { date_scheduler, date_diff, formatDate, show_diff_message, } from "./help";
 export type { int, double } from "./type";
-export type { FSRSParameters, Card, ReviewLog, RecordLog, RecordLogItem, StateType, RatingType, CardInput, DateInput } from "./models";
+export type { FSRSParameters, Card, ReviewLog, RecordLog, RecordLogItem, StateType, RatingType, CardInput, DateInput, } from "./models";
 export { State, Rating } from "./models";
 export { FSRS } from "./fsrs";

package/dist/models.d.ts

@@ -15,6 +15,9 @@ export declare enum Rating {
 export interface ReviewLog {
     rating: Rating;
     state: State;
+    due: Date;
+    stability: number;
+    difficulty: number;
     elapsed_days: number;
     scheduled_days: number;
     review: Date;
@@ -41,6 +44,10 @@ export type CardInput = Card & {
     state: StateType | State;
 };
 export type DateInput = Date | number | string;
+export type ReviewLogInput = ReviewLog & {
+    rating: RatingType | Rating;
+    state: StateType | State;
+};
 export interface FSRSParameters {
     request_retention: number;
     maximum_interval: number;

package/dist/scheduler.d.ts

@@ -4,8 +4,10 @@ export declare class SchedulingCard {
     hard: Card;
     good: Card;
     easy: Card;
+    last_review: Date;
+    elapsed_days: number;
     private copy;
-    constructor(card: Card);
+    constructor(card: Card, now: Date);
     update_state(state: State): this;
     schedule(now: Date, hard_interval: number, good_interval: number, easy_interval: number): SchedulingCard;
     record_log(card: Card, now: Date): RecordLog;

package/dist/scheduler.js

@@ -8,12 +8,20 @@ class SchedulingCard {
     hard;
     good;
     easy;
+    last_review;
+    elapsed_days;
     copy(card) {
         return {
             ...card,
         };
     }
-    constructor(card) {
+    constructor(card, now) {
+        this.last_review = card.last_review || card.due;
+        this.elapsed_days = card.elapsed_days;
+        card.elapsed_days =
+            card.state === models_1.State.New ? 0 : now.diff(card.last_review, "days"); //相距时间
+        card.last_review = now; // 上次复习时间
+        card.reps += 1;
         this.again = this.copy(card);
         this.hard = this.copy(card);
         this.good = this.copy(card);
@@ -63,8 +71,11 @@ class SchedulingCard {
                 log: {
                     rating: models_1.Rating.Again,
                     state: card.state,
-                    elapsed_days: this.again.scheduled_days,
-                    scheduled_days: card.elapsed_days,
+                    due: this.last_review,
+                    stability: card.stability,
+                    difficulty: card.difficulty,
+                    elapsed_days: this.elapsed_days,
+                    scheduled_days: card.scheduled_days,
                     review: now,
                 },
             },
@@ -73,8 +84,11 @@ class SchedulingCard {
                 log: {
                     rating: models_1.Rating.Hard,
                     state: card.state,
-                    elapsed_days: this.hard.scheduled_days,
-                    scheduled_days: card.elapsed_days,
+                    due: this.last_review,
+                    stability: card.stability,
+                    difficulty: card.difficulty,
+                    elapsed_days: this.elapsed_days,
+                    scheduled_days: card.scheduled_days,
                     review: now,
                 },
             },
@@ -83,8 +97,11 @@ class SchedulingCard {
                 log: {
                     rating: models_1.Rating.Good,
                     state: card.state,
-                    elapsed_days: this.good.scheduled_days,
-                    scheduled_days: card.elapsed_days,
+                    due: this.last_review,
+                    stability: card.stability,
+                    difficulty: card.difficulty,
+                    elapsed_days: this.elapsed_days,
+                    scheduled_days: card.scheduled_days,
                     review: now,
                 },
             },
@@ -93,8 +110,11 @@ class SchedulingCard {
                 log: {
                     rating: models_1.Rating.Easy,
                     state: card.state,
-                    elapsed_days: this.easy.scheduled_days,
-                    scheduled_days: card.elapsed_days,
+                    due: this.last_review,
+                    stability: card.stability,
+                    difficulty: card.difficulty,
+                    elapsed_days: this.elapsed_days,
+                    scheduled_days: card.scheduled_days,
                     review: now,
                 },
             },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-fsrs",
-  "version": "3.0.5",
+  "version": "3.1.0-beta1",
   "description": "ts-fsrs is a TypeScript package used to implement the Free Spaced Repetition Scheduler (FSRS) algorithm. It helps developers apply FSRS to their flashcard applications, thereby improving the user learning experience.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",