@speakableio/core 0.1.64 → 0.1.65

package/dist/index.web.d.mts

@@ -30,142 +30,492 @@ interface FirestoreHelpers {
 type CustomTimestamp = Timestamp | Timestamp$1;
 type CallableFunction<T = any, R = any> = (data: T) => Promise<R>;
 
-interface Assignment {
-    name: string;
-    description: string;
-    scheduledTime?: string | null;
-    dueTime?: {
-        hours: number;
-        minutes: number;
-        nanos: number;
-    };
-    speakableio: boolean;
-    owners: string[];
-    image: {
-        path: string | null;
-        url: string;
-    };
-    dueDate: {
-        day: number;
-        month: number;
-        year: number;
-    };
-    teacherName: string;
-    courseWorkId: string | null;
-    dueDateTimestamp: CustomTimestamp;
-    scheduledTimeTimestamp: number;
-    active: boolean;
-    voice: string | null;
-    setId: string;
-    dateMade: {
-        seconds: number;
-        nanoseconds: number;
-    };
-    maxPoints: number;
-    courseId: string;
-    isAssessment: boolean;
-    isAvailable: boolean;
-    ltiDeeplink?: string;
-    content?: string[];
-    weights?: Record<string, number>;
-    language?: string;
+declare const enum FeedbackTypesCard {
+    SuggestedResponse = "suggested_response",
+    Wida = "wida",
+    GrammarInsights = "grammar_insights",
+    Actfl = "actfl",
+    ProficiencyLevel = "proficiency_level"
 }
-interface AssignmentWithId extends Assignment {
-    id: string;
-    isAvailable: boolean;
-    scores?: unknown;
+declare const enum LeniencyCard {
+    CONFIDENCE = "confidence",
+    EASY = "easy",
+    NORMAL = "normal",
+    HARD = "hard"
 }
-interface Score {
-    userId: string;
-    owners: string[];
-    progress: number;
-    score: number;
-    cards?: {
-        [cardId: string]: CardScore;
-    };
-    courseId?: string;
-    firstLoad?: boolean;
-    googleClassroomUserId?: string;
-    skippedCards?: number;
-    lastPlayed?: CustomTimestamp;
-    startDate?: CustomTimestamp;
-    submissionDate?: CustomTimestamp;
-    status?: 'SUBMITTED' | 'PENDING_REVIEW' | 'IN_PROGRESS' | 'FINALIZED';
-    submitted?: boolean;
-    successfulCards?: number;
-    total_voiceSuccess?: number;
-    total_voice_attempts?: number;
-    total_words_spoken?: number;
-    history?: CardScore[];
-    attempts?: number;
-    assignmentId?: string;
-    setId?: string;
+declare const LENIENCY_OPTIONS: {
+    label: string;
+    value: LeniencyCard;
+}[];
+declare const STUDENT_LEVELS_OPTIONS: {
+    label: string;
+    description: string;
+    value: string;
+}[];
+declare const BASE_RESPOND_FIELD_VALUES: {
+    title: string;
+    allowRetries: boolean;
+    respondTime: number;
+    maxCharacters: number;
+};
+declare const BASE_REPEAT_FIELD_VALUES: {
+    repeat: number;
+};
+declare const BASE_MULTIPLE_CHOICE_FIELD_VALUES: {
+    MCQType: string;
+    answer: string[];
+    choices: {
+        option: string;
+        value: string;
+    }[];
+};
+declare const enum VerificationCardStatus {
+    VERIFIED = "VERIFIED",
+    WARNING = "WARNING",
+    NOT_RECOMMENDED = "NOT_RECOMMENDED",
+    NOT_WORKING = "NOT_WORKING",
+    NOT_CHECKED = "NOT_CHECKED"
 }
-interface ScoreWithId extends Score {
+declare const CARDS_COLLECTION = "flashcards";
+type RefsCardsFiresotre = `${typeof CARDS_COLLECTION}/${string}`;
+declare const refsCardsFiresotre: {
+    allCards: string;
+    card: (id: string) => `flashcards/${string}`;
+};
+
+interface PageActivityWithId extends PageActivity {
     id: string;
 }
-interface CardScore {
-    voiceSuccess?: number;
-    voiceAttempts?: number;
-    voiceFail?: number;
+interface PageActivity {
+    owners: string[];
+    checked?: boolean;
     completed?: boolean;
-    attempts?: number;
-    correct?: number;
-    success?: boolean;
-    aiSuccess?: boolean;
-    grading_method?: 'simple' | 'rubric' | 'manual' | 'standards_based';
-    grammar_insights?: {
-        type?: string;
-        justification?: string;
-        error?: boolean;
-        correction?: string;
-    }[];
-    promptSuccess?: boolean;
+    media_area_id?: string | null;
+    media_area_layout?: 'left' | 'right' | null;
     score?: number;
-    simple_grading?: {
-        justification?: string;
-        success?: boolean;
-    };
-    suggested_response?: string;
-    summary?: string;
-    transcript?: string;
-    errors?: any;
-    improvedResponse?: string;
-    audio?: string;
-    actfl?: {
-        justification: string;
-        level: string;
-    };
-    wida?: {
-        justification: string;
-        level: string;
+    verificationStatus?: VerificationCardStatus;
+    native_text?: string;
+    repeat?: number;
+    language?: string | null;
+    image?: {
+        path?: string | null;
+        url?: string;
     };
-    earned_points?: number;
-    fileName?: string;
-    max_points?: number;
+    audio?: {
+        path?: string | null;
+        url?: string;
+    } | null;
+    notes?: string;
+    difficulty?: string;
+    default_language?: string;
+    target_text?: string;
+    type: ActivityPageType;
+    grading_criteria?: string;
+    scoring_type?: string;
+    grading_method?: 'simple' | 'rubric' | 'manual' | 'standards_based';
+    feedback_types?: string[];
+    rubricId?: string;
+    prompt?: string;
+    title?: string;
     passing_score?: number;
-    rubric?: {
-        description: string;
-        justification: string;
-        maxPoints: number;
-        score: number;
-        score_title: string;
-        title: string;
+    maxCharacters?: number;
+    answer?: string[];
+    choices?: {
+        value: string;
+        option: string;
     }[];
-    scoring_type?: string;
-    history?: CardScore[];
-    media_area_opened?: boolean;
-    noFeedbackAvailable?: boolean;
-    proficiency_level?: {
-        standardId: string;
-        level: string;
-        justification: string;
-        key_indicators?: string[];
-    };
-    status?: string;
+    MCQType?: string;
+    multipleAttemptsAllowed?: boolean;
+    allowRetries?: boolean;
+    question?: string;
+    respondTime?: number;
+    hidePrompt?: boolean;
+    videoUrl?: string;
+    link?: string;
+    text?: string;
+    isListenAloud?: boolean;
+    embedCode?: string;
+    attempt?: number;
+    correct?: number;
+    autoGrade?: boolean;
+    points?: number;
+    shuffle?: boolean;
+    translation?: string;
+    includeAIContext?: boolean;
+    media_area_context_ref?: string | null;
+    standardId?: string;
+    target_proficiency_level?: string;
+    allowTTS?: boolean;
+}
+declare const enum ActivityPageType {
+    READ_REPEAT = "READ_REPEAT",
+    VIDEO = "VIDEO",
+    TEXT = "TEXT",
+    READ_RESPOND = "READ_RESPOND",
+    FREE_RESPONSE = "FREE_RESPONSE",
+    REPEAT = "REPEAT",
+    RESPOND = "RESPOND",
+    RESPOND_WRITE = "RESPOND_WRITE",
+    TEXT_TO_SPEECH = "TEXT_TO_SPEECH",
+    MULTIPLE_CHOICE = "MULTIPLE_CHOICE",
+    PODCAST = "PODCAST",
+    MEDIA_PAGE = "MEDIA_PAGE",
+    WRITE = "WRITE",
+    SHORT_ANSWER = "SHORT_ANSWER",
+    SHORT_STORY = "SHORT_STORY",
+    SPEAK = "SPEAK",
+    CONVERSATION = "CONVERSATION",
+    CONVERSATION_WRITE = "CONVERSATION_WRITE",
+    DIALOGUE = "DIALOGUE",
+    INSTRUCTION = "INSTRUCTION",
+    LISTEN = "LISTEN",
+    READ = "READ",
+    ANSWER = "ANSWER"
 }
+declare const RESPOND_PAGE_ACTIVITY_TYPES: ActivityPageType[];
+declare const MULTIPLE_CHOICE_PAGE_ACTIVITY_TYPES: ActivityPageType[];
+declare const REPEAT_PAGE_ACTIVITY_TYPES: ActivityPageType[];
+declare const RESPOND_WRITE_PAGE_ACTIVITY_TYPES: ActivityPageType[];
+declare const RESPOND_AUDIO_PAGE_ACTIVITY_TYPES: ActivityPageType[];
 
-declare const enum AssignmentAnalyticsType {
+declare const cardsQueryKeys: {
+    all: string[];
+    one: (params: {
+        cardId: string;
+    }) => string[];
+};
+declare function useCards({ cardIds, enabled, asObject, }: {
+    cardIds: string[];
+    enabled: boolean;
+    asObject?: boolean;
+}): {
+    cards: PageActivityWithId[];
+    cardsObject: Record<string, PageActivityWithId> | null;
+    cardsQueries: _tanstack_react_query.UseQueryResult<PageActivityWithId | null, Error>[];
+};
+declare function useCreateCard(): {
+    mutationCreateCard: _tanstack_react_query.UseMutationResult<{
+        id: string;
+    } & Partial<PageActivity>, Error, {
+        data: Partial<PageActivity>;
+    }, unknown>;
+};
+declare function useCreateCards(): {
+    mutationCreateCards: _tanstack_react_query.UseMutationResult<{
+        id: string;
+        owners: string[];
+        checked?: boolean;
+        completed?: boolean;
+        media_area_id?: string | null;
+        media_area_layout?: "left" | "right" | null;
+        score?: number;
+        verificationStatus?: VerificationCardStatus;
+        native_text?: string;
+        repeat?: number;
+        language?: string | null;
+        image?: {
+            path?: string | null;
+            url?: string;
+        };
+        audio?: {
+            path?: string | null;
+            url?: string;
+        } | null;
+        notes?: string;
+        difficulty?: string;
+        default_language?: string;
+        target_text?: string;
+        type: ActivityPageType;
+        grading_criteria?: string;
+        scoring_type?: string;
+        grading_method?: "simple" | "rubric" | "manual" | "standards_based";
+        feedback_types?: string[];
+        rubricId?: string;
+        prompt?: string;
+        title?: string;
+        passing_score?: number;
+        maxCharacters?: number;
+        answer?: string[];
+        choices?: {
+            value: string;
+            option: string;
+        }[];
+        MCQType?: string;
+        multipleAttemptsAllowed?: boolean;
+        allowRetries?: boolean;
+        question?: string;
+        respondTime?: number;
+        hidePrompt?: boolean;
+        videoUrl?: string;
+        link?: string;
+        text?: string;
+        isListenAloud?: boolean;
+        embedCode?: string;
+        attempt?: number;
+        correct?: number;
+        autoGrade?: boolean;
+        points?: number;
+        shuffle?: boolean;
+        translation?: string;
+        includeAIContext?: boolean;
+        media_area_context_ref?: string | null;
+        standardId?: string;
+        target_proficiency_level?: string;
+        allowTTS?: boolean;
+    }[], Error, {
+        cards: PageActivity[];
+    }, unknown>;
+};
+declare function getCardFromCache({ cardId, queryClient, }: {
+    cardId: string;
+    queryClient: QueryClient;
+}): PageActivityWithId | undefined;
+declare function updateCardInCache({ cardId, card, queryClient, }: {
+    cardId: string;
+    card: PageActivityWithId | null;
+    queryClient: QueryClient;
+}): void;
+declare function useGetCard({ cardId, enabled }: {
+    cardId: string;
+    enabled?: boolean;
+}): _tanstack_react_query.UseQueryResult<PageActivityWithId | null, Error>;
+
+declare const createCardRepo: () => {
+    createCard: (args_0: {
+        data: Partial<PageActivity>;
+    }) => Promise<{
+        id: string;
+    } & Partial<PageActivity>>;
+    createCards: (args_0: {
+        cards: PageActivity[];
+    }) => Promise<{
+        id: string;
+        owners: string[];
+        checked?: boolean;
+        completed?: boolean;
+        media_area_id?: string | null;
+        media_area_layout?: "left" | "right" | null;
+        score?: number;
+        verificationStatus?: VerificationCardStatus;
+        native_text?: string;
+        repeat?: number;
+        language?: string | null;
+        image?: {
+            path?: string | null;
+            url?: string;
+        };
+        audio?: {
+            path?: string | null;
+            url?: string;
+        } | null;
+        notes?: string;
+        difficulty?: string;
+        default_language?: string;
+        target_text?: string;
+        type: ActivityPageType;
+        grading_criteria?: string;
+        scoring_type?: string;
+        grading_method?: "simple" | "rubric" | "manual" | "standards_based";
+        feedback_types?: string[];
+        rubricId?: string;
+        prompt?: string;
+        title?: string;
+        passing_score?: number;
+        maxCharacters?: number;
+        answer?: string[];
+        choices?: {
+            value: string;
+            option: string;
+        }[];
+        MCQType?: string;
+        multipleAttemptsAllowed?: boolean;
+        allowRetries?: boolean;
+        question?: string;
+        respondTime?: number;
+        hidePrompt?: boolean;
+        videoUrl?: string;
+        link?: string;
+        text?: string;
+        isListenAloud?: boolean;
+        embedCode?: string;
+        attempt?: number;
+        correct?: number;
+        autoGrade?: boolean;
+        points?: number;
+        shuffle?: boolean;
+        translation?: string;
+        includeAIContext?: boolean;
+        media_area_context_ref?: string | null;
+        standardId?: string;
+        target_proficiency_level?: string;
+        allowTTS?: boolean;
+    }[]>;
+    getCard: (params: {
+        cardId: string;
+    }) => Promise<PageActivityWithId | null>;
+};
+
+declare function checkIsRepeatPage(cardType: ActivityPageType | undefined): boolean;
+declare function checkIsMCPage(cardType: ActivityPageType | undefined): boolean;
+declare function checkIsRespondPage(cardType: ActivityPageType | undefined): boolean;
+declare function checkIsRespondWrittenPage(cardType: ActivityPageType | undefined): boolean;
+declare function checkIsRespondAudioPage(cardType: ActivityPageType | undefined): boolean;
+declare const checkIsMediaPage: (cardType: ActivityPageType | undefined) => boolean;
+declare const checkIsShortAnswerPage: (cardType: ActivityPageType | undefined) => boolean;
+declare const checkTypePageActivity: (cardType: ActivityPageType | undefined) => {
+    isRespondAudio: boolean;
+    isRespondWritten: boolean;
+    isRespond: boolean;
+    isMC: boolean;
+    isRepeat: boolean;
+    isMediaPage: boolean;
+    isShortAnswer: boolean;
+};
+
+declare function getPagePrompt(card: PageActivityWithId | undefined): {
+    has: boolean;
+    text: string | undefined;
+};
+
+interface Assignment {
+    name: string;
+    description: string;
+    scheduledTime?: string | null;
+    dueTime?: {
+        hours: number;
+        minutes: number;
+        nanos: number;
+    };
+    speakableio: boolean;
+    owners: string[];
+    image: {
+        path: string | null;
+        url: string;
+    };
+    dueDate: {
+        day: number;
+        month: number;
+        year: number;
+    };
+    teacherName: string;
+    courseWorkId: string | null;
+    dueDateTimestamp: CustomTimestamp;
+    scheduledTimeTimestamp: number;
+    active: boolean;
+    voice: string | null;
+    setId: string;
+    dateMade: {
+        seconds: number;
+        nanoseconds: number;
+    };
+    maxPoints: number;
+    courseId: string;
+    isAssessment: boolean;
+    isAvailable: boolean;
+    ltiDeeplink?: string;
+    content?: string[];
+    weights?: Record<string, number>;
+    language?: string;
+    types?: {
+        [key in ActivityPageType]?: number;
+    };
+}
+interface AssignmentWithId extends Assignment {
+    id: string;
+    isAvailable: boolean;
+    scores?: unknown;
+}
+interface Score {
+    userId: string;
+    owners: string[];
+    progress: number;
+    score: number;
+    cards?: {
+        [cardId: string]: PageScore;
+    };
+    courseId?: string;
+    firstLoad?: boolean;
+    googleClassroomUserId?: string;
+    skippedCards?: number;
+    lastPlayed?: CustomTimestamp;
+    startDate?: CustomTimestamp;
+    submissionDate?: CustomTimestamp;
+    status?: 'SUBMITTED' | 'PENDING_REVIEW' | 'IN_PROGRESS' | 'FINALIZED';
+    submitted?: boolean;
+    successfulCards?: number;
+    total_voiceSuccess?: number;
+    total_voice_attempts?: number;
+    total_words_spoken?: number;
+    history?: PageScore[];
+    attempts?: number;
+    assignmentId?: string;
+    setId?: string;
+}
+interface ScoreWithId extends Score {
+    id: string;
+}
+interface PageScore {
+    voiceSuccess?: number;
+    voiceAttempts?: number;
+    voiceFail?: number;
+    completed?: boolean;
+    attempts?: number;
+    correct?: number;
+    success?: boolean;
+    aiSuccess?: boolean;
+    grading_method?: 'simple' | 'rubric' | 'manual' | 'standards_based';
+    grammar_insights?: {
+        type?: string;
+        justification?: string;
+        error?: boolean;
+        correction?: string;
+    }[];
+    promptSuccess?: boolean;
+    score?: number;
+    simple_grading?: {
+        justification?: string;
+        success?: boolean;
+    };
+    suggested_response?: string;
+    summary?: string;
+    transcript?: string;
+    errors?: any;
+    improvedResponse?: string;
+    audio?: string;
+    actfl?: {
+        justification: string;
+        level: string;
+    };
+    wida?: {
+        justification: string;
+        level: string;
+    };
+    earned_points?: number;
+    fileName?: string;
+    max_points?: number;
+    passing_score?: number;
+    rubric?: {
+        description: string;
+        justification: string;
+        maxPoints: number;
+        score: number;
+        score_title: string;
+        title: string;
+    }[];
+    scoring_type?: string;
+    history?: PageScore[];
+    media_area_opened?: boolean;
+    noFeedbackAvailable?: boolean;
+    proficiency_level?: {
+        standardId: string;
+        level: string;
+        justification: string;
+        key_indicators?: string[];
+    };
+    status?: string;
+}
+
+declare const enum AssignmentAnalyticsType {
     Macro = "macro",
     Gradebook = "gradebook",
     Cards = "cards",
@@ -221,6 +571,7 @@ declare const createAssignmentRepo: () => {
         content?: string[];
         weights?: Record<string, number>;
         language?: string;
+        types?: { [key in ActivityPageType]?: number; };
     } | null>;
     attachScoresAssignment: (args_0: {
         assignments: AssignmentWithId[];
@@ -268,6 +619,7 @@ declare const createAssignmentRepo: () => {
         content?: string[];
         weights?: Record<string, number>;
         language?: string;
+        types?: { [key in ActivityPageType]?: number; };
     }[]>;
     getAssignmentScores: (args_0: {
         assignmentId: string;
@@ -334,6 +686,7 @@ declare function useAssignment({ assignmentId, enabled, analyticType, userId, }:
     content?: string[];
     weights?: Record<string, number>;
     language?: string;
+    types?: { [key in ActivityPageType]?: number; };
 } | null, Error>;
 
 declare const scoreQueryKeys: {
@@ -341,435 +694,88 @@ declare const scoreQueryKeys: {
     byId: (id: string) => readonly ["scores", string];
     list: () => readonly ["scores", "list"];
 };
-declare function useScore({ isAssignment, activityId, userId, courseId, enabled, googleClassroomUserId, }: {
-    userId: string;
-    isAssignment: boolean;
-    activityId: string;
-    courseId?: string;
-    enabled?: boolean;
-    googleClassroomUserId?: string;
-}): _tanstack_react_query.UseQueryResult<ScoreWithId, Error>;
-declare function useUpdateScore(): {
-    mutationUpdateScore: _tanstack_react_query.UseMutationResult<Promise<void>, Error, {
-        userId: string;
-        data: Partial<Score>;
-        isAssignment: boolean;
-        activityId: string;
-    }, {
-        previousData: Partial<Score> | undefined;
-    }>;
-};
-declare function useUpdateCardScore({ isAssignment, activityId, userId, cardIds, weights, }: {
-    isAssignment: boolean;
-    userId: string;
-    activityId: string;
-    cardIds: string[];
-    weights: Record<string, number>;
-}): {
-    mutationUpdateCardScore: _tanstack_react_query.UseMutationResult<{
-        cardId: string;
-        scoresUpdated: Score;
-    }, Error, {
-        cardId: string;
-        cardScore: CardScore;
-    }, void>;
-};
-declare function useClearScore(): {
-    mutationClearScore: _tanstack_react_query.UseMutationResult<{
-        update: Partial<Score>;
-        activityId: string;
-    }, Error, {
-        isAssignment: boolean;
-        cardId: string;
-        cardScores: CardScore;
-        userId: string;
-        activityId: string;
-    }, unknown>;
-};
-declare function useSubmitAssignmentScore({ onAssignmentSubmitted, studentName, }: {
-    onAssignmentSubmitted: (assignmentId: string) => void;
-    studentName: string;
-}): {
-    submitAssignmentScore: _tanstack_react_query.UseMutateAsyncFunction<{
-        success: boolean;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        error: unknown;
-        message?: undefined;
-    }, Error, {
-        assignment: AssignmentWithId;
-        userId: string;
-        cardIds: string[];
-        weights: Record<string, number>;
-        scores: Score;
-        status: "FINALIZED" | "IN_PROGRESS" | "PENDING_REVIEW";
-    }, unknown>;
-    isLoading: boolean;
-};
-declare function useSubmitPracticeScore(): {
-    submitPracticeScore: _tanstack_react_query.UseMutateAsyncFunction<{
-        success: boolean;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        error: unknown;
-        message?: undefined;
-    }, Error, {
-        setId: string;
-        userId: string;
-        scores: Score;
-    }, unknown>;
-    isLoading: boolean;
-};
-
-declare const enum FeedbackTypesCard {
-    SuggestedResponse = "suggested_response",
-    Wida = "wida",
-    GrammarInsights = "grammar_insights",
-    Actfl = "actfl",
-    ProficiencyLevel = "proficiency_level"
-}
-declare const enum LeniencyCard {
-    CONFIDENCE = "confidence",
-    EASY = "easy",
-    NORMAL = "normal",
-    HARD = "hard"
-}
-declare const LENIENCY_OPTIONS: {
-    label: string;
-    value: LeniencyCard;
-}[];
-declare const STUDENT_LEVELS_OPTIONS: {
-    label: string;
-    description: string;
-    value: string;
-}[];
-declare const BASE_RESPOND_FIELD_VALUES: {
-    title: string;
-    allowRetries: boolean;
-    respondTime: number;
-    maxCharacters: number;
-};
-declare const BASE_REPEAT_FIELD_VALUES: {
-    repeat: number;
-};
-declare const BASE_MULTIPLE_CHOICE_FIELD_VALUES: {
-    MCQType: string;
-    answer: string[];
-    choices: {
-        option: string;
-        value: string;
-    }[];
-};
-declare const enum VerificationCardStatus {
-    VERIFIED = "VERIFIED",
-    WARNING = "WARNING",
-    NOT_RECOMMENDED = "NOT_RECOMMENDED",
-    NOT_WORKING = "NOT_WORKING",
-    NOT_CHECKED = "NOT_CHECKED"
-}
-declare const CARDS_COLLECTION = "flashcards";
-type RefsCardsFiresotre = `${typeof CARDS_COLLECTION}/${string}`;
-declare const refsCardsFiresotre: {
-    allCards: string;
-    card: (id: string) => `flashcards/${string}`;
-};
-
-interface PageActivityWithId extends PageActivity {
-    id: string;
-}
-interface PageActivity {
-    owners: string[];
-    checked?: boolean;
-    completed?: boolean;
-    media_area_id?: string | null;
-    media_area_layout?: 'left' | 'right' | null;
-    score?: number;
-    verificationStatus?: VerificationCardStatus;
-    native_text?: string;
-    repeat?: number;
-    language?: string | null;
-    image?: {
-        path?: string | null;
-        url?: string;
-    };
-    audio?: {
-        path?: string | null;
-        url?: string;
-    } | null;
-    notes?: string;
-    difficulty?: string;
-    default_language?: string;
-    target_text?: string;
-    type: ActivityPageType;
-    grading_criteria?: string;
-    scoring_type?: string;
-    grading_method?: 'simple' | 'rubric' | 'manual' | 'standards_based';
-    feedback_types?: string[];
-    rubricId?: string;
-    prompt?: string;
-    title?: string;
-    passing_score?: number;
-    maxCharacters?: number;
-    answer?: string[];
-    choices?: {
-        value: string;
-        option: string;
-    }[];
-    MCQType?: string;
-    multipleAttemptsAllowed?: boolean;
-    allowRetries?: boolean;
-    question?: string;
-    respondTime?: number;
-    hidePrompt?: boolean;
-    videoUrl?: string;
-    link?: string;
-    text?: string;
-    isListenAloud?: boolean;
-    embedCode?: string;
-    attempt?: number;
-    correct?: number;
-    autoGrade?: boolean;
-    points?: number;
-    shuffle?: boolean;
-    translation?: string;
-    includeAIContext?: boolean;
-    media_area_context_ref?: string | null;
-    standardId?: string;
-    target_proficiency_level?: string;
-    allowTTS?: boolean;
-}
-declare const enum ActivityPageType {
-    READ_REPEAT = "READ_REPEAT",
-    VIDEO = "VIDEO",
-    TEXT = "TEXT",
-    READ_RESPOND = "READ_RESPOND",
-    FREE_RESPONSE = "FREE_RESPONSE",
-    REPEAT = "REPEAT",
-    RESPOND = "RESPOND",
-    RESPOND_WRITE = "RESPOND_WRITE",
-    TEXT_TO_SPEECH = "TEXT_TO_SPEECH",
-    MULTIPLE_CHOICE = "MULTIPLE_CHOICE",
-    PODCAST = "PODCAST",
-    MEDIA_PAGE = "MEDIA_PAGE",
-    WRITE = "WRITE",
-    SHORT_ANSWER = "SHORT_ANSWER",
-    SHORT_STORY = "SHORT_STORY",
-    SPEAK = "SPEAK",
-    CONVERSATION = "CONVERSATION",
-    CONVERSATION_WRITE = "CONVERSATION_WRITE",
-    DIALOGUE = "DIALOGUE",
-    INSTRUCTION = "INSTRUCTION",
-    LISTEN = "LISTEN",
-    READ = "READ",
-    ANSWER = "ANSWER"
-}
-declare const RESPOND_PAGE_ACTIVITY_TYPES: ActivityPageType[];
-declare const MULTIPLE_CHOICE_PAGE_ACTIVITY_TYPES: ActivityPageType[];
-declare const REPEAT_PAGE_ACTIVITY_TYPES: ActivityPageType[];
-declare const RESPOND_WRITE_PAGE_ACTIVITY_TYPES: ActivityPageType[];
-declare const RESPOND_AUDIO_PAGE_ACTIVITY_TYPES: ActivityPageType[];
-
-declare const cardsQueryKeys: {
-    all: string[];
-    one: (params: {
-        cardId: string;
-    }) => string[];
+declare function useScore({ isAssignment, activityId, userId, courseId, enabled, googleClassroomUserId, }: {
+    userId: string;
+    isAssignment: boolean;
+    activityId: string;
+    courseId?: string;
+    enabled?: boolean;
+    googleClassroomUserId?: string;
+}): _tanstack_react_query.UseQueryResult<ScoreWithId, Error>;
+declare function useUpdateScore(): {
+    mutationUpdateScore: _tanstack_react_query.UseMutationResult<Promise<void>, Error, {
+        userId: string;
+        data: Partial<Score>;
+        isAssignment: boolean;
+        activityId: string;
+    }, {
+        previousData: Partial<Score> | undefined;
+    }>;
 };
-declare function useCards({ cardIds, enabled, asObject, }: {
+declare function useUpdateCardScore({ isAssignment, activityId, userId, cardIds, weights, }: {
+    isAssignment: boolean;
+    userId: string;
+    activityId: string;
     cardIds: string[];
-    enabled: boolean;
-    asObject?: boolean;
+    weights: Record<string, number>;
 }): {
-    cards: PageActivityWithId[];
-    cardsObject: Record<string, PageActivityWithId> | null;
-    cardsQueries: _tanstack_react_query.UseQueryResult<PageActivityWithId | null, Error>[];
+    mutationUpdateCardScore: _tanstack_react_query.UseMutationResult<{
+        cardId: string;
+        scoresUpdated: Score;
+    }, Error, {
+        cardId: string;
+        cardScore: PageScore;
+    }, void>;
 };
-declare function useCreateCard(): {
-    mutationCreateCard: _tanstack_react_query.UseMutationResult<{
-        id: string;
-    } & Partial<PageActivity>, Error, {
-        data: Partial<PageActivity>;
+declare function useClearScore(): {
+    mutationClearScore: _tanstack_react_query.UseMutationResult<{
+        update: Partial<Score>;
+        activityId: string;
+    }, Error, {
+        isAssignment: boolean;
+        cardId: string;
+        cardScores: PageScore;
+        userId: string;
+        activityId: string;
     }, unknown>;
 };
-declare function useCreateCards(): {
-    mutationCreateCards: _tanstack_react_query.UseMutationResult<{
-        id: string;
-        owners: string[];
-        checked?: boolean;
-        completed?: boolean;
-        media_area_id?: string | null;
-        media_area_layout?: "left" | "right" | null;
-        score?: number;
-        verificationStatus?: VerificationCardStatus;
-        native_text?: string;
-        repeat?: number;
-        language?: string | null;
-        image?: {
-            path?: string | null;
-            url?: string;
-        };
-        audio?: {
-            path?: string | null;
-            url?: string;
-        } | null;
-        notes?: string;
-        difficulty?: string;
-        default_language?: string;
-        target_text?: string;
-        type: ActivityPageType;
-        grading_criteria?: string;
-        scoring_type?: string;
-        grading_method?: "simple" | "rubric" | "manual" | "standards_based";
-        feedback_types?: string[];
-        rubricId?: string;
-        prompt?: string;
-        title?: string;
-        passing_score?: number;
-        maxCharacters?: number;
-        answer?: string[];
-        choices?: {
-            value: string;
-            option: string;
-        }[];
-        MCQType?: string;
-        multipleAttemptsAllowed?: boolean;
-        allowRetries?: boolean;
-        question?: string;
-        respondTime?: number;
-        hidePrompt?: boolean;
-        videoUrl?: string;
-        link?: string;
-        text?: string;
-        isListenAloud?: boolean;
-        embedCode?: string;
-        attempt?: number;
-        correct?: number;
-        autoGrade?: boolean;
-        points?: number;
-        shuffle?: boolean;
-        translation?: string;
-        includeAIContext?: boolean;
-        media_area_context_ref?: string | null;
-        standardId?: string;
-        target_proficiency_level?: string;
-        allowTTS?: boolean;
-    }[], Error, {
-        cards: PageActivity[];
+declare function useSubmitAssignmentScore({ onAssignmentSubmitted, studentName, }: {
+    onAssignmentSubmitted: (assignmentId: string) => void;
+    studentName: string;
+}): {
+    submitAssignmentScore: _tanstack_react_query.UseMutateAsyncFunction<{
+        success: boolean;
+        message: string;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: unknown;
+        message?: undefined;
+    }, Error, {
+        assignment: AssignmentWithId;
+        userId: string;
+        cardIds: string[];
+        weights: Record<string, number>;
+        scores: Score;
+        status: "FINALIZED" | "IN_PROGRESS" | "PENDING_REVIEW";
     }, unknown>;
+    isLoading: boolean;
 };
-declare function getCardFromCache({ cardId, queryClient, }: {
-    cardId: string;
-    queryClient: QueryClient;
-}): PageActivityWithId | undefined;
-declare function updateCardInCache({ cardId, card, queryClient, }: {
-    cardId: string;
-    card: PageActivityWithId | null;
-    queryClient: QueryClient;
-}): void;
-declare function useGetCard({ cardId, enabled }: {
-    cardId: string;
-    enabled?: boolean;
-}): _tanstack_react_query.UseQueryResult<PageActivityWithId | null, Error>;
-
-declare const createCardRepo: () => {
-    createCard: (args_0: {
-        data: Partial<PageActivity>;
-    }) => Promise<{
-        id: string;
-    } & Partial<PageActivity>>;
-    createCards: (args_0: {
-        cards: PageActivity[];
-    }) => Promise<{
-        id: string;
-        owners: string[];
-        checked?: boolean;
-        completed?: boolean;
-        media_area_id?: string | null;
-        media_area_layout?: "left" | "right" | null;
-        score?: number;
-        verificationStatus?: VerificationCardStatus;
-        native_text?: string;
-        repeat?: number;
-        language?: string | null;
-        image?: {
-            path?: string | null;
-            url?: string;
-        };
-        audio?: {
-            path?: string | null;
-            url?: string;
-        } | null;
-        notes?: string;
-        difficulty?: string;
-        default_language?: string;
-        target_text?: string;
-        type: ActivityPageType;
-        grading_criteria?: string;
-        scoring_type?: string;
-        grading_method?: "simple" | "rubric" | "manual" | "standards_based";
-        feedback_types?: string[];
-        rubricId?: string;
-        prompt?: string;
-        title?: string;
-        passing_score?: number;
-        maxCharacters?: number;
-        answer?: string[];
-        choices?: {
-            value: string;
-            option: string;
-        }[];
-        MCQType?: string;
-        multipleAttemptsAllowed?: boolean;
-        allowRetries?: boolean;
-        question?: string;
-        respondTime?: number;
-        hidePrompt?: boolean;
-        videoUrl?: string;
-        link?: string;
-        text?: string;
-        isListenAloud?: boolean;
-        embedCode?: string;
-        attempt?: number;
-        correct?: number;
-        autoGrade?: boolean;
-        points?: number;
-        shuffle?: boolean;
-        translation?: string;
-        includeAIContext?: boolean;
-        media_area_context_ref?: string | null;
-        standardId?: string;
-        target_proficiency_level?: string;
-        allowTTS?: boolean;
-    }[]>;
-    getCard: (params: {
-        cardId: string;
-    }) => Promise<PageActivityWithId | null>;
-};
-
-declare function checkIsRepeatPage(cardType: ActivityPageType | undefined): boolean;
-declare function checkIsMCPage(cardType: ActivityPageType | undefined): boolean;
-declare function checkIsRespondPage(cardType: ActivityPageType | undefined): boolean;
-declare function checkIsRespondWrittenPage(cardType: ActivityPageType | undefined): boolean;
-declare function checkIsRespondAudioPage(cardType: ActivityPageType | undefined): boolean;
-declare const checkIsMediaPage: (cardType: ActivityPageType | undefined) => boolean;
-declare const checkIsShortAnswerPage: (cardType: ActivityPageType | undefined) => boolean;
-declare const checkTypePageActivity: (cardType: ActivityPageType | undefined) => {
-    isRespondAudio: boolean;
-    isRespondWritten: boolean;
-    isRespond: boolean;
-    isMC: boolean;
-    isRepeat: boolean;
-    isMediaPage: boolean;
-    isShortAnswer: boolean;
-};
-
-declare function getPagePrompt(card: PageActivityWithId | undefined): {
-    has: boolean;
-    text: string | undefined;
+declare function useSubmitPracticeScore(): {
+    submitPracticeScore: _tanstack_react_query.UseMutateAsyncFunction<{
+        success: boolean;
+        message: string;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: unknown;
+        message?: undefined;
+    }, Error, {
+        setId: string;
+        userId: string;
+        scores: Score;
+    }, unknown>;
+    isLoading: boolean;
 };
 
 interface SetWithId extends Set {
@@ -932,6 +938,7 @@ declare function createFsClientBase({ db, helpers, httpsCallable, logEvent, }: {
             content?: string[];
             weights?: Record<string, number>;
             language?: string;
+            types?: { [key in ActivityPageType]?: number; };
         } | null>;
         attachScoresAssignment: (args_0: {
             assignments: AssignmentWithId[];
@@ -979,6 +986,7 @@ declare function createFsClientBase({ db, helpers, httpsCallable, logEvent, }: {
             content?: string[];
             weights?: Record<string, number>;
             language?: string;
+            types?: { [key in ActivityPageType]?: number; };
         }[]>;
         getAssignmentScores: (args_0: {
             assignmentId: string;
@@ -1282,6 +1290,7 @@ declare function useActivity({ id, isAssignment, onAssignmentSubmitted, ltiData,
             content?: string[];
             weights?: Record<string, number>;
             language?: string;
+            types?: { [key in ActivityPageType]?: number; };
         } | null | undefined;
         query: _tanstack_react_query.UseQueryResult<AssignmentWithId | {
             scores: any;
@@ -1324,6 +1333,7 @@ declare function useActivity({ id, isAssignment, onAssignmentSubmitted, ltiData,
             content?: string[];
             weights?: Record<string, number>;
             language?: string;
+            types?: { [key in ActivityPageType]?: number; };
         } | null, Error>;
     };
     scores: {
@@ -1344,7 +1354,7 @@ declare function useActivity({ id, isAssignment, onAssignmentSubmitted, ltiData,
                 error: unknown;
                 message?: undefined;
             }>;
-            updateCard: (cardId: string, cardScore: CardScore) => void;
+            updateCard: (cardId: string, cardScore: PageScore) => void;
             logGradingStandardEntry: ({ cardId, gradingStandard, type, }: {
                 cardId: string;
                 gradingStandard: {
@@ -2572,6 +2582,7 @@ declare const createFsClientWeb: ({ db, httpsCallable, logEvent }: FsClientParam
             content?: string[];
             weights?: Record<string, number>;
             language?: string;
+            types?: { [key in ActivityPageType]?: number; };
         } | null>;
         attachScoresAssignment: (args_0: {
             assignments: AssignmentWithId[];
@@ -2619,6 +2630,7 @@ declare const createFsClientWeb: ({ db, httpsCallable, logEvent }: FsClientParam
             content?: string[];
             weights?: Record<string, number>;
             language?: string;
+            types?: { [key in ActivityPageType]?: number; };
         }[]>;
         getAssignmentScores: (args_0: {
             assignmentId: string;
@@ -2709,4 +2721,4 @@ declare const createFsClientWeb: ({ db, httpsCallable, logEvent }: FsClientParam
     };
 };
 
-export { ActivityPageType, type Assignment, type AssignmentWithId, BASE_MULTIPLE_CHOICE_FIELD_VALUES, BASE_REPEAT_FIELD_VALUES, BASE_RESPOND_FIELD_VALUES, type CardScore, type CreditContract, FeedbackTypesCard, FsCtx, type InstitutionSubscription, LENIENCY_OPTIONS, LeniencyCard, MULTIPLE_CHOICE_PAGE_ACTIVITY_TYPES, type Organization, type OrganizationAccess, type PageActivity, type PageActivityWithId, REPEAT_PAGE_ACTIVITY_TYPES, RESPOND_AUDIO_PAGE_ACTIVITY_TYPES, RESPOND_PAGE_ACTIVITY_TYPES, RESPOND_WRITE_PAGE_ACTIVITY_TYPES, type RefsCardsFiresotre, type RefsSetsFirestore, SPEAKABLE_NOTIFICATIONS, STUDENT_LEVELS_OPTIONS, type Score, type ScoreWithId, type Set, type SetWithId, type SpeakableNotificationType, SpeakableNotificationTypes, SpeakableProvider, VerificationCardStatus, assignmentQueryKeys, cardsQueryKeys, checkIsMCPage, checkIsMediaPage, checkIsRepeatPage, checkIsRespondAudioPage, checkIsRespondPage, checkIsRespondWrittenPage, checkIsShortAnswerPage, checkTypePageActivity, cleanString, createAssignmentRepo, createCardRepo, createFsClientWeb as createFsClient, createSetRepo, creditQueryKeys, debounce, getCardFromCache, getPagePrompt, getRespondCardTool, getSetFromCache, getWordHash, purify, refsCardsFiresotre, refsSetsFirestore, scoreQueryKeys, setsQueryKeys, updateCardInCache, updateSetInCache, useActivity, useActivityFeedbackAccess, useAssignment, useBaseOpenAI, useCards, useClearScore, useCreateCard, useCreateCards, useCreateNotification, useGetCard, useOrganizationAccess, useScore, useSet, useSpeakableApi, useSubmitAssignmentScore, useSubmitPracticeScore, useUpdateCardScore, useUpdateScore, useUserCredits };
+export { ActivityPageType, type Assignment, type AssignmentWithId, BASE_MULTIPLE_CHOICE_FIELD_VALUES, BASE_REPEAT_FIELD_VALUES, BASE_RESPOND_FIELD_VALUES, type CreditContract, FeedbackTypesCard, FsCtx, type InstitutionSubscription, LENIENCY_OPTIONS, LeniencyCard, MULTIPLE_CHOICE_PAGE_ACTIVITY_TYPES, type Organization, type OrganizationAccess, type PageActivity, type PageActivityWithId, type PageScore, REPEAT_PAGE_ACTIVITY_TYPES, RESPOND_AUDIO_PAGE_ACTIVITY_TYPES, RESPOND_PAGE_ACTIVITY_TYPES, RESPOND_WRITE_PAGE_ACTIVITY_TYPES, type RefsCardsFiresotre, type RefsSetsFirestore, SPEAKABLE_NOTIFICATIONS, STUDENT_LEVELS_OPTIONS, type Score, type ScoreWithId, type Set, type SetWithId, type SpeakableNotificationType, SpeakableNotificationTypes, SpeakableProvider, VerificationCardStatus, assignmentQueryKeys, cardsQueryKeys, checkIsMCPage, checkIsMediaPage, checkIsRepeatPage, checkIsRespondAudioPage, checkIsRespondPage, checkIsRespondWrittenPage, checkIsShortAnswerPage, checkTypePageActivity, cleanString, createAssignmentRepo, createCardRepo, createFsClientWeb as createFsClient, createSetRepo, creditQueryKeys, debounce, getCardFromCache, getPagePrompt, getRespondCardTool, getSetFromCache, getWordHash, purify, refsCardsFiresotre, refsSetsFirestore, scoreQueryKeys, setsQueryKeys, updateCardInCache, updateSetInCache, useActivity, useActivityFeedbackAccess, useAssignment, useBaseOpenAI, useCards, useClearScore, useCreateCard, useCreateCards, useCreateNotification, useGetCard, useOrganizationAccess, useScore, useSet, useSpeakableApi, useSubmitAssignmentScore, useSubmitPracticeScore, useUpdateCardScore, useUpdateScore, useUserCredits };