bizdays-toolkit 0.2.0 → 0.3.0

package/dist/jp/rules.d.ts

@@ -9,8 +9,11 @@
  *   内閣府の CSV で検証している。それより後の年は confirmed: false
  */
 import type { Holiday } from "../core/types.ts";
-/** 日本の祝日・休日の種別 */
-export type JapaneseHolidayKind = 
+/**
+ * 日本の祝日・休日の種別（既知の値）。
+ * @public
+ */
+export type KnownJapaneseHolidayKind = 
 /** 国民の祝日 */
 "national"
 /** 振替休日 */
@@ -19,18 +22,24 @@ export type JapaneseHolidayKind =
  | "citizens"
 /** 皇室行事などによる特例の休日 */
  | "special";
-/** 対応年 */
+/**
+ * 日本の祝日・休日の種別。将来の版で値が増えることがあるので、分岐では「その他」も扱うこと。
+ * すべての値を網羅したことを型で確かめたい場合は KnownJapaneseHolidayKind を使う。
+ * @public
+ */
+export type JapaneseHolidayKind = KnownJapaneseHolidayKind | (string & {});
+/** @internal 対応年 */
 export declare const SUPPORTED_YEARS: Readonly<{
     from: 1955;
     to: 2099;
 }>;
-/** 春分・秋分の日が官報で確定している最後の年 */
+/** @internal 春分・秋分の日が官報で確定している最後の年 */
 export declare const CONFIRMED_THROUGH = 2027;
-/** 反映済みの官報の年月（2027 年の春分・秋分の日の公表） */
+/** @internal 反映済みの官報の年月（2027 年の春分・秋分の日の公表） */
 export declare const DATA_VERSION = "2026-02";
-/** 春分日（3 月の日） */
+/** @internal 春分日（3 月の日） */
 export declare function vernalEquinoxDay(year: number): number;
-/** 秋分日（9 月の日） */
+/** @internal 秋分日（9 月の日） */
 export declare function autumnalEquinoxDay(year: number): number;
-/** その年の祝日・休日（日付順） */
+/** @internal その年の祝日・休日（日付順） */
 export declare function computeJapaneseHolidays(year: number): Holiday<JapaneseHolidayKind>[];

package/dist/jp/rules.js

@@ -9,11 +9,12 @@
  *   内閣府の CSV で検証している。それより後の年は confirmed: false
  */
 import { addDays, formatDate, nthWeekdayOfMonth, weekdayOf, } from "../core/date.js";
-/** 対応年 */
+import { rangeError } from "../core/errors.js";
+/** @internal 対応年 */
 export const SUPPORTED_YEARS = Object.freeze({ from: 1955, to: 2099 });
-/** 春分・秋分の日が官報で確定している最後の年 */
+/** @internal 春分・秋分の日が官報で確定している最後の年 */
 export const CONFIRMED_THROUGH = 2027;
-/** 反映済みの官報の年月（2027 年の春分・秋分の日の公表） */
+/** @internal 反映済みの官報の年月（2027 年の春分・秋分の日の公表） */
 export const DATA_VERSION = "2026-02";
 const SUBSTITUTE_START = "1973-04-12";
 const SUBSTITUTE_2007 = "2007-01-01";
@@ -37,14 +38,14 @@ const SPECIAL_DAYS = [
 ];
 // 近似式の int() は 0 方向への切り捨て。1979 年以前は (year - 1983) / 4 が負になるため
 // Math.floor ではなく Math.trunc を使う（floor だと 1 日ずれる年がある）
-/** 春分日（3 月の日） */
+/** @internal 春分日（3 月の日） */
 export function vernalEquinoxDay(year) {
     if (year <= 1979) {
         return Math.floor(20.8357 + 0.242194 * (year - 1980) - Math.trunc((year - 1983) / 4));
     }
     return Math.floor(20.8431 + 0.242194 * (year - 1980) - Math.floor((year - 1980) / 4));
 }
-/** 秋分日（9 月の日） */
+/** @internal 秋分日（9 月の日） */
 export function autumnalEquinoxDay(year) {
     if (year <= 1979) {
         return Math.floor(23.2588 + 0.242194 * (year - 1980) - Math.trunc((year - 1983) / 4));
@@ -118,10 +119,10 @@ function baseHolidays(y) {
     }
     return list.sort((a, b) => (a.date < b.date ? -1 : 1));
 }
-/** その年の祝日・休日（日付順） */
+/** @internal その年の祝日・休日（日付順） */
 export function computeJapaneseHolidays(year) {
     if (!Number.isInteger(year) || year < SUPPORTED_YEARS.from || year > SUPPORTED_YEARS.to) {
-        throw new RangeError(`Japanese holidays are supported for ${SUPPORTED_YEARS.from}-${SUPPORTED_YEARS.to}; requested ${year}`);
+        throw rangeError("out-of-range", `Japanese holidays are supported for ${SUPPORTED_YEARS.from}-${SUPPORTED_YEARS.to}; requested ${year}`);
     }
     const base = baseHolidays(year);
     const byDate = new Map(base.map((e) => [e.date, e]));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bizdays-toolkit",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Holidays, business-day calendar and day-by-day schedules (e.g. store hours) with time zone support. Japanese holidays verified against the Cabinet Office data. / 祝日と営業日のカレンダー（タイムゾーン対応・日本の祝日は内閣府データで全日照合）",
   "keywords": [
     "bizdays",
@@ -46,12 +46,14 @@
     "build": "rm -rf dist && tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit",
     "test": "node --test \"test/**/*.test.ts\"",
+    "test:tz": "node scripts/test-tz.ts",
     "fmt": "oxfmt",
     "fmt:check": "oxfmt --check",
-    "check": "pnpm typecheck && pnpm test && pnpm build && pnpm fmt:check && node scripts/check-package.ts",
+    "check": "pnpm typecheck && pnpm test && pnpm test:tz && pnpm build && pnpm fmt:check && node scripts/check-package.ts && node scripts/check-size.ts && node scripts/api-report.ts",
     "verify:cao": "node scripts/verify-cao.ts",
     "prepublishOnly": "pnpm check",
-    "release-notes": "node scripts/release-notes.ts"
+    "release-notes": "node scripts/release-notes.ts",
+    "api:update": "pnpm build && node scripts/api-report.ts --update"
   },
   "devDependencies": {
     "@types/node": "24.19.2",