bizdays-toolkit 0.30.4 → 0.30.5

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.
Files changed (2) hide show
  1. package/CHANGELOG.md +23 -1
  2. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -4,6 +4,27 @@
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ ## [0.30.5] - 2026-11-01
8
+
9
+ 0.30.4 の品質基盤の補修です。公開物の `.js` は 0.30.4 と同じです。0.30.4 で、品質基盤が「動いているように見えて、実は見ていない」箇所と、乱数のテストの生成範囲が縮んだ箇所が見つかったので、それだけを直しました。テスト拡充案の段の番号を 1 つずつずらし、第 2 段は 0.30.6、第 3 段は 0.30.7 で出します。
10
+
11
+ ### 開発
12
+
13
+ - 生成範囲を減らさない検査を入れた(`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)
14
+ - 呼び出し側の設定の作り方を `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)
15
+ - 生成器の到達性を、呼び出し側の文脈ごと・規則の形ごとに確かめるようにした(`test/catalog.test.ts`)。これまではキーを全部の形の和集合で数え、ある形でだけ作られないキーを見逃していた。文脈は `test/support/sites.ts` の `CONTEXT_USES` に書き出し、文脈で作らない形(提供元のない設定の祝日に従属する形、0.22.2 と比べる設定の週の第 n 営業日)は理由付きで除く(種類 A)
16
+ - 目録の除外の一覧を `"型.キー"` で引くようにし、除外したキーが `etc/api.md` に実在すること、呼び出し側が実際には作らないことも確かめる。0.30.4 の一覧は、作っているキー(`weekdayValues`・`sameAs`・`value`)を除外し、`calendar` を「スケジュールの生成器が別に付ける」としていたが、どの生成器も付けていなかった(種類 A)
17
+ - `scripts/result-compare.ts`: スケジュールの第 n 営業日の規則に、数える基準のカレンダー(`calendar`)を付けるようにした。これまでは付けていなかったので、その設定は前の版・今回の版のどちらでも作成が `invalid-option` になり、結果を一度も比べていなかった(v0.30.3 から)。入力の誤りの設定(生成器が意図して混ぜ、規則に印を付けたもの)の件数を Job Summary に出し、印のない設定の作成の失敗(意図せず作成に失敗した設定)が 1 件でもあれば失敗にし、入力の誤りの設定が 0 件のときも空振りとして失敗にする。エラーコードでは分けない。印は規則のオブジェクトに付くので、印が誤りの形の規則とそろうこと(写した規則で消えていないこと)を `test/catalog.test.ts` で確かめる(黙って見ていない穴。種類 C)
18
+ - 診断のオラクルの項目を、目録の乱数から切り離して明示した一覧(`test/fixtures/oracle-items.json`。0.30.4 の項目と同じ)にした。目録の値の候補を広げても、オラクルの項目は意図して変えない限り変わらない。一覧が目録のすべての形とキーを含むことを確かめ、今の不足(曜日の規則の `nth`・`months`・`skipWeekdays` など 8 つ)は `ITEM_GAPS` に理由付きで載せた(項目を足すと組み合わせが約 1.4 倍になり全件の実行が CI の時間を超えるので、全件の実行を行列に分けてから足す)(種類 B)
19
+ - 黙って飛ばさない: `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)
20
+ - 診断のオラクルの完全性の報告(取り除けるのに何も出ない項目)を確かめられるようにした。0 件のときは「なし」と出す。0 件だったのは項目の違いで、集計の誤りではなかった(外部のレビューの試作の項目を正式版のオラクルで動かすと、試作と同じく開く規則「5・7 月の月曜」の 2 件が出た)。その設定をカナリアとして固定し、報告に出ることを確かめる。全件では、`shadowed`・`never-matches`・`redundant`・`expired` がどれも 1 件以上出ることも確かめる(報告の仕組みが壊れても気づけない穴。種類 B)
21
+ - 診断のオラクルの範囲を広げた。項目の一覧に、目録の形とキーの不足を埋める 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)
22
+ - 診断の `counting-basis` の文を、毎週の曜日の規則が開く規則か閉じる規則かの両側で確かめる単体テストを足した(`test/counting-basis.test.ts`)(文の分岐を確かめていなかった穴。種類 C)
23
+ - 生成範囲の検査の補修: 特徴の取り出しの診断の走査の範囲(`diagnoseRangeOf`)に、対応年が 1900〜2099 年と重ならないときに先頭の 200 年にする扱いを入れ、単体テストで確かめる(`test/features.test.ts`)。記録を作り直す(`--update`)ときは、呼び出し側の終了コード 0 を必須にした(比べるときは見ない。理由はスクリプトの冒頭)。テストとスクリプトで result-compare の拾える特徴の数が違う理由(差はすべて、スケジュールの基準のカレンダーにライブラリが問い合わせた日付の特徴)をテストに書いた。生成範囲の検査が守るのは個々の特徴だけで、特徴の組み合わせは守らない(組み合わせは診断のオラクルの総当たりでしか守られていない)ことを `RELEASING.md` に書いた(種類 A)
24
+ - `RELEASING.md`: 診断のオラクルの環境変数(`ORACLE_FULL`・`ORACLE_SHARD`・`ORACLE_TARGET`・`ORACLE_JOINT`)と、全件の実行の時間の決まりを書いた
25
+ - `test/diagnose-properties.test.ts` の冒頭に二重に残っていた古い説明のコメントを消した
26
+ - `RELEASING.md`: 品質の確認に生成範囲の行を足し、目録・オラクルの行を今の検査に合わせた。生成範囲の記録は基準の版(v0.30.3)から取り、作り直すのは比べ方(特徴の取り出し方)を変えたときだけにして、CHANGELOG の「開発」に理由を書くことを書いた
27
+
7
28
  ## [0.30.4] - 2026-11-01
8
29
 
9
30
  品質基盤の整備の第 1 段(正解の定義)です。規則と設定の目録と、診断の総当たりのオラクルを入れました。オラクルで見つけた診断の文の誤りを 1 つ直しました(判定の結果は変わりません)。
@@ -805,7 +826,8 @@
805
826
 
806
827
  - 日本: 2026 年 2 月の官報(2027 年の春分・秋分の日)まで反映(`dataVersion: "2026-02"`、`confirmedThrough: 2027`)
807
828
 
808
- [Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.4...HEAD
829
+ [Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.5...HEAD
830
+ [0.30.5]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.4...v0.30.5
809
831
  [0.30.4]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.3...v0.30.4
810
832
  [0.30.3]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.2...v0.30.3
811
833
  [0.30.2]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.1...v0.30.2
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bizdays-toolkit",
3
- "version": "0.30.4",
3
+ "version": "0.30.5",
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",