tessera-learn 0.0.3 → 0.0.4

package/src/runtime/progress.svelte.ts

@@ -24,6 +24,21 @@ export class ProgressState {
   completionStatus = $state<'incomplete' | 'complete'>('incomplete');
   successStatus = $state<'unknown' | 'passed' | 'failed'>('unknown');
 
+  // Latch for manual completion. Monotonic; recalc methods bail when set.
+  #manuallyCompleted = $state(false);
+
+  get manuallyCompleted(): boolean {
+    return this.#manuallyCompleted;
+  }
+
+  /** Idempotent — only the first call per session has an effect. */
+  markCompleteManually(): void {
+    if (this.#manuallyCompleted) return;
+    this.#manuallyCompleted = true;
+    this.completionStatus = 'complete';
+    this.version++;
+  }
+
   /**
    * Monotonic counter incremented on every persistable state mutation
    * (visited/scores/chunks/standalone). Callers that need to react to *any*
@@ -100,6 +115,8 @@ export class ProgressState {
   }
 
   recalculateCompletion(manifest: Manifest, config: CourseConfig) {
+    if (this.#manuallyCompleted) return;
+    if (config.completion.mode === 'manual') return;
     if (config.completion.mode === 'percentage') {
       const threshold = config.completion.percentageThreshold ?? 100;
       const percent = manifest.totalPages > 0
@@ -118,6 +135,14 @@ export class ProgressState {
   }
 
   recalculateSuccess(manifest: Manifest, config: CourseConfig) {
+    if (config.completion.mode === 'manual') {
+      const want = config.completion.requireSuccessStatus;
+      // Stay 'unknown' until manual mark fires, so a learner who never
+      // finishes isn't reported as passed.
+      this.successStatus = this.#manuallyCompleted && want !== undefined ? want : 'unknown';
+      return;
+    }
+
     const { indices, attempted } = this.#gradedPages(manifest);
 
     if (indices.length === 0) {

package/src/runtime/types.ts

@@ -29,10 +29,8 @@ export interface CourseConfig {
     mode: 'free' | 'sequential';
     canAccess?: AccessFn;
   };
-  completion: {
-    mode: 'quiz' | 'percentage';
-    percentageThreshold?: number;
-  };
+  completion: ManualCompletion | QuizCompletion | PercentageCompletion;
+  /** Optional under "manual"; required under "quiz". */
   scoring: {
     passingScore: number;
   };
@@ -48,6 +46,27 @@ export interface CourseConfig {
   xapi?: XAPIConfig | XAPIConfig[];
 }
 
+export interface ManualCompletion {
+  mode: 'manual';
+  /**
+   * Set to "page" to opt into a build-time check that at least one page
+   * declares `completesOn: "view"`. Omit to skip the check; both completion
+   * paths still work at runtime.
+   */
+  trigger?: 'page';
+  /** When set, markComplete() also flips successStatus. Omit for unknown. */
+  requireSuccessStatus?: 'passed' | 'failed';
+}
+
+export interface QuizCompletion {
+  mode: 'quiz';
+}
+
+export interface PercentageCompletion {
+  mode: 'percentage';
+  percentageThreshold?: number;
+}
+
 /**
  * cmi5 launch-inherited destination. Only valid under `export.standard:
  * 'cmi5'`. Auth, actor, activityId, and registration are taken from the