@magmamath/students-features 1.5.0 → 1.5.1

package/dist/module/features/fluency/hooks/usePreventPageLeave.js

@@ -0,0 +1,13 @@
+"use strict";
+
+import { useEffect } from 'react';
+import { Platform } from 'react-native';
+export const usePreventPageLeave = () => {
+  useEffect(() => {
+    if (Platform.OS !== 'web') return;
+    const handleBeforeUnload = event => event.preventDefault();
+    window.addEventListener('beforeunload', handleBeforeUnload);
+    return () => window.removeEventListener('beforeunload', handleBeforeUnload);
+  }, []);
+};
+//# sourceMappingURL=usePreventPageLeave.js.map

package/dist/module/features/fluency/hooks/usePreventPageLeave.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","Platform","usePreventPageLeave","OS","handleBeforeUnload","event","preventDefault","window","addEventListener","removeEventListener"],"sourceRoot":"../../../../../src","sources":["features/fluency/hooks/usePreventPageLeave.ts"],"mappings":";;AAAA,SAASA,SAAS,QAAQ,OAAO;AACjC,SAASC,QAAQ,QAAQ,cAAc;AAEvC,OAAO,MAAMC,mBAAmB,GAAGA,CAAA,KAAM;EACvCF,SAAS,CAAC,MAAM;IACd,IAAIC,QAAQ,CAACE,EAAE,KAAK,KAAK,EAAE;IAC3B,MAAMC,kBAAkB,GAAIC,KAAwB,IAAKA,KAAK,CAACC,cAAc,CAAC,CAAC;IAC/EC,MAAM,CAACC,gBAAgB,CAAC,cAAc,EAAEJ,kBAAkB,CAAC;IAC3D,OAAO,MAAMG,MAAM,CAACE,mBAAmB,CAAC,cAAc,EAAEL,kBAAkB,CAAC;EAC7E,CAAC,EAAE,EAAE,CAAC;AACR,CAAC","ignoreList":[]}

package/dist/module/features/fluency/hooks/usePreventWebKeys.js

@@ -0,0 +1,21 @@
+"use strict";
+
+import { useEffect } from 'react';
+import { Platform } from 'react-native';
+export const usePreventWebKeys = ({
+  ref,
+  keys,
+  enabled
+}) => {
+  useEffect(() => {
+    if (Platform.OS !== 'web' || !enabled) return;
+    const element = ref.current;
+    if (!element) return;
+    const preventKeys = event => {
+      if (keys.includes(event.key)) event.preventDefault();
+    };
+    element.addEventListener('keydown', preventKeys);
+    return () => element.removeEventListener('keydown', preventKeys);
+  }, [ref, keys, enabled]);
+};
+//# sourceMappingURL=usePreventWebKeys.js.map

package/dist/module/features/fluency/hooks/usePreventWebKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","Platform","usePreventWebKeys","ref","keys","enabled","OS","element","current","preventKeys","event","includes","key","preventDefault","addEventListener","removeEventListener"],"sourceRoot":"../../../../../src","sources":["features/fluency/hooks/usePreventWebKeys.ts"],"mappings":";;AAAA,SAAoBA,SAAS,QAAQ,OAAO;AAC5C,SAASC,QAAQ,QAAQ,cAAc;AAQvC,OAAO,MAAMC,iBAAiB,GAAGA,CAAC;EAAEC,GAAG;EAAEC,IAAI;EAAEC;AAAgC,CAAC,KAAK;EACnFL,SAAS,CAAC,MAAM;IACd,IAAIC,QAAQ,CAACK,EAAE,KAAK,KAAK,IAAI,CAACD,OAAO,EAAE;IAEvC,MAAME,OAAO,GAAGJ,GAAG,CAACK,OAAsC;IAC1D,IAAI,CAACD,OAAO,EAAE;IAEd,MAAME,WAAW,GAAIC,KAAoB,IAAK;MAC5C,IAAIN,IAAI,CAACO,QAAQ,CAACD,KAAK,CAACE,GAAG,CAAC,EAAEF,KAAK,CAACG,cAAc,CAAC,CAAC;IACtD,CAAC;IAEDN,OAAO,CAACO,gBAAgB,CAAC,SAAS,EAAEL,WAAW,CAAC;IAChD,OAAO,MAAMF,OAAO,CAACQ,mBAAmB,CAAC,SAAS,EAAEN,WAAW,CAAC;EAClE,CAAC,EAAE,CAACN,GAAG,EAAEC,IAAI,EAAEC,OAAO,CAAC,CAAC;AAC1B,CAAC","ignoreList":[]}

package/dist/module/features/fluency/hooks/useSuccessSound.js

@@ -0,0 +1,21 @@
+"use strict";
+
+import { useEffect, useRef } from 'react';
+import { createAudioPlayer } from 'expo-audio';
+import SUCCESS_SOUND from '../assets/success.mp3';
+export const useSuccessSound = () => {
+  const playerRef = useRef(null);
+  useEffect(() => {
+    const player = createAudioPlayer(SUCCESS_SOUND);
+    playerRef.current = player;
+    return () => player.remove();
+  }, []);
+  const play = () => {
+    playerRef.current?.seekTo(0);
+    playerRef.current?.play();
+  };
+  return {
+    play
+  };
+};
+//# sourceMappingURL=useSuccessSound.js.map

package/dist/module/features/fluency/hooks/useSuccessSound.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useRef","createAudioPlayer","SUCCESS_SOUND","useSuccessSound","playerRef","player","current","remove","play","seekTo"],"sourceRoot":"../../../../../src","sources":["features/fluency/hooks/useSuccessSound.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,MAAM,QAAQ,OAAO;AACzC,SAAsBC,iBAAiB,QAAQ,YAAY;AAC3D,OAAOC,aAAa,MAAM,uBAAuB;AAEjD,OAAO,MAAMC,eAAe,GAAGA,CAAA,KAAM;EACnC,MAAMC,SAAS,GAAGJ,MAAM,CAAqB,IAAI,CAAC;EAElDD,SAAS,CAAC,MAAM;IACd,MAAMM,MAAM,GAAGJ,iBAAiB,CAACC,aAAa,CAAC;IAC/CE,SAAS,CAACE,OAAO,GAAGD,MAAM;IAC1B,OAAO,MAAMA,MAAM,CAACE,MAAM,CAAC,CAAC;EAC9B,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMC,IAAI,GAAGA,CAAA,KAAM;IACjBJ,SAAS,CAACE,OAAO,EAAEG,MAAM,CAAC,CAAC,CAAC;IAC5BL,SAAS,CAACE,OAAO,EAAEE,IAAI,CAAC,CAAC;EAC3B,CAAC;EAED,OAAO;IAAEA;EAAK,CAAC;AACjB,CAAC","ignoreList":[]}

package/dist/module/features/fluency/index.js

@@ -0,0 +1,9 @@
+"use strict";
+
+export * from "./shared/fluency.constants.js";
+export * from "./shared/fluency.types.js";
+export * from "./shared/fluency.helpers.js";
+export { Fluency } from "./components/Fluency.js";
+export { FluencySolving } from "./components/FluencySolving.js";
+export { FluencyModel } from "./model/FluencyModel.js";
+//# sourceMappingURL=index.js.map

package/dist/module/features/fluency/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Fluency","FluencySolving","FluencyModel"],"sourceRoot":"../../../../src","sources":["features/fluency/index.ts"],"mappings":";;AAAA,cAAc,+BAA4B;AAC1C,cAAc,2BAAwB;AACtC,cAAc,6BAA0B;AACxC,SAASA,OAAO,QAAQ,yBAAsB;AAC9C,SAASC,cAAc,QAAQ,gCAA6B;AAC5D,SAASC,YAAY,QAAQ,yBAAsB","ignoreList":[]}

package/dist/module/features/fluency/model/FluencyApiModel.js

@@ -0,0 +1,11 @@
+"use strict";
+
+import { createEffect } from 'effector';
+export class FluencyApiModel {
+  constructor(api) {
+    this.getMatrixFx = createEffect(api.getMatrix);
+    this.getWeeklyStatsFx = createEffect(() => api.getWeeklyStats());
+    this.postAttemptFx = createEffect(api.postAttempt);
+  }
+}
+//# sourceMappingURL=FluencyApiModel.js.map

package/dist/module/features/fluency/model/FluencyApiModel.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createEffect","FluencyApiModel","constructor","api","getMatrixFx","getMatrix","getWeeklyStatsFx","getWeeklyStats","postAttemptFx","postAttempt"],"sourceRoot":"../../../../../src","sources":["features/fluency/model/FluencyApiModel.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAgB,UAAU;AAS/C,OAAO,MAAMC,eAAe,CAAC;EAK3BC,WAAWA,CAACC,GAA6B,EAAE;IACzC,IAAI,CAACC,WAAW,GAAGJ,YAAY,CAACG,GAAG,CAACE,SAAS,CAAC;IAC9C,IAAI,CAACC,gBAAgB,GAAGN,YAAY,CAAC,MAAMG,GAAG,CAACI,cAAc,CAAC,CAAC,CAAC;IAChE,IAAI,CAACC,aAAa,GAAGR,YAAY,CAACG,GAAG,CAACM,WAAW,CAAC;EACpD;AACF","ignoreList":[]}

package/dist/module/features/fluency/model/FluencyDaysStreakModel.js

@@ -0,0 +1,11 @@
+"use strict";
+
+import { createStore } from 'effector';
+export class FluencyDaysStreakModel {
+  $stats = createStore(null);
+  constructor(api) {
+    this.api = api;
+    this.$stats.on(this.api.getWeeklyStatsFx.doneData, (_, data) => data);
+  }
+}
+//# sourceMappingURL=FluencyDaysStreakModel.js.map

package/dist/module/features/fluency/model/FluencyDaysStreakModel.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createStore","FluencyDaysStreakModel","$stats","constructor","api","on","getWeeklyStatsFx","doneData","_","data"],"sourceRoot":"../../../../../src","sources":["features/fluency/model/FluencyDaysStreakModel.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,UAAU;AAItC,OAAO,MAAMC,sBAAsB,CAAC;EAClBC,MAAM,GAAGF,WAAW,CAAgC,IAAI,CAAC;EAEzEG,WAAWA,CAAkBC,GAAoB,EAAE;IAAA,KAAtBA,GAAoB,GAApBA,GAAoB;IAC/C,IAAI,CAACF,MAAM,CAACG,EAAE,CAAC,IAAI,CAACD,GAAG,CAACE,gBAAgB,CAACC,QAAQ,EAAE,CAACC,CAAC,EAAEC,IAAI,KAAKA,IAAI,CAAC;EACvE;AACF","ignoreList":[]}

package/dist/module/features/fluency/model/FluencyMatrixModel.js

@@ -0,0 +1,18 @@
+"use strict";
+
+import { combine, createEvent, createStore, restore } from 'effector';
+import { FluencyMode } from "../shared/fluency.constants.js";
+import { buildMatrixGrid } from "../shared/fluency.helpers.js";
+export class FluencyMatrixModel {
+  setMode = createEvent();
+  $mode = restore(this.setMode, FluencyMode.ADDITION);
+  $data = createStore(null);
+  $matrix = combine(this.$data, this.$mode, (data, mode) => {
+    if (!data) return null;
+    return buildMatrixGrid(data, mode);
+  });
+  constructor(api) {
+    this.$data.on(api.getMatrixFx.doneData, (_, data) => data);
+  }
+}
+//# sourceMappingURL=FluencyMatrixModel.js.map

package/dist/module/features/fluency/model/FluencyMatrixModel.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["combine","createEvent","createStore","restore","FluencyMode","buildMatrixGrid","FluencyMatrixModel","setMode","$mode","ADDITION","$data","$matrix","data","mode","constructor","api","on","getMatrixFx","doneData","_"],"sourceRoot":"../../../../../src","sources":["features/fluency/model/FluencyMatrixModel.ts"],"mappings":";;AAAA,SAASA,OAAO,EAAEC,WAAW,EAAEC,WAAW,EAAEC,OAAO,QAAQ,UAAU;AACrE,SAASC,WAAW,QAAQ,gCAA6B;AACzD,SAASC,eAAe,QAAQ,8BAA2B;AAI3D,OAAO,MAAMC,kBAAkB,CAAC;EACdC,OAAO,GAAGN,WAAW,CAAc,CAAC;EACpCO,KAAK,GAAGL,OAAO,CAAC,IAAI,CAACI,OAAO,EAAEH,WAAW,CAACK,QAAQ,CAAC;EAEnDC,KAAK,GAAGR,WAAW,CAA2B,IAAI,CAAC;EACnDS,OAAO,GAAGX,OAAO,CAAC,IAAI,CAACU,KAAK,EAAE,IAAI,CAACF,KAAK,EAAE,CAACI,IAAI,EAAEC,IAAI,KAAwB;IAC3F,IAAI,CAACD,IAAI,EAAE,OAAO,IAAI;IACtB,OAAOP,eAAe,CAACO,IAAI,EAAEC,IAAI,CAAC;EACpC,CAAC,CAAC;EAEFC,WAAWA,CAACC,GAAoB,EAAE;IAChC,IAAI,CAACL,KAAK,CAACM,EAAE,CAACD,GAAG,CAACE,WAAW,CAACC,QAAQ,EAAE,CAACC,CAAC,EAAEP,IAAI,KAAKA,IAAI,CAAC;EAC5D;AACF","ignoreList":[]}

package/dist/module/features/fluency/model/FluencyModel.js

@@ -0,0 +1,80 @@
+"use strict";
+
+import { createStore, sample } from 'effector';
+import { createGate } from 'effector-react';
+import { not } from 'patronum/not';
+import { FluencyDaysStreakModel } from "./FluencyDaysStreakModel.js";
+import { FluencyMatrixModel } from "./FluencyMatrixModel.js";
+import { FluencyApiModel } from "./FluencyApiModel.js";
+import { FluencySolvingModel } from "./FluencySolvingModel.js";
+import { FluencyStatus, MatrixConfig } from "../shared/fluency.constants.js";
+import { allFactsEmpty } from "../shared/fluency.helpers.js";
+export class FluencyModel {
+  gate = createGate();
+  $config = createStore(null);
+  $status = createStore(null);
+  constructor({
+    api
+  }) {
+    this.api = new FluencyApiModel(api);
+    this.streak = new FluencyDaysStreakModel(this.api);
+    this.matrix = new FluencyMatrixModel(this.api);
+    this.solving = new FluencySolvingModel(this.matrix, this.$config);
+    this.init();
+    this.setupStatusTracking();
+  }
+  init() {
+    sample({
+      clock: this.gate.open,
+      fn: ({
+        config
+      }) => config,
+      target: this.$config
+    });
+    sample({
+      clock: this.gate.open,
+      filter: not(this.api.getMatrixFx.pending),
+      fn: ({
+        config
+      }) => ({
+        grade: config.grade
+      }),
+      target: this.api.getMatrixFx
+    });
+    sample({
+      clock: this.gate.open,
+      filter: not(this.api.getWeeklyStatsFx.pending),
+      target: this.api.getWeeklyStatsFx
+    });
+    sample({
+      clock: this.solving.flushAttempts,
+      source: this.$config,
+      filter: Boolean,
+      fn: (config, attempts) => ({
+        grade: config.grade,
+        attempts,
+        matrixConfig: MatrixConfig.STANDARD
+      }),
+      target: this.api.postAttemptFx
+    });
+  }
+  setupStatusTracking() {
+    sample({
+      clock: this.gate.open,
+      fn: () => null,
+      target: this.$status
+    });
+    sample({
+      clock: [this.api.getMatrixFx.fail, this.api.getWeeklyStatsFx.fail],
+      fn: () => FluencyStatus.ERROR,
+      target: this.$status
+    });
+    sample({
+      clock: this.api.getMatrixFx.doneData,
+      filter: allFactsEmpty,
+      fn: () => FluencyStatus.EMPTY,
+      target: this.$status
+    });
+  }
+}
+//# sourceMappingURL=FluencyModel.js.map

package/dist/module/features/fluency/model/FluencyModel.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createStore","sample","createGate","not","FluencyDaysStreakModel","FluencyMatrixModel","FluencyApiModel","FluencySolvingModel","FluencyStatus","MatrixConfig","allFactsEmpty","FluencyModel","gate","$config","$status","constructor","api","streak","matrix","solving","init","setupStatusTracking","clock","open","fn","config","target","filter","getMatrixFx","pending","grade","getWeeklyStatsFx","flushAttempts","source","Boolean","attempts","matrixConfig","STANDARD","postAttemptFx","fail","ERROR","doneData","EMPTY"],"sourceRoot":"../../../../../src","sources":["features/fluency/model/FluencyModel.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,MAAM,QAAQ,UAAU;AAC9C,SAASC,UAAU,QAAQ,gBAAgB;AAC3C,SAASC,GAAG,QAAQ,cAAc;AAClC,SAASC,sBAAsB,QAAQ,6BAA0B;AACjE,SAASC,kBAAkB,QAAQ,yBAAsB;AACzD,SAASC,eAAe,QAAQ,sBAAmB;AACnD,SAASC,mBAAmB,QAAQ,0BAAuB;AAC3D,SAASC,aAAa,EAAEC,YAAY,QAAQ,gCAA6B;AACzE,SAASC,aAAa,QAAQ,8BAA2B;AAQzD,OAAO,MAAMC,YAAY,CAAC;EACRC,IAAI,GAAGV,UAAU,CAAwB,CAAC;EAC1CW,OAAO,GAAGb,WAAW,CAAuB,IAAI,CAAC;EACjDc,OAAO,GAAGd,WAAW,CAAuB,IAAI,CAAC;EAOjEe,WAAWA,CAAC;IAAEC;EAAuB,CAAC,EAAE;IACtC,IAAI,CAACA,GAAG,GAAG,IAAIV,eAAe,CAACU,GAAG,CAAC;IACnC,IAAI,CAACC,MAAM,GAAG,IAAIb,sBAAsB,CAAC,IAAI,CAACY,GAAG,CAAC;IAClD,IAAI,CAACE,MAAM,GAAG,IAAIb,kBAAkB,CAAC,IAAI,CAACW,GAAG,CAAC;IAC9C,IAAI,CAACG,OAAO,GAAG,IAAIZ,mBAAmB,CAAC,IAAI,CAACW,MAAM,EAAE,IAAI,CAACL,OAAO,CAAC;IAEjE,IAAI,CAACO,IAAI,CAAC,CAAC;IACX,IAAI,CAACC,mBAAmB,CAAC,CAAC;EAC5B;EAEQD,IAAIA,CAAA,EAAG;IACbnB,MAAM,CAAC;MACLqB,KAAK,EAAE,IAAI,CAACV,IAAI,CAACW,IAAI;MACrBC,EAAE,EAAEA,CAAC;QAAEC;MAAO,CAAC,KAAKA,MAAM;MAC1BC,MAAM,EAAE,IAAI,CAACb;IACf,CAAC,CAAC;IAEFZ,MAAM,CAAC;MACLqB,KAAK,EAAE,IAAI,CAACV,IAAI,CAACW,IAAI;MACrBI,MAAM,EAAExB,GAAG,CAAC,IAAI,CAACa,GAAG,CAACY,WAAW,CAACC,OAAO,CAAC;MACzCL,EAAE,EAAEA,CAAC;QAAEC;MAAO,CAAC,MAAM;QAAEK,KAAK,EAAEL,MAAM,CAACK;MAAM,CAAC,CAAC;MAC7CJ,MAAM,EAAE,IAAI,CAACV,GAAG,CAACY;IACnB,CAAC,CAAC;IAEF3B,MAAM,CAAC;MACLqB,KAAK,EAAE,IAAI,CAACV,IAAI,CAACW,IAAI;MACrBI,MAAM,EAAExB,GAAG,CAAC,IAAI,CAACa,GAAG,CAACe,gBAAgB,CAACF,OAAO,CAAC;MAC9CH,MAAM,EAAE,IAAI,CAACV,GAAG,CAACe;IACnB,CAAC,CAAC;IAEF9B,MAAM,CAAC;MACLqB,KAAK,EAAE,IAAI,CAACH,OAAO,CAACa,aAAa;MACjCC,MAAM,EAAE,IAAI,CAACpB,OAAO;MACpBc,MAAM,EAAEO,OAAO;MACfV,EAAE,EAAEA,CAACC,MAAM,EAAEU,QAAQ,MAA6B;QAChDL,KAAK,EAAEL,MAAM,CAACK,KAAK;QACnBK,QAAQ;QACRC,YAAY,EAAE3B,YAAY,CAAC4B;MAC7B,CAAC,CAAC;MACFX,MAAM,EAAE,IAAI,CAACV,GAAG,CAACsB;IACnB,CAAC,CAAC;EACJ;EAEQjB,mBAAmBA,CAAA,EAAG;IAC5BpB,MAAM,CAAC;MACLqB,KAAK,EAAE,IAAI,CAACV,IAAI,CAACW,IAAI;MACrBC,EAAE,EAAEA,CAAA,KAAM,IAA4B;MACtCE,MAAM,EAAE,IAAI,CAACZ;IACf,CAAC,CAAC;IAEFb,MAAM,CAAC;MACLqB,KAAK,EAAE,CAAC,IAAI,CAACN,GAAG,CAACY,WAAW,CAACW,IAAI,EAAE,IAAI,CAACvB,GAAG,CAACe,gBAAgB,CAACQ,IAAI,CAAC;MAClEf,EAAE,EAAEA,CAAA,KAAMhB,aAAa,CAACgC,KAAK;MAC7Bd,MAAM,EAAE,IAAI,CAACZ;IACf,CAAC,CAAC;IAEFb,MAAM,CAAC;MACLqB,KAAK,EAAE,IAAI,CAACN,GAAG,CAACY,WAAW,CAACa,QAAQ;MACpCd,MAAM,EAAEjB,aAAa;MACrBc,EAAE,EAAEA,CAAA,KAAMhB,aAAa,CAACkC,KAAK;MAC7BhB,MAAM,EAAE,IAAI,CAACZ;IACf,CAAC,CAAC;EACJ;AACF","ignoreList":[]}

package/dist/module/features/fluency/model/FluencySolvingModel.js

@@ -0,0 +1,148 @@
+"use strict";
+
+import { createEvent, createStore, restore, sample } from 'effector';
+import { AttemptStatus, FLUSH_ATTEMPTS_COUNT, SESSION_LENGTH, getTimeThresholdByGrade } from "../shared/fluency.constants.js";
+import { calculateNextBox, selectNextFact, toSolvingFacts } from "../shared/fluencySolving.helpers.js";
+import { createAction } from 'effector-action';
+export class FluencySolvingModel {
+  reset = createEvent();
+  start = createEvent();
+  submit = createEvent();
+  setAnswer = createEvent();
+  setSessionCompleted = createEvent();
+  updateFact = createEvent();
+  flushAttempts = createEvent();
+  $answer = restore(this.setAnswer, null).reset(this.reset);
+  $current = createStore(null).reset(this.reset);
+  $outcomes = createStore([]).reset(this.reset);
+  $facts = createStore([]).on(this.updateFact, (facts, updatedFact) => facts.map(fact => fact.id === updatedFact.id ? updatedFact : fact)).reset(this.reset);
+  $sessionDurationMs = createStore(0).reset(this.reset);
+  $completedDurationMs = createStore(0).reset(this.reset);
+  $timeSpentInCurrentMs = createStore(0).reset(this.reset);
+  $isSessionComplete = restore(this.setSessionCompleted, false).reset(this.reset);
+  $pendingAttempts = createStore([]).reset(this.flushAttempts).reset(this.reset);
+  constructor(matrixModel, $config) {
+    this.matrixModel = matrixModel;
+    this.$config = $config;
+    this.setupStartTrigger();
+    this.setupSubmitTrigger();
+    this.setupFlushTrigger();
+  }
+  setupStartTrigger() {
+    createAction(this.start, {
+      source: {
+        data: this.matrixModel.$data
+      },
+      target: {
+        $facts: this.$facts,
+        $current: this.$current,
+        $answer: this.$answer,
+        $outcomes: this.$outcomes,
+        $isSessionComplete: this.$isSessionComplete,
+        $pendingAttempts: this.$pendingAttempts,
+        $sessionDurationMs: this.$sessionDurationMs,
+        $completedDurationMs: this.$completedDurationMs,
+        $timeSpentInCurrentMs: this.$timeSpentInCurrentMs
+      },
+      fn: (target, source, mode) => {
+        if (!source.data) return;
+        const facts = this.getFactsFromData(source.data, mode || undefined);
+        target.$facts(facts);
+        target.$current(selectNextFact(facts, Date.now()));
+        target.$answer(null);
+        target.$outcomes([]);
+        target.$isSessionComplete(false);
+        target.$pendingAttempts([]);
+        target.$sessionDurationMs(Date.now());
+        target.$completedDurationMs(0);
+        target.$timeSpentInCurrentMs(Date.now());
+      }
+    });
+  }
+  setupSubmitTrigger() {
+    createAction(this.submit, {
+      source: {
+        answer: this.$answer,
+        facts: this.$facts,
+        current: this.$current,
+        outcomes: this.$outcomes,
+        timeSpentInCurrentMs: this.$timeSpentInCurrentMs,
+        sessionDurationMs: this.$sessionDurationMs,
+        pendingAttempts: this.$pendingAttempts,
+        config: this.$config
+      },
+      target: {
+        $current: this.$current,
+        $outcomes: this.$outcomes,
+        $answer: this.$answer,
+        $sessionDurationMs: this.$sessionDurationMs,
+        $completedDurationMs: this.$completedDurationMs,
+        $timeSpentInCurrentMs: this.$timeSpentInCurrentMs,
+        $pendingAttempts: this.$pendingAttempts,
+        update: this.updateFact,
+        setSessionCompleted: this.setSessionCompleted
+      },
+      fn: (target, source) => {
+        if (!source.facts || !source.current) return;
+        const timeTakenToSolveFactMs = Date.now() - source.timeSpentInCurrentMs;
+        const isCorrect = source.answer !== null && Number(source.answer) === source.current.answer;
+        const isFast = timeTakenToSolveFactMs <= getTimeThresholdByGrade(source.config?.grade);
+        const isLastQuestion = source.outcomes.length + 1 >= SESSION_LENGTH;
+        const nextBox = calculateNextBox({
+          isFast,
+          isCorrect,
+          currentBox: source.current.box,
+          sessionStartBox: source.current.sessionStartBox,
+          hasFailedThisSession: source.current.hasFailedThisSession
+        });
+        const updatedFact = {
+          ...source.current,
+          box: nextBox,
+          lastSeenMs: Date.now(),
+          hasFailedThisSession: source.current.hasFailedThisSession || !isCorrect,
+          attemptsCount: source.current.attemptsCount + 1,
+          correctCount: source.current.correctCount + (isCorrect ? 1 : 0)
+        };
+        const updatedFacts = source.facts.map(f => f.id === updatedFact.id ? updatedFact : f);
+        target.update(updatedFact);
+        const attemptItem = {
+          factId: source.current.id,
+          status: isCorrect ? AttemptStatus.CORRECT : AttemptStatus.INCORRECT,
+          startedAt: new Date(source.timeSpentInCurrentMs).toISOString(),
+          timeToSolve: timeTakenToSolveFactMs,
+          boxAfter: nextBox
+        };
+        target.$pendingAttempts([...source.pendingAttempts, attemptItem]);
+        target.$outcomes([...source.outcomes, {
+          factId: source.current.id,
+          status: isCorrect ? AttemptStatus.CORRECT : AttemptStatus.INCORRECT,
+          answer: source.answer,
+          numbers: source.current.numbers,
+          mode: source.current.mode
+        }]);
+        if (isLastQuestion) {
+          target.$completedDurationMs(Date.now() - source.sessionDurationMs);
+          target.$sessionDurationMs(0);
+          target.setSessionCompleted(true);
+          return;
+        }
+        target.$current(selectNextFact(updatedFacts, Date.now()));
+        target.$answer(null);
+        target.$timeSpentInCurrentMs(Date.now());
+      }
+    });
+  }
+  setupFlushTrigger() {
+    sample({
+      clock: this.$pendingAttempts,
+      filter: attempts => attempts.length >= FLUSH_ATTEMPTS_COUNT,
+      target: this.flushAttempts
+    });
+  }
+  getFactsFromData(data, mode) {
+    return mode ? toSolvingFacts(data.operations[mode].facts, mode) : Object.entries(data.operations).flatMap(([key, {
+      facts
+    }]) => toSolvingFacts(facts, key));
+  }
+}
+//# sourceMappingURL=FluencySolvingModel.js.map

package/dist/module/features/fluency/model/FluencySolvingModel.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createEvent","createStore","restore","sample","AttemptStatus","FLUSH_ATTEMPTS_COUNT","SESSION_LENGTH","getTimeThresholdByGrade","calculateNextBox","selectNextFact","toSolvingFacts","createAction","FluencySolvingModel","reset","start","submit","setAnswer","setSessionCompleted","updateFact","flushAttempts","$answer","$current","$outcomes","$facts","on","facts","updatedFact","map","fact","id","$sessionDurationMs","$completedDurationMs","$timeSpentInCurrentMs","$isSessionComplete","$pendingAttempts","constructor","matrixModel","$config","setupStartTrigger","setupSubmitTrigger","setupFlushTrigger","source","data","$data","target","fn","mode","getFactsFromData","undefined","Date","now","answer","current","outcomes","timeSpentInCurrentMs","sessionDurationMs","pendingAttempts","config","update","timeTakenToSolveFactMs","isCorrect","Number","isFast","grade","isLastQuestion","length","nextBox","currentBox","box","sessionStartBox","hasFailedThisSession","lastSeenMs","attemptsCount","correctCount","updatedFacts","f","attemptItem","factId","status","CORRECT","INCORRECT","startedAt","toISOString","timeToSolve","boxAfter","numbers","clock","filter","attempts","operations","Object","entries","flatMap","key"],"sourceRoot":"../../../../../src","sources":["features/fluency/model/FluencySolvingModel.ts"],"mappings":"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","ignoreList":[]}

package/dist/module/features/fluency/shared/fluency.constants.js

@@ -0,0 +1,105 @@
+"use strict";
+
+import { ButtonColor, COLORS, SelectOptionColor } from '@magmamath/react-native-ui';
+import { createFluencyMode } from "./fluency.helpers.js";
+export const MAX_INPUT_LENGTH = 3;
+export const SESSION_LENGTH = 20;
+export const FLUSH_ATTEMPTS_COUNT = 5;
+export const getTimeThresholdByGrade = grade => {
+  if (grade == null || grade >= 4) return 4000;
+  if (grade >= 2) return 5000;
+  return 6000;
+};
+export let FluencyMode = /*#__PURE__*/function (FluencyMode) {
+  FluencyMode["ADDITION"] = "addition";
+  FluencyMode["SUBTRACTION"] = "subtraction";
+  FluencyMode["MULTIPLICATION"] = "multiplication";
+  FluencyMode["DIVISION"] = "division";
+  return FluencyMode;
+}({});
+export let FluencyMasteryLevel = /*#__PURE__*/function (FluencyMasteryLevel) {
+  FluencyMasteryLevel[FluencyMasteryLevel["NOT_STARTED"] = 0] = "NOT_STARTED";
+  FluencyMasteryLevel[FluencyMasteryLevel["LEARNING"] = 1] = "LEARNING";
+  FluencyMasteryLevel[FluencyMasteryLevel["GROWING"] = 2] = "GROWING";
+  FluencyMasteryLevel[FluencyMasteryLevel["STRONG"] = 3] = "STRONG";
+  FluencyMasteryLevel[FluencyMasteryLevel["MASTERED"] = 4] = "MASTERED";
+  return FluencyMasteryLevel;
+}({});
+export let FluencyColorFamily = /*#__PURE__*/function (FluencyColorFamily) {
+  FluencyColorFamily["GREEN"] = "GREEN";
+  FluencyColorFamily["ORANGE"] = "ORANGE";
+  FluencyColorFamily["BLUE"] = "BLUE";
+  FluencyColorFamily["PURPLE"] = "PURPLE";
+  return FluencyColorFamily;
+}({});
+export let StreakStatus = /*#__PURE__*/function (StreakStatus) {
+  StreakStatus["MISSED"] = "missed";
+  StreakStatus["GAINED"] = "gained";
+  StreakStatus["TODAY"] = "today";
+  StreakStatus["TODAY_GAINED"] = "today_gained";
+  return StreakStatus;
+}({});
+export let AttemptStatus = /*#__PURE__*/function (AttemptStatus) {
+  AttemptStatus["CORRECT"] = "correct";
+  AttemptStatus["INCORRECT"] = "incorrect";
+  AttemptStatus["SKIPPED"] = "skipped";
+  return AttemptStatus;
+}({});
+export let MatrixConfig = /*#__PURE__*/function (MatrixConfig) {
+  MatrixConfig["STANDARD"] = "standard";
+  return MatrixConfig;
+}({});
+export const COLOR_FAMILY_PALETTES = {
+  [FluencyColorFamily.GREEN]: {
+    shades: [COLORS.GREEN_2, COLORS.GREEN_3, COLORS.PRIMARY_GREEN, COLORS.GREEN_6],
+    button: ButtonColor.GREEN,
+    select: SelectOptionColor.GREEN
+  },
+  [FluencyColorFamily.ORANGE]: {
+    shades: [COLORS.ORANGE_2, COLORS.ORANGE_3, COLORS.PRIMARY_ORANGE, COLORS.ORANGE_6],
+    button: ButtonColor.ORANGE,
+    select: SelectOptionColor.ORANGE
+  },
+  [FluencyColorFamily.BLUE]: {
+    shades: [COLORS.BLUE_2, COLORS.BLUE_3, COLORS.PRIMARY_BLUE, COLORS.BLUE_6],
+    button: ButtonColor.BLUE,
+    select: SelectOptionColor.BLUE
+  },
+  [FluencyColorFamily.PURPLE]: {
+    shades: [COLORS.PURPLE_2, COLORS.PURPLE_3, COLORS.PRIMARY_PURPLE, COLORS.PURPLE_6],
+    button: ButtonColor.PURPLE,
+    select: SelectOptionColor.PURPLE
+  }
+};
+export const FLUENCY_MODES = [createFluencyMode({
+  mode: FluencyMode.ADDITION,
+  label: 'student.fluency.addition',
+  symbol: '+',
+  colorFamily: FluencyColorFamily.GREEN
+}), createFluencyMode({
+  mode: FluencyMode.SUBTRACTION,
+  label: 'student.fluency.subtraction',
+  symbol: '−',
+  colorFamily: FluencyColorFamily.ORANGE
+}), createFluencyMode({
+  mode: FluencyMode.MULTIPLICATION,
+  label: 'student.fluency.multiplication',
+  symbol: '×',
+  colorFamily: FluencyColorFamily.BLUE
+}), createFluencyMode({
+  mode: FluencyMode.DIVISION,
+  label: 'student.fluency.division',
+  symbol: '÷',
+  colorFamily: FluencyColorFamily.PURPLE
+})];
+export const FLUENCY_MODE_PRESETS = Object.fromEntries(FLUENCY_MODES.map(({
+  mode,
+  preset
+}) => [mode, preset]));
+export const ONE_DAY_MS = 86_400_000;
+export let FluencyStatus = /*#__PURE__*/function (FluencyStatus) {
+  FluencyStatus["ERROR"] = "ERROR";
+  FluencyStatus["EMPTY"] = "EMPTY";
+  return FluencyStatus;
+}({});
+//# sourceMappingURL=fluency.constants.js.map

package/dist/module/features/fluency/shared/fluency.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ButtonColor","COLORS","SelectOptionColor","createFluencyMode","MAX_INPUT_LENGTH","SESSION_LENGTH","FLUSH_ATTEMPTS_COUNT","getTimeThresholdByGrade","grade","FluencyMode","FluencyMasteryLevel","FluencyColorFamily","StreakStatus","AttemptStatus","MatrixConfig","COLOR_FAMILY_PALETTES","GREEN","shades","GREEN_2","GREEN_3","PRIMARY_GREEN","GREEN_6","button","select","ORANGE","ORANGE_2","ORANGE_3","PRIMARY_ORANGE","ORANGE_6","BLUE","BLUE_2","BLUE_3","PRIMARY_BLUE","BLUE_6","PURPLE","PURPLE_2","PURPLE_3","PRIMARY_PURPLE","PURPLE_6","FLUENCY_MODES","mode","ADDITION","label","symbol","colorFamily","SUBTRACTION","MULTIPLICATION","DIVISION","FLUENCY_MODE_PRESETS","Object","fromEntries","map","preset","ONE_DAY_MS","FluencyStatus"],"sourceRoot":"../../../../../src","sources":["features/fluency/shared/fluency.constants.ts"],"mappings":"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","ignoreList":[]}

package/dist/module/features/fluency/shared/fluency.helpers.js

@@ -0,0 +1,125 @@
+"use strict";
+
+import { COLORS } from '@magmamath/react-native-ui';
+import { FluencyMasteryLevel, FluencyMode, COLOR_FAMILY_PALETTES, StreakStatus, ONE_DAY_MS } from "./fluency.constants.js";
+export const createFluencyMode = ({
+  mode,
+  label,
+  symbol,
+  colorFamily
+}) => {
+  const palette = COLOR_FAMILY_PALETTES[colorFamily];
+  const [learning, growing, strong, mastered] = palette.shades;
+  return {
+    mode,
+    label,
+    symbol,
+    select: palette.select,
+    preset: {
+      buttonColor: palette.button,
+      symbol,
+      accentColor: strong,
+      header: {
+        streakColor: {
+          gained: growing,
+          todayBorder: strong
+        }
+      },
+      matrix: {
+        operatorLabel: label,
+        levelColors: {
+          [FluencyMasteryLevel.NOT_STARTED]: COLORS.NEUTRAL_2,
+          [FluencyMasteryLevel.LEARNING]: learning,
+          [FluencyMasteryLevel.GROWING]: growing,
+          [FluencyMasteryLevel.STRONG]: strong,
+          [FluencyMasteryLevel.MASTERED]: mastered
+        }
+      }
+    }
+  };
+};
+export const buildMatrixGrid = (data, mode) => {
+  const facts = Object.values(data.operations[mode].facts);
+  const maxRow = Math.max(0, ...facts.map(f => f.position.row));
+  const maxColumn = Math.max(0, ...facts.map(f => f.position.column));
+  const isDivision = mode === FluencyMode.DIVISION;
+  const isSubtraction = mode === FluencyMode.SUBTRACTION;
+  const isCommutative = mode === FluencyMode.ADDITION || mode === FluencyMode.MULTIPLICATION;
+  const factAt = (row, col) => facts.find(f => f.position.row === row && f.position.column === col);
+
+  // Division columns are 1-indexed in the API (÷1, ÷2...); all others are 0-indexed.
+  // Subtraction rows: the API stores position.row = result (like division stores quotient),
+  // but we display a minuend×subtrahend grid, so we derive row count from the max minuend
+  // stored in fact.numbers[0] and look up each cell by result = minuend − subtrahend.
+  const maxMinuend = isSubtraction ? Math.max(0, ...facts.map(f => f.numbers[0])) : maxRow;
+  const rowNumbers = Array.from({
+    length: maxMinuend + 1
+  }, (_, i) => i);
+  const columnNumbers = isDivision ? Array.from({
+    length: maxColumn
+  }, (_, i) => i + 1) : Array.from({
+    length: maxColumn + 1
+  }, (_, i) => i);
+  const headerRow = [{
+    isHeader: false,
+    isEmpty: false,
+    label: null,
+    box: null,
+    numbers: null
+  }, ...columnNumbers.map(col => ({
+    isHeader: true,
+    isEmpty: false,
+    label: col,
+    box: null,
+    numbers: null
+  }))];
+  const dataRows = rowNumbers.map(row => [{
+    isHeader: true,
+    isEmpty: false,
+    label: row,
+    box: null,
+    numbers: null
+  }, ...columnNumbers.map(col => {
+    if (isSubtraction && col > row) {
+      return {
+        isHeader: false,
+        isEmpty: true,
+        label: null,
+        box: null,
+        numbers: null
+      };
+    }
+
+    // Subtraction: row=minuend, col=subtrahend — look up by result=minuend−subtrahend
+    const fact = isSubtraction ? factAt(row - col, col) : factAt(row, col);
+    const mirrorFact = isCommutative ? factAt(col, row) : null;
+    const primaryBox = fact?.box ?? null;
+    const mirrorBox = mirrorFact?.box ?? null;
+    const effectiveBox = primaryBox !== null && mirrorBox !== null ? Math.max(primaryBox, mirrorBox) : primaryBox ?? mirrorBox;
+    const numbers = fact?.numbers ?? (isDivision ? [row * col, col] : [row, col]);
+    return {
+      isHeader: false,
+      isEmpty: false,
+      label: null,
+      box: effectiveBox,
+      numbers
+    };
+  })]);
+  return [headerRow, ...dataRows];
+};
+export const allFactsEmpty = response => Object.values(response.operations).every(op => Object.keys(op.facts).length === 0);
+export const generateStreakDates = stats => {
+  const todayMs = new Date().setHours(0, 0, 0, 0);
+  const startMs = new Date(stats.weekStart).setHours(0, 0, 0, 0);
+  const practiced = new Set(stats.practicedDates.map(d => new Date(d).setHours(0, 0, 0, 0)));
+  return [0, 1, 2, 3, 4].map(i => {
+    const dayMs = startMs + i * ONE_DAY_MS;
+    const isPracticed = practiced.has(dayMs);
+    const isToday = dayMs === todayMs;
+    if (isPracticed && isToday) return StreakStatus.TODAY_GAINED;
+    if (isPracticed) return StreakStatus.GAINED;
+    if (isToday) return StreakStatus.TODAY;
+    return StreakStatus.MISSED;
+  });
+};
+//# sourceMappingURL=fluency.helpers.js.map