bizdays-toolkit 0.30.2 → 0.30.4

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,57 @@
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ ## [0.30.4] - 2026-11-01
8
+
9
+ 品質基盤の整備の第 1 段(正解の定義)です。規則と設定の目録と、診断の総当たりのオラクルを入れました。オラクルで見つけた診断の文の誤りを 1 つ直しました(判定の結果は変わりません)。
10
+
11
+ ### Fixed
12
+
13
+ - 診断: 第 n 営業日の規則と、毎週の曜日を開く繰り返しの規則がある設定で、`counting-basis` の文が「その曜日の規則は数を減らさない」と、閉じる規則のときの説明をしていた。開く規則のときは「その規則が開いた日は数えない」と説明する。メッセージは API ではないので、診断の `code`・`path` は変わらない(総当たりのオラクルで約束を確かめるときに見つけた。種類は文章の主張の未検証)
14
+
15
+ ### 開発
16
+
17
+ - 規則と設定の目録 `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` を見逃した種類)
18
+ - `test/properties.test.ts` のカレンダーに、目録の繰り返しの規則を入れた(これまでは繰り返しの規則のないカレンダーだけを試していた)。営業日のないカレンダーになった試行は、性質の前提を満たさないので飛ばす(1 割まで)
19
+ - `test/diagnose-properties.test.ts` は、対応年の短い自作の提供元(`test/support/provider.ts`)で全日を比べる(400 日の抜き出しをやめた)
20
+ - 診断の総当たりのオラクル `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` を検出する(正解と突き合わせる仕組みの不在の穴を塞ぐ)
21
+ - `scripts/test-tz.ts`: タイムゾーンを変えた実行では、オラクルを飛ばす(暦日だけで決まるので)
22
+ - `RELEASING.md`: 品質の確認に目録とオラクルを足し、手元の確認は前の版のタグを読める状態で通すことを書いた
23
+ - サイズ(gzip): `./diagnose` 25,321 → 25,360(測定 25,360。上の Fixed の文の分)。上限は変えていない
24
+
25
+ ## [0.30.3] - 2026-11-01
26
+
27
+ 診断の不具合を直すパッチ版です。あわせて、0.30.2 の後に main で整えた決定の文書・規約・CI を含みます。カレンダー・スケジュールの判定の結果は変わりません。
28
+
29
+ ### Fixed
30
+
31
+ - 診断: 営業日カレンダーの繰り返しの規則(閉じる・開くの両方)に第 n 営業日の規則(`businessDayOfMonth`・`businessDayOfWeek`)がある設定で、数え方を変える個別の日付・毎年の月日(とそれに関わる規則)を、取り除くと同じ月・週の別の日の結果が変わるのに `redundant` としていた。`docs/decisions.md` の 16 番(第 n 営業日を数える基準には個別の日付と毎年の月日が入る)から外れていた、0.30.2 以前からある不具合。取り除いて変わりうる月・週の日をすべて調べ、規則の判定の基準にも個別の日付を残すようにした。判定できない日は、取り除ける側に倒さない(31 番)。これまでは規則どうしの診断の途中で判定が例外になると、その結果を捨てて祝日の提供元の誤り(`invalid-provider-data` など)として報告していたが、その項目を `redundant` にしないで診断を続けるようにした(判定が例外になる設定は、手元では作れていない)。該当する設定では診断の結果から `redundant` が減るので、診断の結果を `deepEqual` で比べているテストは期待値が変わることがある。減ったのは取り除くと結果が変わる項目なので、新しい結果を期待値にする。入った版を問わず不具合の修正はパッチ、という規約(`RELEASING.md` の「区分」)の最初の適用
32
+
33
+ ### Changed
34
+
35
+ - 旧名を受け付ける期間を「0.30.x の間」と書いていた箇所(決定の文書の 10・37 番、`RELEASING.md` の設定の結果の差分の行、移行ガイド、テストとスクリプトのコメント)を「1.0.0 より前の版」に直した。0.31.0 以降のマイナー版でも旧名は受け付け、1.0.0 で `invalid-option` にする(移行ガイドの冒頭の「1.0.0 まで」と同じ)。長く続いた挙動の扱いで CHANGELOG に書くものを「決めた結果と理由」にそろえた
36
+ - README(英日)から npm のダウンロード数のバッジを外した(shields.io が npm の API のレート制限を受け、「rate limited by upstream service」と表示されていたため)
37
+ - `docs/decisions.md` を、時系列に並んだ 56 の番号から、話題ごとの 11 章・39 の番号に整理し直した。各決定は今の決定・理由・退けた案だけにし、版ごとの追記・提案書の番号・測定値は CHANGELOG と git の履歴に任せた。冒頭に目次と番号の付け方(番号は ID で振り直さない、新しい決定は章の中に置いて通しの番号を振る、追記を重ねず本文を書き換える)を、末尾に旧番号との対応表(残し続ける)を置いた。ソース・スクリプト・テスト・ワークフロー・文書の番号の参照を新しい番号に直した。CHANGELOG の 0.30.2 までの節の番号は旧番号のまま
38
+ - `docs/decisions.md` の整理で落ちていた決定を戻した: ウェールズ語の名称を GOV.UK のリポジトリの翻訳ファイルで照合する例外(29 番)、`src` が Node.js 固有の機能を使わない検査(35 番)、和集合の `"regular"` で退けた 2 案(10 番)と結果の比較で退けた案(37 番)、`withSubstituteDays` の定義(26 番)、スケジュールの第 n 営業日の基準と `"over-holiday"` の `redundant`(16 番)、英国の臨時の祝日の名前の付け方(28 番)、時刻を数値で受けない理由(7 番)、0.23.0〜0.29.0 を欠番にした理由(9 番)。新たに例外を投げる変更は 1.0.0 以降はメジャー版であることを 6・32 番と `RELEASING.md` に書き、旧番号の対応表の行き先の漏れを足した。あわせて、整理で省いた細部のうち決定にあたるもの(`decidedByPath`・`asOf`・ID `"JP"` の判定の細部、`Policy` の選択肢の部分集合、`?: never` の項目に TSDoc を付けないことなど)を本文に戻し、誤った `key` の修正をマイナー版、性能・サイズの改善をパッチと `RELEASING.md` の区分に書いた
39
+ - `RELEASING.md` と `docs/decisions.md` の役割を分けた: 版の区分・互換性の約束・手順・検査の一覧は `RELEASING.md` だけに書き、決定の文書の 32・33・35〜37・39 番はその理由と退けた案だけにした(同じ規則を 2 か所に書かない。36 番)。`RELEASING.md` の箇条からは理由を除き、決定の番号を指すようにした。残っていた重複(誤った `key` の直し方、提供元の内部の置き換えの条件、黙って外れる検査を作らないこと、`src` の移植性の検査)も規則を `RELEASING.md` に、理由を決定の文書に分けた
40
+ - 外部のレビューを受けて直した: 決定の文書の 27 番に 4 か国目を選んだときに見送った候補(香港・米国・ドイツ)と理由を戻した。公開から複数のマイナー版を経た挙動が文書と違うときは、直す前にコードを直す(パッチ)・文書を挙動に合わせる・マイナー版で扱うのどれにするかを決め、その結果を CHANGELOG に書くことを `RELEASING.md` の「区分」と 32 番に足した。`scripts/result-compare.ts` の冒頭のコメントを、診断の結果が誤った診断の修正で消えうるという今の約束に合わせた
41
+ - 規約を見直した(`docs/decisions.md` の 25・26・32・33・37 番、`RELEASING.md`): 約束した挙動から外れていた不具合の修正は、入った版を問わずパッチにする(これまでは直前の版で入った退行だけ)。誤った診断を直したときは、前の版の診断の結果が消えることがある。性能の比較は、正しさのために遅くなることを CHANGELOG に書いた版を通す。同梱の提供元の内部は、前の版との祝日データの比較で差分がなければ置き換えてよい。誤った祝日の `key` を直す手順を決めた
42
+ - ガイド(英日)の「0.30.0 より前に保存した設定」に 0.30.2 で足した、書き換えた後に診断を実行する例の設定が、`timeZone` を書いていないので `time-zone-conflict`(error)になっていた(日本と英国の提供元はタイムゾーンが違う)。例は `deprecated-option` だけを取り出していたので、コード例の検査は通っていた。`timeZone: "Asia/Tokyo"` と `holidayPolicy: "open"` を足し、診断の結果をすべて示す形にした(誤りがあれば例の検査で止まる)
43
+
44
+ ### 開発
45
+
46
+ - `test/diagnose.test.ts`・`test/diagnose-properties.test.ts`: 上の Fixed の 4 例(月・週の第 n 営業日、閉じる・開く規則)と、スケジュールの第 n 営業日の規則では結果が変わらないことのテストを足した。性質のテストの設定の生成に第 n 営業日の規則を足し、第 n 営業日の規則と個別の日付を必ず持つ設定の性質を足した(0.30.2 では失敗する。生成に入っていなかったので、この不具合を見逃していた)
47
+ - `scripts/result-compare.ts`: 意図した差分を、診断の消えた結果のコード(`removedCodes`)で絞れるようにした。上の Fixed の差分を、第 n 営業日の規則と個別の日付・毎年の月日を持つ設定の `redundant` が消えたものだけに絞って許す(`counting-rules-with-dates`)。上の Fixed の例を固定の設定に足した(週の第 n 営業日の例は、それがない 0.22.2 とは比べない)
48
+ - サイズの上限: `./diagnose` を 25,000 から 25,800 に上げた(上の Fixed で上限を超えたため。測定値に小さな余裕を足した値)
49
+ - サイズ(gzip): `./diagnose` 24,753 → 25,321(測定 25,321)。ルート 17,997(測定 17,997)と `./jp` 20,226(測定 20,226)は変わらない
50
+ - 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 時間を過ぎた版)
51
+ - `scripts/check-package.ts`: 決定の文書の目次が本文の章・見出しと一致すること(番号の重複も)を確かめる。CHANGELOG の 0.30.2 までの節の番号は旧番号の対応表で確かめ、`` `docs/decisions.md` の N 番 `` のようにバッククォートで囲んだ参照も確かめるようにした(これまでは見ていなかった)。「番」を書き忘れた参照(`decisions.md の 15`)は形の誤りとして止める
52
+ - `scripts/bench-compare.ts`: CHANGELOG の今の版(または [Unreleased])の「開発」に決まった言葉で理由を書いた版は、2 倍を超えて遅くなっても表に記録して合格にする(言葉は `RELEASING.md` の品質の確認の表)
53
+ - `etc/result-changes.json` に 0.30.1 の修正(和集合の旧名 `"national"`)を足した。公開済みの 0.30.0 → 0.30.1 を比べたとき、意図した修正ではなく診断の退行だけが「許していない差分」として出る
54
+
55
+ - `scripts/result-compare.ts`: 意図した差分を許す特徴を、比べた対象ごとに付けるようにした。0.30.2 では合成の組の相手の特徴まで付けていたので、相手だけが日本の提供元と `kinds: ["regular"]` を持つ組では、元のカレンダー単独の差分まで許していた。合成だけ組の両方の設定から、ほかはその設定だけから付ける。日本の提供元だけの設定の `"national"` の特徴は、同じ配列に同じ形で `"regular"` を含む規則もあるときだけ付ける(名前を `kinds-national-and-regular-with-jp-only` に改めた。前の版が 0.30.1 のときだけ効く項目)
56
+ - `test/fixtures/national-union-0.22.2.json` の出典の説明で、`"national"` の扱いの根拠を旧 55 番としていたのを旧 54 番(今の 10 番)に直した
57
+
7
58
  ## [0.30.2] - 2026-10-30
8
59
 
9
60
  0.30.0・0.30.1 の改名の後始末の続きの版です。新しい設定・関数・診断コードはありません。公開物の `.js` の挙動が変わるのは Fixed の 1 つ(診断の結果)で、カレンダー・スケジュールの判定の結果は変わりません。
@@ -754,7 +805,9 @@
754
805
 
755
806
  - 日本: 2026 年 2 月の官報(2027 年の春分・秋分の日)まで反映(`dataVersion: "2026-02"`、`confirmedThrough: 2027`)
756
807
 
757
- [Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.2...HEAD
808
+ [Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.4...HEAD
809
+ [0.30.4]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.3...v0.30.4
810
+ [0.30.3]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.2...v0.30.3
758
811
  [0.30.2]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.1...v0.30.2
759
812
  [0.30.1]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.0...v0.30.1
760
813
  [0.30.0]: https://github.com/inohan77/bizdays-toolkit/compare/v0.22.2...v0.30.0
package/README.md CHANGED
@@ -7,7 +7,6 @@
7
7
 
8
8
  <p align="center">
9
9
  <a href="https://www.npmjs.com/package/bizdays-toolkit"><img src="https://img.shields.io/npm/v/bizdays-toolkit" alt="npm version"></a>
10
- <a href="https://www.npmjs.com/package/bizdays-toolkit"><img src="https://img.shields.io/npm/d18m/bizdays-toolkit" alt="npm downloads"></a>
11
10
  <a href="https://github.com/inohan77/bizdays-toolkit/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/inohan77/bizdays-toolkit/ci.yml?branch=main&amp;label=CI" alt="CI status"></a>
12
11
  <a href="https://github.com/inohan77/bizdays-toolkit/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/bizdays-toolkit" alt="license"></a>
13
12
  <img src="https://img.shields.io/node/v/bizdays-toolkit" alt="Node.js version">
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * 祝日と、会社・店舗の休業日を組み合わせた営業日カレンダー。
3
- * 1 日の判定の優先順位は docs/guide.md の「Business-day calendars」と docs/decisions.md の 12 番。
3
+ * 1 日の判定の優先順位は docs/guide.md の「Business-day calendars」と docs/decisions.md の 11 番。
4
4
  *
5
5
  * 内部では、営業日かどうか(真偽値)を返すスケジュール(createSchedule)として作っている。
6
6
  * 営業日の探索・調整・月の営業日などの機能は buildCalendar に切り出し、作成済みのカレンダーを
@@ -35,7 +35,7 @@ import { type ScheduleOptions } from "./schedule.ts";
35
35
  * - "warning": 作れるが、意図と違う可能性が高い
36
36
  * - "info": 結果には影響しないが、整理できる
37
37
  *
38
- * 出力の列挙だが、重さの段階は増やさないため閉じた型にしている(docs/decisions.md の 15)。
38
+ * 出力の列挙だが、重さの段階は増やさないため閉じた型にしている(docs/decisions.md の 2 番)。
39
39
  * @public
40
40
  */
41
41
  export type DiagnosticSeverity = "error" | "warning" | "info";
@@ -1,4 +1,4 @@
1
- import { lengthOfMonth, fromDayNumber, isValidDate, parseDate, toDayNumber, } from "./date.js";
1
+ import { lengthOfMonth, fromDayNumber, isValidDate, parseDate, toDayNumber, weekdayOf, } from "./date.js";
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";
@@ -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, `The business days are counted without recurring rules, so the weekday rule ${weekly.path} does not reduce the count; ` +
406
- "write regular closed weekdays as closedWeekdays if they should not be counted", weekly.path);
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 &&
@@ -452,18 +454,76 @@ function analyze(c, compiled, isCalendar) {
452
454
  "searching for a business day throws");
453
455
  }
454
456
  }
455
- const redundant = (rule, base, days) => {
457
+ const counting = recurring.filter((r) => r.businessDays !== null && r.calendar === null);
458
+ const countsMonth = counting.some((r) => r.weekStart === null);
459
+ const weekStarts = [
460
+ ...new Set(counting.flatMap((r) => (r.weekStart === null ? [] : [r.weekStart]))),
461
+ ];
462
+ const countingUnits = (days) => {
463
+ const out = new Set();
464
+ for (const n of days) {
465
+ out.add(n);
466
+ if (countsMonth) {
467
+ const { year, month, day } = parseDate(fromDayNumber(n));
468
+ for (let k = 0; k < lengthOfMonth(year, month); k++)
469
+ out.add(n - day + 1 + k);
470
+ }
471
+ for (const start of weekStarts) {
472
+ const first = n - ((weekdayOf(fromDayNumber(n)) - start + 7) % 7);
473
+ for (let k = 0; k < 7; k++)
474
+ out.add(first + k);
475
+ }
476
+ }
477
+ return out;
478
+ };
479
+ const FAILED = Symbol("failed");
480
+ const originalOf = (resolve) => {
481
+ const values = new Map();
482
+ return (n) => {
483
+ if (!values.has(n)) {
484
+ let value;
485
+ try {
486
+ value = resolve(fromDayNumber(n)).day.value;
487
+ }
488
+ catch {
489
+ value = FAILED;
490
+ }
491
+ values.set(n, value);
492
+ }
493
+ return values.get(n);
494
+ };
495
+ };
496
+ const redundant = (rule, base, days, original) => {
456
497
  const resolve = createResolver(without(base, rule, false), lookup);
457
- return days.every((n) => sameValue(rule.value, resolve(fromDayNumber(n)).day.value));
498
+ for (const n of days) {
499
+ let value;
500
+ try {
501
+ value = resolve(fromDayNumber(n)).day.value;
502
+ }
503
+ catch {
504
+ value = FAILED;
505
+ }
506
+ const before = original(n);
507
+ if (value === FAILED || before === FAILED) {
508
+ if (value !== before)
509
+ return false;
510
+ }
511
+ else if (!sameValue(before, value))
512
+ return false;
513
+ }
514
+ return true;
458
515
  };
459
516
  const full = createResolver(compiled, lookup);
517
+ const originalFull = originalOf(full);
460
518
  for (const rule of dates) {
461
519
  if (unused.has(rule))
462
520
  continue;
463
521
  const decided = [];
522
+ const span = [];
464
523
  let checked = 0;
465
524
  const last = Math.min(rule.to, rule.from + MAX_DATE_RULE_DAYS - 1);
466
525
  for (let n = rule.from; n <= last; n++) {
526
+ span.push(n);
467
527
  let decidedBy;
468
528
  try {
469
529
  decidedBy = full(fromDayNumber(n)).rule;
@@ -475,7 +535,10 @@ function analyze(c, compiled, isCalendar) {
475
535
  if (decidedBy === rule)
476
536
  decided.push(n);
477
537
  }
478
- if (checked > 0 && redundant(rule, compiled, decided)) {
538
+ const ok = counting.length > 0
539
+ ? redundant(rule, compiled, countingUnits(span), originalFull)
540
+ : redundant(rule, compiled, decided, () => rule.value);
541
+ if (checked > 0 && ok) {
479
542
  c.info("redundant", rule.path, decided.length === 0
480
543
  ? "This rule is never used: earlier rules cover all of its days"
481
544
  : "Removing this rule does not change any result");
@@ -486,17 +549,35 @@ function analyze(c, compiled, isCalendar) {
486
549
  const candidates = [...annual, ...recurring].filter((r) => !unused.has(r));
487
550
  if (candidates.length === 0)
488
551
  return;
489
- const base = without(compiled, null, true);
552
+ const base = counting.length > 0 ? compiled : without(compiled, null, true);
490
553
  const resolveBase = createResolver(base, lookup);
554
+ const originalBase = originalOf(resolveBase);
491
555
  const decided = new Map(candidates.map((r) => [r, []]));
492
556
  eachDay(window, (n) => {
493
- const rule = resolveBase(fromDayNumber(n)).rule;
557
+ let rule;
558
+ try {
559
+ rule = resolveBase(fromDayNumber(n)).rule;
560
+ }
561
+ catch {
562
+ return;
563
+ }
494
564
  if (rule)
495
565
  decided.get(rule)?.push(n);
496
566
  });
567
+ const annualUnits = (rule) => {
568
+ const matched = [];
569
+ eachDay(window, (n) => {
570
+ if (matchMonthDay(rule, fromDayNumber(n).slice(5)))
571
+ matched.push(n);
572
+ });
573
+ return countingUnits(matched);
574
+ };
497
575
  for (const rule of candidates) {
498
576
  const days = decided.get(rule);
499
- if (!redundant(rule, base, days))
577
+ const ok = counting.length > 0 && annual.includes(rule)
578
+ ? redundant(rule, base, annualUnits(rule), originalBase)
579
+ : redundant(rule, base, days, () => rule.value);
580
+ if (!ok)
500
581
  continue;
501
582
  c.info("redundant", rule.path, days.length === 0
502
583
  ? `This rule is never used: other rules decide every day it matches (checked ${window.label})`
@@ -50,7 +50,7 @@ export declare function monthOf(input: DateString | MonthString, offset?: number
50
50
  export declare function closingMonth(date: DateString, closingDayOfMonth: number): MonthString;
51
51
  /** @internal 締め日の検証(closingMonth・closingPeriod・営業日カレンダーの締め日で共用) */
52
52
  export declare function checkClosingDay(closingDayOfMonth: number): void;
53
- /** @internal その月の締め日(日)。-1 またはその月の日数以上なら末日(decisions.md の 16 番の読み替えはここだけで行う) */
53
+ /** @internal その月の締め日(日)。-1 またはその月の日数以上なら末日(decisions.md の 23 番の読み替えはここだけで行う) */
54
54
  export declare function closingDayIn({ year, month }: YearMonth, closingDayOfMonth: number): number;
55
55
  /**
56
56
  * 締め日で区切ったときの、その月分の期間(両端を含む暦日)。closingMonth の逆算。
@@ -1,5 +1,5 @@
1
1
  /**
2
- * 0.30.0 で改名した設定のキーと値の表(docs/decisions.md の 54 番、docs/migration.md の 0.30.0)。
2
+ * 0.30.0 で改名した設定のキーと値の表(docs/decisions.md の 10 番、docs/migration.md の 0.30.0)。
3
3
  * 検証の入口での読み替え・診断の deprecated-option・migrate… 関数が、この表だけを使う。
4
4
  */
5
5
  import { type IssueCollector } from "./errors.ts";
@@ -23,7 +23,7 @@ export interface RenamedValue {
23
23
  }
24
24
  /**
25
25
  * @internal 改名した値の表(0.30.0)。kinds の "national" は、ID が "JP" の祝日の提供元を使う設定でだけ扱いを変える。
26
- * 作成と診断は値を読み替えずに知らせ(schedule.ts の reportNational)、migrate… は日本の提供元だけの設定で書き換える(docs/decisions.md の 54 番)
26
+ * 作成と診断は値を読み替えずに知らせ(schedule.ts の reportNational)、migrate… は日本の提供元だけの設定で書き換える(docs/decisions.md の 10 番)
27
27
  */
28
28
  export declare const RENAMED_VALUES: readonly RenamedValue[];
29
29
  /** @internal 改名を見つけたときの扱い(作成・診断は記録して読み替える。合成などの記録先がない設定は読み替えるだけ) */
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * 日ごとに値を返すスケジュール(営業時間・受付枠など、曜日・祝日・特定日で変わるもの)。
3
- * 1 日の値を決める優先順位は docs/guide.md の「Day-by-day values」と docs/decisions.md の 12 番。
3
+ * 1 日の値を決める優先順位は docs/guide.md の「Day-by-day values」と docs/decisions.md の 11 番。
4
4
  * 営業日カレンダー(createCalendar)は、このスケジュールの真偽値版として作られている。
5
5
  */
6
6
  import { type DateString, type Weekday } from "./date.ts";
@@ -657,7 +657,7 @@ export interface RecurringRuleCompiled<Value> extends CompiledPeriod {
657
657
  readonly holiday: boolean;
658
658
  /** 祝日・祝日の翌日・祝前日の規則で絞る種別(null はすべての祝日) */
659
659
  readonly kinds: ReadonlySet<string> | null;
660
- /** kinds の旧名 "national" を、日本の提供元が返した "regular" の祝日にも当てるか(docs/decisions.md の 54 番) */
660
+ /** kinds の旧名 "national" を、日本の提供元が返した "regular" の祝日にも当てるか(docs/decisions.md の 10 番) */
661
661
  readonly nationalOfJp: boolean;
662
662
  /** 祝日・祝日の翌日・祝前日の規則で絞る識別子(null はすべての祝日) */
663
663
  readonly keys: ReadonlySet<string> | null;
@@ -7,7 +7,7 @@
7
7
  * - 臨時の祝日・移動: 布告ごとの日付をテーブルで持つ
8
8
  * - 識別子(key): 毎年の祝日に GOV.UK の区分名から 1 つ(KnownUkHolidayKey)。振替日は元の祝日の key、臨時の祝日は持たない
9
9
  *
10
- * 年ごとの正(GOV.UK・当時の政府の一覧・布告)と検証のフィクスチャは decisions.md の 18・49 番。
10
+ * 年ごとの正(GOV.UK・当時の政府の一覧・布告)と検証のフィクスチャは decisions.md の 28 番。
11
11
  * CONFIRMED_THROUGH より後の年は、規則による予測(confirmed: false)。
12
12
  */
13
13
  import type { Holiday } from "../core/types.ts";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bizdays-toolkit",
3
- "version": "0.30.2",
3
+ "version": "0.30.4",
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",