import { CourseConfig, ClassroomConfig, Status, SkuilderCourseData as SkuilderCourseData$1, CourseElo, DataShape, TagFilter } from '@vue-skuilder/common';
import { Moment } from 'moment';
import { S as SkuilderCourseData, b as DocTypePrefixes, D as DocType, Q as QualifiedCardID, T as TagStub, a as Tag, C as CardHistory, c as CardRecord } from './types-legacy-DDY4N-Uq.js';

/**
 * Admin functionality
 */
interface AdminDBInterface {
    /**
     * Get all users
     */
    getUsers(): Promise<PouchDB.Core.Document<{}>[]>;
    /**
     * Get all courses
     */
    getCourses(): Promise<CourseConfig[]>;
    /**
     * Remove a course
     */
    removeCourse(id: string): Promise<PouchDB.Core.Response>;
    /**
     * Get all classrooms
     */
    getClassrooms(): Promise<(ClassroomConfig & {
        _id: string;
    })[]>;
}

/**
 * Classroom management
 */
interface ClassroomDBInterface {
    /**
     * Get classroom config
     */
    getConfig(): ClassroomConfig;
    /**
     * Get assigned content
     */
    getAssignedContent(): Promise<AssignedContent[]>;
}
interface TeacherClassroomDBInterface extends ClassroomDBInterface {
    /**
     * For teacher interfaces: assign content
     */
    assignContent?(content: AssignedContent): Promise<boolean>;
    /**
     * For teacher interfaces: remove content
     */
    removeContent?(content: AssignedContent): Promise<void>;
}
/**
 * Student-facing classroom interface.
 * Content is accessed via StudyContentSource.getWeightedCards().
 */
type StudentClassroomDBInterface = ClassroomDBInterface;
type AssignedContent = AssignedCourse | AssignedTag | AssignedCard;
interface AssignedTag extends ContentBase {
    type: 'tag';
    tagID: string;
}
interface AssignedCourse extends ContentBase {
    type: 'course';
}
interface AssignedCard extends ContentBase {
    type: 'card';
    cardID: string;
}
interface ContentBase {
    type: 'course' | 'tag' | 'card';
    /**
     * Username of the assigning teacher.
     */
    assignedBy: string;
    /**
     * Date the content was assigned.
     */
    assignedOn: moment.Moment;
    /**
     * A 'due' date for this assigned content, for scheduling content
     * in advance. Content will not be actively pushed to students until
     * this date.
     */
    activeOn: moment.Moment;
    courseID: string;
}

interface DataLayerResult {
    status: Status;
    message: string;
    id?: string;
}

/**
 *
 */
interface ContentNavigationStrategyData extends SkuilderCourseData {
    _id: `${typeof DocTypePrefixes[DocType.NAVIGATION_STRATEGY]}-${string}`;
    docType: DocType.NAVIGATION_STRATEGY;
    name: string;
    description: string;
    /**
     The name of the class that implements the navigation strategy at runtime.
     */
    implementingClass: string;
    /**
     A representation of the strategy's parameterization - to be deserialized
     by the implementing class's constructor at runtime.
    */
    serializedData: string;
}

/**
 * A NavigationStrategyManager is an entity which may contain multiple strategies.
 *
 * This interface defines strategy CRUD.
 */
interface NavigationStrategyManager {
    /**
     * Get the navigation strategy for a given course
     * @returns The navigation strategy for the course
     */
    getNavigationStrategy(id: string): Promise<ContentNavigationStrategyData>;
    /**
     * Get all available navigation strategies
     * @returns An array of all available navigation strategies
     */
    getAllNavigationStrategies(): Promise<ContentNavigationStrategyData[]>;
    /**
     * Add a new navigation strategy
     * @param data The data for the new navigation strategy
     * @returns A promise that resolves when the strategy has been added
     */
    addNavigationStrategy(data: ContentNavigationStrategyData): Promise<void>;
    /**
     * Update an existing navigation strategy
     * @param id The ID of the navigation strategy to update
     * @param data The new data for the navigation strategy
     * @returns A promise that resolves when the update is complete
     */
    updateNavigationStrategy(id: string, data: ContentNavigationStrategyData): Promise<void>;
}

/**
 * Course content and management
 */
interface CoursesDBInterface {
    /**
     * Get course config
     */
    getCourseConfig(courseId: string): Promise<CourseConfig>;
    /**
     * Get a list of all courses
     */
    getCourseList(): Promise<CourseConfig[]>;
    disambiguateCourse(courseId: string, disambiguator: string): Promise<void>;
}
interface CourseInfo {
    cardCount: number;
    registeredUsers: number;
}
interface CourseDBInterface extends NavigationStrategyManager, StudyContentSource {
    /**
     * Get course config
     */
    getCourseConfig(): Promise<CourseConfig>;
    getCourseID(): string;
    /**
     * Set course config
     */
    updateCourseConfig(cfg: CourseConfig): Promise<PouchDB.Core.Response>;
    getCourseInfo(): Promise<CourseInfo>;
    getCourseDoc<T extends SkuilderCourseData$1>(id: string, options?: PouchDB.Core.GetOptions): Promise<T>;
    getCourseDocs<T extends SkuilderCourseData$1>(ids: string[], options?: PouchDB.Core.AllDocsOptions): Promise<PouchDB.Core.AllDocsWithKeysResponse<{} & T>>;
    /**
     * Get cards sorted by ELO rating
     */
    getCardsByELO(elo: number, limit?: number): Promise<{
        courseID: string;
        cardID: string;
        elo?: number;
    }[]>;
    /**
     * Get ELO data for specific cards
     */
    getCardEloData(cardIds: string[]): Promise<CourseElo[]>;
    /**
     * Update card ELO rating
     */
    updateCardElo(cardId: string, elo: CourseElo): Promise<PouchDB.Core.Response>;
    /**
     * Get cards centered at a particular ELO rating
     */
    getCardsCenteredAtELO(options: {
        limit: number;
        elo: 'user' | 'random' | number;
    }, filter?: (card: QualifiedCardID) => boolean): Promise<StudySessionItem[]>;
    /**
     * Get tags for a card
     */
    getAppliedTags(cardId: string): Promise<PouchDB.Query.Response<TagStub>>;
    /**
     * Get tags for multiple cards in a single batch query.
     * More efficient than calling getAppliedTags() for each card.
     *
     * This method reduces redundant database operations when multiple filters
     * need tag data for the same cards. The Pipeline uses this to pre-hydrate
     * tags on WeightedCard objects before filters run.
     *
     * @param cardIds - Array of card IDs to fetch tags for
     * @returns Map from cardId to array of tag names
     */
    getAppliedTagsBatch(cardIds: string[]): Promise<Map<string, string[]>>;
    /**
     * Add a tag to a card
     */
    addTagToCard(cardId: string, tagId: string, updateELO?: boolean): Promise<PouchDB.Core.Response>;
    /**
     * Remove a tag from a card
     */
    removeTagFromCard(cardId: string, tagId: string): Promise<PouchDB.Core.Response>;
    /**
     * Create a new tag
     */
    createTag(tagName: string, author: string): Promise<PouchDB.Core.Response>;
    /**
     * Get a tag by name
     */
    getTag(tagName: string): Promise<Tag>;
    /**
     * Update a tag
     */
    updateTag(tag: Tag): Promise<PouchDB.Core.Response>;
    /**
     * Get all tag stubs for a course
     */
    getCourseTagStubs(): Promise<PouchDB.Core.AllDocsResponse<Tag>>;
    /**
     * Add a note to the course
     */
    addNote(codeCourse: string, shape: DataShape, data: unknown, author: string, tags: string[], uploads?: {
        [key: string]: PouchDB.Core.FullAttachment;
    }, elo?: CourseElo): Promise<DataLayerResult>;
    removeCard(cardId: string): Promise<PouchDB.Core.Response>;
    getInexperiencedCards(): Promise<{
        courseId: string;
        cardId: string;
        count: number;
        elo: CourseElo;
    }[]>;
    /**
     * Search for cards by text content
     * @param query Text to search for
     * @returns Array of matching card data
     */
    searchCards(query: string): Promise<any[]>;
    /**
     * Find documents using PouchDB query syntax
     * @param request PouchDB find request
     * @returns Query response
     */
    find(request: PouchDB.Find.FindRequest<any>): Promise<PouchDB.Find.FindResponse<any>>;
}

interface SessionTrackingData {
    peekSessionCount: number;
    studySessionCount: number;
    sessionCount: number;
    firstSessionDate: string;
    lastSessionDate: string;
    signupPrompted: boolean;
    promptDismissalCount: number;
    studyModeAcknowledged: boolean;
}
interface UserConfig {
    darkMode: boolean;
    likesConfetti: boolean;
    sessionTimeLimit: number;
    email?: string;
    sessionTracking?: Record<string, SessionTrackingData>;
}
interface ActivityRecord {
    timeStamp: number | string;
    [key: string]: any;
}
interface CourseRegistration {
    status?: 'active' | 'dropped' | 'maintenance-mode' | 'preview';
    courseID: string;
    admin: boolean;
    moderator: boolean;
    user: boolean;
    settings?: {
        [setting: string]: string | number | boolean;
    };
    elo: number | CourseElo;
}
interface StudyWeights {
    [courseID: string]: number;
}
interface CourseRegistrationDoc {
    courses: CourseRegistration[];
    studyWeight: StudyWeights;
}
interface ScheduledCard {
    _id: PouchDB.Core.DocumentId;
    /**
     * The docID of the card to be reviewed
     */
    cardId: PouchDB.Core.DocumentId;
    /**
     * The ID of the course
     */
    courseId: string;
    /**
     * The time at which the card becomes eligible for review.
     *
     * (Should probably be UTC adjusted so that performance is
     * not wonky across time zones)
     *
     * Note: Stored as ISO string for PouchDB serialization compatibility,
     * but can be consumed as Moment objects via moment.utc(reviewTime)
     */
    reviewTime: string | Moment;
    /**
     * The time at which this scheduled event was created.
     *
     * Note: Stored as ISO string for PouchDB serialization compatibility,
     * but can be consumed as Moment objects via moment.utc(scheduledAt)
     */
    scheduledAt: string | Moment;
    /**
     * Classifying whether this card is scheduled on behalf of a
     * user-registered course or by as assigned content from a
     * user-registered classroom
     */
    scheduledFor: 'course' | 'classroom';
    /**
     * The ID of the course or classroom that requested this card
     */
    schedulingAgentId: string;
}

type Update<T> = Partial<T> | ((x: T) => T);

interface DocumentUpdater {
    update<T extends PouchDB.Core.Document<object>>(id: string, update: Update<T>): Promise<T>;
}
/**
 * Returns the minimum number of seconds that should pass before a
 * card is redisplayed for review / practice.
 *
 * @param cardHistory The user's history working with the given card
 */
declare function newInterval(user: DocumentUpdater, cardHistory: CardHistory<CardRecord>): number;

/**
 * Read-only user data operations
 */
interface UserDBReader {
    get<T>(id: string): Promise<T & PouchDB.Core.RevisionIdMeta>;
    getUsername(): string;
    isLoggedIn(): boolean;
    /**
     * Get user configuration
     */
    getConfig(): Promise<UserConfig>;
    /**
     * Get cards that the user has seen
     */
    getSeenCards(courseId?: string): Promise<string[]>;
    /**
     * Get cards that are actively scheduled for review
     */
    getActiveCards(): Promise<QualifiedCardID[]>;
    /**
     * Get user's course registrations
     */
    getCourseRegistrationsDoc(): Promise<CourseRegistrationDoc>;
    /**
     * Get the registration doc for a specific course.
     * @param courseId
     */
    getCourseRegDoc(courseId: string): Promise<CourseRegistration>;
    /**
     * Get user's active courses
     */
    getActiveCourses(): Promise<CourseRegistration[]>;
    /**
     * Get user's pending reviews
     */
    getPendingReviews(courseId?: string): Promise<ScheduledCard[]>;
    getActivityRecords(): Promise<ActivityRecord[]>;
    /**
     * Get strategy-specific state for a course.
     *
     * Strategies use this to persist preferences, learned patterns, or temporal
     * tracking data across sessions. Each strategy owns its own namespace.
     *
     * @param courseId - The course this state applies to
     * @param strategyKey - Unique key identifying the strategy (typically class name)
     * @returns The strategy's data payload, or null if no state exists
     */
    getStrategyState<T>(courseId: string, strategyKey: string): Promise<T | null>;
    /**
     * Get user's classroom registrations
     */
    getUserClassrooms(): Promise<ClassroomRegistrationDoc>;
    /**
     * Get user's active classes
     */
    getActiveClasses(): Promise<string[]>;
    getCourseInterface(courseId: string): Promise<UsrCrsDataInterface>;
}
/**
 * User data mutation operations
 */
interface UserDBWriter extends DocumentUpdater {
    /**
     * Update user configuration
     */
    setConfig(config: Partial<UserConfig>): Promise<void>;
    /**
     * Record a user's interaction with a card
     */
    putCardRecord<T extends CardRecord>(record: T): Promise<CardHistory<CardRecord>>;
    /**
     * Register user for a course
     */
    registerForCourse(courseId: string, previewMode?: boolean): Promise<PouchDB.Core.Response>;
    /**
     * Drop a course registration
     */
    dropCourse(courseId: string, dropStatus?: string): Promise<PouchDB.Core.Response>;
    /**
     * Schedule a card for review
     */
    scheduleCardReview(review: {
        user: string;
        course_id: string;
        card_id: string;
        time: Moment;
        scheduledFor: 'course' | 'classroom';
        schedulingAgentId: string;
    }): Promise<void>;
    /**
     * Remove a scheduled card review
     */
    removeScheduledCardReview(reviewId: string): Promise<void>;
    /**
     * Register user for a classroom
     */
    registerForClassroom(classId: string, registerAs: 'student' | 'teacher' | 'aide' | 'admin'): Promise<PouchDB.Core.Response>;
    /**
     * Drop user from classroom
     */
    dropFromClassroom(classId: string): Promise<PouchDB.Core.Response>;
    /**
     * Update user's ELO rating for a course
     */
    updateUserElo(courseId: string, elo: CourseElo): Promise<PouchDB.Core.Response>;
    /**
     * Reset all user data (progress, registrations, etc.) while preserving authentication
     */
    resetUserData(): Promise<{
        status: Status;
        error?: string;
    }>;
    /**
     * Store strategy-specific state for a course.
     *
     * Strategies use this to persist preferences, learned patterns, or temporal
     * tracking data across sessions. Each strategy owns its own namespace.
     *
     * @param courseId - The course this state applies to
     * @param strategyKey - Unique key identifying the strategy (typically class name)
     * @param data - The strategy's data payload to store
     */
    putStrategyState<T>(courseId: string, strategyKey: string, data: T): Promise<void>;
    /**
     * Delete strategy-specific state for a course.
     *
     * @param courseId - The course this state applies to
     * @param strategyKey - Unique key identifying the strategy (typically class name)
     */
    deleteStrategyState(courseId: string, strategyKey: string): Promise<void>;
}
/**
 * Authentication and account management operations
 */
interface UserDBAuthenticator {
    /**
     * Create a new user account
     */
    createAccount(username: string, password: string): Promise<{
        status: Status;
        error: string;
    }>;
    /**
     * Log in as a user
     */
    login(username: string, password: string): Promise<{
        ok: boolean;
        name?: string;
        roles?: string[];
    }>;
    /**
     * Log out the current user
     */
    logout(): Promise<{
        ok: boolean;
    }>;
}
/**
 * Complete user database interface - combines all user operations
 * This maintains backward compatibility with existing code
 */
interface UserDBInterface extends UserDBReader, UserDBWriter, UserDBAuthenticator {
}
interface UserCourseSettings {
    [setting: string]: string | number | boolean;
}
interface UserCourseSetting {
    key: string;
    value: string | number | boolean;
}
interface UsrCrsDataInterface {
    getScheduledReviewCount(): Promise<number>;
    getCourseSettings(): Promise<UserCourseSettings>;
    updateCourseSettings(updates: UserCourseSetting[]): void;
}
type ClassroomRegistrationDesignation = 'student' | 'teacher' | 'aide' | 'admin';
interface ClassroomRegistration {
    classID: string;
    registeredAs: ClassroomRegistrationDesignation;
}
interface ClassroomRegistrationDoc {
    registrations: ClassroomRegistration[];
}

/**
 * Tracks a single strategy's contribution to a card's final score.
 *
 * Each strategy in the pipeline adds a StrategyContribution entry to the
 * card's provenance array, creating an audit trail of scoring decisions.
 */
interface StrategyContribution {
    /**
     * Strategy type (implementing class name).
     * Examples: 'elo', 'hierarchyDefinition', 'interferenceMitigator'
     */
    strategy: string;
    /**
     * Human-readable name identifying this specific strategy instance.
     * Extracted from ContentNavigationStrategyData.name.
     * Courses may have multiple instances of the same strategy type with
     * different configurations.
     *
     * Examples:
     * - "ELO (default)"
     * - "Interference: b/d/p confusion"
     * - "Interference: phonetic confusables"
     * - "Priority: Common letters first"
     */
    strategyName: string;
    /**
     * Unique database document ID for this strategy instance.
     * Extracted from ContentNavigationStrategyData._id.
     * Use this to fetch the full strategy configuration document.
     *
     * Examples:
     * - "NAVIGATION_STRATEGY-ELO-default"
     * - "NAVIGATION_STRATEGY-interference-bdp"
     * - "NAVIGATION_STRATEGY-priority-common-letters"
     */
    strategyId: string;
    /**
     * What the strategy did:
     * - 'generated': Strategy produced this card (generators only)
     * - 'passed': Strategy evaluated but didn't change score (transparent pass-through)
     * - 'boosted': Strategy increased the score
     * - 'penalized': Strategy decreased the score
     */
    action: 'generated' | 'passed' | 'boosted' | 'penalized';
    /** Score after this strategy's processing */
    score: number;
    /**
     * Human-readable explanation of the strategy's decision.
     *
     * Examples:
     * - "ELO distance 75, new card"
     * - "Prerequisites met: letter-sounds"
     * - "Interferes with immature tag 'd' (decay 0.8)"
     * - "High-priority tag 's' (0.95) → boost 1.15x"
     *
     * Required for transparency - silent adjusters are anti-patterns.
     */
    reason: string;
}
/**
 * A card with a suitability score and provenance trail.
 *
 * Scores range from 0-1:
 * - 1.0 = fully suitable
 * - 0.0 = hard filter (e.g., prerequisite not met)
 * - 0.5 = neutral
 * - Intermediate values = soft preference
 *
 * Provenance tracks the scoring pipeline:
 * - First entry: Generator that produced the card
 * - Subsequent entries: Filters that transformed the score
 * - Each entry includes action and human-readable reason
 */
interface WeightedCard {
    cardId: string;
    courseId: string;
    /** Suitability score from 0-1 */
    score: number;
    /**
     * Audit trail of strategy contributions.
     * First entry is from the generator, subsequent entries from filters.
     */
    provenance: StrategyContribution[];
    /**
     * Pre-fetched tags. Populated by Pipeline before filters run.
     * Filters should use this instead of querying getAppliedTags() individually.
     */
    tags?: string[];
    /**
     * Review document ID (_id from ScheduledCard).
     * Present when this card originated from SRS review scheduling.
     * Used by SessionController to track review outcomes and maintain review state.
     */
    reviewID?: string;
}
/**
 * Extract card origin from provenance trail.
 *
 * The first provenance entry (from the generator) indicates whether
 * this is a new card, review, or failed card. We parse the reason
 * string to extract this information.
 *
 * @param card - Card with provenance trail
 * @returns Card origin ('new', 'review', or 'failed')
 */
declare function getCardOrigin(card: WeightedCard): 'new' | 'review' | 'failed';
declare enum Navigators {
    ELO = "elo",
    SRS = "srs",
    HIERARCHY = "hierarchyDefinition",
    INTERFERENCE = "interferenceMitigator",
    RELATIVE_PRIORITY = "relativePriority",
    USER_TAG_PREFERENCE = "userTagPreference"
}
/**
 * Role classification for navigation strategies.
 *
 * - GENERATOR: Produces candidate cards with initial scores
 * - FILTER: Transforms cards with score multipliers
 */
declare enum NavigatorRole {
    GENERATOR = "generator",
    FILTER = "filter"
}
/**
 * Registry mapping navigator implementations to their roles.
 */
declare const NavigatorRoles: Record<Navigators, NavigatorRole>;
/**
 * Check if a navigator implementation is a generator.
 *
 * @param impl - Navigator implementation name (e.g., 'elo', 'hierarchyDefinition')
 * @returns true if the navigator is a generator, false otherwise
 */
declare function isGenerator(impl: string): boolean;
/**
 * Check if a navigator implementation is a filter.
 *
 * @param impl - Navigator implementation name (e.g., 'elo', 'hierarchyDefinition')
 * @returns true if the navigator is a filter, false otherwise
 */
declare function isFilter(impl: string): boolean;
/**
 * Abstract base class for navigation strategies.
 *
 * This class exists primarily for backward compatibility with legacy code.
 * New code should use CardGenerator or CardFilter interfaces directly.
 *
 * The class implements StudyContentSource for compatibility with SessionController.
 * Once SessionController migrates to use getWeightedCards() exclusively,
 * the legacy methods can be removed.
 */
declare abstract class ContentNavigator implements StudyContentSource {
    /** User interface for this navigation session */
    protected user: UserDBInterface;
    /** Course interface for this navigation session */
    protected course: CourseDBInterface;
    /** Human-readable name for this strategy instance (from ContentNavigationStrategyData.name) */
    protected strategyName?: string;
    /** Unique document ID for this strategy instance (from ContentNavigationStrategyData._id) */
    protected strategyId?: string;
    /**
     * Constructor for standard navigators.
     * Call this from subclass constructors to initialize common fields.
     *
     * Note: CompositeGenerator and Pipeline call super() without args, then set
     * user/course fields directly if needed.
     */
    constructor(user?: UserDBInterface, course?: CourseDBInterface, strategyData?: ContentNavigationStrategyData);
    /**
     * Unique key identifying this strategy for state storage.
     *
     * Defaults to the constructor name (e.g., "UserTagPreferenceFilter").
     * Override in subclasses if multiple instances of the same strategy type
     * need separate state storage.
     */
    protected get strategyKey(): string;
    /**
     * Get this strategy's persisted state for the current course.
     *
     * @returns The strategy's data payload, or null if no state exists
     * @throws Error if user or course is not initialized
     */
    protected getStrategyState<T>(): Promise<T | null>;
    /**
     * Persist this strategy's state for the current course.
     *
     * @param data - The strategy's data payload to store
     * @throws Error if user or course is not initialized
     */
    protected putStrategyState<T>(data: T): Promise<void>;
    /**
     * Factory method to create navigator instances dynamically.
     *
     * @param user - User interface
     * @param course - Course interface
     * @param strategyData - Strategy configuration document
     * @returns the runtime object used to steer a study session.
     */
    static create(user: UserDBInterface, course: CourseDBInterface, strategyData: ContentNavigationStrategyData): Promise<ContentNavigator>;
    /**
     * Get cards with suitability scores and provenance trails.
     *
     * **This is the PRIMARY API for navigation strategies.**
     *
     * Returns cards ranked by suitability score (0-1). Higher scores indicate
     * better candidates for presentation. Each card includes a provenance trail
     * documenting how strategies contributed to the final score.
     *
     * ## Implementation Required
     * All navigation strategies MUST override this method. The base class does
     * not provide a default implementation.
     *
     * ## For Generators
     * Override this method to generate candidates and compute scores based on
     * your strategy's logic (e.g., ELO proximity, review urgency). Create the
     * initial provenance entry with action='generated'.
     *
     * ## For Filters
     * Filters should implement the CardFilter interface instead and be composed
     * via Pipeline. Filters do not directly implement getWeightedCards().
     *
     * @param limit - Maximum cards to return
     * @returns Cards sorted by score descending, with provenance trails
     */
    getWeightedCards(_limit: number): Promise<WeightedCard[]>;
}

type StudySessionFailedItem = StudySessionFailedNewItem | StudySessionFailedReviewItem;
interface StudySessionFailedNewItem extends StudySessionItem {
    status: 'failed-new';
}
interface StudySessionFailedReviewItem extends StudySessionReviewItem {
    status: 'failed-review';
}
interface StudySessionNewItem extends StudySessionItem {
    status: 'new';
}
interface StudySessionReviewItem extends StudySessionItem {
    reviewID: string;
    status: 'review' | 'failed-review';
}
declare function isReview(item: StudySessionItem): item is StudySessionReviewItem;
interface StudySessionItem {
    status: 'new' | 'review' | 'failed-new' | 'failed-review';
    contentSourceType: 'course' | 'classroom';
    contentSourceID: string;
    cardID: string;
    courseID: string;
    elo?: number;
}
interface ContentSourceID {
    type: 'course' | 'classroom';
    id: string;
    /**
     * Optional tag filter for scoped study sessions.
     * When present, creates a TagFilteredContentSource instead of a regular course source.
     */
    tagFilter?: TagFilter;
}
/**
 * Interface for sources that provide study content to SessionController.
 *
 * Content sources return scored candidates via getWeightedCards(), which
 * SessionController uses to populate study queues.
 *
 * See: packages/db/docs/navigators-architecture.md
 */
interface StudyContentSource {
    /**
     * Get cards with suitability scores for presentation.
     *
     * Returns unified scored candidates that can be sorted and selected by SessionController.
     * The card origin ('new' | 'review' | 'failed') is determined by provenance metadata.
     *
     * @param limit - Maximum number of cards to return
     * @returns Cards sorted by score descending
     */
    getWeightedCards(limit: number): Promise<WeightedCard[]>;
}
declare function getStudySource(source: ContentSourceID, user: UserDBInterface): Promise<StudyContentSource>;

export { type AdminDBInterface as A, type UsrCrsDataInterface as B, type CourseDBInterface as C, type DataLayerResult as D, type ClassroomRegistrationDesignation as E, type ClassroomRegistration as F, type ClassroomRegistrationDoc as G, type SessionTrackingData as H, type UserConfig as I, type ActivityRecord as J, type CourseRegistration as K, type StrategyContribution as L, getCardOrigin as M, Navigators as N, NavigatorRole as O, NavigatorRoles as P, isGenerator as Q, isFilter as R, type StudySessionItem as S, type TeacherClassroomDBInterface as T, type UserDBInterface as U, type DocumentUpdater as V, type WeightedCard as W, newInterval as X, type UserDBReader as a, type CoursesDBInterface as b, type ClassroomDBInterface as c, type CourseInfo as d, type ContentNavigationStrategyData as e, ContentNavigator as f, type AssignedContent as g, type StudyContentSource as h, type StudentClassroomDBInterface as i, type ScheduledCard as j, type StudySessionFailedItem as k, type StudySessionFailedNewItem as l, type StudySessionFailedReviewItem as m, type StudySessionNewItem as n, type StudySessionReviewItem as o, isReview as p, type ContentSourceID as q, getStudySource as r, type CourseRegistrationDoc as s, type AssignedTag as t, type AssignedCourse as u, type AssignedCard as v, type UserDBWriter as w, type UserDBAuthenticator as x, type UserCourseSettings as y, type UserCourseSetting as z };
