chuvsu-js 3.0.0 → 3.0.1

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

@@ -2,12 +2,15 @@ import { Period } from "../../common/types.js";
 import type { SemesterWeek } from "../types.js";
 /**
  * Start date of a semester.
- * Fall: September 1 of the given year.
- * Spring: first Monday of February of the given year.
+ * Fall: September 1 of the semester year.
+ * Spring: first Monday of February of the semester year.
+ * If year is omitted, the semester year is derived from the current
+ * academic year instead of the calendar year.
  */
 export declare function getSemesterStart(opts: {
     period: Period;
     year?: number;
+    date?: Date;
 }): Date;
 /**
  * All weeks in a semester with their start/end dates.
@@ -16,10 +19,12 @@ export declare function getSemesterStart(opts: {
 export declare function getSemesterWeeks(opts: {
     period: Period;
     year?: number;
+    date?: Date;
     weekCount?: number;
 }): SemesterWeek[];
 /** Current week number within a semester. */
 export declare function getWeekNumber(opts: {
     period: Period;
+    year?: number;
     date?: Date;
 }): number;

package/dist/tt/utils/semester.js

@@ -1,11 +1,28 @@
 import { getMonday } from "./date.js";
+function getAcademicYearStartYear(date) {
+    const year = date.getFullYear();
+    const month = date.getMonth();
+    // Academic year starts in September.
+    return month >= 8 ? year : year - 1;
+}
+function resolveSemesterYear(opts) {
+    if (opts.year != null)
+        return opts.year;
+    const baseDate = opts.date ?? new Date();
+    const academicYearStart = getAcademicYearStartYear(baseDate);
+    return opts.period === 1 /* Period.FallSemester */
+        ? academicYearStart
+        : academicYearStart + 1;
+}
 /**
  * Start date of a semester.
- * Fall: September 1 of the given year.
- * Spring: first Monday of February of the given year.
+ * Fall: September 1 of the semester year.
+ * Spring: first Monday of February of the semester year.
+ * If year is omitted, the semester year is derived from the current
+ * academic year instead of the calendar year.
  */
 export function getSemesterStart(opts) {
-    const year = opts.year ?? new Date().getFullYear();
+    const year = resolveSemesterYear(opts);
     if (opts.period === 1 /* Period.FallSemester */) {
         return new Date(year, 8, 1); // September 1
     }
@@ -39,7 +56,7 @@ export function getSemesterWeeks(opts) {
 /** Current week number within a semester. */
 export function getWeekNumber(opts) {
     const date = opts.date ?? new Date();
-    const semesterStart = getSemesterStart(opts);
+    const semesterStart = getSemesterStart({ ...opts, date });
     const startMonday = getMonday(semesterStart);
     const targetMonday = getMonday(date);
     const diff = targetMonday.getTime() - startMonday.getTime();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chuvsu-js",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Node.js library for ChuvSU student portal (lk.chuvsu.ru) and schedule (tt.chuvsu.ru)",
   "type": "module",
   "main": "dist/index.js",