bizdays-toolkit 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -4,6 +4,16 @@
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-10-16
+
+### Added
+
+- 祝日（`Holiday`）に、ほかの言語の名称 `names`（省略可能。キーは BCP 47 の言語タグの正規の形。例: `{ "zh-Hant": "…", ko: "…" }`）を追加した。利用者が実装した提供元が付けた `names` を、提供元のデータの検証で確かめ（誤りは `invalid-provider-data`）、複製・凍結して返す。同梱の日本の祝日は `names` を持たない（公式の出典がある日本語・英語の名称だけを同梱する）
+
+### 開発
+
+- `size-limits.json` の値を上げるときの理由は、コミットメッセージではなく CHANGELOG の「開発」に書く取り決めにした。`pnpm check`（`scripts/check-size.ts`）が前の版のタグの `size-limits.json` と比べ、値が上がっているのに記載がなければ失敗する（0.6.0 で理由をコミットメッセージに書き漏らしたため）。CI とリリースのワークフローは履歴とタグを取得して（`fetch-depth: 0`）この確認を行い、リリースのワークフローではタグを付けたコミットを 1 つ前の版のタグと比べる
+
 ## [0.6.0] - 2026-10-16
 
 ### Added
@@ -148,7 +158,8 @@
 
 - 日本: 2026 年 2 月の官報（2027 年の春分・秋分の日）まで反映（`dataVersion: "2026-02"`、`confirmedThrough: 2027`）
 
-[Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.6.0...HEAD
+[Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.7.0...HEAD
+[0.7.0]: https://github.com/inohan77/bizdays-toolkit/compare/v0.6.0...v0.7.0
 [0.6.0]: https://github.com/inohan77/bizdays-toolkit/compare/v0.5.0...v0.6.0
 [0.5.0]: https://github.com/inohan77/bizdays-toolkit/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/inohan77/bizdays-toolkit/compare/v0.3.1...v0.4.0

package/README.md

@@ -23,7 +23,7 @@
 - **月の期日**: 「20 日締め翌月 10 日払い（休業日なら翌営業日）」「月末の最終営業日」のような期日を、金融で使われる 4 つの調整方法（following・preceding・modified-following・modified-preceding）で計算します
 - **営業日の計算**: 定休日の曜日・毎年の休業日（年末年始のような年をまたぐ期間も可）・臨時休業日・臨時営業日と祝日を組み合わせ、「N 営業日後」「締め時刻を過ぎたら翌営業日」などを計算します
 - **タイムゾーンを間違えない**: `Date` などの瞬間は、カレンダーのタイムゾーン（日本は `Asia/Tokyo`）で暦日に変換してから判定します。UTC で動くサーバーでも、日本時間 0〜9 時が前日扱いになりません
-- **軽量・依存ゼロ**: minify + gzip で約 7KB（日本の祝日込みで約 8.3KB）。ESM・型定義同梱・`sideEffects: false` で、Node.js・ブラウザー・Edge ランタイムで動作します
+- **軽量・依存ゼロ**: minify + gzip で約 7.4KB（日本の祝日込みで約 8.5KB）。ESM・型定義同梱・`sideEffects: false` で、Node.js・ブラウザー・Edge ランタイムで動作します
 - **他の国・地域に拡張できる**: 祝日の提供元はインターフェース（`HolidayProvider`）で差し替えられます。現在は日本のみ同梱しています
 
 [English](#english)
@@ -305,6 +305,23 @@ const myCountry: HolidayProvider = {
 const calendar = createCalendar({ holidays: myCountry, closedWeekdays: [0, 6] });
 ```
 
+祝日には、ほかの言語の名称を `names` で付けられます。キーは BCP 47 の言語タグの正規の形（`"zh-Hant"`・`"ko"` など）です。同梱の日本の祝日は `names` を持ちません（公式の出典がある日本語・英語だけを同梱しています）。必要な場合は、提供元を包んで付けます。
+
+```ts
+import { jp } from "bizdays-toolkit/jp";
+
+const zhHant: Record<string, string> = { "2026-01-01": "元日" /* … 利用者が用意した訳 */ };
+const jpWithNames = {
+  ...jp,
+  holidaysInYear: (year: number) =>
+    jp.holidaysInYear(year).map((h) => {
+      const name = zhHant[h.date];
+      return name === undefined ? h : { ...h, names: { "zh-Hant": name } };
+    }),
+};
+createCalendar({ holidays: jpWithNames }).getHoliday("2026-01-01")?.names; // { "zh-Hant": "元日" }
+```
+
 ### 対応年の外
 
 祝日の提供元の対応年（日本は 1955〜2099 年）を外れた日付を判定すると `RangeError` になります。祝日がない日として扱いたい場合は `outOfRange: "ignore"` を指定してください。
@@ -416,8 +433,8 @@ A business-day calendar that combines public holidays with company or store clos
 - **Month-based due dates**: `adjust` with `following` / `preceding` / `modified-following` / `modified-preceding`, the nth / first / last business day of a month, `dueDate(month, { day, convention })`, and the calendar helpers `closingMonth` and `monthOf`
 - **Business-day arithmetic**: closed weekdays, annual closures (including ranges across the new year), specific closed/open dates, holiday policy, `addBusinessDays`, cut-off times, and more
 - **Time-zone safe**: instants (`Date`, ISO strings with offsets, Temporal) are converted to a civil date in the calendar's time zone before evaluation
-- **Lightweight, zero dependencies**: about 7 KB min+gzip (about 8.3 KB with Japanese holidays), ESM, bundled types, `sideEffects: false`
-- **Extensible** through the `HolidayProvider` interface (only Japan is bundled for now)
+- **Lightweight, zero dependencies**: about 7.4 KB min+gzip (about 8.5 KB with Japanese holidays), ESM, bundled types, `sideEffects: false`
+- **Extensible** through the `HolidayProvider` interface (only Japan is bundled for now). Holidays can carry names in other languages via the optional `names` field (keys are canonical BCP 47 language tags); the bundled Japanese data includes only the officially sourced Japanese and English names
 
 ```ts
 import { createCalendar } from "bizdays-toolkit";

package/dist/core/schedule.js

@@ -373,9 +373,46 @@ function loadProviderYear(provider, year) {
         if (typeof confirmed !== "boolean") {
             throw providerDataError(provider, year, `item ${i} (${date}) must have boolean confirmed`);
         }
-        return Object.freeze({ date, name, nameEn, kind: kind, confirmed });
+        const holiday = {
+            date,
+            name,
+            nameEn,
+            kind: kind,
+            confirmed,
+        };
+        if (h["names"] !== undefined) {
+            const problem = checkNames(h["names"]);
+            if (problem)
+                throw providerDataError(provider, year, `item ${i} (${date}) names: ${problem}`);
+            holiday.names = Object.freeze(Object.fromEntries(Object.entries(h["names"])));
+        }
+        return Object.freeze(holiday);
     });
 }
+/** 祝日のほかの言語の名称を検証する（誤りがあれば理由を返す） */
+function checkNames(names) {
+    // 普通のオブジェクト（別の実行環境で作られたものも可）。継承した項目を持つものは受け付けない
+    const proto = isObject(names) ? Object.getPrototypeOf(names) : undefined;
+    if (!isObject(names) || (proto !== null && Object.getPrototypeOf(proto) !== null)) {
+        return "must be a plain object of { [language tag]: name }";
+    }
+    for (const [tag, value] of Object.entries(names)) {
+        let canonical;
+        try {
+            canonical = Intl.getCanonicalLocales(tag)[0];
+        }
+        catch {
+            return `${JSON.stringify(tag)} is not a BCP 47 language tag`;
+        }
+        if (canonical !== tag) {
+            return `${JSON.stringify(tag)} must be written in canonical form ${JSON.stringify(canonical)}`;
+        }
+        if (typeof value !== "string" || value === "") {
+            return `${JSON.stringify(tag)} must be a non-empty string`;
+        }
+    }
+    return undefined;
+}
 /** @internal 祝日を調べる機能を作る（設定は検証済みであること） */
 export function createHolidayLookup(source) {
     const { providers, timeZone, outOfRange } = source;

package/dist/core/types.d.ts

@@ -10,6 +10,11 @@ export interface Holiday<Kind extends string = string> {
     readonly name: string;
     /** 英語の名称 */
     readonly nameEn: string;
+    /**
+     * ほかの言語の名称（省略可能）。キーは BCP 47 の言語タグの正規の形（例: "zh-Hant", "ko"）。
+     * 同梱の提供元（日本）は持たない。利用者が実装した提供元が付けた場合に、検証して複製・凍結して返す
+     */
+    readonly names?: Readonly<Record<string, string>>;
     /** 種別（国ごとに定義。日本は JapaneseHolidayKind） */
     readonly kind: Kind;
     /**
@@ -23,7 +28,8 @@ export interface Holiday<Kind extends string = string> {
  *
  * 他の国・地域の祝日はこのインターフェースを実装して createCalendar・createSchedule に渡す。
  * holidaysInYear が返すデータは、年ごとに初めて使うときに検証され、誤りがあれば
- * code: "invalid-provider-data" の例外になる。
+ * code: "invalid-provider-data" の例外になる。返した祝日は、契約の項目（date・name・nameEn・names・
+ * kind・confirmed）だけを持つ変更できないオブジェクトに複製される。
  *
  * 互換性の約束: このインターフェースに項目を足すときは、メジャー版以外では省略可能な項目に限る。
  * @public

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bizdays-toolkit",
-  "version": "0.6.0",
+  "version": "0.7.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",