@vue-skuilder/db 0.1.18 → 0.1.21

package/dist/{index-D-Fa4Smt.d.cts → index-B_j6u5E4.d.cts}

@@ -1,4 +1,4 @@
-import { P as PackerConfig, a as PackedCourseData, S as StaticCourseManifest } from './types-CzPDLAK6.cjs';
+import { P as PackerConfig, a as PackedCourseData, S as StaticCourseManifest } from './types-Bn0itutr.cjs';
 
 /**
  * Abstraction for file system operations needed by the migrator.

package/dist/{index-CD8BZz2k.d.ts → index-Dj0SEgk3.d.ts}

@@ -1,4 +1,4 @@
-import { P as PackerConfig, a as PackedCourseData, S as StaticCourseManifest } from './types-CewsN87z.js';
+import { P as PackerConfig, a as PackedCourseData, S as StaticCourseManifest } from './types-DQaXnuoc.js';
 
 /**
  * Abstraction for file system operations needed by the migrator.

package/dist/index.d.cts

@@ -1,15 +1,15 @@
-import { U as UserDBInterface, s as CourseRegistrationDoc, l as StudySessionItem, i as StudyContentSource, S as StudySessionNewItem, f as StudySessionReviewItem, g as ScheduledCard, W as WeightedCard } from './classroomDB-CTOenngH.cjs';
-export { J as ActivityRecord, A as AdminDBInterface, v as AssignedCard, h as AssignedContent, u as AssignedCourse, t as AssignedTag, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, G as ClassroomRegistrationDoc, k as ContentNavigator, q as ContentSourceID, C as CourseDBInterface, d as CourseInfo, K as CourseRegistration, b as CoursesDBInterface, V as DocumentUpdater, O as NavigatorRole, P as NavigatorRoles, N as Navigators, H as SessionTrackingData, L as StrategyContribution, j as StudentClassroomDBInterface, m as StudySessionFailedItem, n as StudySessionFailedNewItem, o as StudySessionFailedReviewItem, T as TeacherClassroomDBInterface, I as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, B as UsrCrsDataInterface, M as getCardOrigin, r as getStudySource, R as isFilter, Q as isGenerator, p as isReview, X as newInterval } from './classroomDB-CTOenngH.cjs';
-import { D as DataLayerProvider } from './dataLayerProvider-D6PoCwS6.cjs';
-import { C as CardHistory, c as CardRecord } from './types-legacy-6ettoclI.cjs';
-export { d as CardData, e as CourseListData, g as DataShapeData, f as DisplayableData, D as DocType, b as DocTypePrefixes, F as Field, G as GuestUsername, Q as QualifiedCardID, h as QuestionData, i as QuestionRecord, S as SkuilderCourseData, a as Tag, T as TagStub, l as log } from './types-legacy-6ettoclI.cjs';
+import { U as UserDBInterface, s as CourseRegistrationDoc, S as StudySessionItem, W as WeightedCard, h as StudyContentSource } from './contentSource-DsJadoBU.cjs';
+export { J as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, G as ClassroomRegistrationDoc, f as ContentNavigator, q as ContentSourceID, C as CourseDBInterface, d as CourseInfo, K as CourseRegistration, b as CoursesDBInterface, V as DocumentUpdater, O as NavigatorRole, P as NavigatorRoles, N as Navigators, j as ScheduledCard, H as SessionTrackingData, L as StrategyContribution, i as StudentClassroomDBInterface, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, n as StudySessionNewItem, o as StudySessionReviewItem, T as TeacherClassroomDBInterface, I as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, B as UsrCrsDataInterface, M as getCardOrigin, r as getStudySource, R as isFilter, Q as isGenerator, p as isReview, X as newInterval } from './contentSource-DsJadoBU.cjs';
+import { D as DataLayerProvider } from './dataLayerProvider-CHYrQ5pB.cjs';
+import { C as CardHistory, c as CardRecord } from './types-legacy-DDY4N-Uq.cjs';
+export { d as CardData, e as CourseListData, g as DataShapeData, f as DisplayableData, D as DocType, b as DocTypePrefixes, F as Field, G as GuestUsername, Q as QualifiedCardID, h as QuestionData, i as QuestionRecord, S as SkuilderCourseData, a as Tag, T as TagStub, l as log } from './types-legacy-DDY4N-Uq.cjs';
 import { Loggable } from './core/index.cjs';
-export { BulkCardProcessorConfig, CardFilter, CardFilterFactory, CardGenerator, CardGeneratorFactory, FilterContext, GeneratorContext, ImportResult, areQuestionRecords, docIsDeleted, getCardHistoryID, importParsedCards, isQuestionRecord, parseCardHistoryID, validateProcessorConfig } from './core/index.cjs';
+export { BulkCardProcessorConfig, CardFilter, CardFilterFactory, CardGenerator, CardGeneratorFactory, FilterContext, GeneratorContext, ImportResult, StrategyStateDoc, StrategyStateId, areQuestionRecords, buildStrategyStateId, docIsDeleted, getCardHistoryID, importParsedCards, isQuestionRecord, parseCardHistoryID, validateProcessorConfig } from './core/index.cjs';
 import { TagFilter } from '@vue-skuilder/common';
-import { S as StaticCourseManifest } from './types-CzPDLAK6.cjs';
-export { A as AttachmentData, C as ChunkMetadata, D as DesignDocument, I as IndexMetadata, a as PackedCourseData, P as PackerConfig } from './types-CzPDLAK6.cjs';
-import { F as FileSystemAdapter } from './index-D-Fa4Smt.cjs';
-export { C as CouchDBToStaticPacker, a as FileStats, b as FileSystemError } from './index-D-Fa4Smt.cjs';
+import { S as StaticCourseManifest } from './types-Bn0itutr.cjs';
+export { A as AttachmentData, C as ChunkMetadata, D as DesignDocument, I as IndexMetadata, a as PackedCourseData, P as PackerConfig } from './types-Bn0itutr.cjs';
+import { F as FileSystemAdapter } from './index-B_j6u5E4.cjs';
+export { C as CouchDBToStaticPacker, a as FileStats, b as FileSystemError } from './index-B_j6u5E4.cjs';
 import 'moment';
 
 /**
@@ -242,30 +242,47 @@ declare function getDbPath(dbName: string): string;
 declare function initializeDataDirectory(): Promise<void>;
 
 /**
- * Initialize TUI logging - redirect console logs to file in Node.js
+ * Represents a batch of content fetched from a single StudyContentSource.
  */
-declare function initializeTuiLogging(): void;
-/**
- * Get the current log file path (for debugging)
- */
-declare function getLogFilePath(): string | null;
-/**
- * Show user-facing message (always visible in TUI)
- */
-declare function showUserMessage(message: string): void;
+interface SourceBatch {
+    sourceIndex: number;
+    weighted: WeightedCard[];
+}
 /**
- * Show user-facing error (always visible in TUI)
+ * Strategy interface for mixing content from multiple sources into a unified
+ * set of weighted candidates.
+ *
+ * Different implementations can provide different balancing strategies:
+ * - QuotaRoundRobinMixer: Equal representation per source
+ * - MinMaxNormalizingMixer: Score normalization then global sort
+ * - PercentileBucketMixer: Bucketed round-robin
+ * etc.
  */
-declare function showUserError(message: string): void;
+interface SourceMixer {
+    /**
+     * Mix weighted cards from multiple sources into a unified, ordered list.
+     *
+     * @param batches - Content batches from each source
+     * @param limit - Target number of cards to return
+     * @returns Mixed and ordered weighted cards
+     */
+    mix(batches: SourceBatch[], limit: number): WeightedCard[];
+}
 /**
- * Logger object with standard log levels
+ * Simple quota-based mixer: allocates equal representation to each source,
+ * taking the top-N cards by score from each.
+ *
+ * Guarantees balanced representation across sources regardless of absolute
+ * score differences. A low-scoring source gets the same quota as a high-scoring
+ * source.
+ *
+ * This is the KISS approach - simple, predictable, and fair in terms of
+ * source representation (though not necessarily optimal in terms of absolute
+ * card quality).
  */
-declare const logger: {
-    debug: (message: string, ...args: any[]) => void;
-    info: (message: string, ...args: any[]) => void;
-    warn: (message: string, ...args: any[]) => void;
-    error: (message: string, ...args: any[]) => void;
-};
+declare class QuotaRoundRobinMixer implements SourceMixer {
+    mix(batches: SourceBatch[], limit: number): WeightedCard[];
+}
 
 interface StudySessionRecord {
     card: {
@@ -294,6 +311,7 @@ declare class SessionController<TView = unknown> extends Loggable {
     private srsService;
     private eloService;
     private hydrationService;
+    private mixer;
     private sources;
     private _sessionRecord;
     set sessionRecord(r: StudySessionRecord[]);
@@ -309,9 +327,13 @@ declare class SessionController<TView = unknown> extends Loggable {
     get detailedReport(): string;
     private _intervalHandle;
     /**
-     *
+     * @param sources - Array of content sources to mix for the session
+     * @param time - Session duration in seconds
+     * @param dataLayer - Data layer provider
+     * @param getViewComponent - Function to resolve view components
+     * @param mixer - Optional source mixer strategy (defaults to QuotaRoundRobinMixer)
      */
-    constructor(sources: StudyContentSource[], time: number, dataLayer: DataLayerProvider, getViewComponent: (viewId: string) => TView);
+    constructor(sources: StudyContentSource[], time: number, dataLayer: DataLayerProvider, getViewComponent: (viewId: string) => TView, mixer?: SourceMixer);
     private tick;
     /**
      * Returns a rough, erring toward conservative, guess at
@@ -369,34 +391,29 @@ declare class SessionController<TView = unknown> extends Loggable {
         };
         hydratedCache: {
             count: number;
-            failedCacheSize: number;
-            items: any[];
+            cardIds: string[];
         };
     };
     /**
-     * Fetch content using the new getWeightedCards API.
-     *
-     * This method uses getWeightedCards() to get scored candidates, then uses the
-     * scores to determine ordering. For reviews, we still need the full ScheduledCard
-     * data from getPendingReviews(), so we fetch both and use scores for ordering.
+     * Fetch content using the getWeightedCards API and mix across sources.
      *
-     * The hybrid approach:
-     * 1. Fetch weighted cards to get scoring/ordering information
-     * 2. Fetch full review data via legacy getPendingReviews()
-     * 3. Order reviews by their weighted scores
-     * 4. Add new cards ordered by their weighted scores
+     * This method:
+     * 1. Fetches weighted cards from each source
+     * 2. Fetches full review data (we need ScheduledCard fields for queue)
+     * 3. Uses SourceMixer to balance content across sources
+     * 4. Populates review and new card queues with mixed results
      */
     private getWeightedContent;
     /**
-     * @deprecated Use getWeightedContent() instead. This method is kept for backward
-     * compatibility with sources that don't support getWeightedCards().
+     * Returns items that should be pre-hydrated.
+     * Deterministic: top N items from each queue to ensure coverage.
+     * Failed queue items will typically already be hydrated (from initial render).
      */
-    private getScheduledReviews;
+    private _getItemsToHydrate;
     /**
-     * @deprecated Use getWeightedContent() instead. This method is kept for backward
-     * compatibility with sources that don't support getWeightedCards().
+     * Selects the next item to present to the user.
+     * Nondeterministic: uses probability to balance between queues based on session state.
      */
-    private getNewCards;
     private _selectNextItemToHydrate;
     nextCard(action?: SessionAction): Promise<HydratedCard<TView> | null>;
     /**
@@ -414,9 +431,8 @@ declare class SessionController<TView = unknown> extends Loggable {
      */
     submitResponse(cardRecord: CardRecord, cardHistory: Promise<CardHistory<CardRecord>>, courseRegistrationDoc: CourseRegistrationDoc, currentCard: StudySessionRecord, courseId: string, cardId: string, maxAttemptsPerView: number, maxSessionViews: number, sessionViews: number): Promise<ResponseResult>;
     private dismissCurrentCard;
-    private hasAvailableCards;
     /**
-     * Helper method for CardHydrationService to remove items from appropriate queue.
+     * Remove an item from its source queue after consumption by nextCard().
      */
     private removeItemFromQueue;
 }
@@ -445,20 +461,12 @@ declare class TagFilteredContentSource implements StudyContentSource {
      * - Cards in `exclude` tags are removed from the result
      */
     private resolveFilteredCardIds;
-    /**
-     * Gets new cards that match the tag filter and are not already active for the user.
-     */
-    getNewCards(limit?: number): Promise<StudySessionNewItem[]>;
-    /**
-     * Gets pending reviews, filtered to only include cards that match the tag filter.
-     */
-    getPendingReviews(): Promise<(StudySessionReviewItem & ScheduledCard)[]>;
     /**
      * Get cards with suitability scores for presentation.
      *
-     * This implementation wraps the legacy getNewCards/getPendingReviews methods,
-     * assigning score=1.0 to all cards. TagFilteredContentSource does not currently
-     * support pluggable navigation strategies - it returns flat-scored candidates.
+     * Filters cards by tag inclusion/exclusion and assigns score=1.0 to all.
+     * TagFilteredContentSource does not currently support pluggable navigation
+     * strategies - it returns flat-scored candidates.
      *
      * @param limit - Maximum number of cards to return
      * @returns Cards sorted by score descending (all scores = 1.0)
@@ -577,4 +585,4 @@ interface CouchDbUserDoc extends PouchDB.Authentication.User {
     entitlements: UserEntitlements;
 }
 
-export { type AggregatedDocument, type AttachmentUploadResult, CardHistory, CardRecord, type CouchDbUserDoc, CourseLookup, CourseRegistrationDoc, DEFAULT_MIGRATION_OPTIONS, type DataLayerConfig, DataLayerProvider, type DocumentCounts, ENV, type Entitlement, FileSystemAdapter, Loggable, type MigrationOptions, type MigrationResult, NOT_SET, type ResponseResult, type RestoreProgress, ScheduledCard, type SessionAction, SessionController, StaticCourseManifest, type StaticCourseValidation, StaticToCouchDBMigrator, StudyContentSource, StudySessionItem, StudySessionNewItem, type StudySessionRecord, StudySessionReviewItem, TagFilteredContentSource, type UserAccountStatus, UserDBInterface, type UserEntitlements, type ValidationIssue, type ValidationResult, WeightedCard, _resetDataLayer, ensureAppDataDirectory, getAppDataDirectory, getDataLayer, getDbPath, getLogFilePath, initializeDataDirectory, initializeDataLayer, initializeTuiLogging, logger, showUserError, showUserMessage, validateMigration, validateStaticCourse };
+export { type AggregatedDocument, type AttachmentUploadResult, CardHistory, CardRecord, type CouchDbUserDoc, CourseLookup, CourseRegistrationDoc, DEFAULT_MIGRATION_OPTIONS, type DataLayerConfig, DataLayerProvider, type DocumentCounts, ENV, type Entitlement, FileSystemAdapter, Loggable, type MigrationOptions, type MigrationResult, NOT_SET, QuotaRoundRobinMixer, type ResponseResult, type RestoreProgress, type SessionAction, SessionController, type SourceBatch, type SourceMixer, StaticCourseManifest, type StaticCourseValidation, StaticToCouchDBMigrator, StudyContentSource, StudySessionItem, type StudySessionRecord, TagFilteredContentSource, type UserAccountStatus, UserDBInterface, type UserEntitlements, type ValidationIssue, type ValidationResult, WeightedCard, _resetDataLayer, ensureAppDataDirectory, getAppDataDirectory, getDataLayer, getDbPath, initializeDataDirectory, initializeDataLayer, validateMigration, validateStaticCourse };

package/dist/index.d.ts

@@ -1,15 +1,15 @@
-import { U as UserDBInterface, s as CourseRegistrationDoc, l as StudySessionItem, i as StudyContentSource, S as StudySessionNewItem, f as StudySessionReviewItem, g as ScheduledCard, W as WeightedCard } from './classroomDB-BgfrVb8d.js';
-export { J as ActivityRecord, A as AdminDBInterface, v as AssignedCard, h as AssignedContent, u as AssignedCourse, t as AssignedTag, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, G as ClassroomRegistrationDoc, k as ContentNavigator, q as ContentSourceID, C as CourseDBInterface, d as CourseInfo, K as CourseRegistration, b as CoursesDBInterface, V as DocumentUpdater, O as NavigatorRole, P as NavigatorRoles, N as Navigators, H as SessionTrackingData, L as StrategyContribution, j as StudentClassroomDBInterface, m as StudySessionFailedItem, n as StudySessionFailedNewItem, o as StudySessionFailedReviewItem, T as TeacherClassroomDBInterface, I as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, B as UsrCrsDataInterface, M as getCardOrigin, r as getStudySource, R as isFilter, Q as isGenerator, p as isReview, X as newInterval } from './classroomDB-BgfrVb8d.js';
-import { D as DataLayerProvider } from './dataLayerProvider-CZxC9GtB.js';
-import { C as CardHistory, c as CardRecord } from './types-legacy-6ettoclI.js';
-export { d as CardData, e as CourseListData, g as DataShapeData, f as DisplayableData, D as DocType, b as DocTypePrefixes, F as Field, G as GuestUsername, Q as QualifiedCardID, h as QuestionData, i as QuestionRecord, S as SkuilderCourseData, a as Tag, T as TagStub, l as log } from './types-legacy-6ettoclI.js';
+import { U as UserDBInterface, s as CourseRegistrationDoc, S as StudySessionItem, W as WeightedCard, h as StudyContentSource } from './contentSource-BP9hznNV.js';
+export { J as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, G as ClassroomRegistrationDoc, f as ContentNavigator, q as ContentSourceID, C as CourseDBInterface, d as CourseInfo, K as CourseRegistration, b as CoursesDBInterface, V as DocumentUpdater, O as NavigatorRole, P as NavigatorRoles, N as Navigators, j as ScheduledCard, H as SessionTrackingData, L as StrategyContribution, i as StudentClassroomDBInterface, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, n as StudySessionNewItem, o as StudySessionReviewItem, T as TeacherClassroomDBInterface, I as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, B as UsrCrsDataInterface, M as getCardOrigin, r as getStudySource, R as isFilter, Q as isGenerator, p as isReview, X as newInterval } from './contentSource-BP9hznNV.js';
+import { D as DataLayerProvider } from './dataLayerProvider-MDTxXq2l.js';
+import { C as CardHistory, c as CardRecord } from './types-legacy-DDY4N-Uq.js';
+export { d as CardData, e as CourseListData, g as DataShapeData, f as DisplayableData, D as DocType, b as DocTypePrefixes, F as Field, G as GuestUsername, Q as QualifiedCardID, h as QuestionData, i as QuestionRecord, S as SkuilderCourseData, a as Tag, T as TagStub, l as log } from './types-legacy-DDY4N-Uq.js';
 import { Loggable } from './core/index.js';
-export { BulkCardProcessorConfig, CardFilter, CardFilterFactory, CardGenerator, CardGeneratorFactory, FilterContext, GeneratorContext, ImportResult, areQuestionRecords, docIsDeleted, getCardHistoryID, importParsedCards, isQuestionRecord, parseCardHistoryID, validateProcessorConfig } from './core/index.js';
+export { BulkCardProcessorConfig, CardFilter, CardFilterFactory, CardGenerator, CardGeneratorFactory, FilterContext, GeneratorContext, ImportResult, StrategyStateDoc, StrategyStateId, areQuestionRecords, buildStrategyStateId, docIsDeleted, getCardHistoryID, importParsedCards, isQuestionRecord, parseCardHistoryID, validateProcessorConfig } from './core/index.js';
 import { TagFilter } from '@vue-skuilder/common';
-import { S as StaticCourseManifest } from './types-CewsN87z.js';
-export { A as AttachmentData, C as ChunkMetadata, D as DesignDocument, I as IndexMetadata, a as PackedCourseData, P as PackerConfig } from './types-CewsN87z.js';
-import { F as FileSystemAdapter } from './index-CD8BZz2k.js';
-export { C as CouchDBToStaticPacker, a as FileStats, b as FileSystemError } from './index-CD8BZz2k.js';
+import { S as StaticCourseManifest } from './types-DQaXnuoc.js';
+export { A as AttachmentData, C as ChunkMetadata, D as DesignDocument, I as IndexMetadata, a as PackedCourseData, P as PackerConfig } from './types-DQaXnuoc.js';
+import { F as FileSystemAdapter } from './index-Dj0SEgk3.js';
+export { C as CouchDBToStaticPacker, a as FileStats, b as FileSystemError } from './index-Dj0SEgk3.js';
 import 'moment';
 
 /**
@@ -242,30 +242,47 @@ declare function getDbPath(dbName: string): string;
 declare function initializeDataDirectory(): Promise<void>;
 
 /**
- * Initialize TUI logging - redirect console logs to file in Node.js
+ * Represents a batch of content fetched from a single StudyContentSource.
  */
-declare function initializeTuiLogging(): void;
-/**
- * Get the current log file path (for debugging)
- */
-declare function getLogFilePath(): string | null;
-/**
- * Show user-facing message (always visible in TUI)
- */
-declare function showUserMessage(message: string): void;
+interface SourceBatch {
+    sourceIndex: number;
+    weighted: WeightedCard[];
+}
 /**
- * Show user-facing error (always visible in TUI)
+ * Strategy interface for mixing content from multiple sources into a unified
+ * set of weighted candidates.
+ *
+ * Different implementations can provide different balancing strategies:
+ * - QuotaRoundRobinMixer: Equal representation per source
+ * - MinMaxNormalizingMixer: Score normalization then global sort
+ * - PercentileBucketMixer: Bucketed round-robin
+ * etc.
  */
-declare function showUserError(message: string): void;
+interface SourceMixer {
+    /**
+     * Mix weighted cards from multiple sources into a unified, ordered list.
+     *
+     * @param batches - Content batches from each source
+     * @param limit - Target number of cards to return
+     * @returns Mixed and ordered weighted cards
+     */
+    mix(batches: SourceBatch[], limit: number): WeightedCard[];
+}
 /**
- * Logger object with standard log levels
+ * Simple quota-based mixer: allocates equal representation to each source,
+ * taking the top-N cards by score from each.
+ *
+ * Guarantees balanced representation across sources regardless of absolute
+ * score differences. A low-scoring source gets the same quota as a high-scoring
+ * source.
+ *
+ * This is the KISS approach - simple, predictable, and fair in terms of
+ * source representation (though not necessarily optimal in terms of absolute
+ * card quality).
  */
-declare const logger: {
-    debug: (message: string, ...args: any[]) => void;
-    info: (message: string, ...args: any[]) => void;
-    warn: (message: string, ...args: any[]) => void;
-    error: (message: string, ...args: any[]) => void;
-};
+declare class QuotaRoundRobinMixer implements SourceMixer {
+    mix(batches: SourceBatch[], limit: number): WeightedCard[];
+}
 
 interface StudySessionRecord {
     card: {
@@ -294,6 +311,7 @@ declare class SessionController<TView = unknown> extends Loggable {
     private srsService;
     private eloService;
     private hydrationService;
+    private mixer;
     private sources;
     private _sessionRecord;
     set sessionRecord(r: StudySessionRecord[]);
@@ -309,9 +327,13 @@ declare class SessionController<TView = unknown> extends Loggable {
     get detailedReport(): string;
     private _intervalHandle;
     /**
-     *
+     * @param sources - Array of content sources to mix for the session
+     * @param time - Session duration in seconds
+     * @param dataLayer - Data layer provider
+     * @param getViewComponent - Function to resolve view components
+     * @param mixer - Optional source mixer strategy (defaults to QuotaRoundRobinMixer)
      */
-    constructor(sources: StudyContentSource[], time: number, dataLayer: DataLayerProvider, getViewComponent: (viewId: string) => TView);
+    constructor(sources: StudyContentSource[], time: number, dataLayer: DataLayerProvider, getViewComponent: (viewId: string) => TView, mixer?: SourceMixer);
     private tick;
     /**
      * Returns a rough, erring toward conservative, guess at
@@ -369,34 +391,29 @@ declare class SessionController<TView = unknown> extends Loggable {
         };
         hydratedCache: {
             count: number;
-            failedCacheSize: number;
-            items: any[];
+            cardIds: string[];
         };
     };
     /**
-     * Fetch content using the new getWeightedCards API.
-     *
-     * This method uses getWeightedCards() to get scored candidates, then uses the
-     * scores to determine ordering. For reviews, we still need the full ScheduledCard
-     * data from getPendingReviews(), so we fetch both and use scores for ordering.
+     * Fetch content using the getWeightedCards API and mix across sources.
      *
-     * The hybrid approach:
-     * 1. Fetch weighted cards to get scoring/ordering information
-     * 2. Fetch full review data via legacy getPendingReviews()
-     * 3. Order reviews by their weighted scores
-     * 4. Add new cards ordered by their weighted scores
+     * This method:
+     * 1. Fetches weighted cards from each source
+     * 2. Fetches full review data (we need ScheduledCard fields for queue)
+     * 3. Uses SourceMixer to balance content across sources
+     * 4. Populates review and new card queues with mixed results
      */
     private getWeightedContent;
     /**
-     * @deprecated Use getWeightedContent() instead. This method is kept for backward
-     * compatibility with sources that don't support getWeightedCards().
+     * Returns items that should be pre-hydrated.
+     * Deterministic: top N items from each queue to ensure coverage.
+     * Failed queue items will typically already be hydrated (from initial render).
      */
-    private getScheduledReviews;
+    private _getItemsToHydrate;
     /**
-     * @deprecated Use getWeightedContent() instead. This method is kept for backward
-     * compatibility with sources that don't support getWeightedCards().
+     * Selects the next item to present to the user.
+     * Nondeterministic: uses probability to balance between queues based on session state.
      */
-    private getNewCards;
     private _selectNextItemToHydrate;
     nextCard(action?: SessionAction): Promise<HydratedCard<TView> | null>;
     /**
@@ -414,9 +431,8 @@ declare class SessionController<TView = unknown> extends Loggable {
      */
     submitResponse(cardRecord: CardRecord, cardHistory: Promise<CardHistory<CardRecord>>, courseRegistrationDoc: CourseRegistrationDoc, currentCard: StudySessionRecord, courseId: string, cardId: string, maxAttemptsPerView: number, maxSessionViews: number, sessionViews: number): Promise<ResponseResult>;
     private dismissCurrentCard;
-    private hasAvailableCards;
     /**
-     * Helper method for CardHydrationService to remove items from appropriate queue.
+     * Remove an item from its source queue after consumption by nextCard().
      */
     private removeItemFromQueue;
 }
@@ -445,20 +461,12 @@ declare class TagFilteredContentSource implements StudyContentSource {
      * - Cards in `exclude` tags are removed from the result
      */
     private resolveFilteredCardIds;
-    /**
-     * Gets new cards that match the tag filter and are not already active for the user.
-     */
-    getNewCards(limit?: number): Promise<StudySessionNewItem[]>;
-    /**
-     * Gets pending reviews, filtered to only include cards that match the tag filter.
-     */
-    getPendingReviews(): Promise<(StudySessionReviewItem & ScheduledCard)[]>;
     /**
      * Get cards with suitability scores for presentation.
      *
-     * This implementation wraps the legacy getNewCards/getPendingReviews methods,
-     * assigning score=1.0 to all cards. TagFilteredContentSource does not currently
-     * support pluggable navigation strategies - it returns flat-scored candidates.
+     * Filters cards by tag inclusion/exclusion and assigns score=1.0 to all.
+     * TagFilteredContentSource does not currently support pluggable navigation
+     * strategies - it returns flat-scored candidates.
      *
      * @param limit - Maximum number of cards to return
      * @returns Cards sorted by score descending (all scores = 1.0)
@@ -577,4 +585,4 @@ interface CouchDbUserDoc extends PouchDB.Authentication.User {
     entitlements: UserEntitlements;
 }
 
-export { type AggregatedDocument, type AttachmentUploadResult, CardHistory, CardRecord, type CouchDbUserDoc, CourseLookup, CourseRegistrationDoc, DEFAULT_MIGRATION_OPTIONS, type DataLayerConfig, DataLayerProvider, type DocumentCounts, ENV, type Entitlement, FileSystemAdapter, Loggable, type MigrationOptions, type MigrationResult, NOT_SET, type ResponseResult, type RestoreProgress, ScheduledCard, type SessionAction, SessionController, StaticCourseManifest, type StaticCourseValidation, StaticToCouchDBMigrator, StudyContentSource, StudySessionItem, StudySessionNewItem, type StudySessionRecord, StudySessionReviewItem, TagFilteredContentSource, type UserAccountStatus, UserDBInterface, type UserEntitlements, type ValidationIssue, type ValidationResult, WeightedCard, _resetDataLayer, ensureAppDataDirectory, getAppDataDirectory, getDataLayer, getDbPath, getLogFilePath, initializeDataDirectory, initializeDataLayer, initializeTuiLogging, logger, showUserError, showUserMessage, validateMigration, validateStaticCourse };
+export { type AggregatedDocument, type AttachmentUploadResult, CardHistory, CardRecord, type CouchDbUserDoc, CourseLookup, CourseRegistrationDoc, DEFAULT_MIGRATION_OPTIONS, type DataLayerConfig, DataLayerProvider, type DocumentCounts, ENV, type Entitlement, FileSystemAdapter, Loggable, type MigrationOptions, type MigrationResult, NOT_SET, QuotaRoundRobinMixer, type ResponseResult, type RestoreProgress, type SessionAction, SessionController, type SourceBatch, type SourceMixer, StaticCourseManifest, type StaticCourseValidation, StaticToCouchDBMigrator, StudyContentSource, StudySessionItem, type StudySessionRecord, TagFilteredContentSource, type UserAccountStatus, UserDBInterface, type UserEntitlements, type ValidationIssue, type ValidationResult, WeightedCard, _resetDataLayer, ensureAppDataDirectory, getAppDataDirectory, getDataLayer, getDbPath, initializeDataDirectory, initializeDataLayer, validateMigration, validateStaticCourse };