learnx-cli 0.3.0__py3-none-any.whl

tutor/assets/html/slide_base.css

@@ -0,0 +1,464 @@
+/* ============================================================
+   LearnX Slide Base — v12
+   Typography: Inter (UI) + JetBrains Mono (code)
+   Design: per-type accent system adapted from presentation-ai
+   ============================================================ */
+
+/* ── Web Fonts ──────────────────────────────────────────── */
+
+@font-face {
+  font-family: "Inter";
+  src: url("fonts/Inter-Regular.woff2") format("woff2");
+  font-weight: 400;
+  font-style: normal;
+  font-display: block;
+}
+@font-face {
+  font-family: "Inter";
+  src: url("fonts/Inter-SemiBold.woff2") format("woff2");
+  font-weight: 600;
+  font-style: normal;
+  font-display: block;
+}
+@font-face {
+  font-family: "Inter";
+  src: url("fonts/Inter-Bold.woff2") format("woff2");
+  font-weight: 700;
+  font-style: normal;
+  font-display: block;
+}
+@font-face {
+  font-family: "JetBrains Mono";
+  src: url("fonts/JetBrainsMono-Regular.woff2") format("woff2");
+  font-weight: 400;
+  font-style: normal;
+  font-display: block;
+}
+
+/* ── Design Tokens ──────────────────────────────────────── */
+
+:root {
+  /* Surfaces */
+  --bg-deep:      #0d1117;
+  --bg-card:      #161b22;
+  --bg-elevated:  #1c2128;
+  --bg-overlay:   rgba(255,255,255,.04);
+
+  /* Borders */
+  --border-soft:   #21262d;
+  --border-mid:    #30363d;
+  --border-strong: #484f58;
+
+  /* Text */
+  --text-pri:  #e6edf3;
+  --text-sec:  #8b949e;
+  --text-dim:  #656d76;
+
+  /* Full accent palette */
+  --cyan:   #22d3ee;
+  --blue:   #60a5fa;
+  --purple: #c084fc;
+  --teal:   #2dd4bf;
+  --green:  #4ade80;
+  --amber:  #fbbf24;
+  --orange: #fb923c;
+  --pink:   #f472b6;
+  --rose:   #fb7185;
+  --sky:    #38bdf8;
+  --indigo: #818cf8;
+
+  /*
+   * Per-slide-type accent — templates override this via:
+   *   {% block extra_style %}:root { --type-accent: var(--blue); }{% endblock %}
+   * Default (cyan) applies when no template overrides it.
+   */
+  --type-accent: var(--cyan);
+
+  /* Typography */
+  --font-ui:   "Inter", system-ui, "Helvetica Neue", Arial, sans-serif;
+  --font-mono: "JetBrains Mono", "Cascadia Code", "Consolas", "Courier New", monospace;
+
+  /* Legacy aliases — keep existing templates working until Day 2 */
+  --accent-cyn: var(--cyan);
+  --accent-amb: var(--amber);
+  --accent-grn: var(--green);
+  --divider:    var(--border-mid);
+}
+
+/* ── Reset + Base ───────────────────────────────────────── */
+
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+html, body {
+  width: 1920px;
+  height: 1080px;
+  overflow: hidden;
+  background: var(--bg-deep);
+  color: var(--text-pri);
+  font-family: var(--font-ui);
+  /*
+   * Subtle per-type accent glow — top-right corner.
+   * Inspired by presentation-ai professional themes.
+   * color-mix() requires Chromium 111+ (compatible with current Playwright).
+   */
+  background-image: radial-gradient(
+    ellipse 900px 600px at 96% 4%,
+    color-mix(in srgb, var(--type-accent) 7%, transparent) 0%,
+    transparent 70%
+  );
+}
+
+/* ── Chrome Layout ──────────────────────────────────────── */
+
+.top-bar {
+  height: 60px;
+  background: var(--bg-card);
+  border-bottom: 1px solid var(--border-soft);
+  display: flex;
+  align-items: center;
+  padding: 0 48px;
+  font-size: 20px;
+  font-weight: 600;
+  color: var(--text-sec);
+  gap: 16px;
+}
+
+.footer-bar {
+  position: absolute;
+  bottom: 0;
+  height: 56px;
+  width: 100%;
+  background: var(--bg-card);
+  border-top: 1px solid var(--border-soft);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 8px;
+}
+
+.content {
+  position: absolute;
+  top: 60px;
+  bottom: 56px;
+  left: 80px;
+  right: 80px;
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+}
+
+/* ── Progress Dots ──────────────────────────────────────── */
+
+.dot {
+  width: 10px;
+  height: 10px;
+  border-radius: 50%;
+  display: inline-block;
+  margin: 0 4px;
+}
+.dot--filled { background: var(--type-accent); }
+.dot--hollow { background: transparent; border: 1.5px solid var(--border-strong); }
+
+/* ── Shared Helpers ─────────────────────────────────────── */
+
+/* Card with left accent border — primary elevated content container */
+.card {
+  background: var(--bg-card);
+  border: 1px solid var(--border-soft);
+  border-left: 4px solid var(--type-accent);
+  border-radius: 0 12px 12px 0;
+  padding: 40px 48px;
+  box-shadow: 0 4px 24px rgba(0,0,0,.4);
+}
+
+/* Small coloured pill — slide type label */
+.type-badge {
+  display: inline-flex;
+  align-items: center;
+  padding: 6px 20px;
+  border-radius: 24px;
+  font-size: 16px;
+  font-weight: 700;
+  letter-spacing: .06em;
+  text-transform: uppercase;
+  background: var(--type-accent);
+  color: #0d1117;
+}
+
+/* ── hook_question ──────────────────────────────────────── */
+
+.hook-slide { display: flex; flex-direction: column; gap: 40px; }
+.hook-question {
+  font-size: 68px;
+  font-weight: 700;
+  color: var(--text-pri);
+  line-height: 1.2;
+  max-width: 1520px;
+}
+.learn-label {
+  font-size: 18px;
+  font-weight: 700;
+  letter-spacing: .10em;
+  text-transform: uppercase;
+  color: var(--type-accent);
+  margin-bottom: 16px;
+}
+.learn-list {
+  font-size: 34px;
+  color: var(--text-sec);
+  list-style: none;
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.learn-list li::before { content: "\2192\00a0\00a0"; color: var(--type-accent); font-weight: 700; }
+
+/* ── definition ─────────────────────────────────────────── */
+
+.definition-slide { display: flex; flex-direction: column; gap: 32px; }
+.definition-term {
+  font-size: 60px;
+  font-weight: 700;
+  color: var(--type-accent);
+}
+.definition-text {
+  font-size: 36px;
+  color: var(--text-pri);
+  line-height: 1.55;
+  max-width: 1440px;
+}
+
+/* ── analogy ────────────────────────────────────────────── */
+
+.analogy-slide {
+  display: grid;
+  grid-template-columns: 1fr 72px 1fr;
+  align-items: stretch;
+  gap: 32px;
+  height: 100%;
+}
+.analogy-panel {
+  background: var(--bg-card);
+  border: 1px solid var(--border-soft);
+  border-top: 3px solid var(--type-accent);
+  border-radius: 12px;
+  padding: 40px 48px;
+  display: flex;
+  flex-direction: column;
+  gap: 20px;
+  box-shadow: 0 4px 20px rgba(0,0,0,.35);
+}
+.analogy-label {
+  font-size: 22px;
+  font-weight: 700;
+  color: var(--type-accent);
+  text-transform: uppercase;
+  letter-spacing: .06em;
+}
+.analogy-body  { font-size: 34px; color: var(--text-pri); line-height: 1.5; }
+.analogy-sep   { font-size: 80px; color: var(--type-accent); text-align: center; align-self: center; opacity: .8; }
+
+/* ── comparison / decision_guide ────────────────────────── */
+
+.comparison-slide { width: 100%; }
+.comparison-table { width: 100%; border-collapse: collapse; font-size: 32px; }
+.comparison-table th {
+  padding: 20px 36px;
+  font-weight: 700;
+  font-size: 36px;
+  border-bottom: 2px solid var(--border-mid);
+}
+.comparison-table td { padding: 16px 36px; border-top: 1px solid var(--border-soft); }
+.comparison-table tr:nth-child(even) td { background: var(--bg-card); }
+.comparison-table tr:nth-child(odd)  td { background: var(--bg-deep); }
+.th-left  { color: var(--type-accent); text-align: left; }
+.th-right { color: var(--orange);      text-align: left; }
+.td-ellipsis { text-align: center; color: var(--text-sec); font-size: 28px; }
+
+/* ── code_example ───────────────────────────────────────── */
+
+.code-slide { display: flex; flex-direction: column; gap: 24px; }
+.code-desc  { font-size: 32px; color: var(--text-sec); }
+.code-slide pre {
+  font-family: var(--font-mono);
+  font-size: 26px;
+  line-height: 1.65;
+  border-radius: 10px;
+  overflow: hidden;
+  border: 1px solid var(--border-soft);
+  box-shadow: 0 2px 16px rgba(0,0,0,.5);
+}
+
+/* ── diagram ────────────────────────────────────────────── */
+
+.diagram-slide {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 100%;
+}
+.diagram-slide .mermaid { font-size: 26px; }
+
+/* ── question_prompt ────────────────────────────────────── */
+
+.question-slide {
+  position: absolute;
+  inset: 0;
+  background: var(--bg-card);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background-image: radial-gradient(
+    ellipse 800px 500px at 50% 50%,
+    color-mix(in srgb, var(--type-accent) 5%, transparent) 0%,
+    transparent 70%
+  );
+}
+.question-text {
+  font-size: 56px;
+  font-weight: 600;
+  color: var(--text-pri);
+  text-align: center;
+  max-width: 1400px;
+  line-height: 1.4;
+}
+.speaker-badge {
+  position: absolute;
+  top: 80px;
+  right: 80px;
+  padding: 10px 32px;
+  border-radius: 32px;
+  font-size: 26px;
+  font-weight: 700;
+  color: #0d1117;
+}
+.badge-maya { background: var(--green); }
+.badge-sam  { background: var(--amber); }
+
+/* ── key_insight ────────────────────────────────────────── */
+
+.key-insight-slide {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  height: 100%;
+  gap: 32px;
+}
+.key-insight-text {
+  font-size: 64px;
+  font-weight: 700;
+  color: var(--text-pri);
+  text-align: center;
+  max-width: 1400px;
+  line-height: 1.35;
+}
+.key-insight-rule { width: 500px; height: 3px; background: var(--type-accent); }
+
+/* ── memory_hook ────────────────────────────────────────── */
+
+.memory-hook-slide {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 100%;
+}
+.memory-hook-text {
+  font-size: 56px;
+  font-weight: 500;
+  color: var(--text-pri);
+  text-align: center;
+  max-width: 1400px;
+  line-height: 1.45;
+}
+
+/* ── title_card ─────────────────────────────────────────── */
+
+.title-card-slide {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  height: 100%;
+  gap: 32px;
+}
+.title-card-title {
+  font-size: 88px;
+  font-weight: 700;
+  color: var(--text-pri);
+  text-align: center;
+  line-height: 1.15;
+}
+.title-card-sub  { font-size: 40px; color: var(--text-sec); text-align: center; }
+.title-card-accent {
+  width: 200px;
+  height: 4px;
+  background: linear-gradient(90deg, var(--cyan), var(--blue));
+  border-radius: 2px;
+}
+
+/* ── outro ──────────────────────────────────────────────── */
+
+.outro-slide {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  height: 100%;
+  gap: 32px;
+}
+.outro-text { font-size: 68px; font-weight: 700; color: var(--text-pri); text-align: center; }
+.outro-sub  { font-size: 36px; color: var(--text-sec); text-align: center; }
+
+/* ── step_sequence (new — v12) ──────────────────────────── */
+
+.step-slide { display: flex; flex-direction: column; gap: 28px; }
+.step-item  { display: flex; align-items: flex-start; gap: 32px; }
+.step-num {
+  flex-shrink: 0;
+  width: 64px;
+  height: 64px;
+  border-radius: 50%;
+  background: var(--type-accent);
+  color: #0d1117;
+  font-size: 30px;
+  font-weight: 700;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+.step-text  { font-size: 34px; color: var(--text-pri); line-height: 1.5; padding-top: 10px; }
+
+/* ── callout (new — v12) ────────────────────────────────── */
+
+.callout-slide {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 100%;
+}
+.callout-box {
+  background: color-mix(in srgb, var(--type-accent) 10%, var(--bg-card));
+  border: 2px solid var(--type-accent);
+  border-radius: 16px;
+  padding: 56px 72px;
+  max-width: 1440px;
+  display: flex;
+  flex-direction: column;
+  gap: 28px;
+  box-shadow: 0 0 60px color-mix(in srgb, var(--type-accent) 15%, transparent);
+}
+.callout-label {
+  font-size: 18px;
+  font-weight: 700;
+  letter-spacing: .10em;
+  text-transform: uppercase;
+  color: var(--type-accent);
+}
+.callout-text {
+  font-size: 48px;
+  font-weight: 600;
+  color: var(--text-pri);
+  line-height: 1.4;
+}

tutor/assets/html/theme-learnx-dark.css

@@ -0,0 +1,12 @@
+/* highlight.js dark theme matching LearnX palette */
+.hljs { background: #161b22; color: #e6edf3; }
+.hljs-comment, .hljs-quote { color: #8b949e; font-style: italic; }
+.hljs-keyword, .hljs-selector-tag, .hljs-built_in { color: #00b4d8; font-weight: 600; }
+.hljs-string, .hljs-attr { color: #3fb950; }
+.hljs-number, .hljs-literal { color: #e3a21a; }
+.hljs-variable, .hljs-template-variable { color: #e6edf3; }
+.hljs-type, .hljs-class .hljs-title { color: #00b4d8; font-weight: 700; }
+.hljs-function .hljs-title, .hljs-title.function_ { color: #e6edf3; }
+.hljs-meta { color: #8b949e; }
+.hljs-emphasis { font-style: italic; }
+.hljs-strong { font-weight: bold; }

tutor/audio/audio_builder.py

@@ -0,0 +1,143 @@
+import asyncio
+import json
+import logging
+import shutil
+from dataclasses import asdict
+from pathlib import Path
+
+from pydub import AudioSegment
+from tqdm import tqdm
+
+from tutor.audio.tts_renderer import render_segment
+from tutor.constants import (
+    SILENCE_BREATH_MS,
+    SILENCE_TURN_MS,
+    SILENCE_UNIT_MS,
+    TTS_SEMAPHORE_LIMIT,
+)
+from tutor.models import DialogueLine, RenderedSegment, TimingEntry
+
+log = logging.getLogger(__name__)
+
+
+async def build(lines: list[DialogueLine], out_path: str, units_dir: str) -> None:
+    """
+    Entry point from tutor.py via asyncio.run(audio_builder.build(...)).
+    This is the single sync→async crossing point for the entire pipeline.
+    """
+    tmp_dir = str(Path(out_path).parent / ".tts_tmp")
+    Path(tmp_dir).mkdir(parents=True, exist_ok=True)
+    Path(units_dir).mkdir(parents=True, exist_ok=True)
+
+    segments = await _render_all(lines, tmp_dir)
+    _assemble(segments, out_path, units_dir)
+    _cleanup_tmp(tmp_dir)
+    log.info("Audio saved: %s", out_path)
+
+
+async def _render_all(lines: list[DialogueLine], tmp_dir: str) -> list[RenderedSegment]:
+    semaphore = asyncio.Semaphore(TTS_SEMAPHORE_LIMIT)
+    results: list[RenderedSegment | None] = [None] * len(lines)
+
+    with tqdm(total=len(lines), desc="Generating audio", unit="seg") as pbar:
+
+        async def render_one(idx: int, line: DialogueLine) -> None:
+            async with semaphore:
+                results[idx] = await render_segment(line, tmp_dir, idx)
+                pbar.update(1)
+
+        await asyncio.gather(*[render_one(i, line) for i, line in enumerate(lines)])
+
+    return [r for r in results if r is not None]
+
+
+def _assemble(segments: list[RenderedSegment], out_path: str, units_dir: str) -> None:
+    unit_groups: dict[int, list[RenderedSegment]] = {}
+    for seg in segments:
+        unit_num = seg.line.unit_number
+        unit_groups.setdefault(unit_num, []).append(seg)
+
+    # Sort: intro (0) first, then units (1..N), outro (-1) last
+    sorted_keys = sorted(unit_groups.keys(), key=lambda x: 999 if x == -1 else x)
+
+    unit_timing: dict[str, list] = {}
+    unit_audio: list[AudioSegment] = []
+
+    for unit_num in sorted_keys:
+        group = unit_groups[unit_num]
+        is_teaching_unit = unit_num >= 1
+        combined, entries = _concat_with_silence(group, capture_timing=is_teaching_unit)
+
+        if is_teaching_unit and entries:
+            unit_timing[str(unit_num)] = [asdict(e) for e in entries]
+
+        if unit_num == 0:
+            unit_label = "unit_00_intro"
+        elif unit_num == -1:
+            unit_label = "unit_99_outro"
+        else:
+            unit_label = f"unit_{unit_num:02d}"
+
+        unit_path = str(Path(units_dir) / f"{unit_label}.mp3")
+        combined.export(unit_path, format="mp3")
+        log.info("Saved unit: %s", unit_path)
+
+        unit_audio.append(combined)
+        if unit_num != -1:
+            unit_audio.append(AudioSegment.silent(duration=SILENCE_UNIT_MS))
+
+    timing_path = Path(out_path).parent / "tutorial.timing.json"
+    timing_path.write_text(
+        json.dumps({"version": 1, "units": unit_timing}, ensure_ascii=False, indent=2),
+        encoding="utf-8",
+    )
+    log.info("Timing file written: %s (%d units)", timing_path, len(unit_timing))
+
+    full_audio = sum(unit_audio, AudioSegment.empty())
+    full_audio.export(out_path, format="mp3")
+    log.info("Saved full audio: %s (%d segments)", out_path, len(segments))
+
+
+def _concat_with_silence(
+    segments: list[RenderedSegment],
+    capture_timing: bool = False,
+) -> tuple[AudioSegment, list[TimingEntry]]:
+    result = AudioSegment.empty()
+    entries: list[TimingEntry] = []
+    cursor_ms = 0
+    prev_speaker: str | None = None
+
+    for idx, seg in enumerate(segments):
+        audio = AudioSegment.from_mp3(seg.audio_path)
+
+        if prev_speaker is None:
+            gap = 0
+        elif prev_speaker == seg.line.speaker:
+            gap = SILENCE_BREATH_MS
+        else:
+            gap = SILENCE_TURN_MS
+
+        if gap:
+            result += AudioSegment.silent(duration=gap)
+            cursor_ms += gap
+
+        if capture_timing:
+            entries.append(
+                TimingEntry(
+                    line_index=idx,
+                    speaker=seg.line.speaker,
+                    text=seg.line.text,
+                    start_ms=cursor_ms,
+                    end_ms=cursor_ms + len(audio),
+                )
+            )
+
+        result += audio
+        cursor_ms += len(audio)
+        prev_speaker = seg.line.speaker
+
+    return result, entries
+
+
+def _cleanup_tmp(tmp_dir: str) -> None:
+    shutil.rmtree(tmp_dir, ignore_errors=True)

tutor/audio/sanitizer.py

@@ -0,0 +1,9 @@
+import re
+
+from tutor.constants import CODE_SUBSTITUTIONS
+
+
+def apply(text: str) -> str:
+    for pattern, replacement in CODE_SUBSTITUTIONS:
+        text = re.sub(pattern, replacement, text)
+    return text

tutor/audio/tts_renderer.py

@@ -0,0 +1,54 @@
+import logging
+import os
+from pathlib import Path
+
+import edge_tts
+from pydub import AudioSegment
+
+from tutor.constants import (
+    RATE_COTUTOR,
+    RATE_STUDENT,
+    RATE_TUTOR,
+    VOICE_COTUTOR,
+    VOICE_STUDENT,
+    VOICE_TUTOR,
+)
+from tutor.exceptions import TTSError
+from tutor.models import DialogueLine, RenderedSegment
+
+log = logging.getLogger(__name__)
+
+VOICE_MAP: dict[str, str] = {
+    "ALEX": VOICE_TUTOR,
+    "MAYA": VOICE_STUDENT,
+    "SAM": VOICE_COTUTOR,
+}
+
+RATE_MAP: dict[str, str] = {
+    "ALEX": RATE_TUTOR,
+    "MAYA": RATE_STUDENT,
+    "SAM": RATE_COTUTOR,
+}
+
+
+async def render_segment(line: DialogueLine, out_dir: str, idx: int) -> RenderedSegment:
+    voice = VOICE_MAP.get(line.speaker, VOICE_TUTOR)
+    rate = RATE_MAP.get(line.speaker, RATE_TUTOR)
+    out_path = str(Path(out_dir) / f"seg_{line.unit_number:03d}_{idx:04d}.mp3")
+
+    try:
+        communicate = edge_tts.Communicate(line.text, voice, rate=rate)
+        await communicate.save(out_path)
+    except Exception as e:
+        raise TTSError(f"TTS failed for line {idx}: {e}") from e
+
+    if os.path.getsize(out_path) == 0:
+        raise TTSError(f"TTS returned empty file for line {idx}: {line.text[:60]}")
+
+    try:
+        audio = AudioSegment.from_mp3(out_path)
+        duration_ms = len(audio)
+    except Exception as e:
+        raise TTSError(f"Could not read rendered segment {out_path}: {e}") from e
+
+    return RenderedSegment(line=line, audio_path=out_path, duration_ms=duration_ms)