bizdays-toolkit 0.30.5 → 0.30.7

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
@@ -4,6 +4,72 @@
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ ## [0.30.7] - 2026-11-05
8
+
9
+ テスト拡充案の第 3 段です。0.30.6 の取り込みで持ち越した項目を片付け、そこで見つけた診断の不具合を 2 つ直したので、公開物の `.js` は 0.30.6 から変わります(Fixed。変わるのは `./diagnose` だけで、カレンダー・スケジュールの判定の結果は変わりません)。テストと道具では、変形しても結果が同じことの検査、文書の例と文章の主張の検査、オラクルの完全性を失敗にする切り替えを入れ、設定の結果の差分の旧名の比較の穴を直しました。設定の結果の差分の定期実行(テスト拡充案の T8)は入れず、手動の広い比較として入れました。自前の変異テスト(T9)は、0.31.0 の診断の作り直しの前に行います。
10
+
11
+ ### Fixed
12
+
13
+ - 診断: スケジュールの第 n 営業日の規則の基準のカレンダー(`calendar`)が投げる月(判定できない月)がある設定で、判定できない月の影響を受けない診断まで取り除いていた。例: シンガポールの祝日(2020〜2027 年)の基準のカレンダーを持つ規則 `{ businessDayOfMonth: 1, calendar, value }` と、当てはまる日がない規則 `{ dayOfMonth: 31, months: [2], value }` を並べた設定で、後の規則の `never-matches` が出なかった(後の規則だけの設定では出る)。0.30.6 の Fixed の 3 件目(判定できない月の扱い)の取りこぼしで、0.30.5 以前はこの設定で誤った `error` の `out-of-range` を出していた。診断の結果が増える向きの修正。項目は診断の `path` の先頭が規則の位置と一致するもので引き(規則の中のオプションの位置も同じ規則に当たる)、基準のカレンダーを持たない繰り返しの規則の `never-matches` と、その規則の中のオプションの診断は、規則の形と設定だけで決まるので残す。規則そのものの `redundant` は、取り除いた設定と元の設定の結果を比べるので、ほかの規則の基準のカレンダーにも依存し、今までどおり有効期間に判定できない月があれば出さない。旧名のキー(`recurring`・`day` など)で書いても、規則どうしの診断の `path` は新しい名前で出る(API どうしの整合の検査の持ち越しを調べて見つけた。種類は API どうしの食い違い)
14
+ - 診断: 週の第 n 営業日の規則(`businessDayOfWeek`)で、月をまたぐ週の隣の月が判定できない月のとき、規則の有効期間がその月にかからなければ `never-matches` などを出していた。例: シンガポールの祝日の基準のカレンダーで `{ businessDayOfWeek: 3, weekStart: 1 }` を 2020-01-01〜2020-01-05 に当てると、2019-12-30 から始まる週の 2019 年の日を数えられないのに、`never-matches` を出していた(実際の第 3 営業日は 2020-01-02)。逆向きの例: `{ businessDayOfWeek: -1, weekStart: 3 }` を 2027-12-27〜2027-12-31 に当て、同じ値で 12 月 31 日を決める基準のない規則と並べると、2027-12-29 から始まる週の最後の営業日(2028 年 1 月の祝日次第で、シンガポールの 2028 年の祝日はまだ発表されていない。祝日がなければ 2028-01-04)を 2027-12-31 と数え、後の規則に誤った `redundant` を出していた。週の第 n 営業日の規則では、投げた月の前の月と次の月も判定できない月にする(安全側の扱いなので、隣の月の確かな診断も出さなくなる場合がある)。月の第 n 営業日の規則はその月の基準だけで決まるので、前後の月は記録しない。これも 0.30.6 の Fixed の 3 件目の取りこぼし(0.30.6 の取り込みで見つけた。種類は API どうしの食い違い)
15
+
16
+ ### 開発
17
+
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 とみなさないことをテストで確かめる
24
+ - ガイド(英日)の「対応年の外」: スケジュールの第 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`)を書き足した(コードにだけあった決まり)
28
+ - `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 の直しで関数を移した後も古いままだったので直した
39
+
40
+ ## [0.30.6] - 2026-11-02
41
+
42
+ テスト拡充案の第 2 段です。失敗を注入した祝日の提供元と API どうしの整合の検査で見つけた不具合を 3 つ(判定 1・診断 2)直したので、公開物の `.js` は 0.30.5 から変わります(Fixed)。合成したカレンダーの既知の不具合(0.31.0 で直す)を文書に書きました。
43
+
44
+ ### Fixed
45
+
46
+ - `holidayPolicy: "ignore"` で、祝日に従属する規則(`holiday`・`dayAfterHoliday`・`dayBeforeHoliday`・`"after-holiday"`)も祝日の上で先に判定する規則(`"over-holiday"`)もない設定で、`unconfirmedHolidayPolicy: "throw"` のとき、営業日の判定・第 n 営業日の数え方・探索(`isBusinessDay`・`valueOn`・`addBusinessDays` など。スケジュールから作ったカレンダーも)が未確定の祝日で `unconfirmed-holiday` を投げていた。そのような設定の結果は祝日に依存せず、ガイドは「結果は変わらない」、設定の診断もその `unconfirmedHolidayPolicy` を `redundant`(効き目がない)と言っているので、文書と診断に合わせてコードを直す。複数のマイナー版を経た挙動だが、投げていた判定が投げなくなる向きの修正で、結果の値は変わらない。`dayInfoOn`・`daysBetween` は `holiday` を付けるために祝日を引くので、今までどおり投げる。対応年の外(`out-of-range`)と提供元のデータの誤り(`invalid-provider-data`)は、今までどおり投げる(失敗を注入した祝日の提供元のテストで見つけた。種類は例外の経路の未検証)
47
+ - 診断: `holidayPolicy: "ignore"` で祝日の上で先に判定する規則(`"over-holiday"`)がある設定でも、`unconfirmedHolidayPolicy: "throw"` を `redundant`(結果に影響しない)と出していた。祝日の日だけ `"over-holiday"` の規則が先に判定されるので、そのような設定の結果は祝日に依存し、`"throw"` は判定を投げさせる。「結果が祝日に依存しない設定」の判定を 1 つの関数にまとめ、判定(未確定の祝日で投げるか)と診断(`redundant` か)の両方がそれを使うようにした。誤った診断を直す修正で、判定の結果は変わらない(上の修正の条件を決めるときに見つけた。診断が `redundant` と出した設定で `"throw"` を `"accept"` に変えても全日の判定が変わらないことを、目録の設定で確かめるテストを足した。種類は正解と突き合わせる仕組みの不足)
48
+ - 診断: スケジュールの第 n 営業日の規則の数える基準のカレンダー(`calendar`)が投げる月(対応年の外、`unconfirmedHolidayPolicy: "throw"` の未確定の祝日)を、診断が誤って `error`・`never-matches` にしていた。`createSchedule` は成功し、基準のカレンダーが投げない月の判定も投げないのに、対応年が診断の走査の範囲(提供元のないスケジュールの 2001 年からの周期や、規則の形を調べる代表の 28 年間)を覆わない基準(同梱のシンガポール(2020 年〜)など)では `error` の `out-of-range`(`path` は `holidayProvider`)を、未確定の祝日で投げる基準では `error` の `invalid-provider-data` を出していた。診断は、基準のカレンダーを評価して投げた月だけを「判定できない月」として扱い(その月は規則が当てはまらないとみなす)、有効期間に判定できない月がある項目には `never-matches`・`redundant` を出さないようにした(分からないことは言わない)。`shadowed` は規則の形だけで決まり、基準のカレンダーを評価しないので、今までどおり出す。範囲を前もって計算しないので、合成したカレンダーなどの基準でも、基準のカレンダーが判定できる月は今までどおり診断する。誤った診断をなくす修正で、判定の結果は変わらない(result-compare の意図した差分 `schedule-counting-basis-narrower-than-scan` に登録した)。提供元のないスケジュールに提供元のある基準のカレンダーを使う設定の判定が、基準のカレンダーの対応年の外の月で投げることをガイドの「対応年の外」に書いた(診断で知らせるかは 0.31.0 以降で判断する)(API どうしの整合の検査で見つけた。取り込みで見つかった、合成した基準での誤った never-matches の退行もあわせて直した。種類は API どうしの食い違い)
49
+
50
+ ### 既知の不具合
51
+
52
+ - 合成したカレンダーの営業日の判定(`isBusinessDay` や探索)は、`open: "all"` では先のカレンダーが休業日、`open: "any"` では先のカレンダーが営業日と決めた時点で後のカレンダーを判定しないので、後のカレンダーが投げる日(未確定の祝日・提供元の誤りなど)でも投げないことがある(並び順で変わる)。ガイドの「合成したカレンダーは、どれかのカレンダーが投げるなら投げます」から外れる。直すと新たに投げる判定ができるので、0.31.0(マイナー版)で直す。ガイドの該当の箇条に注を足し、確かめるテストは `todo` にした
53
+
54
+ ### 開発
55
+
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` にした
71
+ - `RELEASING.md`: オラクルと生成範囲の行を実装と 1 文ずつ突き合わせ、消えていた「タイムゾーンを変えた実行では、オラクルと日本の全範囲の走査を飛ばす」を戻し、組み合わせの一覧の検査・カナリアの理由の確認・0 件の検査・`ORACLE_SHARD` の条件・CI の実測の時間を書いた
72
+
7
73
  ## [0.30.5] - 2026-11-01
8
74
 
9
75
  0.30.4 の品質基盤の補修です。公開物の `.js` は 0.30.4 と同じです。0.30.4 で、品質基盤が「動いているように見えて、実は見ていない」箇所と、乱数のテストの生成範囲が縮んだ箇所が見つかったので、それだけを直しました。テスト拡充案の段の番号を 1 つずつずらし、第 2 段は 0.30.6、第 3 段は 0.30.7 で出します。
@@ -826,7 +892,9 @@
826
892
 
827
893
  - 日本: 2026 年 2 月の官報(2027 年の春分・秋分の日)まで反映(`dataVersion: "2026-02"`、`confirmedThrough: 2027`)
828
894
 
829
- [Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.5...HEAD
895
+ [Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.7...HEAD
896
+ [0.30.7]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.6...v0.30.7
897
+ [0.30.6]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.5...v0.30.6
830
898
  [0.30.5]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.4...v0.30.5
831
899
  [0.30.4]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.3...v0.30.4
832
900
  [0.30.3]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.2...v0.30.3
@@ -405,7 +405,7 @@ export function createCalendarFromSchedule(schedule, isOpen, options) {
405
405
  if (!Number.isInteger(searchDayLimit) || searchDayLimit < 1) {
406
406
  throw rangeError("invalid-option", "searchDayLimit must be a positive integer");
407
407
  }
408
- const open = (date) => isOpen(info(date).value) === true;
408
+ const open = (date) => isOpen(schedule.valueOn(date)) === true;
409
409
  return buildCalendar(schedule, open, (date) => {
410
410
  const day = info(date);
411
411
  return dayInfoFromScheduleDay(day, isOpen(day.value) === true, true);
@@ -27,8 +27,8 @@
27
27
  */
28
28
  import { type DateString } from "./date.ts";
29
29
  import { type CalendarOptions } from "./calendar.ts";
30
- import { type KnownErrorCode } from "./errors.ts";
31
- import { type ScheduleOptions } from "./schedule.ts";
30
+ import { IssueCollector, type KnownErrorCode } from "./errors.ts";
31
+ import { type CompiledSchedule, type ScheduleOptions } from "./schedule.ts";
32
32
  /**
33
33
  * 診断の重さ。
34
34
  * - "error": 作成すると例外になる誤り
@@ -76,6 +76,32 @@ export interface Diagnostic {
76
76
  /** 関係する別の位置(shadowed では覆っている先の規則、out-of-range では祝日の提供元) */
77
77
  readonly relatedPath?: string;
78
78
  }
79
+ interface Range {
80
+ readonly from: number;
81
+ readonly to: number;
82
+ }
83
+ interface Window {
84
+ readonly ranges: readonly Range[];
85
+ readonly label: string;
86
+ }
87
+ /**
88
+ * 規則どうしの診断(redundant など)が調べる期間。analyzeRules が使う。テストのオラクル(test/diagnose-oracle.test.ts)も、
89
+ * 診断と同じ期間で「取り除いても結果が変わらない」かを確かめるために、同じ関数を使う
90
+ * @internal
91
+ */
92
+ export declare function rulesScanWindow(compiled: Pick<CompiledSchedule<unknown, string>, "source" | "annual" | "recurring">, cycle?: number): Window | undefined;
93
+ /**
94
+ * @internal 判定できない月がある設定で、never-matches・redundant のうち、判定できない月の影響を受けうるものを取り除く。
95
+ * 診断の項目は、path の先頭が規則の位置(規則の path)と一致するもので引く(規則の中のオプションの位置も同じ規則に当たる)。
96
+ *
97
+ * - 基準のカレンダーを持たない繰り返しの規則の never-matches と、その規則の中のオプションの診断は、規則の形と設定だけで
98
+ * 決まり、基準のカレンダーを評価しないので残す
99
+ * - それ以外は、その項目の有効期間(個別の日付はその期間。期間を持たない項目は全期間)に判定できない月があれば取り除く。
100
+ * redundant は、取り除いた設定と元の設定の結果を比べるので、ほかの規則の基準のカレンダーの評価にも依存する。
101
+ * 項目の有効期間の日がすべて判定できるなら、その日の比較は確かなので出す
102
+ * - 規則に当たらない path の診断は取り除く
103
+ */
104
+ export declare function dropUnsure<Value, Kind extends string>(c: IssueCollector, from: number, compiled: CompiledSchedule<Value, Kind>, unknownMonths: ReadonlySet<number>): void;
79
105
  /** 診断を実行する。祝日の提供元の誤り(年ごとに初めて使うときに分かる)も error として返す */
80
106
  /**
81
107
  * 診断のオプション(第 2 引数)。
@@ -104,3 +130,4 @@ export declare function diagnoseCalendar(options?: CalendarOptions | object, dia
104
130
  * @public
105
131
  */
106
132
  export declare function diagnoseSchedule(options: ScheduleOptions<unknown> | object, diagnoseOptions?: DiagnoseOptions): readonly Diagnostic[];
133
+ export {};
@@ -2,7 +2,7 @@ import { lengthOfMonth, fromDayNumber, isValidDate, parseDate, toDayNumber, week
2
2
  import { compileCalendarOptions } from "./calendar.js";
3
3
  import { IssueCollector, rangeError } from "./errors.js";
4
4
  import { RENAMED_KEYS, RENAMED_VALUES } from "./renamed.js";
5
- import { compileScheduleOptions, createBasis, createHolidayLookup, createResolver, inPeriod, jpUsage, matchMonthDay, matchPattern, } from "./schedule.js";
5
+ import { compileScheduleOptions, createBasis, createHolidayLookup, createResolver, inPeriod, jpUsage, matchMonthDay, matchPattern, isHolidayBasedRule, resultIgnoresHolidays, } from "./schedule.js";
6
6
  function editDistance(a, b) {
7
7
  const d = Array.from({ length: a.length + 1 }, (_, i) => Array.from({ length: b.length + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
8
8
  for (let i = 1; i <= a.length; i++) {
@@ -115,6 +115,9 @@ function scanWindow(source, rules, cycle) {
115
115
  const label = merged.map((r) => `${yearOf(r.from)}-${yearOf(r.to)}`).join(", ");
116
116
  return { ranges: merged, label };
117
117
  }
118
+ export function rulesScanWindow(compiled, cycle = patternCycle(compiled.recurring)) {
119
+ return scanWindow(compiled.source, [...compiled.annual, ...compiled.recurring], cycle);
120
+ }
118
121
  function eachDay(window, fn) {
119
122
  for (const { from, to } of window.ranges) {
120
123
  for (let n = from; n <= to; n++)
@@ -240,7 +243,86 @@ function checkProviderData(c, source) {
240
243
  });
241
244
  return ok;
242
245
  }
243
- function analyze(c, compiled, isCalendar) {
246
+ const UNJUDGEABLE = new Set(["out-of-range", "unconfirmed-holiday"]);
247
+ function guardBases(compiled, unknownMonths) {
248
+ if (!compiled.recurring.some((r) => r.basis !== null && r.calendar !== null))
249
+ return compiled;
250
+ return {
251
+ ...compiled,
252
+ recurring: compiled.recurring.map((r) => {
253
+ const basis = r.basis;
254
+ if (basis === null || r.calendar === null)
255
+ return r;
256
+ return {
257
+ ...r,
258
+ basis: (year, month) => {
259
+ try {
260
+ return basis(year, month);
261
+ }
262
+ catch (error) {
263
+ if (!UNJUDGEABLE.has(String(error.code)))
264
+ throw error;
265
+ const thrown = year * 12 + month - 1;
266
+ unknownMonths.add(thrown);
267
+ if (r.weekStart !== null) {
268
+ unknownMonths.add(thrown - 1);
269
+ unknownMonths.add(thrown + 1);
270
+ }
271
+ return [];
272
+ }
273
+ },
274
+ };
275
+ }),
276
+ };
277
+ }
278
+ const UNSURE_CODES = new Set(["never-matches", "redundant"]);
279
+ export function dropUnsure(c, from, compiled, unknownMonths) {
280
+ const monthOf = (day) => {
281
+ const { year, month } = parseDate(fromDayNumber(day));
282
+ return year * 12 + month - 1;
283
+ };
284
+ const overlaps = (start, end) => {
285
+ const a = start === null ? -Infinity : monthOf(start);
286
+ const b = end === null ? Infinity : monthOf(end);
287
+ for (const m of unknownMonths)
288
+ if (m >= a && m <= b)
289
+ return true;
290
+ return false;
291
+ };
292
+ const items = [
293
+ ...compiled.dates,
294
+ ...compiled.annual,
295
+ ...compiled.recurring,
296
+ ];
297
+ const isRecurring = (r) => compiled.recurring.includes(r);
298
+ const isDate = (r) => compiled.dates.includes(r);
299
+ const unsure = (code, path) => {
300
+ const item = items.find((r) => path === r.path || path.startsWith(`${r.path}.`));
301
+ if (item === undefined)
302
+ return true;
303
+ if (isRecurring(item) &&
304
+ item.calendar === null &&
305
+ (code === "never-matches" || path !== item.path))
306
+ return false;
307
+ if (isDate(item))
308
+ return overlaps(item.from, item.to);
309
+ return overlaps(item.effectiveFrom, item.effectiveTo);
310
+ };
311
+ const kept = c.issues
312
+ .slice(from)
313
+ .filter((d) => !(UNSURE_CODES.has(d.code) && unsure(d.code, d.path)));
314
+ c.issues.length = from;
315
+ c.issues.push(...kept);
316
+ }
317
+ function analyze(c, original, isCalendar) {
318
+ const unknownMonths = new Set();
319
+ const compiled = guardBases(original, unknownMonths);
320
+ const from = c.issues.length;
321
+ analyzeRules(c, compiled, isCalendar);
322
+ if (unknownMonths.size > 0)
323
+ dropUnsure(c, from, compiled, unknownMonths);
324
+ }
325
+ function analyzeRules(c, compiled, isCalendar) {
244
326
  const { source, dates, annual, recurring } = compiled;
245
327
  if (!checkProviderData(c, source))
246
328
  return;
@@ -251,7 +333,7 @@ function analyze(c, compiled, isCalendar) {
251
333
  });
252
334
  const basis = createBasis(compiled, lookup);
253
335
  const cycle = patternCycle(recurring);
254
- const window = scanWindow(source, [...annual, ...recurring], cycle);
336
+ const window = rulesScanWindow(compiled, cycle);
255
337
  const unused = new Set();
256
338
  dates.forEach((rule, j) => {
257
339
  const fromYear = yearOf(rule.from);
@@ -358,7 +440,7 @@ function analyze(c, compiled, isCalendar) {
358
440
  [...a.skipWeekdays].every((w) => b.skipWeekdays.has(w));
359
441
  recurring.forEach((rule, j) => {
360
442
  const bits = recurringBits[j];
361
- const holidayBased = rule.holiday || rule.dayAfterHoliday || rule.dayBeforeHoliday;
443
+ const holidayBased = isHolidayBasedRule(rule);
362
444
  const businessDayBased = rule.businessDays !== null;
363
445
  const matches = holidayBased
364
446
  ? holidayRuleMatches(rule)
@@ -617,16 +699,12 @@ function checkUnconfirmedOption(c, compiled) {
617
699
  if (compiled.source.unconfirmedHolidayPolicy !== "throw")
618
700
  return;
619
701
  const noProvider = compiled.source.providers.length === 0;
620
- const holidayUnused = compiled.holiday === "ignore" &&
621
- !compiled.recurring.some((r) => r.holiday ||
622
- r.dayAfterHoliday ||
623
- r.dayBeforeHoliday ||
624
- r.holidayOverlapPolicy === "after-holiday");
702
+ const holidayUnused = resultIgnoresHolidays(compiled);
625
703
  if (!noProvider && !holidayUnused)
626
704
  return;
627
705
  c.info("redundant", "unconfirmedHolidayPolicy", noProvider
628
706
  ? 'unconfirmedHolidayPolicy: "throw" has no effect: there is no holiday provider'
629
- : `unconfirmedHolidayPolicy: "throw" has no effect on results: holidays are not used (holidayPolicy: "ignore" and no holiday-based rule); dayInfoOn still throws when it looks up the holiday to report`);
707
+ : `unconfirmedHolidayPolicy: "throw" has no effect on results: holidays are not used (holidayPolicy: "ignore" and no holiday-based, "after-holiday" or "over-holiday" rule); dayInfoOn still throws when it looks up the holiday to report`);
630
708
  }
631
709
  function run(c, compiled, isCalendar, asOf) {
632
710
  if (compiled && !c.hasErrors) {
@@ -714,7 +714,8 @@ export declare function jpUsage(source: HolidaySource<string>): JpUsage;
714
714
  export declare function compileHolidaySource<Kind extends string>(c: IssueCollector, options: Record<string, unknown>): HolidaySource<Kind>;
715
715
  /** @internal 祝日を調べる機能を作る(設定は検証済みであること) */
716
716
  export declare function createHolidayLookup<Kind extends string>(source: HolidaySource<Kind>): HolidayLookup<Kind> & {
717
- holidayOfDate(date: DateString): Holiday<Kind> | undefined;
717
+ /** allowUnconfirmed なら、未確定の祝日でも unconfirmedHolidayPolicy: "throw" で投げない(結果が祝日に依存しない判定) */
718
+ holidayOfDate(date: DateString, allowUnconfirmed?: boolean): Holiday<Kind> | undefined;
718
719
  fromJp: FromJp;
719
720
  };
720
721
  /** @internal 検証済みのスケジュールの規則 */
@@ -744,11 +745,32 @@ export interface Resolution<Value, Kind extends string> {
744
745
  readonly rule: DecidingRule<Value> | null;
745
746
  }
746
747
  type HolidayLookupInternal<Kind extends string> = ReturnType<typeof createHolidayLookup<Kind>>;
748
+ /** @internal 祝日に従属する規則か(祝日・祝日の翌日・祝前日。祝日を見て当てはまるかが決まる) */
749
+ export declare const isHolidayBasedRule: (rule: {
750
+ readonly holiday?: boolean;
751
+ readonly dayAfterHoliday?: boolean;
752
+ readonly dayBeforeHoliday?: boolean;
753
+ }) => boolean;
754
+ /**
755
+ * @internal 結果が祝日に依存しない設定か。祝日の扱いが "ignore" で、祝日に従属する規則(isHolidayBasedRule)も、
756
+ * 祝日に当たると振り替える規則("after-holiday")も、祝日の日だけ先に判定する規則("over-holiday")もないとき、
757
+ * 祝日の日と祝日でない日の判定は同じになる。判定(未確定の祝日で投げるか。createResolver)と、設定の診断
758
+ * (unconfirmedHolidayPolicy: "throw" が redundant か)の両方がこの関数を使う
759
+ */
760
+ export declare function resultIgnoresHolidays(compiled: {
761
+ readonly holiday: unknown;
762
+ readonly recurring: readonly {
763
+ readonly holiday?: boolean;
764
+ readonly dayAfterHoliday?: boolean;
765
+ readonly dayBeforeHoliday?: boolean;
766
+ readonly holidayOverlapPolicy?: string;
767
+ }[];
768
+ }): boolean;
747
769
  /**
748
770
  * @internal 検証済みの規則から、1 日分の値と値を決めた規則を返す関数を作る。
749
771
  * 規則の診断では、規則を取り除いた版と結果を比べるために、祝日を調べる機能(lookup)を共有して作る
750
772
  */
751
- export declare function createResolver<Value, Kind extends string>(compiled: CompiledSchedule<Value, Kind>, lookup: HolidayLookupInternal<Kind>): (date: DateString) => Resolution<Value, Kind>;
773
+ export declare function createResolver<Value, Kind extends string>(compiled: CompiledSchedule<Value, Kind>, lookup: HolidayLookupInternal<Kind>): (date: DateString, withHoliday?: boolean) => Resolution<Value, Kind>;
752
774
  /** @internal 期間(両端を含む)の日ごとに fn を呼んだ結果。from が to より後ならエラー */
753
775
  export declare function mapDays<R>(from: DateString, to: DateString, fn: (date: DateString) => R): readonly R[];
754
776
  /** @internal スケジュールの内部の判定を取り出す(createSchedule が作ったものでなければ undefined) */
@@ -618,7 +618,7 @@ export function createBasis(compiled, lookup) {
618
618
  if (!compiled.recurring.some((r) => r.businessDays !== null && r.basis === null))
619
619
  return undefined;
620
620
  const resolve = createResolver({ ...compiled, recurring: [] }, lookup);
621
- return basisFromPredicate((date) => resolve(date).day.value === true);
621
+ return basisFromPredicate((date) => resolve(date, false).day.value === true);
622
622
  }
623
623
  function requiredValue(c) {
624
624
  return (entry, path) => {
@@ -824,11 +824,14 @@ export function createHolidayLookup(source) {
824
824
  }
825
825
  return map;
826
826
  }
827
- function holidayOfDate(date) {
827
+ function holidayOfDate(date, allowUnconfirmed = false) {
828
828
  if (providers.length === 0)
829
829
  return undefined;
830
830
  const h = holidayMap(parseDate(date).year).get(date);
831
- if (h !== undefined && unconfirmedHolidayPolicy === "throw" && !h.confirmed) {
831
+ if (h !== undefined &&
832
+ !allowUnconfirmed &&
833
+ unconfirmedHolidayPolicy === "throw" &&
834
+ !h.confirmed) {
832
835
  const year = parseDate(date).year;
833
836
  const provider = providers.find((p) => year >= p.supportedYears.from &&
834
837
  year <= p.supportedYears.to &&
@@ -971,9 +974,17 @@ export function matchMonthDay(rule, monthDay) {
971
974
  export function matchAnnual(rule, date) {
972
975
  return inPeriod(rule, toDayNumber(date)) && matchMonthDay(rule, date.slice(5));
973
976
  }
977
+ export const isHolidayBasedRule = (rule) => rule.holiday === true || rule.dayAfterHoliday === true || rule.dayBeforeHoliday === true;
978
+ export function resultIgnoresHolidays(compiled) {
979
+ return (compiled.holiday === "ignore" &&
980
+ !compiled.recurring.some((r) => isHolidayBasedRule(r) ||
981
+ r.holidayOverlapPolicy === "after-holiday" ||
982
+ r.holidayOverlapPolicy === "over-holiday"));
983
+ }
974
984
  export function createResolver(compiled, lookup) {
975
985
  const { weekly, holiday: holidayRule, annual, dates, recurring } = compiled;
976
986
  const hasShift = recurring.some((r) => r.holidayOverlapPolicy === "after-holiday");
987
+ const holidayUnused = resultIgnoresHolidays(compiled);
977
988
  const basis = createBasis(compiled, lookup);
978
989
  const holidayOfNeighbour = (date) => lookup.holidayOfDate(date);
979
990
  const isHolidayOfNeighbour = (date) => holidayOfNeighbour(date) !== undefined;
@@ -987,10 +998,10 @@ export function createResolver(compiled, lookup) {
987
998
  }
988
999
  return undefined;
989
1000
  }
990
- return function resolve(date) {
1001
+ return function resolve(date, withHoliday = true) {
991
1002
  const dayNumber = toDayNumber(date);
992
1003
  const weekday = weekdayOf(date);
993
- const holiday = lookup.holidayOfDate(date);
1004
+ const holiday = lookup.holidayOfDate(date, holidayUnused && !withHoliday);
994
1005
  const make = (value, reason, rule, name, shiftedFrom) => {
995
1006
  const result = {
996
1007
  date,
@@ -1077,7 +1088,7 @@ export function buildSchedule(compiled) {
1077
1088
  getHoliday: lookup.holidayOn,
1078
1089
  holidaysInYear: lookup.holidaysInYear,
1079
1090
  holidaysBetween: lookup.holidaysBetween,
1080
- valueOn: (input) => info(lookup.dateOf(input)).value,
1091
+ valueOn: (input) => resolve(lookup.dateOf(input), false).day.value,
1081
1092
  dayInfoOn: (input) => info(lookup.dateOf(input)),
1082
1093
  dayInfo: (input) => info(lookup.dateOf(input)),
1083
1094
  daysBetween: (from, to) => mapDays(lookup.dateOf(from), lookup.dateOf(to), info),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bizdays-toolkit",
3
- "version": "0.30.5",
3
+ "version": "0.30.7",
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",
@@ -77,7 +77,7 @@
77
77
  "bench": "node scripts/bench.ts",
78
78
  "fmt": "oxfmt",
79
79
  "fmt:check": "oxfmt --check",
80
- "check": "node scripts/check-toolchain.ts && pnpm typecheck && pnpm lint && pnpm test && pnpm test:tz && pnpm build && pnpm test:compat && node scripts/check-readme-examples.ts && node scripts/check-consumer-types.ts && pnpm fmt:check && node scripts/check-package.ts && node scripts/check-size.ts && node scripts/check-names.ts && node scripts/api-report.ts",
80
+ "check": "node scripts/check-toolchain.ts && pnpm typecheck && pnpm lint && pnpm test && pnpm test:tz && pnpm build && pnpm test:compat && node scripts/check-readme-examples.ts && node scripts/check-consumer-types.ts && pnpm fmt:check && node scripts/check-package.ts && node scripts/check-size.ts && node scripts/check-names.ts && node scripts/check-claims.ts && node scripts/api-report.ts",
81
81
  "verify:cao": "node scripts/verify-cao.ts",
82
82
  "verify:govuk": "node scripts/verify-govuk.ts",
83
83
  "verify:datagovsg": "node scripts/verify-datagovsg.ts",