@magmamath/students-features 0.11.0-rc.8 → 1.0.0

package/dist/commonjs/features/chatbot/TTS_HIGHLIGHTING.md

@@ -1,120 +0,0 @@
-# TTS Word-by-Word Highlighting
-
-## Overview
-
-Word-by-word text highlighting synchronized with text-to-speech playback in the chatbot. The feature is optional and enabled via `isWordHighlightEnabled` config flag.
-
-## How It Works
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│  1. User clicks TTS button on a message                         │
-│                           ↓                                     │
-│  2. Text is converted to SSML with word marks                   │
-│     "Hello world" → <speak><mark name="w_0"/>Hello              │
-│                            <mark name="w_1"/>world</speak>      │
-│                           ↓                                     │
-│  3. Google TTS API returns audio + timepoints                   │
-│     [{ markName: "w_0", timeSeconds: 0.0 },                     │
-│      { markName: "w_1", timeSeconds: 0.5 }]                     │
-│                           ↓                                     │
-│  4. Audio plays, onTimeUpdate fires via RAF loop                │
-│                           ↓                                     │
-│  5. Current time → find matching timepoint → word index         │
-│                           ↓                                     │
-│  6. $highlightedWordIndex updates → UI re-renders highlighted   │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-## Usage
-
-```tsx
-// In students-web model setup
-chatModel.bot.setUpT2S({
-  audioProvider: createT2SAudioProvider(),
-  textSanitizer: removeKatexPartFromTextToSpeech,
-  isWordHighlightEnabled: true,
-})
-```
-
-## Architecture
-
-### ChatTTSModel (ChatTTSModel.ts)
-
-Handles TTS playback and word highlighting. Key design decisions:
-
-- **Map-based cache** — `audioCache: Map<string, AudioCache>` stores both `audioPath` and `timepoints` per message. When highlighting is off, `timepoints` is `[]`. Cache lives for the model's lifetime (cleared when user leaves the problem).
-- **`fetchAudio()` method** — encapsulates API call + audioContent decoding. Highlight vs non-highlight differences are ternaries (SSML vs plain text, `enableTimePointing`).
-- **`play()` is linear** — cache lookup → fetch if miss → store → activate highlight if enabled → play audio. No branching between highlight/non-highlight paths.
-- **Pause/resume guards** — `wordHighlightEnabled` check before toggling `setIsActive(false)`/`setIsActive(true)` on pause/resume.
-- **`wordHighlightEnabled` (private)** — stored result of `!!isWordHighlightEnabled && !!audioProvider.onTimeUpdate`. Set once at `setConfig`.
-- **`isWordHighlightEnabled` (public getter)** — read-only access for external consumers (e.g. `Chat.tsx`).
-
-### AudioProvider type
-
-```typescript
-type AudioProvider = {
-  play: (audioPath: string, onPlaybackComplete: () => void) => Promise<void>
-  pause: () => void
-  resume: () => void
-  stop: () => void
-  onTimeUpdate?: OnTimeUpdate  // optional — presence enables highlight capability
-}
-```
-
-`onTimeUpdate` is optional. It's the mechanism that syncs audio playback time with word highlights via a RAF loop. If the provider doesn't have it, highlighting won't activate even if `isWordHighlightEnabled: true`.
-
-### ChatTTSHighlightModel (ChatTTSHighlightModel.ts)
-
-Manages highlight state using Effector stores with declarative reset. Receives `OnTimeUpdate` callback directly (not the whole `AudioProvider`).
-
-- **`$isActive`** — gates `$highlightedWordIndex` computation. Toggled on pause/resume without resetting timepoints.
-- **`$highlightedWordIndex`** — derived store, returns `-1` when inactive or no match. Parses mark name via `WORD_MARK_REGEX`.
-- **`activate(timepoints, onTimeUpdate)`** — sets timepoints, enables highlighting, registers time update callback. Only triggers store updates when the highlighted word actually changes (`lastMark` comparison).
-- **`deactivate(onTimeUpdate)`** — stops listening, resets all state via declarative `.reset()` chain.
-- **All stores use `.reset(this.reset)`** — single `reset` event clears `$time`, `$timepoints`, and `$isActive`.
-
-### Helpers (helpers/ttsHighlight.ts)
-
-- **`textToSSML(text)`** — converts plain text to SSML with `<mark>` tags for word timing.
-- **`findCurrentMark(timepoints, time)`** — iterates backwards through timepoints to find the current mark. Efficient for linear playback.
-
-### Constants (constants.ts)
-
-- **`WORD_MARK_REGEX`** — `/^w_(\d+)$/` — extracts word index from mark names like `w_0`, `w_1`.
-
-### Naming conventions
-
-| Name | Scope | Purpose |
-|------|-------|---------|
-| `wordHighlight` | public instance | `ChatTTSHighlightModel` instance on `ChatTTSModel` |
-| `wordHighlightEnabled` | private field | Whether highlighting is active (set once at config) |
-| `isWordHighlightEnabled` | public getter | Read-only access to `wordHighlightEnabled` for external consumers |
-| `isWordHighlightEnabled` | T2SConfig field | Config flag passed to `setUpT2S()` |
-
-## Data Flow
-
-```
-AudioProvider.onTimeUpdate(callback)
-       ↓
-ChatTTSHighlightModel.activate(timepoints, onTimeUpdate)
-       ↓
-RAF loop → audio.currentTime → findCurrentMark() → only updates when mark changes
-       ↓
-$highlightedWordIndex = parse mark name "w_N" → N (or -1 if inactive/no match)
-       ↓
-Chat.tsx: model.t2s.isWordHighlightEnabled && isPlayingMessage ? highlightedWordIndex : -1
-       ↓
-ChatMessage → MessageContent → TTSHighlightRenderer({ text, highlightedIndex })
-```
-
-## Key Files
-
-| File | Purpose |
-|------|---------|
-| `model/ChatTTSModel.ts` | `ChatTTSModel` — TTS playback, caching, highlight orchestration |
-| `model/ChatTTSHighlightModel.ts` | Highlight state — timepoints, current time, `$isActive`, derived word index |
-| `helpers/ttsHighlight.ts` | `textToSSML` + `findCurrentMark` — SSML conversion and playback position lookup |
-| `constants.ts` | `WORD_MARK_REGEX` and audio config defaults |
-| `types/t2s.types.ts` | `AudioProvider`, `OnTimeUpdate`, `AudioStatus`, `AudioCache`, `TTSHighlightRendererProps` types |
-| `components/Chat/Chat.tsx` | Reads `isWordHighlightEnabled` and `$highlightedWordIndex`, passes to messages |

package/dist/commonjs/features/chatbot/components/Chat/CloseButton.js

@@ -1,39 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.CloseButton = void 0;
-var _react = _interopRequireDefault(require("react"));
-var _reactNative = require("react-native");
-var _reactNativeUi = require("@magmamath/react-native-ui");
-var _CloseIcon = require("../../../../shared/icons/CloseIcon.js");
-var _jsxRuntime = require("react/jsx-runtime");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-const CloseButton = ({
-  onPress
-}) => /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeUi.Button, {
-  onPress: onPress,
-  style: {
-    button: styles.button
-  },
-  variant: _reactNativeUi.ButtonVariant.PRIMARY,
-  size: _reactNativeUi.ButtonSize.MEDIUM,
-  colorScheme: _reactNativeUi.ButtonColor.WHITE,
-  raiseLevel: 5,
-  children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_CloseIcon.CloseIcon, {
-    width: 18,
-    height: 18
-  })
-});
-exports.CloseButton = CloseButton;
-const styles = _reactNative.StyleSheet.create({
-  button: {
-    width: 38,
-    height: 38,
-    borderRadius: 36,
-    paddingHorizontal: 0,
-    borderColor: _reactNativeUi.COLORS.NEUTRAL_5
-  }
-});
-//# sourceMappingURL=CloseButton.js.map

package/dist/commonjs/features/chatbot/components/Chat/CloseButton.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["_react","_interopRequireDefault","require","_reactNative","_reactNativeUi","_CloseIcon","_jsxRuntime","e","__esModule","default","CloseButton","onPress","jsx","Button","style","button","styles","variant","ButtonVariant","PRIMARY","size","ButtonSize","MEDIUM","colorScheme","ButtonColor","WHITE","raiseLevel","children","CloseIcon","width","height","exports","StyleSheet","create","borderRadius","paddingHorizontal","borderColor","COLORS","NEUTRAL_5"],"sourceRoot":"../../../../../../src","sources":["features/chatbot/components/Chat/CloseButton.tsx"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AACA,IAAAE,cAAA,GAAAF,OAAA;AACA,IAAAG,UAAA,GAAAH,OAAA;AAA8D,IAAAI,WAAA,GAAAJ,OAAA;AAAA,SAAAD,uBAAAM,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAMvD,MAAMG,WAAW,GAAGA,CAAC;EAAEC;AAA0B,CAAC,kBACvD,IAAAL,WAAA,CAAAM,GAAA,EAACR,cAAA,CAAAS,MAAM;EACLF,OAAO,EAAEA,OAAQ;EACjBG,KAAK,EAAE;IAAEC,MAAM,EAAEC,MAAM,CAACD;EAAO,CAAE;EACjCE,OAAO,EAAEC,4BAAa,CAACC,OAAQ;EAC/BC,IAAI,EAAEC,yBAAU,CAACC,MAAO;EACxBC,WAAW,EAAEC,0BAAW,CAACC,KAAM;EAC/BC,UAAU,EAAE,CAAE;EAAAC,QAAA,eAEd,IAAArB,WAAA,CAAAM,GAAA,EAACP,UAAA,CAAAuB,SAAS;IAACC,KAAK,EAAE,EAAG;IAACC,MAAM,EAAE;EAAG,CAAE;AAAC,CAC9B,CACT;AAAAC,OAAA,CAAArB,WAAA,GAAAA,WAAA;AAED,MAAMM,MAAM,GAAGgB,uBAAU,CAACC,MAAM,CAAC;EAC/BlB,MAAM,EAAE;IACNc,KAAK,EAAE,EAAE;IACTC,MAAM,EAAE,EAAE;IACVI,YAAY,EAAE,EAAE;IAChBC,iBAAiB,EAAE,CAAC;IACpBC,WAAW,EAAEC,qBAAM,CAACC;EACtB;AACF,CAAC,CAAC","ignoreList":[]}

package/dist/commonjs/features/chatbot/components/ChatMessage/AnimatedMessage.js

@@ -1,43 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.AnimatedMessage = void 0;
-var _react = _interopRequireWildcard(require("react"));
-var _reactNativeReanimated = _interopRequireWildcard(require("react-native-reanimated"));
-var _jsxRuntime = require("react/jsx-runtime");
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
-const INITIAL_OFFSET = 25;
-// const TIMING_CONFIG = { duration: 600, easing: Easing.out(Easing.cubic) }
-const SPRING_CONFIG = {
-  mass: 1,
-  stiffness: 177,
-  damping: 20
-};
-const AnimatedMessage = ({
-  children,
-  animate = true
-}) => {
-  const translateY = (0, _reactNativeReanimated.useSharedValue)(animate ? INITIAL_OFFSET : 0);
-  (0, _react.useEffect)(() => {
-    if (animate) {
-      // translateY.value = withTiming(0, TIMING_CONFIG)
-      translateY.value = (0, _reactNativeReanimated.withSpring)(0, SPRING_CONFIG);
-    }
-  }, []);
-  const animatedStyle = (0, _reactNativeReanimated.useAnimatedStyle)(() => ({
-    transform: [{
-      translateY: translateY.value
-    }]
-  }), [translateY]);
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeReanimated.default.View, {
-    style: [animate && animatedStyle, {
-      alignItems: 'flex-end'
-    }],
-    children: children
-  });
-};
-exports.AnimatedMessage = AnimatedMessage;
-//# sourceMappingURL=AnimatedMessage.js.map

package/dist/commonjs/features/chatbot/components/ChatMessage/AnimatedMessage.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNativeReanimated","_jsxRuntime","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","default","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","hasOwnProperty","call","i","set","INITIAL_OFFSET","SPRING_CONFIG","mass","stiffness","damping","AnimatedMessage","children","animate","translateY","useSharedValue","useEffect","value","withSpring","animatedStyle","useAnimatedStyle","transform","jsx","View","style","alignItems","exports"],"sourceRoot":"../../../../../../src","sources":["features/chatbot/components/ChatMessage/AnimatedMessage.tsx"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,uBAAA,CAAAC,OAAA;AACA,IAAAC,sBAAA,GAAAF,uBAAA,CAAAC,OAAA;AAMgC,IAAAE,WAAA,GAAAF,OAAA;AAAA,SAAAG,yBAAAC,CAAA,6BAAAC,OAAA,mBAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAF,wBAAA,YAAAA,CAAAC,CAAA,WAAAA,CAAA,GAAAG,CAAA,GAAAD,CAAA,KAAAF,CAAA;AAAA,SAAAL,wBAAAK,CAAA,EAAAE,CAAA,SAAAA,CAAA,IAAAF,CAAA,IAAAA,CAAA,CAAAI,UAAA,SAAAJ,CAAA,eAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,WAAAK,OAAA,EAAAL,CAAA,QAAAG,CAAA,GAAAJ,wBAAA,CAAAG,CAAA,OAAAC,CAAA,IAAAA,CAAA,CAAAG,GAAA,CAAAN,CAAA,UAAAG,CAAA,CAAAI,GAAA,CAAAP,CAAA,OAAAQ,CAAA,KAAAC,SAAA,UAAAC,CAAA,GAAAC,MAAA,CAAAC,cAAA,IAAAD,MAAA,CAAAE,wBAAA,WAAAC,CAAA,IAAAd,CAAA,oBAAAc,CAAA,OAAAC,cAAA,CAAAC,IAAA,CAAAhB,CAAA,EAAAc,CAAA,SAAAG,CAAA,GAAAP,CAAA,GAAAC,MAAA,CAAAE,wBAAA,CAAAb,CAAA,EAAAc,CAAA,UAAAG,CAAA,KAAAA,CAAA,CAAAV,GAAA,IAAAU,CAAA,CAAAC,GAAA,IAAAP,MAAA,CAAAC,cAAA,CAAAJ,CAAA,EAAAM,CAAA,EAAAG,CAAA,IAAAT,CAAA,CAAAM,CAAA,IAAAd,CAAA,CAAAc,CAAA,YAAAN,CAAA,CAAAH,OAAA,GAAAL,CAAA,EAAAG,CAAA,IAAAA,CAAA,CAAAe,GAAA,CAAAlB,CAAA,EAAAQ,CAAA,GAAAA,CAAA;AAEhC,MAAMW,cAAc,GAAG,EAAE;AACzB;AACA,MAAMC,aAAa,GAAG;EAAEC,IAAI,EAAE,CAAC;EAAEC,SAAS,EAAE,GAAG;EAAEC,OAAO,EAAE;AAAG,CAAC;AAIvD,MAAMC,eAAe,GAAGA,CAAC;EAAEC,QAAQ;EAAEC,OAAO,GAAG;AAA2B,CAAC,KAAK;EACrF,MAAMC,UAAU,GAAG,IAAAC,qCAAc,EAACF,OAAO,GAAGP,cAAc,GAAG,CAAC,CAAC;EAE/D,IAAAU,gBAAS,EAAC,MAAM;IACd,IAAIH,OAAO,EAAE;MACX;MACAC,UAAU,CAACG,KAAK,GAAG,IAAAC,iCAAU,EAAC,CAAC,EAAEX,aAAa,CAAC;IACjD;EACF,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMY,aAAa,GAAG,IAAAC,uCAAgB,EACpC,OAAO;IACLC,SAAS,EAAE,CAAC;MAAEP,UAAU,EAAEA,UAAU,CAACG;IAAM,CAAC;EAC9C,CAAC,CAAC,EACF,CAACH,UAAU,CACb,CAAC;EAED,oBACE,IAAA7B,WAAA,CAAAqC,GAAA,EAACtC,sBAAA,CAAAQ,OAAQ,CAAC+B,IAAI;IAACC,KAAK,EAAE,CAACX,OAAO,IAAIM,aAAa,EAAE;MAAEM,UAAU,EAAE;IAAW,CAAC,CAAE;IAAAb,QAAA,EAC1EA;EAAQ,CACI,CAAC;AAEpB,CAAC;AAAAc,OAAA,CAAAf,eAAA,GAAAA,eAAA","ignoreList":[]}

package/dist/module/features/chatbot/TTS_HIGHLIGHTING.md

@@ -1,120 +0,0 @@
-# TTS Word-by-Word Highlighting
-
-## Overview
-
-Word-by-word text highlighting synchronized with text-to-speech playback in the chatbot. The feature is optional and enabled via `isWordHighlightEnabled` config flag.
-
-## How It Works
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│  1. User clicks TTS button on a message                         │
-│                           ↓                                     │
-│  2. Text is converted to SSML with word marks                   │
-│     "Hello world" → <speak><mark name="w_0"/>Hello              │
-│                            <mark name="w_1"/>world</speak>      │
-│                           ↓                                     │
-│  3. Google TTS API returns audio + timepoints                   │
-│     [{ markName: "w_0", timeSeconds: 0.0 },                     │
-│      { markName: "w_1", timeSeconds: 0.5 }]                     │
-│                           ↓                                     │
-│  4. Audio plays, onTimeUpdate fires via RAF loop                │
-│                           ↓                                     │
-│  5. Current time → find matching timepoint → word index         │
-│                           ↓                                     │
-│  6. $highlightedWordIndex updates → UI re-renders highlighted   │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-## Usage
-
-```tsx
-// In students-web model setup
-chatModel.bot.setUpT2S({
-  audioProvider: createT2SAudioProvider(),
-  textSanitizer: removeKatexPartFromTextToSpeech,
-  isWordHighlightEnabled: true,
-})
-```
-
-## Architecture
-
-### ChatTTSModel (ChatTTSModel.ts)
-
-Handles TTS playback and word highlighting. Key design decisions:
-
-- **Map-based cache** — `audioCache: Map<string, AudioCache>` stores both `audioPath` and `timepoints` per message. When highlighting is off, `timepoints` is `[]`. Cache lives for the model's lifetime (cleared when user leaves the problem).
-- **`fetchAudio()` method** — encapsulates API call + audioContent decoding. Highlight vs non-highlight differences are ternaries (SSML vs plain text, `enableTimePointing`).
-- **`play()` is linear** — cache lookup → fetch if miss → store → activate highlight if enabled → play audio. No branching between highlight/non-highlight paths.
-- **Pause/resume guards** — `wordHighlightEnabled` check before toggling `setIsActive(false)`/`setIsActive(true)` on pause/resume.
-- **`wordHighlightEnabled` (private)** — stored result of `!!isWordHighlightEnabled && !!audioProvider.onTimeUpdate`. Set once at `setConfig`.
-- **`isWordHighlightEnabled` (public getter)** — read-only access for external consumers (e.g. `Chat.tsx`).
-
-### AudioProvider type
-
-```typescript
-type AudioProvider = {
-  play: (audioPath: string, onPlaybackComplete: () => void) => Promise<void>
-  pause: () => void
-  resume: () => void
-  stop: () => void
-  onTimeUpdate?: OnTimeUpdate  // optional — presence enables highlight capability
-}
-```
-
-`onTimeUpdate` is optional. It's the mechanism that syncs audio playback time with word highlights via a RAF loop. If the provider doesn't have it, highlighting won't activate even if `isWordHighlightEnabled: true`.
-
-### ChatTTSHighlightModel (ChatTTSHighlightModel.ts)
-
-Manages highlight state using Effector stores with declarative reset. Receives `OnTimeUpdate` callback directly (not the whole `AudioProvider`).
-
-- **`$isActive`** — gates `$highlightedWordIndex` computation. Toggled on pause/resume without resetting timepoints.
-- **`$highlightedWordIndex`** — derived store, returns `-1` when inactive or no match. Parses mark name via `WORD_MARK_REGEX`.
-- **`activate(timepoints, onTimeUpdate)`** — sets timepoints, enables highlighting, registers time update callback. Only triggers store updates when the highlighted word actually changes (`lastMark` comparison).
-- **`deactivate(onTimeUpdate)`** — stops listening, resets all state via declarative `.reset()` chain.
-- **All stores use `.reset(this.reset)`** — single `reset` event clears `$time`, `$timepoints`, and `$isActive`.
-
-### Helpers (helpers/ttsHighlight.ts)
-
-- **`textToSSML(text)`** — converts plain text to SSML with `<mark>` tags for word timing.
-- **`findCurrentMark(timepoints, time)`** — iterates backwards through timepoints to find the current mark. Efficient for linear playback.
-
-### Constants (constants.ts)
-
-- **`WORD_MARK_REGEX`** — `/^w_(\d+)$/` — extracts word index from mark names like `w_0`, `w_1`.
-
-### Naming conventions
-
-| Name | Scope | Purpose |
-|------|-------|---------|
-| `wordHighlight` | public instance | `ChatTTSHighlightModel` instance on `ChatTTSModel` |
-| `wordHighlightEnabled` | private field | Whether highlighting is active (set once at config) |
-| `isWordHighlightEnabled` | public getter | Read-only access to `wordHighlightEnabled` for external consumers |
-| `isWordHighlightEnabled` | T2SConfig field | Config flag passed to `setUpT2S()` |
-
-## Data Flow
-
-```
-AudioProvider.onTimeUpdate(callback)
-       ↓
-ChatTTSHighlightModel.activate(timepoints, onTimeUpdate)
-       ↓
-RAF loop → audio.currentTime → findCurrentMark() → only updates when mark changes
-       ↓
-$highlightedWordIndex = parse mark name "w_N" → N (or -1 if inactive/no match)
-       ↓
-Chat.tsx: model.t2s.isWordHighlightEnabled && isPlayingMessage ? highlightedWordIndex : -1
-       ↓
-ChatMessage → MessageContent → TTSHighlightRenderer({ text, highlightedIndex })
-```
-
-## Key Files
-
-| File | Purpose |
-|------|---------|
-| `model/ChatTTSModel.ts` | `ChatTTSModel` — TTS playback, caching, highlight orchestration |
-| `model/ChatTTSHighlightModel.ts` | Highlight state — timepoints, current time, `$isActive`, derived word index |
-| `helpers/ttsHighlight.ts` | `textToSSML` + `findCurrentMark` — SSML conversion and playback position lookup |
-| `constants.ts` | `WORD_MARK_REGEX` and audio config defaults |
-| `types/t2s.types.ts` | `AudioProvider`, `OnTimeUpdate`, `AudioStatus`, `AudioCache`, `TTSHighlightRendererProps` types |
-| `components/Chat/Chat.tsx` | Reads `isWordHighlightEnabled` and `$highlightedWordIndex`, passes to messages |

package/dist/module/features/chatbot/components/Chat/CloseButton.js

@@ -1,33 +0,0 @@
-"use strict";
-
-import React from 'react';
-import { StyleSheet } from 'react-native';
-import { Button, ButtonColor, ButtonSize, ButtonVariant, COLORS } from '@magmamath/react-native-ui';
-import { CloseIcon } from "../../../../shared/icons/CloseIcon.js";
-import { jsx as _jsx } from "react/jsx-runtime";
-export const CloseButton = ({
-  onPress
-}) => /*#__PURE__*/_jsx(Button, {
-  onPress: onPress,
-  style: {
-    button: styles.button
-  },
-  variant: ButtonVariant.PRIMARY,
-  size: ButtonSize.MEDIUM,
-  colorScheme: ButtonColor.WHITE,
-  raiseLevel: 5,
-  children: /*#__PURE__*/_jsx(CloseIcon, {
-    width: 18,
-    height: 18
-  })
-});
-const styles = StyleSheet.create({
-  button: {
-    width: 38,
-    height: 38,
-    borderRadius: 36,
-    paddingHorizontal: 0,
-    borderColor: COLORS.NEUTRAL_5
-  }
-});
-//# sourceMappingURL=CloseButton.js.map

package/dist/module/features/chatbot/components/Chat/CloseButton.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["React","StyleSheet","Button","ButtonColor","ButtonSize","ButtonVariant","COLORS","CloseIcon","jsx","_jsx","CloseButton","onPress","style","button","styles","variant","PRIMARY","size","MEDIUM","colorScheme","WHITE","raiseLevel","children","width","height","create","borderRadius","paddingHorizontal","borderColor","NEUTRAL_5"],"sourceRoot":"../../../../../../src","sources":["features/chatbot/components/Chat/CloseButton.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,UAAU,QAAQ,cAAc;AACzC,SAASC,MAAM,EAAEC,WAAW,EAAEC,UAAU,EAAEC,aAAa,EAAEC,MAAM,QAAQ,4BAA4B;AACnG,SAASC,SAAS,QAAQ,uCAAoC;AAAA,SAAAC,GAAA,IAAAC,IAAA;AAM9D,OAAO,MAAMC,WAAW,GAAGA,CAAC;EAAEC;AAA0B,CAAC,kBACvDF,IAAA,CAACP,MAAM;EACLS,OAAO,EAAEA,OAAQ;EACjBC,KAAK,EAAE;IAAEC,MAAM,EAAEC,MAAM,CAACD;EAAO,CAAE;EACjCE,OAAO,EAAEV,aAAa,CAACW,OAAQ;EAC/BC,IAAI,EAAEb,UAAU,CAACc,MAAO;EACxBC,WAAW,EAAEhB,WAAW,CAACiB,KAAM;EAC/BC,UAAU,EAAE,CAAE;EAAAC,QAAA,eAEdb,IAAA,CAACF,SAAS;IAACgB,KAAK,EAAE,EAAG;IAACC,MAAM,EAAE;EAAG,CAAE;AAAC,CAC9B,CACT;AAED,MAAMV,MAAM,GAAGb,UAAU,CAACwB,MAAM,CAAC;EAC/BZ,MAAM,EAAE;IACNU,KAAK,EAAE,EAAE;IACTC,MAAM,EAAE,EAAE;IACVE,YAAY,EAAE,EAAE;IAChBC,iBAAiB,EAAE,CAAC;IACpBC,WAAW,EAAEtB,MAAM,CAACuB;EACtB;AACF,CAAC,CAAC","ignoreList":[]}

package/dist/module/features/chatbot/components/ChatMessage/AnimatedMessage.js

@@ -1,40 +0,0 @@
-"use strict";
-
-import React, { useEffect } from 'react';
-import Animated, {
-// Easing,
-useAnimatedStyle, useSharedValue,
-// withTiming,
-withSpring } from 'react-native-reanimated';
-import { jsx as _jsx } from "react/jsx-runtime";
-const INITIAL_OFFSET = 25;
-// const TIMING_CONFIG = { duration: 600, easing: Easing.out(Easing.cubic) }
-const SPRING_CONFIG = {
-  mass: 1,
-  stiffness: 177,
-  damping: 20
-};
-export const AnimatedMessage = ({
-  children,
-  animate = true
-}) => {
-  const translateY = useSharedValue(animate ? INITIAL_OFFSET : 0);
-  useEffect(() => {
-    if (animate) {
-      // translateY.value = withTiming(0, TIMING_CONFIG)
-      translateY.value = withSpring(0, SPRING_CONFIG);
-    }
-  }, []);
-  const animatedStyle = useAnimatedStyle(() => ({
-    transform: [{
-      translateY: translateY.value
-    }]
-  }), [translateY]);
-  return /*#__PURE__*/_jsx(Animated.View, {
-    style: [animate && animatedStyle, {
-      alignItems: 'flex-end'
-    }],
-    children: children
-  });
-};
-//# sourceMappingURL=AnimatedMessage.js.map

package/dist/module/features/chatbot/components/ChatMessage/AnimatedMessage.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["React","useEffect","Animated","useAnimatedStyle","useSharedValue","withSpring","jsx","_jsx","INITIAL_OFFSET","SPRING_CONFIG","mass","stiffness","damping","AnimatedMessage","children","animate","translateY","value","animatedStyle","transform","View","style","alignItems"],"sourceRoot":"../../../../../../src","sources":["features/chatbot/components/ChatMessage/AnimatedMessage.tsx"],"mappings":";;AAAA,OAAOA,KAAK,IAAuBC,SAAS,QAAQ,OAAO;AAC3D,OAAOC,QAAQ;AACb;AACAC,gBAAgB,EAChBC,cAAc;AACd;AACAC,UAAU,QACL,yBAAyB;AAAA,SAAAC,GAAA,IAAAC,IAAA;AAEhC,MAAMC,cAAc,GAAG,EAAE;AACzB;AACA,MAAMC,aAAa,GAAG;EAAEC,IAAI,EAAE,CAAC;EAAEC,SAAS,EAAE,GAAG;EAAEC,OAAO,EAAE;AAAG,CAAC;AAI9D,OAAO,MAAMC,eAAe,GAAGA,CAAC;EAAEC,QAAQ;EAAEC,OAAO,GAAG;AAA2B,CAAC,KAAK;EACrF,MAAMC,UAAU,GAAGZ,cAAc,CAACW,OAAO,GAAGP,cAAc,GAAG,CAAC,CAAC;EAE/DP,SAAS,CAAC,MAAM;IACd,IAAIc,OAAO,EAAE;MACX;MACAC,UAAU,CAACC,KAAK,GAAGZ,UAAU,CAAC,CAAC,EAAEI,aAAa,CAAC;IACjD;EACF,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMS,aAAa,GAAGf,gBAAgB,CACpC,OAAO;IACLgB,SAAS,EAAE,CAAC;MAAEH,UAAU,EAAEA,UAAU,CAACC;IAAM,CAAC;EAC9C,CAAC,CAAC,EACF,CAACD,UAAU,CACb,CAAC;EAED,oBACET,IAAA,CAACL,QAAQ,CAACkB,IAAI;IAACC,KAAK,EAAE,CAACN,OAAO,IAAIG,aAAa,EAAE;MAAEI,UAAU,EAAE;IAAW,CAAC,CAAE;IAAAR,QAAA,EAC1EA;EAAQ,CACI,CAAC;AAEpB,CAAC","ignoreList":[]}

package/dist/typescript/commonjs/features/chatbot/components/Chat/CloseButton.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-type CloseButtonProps = {
-    onPress?: () => void;
-};
-export declare const CloseButton: ({ onPress }: CloseButtonProps) => React.JSX.Element;
-export {};
-//# sourceMappingURL=CloseButton.d.ts.map

package/dist/typescript/commonjs/features/chatbot/components/Chat/CloseButton.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CloseButton.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/chatbot/components/Chat/CloseButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,KAAK,gBAAgB,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,WAAW,gBAAiB,gBAAgB,sBAWxD,CAAA"}

package/dist/typescript/commonjs/features/chatbot/components/ChatMessage/AnimatedMessage.d.ts

@@ -1,7 +0,0 @@
-import React, { PropsWithChildren } from 'react';
-type AnimatedMessageProps = PropsWithChildren<{
-    animate?: boolean;
-}>;
-export declare const AnimatedMessage: ({ children, animate }: AnimatedMessageProps) => React.JSX.Element;
-export {};
-//# sourceMappingURL=AnimatedMessage.d.ts.map

package/dist/typescript/commonjs/features/chatbot/components/ChatMessage/AnimatedMessage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AnimatedMessage.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/chatbot/components/ChatMessage/AnimatedMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,iBAAiB,EAAa,MAAM,OAAO,CAAA;AAa3D,KAAK,oBAAoB,GAAG,iBAAiB,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAA;AAEpE,eAAO,MAAM,eAAe,0BAAkC,oBAAoB,sBAsBjF,CAAA"}

package/dist/typescript/module/features/chatbot/components/Chat/CloseButton.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-type CloseButtonProps = {
-    onPress?: () => void;
-};
-export declare const CloseButton: ({ onPress }: CloseButtonProps) => React.JSX.Element;
-export {};
-//# sourceMappingURL=CloseButton.d.ts.map

package/dist/typescript/module/features/chatbot/components/Chat/CloseButton.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CloseButton.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/chatbot/components/Chat/CloseButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,KAAK,gBAAgB,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,WAAW,gBAAiB,gBAAgB,sBAWxD,CAAA"}

package/dist/typescript/module/features/chatbot/components/ChatMessage/AnimatedMessage.d.ts

@@ -1,7 +0,0 @@
-import React, { PropsWithChildren } from 'react';
-type AnimatedMessageProps = PropsWithChildren<{
-    animate?: boolean;
-}>;
-export declare const AnimatedMessage: ({ children, animate }: AnimatedMessageProps) => React.JSX.Element;
-export {};
-//# sourceMappingURL=AnimatedMessage.d.ts.map

package/dist/typescript/module/features/chatbot/components/ChatMessage/AnimatedMessage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AnimatedMessage.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/chatbot/components/ChatMessage/AnimatedMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,iBAAiB,EAAa,MAAM,OAAO,CAAA;AAa3D,KAAK,oBAAoB,GAAG,iBAAiB,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAA;AAEpE,eAAO,MAAM,eAAe,0BAAkC,oBAAoB,sBAsBjF,CAAA"}

package/src/features/chatbot/TTS_HIGHLIGHTING.md

@@ -1,120 +0,0 @@
-# TTS Word-by-Word Highlighting
-
-## Overview
-
-Word-by-word text highlighting synchronized with text-to-speech playback in the chatbot. The feature is optional and enabled via `isWordHighlightEnabled` config flag.
-
-## How It Works
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│  1. User clicks TTS button on a message                         │
-│                           ↓                                     │
-│  2. Text is converted to SSML with word marks                   │
-│     "Hello world" → <speak><mark name="w_0"/>Hello              │
-│                            <mark name="w_1"/>world</speak>      │
-│                           ↓                                     │
-│  3. Google TTS API returns audio + timepoints                   │
-│     [{ markName: "w_0", timeSeconds: 0.0 },                     │
-│      { markName: "w_1", timeSeconds: 0.5 }]                     │
-│                           ↓                                     │
-│  4. Audio plays, onTimeUpdate fires via RAF loop                │
-│                           ↓                                     │
-│  5. Current time → find matching timepoint → word index         │
-│                           ↓                                     │
-│  6. $highlightedWordIndex updates → UI re-renders highlighted   │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-## Usage
-
-```tsx
-// In students-web model setup
-chatModel.bot.setUpT2S({
-  audioProvider: createT2SAudioProvider(),
-  textSanitizer: removeKatexPartFromTextToSpeech,
-  isWordHighlightEnabled: true,
-})
-```
-
-## Architecture
-
-### ChatTTSModel (ChatTTSModel.ts)
-
-Handles TTS playback and word highlighting. Key design decisions:
-
-- **Map-based cache** — `audioCache: Map<string, AudioCache>` stores both `audioPath` and `timepoints` per message. When highlighting is off, `timepoints` is `[]`. Cache lives for the model's lifetime (cleared when user leaves the problem).
-- **`fetchAudio()` method** — encapsulates API call + audioContent decoding. Highlight vs non-highlight differences are ternaries (SSML vs plain text, `enableTimePointing`).
-- **`play()` is linear** — cache lookup → fetch if miss → store → activate highlight if enabled → play audio. No branching between highlight/non-highlight paths.
-- **Pause/resume guards** — `wordHighlightEnabled` check before toggling `setIsActive(false)`/`setIsActive(true)` on pause/resume.
-- **`wordHighlightEnabled` (private)** — stored result of `!!isWordHighlightEnabled && !!audioProvider.onTimeUpdate`. Set once at `setConfig`.
-- **`isWordHighlightEnabled` (public getter)** — read-only access for external consumers (e.g. `Chat.tsx`).
-
-### AudioProvider type
-
-```typescript
-type AudioProvider = {
-  play: (audioPath: string, onPlaybackComplete: () => void) => Promise<void>
-  pause: () => void
-  resume: () => void
-  stop: () => void
-  onTimeUpdate?: OnTimeUpdate  // optional — presence enables highlight capability
-}
-```
-
-`onTimeUpdate` is optional. It's the mechanism that syncs audio playback time with word highlights via a RAF loop. If the provider doesn't have it, highlighting won't activate even if `isWordHighlightEnabled: true`.
-
-### ChatTTSHighlightModel (ChatTTSHighlightModel.ts)
-
-Manages highlight state using Effector stores with declarative reset. Receives `OnTimeUpdate` callback directly (not the whole `AudioProvider`).
-
-- **`$isActive`** — gates `$highlightedWordIndex` computation. Toggled on pause/resume without resetting timepoints.
-- **`$highlightedWordIndex`** — derived store, returns `-1` when inactive or no match. Parses mark name via `WORD_MARK_REGEX`.
-- **`activate(timepoints, onTimeUpdate)`** — sets timepoints, enables highlighting, registers time update callback. Only triggers store updates when the highlighted word actually changes (`lastMark` comparison).
-- **`deactivate(onTimeUpdate)`** — stops listening, resets all state via declarative `.reset()` chain.
-- **All stores use `.reset(this.reset)`** — single `reset` event clears `$time`, `$timepoints`, and `$isActive`.
-
-### Helpers (helpers/ttsHighlight.ts)
-
-- **`textToSSML(text)`** — converts plain text to SSML with `<mark>` tags for word timing.
-- **`findCurrentMark(timepoints, time)`** — iterates backwards through timepoints to find the current mark. Efficient for linear playback.
-
-### Constants (constants.ts)
-
-- **`WORD_MARK_REGEX`** — `/^w_(\d+)$/` — extracts word index from mark names like `w_0`, `w_1`.
-
-### Naming conventions
-
-| Name | Scope | Purpose |
-|------|-------|---------|
-| `wordHighlight` | public instance | `ChatTTSHighlightModel` instance on `ChatTTSModel` |
-| `wordHighlightEnabled` | private field | Whether highlighting is active (set once at config) |
-| `isWordHighlightEnabled` | public getter | Read-only access to `wordHighlightEnabled` for external consumers |
-| `isWordHighlightEnabled` | T2SConfig field | Config flag passed to `setUpT2S()` |
-
-## Data Flow
-
-```
-AudioProvider.onTimeUpdate(callback)
-       ↓
-ChatTTSHighlightModel.activate(timepoints, onTimeUpdate)
-       ↓
-RAF loop → audio.currentTime → findCurrentMark() → only updates when mark changes
-       ↓
-$highlightedWordIndex = parse mark name "w_N" → N (or -1 if inactive/no match)
-       ↓
-Chat.tsx: model.t2s.isWordHighlightEnabled && isPlayingMessage ? highlightedWordIndex : -1
-       ↓
-ChatMessage → MessageContent → TTSHighlightRenderer({ text, highlightedIndex })
-```
-
-## Key Files
-
-| File | Purpose |
-|------|---------|
-| `model/ChatTTSModel.ts` | `ChatTTSModel` — TTS playback, caching, highlight orchestration |
-| `model/ChatTTSHighlightModel.ts` | Highlight state — timepoints, current time, `$isActive`, derived word index |
-| `helpers/ttsHighlight.ts` | `textToSSML` + `findCurrentMark` — SSML conversion and playback position lookup |
-| `constants.ts` | `WORD_MARK_REGEX` and audio config defaults |
-| `types/t2s.types.ts` | `AudioProvider`, `OnTimeUpdate`, `AudioStatus`, `AudioCache`, `TTSHighlightRendererProps` types |
-| `components/Chat/Chat.tsx` | Reads `isWordHighlightEnabled` and `$highlightedWordIndex`, passes to messages |

package/src/features/chatbot/components/Chat/CloseButton.tsx

@@ -1,31 +0,0 @@
-import React from 'react'
-import { StyleSheet } from 'react-native'
-import { Button, ButtonColor, ButtonSize, ButtonVariant, COLORS } from '@magmamath/react-native-ui'
-import { CloseIcon } from '../../../../shared/icons/CloseIcon'
-
-type CloseButtonProps = {
-  onPress?: () => void
-}
-
-export const CloseButton = ({ onPress }: CloseButtonProps) => (
-  <Button
-    onPress={onPress}
-    style={{ button: styles.button }}
-    variant={ButtonVariant.PRIMARY}
-    size={ButtonSize.MEDIUM}
-    colorScheme={ButtonColor.WHITE}
-    raiseLevel={5}
-  >
-    <CloseIcon width={18} height={18} />
-  </Button>
-)
-
-const styles = StyleSheet.create({
-  button: {
-    width: 38,
-    height: 38,
-    borderRadius: 36,
-    paddingHorizontal: 0,
-    borderColor: COLORS.NEUTRAL_5,
-  },
-})