bizdays-toolkit 0.30.8 → 0.30.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,8 +2,41 @@
2
2
 
3
3
  この形式は [Keep a Changelog](https://keepachangelog.com/ja/1.1.0/) に、版の付け方は [Semantic Versioning](https://semver.org/lang/ja/) と [RELEASING.md](./RELEASING.md) の方針に従います。区分には Keep a Changelog の Added / Changed / Deprecated / Removed / Fixed / Security に加えて、祝日データの更新を表す **Data**、マイナー版で利用者がする作業を書く **移行**(RELEASING.md)、公開物の変わらない品質の仕組み(検査・CI・リリースの手順)を書く **開発** を使います。
4
4
 
5
+ 「開発」は 1 項目 1 行で、何を足した・やめた・変えたかだけを書きます(RELEASING.md の「区分」)。0.30.8 までの「開発」も 0.30.9 でこの形に縮めました。縮める前の文(経緯・退けた案・測定の詳しい値)は、各版のタグの `CHANGELOG.md` にあります。
6
+
5
7
  ## [Unreleased]
6
8
 
9
+ ## [0.30.9] - 2026-11-07
10
+
11
+ 品質改善提案(11 通目)の分です。文書で約束していた挙動から外れていた不具合を 2 件直しました。合成したカレンダーが、後のカレンダーが投げる日に投げるようになります(約束の回復。新たに投げる向きですが、RELEASING.md の区分を改めてパッチとしました)。省略可能な項目に明示的に書いた `undefined` は、どの項目でも省略と同じになります(作成できなかった設定が作成できるようになる向き)。正しい設定のカレンダー・スケジュールの判定の結果は変わりません。
12
+
13
+ ### Fixed
14
+
15
+ - `combineCalendars`: 営業日の判定(`isBusinessDay`・探索・営業日の数え)が、`open: "all"` では先のカレンダーが休業日、`open: "any"` では営業日と決めた時点で後のカレンダーを判定せず、後のカレンダーが投げる日(`unconfirmedHolidayPolicy: "throw"` の予測の祝日、対応年の外)でも投げないことがあった。すべてのカレンダーを判定するようにした。ガイドの「合成したカレンダーは、どれかのカレンダーが投げるなら投げる」の約束から外れていた既知の不具合(0.30.x のガイドに記載)。影響: 後のカレンダーが投げる日に、今まで値を返していた呼び出しが `unconfirmed-holiday`・`out-of-range` を投げる。判定の費用は合成したカレンダーの数に比例する(今までは先のカレンダーで決まれば残りを省いていた)。`dayInfoOn` は今までもすべてのカレンダーを判定していたので変わらない
16
+ - 省略可能な項目に明示的に書いた `undefined` の扱いが項目ごとに違い、型は通るのに作成が `invalid-option` で失敗することがあった(例: 繰り返しの規則の `keys`・`weekdays`・`interval`・`anchor`・`skipWeekdays`・`calendar`、個別の日付の `{ date: undefined, from, to }`、旧名と新しい名前の片方が `undefined`)。設定・規則・個別の日付・毎年の月日・合成・スケジュールから作るカレンダー・期日のオプションのどこでも、省略と同じにした(決定の文書の 6 番「型と実行時を一致させる」から外れていた。利用者向けの型は `exactOptionalPropertyTypes` なしでは `undefined` を通す)。知らないキーは、値が `undefined` でも今までどおり診断の `unknown-option` で知らせる
17
+ - 文書を直した(コードの挙動は変わらない):
18
+ - `CalendarOptions`・`CombineCalendarsOptions`・`CalendarFromScheduleOptions` の `searchDayLimit` の TSDoc: 超えたときを `Error` と書いていた(0.30.8 から `code: "no-business-day"` の `RangeError`)
19
+ - `createCalendarFromSchedule` の TSDoc とガイド(英日): `isOpen` が boolean でない値(`1`・`"open"`)を返した日は休業日になることを書いた
20
+ - ガイド(英日)の「繰り返しの規則」: 配列の順が効くのは優先順位の同じ段階の中だけで、`holidayPolicy: "ignore"` でも祝日の日は `"over-holiday"` の規則が `"under-holiday"` の規則より先に当たることを書いた
21
+ - ガイド(英日): 明示的な `undefined` は省略と同じ、を書き、「未確定の祝日」の合成の既知の不具合の記載を消した
22
+ - 決定の文書: 17 番を実態に合わせて書き換えた(結果が祝日に依存しない設定の値だけの判定は未確定の祝日で投げない、を 0.30.6 から入れていたのに、「実行時に特別扱いを入れない」と書いていた)。6 番に明示的な `undefined` を、32 番に約束の回復の区分を、38 番に CHANGELOG の「開発」の書き方の理由を足した
23
+
24
+ ### 開発
25
+
26
+ - RELEASING.md の区分: 約束した例外が出ていなかった不具合の修正は、新たに投げる向きでもパッチにした(「新たに例外を投げる変更はマイナー」は約束していなかった呼び出しを止める場合に限る)
27
+ - RELEASING.md: CHANGELOG の「開発」は 1 項目 1 行にする決まりを足し、0.30.8 までの「開発」を縮めた
28
+ - RELEASING.md のサイズの上限: 上限はマイナー版ごとに決め、パッチ版の中では上げない決まりを足した(0.31.0 から適用)
29
+ - サイズの上限: `./diagnose` を 26,500 → 26,800 に上げた(測定 26,503)。明示的な `undefined` の扱いと旧名の読み替えの直しで増えた
30
+ - タイムゾーンを変えたテストを、瞬間・時刻を渡すテスト(`scripts/test-tz.ts` の `TZ_FILES`)だけの再実行にし、一覧に載っていない瞬間・時刻を書いたテストがあれば失敗にした(手元で約 95 秒 → 約 17 秒)。テストの `tz-run` の飛ばしは外した
31
+ - 合成の既知の不具合の `todo` 2 件を、並び順 × `"all"`・`"any"` の通常のテストにした。飛ばしの決まりの自己テストは見本の一覧(`POLICY_SAMPLE`)で確かめる形にした
32
+ - 変形しても結果が同じ: 変形 7(書いていない既知の項目を明示的な `undefined` で書いても、結果・診断が同じ)を足した
33
+ - 明示的な `undefined` のテスト(`test/explicit-undefined.test.ts`)を足した: メソッド・関数のオプション(`etc/api.md` の Options の型。設定の型は変形 7)で、書いていない項目と旧名を `undefined` で書いても結果が同じ。表にない Options の型があれば失敗する
34
+ - API どうしの整合: 事例のテストの整合 9 を、整合 8(`never-matches` も確かめ、有効期間 3 通り)に吸収した。整合 10 は全件(CI)だけで動かす
35
+ - 診断の性質のテスト: `pnpm check` では短い提供元・提供元なしの性質だけを動かし、第 n 営業日の規則のある設定と日本の全範囲は全件(CI)だけにした(飛ばしの理由 `ci-full-only`)
36
+ - `test/counting-basis.test.ts`: オラクルが確かめる形(有効期間が重ならない組)のテストを 1 件消した
37
+ - 診断のオラクル: 項目 3 つの固定の設定 `jointFixed`(同じ曜日の under・over・after の規則。品質改善提案 11 通目の反例)を `test/fixtures/oracle-items.json` に足し、まとめて取り除くテスト(`ORACLE_JOINT=1`)で試す(0.31.0 の作り直しの正解の定義。今は失敗する)
38
+ - `src/core/schedule.ts`: 第 n 営業日の基準のキャッシュの上限(240 か月)の意味をコメントに書いた
39
+
7
40
  ## [0.30.8] - 2026-11-06
8
41
 
9
42
  品質改善提案(10 通目)の分です。文書・決定の文書・コメントが実装と食い違っていた箇所を直し、不具合を 4 件直しました。カレンダー・スケジュールの判定の結果は変わりません。変わるのは、診断の結果(カレンダーの個別の日付・毎年の月日の `value` に `unknown-option` が増える。誤った `counting-basis` が消え、曜日の規則ごとに出る)、`no-business-day` の例外のクラス(`Error` → `RangeError`。広がる向き)、`withSubstituteDays` が返す祝日の凍結です。あわせて、品質の仕組みを軽くしました(タイムゾーンを変えたテストを 4 ゾーンから 2 ゾーンに、診断の性質のテストを抜き出しに、全日の結果を比べる補助を 1 つに、同じ恒等式を確かめるテストを 1 か所に。詳しくは「開発」)。公開物の `.js` が変わるのは Fixed の 4 件と、到達しないコードを消した 1 行(`core/input.js`。「開発」)の分だけで、カレンダー・スケジュール・提供元の判定の結果は変わらないので、利用者の作業は要りません。
@@ -22,28 +55,28 @@
22
55
 
23
56
  ### 開発
24
57
 
25
- - 診断のオラクル: `counting-basis` の確かめを、第 n 営業日の規則と毎週の曜日の規則の有効期間が重なる組を前提にし、前提があるのに出ないとき・出た件数が組の数と違うときも失敗にした。項目の一覧(`test/fixtures/oracle-items.json`)に、有効期間が重ならない組を作る 4 項目(閉じる・開く規則の両方の `{ weekday: 2, effectiveTo: "2025-06-30" }` と `{ businessDayOfMonth: 2, effectiveFrom: "2025-07-01" }`)を足した(71 → 75 項目)
26
- - 前の版との比較: 特徴 `counting-rule-with-period-weekly-rule`(`etc/result-changes.json` で `counting-basis` が消える差分を許す)と `calendar-date-with-value`(増える向きなので許可は足さない)を足し、固定の設定 4 つ(`fixed-counting-basis-no-overlap`・`fixed-counting-basis-two-weekly`・`fixed-counting-basis-shadowed-weekly`・`fixed-calendar-date-with-value`)を足した
58
+ - 診断のオラクル: `counting-basis` の確かめを、第 n 営業日の規則と毎週の曜日の規則の有効期間が重なる組を前提にし、前提があるのに出ないとき・出た件数が組の数と違うときも失敗にした
59
+ - 前の版との比較: 特徴 `counting-rule-with-period-weekly-rule`(`etc/result-changes.json` で `counting-basis` が消える差分を許す)と `calendar-date-with-value`(増える向きなので許可は足さない)を足し、固定の設定 4 つを足した
27
60
  - 決定の文書: 3 番に「同じ `code` は同じクラスで投げる」を足した
28
61
  - `counting-basis` の判定を、規則どうしの走査の後の第 2 の走査にした(規則の並び順で結果が変わらないように)
29
- - `./diagnose` の gzip のサイズ(測定 26,322。上限 26,500)。`counting-basis` の判定の直しで増えた
30
- - 決定の文書: 「版と互換性」の章の見出しの直後にあった番号のない箇条 2 つ(オラクルの完全性を判定する期間、週の第 n 営業日の規則の判定できない月の限界)を 31 番に移した。`KNOWN_INCOMPLETE` に載せるときの手順は RELEASING.md の「診断のオラクル」の行と重なっていたので決定の文書からは消し、31 番(オラクルの完全性の箇条の直後)に手順の場所だけを書いた。章の見出しと最初の決定の見出しの間に本文があれば失敗にする検査を `scripts/check-package.ts` に足し、`scripts/tool-selftest.ts` にその誤りを足した(目次の検査は見出しだけを見るので、見出しのない本文を見つけられなかった)
31
- - 「0.31.0 の P1」を「診断の判定の作り直し(0.31.0)」と言葉で書いた(決定の文書・RELEASING.md・この CHANGELOG の 0.30.4 と 0.30.6 の節・飛ばしの理由。P1 はどの文書にも定義のない名前だったため)
32
- - API どうしの整合のテスト(`test/consistency.test.ts`)の名前の番号を整合 1〜11 に振り直した(「整合 5」が 6 件あり、失敗の報告から文書の行を引けなかった)。RELEASING.md の「API どうしの整合」の行は、関係の数を書かずに、関係とテストの番号を並べた
33
- - `bizdays-toolkit/jp` の `jp` の TSDoc に 0.30.0 の旧名 `holidays` が残っていたのを `holidayProvider` に直した。`scripts/check-names.ts` の旧名の残りの検査(C14)は `holidays` をキーの形でしか探していなかったので、日本語の TSDoc で引数名として書く形(「の holidays に」)を足した
34
- - `src/core/input.ts` の到達しない `replace(" ", "T")` を消した(直前の正規表現が区切りを `T` に限るので、空白を含む値はこの行に届かない。`core/input.js` の 1 行が変わるが、挙動は同じ)
35
- - `check-package`: `src` が実行環境のタイムゾーンに依存する API(ローカル時刻の `Date` の API・`getTimezoneOffset`・`toLocale…String`・`new Date(年, 月, …)`・`timeZone` を渡さない `Intl.DateTimeFormat`)を使っていないことを確かめるようにし、`tool-selftest` にその誤りを 2 件足した
36
- - タイムゾーンを変えたテスト(`scripts/test-tz.ts`)を UTC・Asia/Tokyo・America/Los_Angeles・Pacific/Chatham の 4 ゾーンから America/Los_Angeles・Pacific/Chatham の 2 ゾーンにした(理由は decisions.md の 35 番。1 コアの手元で 209 秒 → 104 秒)
37
- - `check-names`: 報告のパスの区切りを `/` にそろえた(Windows では `\` で出ていて、期待と突き合わせにくかった)。旧名の表に `holidays` がないときは、日本語の TSDoc の引数名の形の検査(0.30.8 の ZIP-A で足した)を黙って外さず、一緒に消すよう失敗にする
38
- - 前の版との比較(`scripts/result-compare.ts`): 意図した差分として許した設定の `id` と対象を一覧に出すようにした(意図しない差分が出たときに、許した側と見比べるため)。固定の設定 `fixed-counting-basis-open-closed-weekly`(開く規則と閉じる規則に曜日の規則が 1 つずつ。`counting-basis` が 2 件に増える形)を足した
62
+ - `./diagnose` の gzip のサイズ(測定 26,322。上限 26,500)
63
+ - 決定の文書: 「版と互換性」の章の見出しの直後にあった番号のない箇条 2 つを 31 番に移した
64
+ - 「0.31.0 の P1」を「診断の判定の作り直し(0.31.0)」と言葉で書いた
65
+ - API どうしの整合のテスト(`test/consistency.test.ts`)の名前の番号を整合 1〜11 に振り直した
66
+ - `bizdays-toolkit/jp` の `jp` の TSDoc に 0.30.0 の旧名 `holidays` が残っていたのを `holidayProvider` に直した
67
+ - `src/core/input.ts` の到達しない `replace(" ", "T")` を消した
68
+ - `check-package`: `src` が実行環境のタイムゾーンに依存する API を使っていないことを確かめるようにし、`tool-selftest` にその誤りを 2 件足した
69
+ - タイムゾーンを変えたテスト(`scripts/test-tz.ts`)を UTC・Asia/Tokyo・America/Los_Angeles・Pacific/Chatham の 4 ゾーンから America/Los_Angeles・Pacific/Chatham の 2 ゾーンにした
70
+ - `check-names`: 報告のパスの区切りを `/` にそろえた
71
+ - 前の版との比較(`scripts/result-compare.ts`): 意図した差分として許した設定の `id` と対象を一覧に出すようにした(意図しない差分が出たときに、許した側と見比べるため)
39
72
  - `src/core/input.ts`: `Date.parse` にオフセット付きの文字列だけを渡している理由をコメントに書いた
40
- - 開発用のツールを更新: oxlint 1.88.0 → 1.91.0、oxfmt 0.73.0 → 0.76.0、`@types/node` 24.19.2 → 26.6.6(どれも既存のファイルの整形と lint の結果は変わらない)
41
- - `check-package` の実行環境のタイムゾーンに依存する API の検査を直した: 引数の中の括弧を 1 段まで読む(`new Date(Number(y), m)` を見逃していた)、`new` を付けない `Intl.DateTimeFormat(…)` と `timeZone: undefined` も不可にした、文字列を渡す `new Date("…")` を不可にし、`Date.parse` は `src/core/input.ts` の 1 か所(オフセット付きに限った文字列)だけを許して回数が変わったら失敗にした、行末の `//` コメントも検査の前に除くようにした(コメントに書いた形で誤って失敗していた)。`tool-selftest` に文字列を渡す `new Date` の誤りを足した
42
- - 診断の性質のテスト(`test/diagnose-properties.test.ts`)を、ほかの全件のテストと同じ「`pnpm check` は抜き出し、全件は CI」の形にした: 設定は毎回作り(乱数の列は変わらない。生成範囲の記録はカレンダーを作る時点で特徴を集めるので、記録の仕組み `scripts/record-generator-features.ts` は全件を動かす)、`pnpm check` では 3 件に 1 件の決まった抜き出しだけを確かめ、全件は `DIAGNOSE_PROPERTY_FULL=1` で CI の `diagnose-consistency` ジョブ。タイムゾーンを変えた実行では 3 つとも飛ばす(暦日だけで決まる。試行を減らして動かしていた `tzRuns`・`tzCountingRuns` は消した)。1 コアの手元で `pnpm test` のこのファイルの分が約 45 秒 → 12 秒
43
- - 変形しても結果が同じ(`test/metamorphic.test.ts`)の全件(`METAMORPHIC_FULL=1`、関係ごとに 40 件)を CI の `diagnose-consistency` ジョブで動かすようにした(RELEASING.md に全件の環境変数だけがあり、動かす場所がなかった。36 番の「黙って外れる確認を作らない」)
44
- - 全日の結果を比べる補助を `test/support/compare.ts` に 1 つにした(`daysOf`・`dayLine`・`linesOf`・`removeItem`)。診断の性質・診断のオラクル・整合・和集合・失敗の注入のテストと `test/support/provider.ts` が別々に持っていた、期間の全日の列・1 日の結果の文字列・項目の取り除きを置き換えた(約束は変えない。変形のテストの全項目の比較、整合のテストの `valueOn` の比較、失敗の注入のテストの `isBusinessDay` と例外の有無の比較は、比べる約束が違うので残した)
45
- - 同じ恒等式を 3 か所で確かめていたのを 1 か所にした: `diff(a, add(a, n)) = n`・`add(end, −n) = start`・加算の結果は営業日・逆向きの差は −n、次の営業日は翌日からの営業日の一覧の最初・前の営業日は前日以前の営業日、を `test/consistency.test.ts` の整合 2・3(目録の設定)で確かめる。`test/properties.test.ts` の性質「addBusinessDays の結果は営業日で、n 進めて −n 戻ると元の営業日に戻る」「nextBusinessDay との間に営業日はなく、previousBusinessDay で戻る」と、`test/naming.test.ts` の T3 のカレンダーの対を消した(T3 は日付の `diffDays`・`addDays` の対だけ残す)。生成範囲の記録は変わらない(残る性質が同じ設定の作り方を使う。`record-generator-features.ts --check` で確かめた)
46
- - `check-package` の実行環境のタイムゾーンに依存する API の検査: 文字列の中身を先に空にしてから `//` のコメントを除くようにした(`" //"` を含む文字列を行末のコメントと誤認して、その行の残りが黙って検査から外れていた)
73
+ - 開発用のツールを更新: oxlint 1.88.0 → 1.91.0、oxfmt 0.73.0 → 0.76.0、`@types/node` 24.19.2 → 26.6.6
74
+ - `check-package` の実行環境のタイムゾーンに依存する API の検査を直した
75
+ - 診断の性質のテストを、ほかの全件のテストと同じ「`pnpm check` は抜き出し、全件は CI」の形にした(全件は `DIAGNOSE_PROPERTY_FULL=1`)
76
+ - 変形しても結果が同じ(`test/metamorphic.test.ts`)の全件(`METAMORPHIC_FULL=1`)を CI の `diagnose-consistency` ジョブで動かすようにした
77
+ - 全日の結果を比べる補助を `test/support/compare.ts` に 1 つにした
78
+ - 同じ恒等式を 3 か所で確かめていたのを 1 か所にした
79
+ - `check-package` の実行環境のタイムゾーンに依存する API の検査: 文字列の中身を先に空にしてから `//` のコメントを除くようにした
47
80
 
48
81
  ## [0.30.7] - 2026-11-05
49
82
 
@@ -56,27 +89,27 @@
56
89
 
57
90
  ### 開発
58
91
 
59
- - サイズ(gzip): `./diagnose` 26,158 → 26,218(測定 26,218。上の Fixed の 2 件の 27 バイトと、規則どうしの診断が調べる期間を求める部分を関数 `rulesScanWindow` に切り出して内部で書き出した 33 バイト)。上限は変えていない。ルート 18,123(測定 18,123)は変わらない
60
- - 判定できない月の診断のテスト(`test/diagnose-unjudgeable.test.ts`)を足した。上の Fixed の例(旧名のキーで書いた形と、週の規則の次の月・前の月の 2 例を含む)、基準のカレンダーを持つ規則の `never-matches`・`redundant` は有効期間に判定できない月があれば出さず、有効期間がすべて対応年の中なら出すこと、月の第 n 営業日の規則は前後の月を記録しないことを確かめる。規則の中のオプションの位置の診断(今はカレンダーにだけ出る)と、`recurringRules[1]` と `recurringRules[11]` が混ざる位置の引き方は、`dropUnsure`(`@internal`)を直接呼んで確かめる
61
- - API どうしの整合の検査(`test/consistency.test.ts`)の直し: 作成を試す関数は、bizdays のエラーコードを持つ例外だけを「作成できない」とみなし、ほかの例外は投げ直す。整合 4 は、n 番目の営業日がないときの `no-business-day` だけを受け止め、営業日が n 日に満たない月がある固定の設定も試す(目録の設定では、その経路を全件でも一度も通っていなかった)。整合 5 は、今までの試行に加えて、目録が意図して入力の誤りにした規則を含む設定を別の種で作り(作れなければ失敗)、その設定が作成できないことも確かめる(抜き出しで 24 件・全件で 300 件。今までの試行の「作成できた」23 件・「作成できない」1 件は変わらない)。件数の行は、数えたものの名前で出す(never-matches・redundant の関係は「診断の項目」)。テストの名前から版の経緯を消した(黙って外れる穴。種類 C)
62
- - `scripts/result-compare.ts`: スケジュールの第 n 営業日の規則の基準のカレンダーに、スケジュールの設定の `outOfRangePolicy` を受け継がせた。意図した差分の特徴 `schedule-counting-basis-narrower-than-scan` は、基準のカレンダーが `"ignore"`(対応年の外で投げない)なら付けない。特徴を付ける関数を `test/support/result-cases.ts` に移し、単体テスト(`test/result-traits.test.ts`)で確かめる(今の種で作る設定は `outOfRangePolicy` を持たないので、比べる設定と結果は変わらない)
63
- - `scripts/tool-selftest.ts`: 表のセルの `|` を `\|` にし、写しの途中で例外が出ても、そこまでに写したファイルを表の後に出し、`Error` でない値の例外も文にする。部品を `scripts/tool-selftest-parts.ts` に切り出し、単体テスト(`test/tool-selftest-parts.test.ts`)で確かめる。対照の SKIP の判定の 2 つ目の形を見る理由をコメントに書いた
64
- - 飛ばしの決まり(`test/support/skip.ts`): 事前の確認で届かなくなった枝を消した。環境変数 `CI` が `"false"`・空文字列のときに CI とみなさないことをテストで確かめる
92
+ - サイズ(gzip): `./diagnose` 26,158 → 26,218
93
+ - 判定できない月の診断のテストを足した
94
+ - API どうしの整合の検査(`test/consistency.test.ts`)の直し: 作成を試す関数は、bizdays のエラーコードを持つ例外だけを「作成できない」とみなし、ほかの例外は投げ直す
95
+ - `scripts/result-compare.ts`: スケジュールの第 n 営業日の規則の基準のカレンダーに、スケジュールの設定の `outOfRangePolicy` を受け継がせた
96
+ - `scripts/tool-selftest.ts`: 表のセルの `|` を `\|` にし、写しの途中で例外が出ても、そこまでに写したファイルを表の後に出し、`Error` でない値の例外も文にする
97
+ - 飛ばしの決まり(`test/support/skip.ts`): 事前の確認で届かなくなった枝を消した
65
98
  - ガイド(英日)の「対応年の外」: スケジュールの第 n 営業日の規則の文を独立させ、「結果が分からない年の祝日に依存するため」の理由とシンガポールの例が、隣の日を見る規則と週の第 n 営業日の規則の説明として読めるようにした
66
- - 変形しても結果が同じ(テスト拡充案の T4。`test/metamorphic.test.ts`): 文書で同じ意味だと約束している書き換えで、全日の結果と、位置を読み替えた診断(関わる項目の位置 `relatedPath` も同じく読み替える)が変わらないことを、目録の設定(自作の提供元・2 つの自作の提供元の和集合・提供元なし。旧い値は日本の提供元でも。日本の提供元だけの設定で `kinds` に `"regular"` を持つ決まった設定を毎回試す)で確かめる。関係は、旧名・旧い値(スケジュールの `holidayPolicy` の `"weekday"`、日本の提供元だけの設定の `kinds` の `"national"`)と新しい名前・値、同じ `id` で包み直した提供元と種別を付け替えて `kinds` も直した提供元、期間の個別の日付とそれを分けた 2 つの日付、順番が意味を持たない配列(`closedWeekdays`・`kinds`・`keys`・`weekdays`)の並べ替え、設定の JSON での往復(提供元と基準のカレンダーは付け直す)、同じ設定から作った 2 つのカレンダーの合成(`"all"`・`"any"`)。期間を分けた診断は、分けた期間のほかの位置は同じ(分けた期間を覆う側として指していた `shadowed` だけは、覆っていた期間が分かれると `redundant` になってよい)で、分けた期間はコードごとの向き(元の `redundant`・`expired`・`shadowed` は両方に、`out-of-range` は少なくとも一方に出る。片方が同じ一覧のほかの期間に含まれると `redundant` の代わりに `shadowed`)に従い、新しく出てよいコードを理由付きの一覧で持つ。目録の生成器はスケジュールの期間を作らないので、スケジュールの期間(`dates` の `{ from, to }`)は決まった設定で試す。関係ごとに試した設定の数を出し、0 件なら失敗にする
67
- - 文書の例の検査(`scripts/check-readme-examples.ts`)を厳しくした(テスト拡充案の T6): 例で `createCalendar`・`createSchedule` に渡した設定を自動で診断にもかけ、`error`・`warning` があれば失敗にする(誤りを見せる例は、直前の注記 `<!-- example: allow-diagnostics <code> -->` で許すコードを明示する)。診断の結果を `filter`・`find` で絞った例は、注記がなければ失敗にする(0.30.2 の事例)。移行ガイド(`docs/migration.md`)の最新の版の節のコード例も実行する(それより前の節は旧名で書かれているので外す)。診断にかけた設定の数を関数ごとに出し、0 件なら失敗にする。付け替えられない書き方(単引用符・セミコロンなし・動的な `import()`・`require()` など)でパッケージのルートを読み込んだ例は失敗にする(例の import の付け替えが外れたとき、黙って通らないため)
68
- - ガイド(英日)の「カレンダーの合成」に、2 つ以上の別々のカレンダーを渡すこと(1 つだけ、または同じカレンダーを 2 度渡すと `invalid-argument`)を書き足した(コードにだけあった決まり)
99
+ - 変形しても結果が同じ: 文書で同じ意味だと約束している書き換えで、全日の結果と、位置を読み替えた診断が変わらないことを、目録の設定で確かめる
100
+ - 文書の例の検査を厳しくした(テスト拡充案の T6): 例で `createCalendar`・`createSchedule` に渡した設定を自動で診断にもかけ、`error`・`warning` があれば失敗にする
101
+ - ガイド(英日)の「カレンダーの合成」に、2 つ以上の別々のカレンダーを渡すことを書き足した(コードにだけあった決まり)
69
102
  - `SECURITY.md` の Supply chain と Supported versions を英日の併記にそろえ、依存ゼロ(`dependencies` を持たない)と、provenance が付く版を 0.1.0 以降と正確に書いた
70
- - 文章の主張の検査(テスト拡充案の T7。`scripts/check-claims.ts`)を足した。リポジトリの Markdown を、版の範囲の語を探すものと理由付きで探さないものに分け(どちらにも分けていなければ失敗)、探すものとソースに今の版より前の系列を指す語(「0.29.x」など)があれば失敗にし、改名の表の旧名のうち診断の対象外のもの(合成・スケジュールから作るカレンダー・期日・振替)が移行ガイドの検索の案内に載っていなければ失敗にする(`pnpm check`)。CI の `result-compare` ジョブでは、前の版と比べて変わった `dist` の `.js`・`.d.ts`(`.d.ts` はコメントを除いて比べる)を Job Summary に出し、変わったのに CHANGELOG の今の版と `[Unreleased]` のどちらにも利用者向けの区分がなければ失敗にする。決定の番号の参照の表(`decisions.md の N 番` と見出し。範囲と形は文書の参照の実在の検査と同じで、`scripts/decision-references.ts` を共有する)は、`--decisions --since v<前の版>` で前の版から変わった参照に印を付けて出し、公開の手順で人が読む(RELEASING.md)。版の範囲の語は `v0.29.x`・`0.29.X` の形と、1.0.0 の後の「1.2.x」の形も拾う。検査のスクリプトの検査(`scripts/tool-selftest.ts`)に、この検査の誤り 6 つを足した
71
- - テスト拡充案の T8(設定の結果の差分の定期実行)は、定期実行としては入れず、種と倍率を指定して広い比較を手動で動かすワークフロー(`.github/workflows/result-compare-wide.yml`)として入れた(定期に動かす頻度に理由がなく、不具合を見つけてきたのは狙いを絞った仕組みだったため。decisions.md の 37 番)。0.30.7 では、Fixed の 1 件目(`never-matches` が増える向き)が乱数の設定に届いたことを、CI の決まった種(倍率 1)では 0 件だったのに対し、倍率 10 の広い比較で 6 件(旧名の比較の穴を直した後は旧名とあわせて 12 件)確かめるのに使った。入力の種と倍率は、環境変数に書く前に整数であることを確かめる。result-compare の予期しない例外は、読み込みの途中で投げたものも含めて終了コード 2(比較が終わらなかった)にし、許していない差分の 1 と区別する(`scripts/exit-on-unexpected.ts` を最初に読み込む。生成範囲の検査 `scripts/record-generator-features.ts` も、このファイルを result-compare とともに写す)
72
- - 設定の結果の差分(`scripts/result-compare.ts`)の直し: 診断の結果が増えた設定(約束の範囲内の変化。旧名の比較の `deprecated-option` は数えない)を一覧に出す。固定の設定に、`outOfRangePolicy: "ignore"` を持ち基準のカレンダーで数えるスケジュール(シンガポール。比べる期間は対応年の外を含む)を足し、基準のカレンダーに `outOfRangePolicy` を受け継がせる枝(旧名の `outOfRange` を含む)を実際の比較で通す。基準のカレンダーを作る処理(`withCalendars`)は、前の版と今回の版を同じ作り方で比べるので result-compare では壊れても差分にならない。そのため `test/support/result-cases.ts` に移し、受け継ぐことを単体テスト(`test/result-traits.test.ts`。新しい名前と旧名の両方)で確かめる。診断する種で作った設定は、種で作った設定の中の番号で選ぶようにした(固定の設定を足すと、並びの番号で選んでいた診断の対象がずれ、0.22.2 との比較で日本の提供元の基準を数十年にわたって問い合わせる設定が外れていた。選ぶ設定は 0.30.6 までと同じ)
73
- - 目録の生成器(`test/support/catalog.ts`)が、スケジュールの個別の日付の半分ほどを期間(`dates` の `{ from, to }`)にする。期間にするかと長さは、日付から決める別の乱数で選び、呼び出し側の乱数の流れは変えない(変えると、ほかのテストが試す設定がすべて変わるため。改名の前の版との比較では作らない)。乱数のテストが、スケジュールの期間の形を一度も試していなかった穴をふさぐ(ZIP-B の記録の持ち越し)
74
- - 診断のオラクル(`test/diagnose-oracle.test.ts`)の完全性(取り除いても結果が変わらないのに診断が何も言わない項目)を、報告から失敗に切り替えた。対応年(2025〜2027 年)だけで「取り除ける」と判定していたので、有効期間が対応年の外に続く規則を、診断はその外まで調べて取り除けないと正しく判定していたのに、報告に出ていた(報告されていた 1 件と、報告の仕組みの見張りのカナリアの 2 件とも、この形で、診断の取りこぼしではなかった。カナリアの説明の理由も実際と違っていた)。対応年で取り除けた項目は、診断が規則どうしを調べる期間でも確かめ直してから数え(期間は、診断の中で組み立てていた部分を関数 `rulesScanWindow` に切り出し、診断とオラクルが同じ関数で求める。`@internal`)、確かめ直して数えなかった件数と時間を出す。既知の項目の一覧(`KNOWN_INCOMPLETE`)は空で、一覧にない項目が出たら失敗、一覧の項目が出なくなっても失敗にする。カナリアは、診断の結果を空にして渡し、本当に取り除ける項目を数えることと、走査の範囲で取り除けない項目を数えないことを確かめる見張りのテストに替えた
75
- - 設定の結果の差分(`scripts/result-compare.ts`)の穴を直した: `latest` との比較の旧名の回が、旧名に書き換わっていなかった(旧名の表を、改名の前の版との比較でだけ読み込んでいたため。result-compare を入れた 0.30.2 から)。旧名の回は、新しい名前の回とほぼ同じ設定を比べ、基準のカレンダーを持つスケジュールは両方の版で `invalid-option` になって、誤りが同じなので差分にならず、結果も診断も比べていなかった。旧名の表をいつも読み込み、旧名に書き換わらなかった設定と、意図した入力の誤りでないのに作成に失敗した設定(名前の書き方ごと。前の版でも失敗した設定の数も出す)を失敗にする(合成の相手のカレンダーも本体と同じに数える)。旧名の表が空なら、読み込みの誤り(終了コード 2)とする。あわせて、スケジュールの基準のカレンダーを、いつも定休日なし(土日も営業日)で作っていた穴を直した(説明には「土日休みのカレンダー」とあった)。基準のカレンダーの定休日は、設定の id から決める別の乱数で選ぶ(書かない・土日・曜日の部分集合。実際の利用で多い土日を多めにする)。生成範囲の検査は、基準のカレンダーの定休日を特徴として別に数える(記録にない特徴なので見張りはしない。定休日を渡すことと、選び方が 3 つの形を出すことは、単体テスト(`test/result-traits.test.ts`)で確かめる)
76
- - 設定の結果の差分の意図した差分(`etc/result-changes.json`)に、上の Fixed の 2 件目の項目(`schedule-week-counting-basis-narrower-than-scan`。0.30.6 が出していた誤った `never-matches`・`redundant` を出さなくなった差分)を足した(結果を変える修正に特徴と項目を足す決まりの、0.30.7 の作業の途中での漏れ)
77
- - `RELEASING.md` の監視の節: GitHub の失敗の知らせの届き先(文書「Notifications for workflow runs」)と、有効にし直すステップの影響を、事実に合わせて書いた。監視のワークフローを改修したときの確かめ方(偽の `gh`・`curl` を与えて、`run:` のシェルを経路ごとに手元で動かす)を足した。`data-watch.yml` の失敗のステップは、照合ごとの終了コードで、差分(「… differ from the bundled data」)と照合そのものの失敗(「… could not be checked」)を書き分ける(取得・解析の失敗でも「differ」と出ていた)
78
- - 飛ばしの決まりの検査(`test/skip-policy.test.ts`): 省略記法(`{ skip }`・`{ todo }`)と、分割代入(`const { skip } = …`)、`skip`・`todo` の import・export(別名を含む)と変数・引数の宣言を、TypeScript のコンパイラーの API で読み、行に分けて書いても拾う(前の行の grep が拾っていた形をすべて含む)
79
- - `RELEASING.md` の確認の表: 変形しても結果が同じ(T4)と文章の主張(T7)の行を足し、ドキュメントのコード例(T6)・設定の結果の差分(T8)の行を今の検査に合わせた。設定の結果の差分の行の特徴の関数の場所(`traitsOf` → `test/support/result-cases.ts` の `traitsOfCase`)が、上の result-compare の直しで関数を移した後も古いままだったので直した
103
+ - 文章の主張の検査(`scripts/check-claims.ts`。`pnpm check`)を足した。前の版から変わった決定の参照の表は `--decisions --since v<前の版>` で出す
104
+ - テスト拡充案の T8(設定の結果の差分の定期実行)は、定期実行としては入れず、種と倍率を指定して広い比較を手動で動かすワークフローとして入れた
105
+ - 設定の結果の差分(`scripts/result-compare.ts`)の直し: 診断の結果が増えた設定を一覧に出す
106
+ - 目録の生成器(`test/support/catalog.ts`)が、スケジュールの個別の日付の半分ほどを期間(`dates` の `{ from, to }`)にする
107
+ - 診断のオラクルの完全性(取り除いても結果が変わらないのに診断が何も言わない項目)を、報告から失敗に切り替えた
108
+ - 設定の結果の差分(`scripts/result-compare.ts`)の穴を直した: `latest` との比較の旧名の回が、旧名に書き換わっていなかった
109
+ - 設定の結果の差分の意図した差分(`etc/result-changes.json`)に、上の Fixed の 2 件目の項目を足した
110
+ - `RELEASING.md` の監視の節: GitHub の失敗の知らせの届き先と、有効にし直すステップの影響を、事実に合わせて書いた
111
+ - 飛ばしの決まりの検査(`test/skip-policy.test.ts`): 省略記法・分割代入・`skip`・`todo` の import・export と変数・引数の宣言を、TypeScript のコンパイラーの API で読んで拾うようにした
112
+ - `RELEASING.md` の確認の表: 変形しても結果が同じ(T4)と文章の主張(T7)の行を足し、ドキュメントのコード例(T6)・設定の結果の差分(T8)の行を今の検査に合わせた
80
113
 
81
114
  ## [0.30.6] - 2026-11-02
82
115
 
@@ -94,21 +127,21 @@
94
127
 
95
128
  ### 開発
96
129
 
97
- - サイズの上限: 上限を 25,800 から 26,500 に上げた `./diagnose`(測定 26,158)。理由: Fixed の 3 件目(基準のカレンダーが投げる月を判定できない月として扱い、確かでない診断を出さない)の修正で増えたため。診断の判定の作り直し(0.31.0)の分は見込まず、そのときにあらためて測って上げる
98
- - 診断のオラクル: カナリア(完全性の報告に必ず出る設定)が取り除ける理由を確かめた。開く規則「5・7 月の月曜」が開きうる祝日(自作の提供元の 5・7 月の月曜の祝日)を、`holidayOverlapPolicy` の既定(`"under-holiday"`)では開かないため。`"over-holiday"` にすると取り除けなくなることを確かめるテストを足し、コメントの理由を直した(コメントの主張を確かめていなかった穴。種類 C)
99
- - 診断のオラクル: `ORACLE_FULL` なしの `ORACLE_SHARD` を例外にした(`pnpm check` の抜き出しの間隔 111 と分ける数の公約数で、分が 0 件になっていた)。どのテストも、試した設定が 0 件なら失敗にする。失敗のメッセージを 1 つの関数にまとめ、設定を作り直せる情報(項目・休業日の扱いの方針・定休日・取り除いた項目)を入れた(黙って空振りする穴。種類 C)
100
- - 生成範囲: 危険の分かっている組み合わせ(第 n 営業日(月・週)× 個別の日付、第 n 営業日(月)× 毎年の月日、祝日の規則 × 臨時営業日、祝日の翌日・前日 × `skipWeekdays` × 個別の日付、和集合の提供元 × `kinds`)の一覧(`test/support/combinations.ts`)を作り、呼び出し側ごとに 1 回以上作ることを確かめる(作れない組み合わせは事実の理由を付けて除く)。個々の特徴の包含だけでは組み合わせを守れなかった(生成器の偏りの穴。種類 A)
101
- - 生成範囲: `test/properties.test.ts` の性質は、設定を作る乱数(性質の名前から決まる種の列)と、日付などを引く乱数を分けた。性質と設定の作り方の対応は `test/support/sites.ts` の `PROPERTY_CONFIGS` に書き、性質が実際に使った作り方と同じかを確かめる。これで生成範囲の包含のテストが properties の設定を並びまで再現し、テストとスクリプトの特徴が一致する(どちらも 414 件。0.30.5 は近似でテスト 408 件・スクリプト 413 件)(種類 A)
102
- - API どうしの整合の検査(`test/consistency.test.ts`)を入れた。目録の生成器の設定(カレンダー・スケジュール、対応年の短い自作の提供元・提供元なし)で、同じことを別の API で問うたときの答えが一致することを確かめる: 各日の判定(`isBusinessDay`・`dayInfoOn`・`daysBetween`、スケジュールは `valueOn`)、次・前の営業日、営業日の加算と差、第 n 営業日の規則と基準のカレンダーの第 n 営業日、診断の `error` と作成の成否・エラーコード、移行(`migrate…` した設定に `deprecated-option` が残らない・2 回かけても変わらない・前後で結果が同じ)。各日の判定と移行は、既定の `"throw"` を隣の年を引かない内側の範囲で、`"ignore"` を対応年の全範囲で試す。関係ごとに試した設定の数を出し、0 件なら失敗にする。`pnpm check` は決まった抜き出し、全件は `CONSISTENCY_API_FULL=1` で CI の `diagnose-consistency` ジョブ(API どうしの食い違いの穴。種類 A)
103
- - 検査のスクリプトの検査の直し: 取り込み中の変更を `git status -z` で読む(日本語・スペースを含むパスを写せなかった)。写したファイルを出力に出す。result-compare・check-readme-examples の失敗の期待を、検査が誤りの理由として出す文(「**失敗**(意図した変更なら…」「expected "…"」)にした(別の理由で失敗しても合格になっていた)。写し・ビルドの途中の例外でも、表と後始末の問題を出してから失敗で終わる。対照の実行で SKIP の行が出たら失敗にする。飛ばしの決まり: `skipWhen` は skip と todo の取り違えを、`todoFor` は一覧にない理由を、CI でなくても飛ばす条件にかかわらず投げる。省略記法の grep の限界(複数行のオブジェクトの `skip,` は拾わない)を書き、`test/support/skip.ts` の冒頭の「CI」の意味を実装に合わせた(黙って外れる穴。種類 C)
104
- - 検査のスクリプトそのものの検査(`scripts/tool-selftest.ts`。CI の `tool-selftest` ジョブ)を入れた。リポジトリの写し(`git worktree add` の作業ツリーに取り込み中の変更を写し、`node_modules` はリンクでつなぐ。前の版のタグも読める)を一時ディレクトリ(`TOOL_SELFTEST_DIR`)に作り、誤りを入れずに 8 つの検査(`check-package`・`check-size`・`check-readme-examples`・`check-names`・`api-report`・`bench-compare`・`result-compare`・`data-compare`)が合格することを確かめてから、誤りを 1 つずつ(計 12)入れて、どれも失敗し入れた誤りを指す文を出すことを確かめる。後始末は、リンクを先に外し、外せなければ(まだ作っていない場合のほかは)リンクの先まで消えないよう何も消さずに残して失敗にし、最後にリポジトリの `node_modules` が残っていることを確かめる。検査のスクリプトは変えていない(検査の検査がない穴。種類 B)
105
- - `catch` 節の到達の検査: 除外の一覧の名前が 2 つ以上の節で重なるときと、節の文が `try` と同じ行にあるとき(行で数える lcov では判定できない)を失敗にした。`--lcov` は検査そのものを試すための引数で CI は使わないことを書いた。飛ばしの決まり: `skipWhen` は飛ばす条件にかかわらず理由が一覧にあるかを確かめ、grep の対象に `test/support/*.ts` と省略記法(`{ skip }`)を加えた。`RELEASING.md` に、grep で止められる範囲の限界(早い `return`・`continue` は個別の仕組みで守る)と、「CI」の意味(環境変数 `CI` が空でも `"false"` でもないとき)を書いた(種類 C)
106
- - `catch` 節の到達の検査(`scripts/check-catch-coverage.ts`。CI の `catch-coverage` ジョブ)を入れた。Node.js の組み込みのカバレッジでテストを動かし、TypeScript のコンパイラーの API で見つけた `src/core` の `catch` 節(13 か所)の中の行が通ったかを lcov と突き合わせ、通らない節は理由付きの除外の一覧(「ファイル・関数・節の中の最初の文」で引く。今は空)に載せない限り失敗にする。通っていなかった診断の 6 か所(提供元の例外を受け止める経路)には、途中から例外を投げる提供元(`throwingAfter`。提供元の約束の外)で届くテスト(`test/catch-paths.test.ts`)を足した(例外の経路の穴。種類 C)
107
- - 飛ばしの決まり: 前提がそろわないときに飛ばす箇所を補助の関数(`test/support/skip.ts` の `skipWhen`・`todoFor`)に集め、理由を意図した飛ばしの一覧から引くようにした(タイムゾーンを変えた実行、`ORACLE_JOINT`、Temporal のない実行環境、手元で前の版のタグが読めないとき、合成の既知の不具合の `todo`)。CI では、一覧にない理由と CI では飛ばさない理由を失敗にする。補助の関数を通さない飛ばしは grep の検査(`test/skip-policy.test.ts`)が止める(黙って飛ばす穴。種類 C)
108
- - 診断と判定の一致のテストの全件(150 件)を、`CONSISTENCY_FULL=1` で CI の `diagnose-consistency` ジョブで動かす(`pnpm check` は 12 件)。スケジュールから作ったカレンダーのテストで、`daysBetween` も未確定の祝日で投げることを確かめ、スケジュールの第 n 営業日の規則が基準のカレンダーを必須とする理由をコメントに書いた
109
- - 失敗を注入する祝日の提供元(`test/support/faulty.ts`。特定の年で例外を投げる・ある年だけ不正なデータ(日付の書式・重複・型の違う項目)を返す・途中の年を未確定にする)を作り、判定・診断・合成の結果が文書のとおりかを確かめるテスト(`test/faulty-provider.test.ts`)を足した。文書が何も言っていなかった組み合わせ(例外を投げる提供元の判定・合成・診断、不正なデータの提供元の合成、未確定の祝日の診断)は、今の挙動を約束として `docs/providers.ja.md`・`docs/providers.md` の「提供元の約束と誤りの扱い」に書き、テストで確かめる。提供元の約束に「`holidaysInYear` は同じ年に同じ結果を返す」を足し、途中から例外を投げる提供元は約束の外とした(例外の経路の穴。種類 C)
110
- - 診断のオラクル: カナリアの理由のテストで、`"over-holiday"` の開く規則を実際に取り除くと全日の結果が変わることまで確かめる。`test/properties.test.ts`: `PROPERTY_CONFIGS` に古い名前が残っていないこと、性質が 1 回の試行で 1 回だけ設定を作ることも確かめる。`scripts/record-generator-features.ts`: 作業ツリーの指定を真偽値で持ち、`"worktree"` という名前の参照と取り違えない。`RELEASING.md`・オラクルの冒頭のコメント: タイムゾーンを変えた実行で飛ばすのはオラクルの総当たりで、カナリアの 2 件は動かすと直した
111
- - `scripts/record-generator-features.ts`: 作業ツリーは `--worktree` で指すようにした。`--ref HEAD`(git ではコミットを指す名前)は、`--worktree` を案内する使い方の誤りにした。CI の `generator-features` ジョブも `--worktree --check` にした
130
+ - サイズの上限: 上限を 25,800 から 26,500 に上げた `./diagnose`(測定 26,158)
131
+ - 診断のオラクル: カナリア(完全性の報告に必ず出る設定)が取り除ける理由を確かめた
132
+ - 診断のオラクル: `ORACLE_FULL` なしの `ORACLE_SHARD` を例外にした
133
+ - 生成範囲: 危険の分かっている組み合わせの一覧を作り、呼び出し側ごとに 1 回以上作ることを確かめる(作れない組み合わせは事実の理由を付けて除く)
134
+ - 生成範囲: `test/properties.test.ts` の性質は、設定を作る乱数(性質の名前から決まる種の列)と、日付などを引く乱数を分けた
135
+ - API どうしの整合の検査(`test/consistency.test.ts`)を入れた(全件は `CONSISTENCY_API_FULL=1` で CI の `diagnose-consistency` ジョブ)
136
+ - 検査のスクリプトの検査の直し: 取り込み中の変更を `git status -z` で読む(日本語・スペースを含むパスを写せなかった)
137
+ - 検査のスクリプトそのものの検査(`scripts/tool-selftest.ts`。CI の `tool-selftest` ジョブ。写しを作る場所は `TOOL_SELFTEST_DIR`)を入れた
138
+ - `catch` 節の到達の検査: 除外の一覧の名前が 2 つ以上の節で重なるときと、節の文が `try` と同じ行にあるとき(行で数える lcov では判定できない)を失敗にした。`--lcov` は検査そのものを試すための引数で、CI は使わない
139
+ - `catch` 節の到達の検査を入れた
140
+ - 飛ばしの決まり: 前提がそろわないときに飛ばす箇所を補助の関数に集め、理由を意図した飛ばしの一覧から引くようにした
141
+ - 診断と判定の一致のテストの全件(150 件)を、`CONSISTENCY_FULL=1` で CI の `diagnose-consistency` ジョブで動かす(`pnpm check` は 12 件)
142
+ - 失敗を注入する祝日の提供元を作り、判定・診断・合成の結果が文書のとおりかを確かめるテストを足した
143
+ - 診断のオラクル: カナリアの理由のテストで、`"over-holiday"` の開く規則を実際に取り除くと全日の結果が変わることまで確かめる
144
+ - `scripts/record-generator-features.ts`: 作業ツリーは `--worktree` で指すようにした(`--ref HEAD` は使い方の誤り。CI の `generator-features` ジョブは `--worktree --check`)
112
145
  - `RELEASING.md`: オラクルと生成範囲の行を実装と 1 文ずつ突き合わせ、消えていた「タイムゾーンを変えた実行では、オラクルと日本の全範囲の走査を飛ばす」を戻し、組み合わせの一覧の検査・カナリアの理由の確認・0 件の検査・`ORACLE_SHARD` の条件・CI の実測の時間を書いた
113
146
 
114
147
  ## [0.30.5] - 2026-11-01
@@ -117,20 +150,20 @@
117
150
 
118
151
  ### 開発
119
152
 
120
- - 生成範囲を減らさない検査を入れた(`test/generator-features.test.ts`)。3 つの生成器を目録に切り替えたとき、v0.30.3 の生成器が作っていた形(曜日に合わない起点・自分の曜日を含む飛ばす曜日などの入力の誤り、第 n 営業日の 3・5、日付の 10・20・25、走査の範囲の外の有効期間、`02-29`・`{ date }`・有効期間付きの毎年の月日、提供元にない種別、さまざまな曜日の組み合わせの定休日、日本の提供元での数十年の走査など)が落ちていた。`scripts/record-generator-features.ts` で v0.30.3 の呼び出し側を種と試行の数を変えずに動かし、作った設定の特徴(`test/support/features.ts`)を呼び出し側ごとに `test/fixtures/generator-features-0.30.3/` に記録した。v0.30.4 の呼び出し側は 113 の特徴を作らなかった。落ちた形を目録に戻し、今の呼び出し側が記録の特徴をすべて作ることを確かめる(意図して落とす特徴は `DROPPED_FEATURES` に事実の理由を付ける。今は空)。比べ方はスクリプトとテストで 1 か所(`test/support/features-compare.ts`)。スクリプトが子プロセスに渡す `--import` の値はファイルの URL にし(Windows の絶対パスを渡すと Node.js が止まる)、単体テスト(`test/import-args.test.ts`)で確かめる。記録は基準の版からだけ作り(`--update` は `--ref v0.30.3` でだけ動き、記録の各ファイルに取った版を書いて読むときに確かめる)、今の版から作り直さない(今の版から作ると、包含の検査が自分自身との比較になるため)。作り直すのは比べ方(特徴の取り出し方)を変えたときだけ。実際の呼び出し側を動かして確かめる CI の `generator-features` ジョブを足した(Node.js の警告が出たら失敗)(生成器の偏りの穴。テスト拡充案の種類 A)
121
- - 呼び出し側の設定の作り方を `test/support/sites.ts`・`test/support/result-cases.ts` の関数にまとめ、呼び出し側と検査が同じ関数を使うようにした(diagnose-properties と result-compare は、同じ種と試行の数で設定まで一致する。properties は性質の中でも乱数を使うので、検査は近似になる。実際の呼び出し側の包含は CI の `generator-features` ジョブで確かめる)。`test/diagnose-properties.test.ts` の試行を増やし(全日を比べる設定 30 → 100 件。タイムゾーンを変えた実行では、暦日だけで決まるので 30 件、第 n 営業日の設定は 30 → 15 件)、日本の提供元の全範囲(1955〜2099 年)と同じ範囲の提供元なしの設定で取り除いた結果を比べる性質のテストを足した(タイムゾーンを変えた実行では飛ばす)(種類 A)
122
- - 生成器の到達性を、呼び出し側の文脈ごと・規則の形ごとに確かめるようにした(`test/catalog.test.ts`)。これまではキーを全部の形の和集合で数え、ある形でだけ作られないキーを見逃していた。文脈は `test/support/sites.ts` の `CONTEXT_USES` に書き出し、文脈で作らない形(提供元のない設定の祝日に従属する形、0.22.2 と比べる設定の週の第 n 営業日)は理由付きで除く(種類 A)
123
- - 目録の除外の一覧を `"型.キー"` で引くようにし、除外したキーが `etc/api.md` に実在すること、呼び出し側が実際には作らないことも確かめる。0.30.4 の一覧は、作っているキー(`weekdayValues`・`sameAs`・`value`)を除外し、`calendar` を「スケジュールの生成器が別に付ける」としていたが、どの生成器も付けていなかった(種類 A)
124
- - `scripts/result-compare.ts`: スケジュールの第 n 営業日の規則に、数える基準のカレンダー(`calendar`)を付けるようにした。これまでは付けていなかったので、その設定は前の版・今回の版のどちらでも作成が `invalid-option` になり、結果を一度も比べていなかった(v0.30.3 から)。入力の誤りの設定(生成器が意図して混ぜ、規則に印を付けたもの)の件数を Job Summary に出し、印のない設定の作成の失敗(意図せず作成に失敗した設定)が 1 件でもあれば失敗にし、入力の誤りの設定が 0 件のときも空振りとして失敗にする。エラーコードでは分けない。印は規則のオブジェクトに付くので、印が誤りの形の規則とそろうこと(写した規則で消えていないこと)を `test/catalog.test.ts` で確かめる(黙って見ていない穴。種類 C)
125
- - 診断のオラクルの項目を、目録の乱数から切り離して明示した一覧(`test/fixtures/oracle-items.json`。0.30.4 の項目と同じ)にした。目録の値の候補を広げても、オラクルの項目は意図して変えない限り変わらない。一覧が目録のすべての形とキーを含むことを確かめ、今の不足(曜日の規則の `nth`・`months`・`skipWeekdays` など 8 つ)は `ITEM_GAPS` に理由付きで載せた(項目を足すと組み合わせが約 1.4 倍になり全件の実行が CI の時間を超えるので、全件の実行を行列に分けてから足す)(種類 B)
126
- - 黙って飛ばさない: `test/properties.test.ts` は飛ばした試行の件数をいつも「飛ばした試行: n / N(理由)」で出し、上限(1 割)を超えたら失敗にする(比べる処理は `checkSkipped` に切り出し、件数を直接渡す単体テストで、種に頼らずに確かめる)。`ORACLE_SHARD` の書式の誤りと `k >= n` を例外にした(これまでは黙って無視するか、何も試さずに合格した)。数でない値が黙って既定や `NaN` になっていた環境変数と引数も、例外か使い方の誤りにした: `PROPERTY_SEED`(数でないと種 0 で動いていた)、`ORACLE_FULL`・`ORACLE_JOINT`("1" 以外の値で黙って抜き出しだけを試していた。`test/support/env.ts`)、`scripts/result-compare.ts` の `--seed`・`--scale`(`NaN` だと乱数の設定が 0 件のまま合格した)、`scripts/bench-compare.ts` の `--ratio`(`NaN` だと比べる条件がすべて偽で合格した)(種類 C)
127
- - 診断のオラクルの完全性の報告(取り除けるのに何も出ない項目)を確かめられるようにした。0 件のときは「なし」と出す。0 件だったのは項目の違いで、集計の誤りではなかった(外部のレビューの試作の項目を正式版のオラクルで動かすと、試作と同じく開く規則「5・7 月の月曜」の 2 件が出た)。その設定をカナリアとして固定し、報告に出ることを確かめる。全件では、`shadowed`・`never-matches`・`redundant`・`expired` がどれも 1 件以上出ることも確かめる(報告の仕組みが壊れても気づけない穴。種類 B)
128
- - 診断のオラクルの範囲を広げた。項目の一覧に、目録の形とキーの不足を埋める 6 つの規則を足して `ITEM_GAPS` を空にし(59 → 71 項目)、休業日の扱いの方針 3 通りと定休日 3 通り(`[0, 6]`・`[0]`・`[]`)を試す(項目 1 つの設定はすべての組み合わせ、項目 2 つの設定は方針 3 通り × 土日、定休日 `[0]`・`[]` との 2 つの組み合わせは種で決まる 8 件に 1 件)。全件の設定は 3,481 → 9,976 件。全件の実行は CI の 1 ジョブあたり 10 分以内という決まりを `RELEASING.md` に書き、CI の `oracle` ジョブを `ORACLE_SHARD` で 3 つの行列に分けた。Job Summary に方針ごと・定休日ごとの件数と抜き出しの割合を出す。`pnpm check` は全件から 111 件に 1 件の抜き出しを試す(生成器の偏りの穴。種類 A)
129
- - 診断の `counting-basis` の文を、毎週の曜日の規則が開く規則か閉じる規則かの両側で確かめる単体テストを足した(`test/counting-basis.test.ts`)(文の分岐を確かめていなかった穴。種類 C)
130
- - 生成範囲の検査の補修: 特徴の取り出しの診断の走査の範囲(`diagnoseRangeOf`)に、対応年が 1900〜2099 年と重ならないときに先頭の 200 年にする扱いを入れ、単体テストで確かめる(`test/features.test.ts`)。記録を作り直す(`--update`)ときは、呼び出し側の終了コード 0 を必須にした(比べるときは見ない。理由はスクリプトの冒頭)。テストとスクリプトで result-compare の拾える特徴の数が違う理由(差はすべて、スケジュールの基準のカレンダーにライブラリが問い合わせた日付の特徴)をテストに書いた。生成範囲の検査が守るのは個々の特徴だけで、特徴の組み合わせは守らない(組み合わせは診断のオラクルの総当たりでしか守られていない)ことを `RELEASING.md` に書いた(種類 A)
153
+ - 生成範囲を減らさない検査を入れた(`test/generator-features.test.ts`。記録は `scripts/record-generator-features.ts --update --ref v0.30.3` でだけ作る)
154
+ - 呼び出し側の設定の作り方を `test/support/sites.ts`・`test/support/result-cases.ts` の関数にまとめ、呼び出し側と検査が同じ関数を使うようにした
155
+ - 生成器の到達性を、呼び出し側の文脈ごと・規則の形ごとに確かめるようにした(`test/catalog.test.ts`)
156
+ - 目録の除外の一覧を `"型.キー"` で引くようにし、除外したキーが `etc/api.md` に実在すること、呼び出し側が実際には作らないことも確かめる
157
+ - `scripts/result-compare.ts`: スケジュールの第 n 営業日の規則に、数える基準のカレンダー(`calendar`)を付けるようにした
158
+ - 診断のオラクルの項目を、目録の乱数から切り離して明示した一覧にした
159
+ - 黙って飛ばさない: `test/properties.test.ts` は飛ばした試行の件数をいつも「飛ばした試行: n / N(理由)」で出し、上限(1 割)を超えたら失敗にする。誤った値が黙って既定になっていた `ORACLE_SHARD`・`PROPERTY_SEED`・`ORACLE_FULL`・`ORACLE_JOINT` と、`result-compare.ts` の `--seed`・`--scale`、`bench-compare.ts` の `--ratio` を、例外か使い方の誤りにした
160
+ - 診断のオラクルの完全性の報告(取り除けるのに何も出ない項目)を確かめられるようにした
161
+ - 診断のオラクルの範囲を広げた(全件の設定 3,481 → 9,976 件。CI の `oracle` ジョブを `ORACLE_SHARD` で 3 つの行列に分けた)
162
+ - 診断の `counting-basis` の文を、毎週の曜日の規則が開く規則か閉じる規則かの両側で確かめる単体テストを足した(文の分岐を確かめていなかった穴。種類 C)
163
+ - 生成範囲の検査の補修: 特徴の取り出しの診断の走査の範囲(`diagnoseRangeOf`)に、対応年が 1900〜2099 年と重ならないときに先頭の 200 年にする扱いを入れ、単体テストで確かめる(`test/features.test.ts`)
131
164
  - `RELEASING.md`: 診断のオラクルの環境変数(`ORACLE_FULL`・`ORACLE_SHARD`・`ORACLE_TARGET`・`ORACLE_JOINT`)と、全件の実行の時間の決まりを書いた
132
165
  - `test/diagnose-properties.test.ts` の冒頭に二重に残っていた古い説明のコメントを消した
133
- - `RELEASING.md`: 品質の確認に生成範囲の行を足し、目録・オラクルの行を今の検査に合わせた。生成範囲の記録は基準の版(v0.30.3)から取り、作り直すのは比べ方(特徴の取り出し方)を変えたときだけにして、CHANGELOG の「開発」に理由を書くことを書いた
166
+ - `RELEASING.md`: 品質の確認に生成範囲の行を足し、目録・オラクルの行を今の検査に合わせた
134
167
 
135
168
  ## [0.30.4] - 2026-11-01
136
169
 
@@ -142,13 +175,13 @@
142
175
 
143
176
  ### 開発
144
177
 
145
- - 規則と設定の目録 `test/support/catalog.ts` を置き、乱数のテスト(`test/properties.test.ts`・`test/diagnose-properties.test.ts`)と `scripts/result-compare.ts` の生成器を目録に切り替えた。`test/catalog.test.ts` が、目録を `etc/api.md` の公開の型(繰り返しの規則の形・設定のキー・選択肢の値)と突き合わせ、生成器が目録のすべての形・キー・値を作ることを確かめる(生成器の偏りの穴を塞ぐ。第 n 営業日の規則が生成器になく、誤った `redundant` を見逃した種類)
146
- - `test/properties.test.ts` のカレンダーに、目録の繰り返しの規則を入れた(これまでは繰り返しの規則のないカレンダーだけを試していた)。営業日のないカレンダーになった試行は、性質の前提を満たさないので飛ばす(1 割まで)
178
+ - 規則と設定の目録 `test/support/catalog.ts` を置き、乱数のテストと `scripts/result-compare.ts` の生成器を目録に切り替えた
179
+ - `test/properties.test.ts` のカレンダーに、目録の繰り返しの規則を入れた(これまでは繰り返しの規則のないカレンダーだけを試していた)
147
180
  - `test/diagnose-properties.test.ts` は、対応年の短い自作の提供元(`test/support/provider.ts`)で全日を比べる(400 日の抜き出しをやめた)
148
- - 診断の総当たりのオラクル `test/diagnose-oracle.test.ts` を入れた。目録の規則の形の代表と個別の日付・毎年の月日の 2 つまでの組み合わせで、出た項目を取り除いて全日の結果を比べ、`expired`・`no-business-day`・`counting-basis` の約束も確かめる。`pnpm check` は決まった抜き出し、CI の `oracle` ジョブはすべての組み合わせを試し、完全性(取り除けるのに何も出ない項目)を Job Summary に報告する。出た項目をまとめて取り除いても変わらない性質(診断の判定の作り直し(0.31.0)の正解の定義)は、印を付けて用意した(`ORACLE_JOINT=1` で試せる)。0.30.2 に向けると、すべての組み合わせで第 n 営業日の誤った `redundant` を検出する(正解と突き合わせる仕組みの不在の穴を塞ぐ)
181
+ - 診断の総当たりのオラクル `test/diagnose-oracle.test.ts` を入れた(出た項目をまとめて取り除く性質は `ORACLE_JOINT=1` で試せる)
149
182
  - `scripts/test-tz.ts`: タイムゾーンを変えた実行では、オラクルを飛ばす(暦日だけで決まるので)
150
183
  - `RELEASING.md`: 品質の確認に目録とオラクルを足し、手元の確認は前の版のタグを読める状態で通すことを書いた
151
- - サイズ(gzip): `./diagnose` 25,321 → 25,360(測定 25,360。上の Fixed の文の分)。上限は変えていない
184
+ - サイズ(gzip): `./diagnose` 25,321 → 25,360(測定 25,360。上の Fixed の文の分)
152
185
 
153
186
  ## [0.30.3] - 2026-11-01
154
187
 
@@ -171,16 +204,15 @@
171
204
 
172
205
  ### 開発
173
206
 
174
- - `test/diagnose.test.ts`・`test/diagnose-properties.test.ts`: 上の Fixed の 4 例(月・週の第 n 営業日、閉じる・開く規則)と、スケジュールの第 n 営業日の規則では結果が変わらないことのテストを足した。性質のテストの設定の生成に第 n 営業日の規則を足し、第 n 営業日の規則と個別の日付を必ず持つ設定の性質を足した(0.30.2 では失敗する。生成に入っていなかったので、この不具合を見逃していた)
175
- - `scripts/result-compare.ts`: 意図した差分を、診断の消えた結果のコード(`removedCodes`)で絞れるようにした。上の Fixed の差分を、第 n 営業日の規則と個別の日付・毎年の月日を持つ設定の `redundant` が消えたものだけに絞って許す(`counting-rules-with-dates`)。上の Fixed の例を固定の設定に足した(週の第 n 営業日の例は、それがない 0.22.2 とは比べない)
176
- - サイズの上限: `./diagnose` を 25,000 から 25,800 に上げた(上の Fixed で上限を超えたため。測定値に小さな余裕を足した値)
177
- - サイズ(gzip): `./diagnose` 24,753 → 25,321(測定 25,321)。ルート 17,997(測定 17,997)と `./jp` 20,226(測定 20,226)は変わらない
178
- - Node.js 26 が LTS に入ったので、CI の `check` の行列を 22.23.4・24.22.2・26.13.0 に上げ(2026-10-21 のセキュリティリリース、24 系はその後の不具合の修正(2026-10-28)、26 の LTS の最初の版)、ビルド・ブラウザー・ランタイム・比較・公開・監視のジョブの固定の版を 26.13.0 にした。`compat` は engines の下限の 22.12.0 だけにした(26 は `check` で確かめるようになり、LTS 入りを控えた系列は今はない)。`RELEASING.md` の npm 12 の動作要件を今の値(`>=26.0.0` を含む)に、公開物の互換性の行の `compat` の版を直した。開発環境とそろえ、npm を 12.2.1、pnpm を 12.16.1 に上げた(どちらも公開から 48 時間を過ぎた版)
179
- - `scripts/check-package.ts`: 決定の文書の目次が本文の章・見出しと一致すること(番号の重複も)を確かめる。CHANGELOG の 0.30.2 までの節の番号は旧番号の対応表で確かめ、`` `docs/decisions.md` の N 番 `` のようにバッククォートで囲んだ参照も確かめるようにした(これまでは見ていなかった)。「番」を書き忘れた参照(`decisions.md の 15`)は形の誤りとして止める
207
+ - `test/diagnose.test.ts`・`test/diagnose-properties.test.ts`: 上の Fixed の 4 例(月・週の第 n 営業日、閉じる・開く規則)と、スケジュールの第 n 営業日の規則では結果が変わらないことのテストを足した
208
+ - `scripts/result-compare.ts`: 意図した差分を、診断の消えた結果のコード(`removedCodes`)で絞れるようにした
209
+ - サイズの上限: `./diagnose` を 25,000 から 25,800 に上げた
210
+ - サイズ(gzip): `./diagnose` 24,753 → 25,321(測定 25,321)
211
+ - Node.js 26 が LTS に入ったので、CI の `check` の行列を 22.23.4・24.22.2・26.13.0 に上げ、ビルド・ブラウザー・ランタイム・比較・公開・監視のジョブの固定の版を 26.13.0 にした
212
+ - `scripts/check-package.ts`: 決定の文書の目次が本文の章・見出しと一致すること(番号の重複も)を確かめる
180
213
  - `scripts/bench-compare.ts`: CHANGELOG の今の版(または [Unreleased])の「開発」に決まった言葉で理由を書いた版は、2 倍を超えて遅くなっても表に記録して合格にする(言葉は `RELEASING.md` の品質の確認の表)
181
- - `etc/result-changes.json` に 0.30.1 の修正(和集合の旧名 `"national"`)を足した。公開済みの 0.30.0 → 0.30.1 を比べたとき、意図した修正ではなく診断の退行だけが「許していない差分」として出る
182
-
183
- - `scripts/result-compare.ts`: 意図した差分を許す特徴を、比べた対象ごとに付けるようにした。0.30.2 では合成の組の相手の特徴まで付けていたので、相手だけが日本の提供元と `kinds: ["regular"]` を持つ組では、元のカレンダー単独の差分まで許していた。合成だけ組の両方の設定から、ほかはその設定だけから付ける。日本の提供元だけの設定の `"national"` の特徴は、同じ配列に同じ形で `"regular"` を含む規則もあるときだけ付ける(名前を `kinds-national-and-regular-with-jp-only` に改めた。前の版が 0.30.1 のときだけ効く項目)
214
+ - `etc/result-changes.json` に 0.30.1 の修正(和集合の旧名 `"national"`)を足した
215
+ - `scripts/result-compare.ts`: 意図した差分を許す特徴を、比べた対象ごとに付けるようにした
184
216
  - `test/fixtures/national-union-0.22.2.json` の出典の説明で、`"national"` の扱いの根拠を旧 55 番としていたのを旧 54 番(今の 10 番)に直した
185
217
 
186
218
  ## [0.30.2] - 2026-10-30
@@ -203,10 +235,10 @@
203
235
 
204
236
  ### 開発
205
237
 
206
- - CI に `result-compare` ジョブを足した(`scripts/result-compare.ts`)。種で決まる設定の集まりと過去の退行を再現する固定の設定を、公開済みの前の版と今回の `dist` に渡し、カレンダー(直接・合成・スケジュールから)とスケジュールの結果を 1 日ずつ比べ、診断は前の版の結果がすべて含まれることを確かめる。意図した差分は `etc/result-changes.json` に特徴・版・出典を書いたものだけを許す。0.30.x の間は 0.22.2 とも旧名の設定で比べる。公開済みの版どうしで確かめると、0.22.2 → 0.30.0 で和集合の `"national"` の退行を、0.30.0 → 0.30.1 で上の診断の退行を検出する
238
+ - CI に `result-compare` ジョブを足した(`scripts/result-compare.ts`)
207
239
  - `scripts/check-names.ts`: 前の版を動かす `scripts/result-compare.ts` を、旧名の検査(C14)の対象から外した
208
240
  - `test/national-union.test.ts` に、日本の提供元だけの設定の `shadowed` の確認を足した
209
- - サイズ(gzip): ルート 18,054 → 17,997(測定 17,997)、`./jp` 20,288 → 20,226(測定 20,226)、`./diagnose` 24,492 → 24,753(測定 24,753)。上限は変えていない
241
+ - サイズ(gzip): ルート 18,054 → 17,997(測定 17,997)、`./jp` 20,288 → 20,226(測定 20,226)、`./diagnose` 24,492 → 24,753(測定 24,753)
210
242
 
211
243
  ## [0.30.1] - 2026-10-30
212
244
 
@@ -228,10 +260,10 @@
228
260
 
229
261
  ### 開発
230
262
 
231
- - `scripts/check-names.ts` に、形を分けるための `?: never` の項目に TSDoc が付いていないこと(C13)と、今の状態を書いた文書・スクリプト・型定義の TSDoc に 0.30.0 の旧名が残っていないこと(C14)の検査を足した(`etc/naming.md`)。0.30.0 に当てると、C13 は 2 か所、C14 はガイドの引数名・RELEASING.md・`check-readme-examples.ts` の補い・型定義の `@example` と `day:` を検出する
232
- - `scripts/check-size.ts`: 上限を変えた版で、CHANGELOG の測定値(「(測定 N)」の形)を 1 つも照合できなければ失敗にし、照合した件数を出すようにした。0.30.0 の節は測定値をこの形で書いておらず、照合が 0 件のまま合格していた(記載の値は、測定の後の内部の関数名の変更で公開物と 6〜7 バイト違っていた)
233
- - 和集合の `"national"` のテスト(`test/national-union.test.ts`)を足した。日本の提供元を包んだ設定との関係を対応年のすべてで確かめ、公開済みの 0.22.2 の結果(2020〜2027 年)を錨にする(`test/fixtures/national-union-0.22.2.json`)
234
- - サイズ(gzip): ルート 17,646 → 18,054(測定 18,054)、`./jp` 19,890 → 20,288(測定 20,288)、`./diagnose` 23,919 → 24,492(測定 24,492)。和集合の `"national"` の判定とメッセージのため。上限は変えていない(ルート・`./jp`・`./diagnose` は上限の 97〜98%)
263
+ - `scripts/check-names.ts` に、形を分けるための `?: never` の項目に TSDoc が付いていないこと(C13)と、今の状態を書いた文書・スクリプト・型定義の TSDoc に 0.30.0 の旧名が残っていないこと(C14)の検査を足した
264
+ - `scripts/check-size.ts`: 上限を変えた版で、CHANGELOG の測定値(「(測定 N)」の形)を 1 つも照合できなければ失敗にし、照合した件数を出すようにした
265
+ - 和集合の `"national"` のテストを足した
266
+ - サイズ(gzip): ルート 17,646 → 18,054(測定 18,054)、`./jp` 19,890 → 20,288(測定 20,288)、`./diagnose` 23,919 → 24,492(測定 24,492)
235
267
 
236
268
  ## [0.30.0] - 2026-10-27
237
269
 
@@ -270,11 +302,11 @@
270
302
 
271
303
  ### 開発
272
304
 
273
- - 名前の規則の検査 `scripts/check-names.ts` を `pnpm check` に足した(`etc/naming.md` の用語集・外部の名前の出典と、移行ガイドの削除予定の表に照らす。名前を許す一覧は持たない)。名前が約束する意味は `test/naming.test.ts` の性質のテストで確かめる
305
+ - 名前の規則の検査 `scripts/check-names.ts` を `pnpm check` に足した
274
306
  - 改名の表を `src/core/renamed.ts` の 1 か所に置き、読み替え・診断・`migrate…` がこの表だけを使う
275
307
  - `scripts/bench.ts` は、前の版が新しい名前を知らないときは設定を旧名に戻して渡す(CI の bench が同じ場面を比べるため)
276
308
  - `scripts/check-readme-examples.ts` は、0.30.x の間だけ返す旧名の項目(削除予定の表から決める)を比べない
277
- - サイズの上限を上げた(ルート 17,500 → 18,500、`./jp` 19,500 → 21,000、`./diagnose` 23,000 → 25,000、`./provider` 3,500 → 4,500 バイト)。改名の表・旧名の読み替え・旧名の別名・週の第 n 営業日・`migrate…` のため。gzip でルート 16,074 → 17,639、`./jp` 18,293 → 19,883、`./diagnose` 21,445 → 23,913、`./provider` 3,111 → 4,041 バイト
309
+ - サイズの上限を上げた
278
310
  - README のサイズの値を 0.30.0 で測り直した
279
311
 
280
312
  ## [0.22.2] - 2026-10-27
@@ -320,7 +352,7 @@
320
352
 
321
353
  ### 開発
322
354
 
323
- - サイズの上限(`size-limits.json`)を上げた。ルート 16,500 → 17,500(測定 16,074)、`./jp` 19,000 → 19,500(測定 18,293)、`./diagnose` 22,000 → 23,000(測定 21,445)(gzip)。周期の規則の検証・判定、祝日の翌日・祝前日の絞り込みと塊の判定、診断の追加のため
355
+ - サイズの上限(`size-limits.json`)を上げた
324
356
 
325
357
  ## [0.21.4] - 2026-10-26
326
358
 
@@ -333,9 +365,9 @@
333
365
 
334
366
  ### 開発
335
367
 
336
- - `pnpm check`(`scripts/check-package.ts`)に、コメントと文書の参照の検査を足した(decisions.md の 52 番)。今の状態を書いたファイルに書いたファイルのパス(`scripts/…`・`docs/…` など)が実在すること、すべての文書の「decisions.md の N 番」の N が決定の文書にあること。0.21.3 に当てると `scripts/bundled-providers.ts` のコメントの誤り(実在しない `scripts/check-docs.ts`)を検出する
337
- - スクリプト・ワークフロー・テスト・`src` のコメント(型定義に出る TSDoc を含む)から、決定の文書と重複する理由の説明、版の経緯(「0.18.0 で追加」など)、利用元の一覧、変わりうる事実(検証のフィクスチャの一覧・TypeScript や Node.js の版の一覧・照合する国の一覧や数など)を削り、何をするか・使い方・決定の文書の番号だけを残した(52 番)
338
- - サイズの上限(`size-limits.json`)を、コメントを除いた `.js` の実測に合わせて下げた(上限を下げるだけなので理由の記載は要らないが、記録として書く)。ルート 26,500 → 16,500(測定 15,438)、`./jp` 29,500 → 19,000(測定 17,654)、`./uk` 9,000 → 5,000(測定 4,402)、`./sg` 6,000 → 3,500(測定 3,079)、`./fr` 6,500 → 3,000(測定 2,707)、`./diagnose` 35,500 → 22,000(測定 20,648)、`./provider` 6,500 → 3,500(測定 3,111)(gzip)
368
+ - `pnpm check`(`scripts/check-package.ts`)に、コメントと文書の参照の検査を足した(decisions.md の 52 番)
369
+ - スクリプト・ワークフロー・テスト・`src` のコメント(型定義に出る TSDoc を含む)から、決定の文書と重複する理由の説明、版の経緯(「0.18.0 で追加」など)、利用元の一覧、変わりうる事実を削り、何をするか・使い方・決定の文書の番号だけを残した(52 番)
370
+ - サイズの上限(`size-limits.json`)を、コメントを除いた `.js` の実測に合わせて下げた
339
371
 
340
372
  ## [0.21.3] - 2026-10-26
341
373
 
@@ -348,9 +380,9 @@
348
380
 
349
381
  ### 開発
350
382
 
351
- - `pnpm check`(`scripts/check-package.ts`)に、ドキュメントの数値・一覧を `dist` とソースの型と照合する検査を足した(decisions.md の 51 番)。README の提供元の表とガイドの国の節・「対応年の外」の節の対応年とタイムゾーン・`confirmedThrough`、祝日の識別子の表の key、エラーコードの一覧と診断の表のコード、README の「測った版」が今のマイナー系列であること、英日の対の文書で節ごとの数値がそろうこと。0.21.2 の文書に当てると、ガイドのフランスの対応年・README のサイズの測った版・診断の表とエラーコードの一覧の抜け・版の固定の例の英日の違いを検出する
352
- - CI に `data-compare` ジョブを足した。公開済みの前の版(npm の `latest`)と今回の `dist` の同梱の提供元を、対応年が重なるすべての年で 1 日ずつ比べ(`scripts/data-compare.ts`)、`key` が変わったとき、差分があるのに CHANGELOG に Data がないとき、提供元がなくなったか対応年が狭まったときに失敗する。照合のフィクスチャのない年(予測の年など)の安全網
353
- - README のサイズを測る `scripts/measure-bundle.ts` を足した(esbuild は依存にせず、パスを引数で渡す。pnpm check・CI には含めない)
383
+ - `pnpm check`(`scripts/check-package.ts`)に、ドキュメントの数値・一覧を `dist` とソースの型と照合する検査を足した(decisions.md の 51 番)
384
+ - CI に `data-compare` ジョブを足した
385
+ - README のサイズを測る `scripts/measure-bundle.ts` を足した
354
386
 
355
387
  ## [0.21.2] - 2026-10-26
356
388
 
@@ -360,7 +392,7 @@
360
392
 
361
393
  ### 開発
362
394
 
363
- - 納品の検査を `pnpm check` に 3 つ足した(decisions.md の 50 番)。`check-size`: CHANGELOG の今の版の節に書いた「測定 N」が実際の測定と一致すること(測り直し忘れを検出)。`check-package`: `docs/sources/*.md` が README.md と docs/README.ja.md の両方からリンクされていること、テスト用フィクスチャの `record`(出典の記録の節へのパス#アンカー)が実在すること
395
+ - 納品の検査を `pnpm check` に 3 つ足した(decisions.md の 50 番)
364
396
 
365
397
  ## [0.21.1] - 2026-10-26
366
398
 
@@ -391,8 +423,8 @@
391
423
 
392
424
  ### 開発
393
425
 
394
- - テスト: `test/uk-1974-1999.test.ts`・`test/uk-2000-2011.test.ts` と、フィクスチャ `test/fixtures/uk-1974-1999-proclamations.json`・`test/fixtures/uk-2000-2011-government-lists.json` を追加した。出典の収集の記録を `docs/sources/` に置いた
395
- - サイズの上限(`size-limits.json`)を上げた。`./uk` 7,500 → 9,000(測定 8,576。1974〜2011 年の `RENAMED`・臨時の祝日・移動の表のため)(gzip)
426
+ - テスト: `test/uk-1974-1999.test.ts`・`test/uk-2000-2011.test.ts` と、フィクスチャ `test/fixtures/uk-1974-1999-proclamations.json`・`test/fixtures/uk-2000-2011-government-lists.json` を追加した
427
+ - サイズの上限(`size-limits.json`)を上げた
396
428
 
397
429
  ## [0.20.0] - 2026-10-25
398
430
 
@@ -415,7 +447,7 @@
415
447
 
416
448
  ### 開発
417
449
 
418
- - 監視のワークフロー `data-watch.yml` に data.gouv.fr の照合を足した(issue のラベル `datagouv-data`。ハートビートは 4 つの照合がすべて動いたときだけ)。`scripts/verify-datagouv.ts` を英国・シンガポール・日本と同じ形で追加した(`pnpm verify:datagouv`)
450
+ - 監視のワークフロー `data-watch.yml` に data.gouv.fr の照合を足した。`scripts/verify-datagouv.ts`(`pnpm verify:datagouv`)を追加した
419
451
  - テスト: `test/fr-rules.test.ts`・`test/fr-datagouv.test.ts` を追加し、`test/holiday-key.test.ts`・ESM/CJS/ブラウザー/workerd の確認・利用者の型チェックにフランスを足した
420
452
  - サイズの上限(`size-limits.json`)に `./fr` 6,500(測定 5,404)を足した(gzip)
421
453
 
@@ -439,9 +471,9 @@
439
471
 
440
472
  ### 開発
441
473
 
442
- - 監視の照合スクリプト(`scripts/verify-govuk.ts`・`verify-datagovsg.ts`・`verify-cao.ts`)の「確認した日付」を UTC から日本時間に揃えた(issue のコメントの日付と同じ基準)
474
+ - 監視の照合スクリプトの「確認した日付」を UTC から日本時間に揃えた(issue のコメントの日付と同じ基準)
443
475
  - テスト: `test/business-day-of-month.test.ts`・`test/skip-weekdays.test.ts` を追加し、`test/types.check.ts`・利用者の型チェックに新しい規則を足した
444
- - サイズの上限(`size-limits.json`)を上げた。ルート 25,000 → 26,500(測定 25,100)、`./jp` 28,000 → 29,500(測定 28,128)、`./diagnose` 33,000 → 35,500(測定 34,038)(gzip)。第 n 営業日の規則の判定・基準のキャッシュ・検証と、`skipWeekdays` の振替、診断の追加のため
476
+ - サイズの上限(`size-limits.json`)を上げた
445
477
 
446
478
  ## [0.18.0] - 2026-10-25
447
479
 
@@ -464,9 +496,9 @@
464
496
 
465
497
  ### 開発
466
498
 
467
- - 監視のワークフロー `data-watch.yml` に内閣府「国民の祝日」CSV の照合を足した(issue のラベル `cao-data`。ハートビートは 3 つの照合がすべて動いたときだけ)。`scripts/verify-cao.ts` を英国・シンガポールと同じ形(`--report`・`--simulate`、終了コード 0・1・2、取得の再試行、「New years published」・フィクスチャの差分の節)にした。翌年の春分・秋分の日の公表が issue で届くので、2 月の作業を記憶に頼らない
468
- - テスト: `test/holiday-key.test.ts` を追加し、`test/provider.test.ts` に `substituteDays`(同梱の 3 か国との同値・向き・名称・入力の検証)を足した。`test/types.check.ts`・利用者の型チェックに `keys`・既知の `key` の型・`substituteDays` を足した
469
- - サイズの上限(`size-limits.json`)を上げた。`./provider` 4,500 → 6,500(`substituteDays` と入力の検証のため。測定 6,019)、`./diagnose` 32,000 → 33,000(`keys` の判定と診断のため。測定 31,645)(gzip)
499
+ - 監視のワークフロー `data-watch.yml` に内閣府「国民の祝日」CSV の照合を足した(`scripts/verify-cao.ts`。`--report`・`--simulate`)
500
+ - テスト: `test/holiday-key.test.ts` を追加し、`test/provider.test.ts` に `substituteDays`(同梱の 3 か国との同値・向き・名称・入力の検証)を足した
501
+ - サイズの上限(`size-limits.json`)を上げた
470
502
 
471
503
  ## [0.17.1] - 2026-10-25
472
504
 
@@ -476,7 +508,7 @@
476
508
 
477
509
  ### 開発
478
510
 
479
- - `pnpm check`: 英語と日本語のドキュメントの対(README・`docs/guide`・`docs/providers`)の見出しの数とコードブロックの数の一致、互いへのリンク、`docs/*.md` の見出しへのリンク(`#…`)の実在を確かめる(`scripts/check-package.ts`)。コード例の実行(`scripts/check-readme-examples.ts`)も docs のガイドを対象に含めた
511
+ - `pnpm check`: 英語と日本語のドキュメントの対の見出しの数とコードブロックの数の一致、互いへのリンク、`docs/*.md` の見出しへのリンク(`#…`)の実在を確かめる(`scripts/check-package.ts`)
480
512
  - `RELEASING.md`・`docs/decisions.md` の 22・27 番に、ドキュメントの対が増えたことを書いた
481
513
 
482
514
  ## [0.17.0] - 2026-10-25
@@ -502,9 +534,9 @@
502
534
 
503
535
  ### 開発
504
536
 
505
- - 監視のワークフローを `govuk-watch.yml` から `data-watch.yml` に改名し、英国とシンガポールの照合を 1 回の起動で順に行う(issue のラベルは `govuk-data`・`datagovsg-data`。ハートビートは両方が動いたときだけ)。`scripts/verify-datagovsg.ts`(`pnpm verify:datagovsg`。`--file`・`--write`・`--report`・`--simulate`)とフィクスチャ `test/fixtures/datagovsg-public-holidays.json`(既知の差分を含む)を追加した
537
+ - 監視のワークフローを `govuk-watch.yml` から `data-watch.yml` に改名し、英国とシンガポールの照合を 1 回の起動で順に行う。`scripts/verify-datagovsg.ts`(`pnpm verify:datagovsg`。`--file`・`--write`・`--report`・`--simulate`)を追加した
506
538
  - テスト: `test/unconfirmed-holidays.test.ts`・`test/diagnose-as-of.test.ts`・`test/sg-rules.test.ts`・`test/sg-datagovsg.test.ts` を追加し、`smoke.mjs`・CJS・利用者の型チェックにシンガポールと新しい設定を足した
507
- - サイズの上限(`size-limits.json`)を上げ、`./sg` のエントリーを足した。ルート 24,000 → 25,000、`./jp` 27,000 → 28,000、`./uk` 6,700 → 7,500、`./diagnose` 30,500 → 32,000(gzip)。未確定の祝日のガードと診断の基準日のため。`./sg` は 6,000(日付とエラーの共通の実装を含む)
539
+ - サイズの上限(`size-limits.json`)を上げ、`./sg` のエントリーを足した
508
540
 
509
541
  ## [0.16.0] - 2026-10-23
510
542
 
@@ -527,10 +559,10 @@
527
559
 
528
560
  ### 開発
529
561
 
530
- - CI に `bun`・`deno` ジョブを追加した。公開する `dist` を Bun 1.4.3 と Deno 2.9.7(`--unstable-temporal`。本物の Temporal も確かめる)で、`test/compat/runtime.mjs` から `smoke.mjs` を実行して確かめる。どちらも版と SHA-256 を固定した公式のリリースを取得する(workerd と同じ方式)。`smoke.mjs` に `bizdays-toolkit/provider` の確認を足した(Node.js・ブラウザー・workerd・CJS の確認も同じものを呼ぶ)
531
- - `easterSunday` を `src/uk/rules.ts` から `src/core/date.ts` に移した(結果は変わらない。provider のサブパスが英国のデータを引き込まないため)
532
- - 規則の診断の性質のテストの生成器に祝前日を加えた。`test/day-before-holiday.test.ts`・`test/provider.test.ts` を新規に足し、利用者の型チェックに祝前日・`decidedByPath`・provider を足した
533
- - サイズの上限(`size-limits.json`)を上げ、`./provider` のエントリーを足した。ルート 23,000 → 24,000、`./jp` 26,000 → 27,000、`./diagnose` 29,500 → 30,500(gzip)。祝前日の検証・判定・診断と `decidedByPath` のため。`./provider` は 4,500(日付とエラーの共通の実装を含む)
562
+ - CI に `bun`・`deno` ジョブを追加した(Deno は `--unstable-temporal` で本物の Temporal も確かめる)
563
+ - `easterSunday` を `src/uk/rules.ts` から `src/core/date.ts` に移した
564
+ - 規則の診断の性質のテストの生成器に祝前日を加えた
565
+ - サイズの上限(`size-limits.json`)を上げ、`./provider` のエントリーを足した
534
566
 
535
567
  ## [0.15.0] - 2026-10-21
536
568
 
@@ -552,8 +584,8 @@
552
584
 
553
585
  ### 開発
554
586
 
555
- - 性質のテストに、休業日を起点にした `addBusinessDays`(`addBusinessDays(a, n) = addBusinessDays(businessDayOnOrAfter(a), n − 1)`、n ≥ 1)と、営業日を考慮した締め日(複数のカレンダー × 4 つの方法 × 締め日 1〜31・−1 で、空でない期間が敷き詰められ `closingMonth` と往復する)を足した。規則の診断の性質のテストに `weekdays` を加えた
556
- - サイズの上限(`size-limits.json`)を上げた。ルート 22,000 → 23,000、`./jp` 25,000 → 26,000、`./diagnose` 28,500 → 29,500(gzip)。`weekdays` の検証・判定と営業日を考慮した締め日のため
587
+ - 性質のテストに、休業日を起点にした `addBusinessDays` と、営業日を考慮した締め日を足した
588
+ - サイズの上限(`size-limits.json`)を上げた
557
589
 
558
590
  ## [0.14.1] - 2026-10-20
559
591
 
@@ -561,7 +593,7 @@
561
593
 
562
594
  ### 開発
563
595
 
564
- - `createCalendar`・`createSchedule` の作成が 0.13.0 で約 30% 遅くなっていた(CI の `bench` で 1.26 倍。手元では 14.0 → 18.5µs)のを直した。原因は、`createCalendarFromSchedule` のためにスケジュールの内部の判定を `WeakMap` に登録していたこと。`Object.freeze` 済みのオブジェクトに後から印(`WeakMap` のキーのハッシュや `defineProperty` の項目)を付けると、V8 がオブジェクトを遅い形に落とす。内部の判定を Symbol の項目としてオブジェクトリテラルに最初から含める形に変え、作成のコストは 0.12.0 の水準(手元で 14.9µs)に戻った。公開 API・結果は変わらない。Symbol の項目は `Object.keys`・`JSON.stringify` に出ない
596
+ - `createCalendar`・`createSchedule` の作成が 0.13.0 で約 30% 遅くなっていたのを直した
565
597
  - `docs/decisions.md`: 38 番にこの原因と「作ったあとに印を付けず、リテラルに含める」知見を追記した
566
598
 
567
599
  ## [0.14.0] - 2026-10-20
@@ -583,7 +615,7 @@
583
615
 
584
616
  ### 開発
585
617
 
586
- - サイズの上限(`size-limits.json`)を上げた。ルート 20,500 → 22,000、`./jp` 23,500 → 25,000、`./diagnose` 27,000 → 28,500(gzip)。`closingPeriod` と瞬間への変換(ルートで約 1.3KB)のため。0.13.0 で上限に近づいていた分も含めて余裕を持たせた
618
+ - サイズの上限(`size-limits.json`)を上げた
587
619
 
588
620
  ## [0.13.0] - 2026-10-20
589
621
 
@@ -603,9 +635,9 @@
603
635
 
604
636
  ### 開発
605
637
 
606
- - CI に `consumer-types` ジョブを追加した。公開する型定義を、利用者が使う TypeScript 5.0.4・5.5.4・5.8.3・7.0.2(ネイティブ版)のそれぞれで、`moduleResolution` の `node16`・`nodenext`・`bundler` で型チェックする。各版は依存にせず、版と SHA-256 を固定した tgz から一時ディレクトリに入れる(7.0 はランナー向けの実行形式 `@typescript/typescript-linux-x64` も固定)。`pnpm check` は従来どおり開発用の 6.0.3 で確かめる
607
- - `scripts/check-consumer-types.ts` に `--tsc <path>` を足し、わざと型エラーを含む `test/consumer/consumer-error.mts` が各版で失敗として報告されること(検査が機能していること)も確かめるようにした。リポジトリの `@types` を読まないよう `--typeRoots` を空にした(古い TypeScript では `@types/node` の新しい構文を読めないため)。`--ignoreConfig` は 6.0 以降でだけ渡す
608
- - `createCalendar` の `dayInfo` の変換を `createCalendarFromSchedule` と共用の内部関数に切り出した。結果は変わらない
638
+ - CI に `consumer-types` ジョブを追加した
639
+ - `scripts/check-consumer-types.ts` に `--tsc <path>` を足し、わざと型エラーを含む `test/consumer/consumer-error.mts` が各版で失敗として報告されること(検査が機能していること)も確かめるようにした
640
+ - `createCalendar` の `dayInfo` の変換を `createCalendarFromSchedule` と共用の内部関数に切り出した
609
641
 
610
642
  ## [0.12.0] - 2026-10-20
611
643
 
@@ -632,9 +664,9 @@
632
664
 
633
665
  ### 開発
634
666
 
635
- - CI に `bench` ジョブを追加した。公開済みの前の版(npm の `latest`)と今回の `dist` を同じランナーで `scripts/bench.ts` にかけ、`scripts/bench-compare.ts` で比率を比べる。どれかの計測が 2 倍より遅ければ失敗し、絶対値は Job Summary に残す(`pnpm check` には含めない)。`scripts/bench.ts` に `--package <dir>`・`--json <file>` を足した
636
- - サイズの上限(`size-limits.json`)を上げた。ルート 19,500 → 20,500、`./jp` 22,500 → 23,500、`./diagnose` 26,000 → 27,000(gzip)。祝日の規則の検証・判定と `rulePath`(ルートで約 0.5KB)、診断の祝日の規則への対応と候補の改善(約 0.7KB)のため
637
- - 性質のテストに祝日の規則を加えた。規則を取り除いた結果との比較では、位置がずれる `rulePath` を除いて比べる
667
+ - CI に `bench` ジョブを追加した。`scripts/bench.ts` に `--package <dir>`・`--json <file>` を足した
668
+ - サイズの上限(`size-limits.json`)を上げた
669
+ - 性質のテストに祝日の規則を加えた
638
670
  - ライブラリ内のテストとスクリプトで、非推奨にした定数 `confirmedThrough` の代わりに提供元の項目を使うようにした
639
671
 
640
672
  ## [0.11.1] - 2026-10-19
@@ -667,8 +699,8 @@
667
699
 
668
700
  ### 開発
669
701
 
670
- - サイズの上限(`size-limits.json`)を上げた。ルート 17,500 → 19,500、`./jp` 20,500 → 22,500、`./diagnose` 24,000 → 26,000(gzip)。祝日の翌日の規則と `combineCalendars`(ルートで約 1.7KB)と、診断の祝日の翌日への対応(約 1.9KB)のため
671
- - `createCalendar` の営業日の探索・調整・月の営業日の実装を、祝日を調べる機能と 1 日分の判定を引数に取る内部関数(`buildCalendar`)に切り出し、`combineCalendars` と共用した。公開 API と結果は変わらない
702
+ - サイズの上限(`size-limits.json`)を上げた
703
+ - `createCalendar` の営業日の探索・調整・月の営業日の実装を、祝日を調べる機能と 1 日分の判定を引数に取る内部関数(`buildCalendar`)に切り出し、`combineCalendars` と共用した
672
704
  - 性質のテストに祝日の翌日の規則を加えた
673
705
 
674
706
  ## [0.10.0] - 2026-10-19
@@ -696,8 +728,8 @@
696
728
 
697
729
  ### 開発
698
730
 
699
- - サイズの上限(`size-limits.json`)を上げた。ルート 16,500 → 17,500、`./jp` 19,500 → 20,500、`./diagnose` 22,000 → 24,000(gzip)。有効期間と周期の検証・判定(ルートで約 0.8KB)と、診断の走査範囲・包含判定の見直し(約 2.3KB)のため
700
- - 性質のテスト(`test/diagnose-properties.test.ts`)で、有効期間と周期のある規則も作るようにした。固定の走査範囲(2001〜2028 年)の外や、28 年の周期をまたぐ年の日付も比べる
731
+ - サイズの上限(`size-limits.json`)を上げた
732
+ - 性質のテストで、有効期間と周期のある規則も作るようにした
701
733
 
702
734
  ## [0.9.1] - 2026-10-18
703
735
 
@@ -709,7 +741,7 @@
709
741
 
710
742
  ### 開発
711
743
 
712
- - ブラウザーでの確認の Edge の起動オプションに、`--disable-dev-shm-usage` と `--disable-gpu` を足した。CI のランナーで Edge のページの読み込みが止まり、やり直し(`RETRY`)がほぼ毎回起きていたため
744
+ - ブラウザーでの確認の Edge の起動オプションに、`--disable-dev-shm-usage` と `--disable-gpu` を足した
713
745
 
714
746
  ## [0.9.0] - 2026-10-18
715
747
 
@@ -731,11 +763,9 @@
731
763
 
732
764
  ### 開発
733
765
 
734
- - `pnpm check` で、利用者のプロジェクトとして公開する型定義を型チェックするようにした(`scripts/check-consumer-types.ts`・`test/consumer/consumer.mts`。`moduleResolution` を `node16`・`nodenext`・`bundler` に変え、ライブラリの型定義の検査も有効にする)
735
-
736
- - GOV.UK の監視を、外部の cron サービス(cron-job.org)から `workflow_dispatch` で起動する形にした(毎日 06:00 日本時間)。GitHub の schedule は予備として 18:17(日本時間)に移した。GitHub の schedule は高負荷時に遅れたり落ちたりし、追加してから一度も動かなかったため。動いたことは最後に healthchecks.io へ知らせ(Secrets の `HEALTHCHECKS_PING_URL`。照合そのものが失敗したときは `/fail`)、知らせが途絶えたらメールが届くようにした(RELEASING.md の「監視の起動とハートビート」。cron-job.org からの呼び出しは REST API の 2026-03-10 版を指定する)
737
-
738
- - ブラウザーでの確認(`scripts/test-browsers.ts`)に時間制限を設けた。ページの読み込みとスクリプトの実行は 30 秒(WebDriver の `timeouts`)、ドライバーへの各呼び出しは 60 秒。結果を受け取る前の段階(ドライバーの起動・セッションの作成・ページの読み込み・結果の待ち)で止まったときだけ、ドライバーを起動し直して 1 回だけやり直し、その理由を `RETRY` としてログに出す。確認の結果が FAIL のときはやり直さない。CI でランナー上の Edge がページの読み込みで応答しなくなり、既定の 300 秒を待って失敗したため
766
+ - `pnpm check` で、利用者のプロジェクトとして公開する型定義を型チェックするようにした
767
+ - GOV.UK の監視を、外部の cron サービス(cron-job.org)から `workflow_dispatch` で起動する形にした(毎日 06:00 日本時間)
768
+ - ブラウザーでの確認(`scripts/test-browsers.ts`)に時間制限を設けた
739
769
 
740
770
  ## [0.8.1] - 2026-10-18
741
771
 
@@ -748,14 +778,13 @@
748
778
 
749
779
  ### 開発
750
780
 
751
- - 公開する `dist` を ESM(`import`)と CommonJS(`require()`)で確かめるテスト(`test/compat`、`pnpm test:compat`)を追加し、`pnpm check` に含めた。CI に `compat` ジョブを追加し、engines の下限の Node.js 22.12.0 と 26.12.0 でも確かめる(これらの版ではテストの `.ts` と npm 12 が動かないため、ビルドは Node.js 24 で行い、Node.js を切り替えて `dist` だけを確かめる)
752
-
753
- - CI に、公開する `dist` をブラウザーと Cloudflare Workers で確かめるジョブを追加した。`browsers`(Chrome・Firefox・Edge。ランナーのドライバーを WebDriver で操作する `scripts/test-browsers.ts`)・`safari`(macOS)・`workerd`(版と SHA-256 を固定した公式のリリースの workerd で動かす `scripts/test-workerd.ts`)。確認の中身は `test/compat/smoke.mjs` に共通化し、本物の Temporal を備えた環境では Temporal のオブジェクトでも確かめる
754
- - `pnpm check` で、README(英語・日本語)のコード例を実行し、コメントに書いた結果と比べるようにした(`scripts/check-readme-examples.ts`)
755
- - `pnpm check`(`scripts/check-package.ts`)で、`src` が Node.js 固有の機能(`node:` のモジュール・`process`・`Buffer` など)を使っていないことを確かめるようにした
756
- - 自前のスクリプトとテストで Node.js の警告が出たら失敗にするようにした(`scripts/strict-warnings.ts`。`test/compat` は対象外)
757
- - `pnpm check` の最初に、開発用のツールの版を確かめる `scripts/check-toolchain.ts` を追加した(ワークフローどうしの Node.js の版、compat の行列の engines の下限、実行している Node.js・npm・pnpm と固定版の比較。固定版との違いは CI ではエラー、手元では注意の表示)
758
- - GOV.UK の監視のワークフローに、手動実行の入力 `simulate` を追加した。架空の祝日を 1 件足して照合し(`pnpm verify:govuk --simulate`)、ラベル `govuk-data-simulation` の issue で差分の経路を確かめられる
781
+ - 公開する `dist` を ESM(`import`)と CommonJS(`require()`)で確かめるテスト(`pnpm test:compat`)を追加し、`pnpm check` に含めた
782
+ - CI に、公開する `dist` をブラウザーと Cloudflare Workers で確かめるジョブを追加した
783
+ - `pnpm check` で、README(英語・日本語)のコード例を実行し、コメントに書いた結果と比べるようにした
784
+ - `pnpm check`(`scripts/check-package.ts`)で、`src` が Node.js 固有の機能を使っていないことを確かめるようにした
785
+ - 自前のスクリプトとテストで Node.js の警告が出たら失敗にするようにした
786
+ - `pnpm check` の最初に、開発用のツールの版を確かめる `scripts/check-toolchain.ts` を追加した
787
+ - GOV.UK の監視のワークフローに、手動実行の入力 `simulate` を追加した(`pnpm verify:govuk --simulate`)
759
788
  - `pnpm check` のパッケージの中身の検査(`npm pack --dry-run`)を、Windows で Node.js の非推奨の警告(DEP0190)が出ない形で npm を起動するようにした
760
789
 
761
790
  ## [0.8.0] - 2026-10-17
@@ -772,12 +801,12 @@
772
801
 
773
802
  ### 開発
774
803
 
775
- - `bizdays-toolkit/uk` のサイズの上限(gzip 6,700 バイト)を `size-limits.json` に追加した(エントリーの追加。計測は 6,225 バイト)。README の minify + gzip のサイズは、ルートのすべてと国の提供元(`jp`、または英国の 4 つ)を読み込む入口を esbuild で bundle・minify して gzip で測った(ルート 7,394 バイト、日本 8,953 バイト、英国 9,043 バイト)
776
- - GOV.UK の bank holidays を毎日照合するワークフロー(`.github/workflows/govuk-watch.yml`)を追加した。差分があれば `pnpm verify:govuk` の結果と alphagov/frontend の該当ファイルの最新のコミットを本文にした issue(ラベル `govuk-data`)を立て、同じ issue が開いていれば内容が変わったときだけ本文を更新してコメントする。取得に失敗した場合も、監視が機能していないことを issue で知らせる。60 日間動きのないリポジトリで定期実行が止まらないよう、実行のたびにワークフローを有効化し直す。フィクスチャはワークフローでは更新せず、規則の修正と同じコミットで更新する
777
- - CI に、ワークフローを actionlint(1.7.12。版と SHA-256 を固定した公式のリリースを取得)で検査するジョブを追加した。`run:` のシェルスクリプトもランナーの shellcheck で検査する。ワークフローの誤りは `pnpm check` では見つからないため
804
+ - `bizdays-toolkit/uk` のサイズの上限(gzip 6,700 バイト)を `size-limits.json` に追加した(エントリーの追加。計測は 6,225 バイト)
805
+ - GOV.UK の bank holidays を毎日照合するワークフロー(`.github/workflows/govuk-watch.yml`。`pnpm verify:govuk`)を追加した
806
+ - CI に、ワークフローを actionlint で検査するジョブを追加した
778
807
  - CI・リリース・監視のワークフローの Node.js を 24.21.0 から 24.22.0 に、pnpm を 12.11.2 から 12.14.0 に上げた(手元の開発環境に合わせる)
779
808
  - `pnpm check`(`scripts/check-package.ts`)で、`README.md` と `docs/README.ja.md` の見出しの数(段ごと)とコードブロックの数が一致し、互いへの切り替えのリンクがあることを確かめるようにした
780
- - `pnpm check` が、パッケージの中身を `files` の指定からの推定ではなく、実際の `npm pack --dry-run --json` の結果で確かめるようにした(npm が指定にかかわらず含めるファイルを見落とさないため)。ルートに `README.ja.md` があれば失敗する
809
+ - `pnpm check` が、パッケージの中身を `files` の指定からの推定ではなく、実際の `npm pack --dry-run --json` の結果で確かめるようにした
781
810
 
782
811
  ## [0.7.0] - 2026-10-16
783
812
 
@@ -787,7 +816,7 @@
787
816
 
788
817
  ### 開発
789
818
 
790
- - `size-limits.json` の値を上げるときの理由は、コミットメッセージではなく CHANGELOG の「開発」に書く取り決めにした。`pnpm check`(`scripts/check-size.ts`)が前の版のタグの `size-limits.json` と比べ、値が上がっているのに記載がなければ失敗する(0.6.0 で理由をコミットメッセージに書き漏らしたため)。CI とリリースのワークフローは履歴とタグを取得して(`fetch-depth: 0`)この確認を行い、リリースのワークフローではタグを付けたコミットを 1 つ前の版のタグと比べる
819
+ - `size-limits.json` の値を上げるときの理由は、コミットメッセージではなく CHANGELOG の「開発」に書く取り決めにした
791
820
 
792
821
  ## [0.6.0] - 2026-10-16
793
822
 
@@ -805,7 +834,7 @@
805
834
  - `pnpm check`(`scripts/check-package.ts`)で、CHANGELOG の版の節の並び・日付と、末尾のリンク定義が節とそろっていることを確かめるようにした(0.5.0 でリンク定義の更新漏れがあったため)
806
835
  - リリースのワークフローで、CHANGELOG の日付が `YYYY-MM-DD` のまま・見出しがないときの表示を分かりやすくした(止まる条件は変わらない)
807
836
  - 月の計算と日付の調整の性質のテストを追加
808
- - サイズの上限を上げた(`.` 16500・`./jp` 19500・`./diagnose` 22000。月の計算の追加。minify + gzip ではルートが約 7.2KB、日本の祝日込みで約 8.3KB)
837
+ - サイズの上限を上げた
809
838
  - `docs/decisions.md` に 16 番目(日付の調整と月の期日の設計)を追加
810
839
 
811
840
  ## [0.5.0] - 2026-10-16
@@ -824,7 +853,7 @@
824
853
 
825
854
  ### 開発
826
855
 
827
- - 診断の性質のテスト(`test/diagnose-properties.test.ts`): 使われない・取り除いても変わらないと診断した規則を実際に取り除き、結果が変わらないことを乱数の設定で確かめる
856
+ - 診断の性質のテスト: 使われない・取り除いても変わらないと診断した規則を実際に取り除き、結果が変わらないことを乱数の設定で確かめる
828
857
  - サイズの上限に `./diagnose` を追加
829
858
  - `docs/decisions.md` に 15 番目(規則の診断の設計)を追加
830
859
 
@@ -845,7 +874,7 @@
845
874
  ### 開発
846
875
 
847
876
  - 性能の計測(`pnpm bench`、依存なし)を追加
848
- - README に繰り返しの規則の節と、よくある設定の例(国民の休日を営業日として扱う、共通の設定から店舗ごとのカレンダーを作る)を追加。`docs/decisions.md` に 12〜14 番目(判定の順番を固定する理由、「第 n 何曜日」の定義、振替先の定義)を追加
877
+ - README に繰り返しの規則の節と、よくある設定の例を追加
849
878
 
850
879
  ## [0.3.1] - 2026-10-15
851
880
 
@@ -854,7 +883,7 @@
854
883
  ### 開発
855
884
 
856
885
  - lint に oxlint(1.88.0)を導入し、`pnpm check` と CI で実行するようにした(`.oxlintrc.json`)
857
- - 型チェックを強めた(`noUnusedLocals`・`noUnusedParameters`・`noImplicitReturns`・`exactOptionalPropertyTypes`)
886
+ - 型チェックを強めた
858
887
  - oxfmt を 0.73.0 に更新
859
888
  - 改行コードを LF に統一した(`.gitattributes`)
860
889
 
@@ -933,7 +962,8 @@
933
962
 
934
963
  - 日本: 2026 年 2 月の官報(2027 年の春分・秋分の日)まで反映(`dataVersion: "2026-02"`、`confirmedThrough: 2027`)
935
964
 
936
- [Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.8...HEAD
965
+ [Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.9...HEAD
966
+ [0.30.9]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.8...v0.30.9
937
967
  [0.30.8]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.7...v0.30.8
938
968
  [0.30.7]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.6...v0.30.7
939
969
  [0.30.6]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.5...v0.30.6
@@ -74,7 +74,7 @@ export interface CalendarOptions<Kind extends string = string> extends HolidaySo
74
74
  readonly openRecurringRules?: readonly RecurringRule<Kind>[];
75
75
  /** 祝日の扱い(既定: "closed") */
76
76
  readonly holidayPolicy?: HolidayPolicy;
77
- /** 営業日を探すときに調べる最大日数(既定: 3660)。超えたら Error */
77
+ /** 営業日を探すときに調べる最大日数(既定: 3660)。超えたら code: "no-business-day" の RangeError */
78
78
  readonly searchDayLimit?: number;
79
79
  /** @deprecated 0.30.0 で closedAnnualDates に改名した。1.0.0 で削除する */
80
80
  readonly closedAnnual?: readonly (AnnualDate | AnnualRange)[];
@@ -148,7 +148,7 @@ export interface CombineCalendarsOptions {
148
148
  * "any": いずれかのカレンダーが営業日(例: 複数の店舗のどこかが開いている日)
149
149
  */
150
150
  readonly open: "all" | "any";
151
- /** 営業日を探すときに調べる最大日数(既定: 3660)。超えたら Error */
151
+ /** 営業日を探すときに調べる最大日数(既定: 3660)。超えたら code: "no-business-day" の RangeError */
152
152
  readonly searchDayLimit?: number;
153
153
  /** @deprecated 0.30.0 で searchDayLimit に改名した。1.0.0 で削除する */
154
154
  readonly maxSearchDays?: number;
@@ -270,6 +270,8 @@ export interface Calendar<Kind extends string = string> extends HolidayLookup<Ki
270
270
  readonly to: DateString;
271
271
  };
272
272
  }
273
+ /** @internal 営業日カレンダーの設定の項目 */
274
+ export declare const CALENDAR_OPTION_KEYS: string[];
273
275
  interface CompiledCalendar<Kind extends string> {
274
276
  readonly schedule: CompiledSchedule<boolean, Kind>;
275
277
  readonly searchDayLimit: number;
@@ -303,13 +305,14 @@ export declare function combineCalendars<Kind extends string = string>(calendars
303
305
  * @public
304
306
  */
305
307
  export interface CalendarFromScheduleOptions {
306
- /** 営業日を探すときに調べる最大日数(既定: 3660)。超えたら Error */
308
+ /** 営業日を探すときに調べる最大日数(既定: 3660)。超えたら code: "no-business-day" の RangeError */
307
309
  readonly searchDayLimit?: number;
308
310
  /** @deprecated 0.30.0 で searchDayLimit に改名した。1.0.0 で削除する */
309
311
  readonly maxSearchDays?: number;
310
312
  }
311
313
  /**
312
- * スケジュール(createSchedule)から営業日カレンダーを作る。isOpen が true を返す値の日を営業日とする。
314
+ * スケジュール(createSchedule)から営業日カレンダーを作る。isOpen が true を返す値の日を営業日とする
315
+ * (true だけを営業日とし、1 や "open" のような boolean でない値を返した日は休業日になる)。
313
316
  * 営業時間表のような日ごとの値が設定の正本で、営業日の計算(加減算・調整・期日など)も同じ設定から行いたいときに使う
314
317
  * (営業日カレンダーを別に書いて同期を取る必要がなくなる)。
315
318
  *
@@ -1,10 +1,10 @@
1
1
  import { addDays, lengthOfMonth, formatDate, fromDayNumber, toDayNumber, } from "./date.js";
2
- import { checkUnknownKeys, IssueCollector, plainError, rangeError } from "./errors.js";
2
+ import { checkUnknownKeys, IssueCollector, plainError, rangeError, withoutUndefined, } from "./errors.js";
3
3
  import { renameKeys, writtenKey } from "./renamed.js";
4
4
  import { parseTimeOfDay, toCivil } from "./input.js";
5
5
  import { checkClosingDay, closingDayIn, closingMonth as calendarClosingMonth, dayOfMonth, formatMonth, isDayOfMonthValue, parseMonth, shiftMonth, } from "./month.js";
6
6
  import { buildSchedule, compileAnnualRules, compileDateRules, compileHolidaySource, compileRecurringRules, createHolidayLookup, infoOfSchedule, isWeekday, mapDays, RECURRING_RULE_KEYS, jpUsage, } from "./schedule.js";
7
- const CALENDAR_OPTION_KEYS = [
7
+ export const CALENDAR_OPTION_KEYS = [
8
8
  "holidayProvider",
9
9
  "timeZone",
10
10
  "outOfRangePolicy",
@@ -25,8 +25,9 @@ export function compileCalendarOptions(c, options) {
25
25
  }
26
26
  const written = options;
27
27
  const places = ["source", "calendar"];
28
- const o = renameKeys(c, places, "", written);
29
- checkUnknownKeys(c, "", o, CALENDAR_OPTION_KEYS);
28
+ const renamed = renameKeys(c, places, "", written);
29
+ checkUnknownKeys(c, "", renamed, CALENDAR_OPTION_KEYS);
30
+ const o = withoutUndefined(renamed);
30
31
  const source = compileHolidaySource(c, o);
31
32
  const closedWeekdays = new Set();
32
33
  const rawWeekdays = o["closedWeekdays"];
@@ -302,7 +303,9 @@ function buildCalendar(lookup, isOpen, info, searchDayLimit) {
302
303
  return Object.freeze({ from, to });
303
304
  },
304
305
  dueDate(month, options) {
305
- const o = isPlainObject(options) ? renameKeys("throw", ["dueDate"], "", options) : undefined;
306
+ const o = isPlainObject(options)
307
+ ? withoutUndefined(renameKeys("throw", ["dueDate"], "", options))
308
+ : undefined;
306
309
  const day = o?.["dayOfMonth"];
307
310
  if (!isDayOfMonthValue(day)) {
308
311
  throw rangeError("invalid-argument", `dayOfMonth must be an integer from 1 to 31, or -1 (last day): ${String(day)}`);
@@ -333,7 +336,7 @@ export function combineCalendars(calendars, options) {
333
336
  }
334
337
  });
335
338
  const o = isPlainObject(options)
336
- ? renameKeys("throw", ["combine"], "", options)
339
+ ? withoutUndefined(renameKeys("throw", ["combine"], "", options))
337
340
  : {};
338
341
  const mode = o["open"];
339
342
  if (mode !== "all" && mode !== "any") {
@@ -360,9 +363,10 @@ export function combineCalendars(calendars, options) {
360
363
  ? "throw"
361
364
  : "accept",
362
365
  });
363
- const isOpen = (date) => mode === "all"
364
- ? calendars.every((c) => c.isBusinessDay(date))
365
- : calendars.some((c) => c.isBusinessDay(date));
366
+ const isOpen = (date) => {
367
+ const results = calendars.map((c) => c.isBusinessDay(date));
368
+ return mode === "all" ? results.every(Boolean) : results.some(Boolean);
369
+ };
366
370
  function info(date) {
367
371
  const results = calendars.map((c) => c.dayInfoOn(date));
368
372
  const open = mode === "all" ? results.every((r) => r.open) : results.some((r) => r.open);
@@ -399,7 +403,7 @@ export function createCalendarFromSchedule(schedule, isOpen, options) {
399
403
  throw rangeError("invalid-argument", "isOpen must be a function (value) => boolean");
400
404
  }
401
405
  const o = isPlainObject(options)
402
- ? renameKeys("throw", ["fromSchedule"], "", options)
406
+ ? withoutUndefined(renameKeys("throw", ["fromSchedule"], "", options))
403
407
  : {};
404
408
  const searchDayLimit = (o["searchDayLimit"] ?? 3660);
405
409
  if (!Number.isInteger(searchDayLimit) || searchDayLimit < 1) {
@@ -88,6 +88,14 @@ export declare class IssueCollector {
88
88
  /** 最初の誤りを例外にして投げる(誤りがなければ何もしない) */
89
89
  throwFirstError(): void;
90
90
  }
91
+ /**
92
+ * @internal 値が undefined の項目を除いた複製(なければ元のオブジェクト)。設定の明示的な undefined は省略と同じ
93
+ * (decisions.md の 6 番)。知らないキーの検査(checkUnknownKeys)は除く前のオブジェクトに対して行う。
94
+ * スケジュールの value は undefined も値として持てるので除かない
95
+ */
96
+ export declare function withoutUndefined(value: Record<string, unknown>,
97
+ /** 除く項目を限るとき、その項目 */
98
+ keys?: readonly string[]): Record<string, unknown>;
91
99
  /**
92
100
  * @internal 設定のオブジェクトに、知らないキーがあれば警告として記録する。
93
101
  * 近い既知のキーを候補に挙げるのは規則の診断で行う(作成時は警告を使わないので、ここでは既知のキーを渡すだけ)
@@ -44,6 +44,15 @@ export class IssueCollector {
44
44
  throw rangeError(first.code, message);
45
45
  }
46
46
  }
47
+ export function withoutUndefined(value, keys) {
48
+ const out = { ...value };
49
+ for (const key of Object.keys(value)) {
50
+ const limited = keys !== undefined && !keys.includes(key);
51
+ if (value[key] === undefined && key !== "value" && !limited)
52
+ delete out[key];
53
+ }
54
+ return out;
55
+ }
47
56
  export function checkUnknownKeys(collector, path, value, known) {
48
57
  for (const key of Object.keys(value)) {
49
58
  if (!known.includes(key)) {
@@ -39,12 +39,14 @@ export function renameKeys(report, places, writtenPath, value) {
39
39
  if (!places.includes(r.place) || !Object.hasOwn(value, r.from))
40
40
  continue;
41
41
  const at = join(writtenPath, r.from);
42
- if (Object.hasOwn(value, r.to)) {
42
+ const old = value[r.from];
43
+ if (old !== undefined && value[r.to] !== undefined) {
43
44
  conflict(report, at, r.from, r.to);
44
45
  delete out[r.from];
45
46
  continue;
46
47
  }
47
- out[r.to] = value[r.from];
48
+ if (old !== undefined)
49
+ out[r.to] = old;
48
50
  delete out[r.from];
49
51
  if (report !== "throw")
50
52
  report.warning("deprecated-option", at, `${JSON.stringify(r.from)} was renamed to ${JSON.stringify(r.to)} in ${VERSION}`);
@@ -52,7 +54,7 @@ export function renameKeys(report, places, writtenPath, value) {
52
54
  return out;
53
55
  }
54
56
  export function writtenKey(places, value, key) {
55
- const r = RENAMED_KEYS.find((x) => places.includes(x.place) && x.to === key && Object.hasOwn(value, x.from));
57
+ const r = RENAMED_KEYS.find((x) => places.includes(x.place) && x.to === key && value[x.from] !== undefined);
56
58
  return r ? r.from : key;
57
59
  }
58
60
  export function renameValue(report, place, key, writtenPath, value) {
@@ -731,9 +731,11 @@ export interface CompiledSchedule<Value, Kind extends string> {
731
731
  readonly dates: readonly DateRule<Value>[];
732
732
  readonly recurring: readonly RecurringRuleCompiled<Value>[];
733
733
  }
734
- /** @internal 繰り返しの規則の項目 */
734
+ /** @internal スケジュールの設定の項目 */
735
+ export declare const SCHEDULE_OPTION_KEYS: string[];
735
736
  /** @internal 有効期間の項目 */
736
737
  export declare const PERIOD_KEYS: string[];
738
+ /** @internal 繰り返しの規則の項目 */
737
739
  export declare const RECURRING_RULE_KEYS: string[];
738
740
  /** @internal スケジュールの設定を検証して取り込む(誤りは c に集める) */
739
741
  export declare function compileScheduleOptions<Value, Kind extends string>(c: IssueCollector, options: unknown): CompiledSchedule<Value, Kind> | undefined;
@@ -1,5 +1,5 @@
1
1
  import { addDays, lengthOfMonth, formatDate, fromDayNumber, isValidDate, parseDate, toDayNumber, weekdayOf, } from "./date.js";
2
- import { checkUnknownKeys, IssueCollector, rangeError } from "./errors.js";
2
+ import { checkUnknownKeys, IssueCollector, rangeError, withoutUndefined, } from "./errors.js";
3
3
  import { RENAMED_VALUES, renameKeys, renameValue, writtenKey } from "./renamed.js";
4
4
  import { instantToCivil, toCivil, toDateTimeParts, toInstant, validateTimeZone, } from "./input.js";
5
5
  import { HOLIDAY_KEY_PATTERN } from "./types.js";
@@ -80,18 +80,19 @@ export function compileDateRules(c, path, entries, valueOf, allowString, valueKe
80
80
  }
81
81
  const value = valueOf(entry, p);
82
82
  const name = checkName(c, p, entry["name"]);
83
- if ("date" in entry) {
84
- checkUnknownKeys(c, p, entry, ["date", "name", ...(valueKey ? ["value"] : [])]);
83
+ const defined = withoutUndefined(entry, DATE_SHAPE_KEYS);
84
+ if ("date" in defined) {
85
+ checkUnknownKeys(c, p, defined, ["date", "name", ...(valueKey ? ["value"] : [])]);
85
86
  const n = checkDate(c, `${p}.date`, entry["date"]);
86
87
  if (n !== undefined && value !== undefined)
87
88
  rules.push({ path: p, from: n, to: n, value, name });
88
89
  return;
89
90
  }
90
- if (!("from" in entry) || !("to" in entry)) {
91
+ if (!("from" in defined) || !("to" in defined)) {
91
92
  c.error("invalid-option", p, 'must have "date" or both "from" and "to"');
92
93
  return;
93
94
  }
94
- checkUnknownKeys(c, p, entry, ["from", "to", "name", ...(valueKey ? ["value"] : [])]);
95
+ checkUnknownKeys(c, p, defined, ["from", "to", "name", ...(valueKey ? ["value"] : [])]);
95
96
  const from = checkDate(c, `${p}.from`, entry["from"]);
96
97
  const to = checkDate(c, `${p}.to`, entry["to"]);
97
98
  if (from === undefined || to === undefined)
@@ -123,8 +124,9 @@ export function compileAnnualRules(c, path, entries, valueOf, allowString, value
123
124
  const value = valueOf(entry, p);
124
125
  const name = checkName(c, p, entry["name"]);
125
126
  const period = checkPeriod(c, p, entry);
126
- if ("date" in entry) {
127
- checkUnknownKeys(c, p, entry, [
127
+ const defined = withoutUndefined(entry, DATE_SHAPE_KEYS);
128
+ if ("date" in defined) {
129
+ checkUnknownKeys(c, p, defined, [
128
130
  "date",
129
131
  "name",
130
132
  ...(valueKey ? ["value"] : []),
@@ -136,11 +138,11 @@ export function compileAnnualRules(c, path, entries, valueOf, allowString, value
136
138
  }
137
139
  return;
138
140
  }
139
- if (!("from" in entry) || !("to" in entry)) {
141
+ if (!("from" in defined) || !("to" in defined)) {
140
142
  c.error("invalid-option", p, 'must have "date" or both "from" and "to"');
141
143
  return;
142
144
  }
143
- checkUnknownKeys(c, p, entry, [
145
+ checkUnknownKeys(c, p, defined, [
144
146
  "from",
145
147
  "to",
146
148
  "name",
@@ -208,9 +210,10 @@ export function compileRecurringRules(c, path, entries, valueOf, keys, context,
208
210
  return;
209
211
  }
210
212
  const written = `${writtenPath}[${i}]`;
211
- const entry = renameKeys(c, ["rule"], written, rawEntry);
213
+ const renamedEntry = renameKeys(c, ["rule"], written, rawEntry);
214
+ checkUnknownKeys(c, p, renamedEntry, keys);
215
+ const entry = withoutUndefined(renamedEntry);
212
216
  const nationalOfJp = jp !== "none" && reportNational(c, `${written}.kinds`, entry["kinds"], jp === "mixed");
213
- checkUnknownKeys(c, p, entry, keys);
214
217
  const value = valueOf(entry, p);
215
218
  const name = checkName(c, p, entry["name"]);
216
219
  const hasWeekday = "weekday" in entry;
@@ -892,7 +895,7 @@ export function createHolidayLookup(source) {
892
895
  },
893
896
  };
894
897
  }
895
- const SCHEDULE_OPTION_KEYS = [
898
+ export const SCHEDULE_OPTION_KEYS = [
896
899
  "holidayProvider",
897
900
  "timeZone",
898
901
  "outOfRangePolicy",
@@ -903,6 +906,7 @@ const SCHEDULE_OPTION_KEYS = [
903
906
  "dates",
904
907
  "recurringRules",
905
908
  ];
909
+ const DATE_SHAPE_KEYS = ["date", "from", "to"];
906
910
  export const PERIOD_KEYS = ["effectiveFrom", "effectiveTo"];
907
911
  export const RECURRING_RULE_KEYS = [
908
912
  "weekday",
@@ -934,8 +938,9 @@ export function compileScheduleOptions(c, options) {
934
938
  return undefined;
935
939
  }
936
940
  const written = options;
937
- const o = renameKeys(c, ["source", "schedule"], "", written);
938
- checkUnknownKeys(c, "", o, SCHEDULE_OPTION_KEYS);
941
+ const renamed = renameKeys(c, ["source", "schedule"], "", written);
942
+ checkUnknownKeys(c, "", renamed, SCHEDULE_OPTION_KEYS);
943
+ const o = withoutUndefined(renamed);
939
944
  const source = compileHolidaySource(c, o);
940
945
  const weeklyRaw = o["weekdayValues"];
941
946
  let weekly = [];
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bizdays-toolkit",
3
- "version": "0.30.8",
3
+ "version": "0.30.9",
4
4
  "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; UK bank holidays (England, Wales, Scotland, Northern Ireland) verified against GOV.UK and The Gazette; French public holidays (metropole, Alsace-Moselle) verified against data.gouv.fr; Singapore public holidays verified against data.gov.sg. / 祝日と営業日のカレンダー(タイムゾーン対応・日本の祝日は内閣府、英国の bank holidays は GOV.UK と The Gazette、フランスの祝日は data.gouv.fr、シンガポールの祝日は data.gov.sg のデータで全日照合)",
5
5
  "keywords": [
6
6
  "bank-holidays",