@orjok/commons 1.0.2 → 1.1.0

package/dist/index.d.cts

@@ -1,8 +1,49 @@
-import { Q as QuestionType, a as QuestionObject, D as Difficulty, U as UserChapterProgress, b as UserSubjectProgress, c as UserTopicProgress } from './client-BaOC79Nc.cjs';
-export { A as AIService, d as AIUsageLog, e as AddQuestionTagInput, C as Chapter, f as CheckParticipationResponse, g as Contest, h as ContestAnswersResponse, i as ContestOption, j as ContestParticipant, k as ContestQuestion, l as ContestQuestionsResponse, m as ContestService, n as Course, o as CourseEnrolled, p as CourseEnrollmentRequest, q as CourseItem, r as CourseItemType, s as CourseLiveExam, t as CourseLiveExamParticipant, u as CourseLiveExamQuestionsResponse, v as CourseService, w as CreateContestInput, x as CreateCourseInput, y as CreateCourseItemInput, z as CreateCourseLiveExamInput, B as CreateCourseResponse, E as CreateCourseVideoInput, F as CreateCourseVideoResponse, G as CreatePackInput, H as CreateQuestionInput, I as CreateQuestionResponse, J as CurriculumService, K as DeleteCourseItemInput, L as EnrollStudentInput, M as EvaluateWrittenAnswerInput, N as EvaluateWrittenAnswerResponse, P as GetSignedFileURLInput, R as GetSignedURLInput, S as Language, T as LeaderboardResponse, V as Level, W as ListByCurriculumInput, X as ListByRandomHashInput, Y as MediaService, Z as ModelType, _ as NewsArticle, $ as NewsService, a0 as Option, O as OrjokClient, a1 as OrjokClientConfig, a2 as Pack, a3 as PackExamResults, a4 as PackGroup, a5 as PackReport, a6 as PackService, a7 as PackTag, a8 as PaginatedList, a9 as PaymentStatus, aa as PaymentTransaction, ab as ProgressService, ac as QuestionReport, ad as QuestionService, ae as QuestionTag, af as QuestionTracking, ag as QuestionTrackingStatus, ah as QuestionVote, ai as SendEnrollmentRequestInput, aj as SignedURLResponse, ak as SortDirection, al as StatusIdResponse, am as StatusResponse, an as Subject, ao as SubmitPackExamInput, ap as Tag, aq as Tier, ar as Topic, as as TrackPracticeProgressInput, at as UpdateUserAvatarInput, au as UploadImageResponse, av as UploadVideoToBunnyInput, aw as User, ax as UserService, ay as UserTopicMetric, az as Verification, aA as VerificationType, aB as VoteInput, aC as VoteType, aD as createOrjokClient } from './client-BaOC79Nc.cjs';
+import { D as Difficulty, L as Language, i as Level, j as QuestionType, Q as QuestionObject } from './practice-QnWtC5A7.cjs';
+export { A as AIService, k as AIUsageLog, l as AddQuestionTagInput, C as Chapter, b as CheckParticipationResponse, a as Contest, m as ContestAnswersResponse, n as ContestOption, o as ContestParticipant, p as ContestQuestion, q as ContestQuestionsResponse, r as ContestService, c as Course, s as CourseEnrolled, t as CourseEnrollmentRequest, d as CourseItem, u as CourseItemType, e as CourseLiveExam, v as CourseLiveExamParticipant, w as CourseLiveExamQuestionsResponse, x as CourseService, y as CreateContestInput, z as CreateCourseInput, B as CreateCourseItemInput, E as CreateCourseLiveExamInput, F as CreateCourseResponse, G as CreateCourseVideoInput, H as CreateCourseVideoResponse, I as CreatePackInput, J as CreateQuestionInput, K as CreateQuestionResponse, M as CurriculumService, N as DeleteCourseItemInput, R as EnrollStudentInput, V as EvaluateWrittenAnswerInput, W as EvaluateWrittenAnswerResponse, X as GetSignedFileURLInput, Y as GetSignedURLInput, Z as LeaderboardResponse, _ as ListByCurriculumInput, $ as ListByRandomHashInput, a0 as MediaService, a1 as ModelType, a2 as NewsArticle, a3 as NewsService, a4 as Option, O as OrjokClient, a5 as OrjokClientConfig, P as Pack, a6 as PackExamResults, a7 as PackGroup, a8 as PackReport, a9 as PackService, aa as PackTag, ab as PaginatedList, ac as PaymentStatus, ad as PaymentTransaction, h as PracticeMetrics, ae as ProgressService, af as QuestionReport, ag as QuestionService, ah as QuestionTag, ai as QuestionTracking, aj as QuestionTrackingStatus, ak as QuestionVote, al as SendEnrollmentRequestInput, am as SignedURLResponse, an as SortDirection, ao as StatusIdResponse, ap as StatusResponse, S as Subject, aq as SubmitPackExamInput, ar as Tag, as as Tier, T as Topic, at as TrackPracticeProgressInput, au as UpdateUserAvatarInput, av as UploadImageResponse, aw as UploadVideoToBunnyInput, ax as User, f as UserChapterProgress, ay as UserService, U as UserSubjectProgress, az as UserTopicMetric, g as UserTopicProgress, aA as Verification, aB as VerificationType, aC as VoteInput, aD as VoteType, aE as aggregateChapterMetrics, aF as aggregateSubjectMetrics, aG as aggregateTopicMetrics, aH as calculateAccuracy, aI as createOrjokClient, aJ as isDifficultyMatch, aK as isLanguageMatch, aL as isValidMCQ } from './practice-QnWtC5A7.cjs';
 import { S as StorageProvider } from './storage-DLqdJgQt.cjs';
 export { A as AuthProvider, a as AuthSession, G as GraphQLResult, N as NetworkProvider, b as UploadOptions, U as UserAttributes } from './storage-DLqdJgQt.cjs';
 
+type RenderCategory = "Background" | "Hair Back" | "Skin Color Body" | "Skin Color Head" | "Skin Color" | "Clothes Back" | "Clothes Front" | "Accessories" | "Headwears" | "Facial Expression" | "Beard" | "Eyewear" | "Hair Front";
+type UICategory = "Background" | "Hair" | "Skin Color" | "Clothes" | "Accessories" | "Headwears" | "Eyewear" | "Facial Expression" | "Beard";
+interface ColorOption {
+    name: string;
+    filter: string;
+    hex: string;
+    brightness: number;
+}
+interface AvatarConfigItem {
+    raw_name: string;
+    safe_name: string;
+    base_name: string;
+    conditions: string[];
+    is_multicolor: boolean;
+    has_inner_color?: boolean;
+    brightness?: number;
+    hue?: number;
+}
+type AvatarConfig = Record<string, AvatarConfigItem[]>;
+interface AvatarState {
+    selections: Record<string, string>;
+    colors: Record<string, string>;
+}
+
+interface SelectOption<T = string> {
+    value: T;
+    label: string;
+}
+declare const levelOptions: SelectOption<Level>[];
+declare const languageOptions: SelectOption<Language>[];
+declare const difficultyOptions: SelectOption<Difficulty>[];
+
+declare const HAIR_COLORS: ColorOption[];
+declare const CLOTHES_COLORS: ColorOption[];
+declare const COLOR_HUES: Record<string, number>;
+declare const RENDER_ORDER: readonly ["Background", "Hair Back", "Clothes Back", "Skin Color Body", "Clothes Front", "Skin Color Head", "Accessories", "Facial Expression", "Beard", "Hair Front", "Eyewear", "Headwears"];
+declare const INITIAL_AVATAR_DATA: Record<UICategory, string[]>;
+declare function getActualOptionFileName(category: string, baseName: string, config: AvatarConfig, selections: Record<string, string>): AvatarConfigItem | null;
+declare function parseAvatarConfig(configStr: string | null | undefined): AvatarState;
+declare function serializeAvatarConfig(state: AvatarState): string;
+
 interface EloTier {
     name: string;
     minRating: number;
@@ -35,6 +76,15 @@ declare function parseImageKeys(answer: string): string[];
 declare function buildImageAnswer(keys: string[]): string;
 declare function normalizeDifficulty(raw: string): Difficulty | undefined;
 declare function detectQuestionType(option2: string, option3: string, option4: string): QuestionType;
+declare function isCorrectAnswer(selected: string | null | undefined, correct: string | null | undefined): boolean;
+declare function calculateDefaultExamMinutes(mode: ExamMode, questions: Array<{
+    type?: string | null;
+}>): number;
+declare function reorderObjectKeys<T>(obj: {
+    [key: number]: T;
+}, oldIndex: number, newIndex: number, length: number): {
+    [key: number]: T;
+};
 
 interface ParsedQuestion {
     id?: string;
@@ -80,26 +130,48 @@ declare function resolveMediaUrl(value: string | null | undefined, storage: Stor
 declare function resolveMediaUrls<T extends Record<string, unknown>>(obj: T, fields: (keyof T)[], storage: StorageProvider | undefined, cache?: MediaUrlCache): Promise<T>;
 declare function _resetMediaUrlWarning(): void;
 
-interface PracticeMetrics {
-    totalPracticed: number;
-    totalMistakes: number;
-    totalCorrected: number;
-    accuracy: number;
-}
-declare function aggregateSubjectMetrics(progress: UserSubjectProgress[]): PracticeMetrics;
-declare function aggregateChapterMetrics(progress: UserChapterProgress[]): PracticeMetrics;
-declare function aggregateTopicMetrics(progress: UserTopicProgress[]): PracticeMetrics;
-declare function calculateAccuracy(practiced: number, mistakes: number): number;
+type PrimaryTab = "home" | "learn" | "contests" | "courses" | "profile";
+declare function getActiveTab(pathname: string): PrimaryTab;
+declare function getCanonicalPath(pathname: string): string;
+declare function isAuthGatedRoute(pathname: string): boolean;
 
 declare function shuffle<T>(array: T[]): T[];
 declare function shuffleInPlace<T>(array: T[]): void;
 
 declare function engToBanglaNumber(num: number | string): string;
 
-declare function formatCurriculumName(idString: string, dbName?: string | null): string;
+/**
+ * Splits a bilingual string formatted as "Bangla Name (English Name)"
+ * into the requested language ("bn" or "en").
+ * If the string does not follow the bilingual pattern, returns the clean string.
+ */
+declare function extractBilingualName(name: string, language?: "bn" | "en" | string): string;
+declare function formatCurriculumName(idString: string, dbName?: string | null, language?: "bn" | "en" | string): string;
 
 declare function getRelativeTime(startTime: string | Date, endTime?: string | Date): string;
 
 declare function processLatexText(str: string): string;
 
-export { Difficulty, type EloTier, type ExamConfig, type ExamMode, MediaUrlCache, type ParseResult, type ParsedQuestion, type PracticeMetrics, QuestionObject, QuestionType, type RatingField, StorageProvider, UserChapterProgress, UserSubjectProgress, UserTopicProgress, _resetMediaUrlWarning, aggregateChapterMetrics, aggregateSubjectMetrics, aggregateTopicMetrics, buildImageAnswer, calculateAccuracy, calculateExamTime, computeRatingDelta, detectQuestionType, engToBanglaNumber, filterQuestionsByMode, formatCurriculumName, formatExamTime, formatQuestionsToCsv, formatQuestionsToText, getAllTiers, getEloProgress, getEloTier, getRatingForSubject, getRelativeTime, isImageAnswer, isStorageKey, normalizeDifficulty, parseCsvQuestions, parseImageKeys, parseTextQuestions, processLatexText, resolveMediaUrl, resolveMediaUrls, scoreExam, shuffle, shuffleInPlace };
+interface TimeLeft {
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    isEnded: boolean;
+}
+declare function convertToBangladeshTime(isoString: string): string;
+declare function getDhakaNow(): Date;
+declare function calculateTimeLeft(endTime: string | Date): TimeLeft;
+declare function formatDate(date: Date | string, locale?: string): string;
+
+declare function formatBDT(amount: number): string;
+
+declare function getYouTubeId(url: string | null | undefined): string | null;
+
+declare function sanitizeFileName(name: string): string;
+
+declare function isQuestionLevel(value: unknown): value is Level;
+declare function isLanguage(value: unknown): value is Language;
+declare function isDifficulty(value: unknown): value is Difficulty;
+
+export { type AvatarConfig, type AvatarConfigItem, type AvatarState, CLOTHES_COLORS, COLOR_HUES, type ColorOption, Difficulty, type EloTier, type ExamConfig, type ExamMode, HAIR_COLORS, INITIAL_AVATAR_DATA, Language, Level, MediaUrlCache, type ParseResult, type ParsedQuestion, type PrimaryTab, QuestionObject, QuestionType, RENDER_ORDER, type RatingField, type RenderCategory, type SelectOption, StorageProvider, type TimeLeft, type UICategory, _resetMediaUrlWarning, buildImageAnswer, calculateDefaultExamMinutes, calculateExamTime, calculateTimeLeft, computeRatingDelta, convertToBangladeshTime, detectQuestionType, difficultyOptions, engToBanglaNumber, extractBilingualName, filterQuestionsByMode, formatBDT, formatCurriculumName, formatDate, formatExamTime, formatQuestionsToCsv, formatQuestionsToText, getActiveTab, getActualOptionFileName, getAllTiers, getCanonicalPath, getDhakaNow, getEloProgress, getEloTier, getRatingForSubject, getRelativeTime, getYouTubeId, isAuthGatedRoute, isCorrectAnswer, isDifficulty, isImageAnswer, isLanguage, isQuestionLevel, isStorageKey, languageOptions, levelOptions, normalizeDifficulty, parseAvatarConfig, parseCsvQuestions, parseImageKeys, parseTextQuestions, processLatexText, reorderObjectKeys, resolveMediaUrl, resolveMediaUrls, sanitizeFileName, scoreExam, serializeAvatarConfig, shuffle, shuffleInPlace };

package/dist/index.d.ts

@@ -1,8 +1,49 @@
-import { Q as QuestionType, a as QuestionObject, D as Difficulty, U as UserChapterProgress, b as UserSubjectProgress, c as UserTopicProgress } from './client-Bm9aiyTx.js';
-export { A as AIService, d as AIUsageLog, e as AddQuestionTagInput, C as Chapter, f as CheckParticipationResponse, g as Contest, h as ContestAnswersResponse, i as ContestOption, j as ContestParticipant, k as ContestQuestion, l as ContestQuestionsResponse, m as ContestService, n as Course, o as CourseEnrolled, p as CourseEnrollmentRequest, q as CourseItem, r as CourseItemType, s as CourseLiveExam, t as CourseLiveExamParticipant, u as CourseLiveExamQuestionsResponse, v as CourseService, w as CreateContestInput, x as CreateCourseInput, y as CreateCourseItemInput, z as CreateCourseLiveExamInput, B as CreateCourseResponse, E as CreateCourseVideoInput, F as CreateCourseVideoResponse, G as CreatePackInput, H as CreateQuestionInput, I as CreateQuestionResponse, J as CurriculumService, K as DeleteCourseItemInput, L as EnrollStudentInput, M as EvaluateWrittenAnswerInput, N as EvaluateWrittenAnswerResponse, P as GetSignedFileURLInput, R as GetSignedURLInput, S as Language, T as LeaderboardResponse, V as Level, W as ListByCurriculumInput, X as ListByRandomHashInput, Y as MediaService, Z as ModelType, _ as NewsArticle, $ as NewsService, a0 as Option, O as OrjokClient, a1 as OrjokClientConfig, a2 as Pack, a3 as PackExamResults, a4 as PackGroup, a5 as PackReport, a6 as PackService, a7 as PackTag, a8 as PaginatedList, a9 as PaymentStatus, aa as PaymentTransaction, ab as ProgressService, ac as QuestionReport, ad as QuestionService, ae as QuestionTag, af as QuestionTracking, ag as QuestionTrackingStatus, ah as QuestionVote, ai as SendEnrollmentRequestInput, aj as SignedURLResponse, ak as SortDirection, al as StatusIdResponse, am as StatusResponse, an as Subject, ao as SubmitPackExamInput, ap as Tag, aq as Tier, ar as Topic, as as TrackPracticeProgressInput, at as UpdateUserAvatarInput, au as UploadImageResponse, av as UploadVideoToBunnyInput, aw as User, ax as UserService, ay as UserTopicMetric, az as Verification, aA as VerificationType, aB as VoteInput, aC as VoteType, aD as createOrjokClient } from './client-Bm9aiyTx.js';
+import { D as Difficulty, L as Language, i as Level, j as QuestionType, Q as QuestionObject } from './practice-Dh2Tv80G.js';
+export { A as AIService, k as AIUsageLog, l as AddQuestionTagInput, C as Chapter, b as CheckParticipationResponse, a as Contest, m as ContestAnswersResponse, n as ContestOption, o as ContestParticipant, p as ContestQuestion, q as ContestQuestionsResponse, r as ContestService, c as Course, s as CourseEnrolled, t as CourseEnrollmentRequest, d as CourseItem, u as CourseItemType, e as CourseLiveExam, v as CourseLiveExamParticipant, w as CourseLiveExamQuestionsResponse, x as CourseService, y as CreateContestInput, z as CreateCourseInput, B as CreateCourseItemInput, E as CreateCourseLiveExamInput, F as CreateCourseResponse, G as CreateCourseVideoInput, H as CreateCourseVideoResponse, I as CreatePackInput, J as CreateQuestionInput, K as CreateQuestionResponse, M as CurriculumService, N as DeleteCourseItemInput, R as EnrollStudentInput, V as EvaluateWrittenAnswerInput, W as EvaluateWrittenAnswerResponse, X as GetSignedFileURLInput, Y as GetSignedURLInput, Z as LeaderboardResponse, _ as ListByCurriculumInput, $ as ListByRandomHashInput, a0 as MediaService, a1 as ModelType, a2 as NewsArticle, a3 as NewsService, a4 as Option, O as OrjokClient, a5 as OrjokClientConfig, P as Pack, a6 as PackExamResults, a7 as PackGroup, a8 as PackReport, a9 as PackService, aa as PackTag, ab as PaginatedList, ac as PaymentStatus, ad as PaymentTransaction, h as PracticeMetrics, ae as ProgressService, af as QuestionReport, ag as QuestionService, ah as QuestionTag, ai as QuestionTracking, aj as QuestionTrackingStatus, ak as QuestionVote, al as SendEnrollmentRequestInput, am as SignedURLResponse, an as SortDirection, ao as StatusIdResponse, ap as StatusResponse, S as Subject, aq as SubmitPackExamInput, ar as Tag, as as Tier, T as Topic, at as TrackPracticeProgressInput, au as UpdateUserAvatarInput, av as UploadImageResponse, aw as UploadVideoToBunnyInput, ax as User, f as UserChapterProgress, ay as UserService, U as UserSubjectProgress, az as UserTopicMetric, g as UserTopicProgress, aA as Verification, aB as VerificationType, aC as VoteInput, aD as VoteType, aE as aggregateChapterMetrics, aF as aggregateSubjectMetrics, aG as aggregateTopicMetrics, aH as calculateAccuracy, aI as createOrjokClient, aJ as isDifficultyMatch, aK as isLanguageMatch, aL as isValidMCQ } from './practice-Dh2Tv80G.js';
 import { S as StorageProvider } from './storage-DLqdJgQt.js';
 export { A as AuthProvider, a as AuthSession, G as GraphQLResult, N as NetworkProvider, b as UploadOptions, U as UserAttributes } from './storage-DLqdJgQt.js';
 
+type RenderCategory = "Background" | "Hair Back" | "Skin Color Body" | "Skin Color Head" | "Skin Color" | "Clothes Back" | "Clothes Front" | "Accessories" | "Headwears" | "Facial Expression" | "Beard" | "Eyewear" | "Hair Front";
+type UICategory = "Background" | "Hair" | "Skin Color" | "Clothes" | "Accessories" | "Headwears" | "Eyewear" | "Facial Expression" | "Beard";
+interface ColorOption {
+    name: string;
+    filter: string;
+    hex: string;
+    brightness: number;
+}
+interface AvatarConfigItem {
+    raw_name: string;
+    safe_name: string;
+    base_name: string;
+    conditions: string[];
+    is_multicolor: boolean;
+    has_inner_color?: boolean;
+    brightness?: number;
+    hue?: number;
+}
+type AvatarConfig = Record<string, AvatarConfigItem[]>;
+interface AvatarState {
+    selections: Record<string, string>;
+    colors: Record<string, string>;
+}
+
+interface SelectOption<T = string> {
+    value: T;
+    label: string;
+}
+declare const levelOptions: SelectOption<Level>[];
+declare const languageOptions: SelectOption<Language>[];
+declare const difficultyOptions: SelectOption<Difficulty>[];
+
+declare const HAIR_COLORS: ColorOption[];
+declare const CLOTHES_COLORS: ColorOption[];
+declare const COLOR_HUES: Record<string, number>;
+declare const RENDER_ORDER: readonly ["Background", "Hair Back", "Clothes Back", "Skin Color Body", "Clothes Front", "Skin Color Head", "Accessories", "Facial Expression", "Beard", "Hair Front", "Eyewear", "Headwears"];
+declare const INITIAL_AVATAR_DATA: Record<UICategory, string[]>;
+declare function getActualOptionFileName(category: string, baseName: string, config: AvatarConfig, selections: Record<string, string>): AvatarConfigItem | null;
+declare function parseAvatarConfig(configStr: string | null | undefined): AvatarState;
+declare function serializeAvatarConfig(state: AvatarState): string;
+
 interface EloTier {
     name: string;
     minRating: number;
@@ -35,6 +76,15 @@ declare function parseImageKeys(answer: string): string[];
 declare function buildImageAnswer(keys: string[]): string;
 declare function normalizeDifficulty(raw: string): Difficulty | undefined;
 declare function detectQuestionType(option2: string, option3: string, option4: string): QuestionType;
+declare function isCorrectAnswer(selected: string | null | undefined, correct: string | null | undefined): boolean;
+declare function calculateDefaultExamMinutes(mode: ExamMode, questions: Array<{
+    type?: string | null;
+}>): number;
+declare function reorderObjectKeys<T>(obj: {
+    [key: number]: T;
+}, oldIndex: number, newIndex: number, length: number): {
+    [key: number]: T;
+};
 
 interface ParsedQuestion {
     id?: string;
@@ -80,26 +130,48 @@ declare function resolveMediaUrl(value: string | null | undefined, storage: Stor
 declare function resolveMediaUrls<T extends Record<string, unknown>>(obj: T, fields: (keyof T)[], storage: StorageProvider | undefined, cache?: MediaUrlCache): Promise<T>;
 declare function _resetMediaUrlWarning(): void;
 
-interface PracticeMetrics {
-    totalPracticed: number;
-    totalMistakes: number;
-    totalCorrected: number;
-    accuracy: number;
-}
-declare function aggregateSubjectMetrics(progress: UserSubjectProgress[]): PracticeMetrics;
-declare function aggregateChapterMetrics(progress: UserChapterProgress[]): PracticeMetrics;
-declare function aggregateTopicMetrics(progress: UserTopicProgress[]): PracticeMetrics;
-declare function calculateAccuracy(practiced: number, mistakes: number): number;
+type PrimaryTab = "home" | "learn" | "contests" | "courses" | "profile";
+declare function getActiveTab(pathname: string): PrimaryTab;
+declare function getCanonicalPath(pathname: string): string;
+declare function isAuthGatedRoute(pathname: string): boolean;
 
 declare function shuffle<T>(array: T[]): T[];
 declare function shuffleInPlace<T>(array: T[]): void;
 
 declare function engToBanglaNumber(num: number | string): string;
 
-declare function formatCurriculumName(idString: string, dbName?: string | null): string;
+/**
+ * Splits a bilingual string formatted as "Bangla Name (English Name)"
+ * into the requested language ("bn" or "en").
+ * If the string does not follow the bilingual pattern, returns the clean string.
+ */
+declare function extractBilingualName(name: string, language?: "bn" | "en" | string): string;
+declare function formatCurriculumName(idString: string, dbName?: string | null, language?: "bn" | "en" | string): string;
 
 declare function getRelativeTime(startTime: string | Date, endTime?: string | Date): string;
 
 declare function processLatexText(str: string): string;
 
-export { Difficulty, type EloTier, type ExamConfig, type ExamMode, MediaUrlCache, type ParseResult, type ParsedQuestion, type PracticeMetrics, QuestionObject, QuestionType, type RatingField, StorageProvider, UserChapterProgress, UserSubjectProgress, UserTopicProgress, _resetMediaUrlWarning, aggregateChapterMetrics, aggregateSubjectMetrics, aggregateTopicMetrics, buildImageAnswer, calculateAccuracy, calculateExamTime, computeRatingDelta, detectQuestionType, engToBanglaNumber, filterQuestionsByMode, formatCurriculumName, formatExamTime, formatQuestionsToCsv, formatQuestionsToText, getAllTiers, getEloProgress, getEloTier, getRatingForSubject, getRelativeTime, isImageAnswer, isStorageKey, normalizeDifficulty, parseCsvQuestions, parseImageKeys, parseTextQuestions, processLatexText, resolveMediaUrl, resolveMediaUrls, scoreExam, shuffle, shuffleInPlace };
+interface TimeLeft {
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    isEnded: boolean;
+}
+declare function convertToBangladeshTime(isoString: string): string;
+declare function getDhakaNow(): Date;
+declare function calculateTimeLeft(endTime: string | Date): TimeLeft;
+declare function formatDate(date: Date | string, locale?: string): string;
+
+declare function formatBDT(amount: number): string;
+
+declare function getYouTubeId(url: string | null | undefined): string | null;
+
+declare function sanitizeFileName(name: string): string;
+
+declare function isQuestionLevel(value: unknown): value is Level;
+declare function isLanguage(value: unknown): value is Language;
+declare function isDifficulty(value: unknown): value is Difficulty;
+
+export { type AvatarConfig, type AvatarConfigItem, type AvatarState, CLOTHES_COLORS, COLOR_HUES, type ColorOption, Difficulty, type EloTier, type ExamConfig, type ExamMode, HAIR_COLORS, INITIAL_AVATAR_DATA, Language, Level, MediaUrlCache, type ParseResult, type ParsedQuestion, type PrimaryTab, QuestionObject, QuestionType, RENDER_ORDER, type RatingField, type RenderCategory, type SelectOption, StorageProvider, type TimeLeft, type UICategory, _resetMediaUrlWarning, buildImageAnswer, calculateDefaultExamMinutes, calculateExamTime, calculateTimeLeft, computeRatingDelta, convertToBangladeshTime, detectQuestionType, difficultyOptions, engToBanglaNumber, extractBilingualName, filterQuestionsByMode, formatBDT, formatCurriculumName, formatDate, formatExamTime, formatQuestionsToCsv, formatQuestionsToText, getActiveTab, getActualOptionFileName, getAllTiers, getCanonicalPath, getDhakaNow, getEloProgress, getEloTier, getRatingForSubject, getRelativeTime, getYouTubeId, isAuthGatedRoute, isCorrectAnswer, isDifficulty, isImageAnswer, isLanguage, isQuestionLevel, isStorageKey, languageOptions, levelOptions, normalizeDifficulty, parseAvatarConfig, parseCsvQuestions, parseImageKeys, parseTextQuestions, processLatexText, reorderObjectKeys, resolveMediaUrl, resolveMediaUrls, sanitizeFileName, scoreExam, serializeAvatarConfig, shuffle, shuffleInPlace };