chuvsu-js 2.8.2 → 3.0.0

package/dist/tt/utils.js

@@ -1,521 +0,0 @@
-export function getCurrentPeriod(opts) {
-    const date = opts?.date ?? new Date();
-    const month = date.getMonth();
-    const day = date.getDate();
-    // Dec 25+ and Jan → Winter session (зимняя сессия)
-    if (month === 0 || (month === 11 && day >= 25))
-        return 2 /* Period.WinterSession */;
-    // Feb–May → Spring semester (весенний семестр)
-    if (month >= 1 && month <= 4)
-        return 3 /* Period.SpringSemester */;
-    // Jun–Aug → Summer session (летняя сессия)
-    if (month >= 5 && month <= 7)
-        return 4 /* Period.SummerSession */;
-    // Sep – Dec 24 → Fall semester (осенний семестр)
-    return 1 /* Period.FallSemester */;
-}
-export function isSessionPeriod(period) {
-    return period === 2 /* Period.WinterSession */ || period === 4 /* Period.SummerSession */;
-}
-export function sortLessons(a, b) {
-    return a.start.date.getTime() - b.start.date.getTime();
-}
-const WEEKDAY_NAMES = [
-    "Воскресенье",
-    "Понедельник",
-    "Вторник",
-    "Среда",
-    "Четверг",
-    "Пятница",
-    "Суббота",
-];
-export function getWeekdayName(weekday) {
-    return WEEKDAY_NAMES[weekday] ?? "";
-}
-export function getMonday(date) {
-    const d = new Date(date);
-    const day = d.getDay();
-    const diff = day === 0 ? -6 : 1 - day;
-    d.setDate(d.getDate() + diff);
-    d.setHours(0, 0, 0, 0);
-    return d;
-}
-/**
- * Get the start date of a semester.
- * Fall: September 1 of the given year.
- * Spring: first Monday of February of the given year.
- */
-export function getSemesterStart(opts) {
-    const year = opts.year ?? new Date().getFullYear();
-    if (opts.period === 1 /* Period.FallSemester */) {
-        return new Date(year, 8, 1); // September 1
-    }
-    // Spring: first Monday of February
-    const feb1 = new Date(year, 1, 1);
-    const day = feb1.getDay();
-    const daysToAdd = day === 1 ? 0 : day === 0 ? 1 : 8 - day;
-    const firstMonday = new Date(year, 1, 1 + daysToAdd);
-    firstMonday.setHours(0, 0, 0, 0);
-    return firstMonday;
-}
-/**
- * Get all weeks in a semester with their start/end dates.
- * Week 0 starts from the semester start date.
- */
-export function getSemesterWeeks(opts) {
-    const weekCount = opts.weekCount ?? 17;
-    const semesterStart = getSemesterStart(opts);
-    const startMonday = getMonday(semesterStart);
-    const weeks = [];
-    for (let i = 0; i <= weekCount; i++) {
-        const start = new Date(startMonday);
-        start.setDate(startMonday.getDate() + i * 7);
-        const end = new Date(start);
-        end.setDate(start.getDate() + 6);
-        end.setHours(23, 59, 59, 999);
-        weeks.push({ week: i, start, end });
-    }
-    return weeks;
-}
-/**
- * Get the current week number within a semester.
- */
-export function getWeekNumber(opts) {
-    const date = opts.date ?? new Date();
-    const semesterStart = getSemesterStart(opts);
-    const startMonday = getMonday(semesterStart);
-    const targetMonday = getMonday(date);
-    const diff = targetMonday.getTime() - startMonday.getTime();
-    return Math.floor(diff / (7 * 24 * 60 * 60 * 1000));
-}
-function isSameDay(a, b) {
-    return (a.getFullYear() === b.getFullYear() &&
-        a.getMonth() === b.getMonth() &&
-        a.getDate() === b.getDate());
-}
-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 };
-}
-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 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;
-                    }
-                    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,
-                originalRoom,
-                originalTeacher,
-                transfer: entry.transfer,
-                substituteFor: entry.substituteFor,
-                possibleChanges: entry.possibleChanges,
-            });
-        }
-    }
-    return lessons;
-}
-/** Collect all transfer entries from 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);
-    });
-}
-// --- Lesson time slots ---
-const VO_TIME_SLOTS = [
-    {
-        number: 1,
-        start: { hours: 8, minutes: 20 },
-        end: { hours: 9, minutes: 40 },
-    },
-    {
-        number: 2,
-        start: { hours: 9, minutes: 50 },
-        end: { hours: 11, minutes: 10 },
-    },
-    {
-        number: 3,
-        start: { hours: 11, minutes: 40 },
-        end: { hours: 13, minutes: 0 },
-    },
-    {
-        number: 4,
-        start: { hours: 13, minutes: 30 },
-        end: { hours: 14, minutes: 50 },
-    },
-    {
-        number: 5,
-        start: { hours: 15, minutes: 0 },
-        end: { hours: 16, minutes: 20 },
-    },
-    {
-        number: 6,
-        start: { hours: 16, minutes: 40 },
-        end: { hours: 18, minutes: 0 },
-    },
-    {
-        number: 7,
-        start: { hours: 18, minutes: 10 },
-        end: { hours: 19, minutes: 30 },
-    },
-    {
-        number: 8,
-        start: { hours: 19, minutes: 40 },
-        end: { hours: 21, minutes: 0 },
-    },
-];
-const SPO_TIME_SLOTS = [
-    {
-        number: 1,
-        start: { hours: 8, minutes: 10 },
-        end: { hours: 9, minutes: 40 },
-    },
-    {
-        number: 2,
-        start: { hours: 9, minutes: 55 },
-        end: { hours: 11, minutes: 25 },
-    },
-    {
-        number: 3,
-        start: { hours: 11, minutes: 55 },
-        end: { hours: 13, minutes: 25 },
-    },
-    {
-        number: 4,
-        start: { hours: 13, minutes: 40 },
-        end: { hours: 15, minutes: 10 },
-    },
-    {
-        number: 5,
-        start: { hours: 15, minutes: 25 },
-        end: { hours: 16, minutes: 55 },
-    },
-    {
-        number: 6,
-        start: { hours: 17, minutes: 10 },
-        end: { hours: 18, minutes: 40 },
-    },
-    {
-        number: 7,
-        start: { hours: 18, minutes: 55 },
-        end: { hours: 20, minutes: 25 },
-    },
-];
-export function getTimeSlots(educationType) {
-    return educationType === 2 /* EducationType.VocationalEducation */
-        ? SPO_TIME_SLOTS
-        : VO_TIME_SLOTS;
-}
-function timeToMinutes(t) {
-    return t.hours * 60 + t.minutes;
-}
-export function getLessonNumber(time, educationType) {
-    const slots = getTimeSlots(educationType);
-    const target = timeToMinutes(time);
-    let closest = slots[0];
-    let minDiff = Math.abs(timeToMinutes(closest.start) - target);
-    for (let i = 1; i < slots.length; i++) {
-        const diff = Math.abs(timeToMinutes(slots[i].start) - target);
-        if (diff < minDiff) {
-            minDiff = diff;
-            closest = slots[i];
-        }
-    }
-    return closest.number;
-}
-export function getAdjacentSemester(session) {
-    return session === 2 /* Period.WinterSession */
-        ? 1 /* Period.FallSemester */
-        : 3 /* Period.SpringSemester */;
-}
-/** Russian non-working public holidays (Статья 112 ТК РФ). */
-export const RUSSIAN_HOLIDAYS = [
-    { month: 1, day: 1, name: "Новый год" },
-    { month: 1, day: 2, name: "Новогодние каникулы" },
-    { month: 1, day: 3, name: "Новогодние каникулы" },
-    { month: 1, day: 4, name: "Новогодние каникулы" },
-    { month: 1, day: 5, name: "Новогодние каникулы" },
-    { month: 1, day: 6, name: "Новогодние каникулы" },
-    { month: 1, day: 7, name: "Рождество Христово" },
-    { month: 1, day: 8, name: "Новогодние каникулы" },
-    { month: 2, day: 23, name: "День защитника Отечества" },
-    { month: 3, day: 8, name: "Международный женский день" },
-    { month: 5, day: 1, name: "Праздник Весны и Труда" },
-    { month: 5, day: 9, name: "День Победы" },
-    { month: 6, day: 12, name: "День России" },
-    { month: 11, day: 4, name: "День народного единства" },
-];
-/**
- * January holiday dates (1–8) are excluded from automatic weekend transfer
- * per Art. 112 ТК РФ. Their transfers are decided by government decree.
- */
-function isJanuaryHoliday(h) {
-    return h.month === 1 && h.day >= 1 && h.day <= 8;
-}
-/**
- * Compute bridge-day transfers for non-January holidays.
- *
- * Pattern (consistent across government decrees):
- * - Holiday on Tuesday → Monday becomes day off, preceding Saturday is work day
- * - Holiday on Thursday → Friday becomes day off, following Saturday is work day
- *   (only for 5-day week; 6-day week has Saturday classes, so no gap to bridge)
- *
- * January holidays are excluded (their 2 transfers are unpredictable).
- */
-function computeBridgeDays(year, holidays, effectiveDays, sixDayWeek) {
-    const bridges = [];
-    for (const h of holidays) {
-        if (isJanuaryHoliday(h))
-            continue;
-        const date = new Date(year, h.month - 1, h.day);
-        const dow = date.getDay();
-        if (dow === 2) {
-            // Tuesday → Monday off, preceding Saturday works
-            const monday = new Date(date);
-            monday.setDate(date.getDate() - 1);
-            const saturday = new Date(date);
-            saturday.setDate(date.getDate() - 3);
-            if (!effectiveDays.some((d) => isSameDay(d, monday))) {
-                bridges.push({
-                    dayOff: monday,
-                    workDay: sixDayWeek ? null : saturday,
-                });
-            }
-        }
-        else if (dow === 4 && !sixDayWeek) {
-            // Thursday → Friday off, following Saturday works
-            // Only for 5-day week: 6-day week has no gap (Saturday is a work day)
-            const friday = new Date(date);
-            friday.setDate(date.getDate() + 1);
-            const saturday = new Date(date);
-            saturday.setDate(date.getDate() + 2);
-            if (!effectiveDays.some((d) => isSameDay(d, friday))) {
-                bridges.push({ dayOff: friday, workDay: saturday });
-            }
-        }
-    }
-    return bridges;
-}
-/**
- * Compute effective non-working holiday dates for a given year.
- *
- * Rules (Art. 112 ТК РФ):
- * 1. All holidays in the list are non-working days.
- * 2. For non-January holidays: if a holiday falls on Sat/Sun, the day off
- *    automatically transfers to the next working day.
- * 3. For January holidays (1–8): weekend transfers are NOT automatic —
- *    they are decided by annual government decree. Pass them via `transfers`.
- * 4. Bridge days: if a non-January holiday falls on Tue, Mon is day off
- *    (preceding Sat works); if on Thu, Fri is day off (following Sat works).
- *    Computed automatically, can be overridden via `transfers`.
- * 5. Government decree transfers (`transfers`) add extra days off and
- *    override auto-computed bridge days.
- * 6. For 6-day week (`sixDayWeek`): Saturday is a work day, so
- *    Thursday bridges don't apply and Saturday holidays don't auto-transfer.
- */
-export function getEffectiveHolidays(year, holidays = RUSSIAN_HOLIDAYS, transfers = [], sixDayWeek = true) {
-    const originalDates = holidays.map((h) => new Date(year, h.month - 1, h.day));
-    const isOriginalHoliday = (d) => originalDates.some((od) => isSameDay(od, d));
-    const effectiveDays = [...originalDates];
-    // Auto-transfer: only non-January holidays that fall on weekends
-    const nonJanuaryOnWeekend = holidays
-        .filter((h) => !isJanuaryHoliday(h))
-        .map((h) => new Date(year, h.month - 1, h.day))
-        .filter((d) => d.getDay() === 0 || d.getDay() === 6)
-        .sort((a, b) => a.getTime() - b.getTime());
-    for (const holiday of nonJanuaryOnWeekend) {
-        let candidate = new Date(holiday);
-        if (candidate.getDay() === 6) {
-            candidate.setDate(candidate.getDate() + 2);
-        }
-        else {
-            candidate.setDate(candidate.getDate() + 1);
-        }
-        while (candidate.getDay() === 0 ||
-            candidate.getDay() === 6 ||
-            isOriginalHoliday(candidate) ||
-            effectiveDays.some((ed) => isSameDay(ed, candidate))) {
-            candidate.setDate(candidate.getDate() + 1);
-        }
-        effectiveDays.push(new Date(candidate));
-    }
-    // Bridge days (auto-computed, can be overridden)
-    const autoBridges = computeBridgeDays(year, holidays, effectiveDays, sixDayWeek);
-    // Merge: explicit transfers override auto-computed bridges
-    const allTransfers = [...autoBridges];
-    for (const t of transfers) {
-        const idx = allTransfers.findIndex((b) => isSameDay(b.dayOff, t.dayOff));
-        if (idx !== -1) {
-            allTransfers[idx] = t;
-        }
-        else {
-            allTransfers.push(t);
-        }
-    }
-    const compensatingWorkDays = [];
-    for (const t of allTransfers) {
-        if (!effectiveDays.some((d) => isSameDay(d, t.dayOff))) {
-            effectiveDays.push(t.dayOff);
-        }
-        if (t.workDay) {
-            compensatingWorkDays.push(t.workDay);
-        }
-    }
-    return effectiveDays.sort((a, b) => a.getTime() - b.getTime());
-}
-/**
- * Compute all transfers (auto bridges + explicit) for a given year.
- * Useful for getting compensating work days (Saturdays that become working).
- */
-export function getHolidayTransfers(year, holidays = RUSSIAN_HOLIDAYS, transfers = [], sixDayWeek) {
-    const originalDates = holidays.map((h) => new Date(year, h.month - 1, h.day));
-    const effectiveDays = [...originalDates];
-    // Replay weekend transfers to build effectiveDays for bridge computation
-    const nonJanuaryOnWeekend = holidays
-        .filter((h) => !isJanuaryHoliday(h))
-        .map((h) => new Date(year, h.month - 1, h.day))
-        .filter((d) => d.getDay() === 0 || d.getDay() === 6)
-        .sort((a, b) => a.getTime() - b.getTime());
-    const isOriginalHoliday = (d) => originalDates.some((od) => isSameDay(od, d));
-    for (const holiday of nonJanuaryOnWeekend) {
-        let candidate = new Date(holiday);
-        if (candidate.getDay() === 6) {
-            candidate.setDate(candidate.getDate() + 2);
-        }
-        else {
-            candidate.setDate(candidate.getDate() + 1);
-        }
-        while (candidate.getDay() === 0 ||
-            candidate.getDay() === 6 ||
-            isOriginalHoliday(candidate) ||
-            effectiveDays.some((ed) => isSameDay(ed, candidate))) {
-            candidate.setDate(candidate.getDate() + 1);
-        }
-        effectiveDays.push(new Date(candidate));
-    }
-    const autoBridges = computeBridgeDays(year, holidays, effectiveDays, sixDayWeek);
-    const allTransfers = [...autoBridges];
-    for (const t of transfers) {
-        const idx = allTransfers.findIndex((b) => isSameDay(b.dayOff, t.dayOff));
-        if (idx !== -1) {
-            allTransfers[idx] = t;
-        }
-        else {
-            allTransfers.push(t);
-        }
-    }
-    return allTransfers;
-}
-/**
- * Returns the list of compensating work days (e.g. Saturdays that become working).
- * Includes both auto-computed bridge compensations and explicit transfers.
- */
-export function getCompensatingWorkDays(year, holidays = RUSSIAN_HOLIDAYS, transfers = [], sixDayWeek) {
-    return getHolidayTransfers(year, holidays, transfers, sixDayWeek)
-        .filter((t) => t.workDay != null)
-        .map((t) => t.workDay);
-}
-/**
- * Returns true if the given date is a non-working holiday,
- * including transferred holidays when they fall on weekends (Art. 112 ТК РФ)
- * and auto-computed bridge days.
- * Pass an empty array for `holidays` to disable holiday checking.
- */
-export function isHoliday(date, holidays = RUSSIAN_HOLIDAYS, transfers = [], sixDayWeek = true) {
-    if (holidays.length === 0 && transfers.length === 0)
-        return false;
-    const year = date.getFullYear();
-    const effectiveDays = getEffectiveHolidays(year, holidays, transfers, sixDayWeek);
-    return effectiveDays.some((d) => isSameDay(d, date));
-}