@hebcal/core 3.41.2 → 3.42.0

package/hebcal.d.ts

@@ -292,6 +292,7 @@ declare module '@hebcal/core' {
         tzeit(hdate: Date | HDate, angle?: number): Date;
         /**
          * Builds a city description from geonameid string components
+         * @deprecated
          * @param cityName e.g. 'Tel Aviv' or 'Chicago'
          * @param admin1 e.g. 'England' or 'Massachusetts'
          * @param countryName full country name, e.g. 'Israel' or 'United States'
@@ -603,6 +604,15 @@ declare module '@hebcal/core' {
         hour12?: boolean;
     };
 
+    export type TachanunResult = {
+        /** Tachanun is said at Shacharit */
+        shacharit: boolean;
+        /** Tachanun is said at Mincha */
+        mincha: boolean;
+        /** All congregations say Tachanun on the day */
+        allCongs: boolean;
+    };
+
     /**
      * HebrewCalendar is the main interface to the `@hebcal/core` library.
      * This class is used to calculate holidays, rosh chodesh, candle lighting & havdalah times,
@@ -712,6 +722,40 @@ declare module '@hebcal/core' {
          * created and cached instance.
          */
         static getSedra(hyear: number, il: boolean): Sedra;
+
+        /**
+         * Return a number containing information on what Hallel is said on that day.
+         *
+         * Whole Hallel is said on Chanukah, the first Yom Tov of Pesach, Shavuot, Sukkot,
+         * Yom Ha'atzmaut, and Yom Yerushalayim.
+         *
+         * Half Hallel is said on Rosh Chodesh (not Rosh Hashanah), and the last 6 days of Pesach.
+         *
+         * The number is one of the following values:
+         *
+         * 0 - No Hallel
+         * 1 - Half Hallel
+         * 2 - Whole Hallel
+         */
+        static hallel(hdate: HDate, il: boolean): number;
+
+        /**
+         * Return details on what Tachanun (or Tzidchatcha on Shabbat) is said on `hdate`.
+         *
+         * Tachanun is not said on Rosh Chodesh, the month of Nisan, Lag Baomer,
+         * Rosh Chodesh Sivan until Isru Chag, Tisha B'av, 15 Av, Erev Rosh Hashanah,
+         * Rosh Hashanah, Erev Yom Kippur until after Simchat Torah, Chanukah,
+         * Tu B'shvat, Purim and Shushan Purim, and Purim and Shushan Purim Katan.
+         *
+         * In some congregations Tachanun is not said until from Rosh Chodesh Sivan
+         * until 14th Sivan, Sukkot until after Rosh Chodesh Cheshvan, Pesach Sheini,
+         * Yom Ha'atzmaut, and Yom Yerushalayim.
+         *
+         * Tachanun is not said at Mincha on days before it is not said at Shacharit.
+         *
+         * Tachanun is not said at Shacharit on Shabbat, but is at Mincha, usually.
+         */
+        static tachanun(hdate: HDate, il: boolean): TachanunResult;
     }
 
     /**
@@ -786,6 +830,7 @@ declare module '@hebcal/core' {
         static daysInMonth(month: number, year: number): number;
         /**
          * Returns number of days since January 1 of that year
+         * @deprecated
          * @param date - Gregorian date
          */
         static dayOfYear(date: Date): number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hebcal/core",
-  "version": "3.41.2",
+  "version": "3.42.0",
   "author": "Michael J. Radwin (https://github.com/mjradwin)",
   "contributors": [
     "Eyal Schachter (https://github.com/Scimonster)",
@@ -63,9 +63,9 @@
     "verbose": true
   },
   "devDependencies": {
-    "@babel/core": "^7.18.5",
-    "@babel/preset-env": "^7.18.2",
-    "@babel/register": "^7.17.7",
+    "@babel/core": "^7.18.6",
+    "@babel/preset-env": "^7.18.6",
+    "@babel/register": "^7.18.6",
     "@hebcal/solar-calc": "^1.1.2",
     "@rollup/plugin-babel": "^5.3.1",
     "@rollup/plugin-commonjs": "^22.0.1",
@@ -73,7 +73,7 @@
     "@rollup/plugin-node-resolve": "^13.3.0",
     "ava": "^4.3.0",
     "codecov": "^3.8.3",
-    "core-js": "^3.23.2",
+    "core-js": "^3.23.3",
     "eslint": "^8.18.0",
     "eslint-config-google": "^0.14.0",
     "jsdoc": "^3.6.10",