@timestamp-js/calendar-saka 0.1.0-rc.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jeff Galbraith
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# @timestamp-js/calendar-saka
+
+Indian National Calendar (Saka) adapter for `@timestamp-js/core`.
+
+The adapter is `indianNationalCalendar`, with `sakaCalendar` as a convenience alias. It models the
+official Indian National Calendar using deterministic Gregorian-aligned leap-year rules.
+
+```ts
+import {
+  createCalendarDayList,
+  getCalendarEndOfMonth,
+  getCalendarEndOfWeek,
+  getCalendarStartOfMonth,
+  getCalendarStartOfWeek,
+  gregorianCalendar,
+  parseCalendarTimestamp,
+} from '@timestamp-js/core'
+import { indianNationalCalendar } from '@timestamp-js/calendar-saka'
+
+const sakaNewYear = { year: 1946, month: 1, day: 1 }
+const gregorian = gregorianCalendar.fromEpochDay(indianNationalCalendar.toEpochDay(sakaNewYear))
+
+gregorian // { year: 2024, month: 3, day: 21 }
+
+const visible = parseCalendarTimestamp('1946-01-15', indianNationalCalendar)!
+const weekdays = [0, 1, 2, 3, 4, 5, 6]
+
+const weekStart = getCalendarStartOfWeek(visible, weekdays, indianNationalCalendar)
+const weekEnd = getCalendarEndOfWeek(visible, weekdays, indianNationalCalendar)
+const weekDays = createCalendarDayList(weekStart, weekEnd, visible, indianNationalCalendar)
+
+weekStart.date // '1946-01-11'
+weekEnd.date // '1946-01-17'
+weekDays.length // 7
+
+const monthStart = getCalendarStartOfMonth(visible, indianNationalCalendar)
+const monthEnd = getCalendarEndOfMonth(visible, indianNationalCalendar)
+const monthDays = createCalendarDayList(monthStart, monthEnd, visible, indianNationalCalendar)
+
+monthStart.date // '1946-01-01'
+monthEnd.date // '1946-01-31'
+monthDays.length // 31
+```
+
+This package is early calendar-adapter work. Treat the adapter contract as release-candidate API
+until `@timestamp-js/core` reaches a stable `1.0.0`.

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import type { CalendarSystem } from '@timestamp-js/core';
+/**
+ * Returns true when the Saka year begins in a Gregorian leap year.
+ *
+ * @param year Saka year number.
+ * @returns True when Chaitra has 31 days.
+ * @category calendar
+ */
+export declare function isSakaLeapYear(year: number): boolean;
+/**
+ * Returns days in an Indian National Calendar (Saka) month.
+ *
+ * @param year Saka year number.
+ * @param month Saka month number, where Chaitra is `1`.
+ * @returns Number of days in the month, or `0` for an invalid month number.
+ * @category calendar
+ */
+export declare function sakaDaysInMonth(year: number, month: number): number;
+/**
+ * Deterministic Indian National Calendar (Saka) adapter.
+ *
+ * Saka year `1` begins in Gregorian year `79`. A Saka year starts on March 21
+ * when the corresponding Gregorian year is leap, and March 22 otherwise.
+ */
+export declare const indianNationalCalendar: CalendarSystem;
+/**
+ * Alias for the default Saka adapter exported by this package.
+ */
+export declare const sakaCalendar: CalendarSystem;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAqC3E;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAYnE;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,cAwEnC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,gBAAyB,CAAA"}

package/dist/index.js

@@ -0,0 +1,124 @@
+import { gregorianCalendar } from '@timestamp-js/core';
+const GREGORIAN_YEAR_OFFSET = 78;
+const MONTHS_IN_YEAR = 12;
+const SAKA_DAYS_IN_MONTH_COMMON = [0, 30, 31, 31, 31, 31, 31, 30, 30, 30, 30, 30, 30];
+const SAKA_DAYS_IN_MONTH_LEAP = [0, 31, 31, 31, 31, 31, 31, 30, 30, 30, 30, 30, 30];
+function assertPositiveYear(year) {
+    if (year < 1) {
+        throw new RangeError('Saka calendar years start at 1.');
+    }
+}
+function getGregorianYearForSakaYear(year) {
+    assertPositiveYear(year);
+    return year + GREGORIAN_YEAR_OFFSET;
+}
+function getSakaYearStartEpochDay(year) {
+    const gregorianYear = getGregorianYearForSakaYear(year);
+    return gregorianCalendar.toEpochDay({
+        year: gregorianYear,
+        month: 3,
+        day: gregorianCalendar.isLeapYear(gregorianYear) === true ? 21 : 22,
+    });
+}
+function daysBeforeMonth(year, month) {
+    let days = 0;
+    for (let currentMonth = 1; currentMonth < month; currentMonth += 1) {
+        days += sakaDaysInMonth(year, currentMonth);
+    }
+    return days;
+}
+/**
+ * Returns true when the Saka year begins in a Gregorian leap year.
+ *
+ * @param year Saka year number.
+ * @returns True when Chaitra has 31 days.
+ * @category calendar
+ */
+export function isSakaLeapYear(year) {
+    return gregorianCalendar.isLeapYear(getGregorianYearForSakaYear(year));
+}
+/**
+ * Returns days in an Indian National Calendar (Saka) month.
+ *
+ * @param year Saka year number.
+ * @param month Saka month number, where Chaitra is `1`.
+ * @returns Number of days in the month, or `0` for an invalid month number.
+ * @category calendar
+ */
+export function sakaDaysInMonth(year, month) {
+    assertPositiveYear(year);
+    if (month < 1 || month > MONTHS_IN_YEAR) {
+        return 0;
+    }
+    return (isSakaLeapYear(year) === true
+        ? SAKA_DAYS_IN_MONTH_LEAP[month]
+        : SAKA_DAYS_IN_MONTH_COMMON[month]);
+}
+/**
+ * Deterministic Indian National Calendar (Saka) adapter.
+ *
+ * Saka year `1` begins in Gregorian year `79`. A Saka year starts on March 21
+ * when the corresponding Gregorian year is leap, and March 22 otherwise.
+ */
+export const indianNationalCalendar = Object.freeze({
+    id: 'saka',
+    intlCalendar: 'indian',
+    label: 'Indian National (Saka)',
+    monthsInYear() {
+        return MONTHS_IN_YEAR;
+    },
+    isLeapYear(year) {
+        return isSakaLeapYear(year);
+    },
+    daysInMonth(year, month) {
+        return sakaDaysInMonth(year, month);
+    },
+    toEpochDay(date) {
+        assertPositiveYear(date.year);
+        return (getSakaYearStartEpochDay(date.year) + daysBeforeMonth(date.year, date.month) + date.day - 1);
+    },
+    fromEpochDay(epochDay) {
+        const gregorianDate = gregorianCalendar.fromEpochDay(epochDay);
+        let year = gregorianDate.year - GREGORIAN_YEAR_OFFSET;
+        let yearStart = getSakaYearStartEpochDay(year);
+        if (epochDay < yearStart) {
+            year -= 1;
+            yearStart = getSakaYearStartEpochDay(year);
+        }
+        let dayOfYear = epochDay - yearStart;
+        let month = 1;
+        while (month < MONTHS_IN_YEAR) {
+            const daysInCurrentMonth = this.daysInMonth(year, month);
+            if (dayOfYear < daysInCurrentMonth) {
+                break;
+            }
+            dayOfYear -= daysInCurrentMonth;
+            month += 1;
+        }
+        return {
+            year,
+            month,
+            day: dayOfYear + 1,
+        };
+    },
+    addDays(date, amount) {
+        return this.fromEpochDay(this.toEpochDay(date) + amount);
+    },
+    nextDay(date) {
+        return this.addDays(date, 1);
+    },
+    prevDay(date) {
+        return this.addDays(date, -1);
+    },
+    getDayOfYear(date) {
+        return this.toEpochDay(date) - this.toEpochDay({ year: date.year, month: 1, day: 1 }) + 1;
+    },
+    getWeekday(date) {
+        return gregorianCalendar.getWeekday(gregorianCalendar.fromEpochDay(this.toEpochDay(date)));
+    },
+});
+/**
+ * Alias for the default Saka adapter exported by this package.
+ */
+export const sakaCalendar = indianNationalCalendar;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@timestamp-js/calendar-saka",
+  "version": "0.1.0-rc.1",
+  "description": "Indian National Calendar (Saka) adapter for Timestamp.",
+  "keywords": [
+    "calendar",
+    "date",
+    "indian",
+    "saka",
+    "timestamp",
+    "typescript"
+  ],
+  "homepage": "https://github.com/hawkeye64/timestamp#readme",
+  "bugs": {
+    "url": "https://github.com/hawkeye64/timestamp/issues"
+  },
+  "license": "MIT",
+  "author": "Jeff <galbraith64@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hawkeye64/timestamp.git"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@timestamp-js/core": "0.1.0-rc.1"
+  },
+  "devDependencies": {
+    "@types/node": "26.0.1",
+    "oxfmt": "0.56.0",
+    "oxlint": "1.71.0",
+    "typescript": "6.0.3",
+    "vitest": "4.1.9"
+  },
+  "engines": {
+    "node": ">=22.13",
+    "pnpm": ">=11.5.0"
+  },
+  "scripts": {
+    "clean": "rm -rf dist node_modules",
+    "prebuild": "pnpm --filter @timestamp-js/core build",
+    "build": "tsc -p tsconfig.build.json",
+    "format": "oxfmt",
+    "format:check": "oxfmt --check",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix",
+    "pretest": "pnpm --filter @timestamp-js/core build",
+    "test": "vitest run",
+    "pretypecheck": "pnpm --filter @timestamp-js/core build",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "verify": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm test && pnpm build"
+  }
+}