bizdays-toolkit 0.30.7 → 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,82 @@
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
+
40
+ ## [0.30.8] - 2026-11-06
41
+
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`。「開発」)の分だけで、カレンダー・スケジュール・提供元の判定の結果は変わらないので、利用者の作業は要りません。
43
+
44
+ ### Fixed
45
+
46
+ - 診断: 第 n 営業日の規則(`businessDayOfMonth`・`businessDayOfWeek`)の `counting-basis` を、同じ設定の最初の毎週の曜日の規則だけを見て出していた。有効期間が重ならない曜日の規則(例: `{ weekday: 3, effectiveTo: "2026-12-31" }` と `{ businessDayOfMonth: 1, effectiveFrom: "2027-01-01" }`)や、対応年の外で決して使われない曜日の規則(例: 既定の `outOfRangePolicy: "throw"` で `{ weekday: 3, effectiveTo: "1950-12-31" }`。`out-of-range` だけが出る)を理由にも出し、曜日の規則が 2 つ以上あっても最初の 1 つしか `relatedPath` に出さなかった。有効期間が重なり、使われている曜日の規則ごとに 1 件出すようにした。減る形: 上の 2 つの例(どちらも `counting-basis` が出なくなる。`outOfRangePolicy: "ignore"` では 1950 年の数え方に影響するので、2 つ目の例でも出す)と、第 n 営業日の規則より後ろにある曜日の規則が `shadowed`・`never-matches` のとき(判定の順番で、使われないと分かる前に見ていた。例: `[{ businessDayOfMonth: 1 }, { weekday: 3 }, { weekday: 3 }]` は 2 件ではなく 1 件)。増える形: `{ weekday: 3 }`・`{ weekday: 6 }`・`{ businessDayOfMonth: 1 }` のように曜日の規則が 2 つ(2 件)、開く規則 `{ weekday: 6 }` と閉じる規則 `{ weekday: 3 }` に 1 つずつ(2 件。0.30.7 までは開く規則の 1 件だけ)。誤った診断を直す修正で、判定の結果は変わらない(オラクルは `counting-basis` を「出たら前提があるか」の一方向だけで、有効期間を見ずに確かめていたので見つけなかった。逆向きと件数も確かめるようにした。種類は正解と突き合わせる仕組みの不足)
47
+ - 診断: カレンダーの個別の日付・毎年の月日(`closedDates`・`openDates`・`closedAnnualDates`)の要素に書いた `value`(スケジュールの書き方の流用)を、黙って通していた。作成時は今までどおり無視し、診断で `unknown-option`(`path` は `closedDates[0].value` の形)を出す(打ち間違いは診断で見つかるという 8 番の約束のとおりにする。スケジュールの `dates`・`annualDates` の `value` は今までどおり既知のキー)
48
+ - `bizdays-toolkit/provider` の `withSubstituteDays`: 入力のまま返す祝日を凍結していなかった(振替日だけ凍結していた。4 番の「返すものはすべて凍結」から外れていた)。契約の項目だけを持つ凍結した複製にした。返す配列の凍結と戻り値の型の `readonly` は、`push` していたコードや可変の配列の型に代入しているコードが通らなくなるので、パッチではなく 0.31.0 で行う(RELEASING.md の区分)
49
+ - `no-business-day` の例外のクラスが経路で違っていた(探索と第 n 営業日は `Error`、`closingPeriod` は `RangeError`)。どれも `RangeError` にした。`RangeError` は `Error` でもあるので、`instanceof Error` で受けていたコードはそのまま通り、`instanceof RangeError` で受けていたコードは新たに捕まる(広がる向き)
50
+ - 文書を直した(コードの挙動は変わらない):
51
+ - ガイド(英日)の「設定の診断」の `redundant` の説明: 「毎年の月日と繰り返しの規則は個別の日付を除いた設定で調べる」と無条件に書いていた。0.30.3 から、自分の設定を基準に第 n 営業日を数える規則があれば、個別の日付は数え方を変えるので残し、毎年の月日は取り除いて変わりうる月・週の日をすべて調べる(0.30.3 の Fixed のとおり。例は `test/diagnose.test.ts` の「第 n 営業日の規則があると、数え方を変える個別の日付・毎年の月日は redundant にしない」)
52
+ - ガイド(英日)の診断の表の `counting-basis` の行と `src/core/diagnose.ts` の冒頭のコメント: `businessDayOfMonth` の規則だけを書いていたが、週の第 n 営業日の規則(`businessDayOfWeek`)でも出る。`{ businessDayOfWeek: -1, weekStart: 1 }` と `{ weekday: 0 }` の設定の単体テストを `test/counting-basis.test.ts` に足した
53
+ - ガイド(英日)の「未確定の祝日」: 「`holidaysInYear`・`holidaysBetween` は投げない」を、未確定の祝日では投げない、に限った(対応年の外の `out-of-range` と、提供元のデータの誤りの `invalid-provider-data` は投げる)
54
+ - ガイド(英日)と `BusinessDayOnOrAfterOptions.cutoff` の TSDoc: `cutoff` が `"HH:mm"` だけを受け付ける理由(入力の時刻は分の精度で比べるので、秒を持つ締め時刻は入力の秒と比べられない)を書いた。秒の受け付けは 0.31.0 で扱う
55
+
56
+ ### 開発
57
+
58
+ - 診断のオラクル: `counting-basis` の確かめを、第 n 営業日の規則と毎週の曜日の規則の有効期間が重なる組を前提にし、前提があるのに出ないとき・出た件数が組の数と違うときも失敗にした
59
+ - 前の版との比較: 特徴 `counting-rule-with-period-weekly-rule`(`etc/result-changes.json` で `counting-basis` が消える差分を許す)と `calendar-date-with-value`(増える向きなので許可は足さない)を足し、固定の設定 4 つを足した
60
+ - 決定の文書: 3 番に「同じ `code` は同じクラスで投げる」を足した
61
+ - `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` と対象を一覧に出すようにした(意図しない差分が出たときに、許した側と見比べるため)
72
+ - `src/core/input.ts`: `Date.parse` にオフセット付きの文字列だけを渡している理由をコメントに書いた
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 の検査: 文字列の中身を先に空にしてから `//` のコメントを除くようにした
80
+
7
81
  ## [0.30.7] - 2026-11-05
8
82
 
9
83
  テスト拡充案の第 3 段です。0.30.6 の取り込みで持ち越した項目を片付け、そこで見つけた診断の不具合を 2 つ直したので、公開物の `.js` は 0.30.6 から変わります(Fixed。変わるのは `./diagnose` だけで、カレンダー・スケジュールの判定の結果は変わりません)。テストと道具では、変形しても結果が同じことの検査、文書の例と文章の主張の検査、オラクルの完全性を失敗にする切り替えを入れ、設定の結果の差分の旧名の比較の穴を直しました。設定の結果の差分の定期実行(テスト拡充案の T8)は入れず、手動の広い比較として入れました。自前の変異テスト(T9)は、0.31.0 の診断の作り直しの前に行います。
@@ -15,27 +89,27 @@
15
89
 
16
90
  ### 開発
17
91
 
18
- - サイズ(gzip): `./diagnose` 26,158 → 26,218(測定 26,218。上の Fixed の 2 件の 27 バイトと、規則どうしの診断が調べる期間を求める部分を関数 `rulesScanWindow` に切り出して内部で書き出した 33 バイト)。上限は変えていない。ルート 18,123(測定 18,123)は変わらない
19
- - 判定できない月の診断のテスト(`test/diagnose-unjudgeable.test.ts`)を足した。上の Fixed の例(旧名のキーで書いた形と、週の規則の次の月・前の月の 2 例を含む)、基準のカレンダーを持つ規則の `never-matches`・`redundant` は有効期間に判定できない月があれば出さず、有効期間がすべて対応年の中なら出すこと、月の第 n 営業日の規則は前後の月を記録しないことを確かめる。規則の中のオプションの位置の診断(今はカレンダーにだけ出る)と、`recurringRules[1]` と `recurringRules[11]` が混ざる位置の引き方は、`dropUnsure`(`@internal`)を直接呼んで確かめる
20
- - API どうしの整合の検査(`test/consistency.test.ts`)の直し: 作成を試す関数は、bizdays のエラーコードを持つ例外だけを「作成できない」とみなし、ほかの例外は投げ直す。整合 4 は、n 番目の営業日がないときの `no-business-day` だけを受け止め、営業日が n 日に満たない月がある固定の設定も試す(目録の設定では、その経路を全件でも一度も通っていなかった)。整合 5 は、今までの試行に加えて、目録が意図して入力の誤りにした規則を含む設定を別の種で作り(作れなければ失敗)、その設定が作成できないことも確かめる(抜き出しで 24 件・全件で 300 件。今までの試行の「作成できた」23 件・「作成できない」1 件は変わらない)。件数の行は、数えたものの名前で出す(never-matches・redundant の関係は「診断の項目」)。テストの名前から版の経緯を消した(黙って外れる穴。種類 C)
21
- - `scripts/result-compare.ts`: スケジュールの第 n 営業日の規則の基準のカレンダーに、スケジュールの設定の `outOfRangePolicy` を受け継がせた。意図した差分の特徴 `schedule-counting-basis-narrower-than-scan` は、基準のカレンダーが `"ignore"`(対応年の外で投げない)なら付けない。特徴を付ける関数を `test/support/result-cases.ts` に移し、単体テスト(`test/result-traits.test.ts`)で確かめる(今の種で作る設定は `outOfRangePolicy` を持たないので、比べる設定と結果は変わらない)
22
- - `scripts/tool-selftest.ts`: 表のセルの `|` を `\|` にし、写しの途中で例外が出ても、そこまでに写したファイルを表の後に出し、`Error` でない値の例外も文にする。部品を `scripts/tool-selftest-parts.ts` に切り出し、単体テスト(`test/tool-selftest-parts.test.ts`)で確かめる。対照の SKIP の判定の 2 つ目の形を見る理由をコメントに書いた
23
- - 飛ばしの決まり(`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`): 事前の確認で届かなくなった枝を消した
24
98
  - ガイド(英日)の「対応年の外」: スケジュールの第 n 営業日の規則の文を独立させ、「結果が分からない年の祝日に依存するため」の理由とシンガポールの例が、隣の日を見る規則と週の第 n 営業日の規則の説明として読めるようにした
25
- - 変形しても結果が同じ(テスト拡充案の 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 件なら失敗にする
26
- - 文書の例の検査(`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 の付け替えが外れたとき、黙って通らないため)
27
- - ガイド(英日)の「カレンダーの合成」に、2 つ以上の別々のカレンダーを渡すこと(1 つだけ、または同じカレンダーを 2 度渡すと `invalid-argument`)を書き足した(コードにだけあった決まり)
99
+ - 変形しても結果が同じ: 文書で同じ意味だと約束している書き換えで、全日の結果と、位置を読み替えた診断が変わらないことを、目録の設定で確かめる
100
+ - 文書の例の検査を厳しくした(テスト拡充案の T6): 例で `createCalendar`・`createSchedule` に渡した設定を自動で診断にもかけ、`error`・`warning` があれば失敗にする
101
+ - ガイド(英日)の「カレンダーの合成」に、2 つ以上の別々のカレンダーを渡すことを書き足した(コードにだけあった決まり)
28
102
  - `SECURITY.md` の Supply chain と Supported versions を英日の併記にそろえ、依存ゼロ(`dependencies` を持たない)と、provenance が付く版を 0.1.0 以降と正確に書いた
29
- - 文章の主張の検査(テスト拡充案の 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 つを足した
30
- - テスト拡充案の 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 とともに写す)
31
- - 設定の結果の差分(`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 までと同じ)
32
- - 目録の生成器(`test/support/catalog.ts`)が、スケジュールの個別の日付の半分ほどを期間(`dates` の `{ from, to }`)にする。期間にするかと長さは、日付から決める別の乱数で選び、呼び出し側の乱数の流れは変えない(変えると、ほかのテストが試す設定がすべて変わるため。改名の前の版との比較では作らない)。乱数のテストが、スケジュールの期間の形を一度も試していなかった穴をふさぐ(ZIP-B の記録の持ち越し)
33
- - 診断のオラクル(`test/diagnose-oracle.test.ts`)の完全性(取り除いても結果が変わらないのに診断が何も言わない項目)を、報告から失敗に切り替えた。対応年(2025〜2027 年)だけで「取り除ける」と判定していたので、有効期間が対応年の外に続く規則を、診断はその外まで調べて取り除けないと正しく判定していたのに、報告に出ていた(報告されていた 1 件と、報告の仕組みの見張りのカナリアの 2 件とも、この形で、診断の取りこぼしではなかった。カナリアの説明の理由も実際と違っていた)。対応年で取り除けた項目は、診断が規則どうしを調べる期間でも確かめ直してから数え(期間は、診断の中で組み立てていた部分を関数 `rulesScanWindow` に切り出し、診断とオラクルが同じ関数で求める。`@internal`)、確かめ直して数えなかった件数と時間を出す。既知の項目の一覧(`KNOWN_INCOMPLETE`)は空で、一覧にない項目が出たら失敗、一覧の項目が出なくなっても失敗にする。カナリアは、診断の結果を空にして渡し、本当に取り除ける項目を数えることと、走査の範囲で取り除けない項目を数えないことを確かめる見張りのテストに替えた
34
- - 設定の結果の差分(`scripts/result-compare.ts`)の穴を直した: `latest` との比較の旧名の回が、旧名に書き換わっていなかった(旧名の表を、改名の前の版との比較でだけ読み込んでいたため。result-compare を入れた 0.30.2 から)。旧名の回は、新しい名前の回とほぼ同じ設定を比べ、基準のカレンダーを持つスケジュールは両方の版で `invalid-option` になって、誤りが同じなので差分にならず、結果も診断も比べていなかった。旧名の表をいつも読み込み、旧名に書き換わらなかった設定と、意図した入力の誤りでないのに作成に失敗した設定(名前の書き方ごと。前の版でも失敗した設定の数も出す)を失敗にする(合成の相手のカレンダーも本体と同じに数える)。旧名の表が空なら、読み込みの誤り(終了コード 2)とする。あわせて、スケジュールの基準のカレンダーを、いつも定休日なし(土日も営業日)で作っていた穴を直した(説明には「土日休みのカレンダー」とあった)。基準のカレンダーの定休日は、設定の id から決める別の乱数で選ぶ(書かない・土日・曜日の部分集合。実際の利用で多い土日を多めにする)。生成範囲の検査は、基準のカレンダーの定休日を特徴として別に数える(記録にない特徴なので見張りはしない。定休日を渡すことと、選び方が 3 つの形を出すことは、単体テスト(`test/result-traits.test.ts`)で確かめる)
35
- - 設定の結果の差分の意図した差分(`etc/result-changes.json`)に、上の Fixed の 2 件目の項目(`schedule-week-counting-basis-narrower-than-scan`。0.30.6 が出していた誤った `never-matches`・`redundant` を出さなくなった差分)を足した(結果を変える修正に特徴と項目を足す決まりの、0.30.7 の作業の途中での漏れ)
36
- - `RELEASING.md` の監視の節: GitHub の失敗の知らせの届き先(文書「Notifications for workflow runs」)と、有効にし直すステップの影響を、事実に合わせて書いた。監視のワークフローを改修したときの確かめ方(偽の `gh`・`curl` を与えて、`run:` のシェルを経路ごとに手元で動かす)を足した。`data-watch.yml` の失敗のステップは、照合ごとの終了コードで、差分(「… differ from the bundled data」)と照合そのものの失敗(「… could not be checked」)を書き分ける(取得・解析の失敗でも「differ」と出ていた)
37
- - 飛ばしの決まりの検査(`test/skip-policy.test.ts`): 省略記法(`{ skip }`・`{ todo }`)と、分割代入(`const { skip } = …`)、`skip`・`todo` の import・export(別名を含む)と変数・引数の宣言を、TypeScript のコンパイラーの API で読み、行に分けて書いても拾う(前の行の grep が拾っていた形をすべて含む)
38
- - `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)の行を今の検査に合わせた
39
113
 
40
114
  ## [0.30.6] - 2026-11-02
41
115
 
@@ -53,21 +127,21 @@
53
127
 
54
128
  ### 開発
55
129
 
56
- - サイズの上限: 上限を 25,800 から 26,500 に上げた `./diagnose`(測定 26,158)。理由: Fixed の 3 件目(基準のカレンダーが投げる月を判定できない月として扱い、確かでない診断を出さない)の修正で増えたため。0.31.0 の P1 の分は見込まず、そのときにあらためて測って上げる
57
- - 診断のオラクル: カナリア(完全性の報告に必ず出る設定)が取り除ける理由を確かめた。開く規則「5・7 月の月曜」が開きうる祝日(自作の提供元の 5・7 月の月曜の祝日)を、`holidayOverlapPolicy` の既定(`"under-holiday"`)では開かないため。`"over-holiday"` にすると取り除けなくなることを確かめるテストを足し、コメントの理由を直した(コメントの主張を確かめていなかった穴。種類 C)
58
- - 診断のオラクル: `ORACLE_FULL` なしの `ORACLE_SHARD` を例外にした(`pnpm check` の抜き出しの間隔 111 と分ける数の公約数で、分が 0 件になっていた)。どのテストも、試した設定が 0 件なら失敗にする。失敗のメッセージを 1 つの関数にまとめ、設定を作り直せる情報(項目・休業日の扱いの方針・定休日・取り除いた項目)を入れた(黙って空振りする穴。種類 C)
59
- - 生成範囲: 危険の分かっている組み合わせ(第 n 営業日(月・週)× 個別の日付、第 n 営業日(月)× 毎年の月日、祝日の規則 × 臨時営業日、祝日の翌日・前日 × `skipWeekdays` × 個別の日付、和集合の提供元 × `kinds`)の一覧(`test/support/combinations.ts`)を作り、呼び出し側ごとに 1 回以上作ることを確かめる(作れない組み合わせは事実の理由を付けて除く)。個々の特徴の包含だけでは組み合わせを守れなかった(生成器の偏りの穴。種類 A)
60
- - 生成範囲: `test/properties.test.ts` の性質は、設定を作る乱数(性質の名前から決まる種の列)と、日付などを引く乱数を分けた。性質と設定の作り方の対応は `test/support/sites.ts` の `PROPERTY_CONFIGS` に書き、性質が実際に使った作り方と同じかを確かめる。これで生成範囲の包含のテストが properties の設定を並びまで再現し、テストとスクリプトの特徴が一致する(どちらも 414 件。0.30.5 は近似でテスト 408 件・スクリプト 413 件)(種類 A)
61
- - 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)
62
- - 検査のスクリプトの検査の直し: 取り込み中の変更を `git status -z` で読む(日本語・スペースを含むパスを写せなかった)。写したファイルを出力に出す。result-compare・check-readme-examples の失敗の期待を、検査が誤りの理由として出す文(「**失敗**(意図した変更なら…」「expected "…"」)にした(別の理由で失敗しても合格になっていた)。写し・ビルドの途中の例外でも、表と後始末の問題を出してから失敗で終わる。対照の実行で SKIP の行が出たら失敗にする。飛ばしの決まり: `skipWhen` は skip と todo の取り違えを、`todoFor` は一覧にない理由を、CI でなくても飛ばす条件にかかわらず投げる。省略記法の grep の限界(複数行のオブジェクトの `skip,` は拾わない)を書き、`test/support/skip.ts` の冒頭の「CI」の意味を実装に合わせた(黙って外れる穴。種類 C)
63
- - 検査のスクリプトそのものの検査(`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)
64
- - `catch` 節の到達の検査: 除外の一覧の名前が 2 つ以上の節で重なるときと、節の文が `try` と同じ行にあるとき(行で数える lcov では判定できない)を失敗にした。`--lcov` は検査そのものを試すための引数で CI は使わないことを書いた。飛ばしの決まり: `skipWhen` は飛ばす条件にかかわらず理由が一覧にあるかを確かめ、grep の対象に `test/support/*.ts` と省略記法(`{ skip }`)を加えた。`RELEASING.md` に、grep で止められる範囲の限界(早い `return`・`continue` は個別の仕組みで守る)と、「CI」の意味(環境変数 `CI` が空でも `"false"` でもないとき)を書いた(種類 C)
65
- - `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)
66
- - 飛ばしの決まり: 前提がそろわないときに飛ばす箇所を補助の関数(`test/support/skip.ts` の `skipWhen`・`todoFor`)に集め、理由を意図した飛ばしの一覧から引くようにした(タイムゾーンを変えた実行、`ORACLE_JOINT`、Temporal のない実行環境、手元で前の版のタグが読めないとき、合成の既知の不具合の `todo`)。CI では、一覧にない理由と CI では飛ばさない理由を失敗にする。補助の関数を通さない飛ばしは grep の検査(`test/skip-policy.test.ts`)が止める(黙って飛ばす穴。種類 C)
67
- - 診断と判定の一致のテストの全件(150 件)を、`CONSISTENCY_FULL=1` で CI の `diagnose-consistency` ジョブで動かす(`pnpm check` は 12 件)。スケジュールから作ったカレンダーのテストで、`daysBetween` も未確定の祝日で投げることを確かめ、スケジュールの第 n 営業日の規則が基準のカレンダーを必須とする理由をコメントに書いた
68
- - 失敗を注入する祝日の提供元(`test/support/faulty.ts`。特定の年で例外を投げる・ある年だけ不正なデータ(日付の書式・重複・型の違う項目)を返す・途中の年を未確定にする)を作り、判定・診断・合成の結果が文書のとおりかを確かめるテスト(`test/faulty-provider.test.ts`)を足した。文書が何も言っていなかった組み合わせ(例外を投げる提供元の判定・合成・診断、不正なデータの提供元の合成、未確定の祝日の診断)は、今の挙動を約束として `docs/providers.ja.md`・`docs/providers.md` の「提供元の約束と誤りの扱い」に書き、テストで確かめる。提供元の約束に「`holidaysInYear` は同じ年に同じ結果を返す」を足し、途中から例外を投げる提供元は約束の外とした(例外の経路の穴。種類 C)
69
- - 診断のオラクル: カナリアの理由のテストで、`"over-holiday"` の開く規則を実際に取り除くと全日の結果が変わることまで確かめる。`test/properties.test.ts`: `PROPERTY_CONFIGS` に古い名前が残っていないこと、性質が 1 回の試行で 1 回だけ設定を作ることも確かめる。`scripts/record-generator-features.ts`: 作業ツリーの指定を真偽値で持ち、`"worktree"` という名前の参照と取り違えない。`RELEASING.md`・オラクルの冒頭のコメント: タイムゾーンを変えた実行で飛ばすのはオラクルの総当たりで、カナリアの 2 件は動かすと直した
70
- - `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`)
71
145
  - `RELEASING.md`: オラクルと生成範囲の行を実装と 1 文ずつ突き合わせ、消えていた「タイムゾーンを変えた実行では、オラクルと日本の全範囲の走査を飛ばす」を戻し、組み合わせの一覧の検査・カナリアの理由の確認・0 件の検査・`ORACLE_SHARD` の条件・CI の実測の時間を書いた
72
146
 
73
147
  ## [0.30.5] - 2026-11-01
@@ -76,20 +150,20 @@
76
150
 
77
151
  ### 開発
78
152
 
79
- - 生成範囲を減らさない検査を入れた(`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)
80
- - 呼び出し側の設定の作り方を `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)
81
- - 生成器の到達性を、呼び出し側の文脈ごと・規則の形ごとに確かめるようにした(`test/catalog.test.ts`)。これまではキーを全部の形の和集合で数え、ある形でだけ作られないキーを見逃していた。文脈は `test/support/sites.ts` の `CONTEXT_USES` に書き出し、文脈で作らない形(提供元のない設定の祝日に従属する形、0.22.2 と比べる設定の週の第 n 営業日)は理由付きで除く(種類 A)
82
- - 目録の除外の一覧を `"型.キー"` で引くようにし、除外したキーが `etc/api.md` に実在すること、呼び出し側が実際には作らないことも確かめる。0.30.4 の一覧は、作っているキー(`weekdayValues`・`sameAs`・`value`)を除外し、`calendar` を「スケジュールの生成器が別に付ける」としていたが、どの生成器も付けていなかった(種類 A)
83
- - `scripts/result-compare.ts`: スケジュールの第 n 営業日の規則に、数える基準のカレンダー(`calendar`)を付けるようにした。これまでは付けていなかったので、その設定は前の版・今回の版のどちらでも作成が `invalid-option` になり、結果を一度も比べていなかった(v0.30.3 から)。入力の誤りの設定(生成器が意図して混ぜ、規則に印を付けたもの)の件数を Job Summary に出し、印のない設定の作成の失敗(意図せず作成に失敗した設定)が 1 件でもあれば失敗にし、入力の誤りの設定が 0 件のときも空振りとして失敗にする。エラーコードでは分けない。印は規則のオブジェクトに付くので、印が誤りの形の規則とそろうこと(写した規則で消えていないこと)を `test/catalog.test.ts` で確かめる(黙って見ていない穴。種類 C)
84
- - 診断のオラクルの項目を、目録の乱数から切り離して明示した一覧(`test/fixtures/oracle-items.json`。0.30.4 の項目と同じ)にした。目録の値の候補を広げても、オラクルの項目は意図して変えない限り変わらない。一覧が目録のすべての形とキーを含むことを確かめ、今の不足(曜日の規則の `nth`・`months`・`skipWeekdays` など 8 つ)は `ITEM_GAPS` に理由付きで載せた(項目を足すと組み合わせが約 1.4 倍になり全件の実行が CI の時間を超えるので、全件の実行を行列に分けてから足す)(種類 B)
85
- - 黙って飛ばさない: `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)
86
- - 診断のオラクルの完全性の報告(取り除けるのに何も出ない項目)を確かめられるようにした。0 件のときは「なし」と出す。0 件だったのは項目の違いで、集計の誤りではなかった(外部のレビューの試作の項目を正式版のオラクルで動かすと、試作と同じく開く規則「5・7 月の月曜」の 2 件が出た)。その設定をカナリアとして固定し、報告に出ることを確かめる。全件では、`shadowed`・`never-matches`・`redundant`・`expired` がどれも 1 件以上出ることも確かめる(報告の仕組みが壊れても気づけない穴。種類 B)
87
- - 診断のオラクルの範囲を広げた。項目の一覧に、目録の形とキーの不足を埋める 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)
88
- - 診断の `counting-basis` の文を、毎週の曜日の規則が開く規則か閉じる規則かの両側で確かめる単体テストを足した(`test/counting-basis.test.ts`)(文の分岐を確かめていなかった穴。種類 C)
89
- - 生成範囲の検査の補修: 特徴の取り出しの診断の走査の範囲(`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`)
90
164
  - `RELEASING.md`: 診断のオラクルの環境変数(`ORACLE_FULL`・`ORACLE_SHARD`・`ORACLE_TARGET`・`ORACLE_JOINT`)と、全件の実行の時間の決まりを書いた
91
165
  - `test/diagnose-properties.test.ts` の冒頭に二重に残っていた古い説明のコメントを消した
92
- - `RELEASING.md`: 品質の確認に生成範囲の行を足し、目録・オラクルの行を今の検査に合わせた。生成範囲の記録は基準の版(v0.30.3)から取り、作り直すのは比べ方(特徴の取り出し方)を変えたときだけにして、CHANGELOG の「開発」に理由を書くことを書いた
166
+ - `RELEASING.md`: 品質の確認に生成範囲の行を足し、目録・オラクルの行を今の検査に合わせた
93
167
 
94
168
  ## [0.30.4] - 2026-11-01
95
169
 
@@ -101,13 +175,13 @@
101
175
 
102
176
  ### 開発
103
177
 
104
- - 規則と設定の目録 `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` を見逃した種類)
105
- - `test/properties.test.ts` のカレンダーに、目録の繰り返しの規則を入れた(これまでは繰り返しの規則のないカレンダーだけを試していた)。営業日のないカレンダーになった試行は、性質の前提を満たさないので飛ばす(1 割まで)
178
+ - 規則と設定の目録 `test/support/catalog.ts` を置き、乱数のテストと `scripts/result-compare.ts` の生成器を目録に切り替えた
179
+ - `test/properties.test.ts` のカレンダーに、目録の繰り返しの規則を入れた(これまでは繰り返しの規則のないカレンダーだけを試していた)
106
180
  - `test/diagnose-properties.test.ts` は、対応年の短い自作の提供元(`test/support/provider.ts`)で全日を比べる(400 日の抜き出しをやめた)
107
- - 診断の総当たりのオラクル `test/diagnose-oracle.test.ts` を入れた。目録の規則の形の代表と個別の日付・毎年の月日の 2 つまでの組み合わせで、出た項目を取り除いて全日の結果を比べ、`expired`・`no-business-day`・`counting-basis` の約束も確かめる。`pnpm check` は決まった抜き出し、CI の `oracle` ジョブはすべての組み合わせを試し、完全性(取り除けるのに何も出ない項目)を Job Summary に報告する。出た項目をまとめて取り除いても変わらない性質(0.31.0 の P1 の正解の定義)は、印を付けて用意した(`ORACLE_JOINT=1` で試せる)。0.30.2 に向けると、すべての組み合わせで第 n 営業日の誤った `redundant` を検出する(正解と突き合わせる仕組みの不在の穴を塞ぐ)
181
+ - 診断の総当たりのオラクル `test/diagnose-oracle.test.ts` を入れた(出た項目をまとめて取り除く性質は `ORACLE_JOINT=1` で試せる)
108
182
  - `scripts/test-tz.ts`: タイムゾーンを変えた実行では、オラクルを飛ばす(暦日だけで決まるので)
109
183
  - `RELEASING.md`: 品質の確認に目録とオラクルを足し、手元の確認は前の版のタグを読める状態で通すことを書いた
110
- - サイズ(gzip): `./diagnose` 25,321 → 25,360(測定 25,360。上の Fixed の文の分)。上限は変えていない
184
+ - サイズ(gzip): `./diagnose` 25,321 → 25,360(測定 25,360。上の Fixed の文の分)
111
185
 
112
186
  ## [0.30.3] - 2026-11-01
113
187
 
@@ -130,16 +204,15 @@
130
204
 
131
205
  ### 開発
132
206
 
133
- - `test/diagnose.test.ts`・`test/diagnose-properties.test.ts`: 上の Fixed の 4 例(月・週の第 n 営業日、閉じる・開く規則)と、スケジュールの第 n 営業日の規則では結果が変わらないことのテストを足した。性質のテストの設定の生成に第 n 営業日の規則を足し、第 n 営業日の規則と個別の日付を必ず持つ設定の性質を足した(0.30.2 では失敗する。生成に入っていなかったので、この不具合を見逃していた)
134
- - `scripts/result-compare.ts`: 意図した差分を、診断の消えた結果のコード(`removedCodes`)で絞れるようにした。上の Fixed の差分を、第 n 営業日の規則と個別の日付・毎年の月日を持つ設定の `redundant` が消えたものだけに絞って許す(`counting-rules-with-dates`)。上の Fixed の例を固定の設定に足した(週の第 n 営業日の例は、それがない 0.22.2 とは比べない)
135
- - サイズの上限: `./diagnose` を 25,000 から 25,800 に上げた(上の Fixed で上限を超えたため。測定値に小さな余裕を足した値)
136
- - サイズ(gzip): `./diagnose` 24,753 → 25,321(測定 25,321)。ルート 17,997(測定 17,997)と `./jp` 20,226(測定 20,226)は変わらない
137
- - 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 時間を過ぎた版)
138
- - `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`: 決定の文書の目次が本文の章・見出しと一致すること(番号の重複も)を確かめる
139
213
  - `scripts/bench-compare.ts`: CHANGELOG の今の版(または [Unreleased])の「開発」に決まった言葉で理由を書いた版は、2 倍を超えて遅くなっても表に記録して合格にする(言葉は `RELEASING.md` の品質の確認の表)
140
- - `etc/result-changes.json` に 0.30.1 の修正(和集合の旧名 `"national"`)を足した。公開済みの 0.30.0 → 0.30.1 を比べたとき、意図した修正ではなく診断の退行だけが「許していない差分」として出る
141
-
142
- - `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`: 意図した差分を許す特徴を、比べた対象ごとに付けるようにした
143
216
  - `test/fixtures/national-union-0.22.2.json` の出典の説明で、`"national"` の扱いの根拠を旧 55 番としていたのを旧 54 番(今の 10 番)に直した
144
217
 
145
218
  ## [0.30.2] - 2026-10-30
@@ -162,10 +235,10 @@
162
235
 
163
236
  ### 開発
164
237
 
165
- - 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`)
166
239
  - `scripts/check-names.ts`: 前の版を動かす `scripts/result-compare.ts` を、旧名の検査(C14)の対象から外した
167
240
  - `test/national-union.test.ts` に、日本の提供元だけの設定の `shadowed` の確認を足した
168
- - サイズ(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)
169
242
 
170
243
  ## [0.30.1] - 2026-10-30
171
244
 
@@ -187,10 +260,10 @@
187
260
 
188
261
  ### 開発
189
262
 
190
- - `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:` を検出する
191
- - `scripts/check-size.ts`: 上限を変えた版で、CHANGELOG の測定値(「(測定 N)」の形)を 1 つも照合できなければ失敗にし、照合した件数を出すようにした。0.30.0 の節は測定値をこの形で書いておらず、照合が 0 件のまま合格していた(記載の値は、測定の後の内部の関数名の変更で公開物と 6〜7 バイト違っていた)
192
- - 和集合の `"national"` のテスト(`test/national-union.test.ts`)を足した。日本の提供元を包んだ設定との関係を対応年のすべてで確かめ、公開済みの 0.22.2 の結果(2020〜2027 年)を錨にする(`test/fixtures/national-union-0.22.2.json`)
193
- - サイズ(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)
194
267
 
195
268
  ## [0.30.0] - 2026-10-27
196
269
 
@@ -229,11 +302,11 @@
229
302
 
230
303
  ### 開発
231
304
 
232
- - 名前の規則の検査 `scripts/check-names.ts` を `pnpm check` に足した(`etc/naming.md` の用語集・外部の名前の出典と、移行ガイドの削除予定の表に照らす。名前を許す一覧は持たない)。名前が約束する意味は `test/naming.test.ts` の性質のテストで確かめる
305
+ - 名前の規則の検査 `scripts/check-names.ts` を `pnpm check` に足した
233
306
  - 改名の表を `src/core/renamed.ts` の 1 か所に置き、読み替え・診断・`migrate…` がこの表だけを使う
234
307
  - `scripts/bench.ts` は、前の版が新しい名前を知らないときは設定を旧名に戻して渡す(CI の bench が同じ場面を比べるため)
235
308
  - `scripts/check-readme-examples.ts` は、0.30.x の間だけ返す旧名の項目(削除予定の表から決める)を比べない
236
- - サイズの上限を上げた(ルート 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
+ - サイズの上限を上げた
237
310
  - README のサイズの値を 0.30.0 で測り直した
238
311
 
239
312
  ## [0.22.2] - 2026-10-27
@@ -279,7 +352,7 @@
279
352
 
280
353
  ### 開発
281
354
 
282
- - サイズの上限(`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`)を上げた
283
356
 
284
357
  ## [0.21.4] - 2026-10-26
285
358
 
@@ -292,9 +365,9 @@
292
365
 
293
366
  ### 開発
294
367
 
295
- - `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`)を検出する
296
- - スクリプト・ワークフロー・テスト・`src` のコメント(型定義に出る TSDoc を含む)から、決定の文書と重複する理由の説明、版の経緯(「0.18.0 で追加」など)、利用元の一覧、変わりうる事実(検証のフィクスチャの一覧・TypeScript や Node.js の版の一覧・照合する国の一覧や数など)を削り、何をするか・使い方・決定の文書の番号だけを残した(52 番)
297
- - サイズの上限(`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` の実測に合わせて下げた
298
371
 
299
372
  ## [0.21.3] - 2026-10-26
300
373
 
@@ -307,9 +380,9 @@
307
380
 
308
381
  ### 開発
309
382
 
310
- - `pnpm check`(`scripts/check-package.ts`)に、ドキュメントの数値・一覧を `dist` とソースの型と照合する検査を足した(decisions.md の 51 番)。README の提供元の表とガイドの国の節・「対応年の外」の節の対応年とタイムゾーン・`confirmedThrough`、祝日の識別子の表の key、エラーコードの一覧と診断の表のコード、README の「測った版」が今のマイナー系列であること、英日の対の文書で節ごとの数値がそろうこと。0.21.2 の文書に当てると、ガイドのフランスの対応年・README のサイズの測った版・診断の表とエラーコードの一覧の抜け・版の固定の例の英日の違いを検出する
311
- - CI に `data-compare` ジョブを足した。公開済みの前の版(npm の `latest`)と今回の `dist` の同梱の提供元を、対応年が重なるすべての年で 1 日ずつ比べ(`scripts/data-compare.ts`)、`key` が変わったとき、差分があるのに CHANGELOG に Data がないとき、提供元がなくなったか対応年が狭まったときに失敗する。照合のフィクスチャのない年(予測の年など)の安全網
312
- - 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` を足した
313
386
 
314
387
  ## [0.21.2] - 2026-10-26
315
388
 
@@ -319,7 +392,7 @@
319
392
 
320
393
  ### 開発
321
394
 
322
- - 納品の検査を `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 番)
323
396
 
324
397
  ## [0.21.1] - 2026-10-26
325
398
 
@@ -350,8 +423,8 @@
350
423
 
351
424
  ### 開発
352
425
 
353
- - テスト: `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/` に置いた
354
- - サイズの上限(`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`)を上げた
355
428
 
356
429
  ## [0.20.0] - 2026-10-25
357
430
 
@@ -374,7 +447,7 @@
374
447
 
375
448
  ### 開発
376
449
 
377
- - 監視のワークフロー `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`)を追加した
378
451
  - テスト: `test/fr-rules.test.ts`・`test/fr-datagouv.test.ts` を追加し、`test/holiday-key.test.ts`・ESM/CJS/ブラウザー/workerd の確認・利用者の型チェックにフランスを足した
379
452
  - サイズの上限(`size-limits.json`)に `./fr` 6,500(測定 5,404)を足した(gzip)
380
453
 
@@ -398,9 +471,9 @@
398
471
 
399
472
  ### 開発
400
473
 
401
- - 監視の照合スクリプト(`scripts/verify-govuk.ts`・`verify-datagovsg.ts`・`verify-cao.ts`)の「確認した日付」を UTC から日本時間に揃えた(issue のコメントの日付と同じ基準)
474
+ - 監視の照合スクリプトの「確認した日付」を UTC から日本時間に揃えた(issue のコメントの日付と同じ基準)
402
475
  - テスト: `test/business-day-of-month.test.ts`・`test/skip-weekdays.test.ts` を追加し、`test/types.check.ts`・利用者の型チェックに新しい規則を足した
403
- - サイズの上限(`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`)を上げた
404
477
 
405
478
  ## [0.18.0] - 2026-10-25
406
479
 
@@ -423,9 +496,9 @@
423
496
 
424
497
  ### 開発
425
498
 
426
- - 監視のワークフロー `data-watch.yml` に内閣府「国民の祝日」CSV の照合を足した(issue のラベル `cao-data`。ハートビートは 3 つの照合がすべて動いたときだけ)。`scripts/verify-cao.ts` を英国・シンガポールと同じ形(`--report`・`--simulate`、終了コード 0・1・2、取得の再試行、「New years published」・フィクスチャの差分の節)にした。翌年の春分・秋分の日の公表が issue で届くので、2 月の作業を記憶に頼らない
427
- - テスト: `test/holiday-key.test.ts` を追加し、`test/provider.test.ts` に `substituteDays`(同梱の 3 か国との同値・向き・名称・入力の検証)を足した。`test/types.check.ts`・利用者の型チェックに `keys`・既知の `key` の型・`substituteDays` を足した
428
- - サイズの上限(`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`)を上げた
429
502
 
430
503
  ## [0.17.1] - 2026-10-25
431
504
 
@@ -435,7 +508,7 @@
435
508
 
436
509
  ### 開発
437
510
 
438
- - `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`)
439
512
  - `RELEASING.md`・`docs/decisions.md` の 22・27 番に、ドキュメントの対が増えたことを書いた
440
513
 
441
514
  ## [0.17.0] - 2026-10-25
@@ -461,9 +534,9 @@
461
534
 
462
535
  ### 開発
463
536
 
464
- - 監視のワークフローを `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`)を追加した
465
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・利用者の型チェックにシンガポールと新しい設定を足した
466
- - サイズの上限(`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` のエントリーを足した
467
540
 
468
541
  ## [0.16.0] - 2026-10-23
469
542
 
@@ -486,10 +559,10 @@
486
559
 
487
560
  ### 開発
488
561
 
489
- - 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 の確認も同じものを呼ぶ)
490
- - `easterSunday` を `src/uk/rules.ts` から `src/core/date.ts` に移した(結果は変わらない。provider のサブパスが英国のデータを引き込まないため)
491
- - 規則の診断の性質のテストの生成器に祝前日を加えた。`test/day-before-holiday.test.ts`・`test/provider.test.ts` を新規に足し、利用者の型チェックに祝前日・`decidedByPath`・provider を足した
492
- - サイズの上限(`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` のエントリーを足した
493
566
 
494
567
  ## [0.15.0] - 2026-10-21
495
568
 
@@ -511,8 +584,8 @@
511
584
 
512
585
  ### 開発
513
586
 
514
- - 性質のテストに、休業日を起点にした `addBusinessDays`(`addBusinessDays(a, n) = addBusinessDays(businessDayOnOrAfter(a), n − 1)`、n ≥ 1)と、営業日を考慮した締め日(複数のカレンダー × 4 つの方法 × 締め日 1〜31・−1 で、空でない期間が敷き詰められ `closingMonth` と往復する)を足した。規則の診断の性質のテストに `weekdays` を加えた
515
- - サイズの上限(`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`)を上げた
516
589
 
517
590
  ## [0.14.1] - 2026-10-20
518
591
 
@@ -520,7 +593,7 @@
520
593
 
521
594
  ### 開発
522
595
 
523
- - `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% 遅くなっていたのを直した
524
597
  - `docs/decisions.md`: 38 番にこの原因と「作ったあとに印を付けず、リテラルに含める」知見を追記した
525
598
 
526
599
  ## [0.14.0] - 2026-10-20
@@ -542,7 +615,7 @@
542
615
 
543
616
  ### 開発
544
617
 
545
- - サイズの上限(`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`)を上げた
546
619
 
547
620
  ## [0.13.0] - 2026-10-20
548
621
 
@@ -562,9 +635,9 @@
562
635
 
563
636
  ### 開発
564
637
 
565
- - 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 で確かめる
566
- - `scripts/check-consumer-types.ts` に `--tsc <path>` を足し、わざと型エラーを含む `test/consumer/consumer-error.mts` が各版で失敗として報告されること(検査が機能していること)も確かめるようにした。リポジトリの `@types` を読まないよう `--typeRoots` を空にした(古い TypeScript では `@types/node` の新しい構文を読めないため)。`--ignoreConfig` は 6.0 以降でだけ渡す
567
- - `createCalendar` の `dayInfo` の変換を `createCalendarFromSchedule` と共用の内部関数に切り出した。結果は変わらない
638
+ - CI に `consumer-types` ジョブを追加した
639
+ - `scripts/check-consumer-types.ts` に `--tsc <path>` を足し、わざと型エラーを含む `test/consumer/consumer-error.mts` が各版で失敗として報告されること(検査が機能していること)も確かめるようにした
640
+ - `createCalendar` の `dayInfo` の変換を `createCalendarFromSchedule` と共用の内部関数に切り出した
568
641
 
569
642
  ## [0.12.0] - 2026-10-20
570
643
 
@@ -591,9 +664,9 @@
591
664
 
592
665
  ### 開発
593
666
 
594
- - CI に `bench` ジョブを追加した。公開済みの前の版(npm の `latest`)と今回の `dist` を同じランナーで `scripts/bench.ts` にかけ、`scripts/bench-compare.ts` で比率を比べる。どれかの計測が 2 倍より遅ければ失敗し、絶対値は Job Summary に残す(`pnpm check` には含めない)。`scripts/bench.ts` に `--package <dir>`・`--json <file>` を足した
595
- - サイズの上限(`size-limits.json`)を上げた。ルート 19,500 → 20,500、`./jp` 22,500 → 23,500、`./diagnose` 26,000 → 27,000(gzip)。祝日の規則の検証・判定と `rulePath`(ルートで約 0.5KB)、診断の祝日の規則への対応と候補の改善(約 0.7KB)のため
596
- - 性質のテストに祝日の規則を加えた。規則を取り除いた結果との比較では、位置がずれる `rulePath` を除いて比べる
667
+ - CI に `bench` ジョブを追加した。`scripts/bench.ts` に `--package <dir>`・`--json <file>` を足した
668
+ - サイズの上限(`size-limits.json`)を上げた
669
+ - 性質のテストに祝日の規則を加えた
597
670
  - ライブラリ内のテストとスクリプトで、非推奨にした定数 `confirmedThrough` の代わりに提供元の項目を使うようにした
598
671
 
599
672
  ## [0.11.1] - 2026-10-19
@@ -626,8 +699,8 @@
626
699
 
627
700
  ### 開発
628
701
 
629
- - サイズの上限(`size-limits.json`)を上げた。ルート 17,500 → 19,500、`./jp` 20,500 → 22,500、`./diagnose` 24,000 → 26,000(gzip)。祝日の翌日の規則と `combineCalendars`(ルートで約 1.7KB)と、診断の祝日の翌日への対応(約 1.9KB)のため
630
- - `createCalendar` の営業日の探索・調整・月の営業日の実装を、祝日を調べる機能と 1 日分の判定を引数に取る内部関数(`buildCalendar`)に切り出し、`combineCalendars` と共用した。公開 API と結果は変わらない
702
+ - サイズの上限(`size-limits.json`)を上げた
703
+ - `createCalendar` の営業日の探索・調整・月の営業日の実装を、祝日を調べる機能と 1 日分の判定を引数に取る内部関数(`buildCalendar`)に切り出し、`combineCalendars` と共用した
631
704
  - 性質のテストに祝日の翌日の規則を加えた
632
705
 
633
706
  ## [0.10.0] - 2026-10-19
@@ -655,8 +728,8 @@
655
728
 
656
729
  ### 開発
657
730
 
658
- - サイズの上限(`size-limits.json`)を上げた。ルート 16,500 → 17,500、`./jp` 19,500 → 20,500、`./diagnose` 22,000 → 24,000(gzip)。有効期間と周期の検証・判定(ルートで約 0.8KB)と、診断の走査範囲・包含判定の見直し(約 2.3KB)のため
659
- - 性質のテスト(`test/diagnose-properties.test.ts`)で、有効期間と周期のある規則も作るようにした。固定の走査範囲(2001〜2028 年)の外や、28 年の周期をまたぐ年の日付も比べる
731
+ - サイズの上限(`size-limits.json`)を上げた
732
+ - 性質のテストで、有効期間と周期のある規則も作るようにした
660
733
 
661
734
  ## [0.9.1] - 2026-10-18
662
735
 
@@ -668,7 +741,7 @@
668
741
 
669
742
  ### 開発
670
743
 
671
- - ブラウザーでの確認の Edge の起動オプションに、`--disable-dev-shm-usage` と `--disable-gpu` を足した。CI のランナーで Edge のページの読み込みが止まり、やり直し(`RETRY`)がほぼ毎回起きていたため
744
+ - ブラウザーでの確認の Edge の起動オプションに、`--disable-dev-shm-usage` と `--disable-gpu` を足した
672
745
 
673
746
  ## [0.9.0] - 2026-10-18
674
747
 
@@ -690,11 +763,9 @@
690
763
 
691
764
  ### 開発
692
765
 
693
- - `pnpm check` で、利用者のプロジェクトとして公開する型定義を型チェックするようにした(`scripts/check-consumer-types.ts`・`test/consumer/consumer.mts`。`moduleResolution` を `node16`・`nodenext`・`bundler` に変え、ライブラリの型定義の検査も有効にする)
694
-
695
- - 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 版を指定する)
696
-
697
- - ブラウザーでの確認(`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`)に時間制限を設けた
698
769
 
699
770
  ## [0.8.1] - 2026-10-18
700
771
 
@@ -707,14 +778,13 @@
707
778
 
708
779
  ### 開発
709
780
 
710
- - 公開する `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` だけを確かめる)
711
-
712
- - 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 のオブジェクトでも確かめる
713
- - `pnpm check` で、README(英語・日本語)のコード例を実行し、コメントに書いた結果と比べるようにした(`scripts/check-readme-examples.ts`)
714
- - `pnpm check`(`scripts/check-package.ts`)で、`src` が Node.js 固有の機能(`node:` のモジュール・`process`・`Buffer` など)を使っていないことを確かめるようにした
715
- - 自前のスクリプトとテストで Node.js の警告が出たら失敗にするようにした(`scripts/strict-warnings.ts`。`test/compat` は対象外)
716
- - `pnpm check` の最初に、開発用のツールの版を確かめる `scripts/check-toolchain.ts` を追加した(ワークフローどうしの Node.js の版、compat の行列の engines の下限、実行している Node.js・npm・pnpm と固定版の比較。固定版との違いは CI ではエラー、手元では注意の表示)
717
- - 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`)
718
788
  - `pnpm check` のパッケージの中身の検査(`npm pack --dry-run`)を、Windows で Node.js の非推奨の警告(DEP0190)が出ない形で npm を起動するようにした
719
789
 
720
790
  ## [0.8.0] - 2026-10-17
@@ -731,12 +801,12 @@
731
801
 
732
802
  ### 開発
733
803
 
734
- - `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 バイト)
735
- - GOV.UK の bank holidays を毎日照合するワークフロー(`.github/workflows/govuk-watch.yml`)を追加した。差分があれば `pnpm verify:govuk` の結果と alphagov/frontend の該当ファイルの最新のコミットを本文にした issue(ラベル `govuk-data`)を立て、同じ issue が開いていれば内容が変わったときだけ本文を更新してコメントする。取得に失敗した場合も、監視が機能していないことを issue で知らせる。60 日間動きのないリポジトリで定期実行が止まらないよう、実行のたびにワークフローを有効化し直す。フィクスチャはワークフローでは更新せず、規則の修正と同じコミットで更新する
736
- - 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 で検査するジョブを追加した
737
807
  - CI・リリース・監視のワークフローの Node.js を 24.21.0 から 24.22.0 に、pnpm を 12.11.2 から 12.14.0 に上げた(手元の開発環境に合わせる)
738
808
  - `pnpm check`(`scripts/check-package.ts`)で、`README.md` と `docs/README.ja.md` の見出しの数(段ごと)とコードブロックの数が一致し、互いへの切り替えのリンクがあることを確かめるようにした
739
- - `pnpm check` が、パッケージの中身を `files` の指定からの推定ではなく、実際の `npm pack --dry-run --json` の結果で確かめるようにした(npm が指定にかかわらず含めるファイルを見落とさないため)。ルートに `README.ja.md` があれば失敗する
809
+ - `pnpm check` が、パッケージの中身を `files` の指定からの推定ではなく、実際の `npm pack --dry-run --json` の結果で確かめるようにした
740
810
 
741
811
  ## [0.7.0] - 2026-10-16
742
812
 
@@ -746,7 +816,7 @@
746
816
 
747
817
  ### 開発
748
818
 
749
- - `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 の「開発」に書く取り決めにした
750
820
 
751
821
  ## [0.6.0] - 2026-10-16
752
822
 
@@ -764,7 +834,7 @@
764
834
  - `pnpm check`(`scripts/check-package.ts`)で、CHANGELOG の版の節の並び・日付と、末尾のリンク定義が節とそろっていることを確かめるようにした(0.5.0 でリンク定義の更新漏れがあったため)
765
835
  - リリースのワークフローで、CHANGELOG の日付が `YYYY-MM-DD` のまま・見出しがないときの表示を分かりやすくした(止まる条件は変わらない)
766
836
  - 月の計算と日付の調整の性質のテストを追加
767
- - サイズの上限を上げた(`.` 16500・`./jp` 19500・`./diagnose` 22000。月の計算の追加。minify + gzip ではルートが約 7.2KB、日本の祝日込みで約 8.3KB)
837
+ - サイズの上限を上げた
768
838
  - `docs/decisions.md` に 16 番目(日付の調整と月の期日の設計)を追加
769
839
 
770
840
  ## [0.5.0] - 2026-10-16
@@ -783,7 +853,7 @@
783
853
 
784
854
  ### 開発
785
855
 
786
- - 診断の性質のテスト(`test/diagnose-properties.test.ts`): 使われない・取り除いても変わらないと診断した規則を実際に取り除き、結果が変わらないことを乱数の設定で確かめる
856
+ - 診断の性質のテスト: 使われない・取り除いても変わらないと診断した規則を実際に取り除き、結果が変わらないことを乱数の設定で確かめる
787
857
  - サイズの上限に `./diagnose` を追加
788
858
  - `docs/decisions.md` に 15 番目(規則の診断の設計)を追加
789
859
 
@@ -804,7 +874,7 @@
804
874
  ### 開発
805
875
 
806
876
  - 性能の計測(`pnpm bench`、依存なし)を追加
807
- - README に繰り返しの規則の節と、よくある設定の例(国民の休日を営業日として扱う、共通の設定から店舗ごとのカレンダーを作る)を追加。`docs/decisions.md` に 12〜14 番目(判定の順番を固定する理由、「第 n 何曜日」の定義、振替先の定義)を追加
877
+ - README に繰り返しの規則の節と、よくある設定の例を追加
808
878
 
809
879
  ## [0.3.1] - 2026-10-15
810
880
 
@@ -813,7 +883,7 @@
813
883
  ### 開発
814
884
 
815
885
  - lint に oxlint(1.88.0)を導入し、`pnpm check` と CI で実行するようにした(`.oxlintrc.json`)
816
- - 型チェックを強めた(`noUnusedLocals`・`noUnusedParameters`・`noImplicitReturns`・`exactOptionalPropertyTypes`)
886
+ - 型チェックを強めた
817
887
  - oxfmt を 0.73.0 に更新
818
888
  - 改行コードを LF に統一した(`.gitattributes`)
819
889
 
@@ -892,7 +962,9 @@
892
962
 
893
963
  - 日本: 2026 年 2 月の官報(2027 年の春分・秋分の日)まで反映(`dataVersion: "2026-02"`、`confirmedThrough: 2027`)
894
964
 
895
- [Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.7...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
967
+ [0.30.8]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.7...v0.30.8
896
968
  [0.30.7]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.6...v0.30.7
897
969
  [0.30.6]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.5...v0.30.6
898
970
  [0.30.5]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.4...v0.30.5