retiam 2.0.2 → 2.0.3

package/dist/libs/explainer/index.js

@@ -1,112 +1,113 @@
-import { assertLesson as S, voiceKey as x, speechKey as y, compileLesson as E, resolveStyle as A } from "./plan.js";
+import { assertLesson as S, voiceKey as M, speechKey as y, compileLesson as E, resolveStyle as A } from "./plan.js";
 import { STYLE_PROFILES as ae, lessonCaptions as oe, validateLesson as se } from "./plan.js";
-import { CustomAnimation as v, TrackAnimation as q, Waiting as C, hex as b, Color as T, Excalidraw as $, Create as z, Tex as N, CENTER as D, Rate as k } from "retiam";
-import { TTS as L } from "retiam/tts";
+import { CustomAnimation as x, TrackAnimation as q, Waiting as C, hex as v, Color as $, Excalidraw as z, Create as N, Tex as D, CENTER as L, Rate as k } from "retiam";
+import { TTS as T } from "retiam/tts";
 /*! Retiam: noncommercial use only unless separately licensed. See ../../LICENSE and ../../COMMERCIAL_LICENSE.md. Third-party notices: ../../THIRD_PARTY_NOTICES.md and ../../THIRD_PARTY_LICENSES.txt. */
 function Y(r, t, i = {}) {
   S(t);
-  const d = (async () => {
+  const u = (async () => {
     const s = /* @__PURE__ */ new Map();
     let a = i.prepared;
     if (t.narration.enabled) {
-      if (!a && !i.synthesize && (t.narration.provider ?? "msedge") !== "msedge")
-        throw new Error("Provide prepared speech or a synthesize adapter for this narration provider.");
-      const m = r.audio;
-      if (a && a.voiceKey !== x(t))
+      const f = t.narration.provider ?? "msedge";
+      if (!a && !i.synthesize && T.provider.name !== (f === "msedge" ? "msedge-tts" : f))
+        throw new Error("Initialize and select the lesson narration provider, or provide prepared speech or a synthesize adapter.");
+      const c = r.audio;
+      if (a && a.voiceKey !== M(t))
         throw new Error("Prepared narration uses different voice settings. Prepare narration again.");
-      a = a ?? { version: 1, voiceKey: x(t), assets: {} };
-      const c = t.beats.flatMap((n) => n.narration.map((e) => ({ beat: n.id, segment: e })));
+      a = a ?? { version: 1, voiceKey: M(t), assets: {} };
+      const p = t.beats.flatMap((e) => e.narration.map((o) => ({ beat: e.id, segment: o })));
       let w = 0;
-      await Promise.all(Array.from({ length: Math.min(3, c.length) }, async () => {
-        for (; w < c.length; ) {
-          const n = c[w++], e = y(n.beat, n.segment.id);
-          let u;
+      await Promise.all(Array.from({ length: Math.min(3, p.length) }, async () => {
+        for (; w < p.length; ) {
+          const e = p[w++], o = y(e.beat, e.segment.id);
+          let g;
           if (i.prepared) {
-            const o = a.assets[e];
-            if (!o || o.text !== n.segment.text || !o.url)
-              throw new Error(`Missing/stale prepared asset: ${e}.`);
-            const g = await fetch(o.url);
-            if (!g.ok)
-              throw new Error(`Narration asset ${o.url}: HTTP ${g.status}.`);
-            if (u = await m.context.decodeAudioData(await g.arrayBuffer()), Math.abs(u.duration * 1e3 - o.durationMs) > 120)
-              throw new Error(`Narration duration mismatch: ${e}.`);
+            const d = a.assets[o];
+            if (!d || d.text !== e.segment.text || (d.speechText ?? d.text) !== (e.segment.speechText ?? e.segment.text) || !d.url)
+              throw new Error(`Missing/stale prepared asset: ${o}.`);
+            const l = await fetch(d.url);
+            if (!l.ok)
+              throw new Error(`Narration asset ${d.url}: HTTP ${l.status}.`);
+            if (g = await c.context.decodeAudioData(await l.arrayBuffer()), Math.abs(g.duration * 1e3 - d.durationMs) > 120)
+              throw new Error(`Narration duration mismatch: ${o}.`);
           } else {
-            const o = await (i.synthesize?.(n.segment.text) ?? L.synthesize(n.segment.text, { voice: t.narration.voice ?? "en-US-AndrewNeural", speed: t.narration.speed ?? 1, pitch: t.narration.pitch ?? "+0Hz", volume: 1 }));
-            a.assets[e] = { text: n.segment.text, durationMs: o.durationMs, words: (o.wordBoundaries ?? []).map((g) => ({ text: g.text, offsetMs: g.offsetMs, durationMs: g.durationMs })) }, u = o.rawBuffer ? await m.context.decodeAudioData(o.rawBuffer.slice(0)) : o.toAudioBuffer(m.context);
+            const d = e.segment.speechText ?? e.segment.text, l = await (i.synthesize?.(d) ?? T.synthesize(d, { voice: t.narration.voice ?? (f === "msedge" ? "en-US-AndrewNeural" : void 0), speed: t.narration.speed, pitch: t.narration.pitch, volume: 1, displayText: e.segment.text, elevenlabs: t.narration.elevenlabs }));
+            a.assets[o] = { text: e.segment.text, speechText: e.segment.speechText, durationMs: l.durationMs, words: (l.wordBoundaries ?? []).map((n) => ({ text: n.text, offsetMs: n.offsetMs, durationMs: n.durationMs })) }, g = l.rawBuffer ? await c.context.decodeAudioData(l.rawBuffer.slice(0)) : l.toAudioBuffer(c.context);
           }
-          s.set(e, u);
+          s.set(o, g);
         }
       }));
     }
-    const l = E(t, a, i.fps ?? 60), h = A(t.style);
-    return { plan: t, timeline: l, style: h, async run(m) {
+    const h = E(t, a, i.fps ?? 60), m = A(t.style);
+    return { plan: t, timeline: h, style: m, async run(f) {
       const c = new Set(t.beats.map((e) => e.id));
-      for (const e of Object.keys(m))
+      for (const e of Object.keys(f))
         if (!c.has(e))
           throw new Error(`Unknown beat handler '${e}'.`);
-      const w = [];
-      for (const e of l.beats) {
-        const u = m[e.id];
-        if (!u)
+      const p = [];
+      for (const e of h.beats) {
+        const o = f[e.id];
+        if (!o)
           throw new Error(`Missing beat handler '${e.id}'.`);
-        const o = (f) => {
-          const p = e.cues[f];
-          if (p === void 0)
-            throw new Error(`Unknown cue '${e.id}/${f}'.`);
-          return p;
-        }, g = u({ beat: e, durationMs: e.durationMs, style: h, cue: o, at: (f, p) => new v(() => {
-        }, { delay: o(f), duration: 1, onStart: p }) });
-        for (const f of g)
-          if (!Number.isFinite(f.delay) || !Number.isFinite(f.duration) || f.delay < 0 || f.duration < 0 || f.delay + f.duration > e.durationMs + 0.1)
+        const g = (n) => {
+          const b = e.cues[n];
+          if (b === void 0)
+            throw new Error(`Unknown cue '${e.id}/${n}'.`);
+          return b;
+        }, d = o({ beat: e, durationMs: e.durationMs, style: m, cue: g, at: (n, b) => new x(() => {
+        }, { delay: g(n), duration: 1, onStart: b }) });
+        for (const n of d)
+          if (!Number.isFinite(n.delay) || !Number.isFinite(n.duration) || n.delay < 0 || n.duration < 0 || n.delay + n.duration > e.durationMs + 0.1)
             throw new Error(`Animation exceeds beat '${e.id}' (${e.durationMs} ms).`);
-        const M = new q([...g, new C({ duration: e.durationMs })]);
-        M.delay = e.startMs, w.push(M);
+        const l = new q([...d, new C({ duration: e.durationMs })]);
+        l.delay = e.startMs, p.push(l);
       }
-      const n = r.composer?.time ?? 0;
+      const w = r.composer?.time ?? 0;
       if (t.narration.enabled)
-        for (const e of l.beats)
-          for (const u of e.segments) {
-            const o = s.get(y(e.id, u.id));
-            r.audio.timeline.addClip(o, n + e.startMs + u.startMs, r.audio.voiceoverGain, { volume: t.narration.volume ?? 1, bus: "voiceover" }), r.audio.timeline.addVolumeAutomation("bgm", n + e.startMs + u.startMs, r.audio.bgmVolume * 0.25, 200), r.audio.timeline.addVolumeAutomation("bgm", n + e.startMs + u.startMs + u.durationMs, r.audio.bgmVolume, 200);
+        for (const e of h.beats)
+          for (const o of e.segments) {
+            const g = s.get(y(e.id, o.id));
+            r.audio.timeline.addClip(g, w + e.startMs + o.startMs, r.audio.voiceoverGain, { volume: t.narration.volume ?? 1, bus: "voiceover" }), r.audio.timeline.addVolumeAutomation("bgm", w + e.startMs + o.startMs, r.audio.bgmVolume * 0.25, 200), r.audio.timeline.addVolumeAutomation("bgm", w + e.startMs + o.startMs + o.durationMs, r.audio.bgmVolume, 200);
           }
-      r.clearColor(b(h.background)), await r.play(new q(w));
+      r.clearColor(v(m.background)), await r.play(new q(p));
     } };
   })();
-  return r.composer?.pendingTasks.push(d), d;
+  return r.composer?.pendingTasks.push(u), u;
 }
-function J(r, t, i = "primary", d = !1) {
+function J(r, t, i = "primary", u = !1) {
   const s = t[i];
-  return r.setStroke(t.strokeWidth, b(s)), r.setFill(d ? b(s).alpha(0.18) : T.NONE), t.rough && r.toExcalidraw({ preset: "clean", stroke: s, strokeWidth: t.strokeWidth, roughness: t.roughness, fill: d ? s : "transparent", fillStyle: t.fillStyle, fillGap: 0.18, fillAlpha: 0.1, seed: 17, boil: !1 }), r;
+  return r.setStroke(t.strokeWidth, v(s)), r.setFill(u ? v(s).alpha(0.18) : $.NONE), t.rough && r.toExcalidraw({ preset: "clean", stroke: s, strokeWidth: t.strokeWidth, roughness: t.roughness, fill: u ? s : "transparent", fillStyle: t.fillStyle, fillGap: 0.18, fillAlpha: 0.1, seed: 17, boil: !1 }), r;
 }
-function Q(r, t, i = 0, d = t.motion.drawMs) {
-  return t.rough ? $.createAnim(r, { delay: i, duration: d }) : new z(r, { delay: i, duration: d });
+function Q(r, t, i = 0, u = t.motion.drawMs) {
+  return t.rough ? z.createAnim(r, { delay: i, duration: u }) : new N(r, { delay: i, duration: u });
 }
-function X(r, t, i, d, s, a = {}) {
-  const l = new N(t, { fontSize: 0.42, anchor: D, fill: b(s.primary), opacity: 0 });
-  r.add(l);
-  let h, m;
-  return new v((c) => {
-    l.transform.position.set([h[0] + (m[0] - h[0]) * c, h[1] + (m[1] - h[1]) * c + (a.arc ?? 0.45) * Math.sin(Math.PI * c), h[2] + (m[2] - h[2]) * c]), l.setOpacity(Math.min(1, c * 8, (1 - c) * 8));
+function X(r, t, i, u, s, a = {}) {
+  const h = new D(t, { fontSize: 0.42, anchor: L, fill: v(s.primary), opacity: 0 });
+  r.add(h);
+  let m, f;
+  return new x((c) => {
+    h.transform.position.set([m[0] + (f[0] - m[0]) * c, m[1] + (f[1] - m[1]) * c + (a.arc ?? 0.45) * Math.sin(Math.PI * c), m[2] + (f[2] - m[2]) * c]), h.setOpacity(Math.min(1, c * 8, (1 - c) * 8));
   }, { delay: a.delay ?? 0, duration: a.duration ?? s.motion.moveMs, rate_func: k.smooth(), onStart: () => {
-    h = i(), m = d();
-  }, onComplete: () => r.remove(l) });
+    m = i(), f = u();
+  }, onComplete: () => r.remove(h) });
 }
-function Z(r, t = 0, i = 900, d = 0.1) {
+function Z(r, t = 0, i = 900, u = 0.1) {
   let s;
-  return new v((a) => {
-    const l = 1 + d * Math.sin(Math.PI * a);
-    r.transform.setScale([s[0] * l, s[1] * l, s[2]]);
+  return new x((a) => {
+    const h = 1 + u * Math.sin(Math.PI * a);
+    r.transform.setScale([s[0] * h, s[1] * h, s[2]]);
   }, { delay: t, duration: i, rate_func: k.smooth(), onStart: () => {
     const a = r.transform.getScale();
     s = [a.x, a.y, a.z];
   } });
 }
-const P = 1, B = "Why does area grow so fast?", H = "How a square's area changes when its side length doubles", I = "Curious beginners", F = "See why doubling both side lengths produces four unit squares.", K = "mathematical", O = { enabled: !1, provider: "msedge", voice: "en-US-AndrewNeural", speed: 1, pitch: "+0Hz", volume: 1 }, V = [], W = [{ id: "area-model", text: "A square of side two can be partitioned into four squares of side one.", sourceIds: [], illustrative: !0 }], j = [{ id: "predict", goal: "Invite a prediction before exposing the area.", visibleChange: "Draw one unit square and mark its side length.", focus: "The original square", minDurationMs: 4500, narration: [{ id: "question", text: "Here is one unit square. If we double its side length, what happens to its area?", pauseAfterMs: 900 }], cues: [{ id: "show", segment: "question" }] }, { id: "grow", goal: "Separate a change in side length from a change in area.", visibleChange: "Expand the outline while retaining the original square.", focus: "Both sides grow", minDurationMs: 5e3, narration: [{ id: "expand", text: "Let's double both sides. The original square still fits in the corner. How much new space have we made?", pauseAfterMs: 700 }], cues: [{ id: "expand", segment: "expand" }] }, { id: "count", goal: "Discover the four equal areas through decomposition.", visibleChange: "Reveal the three additional unit squares in sequence.", focus: "Four equal pieces", minDurationMs: 5e3, narration: [{ id: "reveal", text: "One here, another above, and one more in the corner. Together with our original square, that makes four." }], cues: [{ id: "reveal", segment: "reveal" }] }, { id: "connect", goal: "Connect the construction to the general area relationship.", visibleChange: "Keep all four pieces visible and reveal the equation below them.", focus: "Side length and area", minDurationMs: 4500, narration: [{ id: "insight", text: "Two times the side length gives four times the area. That's the square in side squared: two growing directions, multiplied together." }], cues: [{ id: "equation", segment: "insight" }] }], G = {
-  version: P,
-  title: B,
-  topic: H,
-  audience: I,
-  objective: F,
+const I = 1, P = "Why does area grow so fast?", B = "How a square's area changes when its side length doubles", F = "Curious beginners", H = "See why doubling both side lengths produces four unit squares.", K = "mathematical", O = { enabled: !1, provider: "msedge", voice: "en-US-AndrewNeural", speed: 1, pitch: "+0Hz", volume: 1 }, V = [], W = [{ id: "area-model", text: "A square of side two can be partitioned into four squares of side one.", sourceIds: [], illustrative: !0 }], j = [{ id: "predict", goal: "Invite a prediction before exposing the area.", visibleChange: "Draw one unit square and mark its side length.", focus: "The original square", minDurationMs: 4500, narration: [{ id: "question", text: "Here is one unit square. If we double its side length, what happens to its area?", pauseAfterMs: 900 }], cues: [{ id: "show", segment: "question" }] }, { id: "grow", goal: "Separate a change in side length from a change in area.", visibleChange: "Expand the outline while retaining the original square.", focus: "Both sides grow", minDurationMs: 5e3, narration: [{ id: "expand", text: "Let's double both sides. The original square still fits in the corner. How much new space have we made?", pauseAfterMs: 700 }], cues: [{ id: "expand", segment: "expand" }] }, { id: "count", goal: "Discover the four equal areas through decomposition.", visibleChange: "Reveal the three additional unit squares in sequence.", focus: "Four equal pieces", minDurationMs: 5e3, narration: [{ id: "reveal", text: "One here, another above, and one more in the corner. Together with our original square, that makes four." }], cues: [{ id: "reveal", segment: "reveal" }] }, { id: "connect", goal: "Connect the construction to the general area relationship.", visibleChange: "Keep all four pieces visible and reveal the equation below them.", focus: "Side length and area", minDurationMs: 4500, narration: [{ id: "insight", text: "Two times the side length gives four times the area. That's the square in side squared: two growing directions, multiplied together." }], cues: [{ id: "equation", segment: "insight" }] }], G = {
+  version: I,
+  title: P,
+  topic: B,
+  audience: F,
+  objective: H,
   style: K,
   narration: O,
   sources: V,
@@ -130,5 +131,5 @@ export {
   J as styleGeometry,
   X as transferValue,
   se as validateLesson,
-  x as voiceKey
+  M as voiceKey
 };

package/dist/libs/explainer/plan.js

@@ -1,197 +1,219 @@
 /*! Retiam: noncommercial use only unless separately licensed. See ../../LICENSE and ../../COMMERCIAL_LICENSE.md. Third-party notices: ../../THIRD_PARTY_NOTICES.md and ../../THIRD_PARTY_LICENSES.txt. */
-const b = { name: "Dijkstra-style mathematical explainer", background: "#0A1020", ink: "#ECF0F5", muted: "#74869C", primary: "#6CD5FF", secondary: "#F7CF73", font: "roboto", strokeWidth: 0.035, rough: !1, roughness: 0, fillStyle: "solid", motion: { drawMs: 1200, moveMs: 1400, holdMs: 700 }, accents: ["#65F0C4", "#FF879F", "#BA98FF", "#55DDE0"] }, k = { name: "Excalidraw whiteboard", background: "#FFFDF7", ink: "#263238", muted: "#7B858C", primary: "#1971C2", secondary: "#D46B08", font: "excalifont", strokeWidth: 0.04, rough: !0, roughness: 0.7, fillStyle: "hachure", motion: { drawMs: 1600, moveMs: 1500, holdMs: 900 }, accents: ["#1971C2", "#D46B08"] }, E = { name: "Minimal vector", background: "#F8FAFC", ink: "#17212B", muted: "#68788A", primary: "#2563EB", secondary: "#C2410C", font: "roboto", strokeWidth: 0.025, rough: !1, roughness: 0, fillStyle: "solid", motion: { drawMs: 900, moveMs: 1100, holdMs: 650 }, accents: ["#2563EB", "#C2410C"] }, F = { name: "Cinematic diagrams", background: "#080B18", ink: "#F4F1FF", muted: "#8290AA", primary: "#B79AFF", secondary: "#58E0CE", font: "roboto", strokeWidth: 0.04, rough: !1, roughness: 0, fillStyle: "solid", motion: { drawMs: 1500, moveMs: 2e3, holdMs: 1e3 }, accents: ["#B79AFF", "#58E0CE"] }, A = {
-  mathematical: b,
-  excalidraw: k,
-  minimal: E,
-  cinematic: F
-}, w = A;
-function x(n) {
-  const i = typeof n == "string" ? n : n?.extends;
-  if (!Object.hasOwn(w, i ?? ""))
-    throw new Error(`Unknown style '${i}'. Choose ${Object.keys(w).join(", ")} or extend one in the lesson JSON.`);
-  const e = w[i], r = typeof n == "string" ? {} : n;
-  for (const s of Object.keys(r))
-    if (s !== "extends" && !Object.hasOwn(e, s))
-      throw new Error(`Unknown style token '${s}'.`);
-  if (r.motion !== void 0 && (!r.motion || typeof r.motion != "object" || Array.isArray(r.motion)))
+const w = { name: "Dijkstra-style mathematical explainer", background: "#0A1020", ink: "#ECF0F5", muted: "#74869C", primary: "#6CD5FF", secondary: "#F7CF73", font: "roboto", strokeWidth: 0.035, rough: !1, roughness: 0, fillStyle: "solid", motion: { drawMs: 1200, moveMs: 1400, holdMs: 700 }, accents: ["#65F0C4", "#FF879F", "#BA98FF", "#55DDE0"] }, x = { name: "Excalidraw whiteboard", background: "#FFFDF7", ink: "#263238", muted: "#7B858C", primary: "#1971C2", secondary: "#D46B08", font: "excalifont", strokeWidth: 0.04, rough: !0, roughness: 0.7, fillStyle: "hachure", motion: { drawMs: 1600, moveMs: 1500, holdMs: 900 }, accents: ["#1971C2", "#D46B08"] }, k = { name: "Minimal vector", background: "#F8FAFC", ink: "#17212B", muted: "#68788A", primary: "#2563EB", secondary: "#C2410C", font: "roboto", strokeWidth: 0.025, rough: !1, roughness: 0, fillStyle: "solid", motion: { drawMs: 900, moveMs: 1100, holdMs: 650 }, accents: ["#2563EB", "#C2410C"] }, E = { name: "Cinematic diagrams", background: "#080B18", ink: "#F4F1FF", muted: "#8290AA", primary: "#B79AFF", secondary: "#58E0CE", font: "roboto", strokeWidth: 0.04, rough: !1, roughness: 0, fillStyle: "solid", motion: { drawMs: 1500, moveMs: 2e3, holdMs: 1e3 }, accents: ["#B79AFF", "#58E0CE"] }, A = {
+  mathematical: w,
+  excalidraw: x,
+  minimal: k,
+  cinematic: E
+}, b = A;
+function F(i) {
+  const u = typeof i == "string" ? i : i?.extends;
+  if (!Object.hasOwn(b, u ?? ""))
+    throw new Error(`Unknown style '${u}'. Choose ${Object.keys(b).join(", ")} or extend one in the lesson JSON.`);
+  const e = b[u], s = typeof i == "string" ? {} : i;
+  for (const c of Object.keys(s))
+    if (c !== "extends" && !Object.hasOwn(e, c))
+      throw new Error(`Unknown style token '${c}'.`);
+  if (s.motion !== void 0 && (!s.motion || typeof s.motion != "object" || Array.isArray(s.motion)))
     throw new Error("Style motion must be an object.");
-  for (const s of Object.keys(r.motion ?? {}))
-    if (!Object.hasOwn(e.motion, s))
-      throw new Error(`Unknown style motion token '${s}'.`);
-  const a = { ...e, ...r, motion: { ...e.motion, ...r.motion } };
-  for (const s of ["background", "ink", "muted", "primary", "secondary"])
-    if (!/^#[\da-f]{6}$/i.test(a[s]))
-      throw new Error(`Style ${s} must be a six-digit hex color.`);
-  if (!a.font?.trim() || !a.name?.trim() || typeof a.rough != "boolean" || !["solid", "hachure"].includes(a.fillStyle))
+  for (const c of Object.keys(s.motion ?? {}))
+    if (!Object.hasOwn(e.motion, c))
+      throw new Error(`Unknown style motion token '${c}'.`);
+  const r = { ...e, ...s, motion: { ...e.motion, ...s.motion } };
+  for (const c of ["background", "ink", "muted", "primary", "secondary"])
+    if (!/^#[\da-f]{6}$/i.test(r[c]))
+      throw new Error(`Style ${c} must be a six-digit hex color.`);
+  if (!r.font?.trim() || !r.name?.trim() || typeof r.rough != "boolean" || !["solid", "hachure"].includes(r.fillStyle))
     throw new Error("Invalid style font, name, rough flag, or fillStyle.");
-  if (!(a.strokeWidth > 0 && a.strokeWidth <= 0.5) || !(a.roughness >= 0 && a.roughness <= 3))
+  if (!(r.strokeWidth > 0 && r.strokeWidth <= 0.5) || !(r.roughness >= 0 && r.roughness <= 3))
     throw new Error("Invalid style strokeWidth or roughness.");
-  for (const [s, f] of Object.entries(a.motion))
-    if (!Number.isFinite(f) || f < 0)
-      throw new Error(`Invalid style motion.${s}.`);
-  if (!Array.isArray(a.accents) || !a.accents.length || a.accents.some((s) => !/^#[\da-f]{6}$/i.test(s)))
+  for (const [c, l] of Object.entries(r.motion))
+    if (!Number.isFinite(l) || l < 0)
+      throw new Error(`Invalid style motion.${c}.`);
+  if (!Array.isArray(r.accents) || !r.accents.length || r.accents.some((c) => !/^#[\da-f]{6}$/i.test(c)))
     throw new Error("Style accents must contain hex colors.");
-  return { ...a, accents: [...a.accents] };
+  return { ...r, accents: [...r.accents] };
 }
-const M = /^[a-z][a-z0-9-]*$/, y = (n) => typeof n == "string" && n.trim().length > 0, v = (n) => n.toLowerCase().replace(/[^\p{L}\p{N}]/gu, ""), S = (n, i) => `${n}/${i}`, I = (n) => JSON.stringify({ provider: n.narration.provider ?? "msedge", voice: n.narration.voice ?? "en-US-AndrewNeural", speed: n.narration.speed ?? 1, pitch: n.narration.pitch ?? "+0Hz" });
-function C(n) {
-  const i = [], e = (t, d) => i.push({ path: t, message: d });
-  if (!n || typeof n != "object" || Array.isArray(n))
+const y = /^[a-z][a-z0-9-]*$/, h = (i) => typeof i == "string" && i.trim().length > 0, g = (i) => i.toLowerCase().replace(/[^\p{L}\p{N}]/gu, ""), S = (i, u) => `${i}/${u}`, I = (i) => JSON.stringify({ provider: i.narration.provider ?? "msedge", voice: i.narration.voice ?? ((i.narration.provider ?? "msedge") === "msedge" ? "en-US-AndrewNeural" : null), speed: i.narration.speed ?? 1, pitch: i.narration.pitch ?? ((i.narration.provider ?? "msedge") === "msedge" ? "+0Hz" : null), elevenlabs: i.narration.elevenlabs });
+function D(i) {
+  const u = [], e = (t, o) => u.push({ path: t, message: o });
+  if (!i || typeof i != "object" || Array.isArray(i))
     return [{ path: "$", message: "Expected a lesson object." }];
-  const r = n;
-  r.version !== 1 && e("version", "Expected version 1.");
+  const s = i;
+  s.version !== 1 && e("version", "Expected version 1.");
   for (const t of ["title", "topic", "audience", "objective"])
-    y(r[t]) || e(t, "Provide a nonempty string.");
+    h(s[t]) || e(t, "Provide a nonempty string.");
   try {
-    x(r.style);
+    F(s.style);
   } catch (t) {
     e("style", t.message);
   }
-  (!r.narration || typeof r.narration.enabled != "boolean") && e("narration.enabled", "Choose true or false."), r.narration?.speed !== void 0 && (!Number.isFinite(r.narration.speed) || r.narration.speed <= 0) && e("narration.speed", "Must be positive."), r.narration?.volume !== void 0 && (!Number.isFinite(r.narration.volume) || r.narration.volume < 0 || r.narration.volume > 1) && e("narration.volume", "Must be between 0 and 1."), r.narration?.voice !== void 0 && !y(r.narration.voice) && e("narration.voice", "Must be a voice ID.");
+  (!s.narration || typeof s.narration.enabled != "boolean") && e("narration.enabled", "Choose true or false."), s.narration?.speed !== void 0 && (!Number.isFinite(s.narration.speed) || s.narration.speed <= 0) && e("narration.speed", "Must be positive."), s.narration?.volume !== void 0 && (!Number.isFinite(s.narration.volume) || s.narration.volume < 0 || s.narration.volume > 1) && e("narration.volume", "Must be between 0 and 1."), s.narration?.voice !== void 0 && !h(s.narration.voice) && e("narration.voice", "Must be a voice ID.");
   for (const t of ["provider", "pitch"])
-    r.narration?.[t] !== void 0 && !y(r.narration[t]) && e(`narration.${t}`, "Must be a nonempty string.");
-  const a = /* @__PURE__ */ new Set();
-  Array.isArray(r.sources) ? r.sources.forEach((t, d) => {
-    !t || !M.test(t.id) || a.has(t.id) || !y(t.title) ? e(`sources[${d}]`, "Provide a unique source ID and title.") : a.add(t.id);
+    s.narration?.[t] !== void 0 && !h(s.narration[t]) && e(`narration.${t}`, "Must be a nonempty string.");
+  s.narration?.provider === "elevenlabs" && !h(s.narration.voice) && e("narration.voice", "Choose an ElevenLabs voice ID so prepared speech identifies its speaker.");
+  const r = s.narration?.elevenlabs;
+  if (r !== void 0) {
+    const t = "narration.elevenlabs";
+    if (!r || typeof r != "object" || Array.isArray(r)) e(t, "Expected ElevenLabs synthesis settings.");
+    else {
+      const o = ["modelId", "voiceSettings", "languageCode", "seed", "previousText", "nextText", "applyTextNormalization", "pronunciationDictionaries"];
+      for (const n of Object.keys(r))
+        o.includes(n) || e(`${t}.${n}`, "Unknown synthesis setting. Pass credentials to provider.init(), not the lesson.");
+      for (const n of ["modelId", "languageCode"])
+        r[n] !== void 0 && !h(r[n]) && e(`${t}.${n}`, "Must be a nonempty string.");
+      for (const n of ["previousText", "nextText"])
+        r[n] !== void 0 && typeof r[n] != "string" && e(`${t}.${n}`, "Must be a string.");
+      r.seed !== void 0 && (!Number.isInteger(r.seed) || r.seed < 0 || r.seed > 4294967295) && e(`${t}.seed`, "Must be an integer from 0 to 4294967295."), r.applyTextNormalization !== void 0 && !["auto", "on", "off"].includes(r.applyTextNormalization) && e(`${t}.applyTextNormalization`, "Choose auto, on, or off.");
+      const a = r.voiceSettings;
+      if (a !== void 0)
+        if (!a || typeof a != "object" || Array.isArray(a)) e(`${t}.voiceSettings`, "Expected a settings object.");
+        else for (const [n, m] of Object.entries(a))
+          n === "useSpeakerBoost" ? typeof m != "boolean" && e(`${t}.voiceSettings.${n}`, "Must be a boolean.") : ["stability", "similarityBoost", "style", "speed"].includes(n) ? (!Number.isFinite(m) || m < (n === "speed" ? 0.7 : 0) || m > (n === "speed" ? 1.2 : 1)) && e(`${t}.voiceSettings.${n}`, n === "speed" ? "Must be between 0.7 and 1.2." : "Must be between 0 and 1.") : e(`${t}.voiceSettings.${n}`, "Unknown voice setting.");
+      r.pronunciationDictionaries !== void 0 && (!Array.isArray(r.pronunciationDictionaries) || r.pronunciationDictionaries.length > 3 || r.pronunciationDictionaries.some((n) => !n || !h(n.id) || n.versionId !== void 0 && !h(n.versionId))) && e(`${t}.pronunciationDictionaries`, "Provide at most three dictionary IDs with optional version IDs.");
+    }
+  }
+  const c = /* @__PURE__ */ new Set();
+  Array.isArray(s.sources) ? s.sources.forEach((t, o) => {
+    !t || !y.test(t.id) || c.has(t.id) || !h(t.title) ? e(`sources[${o}]`, "Provide a unique source ID and title.") : c.add(t.id);
   }) : e("sources", "Provide a sources array; it may be empty for an illustrative construction.");
-  const s = (t, d) => {
+  const l = (t, o) => {
     if (!Array.isArray(t))
-      e(d, "Expected source IDs.");
+      e(o, "Expected source IDs.");
     else
-      for (const o of t)
-        a.has(o) || e(d, `Unknown source '${o}'.`);
-  }, f = /* @__PURE__ */ new Set();
-  if (r.claims !== void 0 && !Array.isArray(r.claims))
+      for (const a of t)
+        c.has(a) || e(o, `Unknown source '${a}'.`);
+  }, p = /* @__PURE__ */ new Set();
+  if (s.claims !== void 0 && !Array.isArray(s.claims))
     e("claims", "Expected an array.");
   else
-    for (const [t, d] of (r.claims ?? []).entries()) {
-      if (!d || !M.test(d.id) || f.has(d.id) || !y(d.text)) {
+    for (const [t, o] of (s.claims ?? []).entries()) {
+      if (!o || !y.test(o.id) || p.has(o.id) || !h(o.text)) {
         e(`claims[${t}]`, "Provide a unique claim ID and text.");
         continue;
       }
-      f.add(d.id), s(d.sourceIds, `claims[${t}].sourceIds`), d.illustrative !== void 0 && typeof d.illustrative != "boolean" && e(`claims[${t}].illustrative`, "Must be a boolean."), !d.illustrative && !d.sourceIds?.length && e(`claims[${t}].sourceIds`, "Factual claims need a source; mark illustrative models explicitly.");
+      p.add(o.id), l(o.sourceIds, `claims[${t}].sourceIds`), o.illustrative !== void 0 && typeof o.illustrative != "boolean" && e(`claims[${t}].illustrative`, "Must be a boolean."), !o.illustrative && !o.sourceIds?.length && e(`claims[${t}].sourceIds`, "Factual claims need a source; mark illustrative models explicitly.");
     }
-  const h = /* @__PURE__ */ new Set();
-  return !Array.isArray(r.beats) || !r.beats.length ? (e("beats", "Provide at least one beat."), i) : (r.beats.forEach((t, d) => {
-    const o = `beats[${d}]`;
-    if (!t || !M.test(t.id) || h.has(t.id)) {
-      e(o, "Beat IDs must be unique lowercase identifiers.");
+  const v = /* @__PURE__ */ new Set();
+  return !Array.isArray(s.beats) || !s.beats.length ? (e("beats", "Provide at least one beat."), u) : (s.beats.forEach((t, o) => {
+    const a = `beats[${o}]`;
+    if (!t || !y.test(t.id) || v.has(t.id)) {
+      e(a, "Beat IDs must be unique lowercase identifiers.");
       return;
     }
-    h.add(t.id);
-    for (const c of ["goal", "visibleChange", "focus"])
-      y(t[c]) || e(`${o}.${c}`, "Describe the learning goal, visible event, and attention target.");
-    t.minDurationMs !== void 0 && (!Number.isFinite(t.minDurationMs) || t.minDurationMs < 0) && e(`${o}.minDurationMs`, "Must be nonnegative."), t.sourceIds !== void 0 && s(t.sourceIds, `${o}.sourceIds`);
-    const l = /* @__PURE__ */ new Map();
-    !Array.isArray(t.narration) || !t.narration.length ? e(`${o}.narration`, "Provide at least one spoken segment, also used for silent preview timing.") : t.narration.forEach((c, u) => {
-      if (!c || !M.test(c.id) || l.has(c.id) || !y(c.text)) {
-        e(`${o}.narration[${u}]`, "Provide a unique segment ID and nonempty spoken text.");
+    v.add(t.id);
+    for (const f of ["goal", "visibleChange", "focus"])
+      h(t[f]) || e(`${a}.${f}`, "Describe the learning goal, visible event, and attention target.");
+    t.minDurationMs !== void 0 && (!Number.isFinite(t.minDurationMs) || t.minDurationMs < 0) && e(`${a}.minDurationMs`, "Must be nonnegative."), t.sourceIds !== void 0 && l(t.sourceIds, `${a}.sourceIds`);
+    const n = /* @__PURE__ */ new Map();
+    !Array.isArray(t.narration) || !t.narration.length ? e(`${a}.narration`, "Provide at least one spoken segment, also used for silent preview timing.") : t.narration.forEach((f, d) => {
+      if (!f || !y.test(f.id) || n.has(f.id) || !h(f.text)) {
+        e(`${a}.narration[${d}]`, "Provide a unique segment ID and nonempty spoken text.");
         return;
       }
-      l.set(c.id, c.text), c.pauseAfterMs !== void 0 && (!Number.isFinite(c.pauseAfterMs) || c.pauseAfterMs < 0) && e(`${o}.narration[${u}].pauseAfterMs`, "Must be nonnegative.");
+      n.set(f.id, f.text), f.speechText !== void 0 && !h(f.speechText) && e(`${a}.narration[${d}].speechText`, "Must be nonempty synthesis text."), f.pauseAfterMs !== void 0 && (!Number.isFinite(f.pauseAfterMs) || f.pauseAfterMs < 0) && e(`${a}.narration[${d}].pauseAfterMs`, "Must be nonnegative.");
     });
     const m = /* @__PURE__ */ new Set();
     if (t.cues !== void 0 && !Array.isArray(t.cues))
-      e(`${o}.cues`, "Expected an array.");
+      e(`${a}.cues`, "Expected an array.");
     else
-      for (const [c, u] of (t.cues ?? []).entries()) {
-        if (!u || !M.test(u.id) || m.has(u.id)) {
-          e(`${o}.cues[${c}]`, "Provide a unique cue ID.");
+      for (const [f, d] of (t.cues ?? []).entries()) {
+        if (!d || !y.test(d.id) || m.has(d.id)) {
+          e(`${a}.cues[${f}]`, "Provide a unique cue ID.");
           continue;
         }
-        m.add(u.id), l.has(u.segment) || e(`${o}.cues[${c}].segment`, "Cue references an unknown narration segment."), u.phrase !== void 0 && (!y(u.phrase) || !v(l.get(u.segment) ?? "").includes(v(u.phrase))) && e(`${o}.cues[${c}].phrase`, "Phrase must occur in the specified spoken segment."), u.occurrence !== void 0 && (!Number.isSafeInteger(u.occurrence) || u.occurrence < 1) && e(`${o}.cues[${c}].occurrence`, "Must be a positive occurrence number."), u.offsetMs !== void 0 && (!Number.isFinite(u.offsetMs) || u.offsetMs < 0) && e(`${o}.cues[${c}].offsetMs`, "Must be nonnegative.");
+        m.add(d.id), n.has(d.segment) || e(`${a}.cues[${f}].segment`, "Cue references an unknown narration segment."), d.phrase !== void 0 && (!h(d.phrase) || !g(n.get(d.segment) ?? "").includes(g(d.phrase))) && e(`${a}.cues[${f}].phrase`, "Phrase must occur in the specified spoken segment."), d.occurrence !== void 0 && (!Number.isSafeInteger(d.occurrence) || d.occurrence < 1) && e(`${a}.cues[${f}].occurrence`, "Must be a positive occurrence number."), d.offsetMs !== void 0 && (!Number.isFinite(d.offsetMs) || d.offsetMs < 0) && e(`${a}.cues[${f}].offsetMs`, "Must be nonnegative.");
       }
-  }), i);
+  }), u);
 }
-function D(n) {
-  const i = C(n);
-  if (i.length)
-    throw new Error(i.map((e) => `${e.path}: ${e.message}`).join(`
+function C(i) {
+  const u = D(i);
+  if (u.length)
+    throw new Error(u.map((e) => `${e.path}: ${e.message}`).join(`
 `));
 }
-function j(n, i) {
-  const e = i.trim().split(/\s+/).map(v), r = [];
-  return n.forEach((a, s) => {
-    e.every((f, h) => v(n[s + h]?.text ?? "") === f) && r.push(s);
-  }), r;
+function N(i, u) {
+  const e = u.trim().split(/\s+/).map(g), s = [];
+  return i.forEach((r, c) => {
+    e.every((l, p) => g(i[c + p]?.text ?? "") === l) && s.push(c);
+  }), s;
 }
-function N(n, i, e = 60) {
-  if (D(n), !Number.isSafeInteger(e) || e < 1 || e > 240)
+function j(i, u, e = 60) {
+  if (C(i), !Number.isSafeInteger(e) || e < 1 || e > 240)
     throw new Error("fps must be an integer from 1 to 240.");
-  if (n.narration.enabled && (!i || i.version !== 1 || !i.assets || typeof i.assets != "object" || i.voiceKey !== I(n)))
+  if (i.narration.enabled && (!u || u.version !== 1 || !u.assets || typeof u.assets != "object" || u.voiceKey !== I(i)))
     throw new Error("Narration is not prepared for these voice settings. Run retiam lesson prepare.");
-  let r = 0;
-  const a = [];
-  for (const s of n.beats) {
-    let f = 0;
-    const h = [];
-    for (const o of s.narration) {
-      const l = n.narration.enabled ? i.assets[S(s.id, o.id)] : void 0;
-      if (n.narration.enabled && (!l || l.text !== o.text))
-        throw new Error(`Missing or stale audio: ${s.id}/${o.id}. Prepare narration again.`);
-      const m = l?.durationMs ?? Math.max(900, o.text.trim().split(/\s+/).length * 360);
-      if (!Number.isFinite(m) || m <= 0)
-        throw new Error(`Invalid speech duration: ${s.id}/${o.id}.`);
-      if (l && (!Array.isArray(l.words) || !l.words.length))
-        throw new Error(`Missing word timings: ${s.id}/${o.id}.`);
-      const c = l?.words ?? o.text.trim().split(/\s+/).map((g, $, p) => ({ text: g, offsetMs: m * $ / p.length, durationMs: m / p.length }));
-      let u = -1;
-      for (const g of c) {
-        if (!y(g.text) || !Number.isFinite(g.offsetMs) || !Number.isFinite(g.durationMs) || g.offsetMs < u - 0.1 || g.durationMs < 0 || g.offsetMs + g.durationMs > m + 1)
-          throw new Error(`Invalid word timings: ${s.id}/${o.id}.`);
-        u = g.offsetMs + g.durationMs;
+  let s = 0;
+  const r = [];
+  for (const c of i.beats) {
+    let l = 0;
+    const p = [];
+    for (const o of c.narration) {
+      const a = i.narration.enabled ? u.assets[S(c.id, o.id)] : void 0;
+      if (i.narration.enabled && (!a || a.text !== o.text || (a.speechText ?? a.text) !== (o.speechText ?? o.text)))
+        throw new Error(`Missing or stale audio: ${c.id}/${o.id}. Prepare narration again.`);
+      const n = a?.durationMs ?? Math.max(900, o.text.trim().split(/\s+/).length * 360);
+      if (!Number.isFinite(n) || n <= 0)
+        throw new Error(`Invalid speech duration: ${c.id}/${o.id}.`);
+      if (a && (!Array.isArray(a.words) || !a.words.length))
+        throw new Error(`Missing word timings: ${c.id}/${o.id}.`);
+      const m = a?.words ?? o.text.trim().split(/\s+/).map((d, $, M) => ({ text: d, offsetMs: n * $ / M.length, durationMs: n / M.length }));
+      let f = -1;
+      for (const d of m) {
+        if (!h(d.text) || !Number.isFinite(d.offsetMs) || !Number.isFinite(d.durationMs) || d.offsetMs < f - 0.1 || d.durationMs < 0 || d.offsetMs + d.durationMs > n + 1)
+          throw new Error(`Invalid word timings: ${c.id}/${o.id}.`);
+        f = d.offsetMs + d.durationMs;
       }
-      h.push({ ...l, text: o.text, id: o.id, durationMs: m, words: c, startMs: f, pauseAfterMs: o.pauseAfterMs ?? 0 }), f += m + (o.pauseAfterMs ?? 0);
+      p.push({ ...a, text: o.text, id: o.id, durationMs: n, words: m, startMs: l, pauseAfterMs: o.pauseAfterMs ?? 0 }), l += n + (o.pauseAfterMs ?? 0);
     }
-    const t = Math.ceil(Math.max(s.minDurationMs ?? 0, f + 450) * e / 1e3 - 1e-8) * 1e3 / e, d = {};
-    for (const o of s.cues ?? []) {
-      const l = h.find((c) => c.id === o.segment);
-      let m = l.startMs;
+    const v = Math.ceil(Math.max(c.minDurationMs ?? 0, l + 450) * e / 1e3 - 1e-8) * 1e3 / e, t = {};
+    for (const o of c.cues ?? []) {
+      const a = p.find((m) => m.id === o.segment);
+      let n = a.startMs;
       if (o.phrase) {
-        const c = j(l.words, o.phrase);
-        if (c.length > 1 && o.occurrence === void 0)
-          throw new Error(`Ambiguous cue '${s.id}/${o.id}'; set occurrence.`);
-        const u = c[(o.occurrence ?? 1) - 1];
-        if (u === void 0)
-          throw new Error(`Unaligned cue '${s.id}/${o.id}': ${o.phrase}.`);
-        m += l.words[u].offsetMs;
+        const m = N(a.words, o.phrase);
+        if (m.length > 1 && o.occurrence === void 0)
+          throw new Error(`Ambiguous cue '${c.id}/${o.id}'; set occurrence.`);
+        const f = m[(o.occurrence ?? 1) - 1];
+        if (f === void 0)
+          throw new Error(`Unaligned cue '${c.id}/${o.id}': ${o.phrase}.`);
+        n += a.words[f].offsetMs;
       }
-      if (m += o.offsetMs ?? 0, m > l.startMs + l.durationMs)
-        throw new Error(`Cue '${s.id}/${o.id}' falls outside its speech segment.`);
-      d[o.id] = m;
+      if (n += o.offsetMs ?? 0, n > a.startMs + a.durationMs)
+        throw new Error(`Cue '${c.id}/${o.id}' falls outside its speech segment.`);
+      t[o.id] = n;
     }
-    a.push({ id: s.id, startMs: r, durationMs: t, segments: h, cues: d }), r += t;
+    r.push({ id: c.id, startMs: s, durationMs: v, segments: p, cues: t }), s += v;
   }
-  return { version: 1, timing: n.narration.enabled ? "recorded" : "estimated", fps: e, durationMs: r, beats: a };
+  return { version: 1, timing: i.narration.enabled ? "recorded" : "estimated", fps: e, durationMs: s, beats: r };
 }
-function O(n, i = 8) {
-  if (!Number.isInteger(i) || i < 1)
+function O(i, u = 8) {
+  if (!Number.isInteger(u) || u < 1)
     throw new Error("wordsPerCue must be positive.");
-  const e = (s) => {
-    const f = Math.round(s);
-    return `${String(Math.floor(f / 36e5)).padStart(2, "0")}:${String(Math.floor(f / 6e4) % 60).padStart(2, "0")}:${String(Math.floor(f / 1e3) % 60).padStart(2, "0")},${String(f % 1e3).padStart(3, "0")}`;
+  const e = (c) => {
+    const l = Math.round(c);
+    return `${String(Math.floor(l / 36e5)).padStart(2, "0")}:${String(Math.floor(l / 6e4) % 60).padStart(2, "0")}:${String(Math.floor(l / 1e3) % 60).padStart(2, "0")},${String(l % 1e3).padStart(3, "0")}`;
   };
-  let r = 0;
-  const a = [];
-  for (const s of n.beats)
-    for (const f of s.segments)
-      for (let h = 0; h < f.words.length; h += i) {
-        const t = f.words.slice(h, h + i), d = t.at(-1);
-        a.push(`${++r}
-${e(s.startMs + f.startMs + t[0].offsetMs)} --> ${e(s.startMs + f.startMs + d.offsetMs + d.durationMs)}
-${t.map((o) => o.text).join(" ")}
+  let s = 0;
+  const r = [];
+  for (const c of i.beats)
+    for (const l of c.segments)
+      for (let p = 0; p < l.words.length; p += u) {
+        const v = l.words.slice(p, p + u), t = v.at(-1);
+        r.push(`${++s}
+${e(c.startMs + l.startMs + v[0].offsetMs)} --> ${e(c.startMs + l.startMs + t.offsetMs + t.durationMs)}
+${v.map((o) => o.text).join(" ")}
 `);
       }
-  return a.join(`
+  return r.join(`
 `);
 }
 export {
-  w as STYLE_PROFILES,
-  D as assertLesson,
-  N as compileLesson,
+  b as STYLE_PROFILES,
+  C as assertLesson,
+  j as compileLesson,
   O as lessonCaptions,
-  x as resolveStyle,
+  F as resolveStyle,
   S as speechKey,
-  C as validateLesson,
+  D as validateLesson,
   I as voiceKey
 };