bizdays-toolkit 0.30.3 → 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.
- package/CHANGELOG.md +42 -1
- package/dist/core/diagnose.js +4 -2
- package/package.json +2 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,45 @@
|
|
|
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
|
+
|
|
28
|
+
## [0.30.4] - 2026-11-01
|
|
29
|
+
|
|
30
|
+
品質基盤の整備の第 1 段(正解の定義)です。規則と設定の目録と、診断の総当たりのオラクルを入れました。オラクルで見つけた診断の文の誤りを 1 つ直しました(判定の結果は変わりません)。
|
|
31
|
+
|
|
32
|
+
### Fixed
|
|
33
|
+
|
|
34
|
+
- 診断: 第 n 営業日の規則と、毎週の曜日を開く繰り返しの規則がある設定で、`counting-basis` の文が「その曜日の規則は数を減らさない」と、閉じる規則のときの説明をしていた。開く規則のときは「その規則が開いた日は数えない」と説明する。メッセージは API ではないので、診断の `code`・`path` は変わらない(総当たりのオラクルで約束を確かめるときに見つけた。種類は文章の主張の未検証)
|
|
35
|
+
|
|
36
|
+
### 開発
|
|
37
|
+
|
|
38
|
+
- 規則と設定の目録 `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` を見逃した種類)
|
|
39
|
+
- `test/properties.test.ts` のカレンダーに、目録の繰り返しの規則を入れた(これまでは繰り返しの規則のないカレンダーだけを試していた)。営業日のないカレンダーになった試行は、性質の前提を満たさないので飛ばす(1 割まで)
|
|
40
|
+
- `test/diagnose-properties.test.ts` は、対応年の短い自作の提供元(`test/support/provider.ts`)で全日を比べる(400 日の抜き出しをやめた)
|
|
41
|
+
- 診断の総当たりのオラクル `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` を検出する(正解と突き合わせる仕組みの不在の穴を塞ぐ)
|
|
42
|
+
- `scripts/test-tz.ts`: タイムゾーンを変えた実行では、オラクルを飛ばす(暦日だけで決まるので)
|
|
43
|
+
- `RELEASING.md`: 品質の確認に目録とオラクルを足し、手元の確認は前の版のタグを読める状態で通すことを書いた
|
|
44
|
+
- サイズ(gzip): `./diagnose` 25,321 → 25,360(測定 25,360。上の Fixed の文の分)。上限は変えていない
|
|
45
|
+
|
|
7
46
|
## [0.30.3] - 2026-11-01
|
|
8
47
|
|
|
9
48
|
診断の不具合を直すパッチ版です。あわせて、0.30.2 の後に main で整えた決定の文書・規約・CI を含みます。カレンダー・スケジュールの判定の結果は変わりません。
|
|
@@ -787,7 +826,9 @@
|
|
|
787
826
|
|
|
788
827
|
- 日本: 2026 年 2 月の官報(2027 年の春分・秋分の日)まで反映(`dataVersion: "2026-02"`、`confirmedThrough: 2027`)
|
|
789
828
|
|
|
790
|
-
[Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.
|
|
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
|
|
831
|
+
[0.30.4]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.3...v0.30.4
|
|
791
832
|
[0.30.3]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.2...v0.30.3
|
|
792
833
|
[0.30.2]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.1...v0.30.2
|
|
793
834
|
[0.30.1]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.0...v0.30.1
|
package/dist/core/diagnose.js
CHANGED
|
@@ -402,8 +402,10 @@ function analyze(c, compiled, isCalendar) {
|
|
|
402
402
|
if (businessDayBased && rule.basis === null) {
|
|
403
403
|
const weekly = recurring.find((r) => r.weekday !== null && r.nth === null && r.interval === null && r.months === null);
|
|
404
404
|
if (weekly) {
|
|
405
|
-
c.info("counting-basis", rule.path,
|
|
406
|
-
|
|
405
|
+
c.info("counting-basis", rule.path, weekly.value === true
|
|
406
|
+
? `The business days are counted without recurring rules, so the days opened by the weekday rule ${weekly.path} are not counted`
|
|
407
|
+
: `The business days are counted without recurring rules, so the weekday rule ${weekly.path} does not reduce the count; ` +
|
|
408
|
+
"write regular closed weekdays as closedWeekdays if they should not be counted", weekly.path);
|
|
407
409
|
}
|
|
408
410
|
}
|
|
409
411
|
const k = recurring.findIndex((r, i) => i < j &&
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "bizdays-toolkit",
|
|
3
|
-
"version": "0.30.
|
|
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",
|
|
@@ -71,6 +71,7 @@
|
|
|
71
71
|
"typecheck": "tsc --noEmit",
|
|
72
72
|
"lint": "oxlint --deny-warnings src scripts test",
|
|
73
73
|
"test": "node --import ./scripts/strict-warnings.ts --test \"test/**/*.test.ts\"",
|
|
74
|
+
"test:oracle": "node --import ./scripts/strict-warnings.ts --test test/diagnose-oracle.test.ts",
|
|
74
75
|
"test:tz": "node scripts/test-tz.ts",
|
|
75
76
|
"test:compat": "node --test test/compat/esm.test.mjs test/compat/cjs.test.cjs",
|
|
76
77
|
"bench": "node scripts/bench.ts",
|