learningfoundry 0.40.0__tar.gz → 0.45.0__tar.gz

{learningfoundry-0.40.0 → learningfoundry-0.45.0}/CHANGELOG.md

@@ -7,6 +7,60 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.45.0] - 2026-04-30
+
+### Added
+
+- **Locking and unlocking UI.** Frontend implementation of the locking model introduced in v0.44.0:
+  - New `$lib/utils/locking.ts` with pure functions `isModuleLocked`, `isLessonLocked`, `getOptionalLessons`, `isModuleComplete`, plus convenience set helpers `lockedModuleIds` / `lockedLessonIds`.
+  - `ModuleList.svelte` renders a Lucide `Lock` icon, suppresses expansion, and skips the active-module highlight for locked modules.
+  - `LessonList.svelte` shows a `◇` indicator for optional lessons (sibling lessons within a module whose `unlock_module_on_complete` lesson has been completed) and renders locked lessons as muted, non-clickable rows.
+  - `ProgressDashboard.svelte` uses `isModuleComplete` for per-module status (treats optional lessons as not blocking module completion) while still counting all completed lessons toward the curriculum-level progress bar.
+  - Type extensions: `LessonStatus` gains `'optional'`; `Lesson.unlock_module_on_complete?`, `Module.locked?`, `Curriculum.locking?`, and a new `LockingConfig` interface.
+  - The unlock cascade is fully reactive: completing an `unlock_module_on_complete` lesson refreshes `progressStore` once via `invalidateProgress`, and all locked/optional state re-derives automatically — no extra DB writes or store updates required.
+
+## [0.44.0] - 2026-04-30
+
+### Added
+
+- **Locking configuration schema.** Python-side schema, resolver, and config support for sequential content access control:
+  - `LockingConfig` Pydantic model (`sequential`, `lesson_sequential`) on `CurriculumDef`.
+  - `Module.locked: bool | None` per-module override.
+  - `Lesson.unlock_module_on_complete: bool` gateway-lesson flag.
+  - `QuizBlock.pass_threshold: float` (0.0–1.0) for quiz completion scoring.
+  - Global config (`~/.config/learningfoundry/config.yml`) gains `locking` block with the same fields.
+  - Config hierarchy: global defaults → curriculum YAML `locking` → per-module `locked` override.
+  - All fields propagate through the resolver into `curriculum.json` for frontend consumption (Story I.j).
+
+## [0.43.0] - 2026-04-30
+
+### Added
+
+- **Curriculum-level progress bar on the dashboard.** `ProgressDashboard.svelte` now renders a summary bar above the module cards showing `"{totalComplete} of {totalLessons} lessons completed"`. Computed reactively from `progressStore` — updates live when lessons complete during the session. Hidden when the curriculum has zero lessons. The dashboard `+page.svelte` no longer does its own one-shot progress fetch; it reads from the shared `progressStore` populated by the layout.
+
+## [0.42.0] - 2026-04-30
+
+### Added
+
+- **Block completion events drive lesson auto-complete.** Each content block fires an independent completion event when sufficiently engaged with: `TextBlock` after 1 s in the viewport (IntersectionObserver + debounce timer), `VideoBlock` on YouTube IFrame Player API `ENDED` state (falls back to 3 s viewport if API fails to load within 5 s), `QuizBlock` when score ≥ `passThreshold` (default 0.0). `LessonView` tracks which blocks have completed; when all have fired, the lesson is marked complete in SQLite and the sidebar updates immediately.
+- **Reactive progress store** (`$lib/stores/progress.ts`). `progressStore` is a writable Svelte store holding `Record<string, ModuleProgress>`. `invalidateProgress(curriculum)` re-fetches all module progress from SQLite and writes to the store. `+layout.svelte` subscribes to this store instead of a one-shot `$effect` fetch; lesson completions call `invalidateProgress` so the sidebar reflects changes without a page reload.
+- **Revisit behaviour.** On mount, `LessonView` reads the lesson's current DB status; if already `complete`, all blocks are pre-filled as done so the Next/Finish button is immediately active.
+- **Zero-block edge case.** A lesson with no content blocks is treated as immediately complete on mount.
+- **`QuizManifest.passThreshold`** added to TypeScript types for future quiz scoring threshold support.
+
+### Changed
+
+- **Next/Finish no longer trigger completion marking.** Navigation is decoupled from completion: `Navigation.svelte` handles its own routing (Next → `navigateTo`, Finish → `goto('/')`) and accepts a `disabled` prop. The `onComplete` callback prop has been removed. `LessonView` no longer has `handleNavComplete` or `oncomplete`.
+- **`+page.svelte`** migrated from deprecated `$app/stores` to `$app/state` for route params.
+
+## [0.41.0] - 2026-04-30
+
+### Fixed
+
+- **Finish button on last lesson now navigates to the dashboard.** `+page.svelte` was not passing an `oncomplete` handler to `<LessonView>`; clicking Finish was a no-op. It now calls `goto('/')` to redirect to the progress dashboard.
+- **Sidebar module expand/contract no longer reverts immediately.** The `$effect` in `ModuleList.svelte` read `expandedModuleId` (the value it writes), creating a self-dependency that overwrote manual toggles on every re-run. A separate `lastAutoExpandedModuleId` state variable breaks the cycle — the effect only fires when `currentPosition.moduleId` changes to a genuinely new value.
+- **Active module in sidebar is now visually highlighted.** The module card containing the current lesson receives a left-border accent (`border-l-2 border-l-blue-500`) and a light background tint (`bg-blue-50`).
+
 ## [0.40.0] - 2026-04-29
 
 ### Added

{learningfoundry-0.40.0 → learningfoundry-0.45.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: learningfoundry
-Version: 0.40.0
+Version: 0.45.0
 Summary: A curriculum engine that turns a YAML curriculum definition into a deployable SvelteKit learning application.
 Project-URL: Homepage, https://github.com/pointmatic/learningfoundry
 Project-URL: Repository, https://github.com/pointmatic/learningfoundry
@@ -48,6 +48,7 @@ A curriculum engine that turns a YAML curriculum definition into a deployable Sv
 - [Video blocks](#video-blocks)
 - [Lesson titles and markdown headings](#lesson-titles-and-markdown-headings)
 - [Images and assets](#images-and-assets)
+- [Content locking](#content-locking)
 - [Configuration File](#configuration-file)
 - [Development Setup](#development-setup)
 
@@ -389,9 +390,40 @@ For production deployment to a CDN, just run `cd dist && pnpm build` — the `st
 
 ---
 
+## Content locking
+
+Control access to modules and lessons with a three-level configuration hierarchy (most local wins):
+
+1. **Per-module `locked`** — explicit `true`/`false` override; trumps everything.
+2. **Curriculum `locking.sequential`** — when true, module N+1 requires module N complete.
+3. **Global config `locking.sequential`** — project-wide default (see Configuration File below).
+
+```yaml
+curriculum:
+  locking:
+    sequential: true            # modules must be completed in order
+    lesson_sequential: false    # lessons within a module are free-order
+
+  modules:
+    - id: mod-01
+      locked: false             # always accessible regardless of sequential
+      lessons:
+        - id: lesson-01
+          unlock_module_on_complete: true   # completing this unlocks siblings + next module
+          content_blocks:
+            - type: quiz
+              source: quizazz
+              ref: assessments/quiz.yml
+              pass_threshold: 0.7           # 70% required to count as passed
+```
+
+`unlock_module_on_complete` is useful for "gateway" lessons — a single assessment that, once passed, opens the rest of the module and the next one.
+
+---
+
 ## Configuration File
 
-An optional config file can set defaults for logging. The CLI always takes precedence.
+An optional config file can set defaults for logging and locking. The CLI always takes precedence.
 
 **Default location:** `~/.config/learningfoundry/config.yml`
 
@@ -399,6 +431,10 @@ An optional config file can set defaults for logging. The CLI always takes prece
 logging:
   level: INFO      # DEBUG | INFO | WARNING | ERROR
   output: stdout   # stdout | stderr
+
+locking:
+  sequential: false          # default for all curricula on this machine
+  lesson_sequential: false
 ```
 
 Pass a custom config location with `-c / --config`.

{learningfoundry-0.40.0 → learningfoundry-0.45.0}/README.md

@@ -19,6 +19,7 @@ A curriculum engine that turns a YAML curriculum definition into a deployable Sv
 - [Video blocks](#video-blocks)
 - [Lesson titles and markdown headings](#lesson-titles-and-markdown-headings)
 - [Images and assets](#images-and-assets)
+- [Content locking](#content-locking)
 - [Configuration File](#configuration-file)
 - [Development Setup](#development-setup)
 
@@ -360,9 +361,40 @@ For production deployment to a CDN, just run `cd dist && pnpm build` — the `st
 
 ---
 
+## Content locking
+
+Control access to modules and lessons with a three-level configuration hierarchy (most local wins):
+
+1. **Per-module `locked`** — explicit `true`/`false` override; trumps everything.
+2. **Curriculum `locking.sequential`** — when true, module N+1 requires module N complete.
+3. **Global config `locking.sequential`** — project-wide default (see Configuration File below).
+
+```yaml
+curriculum:
+  locking:
+    sequential: true            # modules must be completed in order
+    lesson_sequential: false    # lessons within a module are free-order
+
+  modules:
+    - id: mod-01
+      locked: false             # always accessible regardless of sequential
+      lessons:
+        - id: lesson-01
+          unlock_module_on_complete: true   # completing this unlocks siblings + next module
+          content_blocks:
+            - type: quiz
+              source: quizazz
+              ref: assessments/quiz.yml
+              pass_threshold: 0.7           # 70% required to count as passed
+```
+
+`unlock_module_on_complete` is useful for "gateway" lessons — a single assessment that, once passed, opens the rest of the module and the next one.
+
+---
+
 ## Configuration File
 
-An optional config file can set defaults for logging. The CLI always takes precedence.
+An optional config file can set defaults for logging and locking. The CLI always takes precedence.
 
 **Default location:** `~/.config/learningfoundry/config.yml`
 
@@ -370,6 +402,10 @@ An optional config file can set defaults for logging. The CLI always takes prece
 logging:
   level: INFO      # DEBUG | INFO | WARNING | ERROR
   output: stdout   # stdout | stderr
+
+locking:
+  sequential: false          # default for all curricula on this machine
+  lesson_sequential: false
 ```
 
 Pass a custom config location with `-c / --config`.

{learningfoundry-0.40.0 → learningfoundry-0.45.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "learningfoundry"
-version = "0.40.0"
+version = "0.45.0"
 description = "A curriculum engine that turns a YAML curriculum definition into a deployable SvelteKit learning application."
 readme = "README.md"
 license = "Apache-2.0"

{learningfoundry-0.40.0 → learningfoundry-0.45.0}/src/learningfoundry/__init__.py

@@ -1,4 +1,4 @@
 # Copyright 2026 Pointmatic
 # SPDX-License-Identifier: Apache-2.0
 
-__version__ = "0.40.0"
+__version__ = "0.45.0"

{learningfoundry-0.40.0 → learningfoundry-0.45.0}/src/learningfoundry/config.py

@@ -16,6 +16,7 @@ DEFAULT_CONFIG_PATH = Path.home() / ".config" / "learningfoundry" / "config.yml"
 
 _KNOWN_KEYS: dict[str, set[str]] = {
     "logging": {"level", "output"},
+    "locking": {"sequential", "lesson_sequential"},
 }
 
 
@@ -25,9 +26,16 @@ class LoggingConfig:
     output: str = "stdout"
 
 
+@dataclass
+class LockingConfig:
+    sequential: bool = False
+    lesson_sequential: bool = False
+
+
 @dataclass
 class AppConfig:
     logging: LoggingConfig = field(default_factory=LoggingConfig)
+    locking: LockingConfig = field(default_factory=LockingConfig)
 
 
 def load_config(
@@ -66,6 +74,13 @@ def load_config(
                 config.logging.level = logging_raw["level"]
             if "output" in logging_raw:
                 config.logging.output = logging_raw["output"]
+            locking_raw = raw.get("locking", {})
+            if "sequential" in locking_raw:
+                config.locking.sequential = bool(locking_raw["sequential"])
+            if "lesson_sequential" in locking_raw:
+                config.locking.lesson_sequential = bool(
+                    locking_raw["lesson_sequential"]
+                )
 
     if cli_overrides:
         if "log_level" in cli_overrides and cli_overrides["log_level"] is not None:

{learningfoundry-0.40.0 → learningfoundry-0.45.0}/src/learningfoundry/resolver.py

@@ -40,6 +40,7 @@ class ResolvedContentBlock:
 class ResolvedLesson:
     id: str
     title: str
+    unlock_module_on_complete: bool = False
     content_blocks: list[ResolvedContentBlock] = field(default_factory=list)
 
 
@@ -48,6 +49,7 @@ class ResolvedModule:
     id: str
     title: str
     description: str
+    locked: bool | None
     pre_assessment: dict[str, Any] | None
     post_assessment: dict[str, Any] | None
     lessons: list[ResolvedLesson] = field(default_factory=list)
@@ -58,6 +60,7 @@ class ResolvedCurriculum:
     version: str
     title: str
     description: str
+    locking: dict[str, Any] = field(default_factory=dict)
     modules: list[ResolvedModule] = field(default_factory=list)
     # Image assets referenced from any text block's markdown, deduped by
     # content hash. Carried out-of-band — the generator copies these into
@@ -122,10 +125,17 @@ def resolve_curriculum(
             )
         )
 
+    locking = curriculum.curriculum.locking
+    locking_dict: dict[str, Any] = {
+        "sequential": locking.sequential,
+        "lesson_sequential": locking.lesson_sequential,
+    }
+
     return ResolvedCurriculum(
         version=curriculum.version,
         title=curriculum.curriculum.title,
         description=curriculum.curriculum.description,
+        locking=locking_dict,
         modules=resolved_modules,
         assets=list(assets_by_dest.values()),
     )
@@ -174,6 +184,7 @@ def _resolve_module(
         id=module.id,
         title=module.title,
         description=module.description,
+        locked=module.locked,
         pre_assessment=pre,
         post_assessment=post,
         lessons=resolved_lessons,
@@ -206,6 +217,7 @@ def _resolve_lesson(
     return ResolvedLesson(
         id=lesson.id,
         title=lesson.title,
+        unlock_module_on_complete=lesson.unlock_module_on_complete,
         content_blocks=resolved_blocks,
     )
 
@@ -228,6 +240,7 @@ def _resolve_block(
             manifest = quiz_provider.compile_assessment(
                 Path(block.ref), base_dir
             )
+            manifest["pass_threshold"] = block.pass_threshold
             return ResolvedContentBlock(
                 type="quiz", source=block.source, ref=block.ref, content=manifest
             )

{learningfoundry-0.40.0 → learningfoundry-0.45.0}/src/learningfoundry/schema_v1.py

@@ -63,6 +63,7 @@ class QuizBlock(BaseModel):
     type: Literal["quiz"]
     source: str
     ref: str
+    pass_threshold: float = Field(0.0, ge=0.0, le=1.0)
 
 
 class ExerciseBlock(BaseModel):
@@ -86,6 +87,7 @@ ContentBlock = Annotated[
 class Lesson(BaseModel):
     id: str
     title: str
+    unlock_module_on_complete: bool = False
     content_blocks: list[ContentBlock]
 
     @field_validator("id")
@@ -98,6 +100,7 @@ class Module(BaseModel):
     id: str
     title: str
     description: str = ""
+    locked: bool | None = None
     pre_assessment: AssessmentRef | None = None
     post_assessment: AssessmentRef | None = None
     lessons: list[Lesson]
@@ -114,9 +117,17 @@ class Module(BaseModel):
         return self
 
 
+class LockingConfig(BaseModel):
+    """Curriculum-level content locking configuration."""
+
+    sequential: bool = False
+    lesson_sequential: bool = False
+
+
 class CurriculumDef(BaseModel):
     title: str
     description: str = ""
+    locking: LockingConfig = Field(default_factory=LockingConfig)
     modules: list[Module]
 
     @model_validator(mode="after")

{learningfoundry-0.40.0 → learningfoundry-0.45.0}/src/learningfoundry/sveltekit_template/src/lib/components/ContentBlock.svelte

@@ -1,6 +1,7 @@
 <!-- Copyright 2026 Pointmatic — SPDX-License-Identifier: Apache-2.0 -->
 <!--
   Dispatcher component — renders the correct block component based on `block.type`.
+  Forwards child completion events upward as `onblockcomplete(blockIndex)`.
 -->
 <script lang="ts">
 	import type { ContentBlock, QuizScore } from '$lib/types/index.js';
@@ -20,20 +21,28 @@
 
 	interface Props {
 		block: ContentBlock;
+		blockIndex: number;
+		onblockcomplete?: (blockIndex: number) => void;
 		onquizcomplete?: (score: QuizScore) => void;
 	}
-	let { block, onquizcomplete }: Props = $props();
+	let { block, blockIndex, onblockcomplete, onquizcomplete }: Props = $props();
+
+	function handleBlockComplete() {
+		onblockcomplete?.(blockIndex);
+	}
 </script>
 
 {#if block.type === 'text'}
-	<TextBlock content={block.content as TextContent} />
+	<TextBlock content={block.content as TextContent} ontextcomplete={handleBlockComplete} />
 {:else if block.type === 'video'}
-	<VideoBlock content={block.content as VideoContent} />
+	<VideoBlock content={block.content as VideoContent} onvideocomplete={handleBlockComplete} />
 {:else if block.type === 'quiz'}
 	<QuizBlock
 		manifest={block.content as QuizManifest}
 		quizRef={block.ref ?? ''}
+		passThreshold={(block.content as QuizManifest).passThreshold ?? 0.0}
 		oncomplete={onquizcomplete}
+		onquizcomplete={handleBlockComplete}
 	/>
 {:else if block.type === 'exercise'}
 	<ExerciseBlock content={block.content as ExerciseContent} />

{learningfoundry-0.40.0 → learningfoundry-0.45.0/src/learningfoundry}/sveltekit_template/src/lib/components/LessonList.svelte

@@ -2,19 +2,27 @@
 <script lang="ts">
 	import { currentPosition, navigateTo } from '$lib/stores/curriculum.js';
 	import type { Lesson, LessonProgress } from '$lib/types/index.js';
+	import { lessonStatusIcon, resolveLessonClick } from './module-list.helpers.js';
 
 	interface Props {
 		moduleId: string;
 		lessons: Lesson[];
 		progress?: Record<string, LessonProgress>;
+		optionalLessons?: Set<string>;
+		lockedLessons?: Set<string>;
 	}
-	let { moduleId, lessons, progress = {} }: Props = $props();
+	let {
+		moduleId,
+		lessons,
+		progress = {},
+		optionalLessons = new Set(),
+		lockedLessons = new Set()
+	}: Props = $props();
 
 	function statusIcon(lessonId: string): string {
 		const s = progress[lessonId]?.status;
-		if (s === 'complete') return '✓';
-		if (s === 'in_progress') return '…';
-		return '○';
+		const concrete = s === 'optional' ? undefined : s;
+		return lessonStatusIcon(lessonId, concrete, optionalLessons);
 	}
 
 	function statusClass(lessonId: string): string {
@@ -23,21 +31,32 @@
 		if (s === 'in_progress') return 'text-blue-500';
 		return 'text-gray-400';
 	}
+
+	function handleClick(lessonId: string) {
+		if (resolveLessonClick(lessonId, lockedLessons) === 'noop') return;
+		navigateTo(moduleId, lessonId);
+	}
 </script>
 
 <ul class="space-y-1">
 	{#each lessons as lesson (lesson.id)}
 		{@const isActive =
 			$currentPosition?.moduleId === moduleId && $currentPosition?.lessonId === lesson.id}
+		{@const locked = lockedLessons.has(lesson.id)}
 		<li>
 			<button
-				onclick={() => navigateTo(moduleId, lesson.id)}
+				onclick={() => handleClick(lesson.id)}
 				class="flex w-full items-center gap-2 rounded px-3 py-1.5 text-left text-sm transition-colors
-					{isActive
-					? 'bg-blue-100 font-medium text-blue-700'
-					: 'text-gray-700 hover:bg-gray-100'}"
+					{locked
+					? 'cursor-not-allowed text-gray-300'
+					: isActive
+						? 'bg-blue-100 font-medium text-blue-700'
+						: 'text-gray-700 hover:bg-gray-100'}"
+				aria-disabled={locked}
 			>
-				<span class="shrink-0 text-xs {statusClass(lesson.id)}">{statusIcon(lesson.id)}</span>
+				<span class="shrink-0 text-xs {locked ? 'text-gray-300' : statusClass(lesson.id)}"
+					>{statusIcon(lesson.id)}</span
+				>
 				<span class="truncate">{lesson.title}</span>
 			</button>
 		</li>

learningfoundry-0.45.0/src/learningfoundry/sveltekit_template/src/lib/components/LessonView.svelte

@@ -0,0 +1,81 @@
+<!-- Copyright 2026 Pointmatic — SPDX-License-Identifier: Apache-2.0 -->
+<script lang="ts">
+	import { getLessonProgress, markLessonComplete, markLessonInProgress } from '$lib/db/index.js';
+	import { curriculum } from '$lib/stores/curriculum.js';
+	import { invalidateProgress } from '$lib/stores/progress.js';
+	import type { Lesson, QuizScore } from '$lib/types/index.js';
+	import ContentBlock from './ContentBlock.svelte';
+	import Navigation from './Navigation.svelte';
+	import { onMount } from 'svelte';
+
+	interface Props {
+		lesson: Lesson;
+		moduleId: string;
+	}
+	let { lesson, moduleId }: Props = $props();
+
+	let allBlocksComplete = $state(false);
+	let completedBlocks = $state(new Set<number>());
+
+	const lessonComplete = $derived(
+		allBlocksComplete || completedBlocks.size === lesson.content_blocks.length
+	);
+
+	onMount(async () => {
+		// Zero-block edge case
+		if (lesson.content_blocks.length === 0) {
+			allBlocksComplete = true;
+			await markLessonComplete(moduleId, lesson.id);
+			await invalidateProgress($curriculum);
+			return;
+		}
+
+		// Revisit: if lesson is already complete, pre-fill so nav is active
+		const existing = await getLessonProgress(moduleId, lesson.id);
+		if (existing?.status === 'complete') {
+			allBlocksComplete = true;
+		} else {
+			await markLessonInProgress(moduleId, lesson.id);
+		}
+	});
+
+	async function handleBlockComplete(blockIndex: number) {
+		if (allBlocksComplete) return;
+		completedBlocks.add(blockIndex);
+		completedBlocks = new Set(completedBlocks);
+		if (completedBlocks.size === lesson.content_blocks.length) {
+			await markLessonComplete(moduleId, lesson.id);
+			// Refreshing the progress store is enough to drive the
+			// `unlock_module_on_complete` cascade: locking utilities in
+			// `$lib/utils/locking.ts` re-derive sibling-optional and
+			// next-module-unlocked state from the new `complete` status —
+			// no additional DB write or extra invalidation is required.
+			await invalidateProgress($curriculum);
+		}
+	}
+
+	function handleQuizComplete(_score: QuizScore) {
+		// Score already persisted by QuizBlock; could trigger further logic here
+	}
+</script>
+
+<article class="mx-auto max-w-3xl space-y-8 py-6">
+	<header>
+		<h1 class="text-2xl font-bold text-gray-900">{lesson.title}</h1>
+	</header>
+
+	<div class="space-y-8">
+		{#each lesson.content_blocks as block, i (i)}
+			<section>
+				<ContentBlock
+					{block}
+					blockIndex={i}
+					onblockcomplete={handleBlockComplete}
+					onquizcomplete={handleQuizComplete}
+				/>
+			</section>
+		{/each}
+	</div>
+
+	<Navigation disabled={!lessonComplete} />
+</article>

learningfoundry-0.45.0/src/learningfoundry/sveltekit_template/src/lib/components/LessonView.test.ts

@@ -0,0 +1,68 @@
+// Copyright 2026 Pointmatic
+// SPDX-License-Identifier: Apache-2.0
+import { describe, expect, it } from 'vitest';
+import { createBlockTracker } from './lesson-view.helpers.js';
+
+describe('LessonView block tracking (via createBlockTracker)', () => {
+	it('all blocks complete → returns true on final markBlockComplete', () => {
+		const tracker = createBlockTracker(3);
+
+		expect(tracker.markBlockComplete(0)).toBe(false);
+		expect(tracker.markBlockComplete(1)).toBe(false);
+		expect(tracker.markBlockComplete(2)).toBe(true);
+		expect(tracker.allComplete).toBe(true);
+	});
+
+	it('button disabled until all blocks done (allComplete is false)', () => {
+		const tracker = createBlockTracker(2);
+
+		expect(tracker.allComplete).toBe(false);
+		tracker.markBlockComplete(0);
+		expect(tracker.allComplete).toBe(false);
+		tracker.markBlockComplete(1);
+		expect(tracker.allComplete).toBe(true);
+	});
+
+	it('pre-fills set when lesson is already complete (revisit)', () => {
+		const tracker = createBlockTracker(5, true);
+
+		// Immediately complete — no engagement required
+		expect(tracker.allComplete).toBe(true);
+		expect(tracker.completedCount).toBe(5);
+		expect(tracker.markBlockComplete(0)).toBe(true);
+	});
+
+	it('zero-block lesson is immediately complete', () => {
+		const tracker = createBlockTracker(0);
+
+		expect(tracker.allComplete).toBe(true);
+		expect(tracker.completedCount).toBe(0);
+	});
+
+	it('duplicate markBlockComplete calls are idempotent', () => {
+		const tracker = createBlockTracker(2);
+
+		tracker.markBlockComplete(0);
+		tracker.markBlockComplete(0);
+		expect(tracker.completedCount).toBe(1);
+		expect(tracker.allComplete).toBe(false);
+
+		tracker.markBlockComplete(1);
+		expect(tracker.allComplete).toBe(true);
+	});
+
+	it('completedCount tracks incremental progress', () => {
+		const tracker = createBlockTracker(4);
+
+		expect(tracker.completedCount).toBe(0);
+		tracker.markBlockComplete(2);
+		expect(tracker.completedCount).toBe(1);
+		tracker.markBlockComplete(0);
+		expect(tracker.completedCount).toBe(2);
+		tracker.markBlockComplete(3);
+		expect(tracker.completedCount).toBe(3);
+		tracker.markBlockComplete(1);
+		expect(tracker.completedCount).toBe(4);
+		expect(tracker.allComplete).toBe(true);
+	});
+});