chuvsu-js 4.2.0 → 5.0.1

package/dist/tt/schedule.d.ts

@@ -1,55 +0,0 @@
-import type { FullScheduleDay, SemesterWeek, Lesson } from "./types.js";
-import { Period, EducationType } from "../common/types.js";
-import { type Holiday, type HolidayTransfer } from "./utils/index.js";
-export declare class Schedule {
-    readonly groupId: number;
-    readonly scheduleMap: Map<number, FullScheduleDay[]>;
-    readonly educationType: EducationType;
-    /** Whether this is a teacher schedule (affects substitution handling). */
-    readonly isTeacherSchedule: boolean;
-    /** List of holidays to exclude from schedule queries. Pass `[]` to disable. */
-    readonly holidays: Holiday[];
-    /** Government decree day-off transfers (Постановление Правительства). */
-    readonly holidayTransfers: HolidayTransfer[];
-    /** Academic year represented by this schedule (e.g. 2026 for 2026/2027). */
-    readonly academicYearStartYear: number;
-    private _period?;
-    constructor(groupId: number, scheduleMap: Map<number, FullScheduleDay[]>, period?: Period, educationType?: EducationType, holidays?: Holiday[] | null, holidayTransfers?: HolidayTransfer[], isTeacherSchedule?: boolean, academicYearStartYear?: number);
-    /** Current (or fixed) period for this schedule. */
-    get period(): Period;
-    /** Days for the current period. */
-    get days(): FullScheduleDay[];
-    /** All periods that have data in this schedule. */
-    get periods(): Period[];
-    /** Get days for a specific period. */
-    getDays(period: Period): FullScheduleDay[];
-    private getSemesterYear;
-    private getSlotsForWeekday;
-    private getDateForWeekday;
-    private isInCurrentAcademicYear;
-    forDay(weekday: number, opts?: {
-        subgroup?: number;
-        week?: number;
-    }): Lesson[];
-    forDate(date: Date, opts?: {
-        subgroup?: number;
-    }): Lesson[];
-    forWeek(week?: number, opts?: {
-        subgroup?: number;
-    }): Lesson[];
-    today(opts?: {
-        subgroup?: number;
-    }): Lesson[];
-    tomorrow(opts?: {
-        subgroup?: number;
-    }): Lesson[];
-    thisWeek(opts?: {
-        subgroup?: number;
-    }): Lesson[];
-    currentLesson(opts?: {
-        subgroup?: number;
-    }): Lesson | null;
-    getWeekNumber(date?: Date): number;
-    getSemesterWeeks(weekCount?: number): SemesterWeek[];
-    getSemesterStart(): Date;
-}

package/dist/tt/schedule.js

@@ -1,233 +0,0 @@
-import { collectTransfers, filterSlots, getAdjacentSemester, getCurrentPeriod, getMonday, getSemesterStart, getSemesterWeeks, getWeekNumber, getWeekdayName, isHoliday, isSameDay, isSessionPeriod, RUSSIAN_HOLIDAYS, slotsToLessons, sortLessons, suppressTransferredLessons, } from "./utils/index.js";
-export class Schedule {
-    groupId;
-    scheduleMap;
-    educationType;
-    /** Whether this is a teacher schedule (affects substitution handling). */
-    isTeacherSchedule;
-    /** List of holidays to exclude from schedule queries. Pass `[]` to disable. */
-    holidays;
-    /** Government decree day-off transfers (Постановление Правительства). */
-    holidayTransfers;
-    /** Academic year represented by this schedule (e.g. 2026 for 2026/2027). */
-    academicYearStartYear;
-    _period;
-    constructor(groupId, scheduleMap, period, educationType, holidays, holidayTransfers, isTeacherSchedule, academicYearStartYear) {
-        this.groupId = groupId;
-        this.scheduleMap = scheduleMap;
-        this.educationType = educationType ?? 1 /* EducationType.HigherEducation */;
-        this.isTeacherSchedule = isTeacherSchedule ?? false;
-        this._period = period;
-        this.holidays = holidays ?? RUSSIAN_HOLIDAYS;
-        this.holidayTransfers = holidayTransfers ?? [];
-        if (academicYearStartYear != null) {
-            this.academicYearStartYear = academicYearStartYear;
-        }
-        else {
-            const now = new Date();
-            this.academicYearStartYear =
-                now.getMonth() >= 8 ? now.getFullYear() : now.getFullYear() - 1;
-        }
-    }
-    /** Current (or fixed) period for this schedule. */
-    get period() {
-        return this._period ?? getCurrentPeriod();
-    }
-    /** Days for the current period. */
-    get days() {
-        return this.scheduleMap.get(this.period) ?? [];
-    }
-    /** All periods that have data in this schedule. */
-    get periods() {
-        return [...this.scheduleMap.keys()];
-    }
-    /** Get days for a specific period. */
-    getDays(period) {
-        return this.scheduleMap.get(period) ?? [];
-    }
-    getSemesterYear(period) {
-        const semester = isSessionPeriod(period)
-            ? getAdjacentSemester(period)
-            : period;
-        return semester === 1 /* Period.FallSemester */
-            ? this.academicYearStartYear
-            : this.academicYearStartYear + 1;
-    }
-    // --- Semester helpers (weekday-based) ---
-    getSlotsForWeekday(weekday, days, opts) {
-        const dayName = getWeekdayName(weekday);
-        const day = days.find((d) => d.weekday.toLowerCase() === dayName.toLowerCase());
-        if (!day)
-            return [];
-        return filterSlots(day.slots, opts);
-    }
-    getDateForWeekday(weekday, period, week) {
-        if (week != null) {
-            const startMonday = getMonday(getSemesterStart({ period, year: this.getSemesterYear(period) }));
-            const date = new Date(startMonday);
-            date.setDate(startMonday.getDate() +
-                (week - 1) * 7 +
-                (weekday === 0 ? 6 : weekday - 1));
-            return date;
-        }
-        const now = new Date();
-        const currentDay = now.getDay();
-        const diff = weekday - currentDay;
-        const date = new Date(now);
-        date.setDate(now.getDate() + diff);
-        date.setHours(0, 0, 0, 0);
-        return date;
-    }
-    isInCurrentAcademicYear(date) {
-        const startYear = this.academicYearStartYear;
-        const start = new Date(startYear, 8, 1);
-        const end = new Date(startYear + 1, 7, 31, 23, 59, 59, 999);
-        return date >= start && date <= end;
-    }
-    // --- Public query methods ---
-    forDay(weekday, opts) {
-        const period = this.period;
-        const days = this.getDays(period);
-        if (isSessionPeriod(period)) {
-            // For sessions, return all entries on days matching this weekday
-            const lessons = [];
-            const dayName = getWeekdayName(weekday);
-            for (const d of days) {
-                if (d.weekday.toLowerCase() === dayName.toLowerCase() && d.date) {
-                    const slots = filterSlots(d.slots, { subgroup: opts?.subgroup });
-                    lessons.push(...slotsToLessons(slots, d.date, {
-                        isTeacherSchedule: this.isTeacherSchedule,
-                    }));
-                }
-            }
-            return lessons.sort(sortLessons);
-        }
-        const slots = this.getSlotsForWeekday(weekday, days, opts);
-        const date = this.getDateForWeekday(weekday, period, opts?.week);
-        return slotsToLessons(slots, date, { isTeacherSchedule: this.isTeacherSchedule });
-    }
-    forDate(date, opts) {
-        if (!this.isInCurrentAcademicYear(date))
-            return [];
-        if (isHoliday(date, this.holidays, this.holidayTransfers))
-            return [];
-        const period = getCurrentPeriod({ date });
-        const lessons = [];
-        // 1. Check all periods for date-based (session) entries matching this date
-        for (const [, d] of this.scheduleMap) {
-            for (const day of d) {
-                if (day.date && isSameDay(day.date, date)) {
-                    const slots = filterSlots(day.slots, { subgroup: opts?.subgroup });
-                    lessons.push(...slotsToLessons(slots, date, {
-                        isTeacherSchedule: this.isTeacherSchedule,
-                    }));
-                }
-            }
-        }
-        // 2. Check applicable semester for weekday-based entries
-        const semesterPeriod = isSessionPeriod(period)
-            ? getAdjacentSemester(period)
-            : period;
-        const semesterDays = this.getDays(semesterPeriod);
-        if (semesterDays.length > 0) {
-            const week = getWeekNumber({
-                period: semesterPeriod,
-                year: this.getSemesterYear(semesterPeriod),
-                date,
-            });
-            if (week >= 1 && week <= 17) {
-                const weekday = date.getDay();
-                const slots = this.getSlotsForWeekday(weekday, semesterDays, {
-                    subgroup: opts?.subgroup,
-                    week,
-                    date,
-                });
-                lessons.push(...slotsToLessons(slots, date, { isTeacherSchedule: this.isTeacherSchedule }));
-            }
-            // 3. Suppress lessons that were transferred away from this date
-            const transfers = collectTransfers(semesterDays);
-            if (transfers.length > 0) {
-                return suppressTransferredLessons(lessons, transfers, date).sort(sortLessons);
-            }
-        }
-        return lessons.sort(sortLessons);
-    }
-    forWeek(week, opts) {
-        const period = this.period;
-        // Determine the Monday of the target week
-        let mondayDate;
-        if (week != null && !isSessionPeriod(period)) {
-            const semesterWeeks = getSemesterWeeks({
-                period,
-                year: this.getSemesterYear(period),
-                weekCount: week,
-            });
-            const weekData = semesterWeeks.find((w) => w.week === week);
-            mondayDate = weekData ? weekData.start : getMonday(new Date());
-        }
-        else {
-            mondayDate = getMonday(new Date());
-        }
-        const lessons = [];
-        for (let i = 0; i < 7; i++) {
-            const date = new Date(mondayDate);
-            date.setDate(mondayDate.getDate() + i);
-            date.setHours(0, 0, 0, 0);
-            lessons.push(...this.forDate(date, opts));
-        }
-        return lessons.sort(sortLessons);
-    }
-    today(opts) {
-        return this.forDate(new Date(), opts).sort(sortLessons);
-    }
-    tomorrow(opts) {
-        const date = new Date();
-        date.setDate(date.getDate() + 1);
-        return this.forDate(date, opts).sort(sortLessons);
-    }
-    thisWeek(opts) {
-        return this.forWeek(undefined, opts).sort(sortLessons);
-    }
-    currentLesson(opts) {
-        const now = new Date();
-        const lessons = this.forDate(now, opts);
-        const timeMinutes = now.getHours() * 60 + now.getMinutes();
-        for (const lesson of lessons) {
-            const start = lesson.start.hours * 60 + lesson.start.minutes;
-            const end = lesson.end.hours * 60 + lesson.end.minutes;
-            if (timeMinutes >= start && timeMinutes <= end) {
-                return lesson;
-            }
-        }
-        return null;
-    }
-    getWeekNumber(date) {
-        const period = isSessionPeriod(this.period)
-            ? getAdjacentSemester(this.period)
-            : this.period;
-        return getWeekNumber({
-            period,
-            year: this.getSemesterYear(period),
-            date,
-        });
-    }
-    getSemesterWeeks(weekCount) {
-        const period = isSessionPeriod(this.period)
-            ? getAdjacentSemester(this.period)
-            : this.period;
-        return getSemesterWeeks({
-            period,
-            year: this.getSemesterYear(period),
-            weekCount,
-        });
-    }
-    getSemesterStart() {
-        const period = isSessionPeriod(this.period)
-            ? getAdjacentSemester(this.period)
-            : this.period;
-        return getSemesterStart({
-            period,
-            year: this.getSemesterYear(period),
-        });
-    }
-}

package/dist/tt/utils/lessons.d.ts

@@ -1,16 +0,0 @@
-import type { FullScheduleDay, FullScheduleSlot, Lesson, ScheduleEntry, Webinar } from "../types.js";
-export declare function sortLessons(a: Lesson, b: Lesson): number;
-export declare function filterSlots(slots: FullScheduleSlot[], opts?: {
-    subgroup?: number;
-    week?: number;
-    date?: Date;
-}): FullScheduleSlot[];
-export declare function slotsToLessons(slots: FullScheduleSlot[], date: Date, opts?: {
-    isTeacherSchedule?: boolean;
-}): Lesson[];
-export declare function matchWebinarToLesson(lesson: Lesson, webinars: Webinar[]): Webinar | undefined;
-export declare function attachWebinarsToLessons(lessons: Lesson[], webinars: Webinar[]): Lesson[];
-/** All transfer entries from the given schedule days. */
-export declare function collectTransfers(days: FullScheduleDay[]): ScheduleEntry[];
-/** Remove lessons whose source date/slot match a transfer. */
-export declare function suppressTransferredLessons(lessons: Lesson[], transfers: ScheduleEntry[], date: Date): Lesson[];

package/dist/tt/utils/lessons.js

@@ -1,173 +0,0 @@
-import { isSameDay } from "./date.js";
-export function sortLessons(a, b) {
-    return a.start.date.getTime() - b.start.date.getTime();
-}
-function filterEntries(entries, opts) {
-    return entries.filter((e) => {
-        // Subgroup filter applies to all entry types
-        if (opts?.subgroup && e.subgroup && e.subgroup !== opts.subgroup) {
-            return false;
-        }
-        // Transfer entries: only include when the query date matches the target date
-        if (e.transfer) {
-            if (!opts?.date)
-                return false;
-            return isSameDay(e.transfer.targetDate, opts.date);
-        }
-        // Substitute-for entries: only include when the query date matches
-        if (e.substituteFor) {
-            if (!opts?.date)
-                return false;
-            return isSameDay(e.substituteFor.date, opts.date);
-        }
-        if (opts?.week != null) {
-            if (e.weeks.from > 0 &&
-                (opts.week < e.weeks.from || opts.week > e.weeks.to)) {
-                return false;
-            }
-            if (e.weekParity) {
-                const isEven = opts.week % 2 === 0;
-                if (e.weekParity === "even" && !isEven)
-                    return false;
-                if (e.weekParity === "odd" && isEven)
-                    return false;
-            }
-        }
-        return true;
-    });
-}
-export function filterSlots(slots, opts) {
-    if (opts?.subgroup == null && opts?.week == null && opts?.date == null)
-        return slots;
-    return slots
-        .map((slot) => ({
-        ...slot,
-        entries: filterEntries(slot.entries, opts),
-    }))
-        .filter((slot) => slot.entries.length > 0);
-}
-function makeLessonTime(date, time) {
-    const d = new Date(date);
-    d.setHours(time.hours, time.minutes, 0, 0);
-    return { date: d, hours: time.hours, minutes: time.minutes };
-}
-function isDistanceRoom(room) {
-    return /дистанционно|ДОТ/i.test(room ?? "");
-}
-export function slotsToLessons(slots, date, opts) {
-    const lessons = [];
-    for (const slot of slots) {
-        for (const entry of slot.entries) {
-            let room = entry.room;
-            let teacher = entry.teacher;
-            let isDistance = entry.isDistance || isDistanceRoom(room);
-            let originalRoom;
-            let originalTeacher;
-            // Apply date-specific substitutions
-            if (entry.substitutions) {
-                const sub = entry.substitutions.find((s) => isSameDay(s.date, date));
-                if (sub) {
-                    if (sub.room) {
-                        originalRoom = room;
-                        room = sub.room;
-                        isDistance = sub.isDistance || isDistanceRoom(room);
-                    }
-                    if (sub.teacher) {
-                        // On teacher schedules, a teacher substitution means another teacher
-                        // is taking over — exclude the lesson entirely.
-                        if (opts?.isTeacherSchedule)
-                            continue;
-                        originalTeacher = teacher;
-                        teacher = sub.teacher;
-                    }
-                }
-            }
-            lessons.push({
-                number: slot.number,
-                start: makeLessonTime(date, slot.timeStart),
-                end: makeLessonTime(date, slot.timeEnd),
-                subject: entry.subject,
-                type: entry.type,
-                room,
-                teacher,
-                groups: entry.groups,
-                weeks: entry.weeks,
-                subgroup: entry.subgroup,
-                weekParity: entry.weekParity,
-                isDistance,
-                originalRoom,
-                originalTeacher,
-                transfer: entry.transfer,
-                substituteFor: entry.substituteFor,
-                possibleChanges: entry.possibleChanges,
-            });
-        }
-    }
-    return lessons;
-}
-function normalizeText(value) {
-    return value
-        .toLowerCase()
-        .replace(/ё/g, "е")
-        .replace(/\s+/g, " ")
-        .trim();
-}
-function sameTime(lesson, webinar) {
-    return (lesson.start.hours === webinar.timeStart.hours &&
-        lesson.start.minutes === webinar.timeStart.minutes &&
-        lesson.end.hours === webinar.timeEnd.hours &&
-        lesson.end.minutes === webinar.timeEnd.minutes);
-}
-export function matchWebinarToLesson(lesson, webinars) {
-    return webinars.find((webinar) => {
-        if (!webinar.scheduled)
-            return false;
-        if (webinar.date && !isSameDay(webinar.date, lesson.start.date))
-            return false;
-        if (webinar.slotNumber != null && webinar.slotNumber !== lesson.number) {
-            return false;
-        }
-        if (!sameTime(lesson, webinar))
-            return false;
-        if (normalizeText(webinar.subject) !== normalizeText(lesson.subject)) {
-            return false;
-        }
-        if (webinar.type && lesson.type && webinar.type !== lesson.type) {
-            return false;
-        }
-        if (webinar.subgroup != null &&
-            lesson.subgroup != null &&
-            webinar.subgroup !== lesson.subgroup) {
-            return false;
-        }
-        return true;
-    });
-}
-export function attachWebinarsToLessons(lessons, webinars) {
-    return lessons.map((lesson) => {
-        const webinar = matchWebinarToLesson(lesson, webinars);
-        return webinar ? { ...lesson, webinar } : lesson;
-    });
-}
-/** All transfer entries from the given schedule days. */
-export function collectTransfers(days) {
-    const transfers = [];
-    for (const day of days) {
-        for (const slot of day.slots) {
-            for (const entry of slot.entries) {
-                if (entry.transfer)
-                    transfers.push(entry);
-            }
-        }
-    }
-    return transfers;
-}
-/** Remove lessons whose source date/slot match a transfer. */
-export function suppressTransferredLessons(lessons, transfers, date) {
-    return lessons.filter((lesson) => {
-        return !transfers.some((t) => t.transfer &&
-            isSameDay(t.transfer.fromDate, date) &&
-            t.transfer.fromSlot === lesson.number &&
-            t.transfer.subject === lesson.subject);
-    });
-}