@scalemule/nextjs 0.1.44 → 0.1.45

package/dist/audio.d.mts

@@ -73,6 +73,37 @@ interface NarrationTimings {
     /** [text, start_ms, end_ms, sentence_index] */
     words: [string, number, number, number][];
 }
+declare const WORD_HIGHLIGHT = "sm-narration-word";
+declare const SENTENCE_HIGHLIGHT = "sm-narration-sentence";
 declare function narrationHighlightSupported(): boolean;
+/**
+ * Owns the live highlight for one narration player. Build once per
+ * (timings, article body) pair; drive with `update(currentTimeMs)`.
+ */
+declare class NarrationHighlighter {
+    private words;
+    private ranges;
+    private sentenceRanges;
+    private currentWord;
+    private currentSentence;
+    private follow;
+    private detachUserScroll;
+    private reducedMotion;
+    constructor(root: Element, timings: NarrationTimings);
+    /** Fraction of narration words found in the article body. A low
+     * ratio means the body diverged from the script; callers may prefer
+     * to hide the toggle below ~0.5. */
+    matchRatio(): number;
+    private attachUserScroll;
+    /** Re-engage auto-scroll (the reader pressed the toggle or sought). */
+    resumeFollowing(): void;
+    update(timeMs: number): void;
+    private scrollTo;
+    clear(): void;
+    destroy(): void;
+}
+/** Parse a fetched timings payload; accepts the raw timings object or
+ * common envelopes ({timings}, {data:{timings}}). */
+declare function parseTimingsPayload(body: unknown): NarrationTimings | null;
 
-export { AudioPlayer, type AudioPlayerNarration, type AudioPlayerProps, type AudioPlayerSource, type AudioPlayerVariant, type NarrationTimings, narrationHighlightSupported };
+export { AudioPlayer, type AudioPlayerNarration, type AudioPlayerProps, type AudioPlayerSource, type AudioPlayerVariant, NarrationHighlighter, type NarrationTimings, SENTENCE_HIGHLIGHT, WORD_HIGHLIGHT, narrationHighlightSupported, parseTimingsPayload };

package/dist/audio.d.ts

@@ -73,6 +73,37 @@ interface NarrationTimings {
     /** [text, start_ms, end_ms, sentence_index] */
     words: [string, number, number, number][];
 }
+declare const WORD_HIGHLIGHT = "sm-narration-word";
+declare const SENTENCE_HIGHLIGHT = "sm-narration-sentence";
 declare function narrationHighlightSupported(): boolean;
+/**
+ * Owns the live highlight for one narration player. Build once per
+ * (timings, article body) pair; drive with `update(currentTimeMs)`.
+ */
+declare class NarrationHighlighter {
+    private words;
+    private ranges;
+    private sentenceRanges;
+    private currentWord;
+    private currentSentence;
+    private follow;
+    private detachUserScroll;
+    private reducedMotion;
+    constructor(root: Element, timings: NarrationTimings);
+    /** Fraction of narration words found in the article body. A low
+     * ratio means the body diverged from the script; callers may prefer
+     * to hide the toggle below ~0.5. */
+    matchRatio(): number;
+    private attachUserScroll;
+    /** Re-engage auto-scroll (the reader pressed the toggle or sought). */
+    resumeFollowing(): void;
+    update(timeMs: number): void;
+    private scrollTo;
+    clear(): void;
+    destroy(): void;
+}
+/** Parse a fetched timings payload; accepts the raw timings object or
+ * common envelopes ({timings}, {data:{timings}}). */
+declare function parseTimingsPayload(body: unknown): NarrationTimings | null;
 
-export { AudioPlayer, type AudioPlayerNarration, type AudioPlayerProps, type AudioPlayerSource, type AudioPlayerVariant, type NarrationTimings, narrationHighlightSupported };
+export { AudioPlayer, type AudioPlayerNarration, type AudioPlayerProps, type AudioPlayerSource, type AudioPlayerVariant, NarrationHighlighter, type NarrationTimings, SENTENCE_HIGHLIGHT, WORD_HIGHLIGHT, narrationHighlightSupported, parseTimingsPayload };

package/dist/audio.js

@@ -23,7 +23,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var audio_exports = {};
 __export(audio_exports, {
   AudioPlayer: () => AudioPlayer,
-  narrationHighlightSupported: () => narrationHighlightSupported
+  NarrationHighlighter: () => NarrationHighlighter,
+  SENTENCE_HIGHLIGHT: () => SENTENCE_HIGHLIGHT,
+  WORD_HIGHLIGHT: () => WORD_HIGHLIGHT,
+  narrationHighlightSupported: () => narrationHighlightSupported,
+  parseTimingsPayload: () => parseTimingsPayload
 });
 module.exports = __toCommonJS(audio_exports);
 
@@ -680,5 +684,9 @@ function PlayerSession({
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AudioPlayer,
-  narrationHighlightSupported
+  NarrationHighlighter,
+  SENTENCE_HIGHLIGHT,
+  WORD_HIGHLIGHT,
+  narrationHighlightSupported,
+  parseTimingsPayload
 });

package/dist/audio.mjs

@@ -659,5 +659,9 @@ function PlayerSession({
 }
 export {
   AudioPlayer,
-  narrationHighlightSupported
+  NarrationHighlighter,
+  SENTENCE_HIGHLIGHT,
+  WORD_HIGHLIGHT,
+  narrationHighlightSupported,
+  parseTimingsPayload
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/nextjs",
-  "version": "0.1.44",
+  "version": "0.1.45",
   "description": "ScaleMule SDK for Next.js applications - authentication, storage, and user management",
   "main": "dist/index.js",
   "module": "dist/index.mjs",