bizdays-toolkit 0.30.8 → 0.31.0
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 +120 -209
- package/README.md +4 -4
- package/dist/core/calendar.d.ts +17 -6
- package/dist/core/calendar.js +37 -20
- package/dist/core/diagnose.d.ts +38 -9
- package/dist/core/diagnose.js +229 -72
- package/dist/core/errors.d.ts +23 -4
- package/dist/core/errors.js +15 -3
- package/dist/core/input.d.ts +0 -2
- package/dist/core/input.js +1 -8
- package/dist/core/migrate.js +2 -2
- package/dist/core/renamed.js +5 -3
- package/dist/core/schedule.d.ts +5 -1
- package/dist/core/schedule.js +27 -14
- package/dist/provider/index.d.ts +1 -1
- package/dist/provider/index.js +11 -11
- package/package.json +4 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,9 +1,53 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and versions follow [Semantic Versioning](https://semver.org/) and the policy in [RELEASING.md](./RELEASING.md). Besides the Keep a Changelog sections (Added / Changed / Deprecated / Removed / Fixed / Security), **Data** lists updates of the holiday data and **Migration** lists the work users need to do for a minor version.
|
|
4
|
+
|
|
5
|
+
Entries from 0.31.0 are in English. Earlier entries remain in Japanese (their **Migration** headings were renamed from 移行 in 0.31.0, and their section **開発** corresponds to the development notes). Development notes for 0.30.x and later (changes to the quality tooling that do not change the published package: checks, CI, release steps) are in [docs/development-log.md](./docs/development-log.md) (in Japanese; not published to npm). For versions before 0.30.0 (0.22.x and earlier), they are in the 開発 section of each version below.
|
|
4
6
|
|
|
5
7
|
## [Unreleased]
|
|
6
8
|
|
|
9
|
+
## [0.31.0] - 2026-11-08
|
|
10
|
+
|
|
11
|
+
This version rebuilds the `redundant` diagnostic so that the reported rules can be removed all together, narrows the days the diagnostics cannot judge, and brings in the changes postponed in 0.30.x that throw where nothing was thrown before or narrow a type (the return value of `isOpen`, the error classes, the frozen result of `withSubstituteDays`). It also adds the search for closed days.
|
|
12
|
+
|
|
13
|
+
### Added
|
|
14
|
+
|
|
15
|
+
- `Calendar.nextClosedDay(input)` and `previousClosedDay(input)`: return the next day after the input, or the previous day before it, that is not a business day. If none is found within `searchDayLimit` days, they throw a `RangeError` with the new code `no-closed-day`. Combined calendars and calendars made from a schedule have them too
|
|
16
|
+
- `BusinessDayOnOrAfterOptions.cutoff` accepts `"HH:mm:ss"`. The time of the input is taken to the minute (seconds are dropped) and compared at the start of that minute (with `"14:00:30"`, an input at 14:00 is before the cutoff)
|
|
17
|
+
|
|
18
|
+
### Changed
|
|
19
|
+
|
|
20
|
+
- Option diagnostics (`diagnoseCalendar`, `diagnoseSchedule`): `redundant` is now judged by sequential removal. Rules that are never used (`shadowed`, `never-matches` and the like) are removed first; then each rule (annual dates and recurring rules in array order, then specific dates) is judged with the rules already reported removed, and the pass is repeated until no other rule can be removed. The reported rules can be removed all together without changing any result (before, each rule was judged as if only that rule were removed: with the same rule written twice, the later one was `shadowed` and the earlier one `redundant`, and removing both changed the result). Impact: fewer `redundant` may be reported (for example, no `redundant` for the earlier of two identical rules), and in some settings more (for example, without closed weekdays, an open date that covers a closed date becomes `redundant` once the covered date is removed)
|
|
21
|
+
- Option diagnostics: `redundant` now has `relatedPath`, the rule that decides the days instead when the rule is removed, set only when one rule decides all of them (not when a closed weekday or the holiday handling decides some of them)
|
|
22
|
+
- Option diagnostics: the days the diagnostics cannot judge (where the counting calendar of a schedule's nth-business-day rule throws) are now found day by day and before the rules are compared: for a monthly rule, the days of the month where the calendar throws; for an nth business day of the week, the seven days of a week that touches such a month. Only rules whose effective period contains such a day get no `never-matches` or `redundant`, and they are not removed in the sequential removal. Before, the months next to such a month and the months of the 28 years used to compare rule shapes (2001–2028) were also treated as unknown, and the diagnostics were dropped after the comparison. Impact: in schedules with counting calendars, more `never-matches` and `redundant` may be reported
|
|
23
|
+
- `createCalendarFromSchedule`: if `isOpen` returns something other than a boolean, it throws a `RangeError` with code `invalid-argument` (before, a day with a value other than `true` was closed). It calls `isOpen` with the weekday values and the value of `holidayPolicy: { value }` when the calendar is created, and checks other values when such a day is evaluated
|
|
24
|
+
- Error classes follow one table by `code`: only `invalid-input` is a `TypeError`; every other code is a `RangeError`. The errors that were `TypeError` (`invalid-argument` for a wrong argument type in the functions of `bizdays-toolkit/provider`, `invalid-argument` from `migrateCalendarOptions` and `migrateScheduleOptions` given a value that is not an object, and `invalid-date` from `toInstant` given a date that is not a string) are now `RangeError`
|
|
25
|
+
- `withSubstituteDays` (`bizdays-toolkit/provider`): the returned array is frozen, and its type is `readonly Holiday<Kind>[]`
|
|
26
|
+
|
|
27
|
+
### Migration
|
|
28
|
+
|
|
29
|
+
- Tests that compare the whole result of the diagnostics (for example with `deepEqual`) need the new results as expected values: `redundant` may decrease or increase, `relatedPath` is added, and in schedules with counting calendars more `never-matches` and `redundant` may be reported. Removing the reported rules one at a time and diagnosing again is no longer needed; they can be removed together
|
|
30
|
+
- If `isOpen` of `createCalendarFromSchedule` returns values such as `1` or `"open"`, make it return a boolean (otherwise it throws when the calendar is created or when a day with that value is evaluated)
|
|
31
|
+
- If you catch the errors with `instanceof TypeError`, use `isBizdaysError(e)` and `e.code` instead (every code except `invalid-input` is now a `RangeError`)
|
|
32
|
+
- If you change the result of `withSubstituteDays` (for example with `push`), copy it first (`[...result]`). In TypeScript, if you assign it to a mutable array type (`Holiday[]`), use `readonly Holiday[]`
|
|
33
|
+
- Code that branches on `code` should handle the new `no-closed-day` in its default branch (usually no work is needed)
|
|
34
|
+
- No work is needed for `cutoff` with seconds or for `nextClosedDay` and `previousClosedDay`. The old option names are still accepted until 1.0.0
|
|
35
|
+
|
|
36
|
+
## [0.30.9] - 2026-11-07
|
|
37
|
+
|
|
38
|
+
品質改善提案(11 通目)の分です。文書で約束していた挙動から外れていた不具合を 2 件直しました。合成したカレンダーが、後のカレンダーが投げる日に投げるようになります(約束の回復。新たに投げる向きですが、RELEASING.md の区分を改めてパッチとしました)。省略可能な項目に明示的に書いた `undefined` は、どの項目でも省略と同じになります(作成できなかった設定が作成できるようになる向き)。正しい設定のカレンダー・スケジュールの判定の結果は変わりません。
|
|
39
|
+
|
|
40
|
+
### Fixed
|
|
41
|
+
|
|
42
|
+
- `combineCalendars`: 営業日の判定(`isBusinessDay`・探索・営業日の数え)が、`open: "all"` では先のカレンダーが休業日、`open: "any"` では営業日と決めた時点で後のカレンダーを判定せず、後のカレンダーが投げる日(`unconfirmedHolidayPolicy: "throw"` の予測の祝日、対応年の外)でも投げないことがあった。すべてのカレンダーを判定するようにした。ガイドの「合成したカレンダーは、どれかのカレンダーが投げるなら投げる」の約束から外れていた既知の不具合(0.30.x のガイドに記載)。影響: 後のカレンダーが投げる日に、今まで値を返していた呼び出しが `unconfirmed-holiday`・`out-of-range` を投げる。判定の費用は合成したカレンダーの数に比例する(今までは先のカレンダーで決まれば残りを省いていた)。`dayInfoOn` は今までもすべてのカレンダーを判定していたので変わらない
|
|
43
|
+
- 省略可能な項目に明示的に書いた `undefined` の扱いが項目ごとに違い、型は通るのに作成が `invalid-option` で失敗することがあった(例: 繰り返しの規則の `keys`・`weekdays`・`interval`・`anchor`・`skipWeekdays`・`calendar`、個別の日付の `{ date: undefined, from, to }`、旧名と新しい名前の片方が `undefined`)。設定・規則・個別の日付・毎年の月日・合成・スケジュールから作るカレンダー・期日のオプションのどこでも、省略と同じにした(決定の文書の 6 番「型と実行時を一致させる」から外れていた。利用者向けの型は `exactOptionalPropertyTypes` なしでは `undefined` を通す)。知らないキーは、値が `undefined` でも今までどおり診断の `unknown-option` で知らせる
|
|
44
|
+
- 文書を直した(コードの挙動は変わらない):
|
|
45
|
+
- `CalendarOptions`・`CombineCalendarsOptions`・`CalendarFromScheduleOptions` の `searchDayLimit` の TSDoc: 超えたときを `Error` と書いていた(0.30.8 から `code: "no-business-day"` の `RangeError`)
|
|
46
|
+
- `createCalendarFromSchedule` の TSDoc とガイド(英日): `isOpen` が boolean でない値(`1`・`"open"`)を返した日は休業日になることを書いた
|
|
47
|
+
- ガイド(英日)の「繰り返しの規則」: 配列の順が効くのは優先順位の同じ段階の中だけで、`holidayPolicy: "ignore"` でも祝日の日は `"over-holiday"` の規則が `"under-holiday"` の規則より先に当たることを書いた
|
|
48
|
+
- ガイド(英日): 明示的な `undefined` は省略と同じ、を書き、「未確定の祝日」の合成の既知の不具合の記載を消した
|
|
49
|
+
- 決定の文書: 17 番を実態に合わせて書き換えた(結果が祝日に依存しない設定の値だけの判定は未確定の祝日で投げない、を 0.30.6 から入れていたのに、「実行時に特別扱いを入れない」と書いていた)。6 番に明示的な `undefined` を、32 番に約束の回復の区分を、38 番に CHANGELOG の「開発」の書き方の理由を足した
|
|
50
|
+
|
|
7
51
|
## [0.30.8] - 2026-11-06
|
|
8
52
|
|
|
9
53
|
品質改善提案(10 通目)の分です。文書・決定の文書・コメントが実装と食い違っていた箇所を直し、不具合を 4 件直しました。カレンダー・スケジュールの判定の結果は変わりません。変わるのは、診断の結果(カレンダーの個別の日付・毎年の月日の `value` に `unknown-option` が増える。誤った `counting-basis` が消え、曜日の規則ごとに出る)、`no-business-day` の例外のクラス(`Error` → `RangeError`。広がる向き)、`withSubstituteDays` が返す祝日の凍結です。あわせて、品質の仕組みを軽くしました(タイムゾーンを変えたテストを 4 ゾーンから 2 ゾーンに、診断の性質のテストを抜き出しに、全日の結果を比べる補助を 1 つに、同じ恒等式を確かめるテストを 1 か所に。詳しくは「開発」)。公開物の `.js` が変わるのは Fixed の 4 件と、到達しないコードを消した 1 行(`core/input.js`。「開発」)の分だけで、カレンダー・スケジュール・提供元の判定の結果は変わらないので、利用者の作業は要りません。
|
|
@@ -20,31 +64,6 @@
|
|
|
20
64
|
- ガイド(英日)の「未確定の祝日」: 「`holidaysInYear`・`holidaysBetween` は投げない」を、未確定の祝日では投げない、に限った(対応年の外の `out-of-range` と、提供元のデータの誤りの `invalid-provider-data` は投げる)
|
|
21
65
|
- ガイド(英日)と `BusinessDayOnOrAfterOptions.cutoff` の TSDoc: `cutoff` が `"HH:mm"` だけを受け付ける理由(入力の時刻は分の精度で比べるので、秒を持つ締め時刻は入力の秒と比べられない)を書いた。秒の受け付けは 0.31.0 で扱う
|
|
22
66
|
|
|
23
|
-
### 開発
|
|
24
|
-
|
|
25
|
-
- 診断のオラクル: `counting-basis` の確かめを、第 n 営業日の規則と毎週の曜日の規則の有効期間が重なる組を前提にし、前提があるのに出ないとき・出た件数が組の数と違うときも失敗にした。項目の一覧(`test/fixtures/oracle-items.json`)に、有効期間が重ならない組を作る 4 項目(閉じる・開く規則の両方の `{ weekday: 2, effectiveTo: "2025-06-30" }` と `{ businessDayOfMonth: 2, effectiveFrom: "2025-07-01" }`)を足した(71 → 75 項目)
|
|
26
|
-
- 前の版との比較: 特徴 `counting-rule-with-period-weekly-rule`(`etc/result-changes.json` で `counting-basis` が消える差分を許す)と `calendar-date-with-value`(増える向きなので許可は足さない)を足し、固定の設定 4 つ(`fixed-counting-basis-no-overlap`・`fixed-counting-basis-two-weekly`・`fixed-counting-basis-shadowed-weekly`・`fixed-calendar-date-with-value`)を足した
|
|
27
|
-
- 決定の文書: 3 番に「同じ `code` は同じクラスで投げる」を足した
|
|
28
|
-
- `counting-basis` の判定を、規則どうしの走査の後の第 2 の走査にした(規則の並び順で結果が変わらないように)
|
|
29
|
-
- `./diagnose` の gzip のサイズ(測定 26,322。上限 26,500)。`counting-basis` の判定の直しで増えた
|
|
30
|
-
- 決定の文書: 「版と互換性」の章の見出しの直後にあった番号のない箇条 2 つ(オラクルの完全性を判定する期間、週の第 n 営業日の規則の判定できない月の限界)を 31 番に移した。`KNOWN_INCOMPLETE` に載せるときの手順は RELEASING.md の「診断のオラクル」の行と重なっていたので決定の文書からは消し、31 番(オラクルの完全性の箇条の直後)に手順の場所だけを書いた。章の見出しと最初の決定の見出しの間に本文があれば失敗にする検査を `scripts/check-package.ts` に足し、`scripts/tool-selftest.ts` にその誤りを足した(目次の検査は見出しだけを見るので、見出しのない本文を見つけられなかった)
|
|
31
|
-
- 「0.31.0 の P1」を「診断の判定の作り直し(0.31.0)」と言葉で書いた(決定の文書・RELEASING.md・この CHANGELOG の 0.30.4 と 0.30.6 の節・飛ばしの理由。P1 はどの文書にも定義のない名前だったため)
|
|
32
|
-
- API どうしの整合のテスト(`test/consistency.test.ts`)の名前の番号を整合 1〜11 に振り直した(「整合 5」が 6 件あり、失敗の報告から文書の行を引けなかった)。RELEASING.md の「API どうしの整合」の行は、関係の数を書かずに、関係とテストの番号を並べた
|
|
33
|
-
- `bizdays-toolkit/jp` の `jp` の TSDoc に 0.30.0 の旧名 `holidays` が残っていたのを `holidayProvider` に直した。`scripts/check-names.ts` の旧名の残りの検査(C14)は `holidays` をキーの形でしか探していなかったので、日本語の TSDoc で引数名として書く形(「の holidays に」)を足した
|
|
34
|
-
- `src/core/input.ts` の到達しない `replace(" ", "T")` を消した(直前の正規表現が区切りを `T` に限るので、空白を含む値はこの行に届かない。`core/input.js` の 1 行が変わるが、挙動は同じ)
|
|
35
|
-
- `check-package`: `src` が実行環境のタイムゾーンに依存する API(ローカル時刻の `Date` の API・`getTimezoneOffset`・`toLocale…String`・`new Date(年, 月, …)`・`timeZone` を渡さない `Intl.DateTimeFormat`)を使っていないことを確かめるようにし、`tool-selftest` にその誤りを 2 件足した
|
|
36
|
-
- タイムゾーンを変えたテスト(`scripts/test-tz.ts`)を UTC・Asia/Tokyo・America/Los_Angeles・Pacific/Chatham の 4 ゾーンから America/Los_Angeles・Pacific/Chatham の 2 ゾーンにした(理由は decisions.md の 35 番。1 コアの手元で 209 秒 → 104 秒)
|
|
37
|
-
- `check-names`: 報告のパスの区切りを `/` にそろえた(Windows では `\` で出ていて、期待と突き合わせにくかった)。旧名の表に `holidays` がないときは、日本語の TSDoc の引数名の形の検査(0.30.8 の ZIP-A で足した)を黙って外さず、一緒に消すよう失敗にする
|
|
38
|
-
- 前の版との比較(`scripts/result-compare.ts`): 意図した差分として許した設定の `id` と対象を一覧に出すようにした(意図しない差分が出たときに、許した側と見比べるため)。固定の設定 `fixed-counting-basis-open-closed-weekly`(開く規則と閉じる規則に曜日の規則が 1 つずつ。`counting-basis` が 2 件に増える形)を足した
|
|
39
|
-
- `src/core/input.ts`: `Date.parse` にオフセット付きの文字列だけを渡している理由をコメントに書いた
|
|
40
|
-
- 開発用のツールを更新: oxlint 1.88.0 → 1.91.0、oxfmt 0.73.0 → 0.76.0、`@types/node` 24.19.2 → 26.6.6(どれも既存のファイルの整形と lint の結果は変わらない)
|
|
41
|
-
- `check-package` の実行環境のタイムゾーンに依存する API の検査を直した: 引数の中の括弧を 1 段まで読む(`new Date(Number(y), m)` を見逃していた)、`new` を付けない `Intl.DateTimeFormat(…)` と `timeZone: undefined` も不可にした、文字列を渡す `new Date("…")` を不可にし、`Date.parse` は `src/core/input.ts` の 1 か所(オフセット付きに限った文字列)だけを許して回数が変わったら失敗にした、行末の `//` コメントも検査の前に除くようにした(コメントに書いた形で誤って失敗していた)。`tool-selftest` に文字列を渡す `new Date` の誤りを足した
|
|
42
|
-
- 診断の性質のテスト(`test/diagnose-properties.test.ts`)を、ほかの全件のテストと同じ「`pnpm check` は抜き出し、全件は CI」の形にした: 設定は毎回作り(乱数の列は変わらない。生成範囲の記録はカレンダーを作る時点で特徴を集めるので、記録の仕組み `scripts/record-generator-features.ts` は全件を動かす)、`pnpm check` では 3 件に 1 件の決まった抜き出しだけを確かめ、全件は `DIAGNOSE_PROPERTY_FULL=1` で CI の `diagnose-consistency` ジョブ。タイムゾーンを変えた実行では 3 つとも飛ばす(暦日だけで決まる。試行を減らして動かしていた `tzRuns`・`tzCountingRuns` は消した)。1 コアの手元で `pnpm test` のこのファイルの分が約 45 秒 → 12 秒
|
|
43
|
-
- 変形しても結果が同じ(`test/metamorphic.test.ts`)の全件(`METAMORPHIC_FULL=1`、関係ごとに 40 件)を CI の `diagnose-consistency` ジョブで動かすようにした(RELEASING.md に全件の環境変数だけがあり、動かす場所がなかった。36 番の「黙って外れる確認を作らない」)
|
|
44
|
-
- 全日の結果を比べる補助を `test/support/compare.ts` に 1 つにした(`daysOf`・`dayLine`・`linesOf`・`removeItem`)。診断の性質・診断のオラクル・整合・和集合・失敗の注入のテストと `test/support/provider.ts` が別々に持っていた、期間の全日の列・1 日の結果の文字列・項目の取り除きを置き換えた(約束は変えない。変形のテストの全項目の比較、整合のテストの `valueOn` の比較、失敗の注入のテストの `isBusinessDay` と例外の有無の比較は、比べる約束が違うので残した)
|
|
45
|
-
- 同じ恒等式を 3 か所で確かめていたのを 1 か所にした: `diff(a, add(a, n)) = n`・`add(end, −n) = start`・加算の結果は営業日・逆向きの差は −n、次の営業日は翌日からの営業日の一覧の最初・前の営業日は前日以前の営業日、を `test/consistency.test.ts` の整合 2・3(目録の設定)で確かめる。`test/properties.test.ts` の性質「addBusinessDays の結果は営業日で、n 進めて −n 戻ると元の営業日に戻る」「nextBusinessDay との間に営業日はなく、previousBusinessDay で戻る」と、`test/naming.test.ts` の T3 のカレンダーの対を消した(T3 は日付の `diffDays`・`addDays` の対だけ残す)。生成範囲の記録は変わらない(残る性質が同じ設定の作り方を使う。`record-generator-features.ts --check` で確かめた)
|
|
46
|
-
- `check-package` の実行環境のタイムゾーンに依存する API の検査: 文字列の中身を先に空にしてから `//` のコメントを除くようにした(`" //"` を含む文字列を行末のコメントと誤認して、その行の残りが黙って検査から外れていた)
|
|
47
|
-
|
|
48
67
|
## [0.30.7] - 2026-11-05
|
|
49
68
|
|
|
50
69
|
テスト拡充案の第 3 段です。0.30.6 の取り込みで持ち越した項目を片付け、そこで見つけた診断の不具合を 2 つ直したので、公開物の `.js` は 0.30.6 から変わります(Fixed。変わるのは `./diagnose` だけで、カレンダー・スケジュールの判定の結果は変わりません)。テストと道具では、変形しても結果が同じことの検査、文書の例と文章の主張の検査、オラクルの完全性を失敗にする切り替えを入れ、設定の結果の差分の旧名の比較の穴を直しました。設定の結果の差分の定期実行(テスト拡充案の T8)は入れず、手動の広い比較として入れました。自前の変異テスト(T9)は、0.31.0 の診断の作り直しの前に行います。
|
|
@@ -54,30 +73,6 @@
|
|
|
54
73
|
- 診断: スケジュールの第 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 どうしの食い違い)
|
|
55
74
|
- 診断: 週の第 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 どうしの食い違い)
|
|
56
75
|
|
|
57
|
-
### 開発
|
|
58
|
-
|
|
59
|
-
- サイズ(gzip): `./diagnose` 26,158 → 26,218(測定 26,218。上の Fixed の 2 件の 27 バイトと、規則どうしの診断が調べる期間を求める部分を関数 `rulesScanWindow` に切り出して内部で書き出した 33 バイト)。上限は変えていない。ルート 18,123(測定 18,123)は変わらない
|
|
60
|
-
- 判定できない月の診断のテスト(`test/diagnose-unjudgeable.test.ts`)を足した。上の Fixed の例(旧名のキーで書いた形と、週の規則の次の月・前の月の 2 例を含む)、基準のカレンダーを持つ規則の `never-matches`・`redundant` は有効期間に判定できない月があれば出さず、有効期間がすべて対応年の中なら出すこと、月の第 n 営業日の規則は前後の月を記録しないことを確かめる。規則の中のオプションの位置の診断(今はカレンダーにだけ出る)と、`recurringRules[1]` と `recurringRules[11]` が混ざる位置の引き方は、`dropUnsure`(`@internal`)を直接呼んで確かめる
|
|
61
|
-
- API どうしの整合の検査(`test/consistency.test.ts`)の直し: 作成を試す関数は、bizdays のエラーコードを持つ例外だけを「作成できない」とみなし、ほかの例外は投げ直す。整合 4 は、n 番目の営業日がないときの `no-business-day` だけを受け止め、営業日が n 日に満たない月がある固定の設定も試す(目録の設定では、その経路を全件でも一度も通っていなかった)。整合 5 は、今までの試行に加えて、目録が意図して入力の誤りにした規則を含む設定を別の種で作り(作れなければ失敗)、その設定が作成できないことも確かめる(抜き出しで 24 件・全件で 300 件。今までの試行の「作成できた」23 件・「作成できない」1 件は変わらない)。件数の行は、数えたものの名前で出す(never-matches・redundant の関係は「診断の項目」)。テストの名前から版の経緯を消した(黙って外れる穴。種類 C)
|
|
62
|
-
- `scripts/result-compare.ts`: スケジュールの第 n 営業日の規則の基準のカレンダーに、スケジュールの設定の `outOfRangePolicy` を受け継がせた。意図した差分の特徴 `schedule-counting-basis-narrower-than-scan` は、基準のカレンダーが `"ignore"`(対応年の外で投げない)なら付けない。特徴を付ける関数を `test/support/result-cases.ts` に移し、単体テスト(`test/result-traits.test.ts`)で確かめる(今の種で作る設定は `outOfRangePolicy` を持たないので、比べる設定と結果は変わらない)
|
|
63
|
-
- `scripts/tool-selftest.ts`: 表のセルの `|` を `\|` にし、写しの途中で例外が出ても、そこまでに写したファイルを表の後に出し、`Error` でない値の例外も文にする。部品を `scripts/tool-selftest-parts.ts` に切り出し、単体テスト(`test/tool-selftest-parts.test.ts`)で確かめる。対照の SKIP の判定の 2 つ目の形を見る理由をコメントに書いた
|
|
64
|
-
- 飛ばしの決まり(`test/support/skip.ts`): 事前の確認で届かなくなった枝を消した。環境変数 `CI` が `"false"`・空文字列のときに CI とみなさないことをテストで確かめる
|
|
65
|
-
- ガイド(英日)の「対応年の外」: スケジュールの第 n 営業日の規則の文を独立させ、「結果が分からない年の祝日に依存するため」の理由とシンガポールの例が、隣の日を見る規則と週の第 n 営業日の規則の説明として読めるようにした
|
|
66
|
-
- 変形しても結果が同じ(テスト拡充案の 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 件なら失敗にする
|
|
67
|
-
- 文書の例の検査(`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 の付け替えが外れたとき、黙って通らないため)
|
|
68
|
-
- ガイド(英日)の「カレンダーの合成」に、2 つ以上の別々のカレンダーを渡すこと(1 つだけ、または同じカレンダーを 2 度渡すと `invalid-argument`)を書き足した(コードにだけあった決まり)
|
|
69
|
-
- `SECURITY.md` の Supply chain と Supported versions を英日の併記にそろえ、依存ゼロ(`dependencies` を持たない)と、provenance が付く版を 0.1.0 以降と正確に書いた
|
|
70
|
-
- 文章の主張の検査(テスト拡充案の 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 つを足した
|
|
71
|
-
- テスト拡充案の 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 とともに写す)
|
|
72
|
-
- 設定の結果の差分(`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 までと同じ)
|
|
73
|
-
- 目録の生成器(`test/support/catalog.ts`)が、スケジュールの個別の日付の半分ほどを期間(`dates` の `{ from, to }`)にする。期間にするかと長さは、日付から決める別の乱数で選び、呼び出し側の乱数の流れは変えない(変えると、ほかのテストが試す設定がすべて変わるため。改名の前の版との比較では作らない)。乱数のテストが、スケジュールの期間の形を一度も試していなかった穴をふさぐ(ZIP-B の記録の持ち越し)
|
|
74
|
-
- 診断のオラクル(`test/diagnose-oracle.test.ts`)の完全性(取り除いても結果が変わらないのに診断が何も言わない項目)を、報告から失敗に切り替えた。対応年(2025〜2027 年)だけで「取り除ける」と判定していたので、有効期間が対応年の外に続く規則を、診断はその外まで調べて取り除けないと正しく判定していたのに、報告に出ていた(報告されていた 1 件と、報告の仕組みの見張りのカナリアの 2 件とも、この形で、診断の取りこぼしではなかった。カナリアの説明の理由も実際と違っていた)。対応年で取り除けた項目は、診断が規則どうしを調べる期間でも確かめ直してから数え(期間は、診断の中で組み立てていた部分を関数 `rulesScanWindow` に切り出し、診断とオラクルが同じ関数で求める。`@internal`)、確かめ直して数えなかった件数と時間を出す。既知の項目の一覧(`KNOWN_INCOMPLETE`)は空で、一覧にない項目が出たら失敗、一覧の項目が出なくなっても失敗にする。カナリアは、診断の結果を空にして渡し、本当に取り除ける項目を数えることと、走査の範囲で取り除けない項目を数えないことを確かめる見張りのテストに替えた
|
|
75
|
-
- 設定の結果の差分(`scripts/result-compare.ts`)の穴を直した: `latest` との比較の旧名の回が、旧名に書き換わっていなかった(旧名の表を、改名の前の版との比較でだけ読み込んでいたため。result-compare を入れた 0.30.2 から)。旧名の回は、新しい名前の回とほぼ同じ設定を比べ、基準のカレンダーを持つスケジュールは両方の版で `invalid-option` になって、誤りが同じなので差分にならず、結果も診断も比べていなかった。旧名の表をいつも読み込み、旧名に書き換わらなかった設定と、意図した入力の誤りでないのに作成に失敗した設定(名前の書き方ごと。前の版でも失敗した設定の数も出す)を失敗にする(合成の相手のカレンダーも本体と同じに数える)。旧名の表が空なら、読み込みの誤り(終了コード 2)とする。あわせて、スケジュールの基準のカレンダーを、いつも定休日なし(土日も営業日)で作っていた穴を直した(説明には「土日休みのカレンダー」とあった)。基準のカレンダーの定休日は、設定の id から決める別の乱数で選ぶ(書かない・土日・曜日の部分集合。実際の利用で多い土日を多めにする)。生成範囲の検査は、基準のカレンダーの定休日を特徴として別に数える(記録にない特徴なので見張りはしない。定休日を渡すことと、選び方が 3 つの形を出すことは、単体テスト(`test/result-traits.test.ts`)で確かめる)
|
|
76
|
-
- 設定の結果の差分の意図した差分(`etc/result-changes.json`)に、上の Fixed の 2 件目の項目(`schedule-week-counting-basis-narrower-than-scan`。0.30.6 が出していた誤った `never-matches`・`redundant` を出さなくなった差分)を足した(結果を変える修正に特徴と項目を足す決まりの、0.30.7 の作業の途中での漏れ)
|
|
77
|
-
- `RELEASING.md` の監視の節: GitHub の失敗の知らせの届き先(文書「Notifications for workflow runs」)と、有効にし直すステップの影響を、事実に合わせて書いた。監視のワークフローを改修したときの確かめ方(偽の `gh`・`curl` を与えて、`run:` のシェルを経路ごとに手元で動かす)を足した。`data-watch.yml` の失敗のステップは、照合ごとの終了コードで、差分(「… differ from the bundled data」)と照合そのものの失敗(「… could not be checked」)を書き分ける(取得・解析の失敗でも「differ」と出ていた)
|
|
78
|
-
- 飛ばしの決まりの検査(`test/skip-policy.test.ts`): 省略記法(`{ skip }`・`{ todo }`)と、分割代入(`const { skip } = …`)、`skip`・`todo` の import・export(別名を含む)と変数・引数の宣言を、TypeScript のコンパイラーの API で読み、行に分けて書いても拾う(前の行の grep が拾っていた形をすべて含む)
|
|
79
|
-
- `RELEASING.md` の確認の表: 変形しても結果が同じ(T4)と文章の主張(T7)の行を足し、ドキュメントのコード例(T6)・設定の結果の差分(T8)の行を今の検査に合わせた。設定の結果の差分の行の特徴の関数の場所(`traitsOf` → `test/support/result-cases.ts` の `traitsOfCase`)が、上の result-compare の直しで関数を移した後も古いままだったので直した
|
|
80
|
-
|
|
81
76
|
## [0.30.6] - 2026-11-02
|
|
82
77
|
|
|
83
78
|
テスト拡充案の第 2 段です。失敗を注入した祝日の提供元と API どうしの整合の検査で見つけた不具合を 3 つ(判定 1・診断 2)直したので、公開物の `.js` は 0.30.5 から変わります(Fixed)。合成したカレンダーの既知の不具合(0.31.0 で直す)を文書に書きました。
|
|
@@ -92,46 +87,10 @@
|
|
|
92
87
|
|
|
93
88
|
- 合成したカレンダーの営業日の判定(`isBusinessDay` や探索)は、`open: "all"` では先のカレンダーが休業日、`open: "any"` では先のカレンダーが営業日と決めた時点で後のカレンダーを判定しないので、後のカレンダーが投げる日(未確定の祝日・提供元の誤りなど)でも投げないことがある(並び順で変わる)。ガイドの「合成したカレンダーは、どれかのカレンダーが投げるなら投げます」から外れる。直すと新たに投げる判定ができるので、0.31.0(マイナー版)で直す。ガイドの該当の箇条に注を足し、確かめるテストは `todo` にした
|
|
94
89
|
|
|
95
|
-
### 開発
|
|
96
|
-
|
|
97
|
-
- サイズの上限: 上限を 25,800 から 26,500 に上げた `./diagnose`(測定 26,158)。理由: Fixed の 3 件目(基準のカレンダーが投げる月を判定できない月として扱い、確かでない診断を出さない)の修正で増えたため。診断の判定の作り直し(0.31.0)の分は見込まず、そのときにあらためて測って上げる
|
|
98
|
-
- 診断のオラクル: カナリア(完全性の報告に必ず出る設定)が取り除ける理由を確かめた。開く規則「5・7 月の月曜」が開きうる祝日(自作の提供元の 5・7 月の月曜の祝日)を、`holidayOverlapPolicy` の既定(`"under-holiday"`)では開かないため。`"over-holiday"` にすると取り除けなくなることを確かめるテストを足し、コメントの理由を直した(コメントの主張を確かめていなかった穴。種類 C)
|
|
99
|
-
- 診断のオラクル: `ORACLE_FULL` なしの `ORACLE_SHARD` を例外にした(`pnpm check` の抜き出しの間隔 111 と分ける数の公約数で、分が 0 件になっていた)。どのテストも、試した設定が 0 件なら失敗にする。失敗のメッセージを 1 つの関数にまとめ、設定を作り直せる情報(項目・休業日の扱いの方針・定休日・取り除いた項目)を入れた(黙って空振りする穴。種類 C)
|
|
100
|
-
- 生成範囲: 危険の分かっている組み合わせ(第 n 営業日(月・週)× 個別の日付、第 n 営業日(月)× 毎年の月日、祝日の規則 × 臨時営業日、祝日の翌日・前日 × `skipWeekdays` × 個別の日付、和集合の提供元 × `kinds`)の一覧(`test/support/combinations.ts`)を作り、呼び出し側ごとに 1 回以上作ることを確かめる(作れない組み合わせは事実の理由を付けて除く)。個々の特徴の包含だけでは組み合わせを守れなかった(生成器の偏りの穴。種類 A)
|
|
101
|
-
- 生成範囲: `test/properties.test.ts` の性質は、設定を作る乱数(性質の名前から決まる種の列)と、日付などを引く乱数を分けた。性質と設定の作り方の対応は `test/support/sites.ts` の `PROPERTY_CONFIGS` に書き、性質が実際に使った作り方と同じかを確かめる。これで生成範囲の包含のテストが properties の設定を並びまで再現し、テストとスクリプトの特徴が一致する(どちらも 414 件。0.30.5 は近似でテスト 408 件・スクリプト 413 件)(種類 A)
|
|
102
|
-
- 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)
|
|
103
|
-
- 検査のスクリプトの検査の直し: 取り込み中の変更を `git status -z` で読む(日本語・スペースを含むパスを写せなかった)。写したファイルを出力に出す。result-compare・check-readme-examples の失敗の期待を、検査が誤りの理由として出す文(「**失敗**(意図した変更なら…」「expected "…"」)にした(別の理由で失敗しても合格になっていた)。写し・ビルドの途中の例外でも、表と後始末の問題を出してから失敗で終わる。対照の実行で SKIP の行が出たら失敗にする。飛ばしの決まり: `skipWhen` は skip と todo の取り違えを、`todoFor` は一覧にない理由を、CI でなくても飛ばす条件にかかわらず投げる。省略記法の grep の限界(複数行のオブジェクトの `skip,` は拾わない)を書き、`test/support/skip.ts` の冒頭の「CI」の意味を実装に合わせた(黙って外れる穴。種類 C)
|
|
104
|
-
- 検査のスクリプトそのものの検査(`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)
|
|
105
|
-
- `catch` 節の到達の検査: 除外の一覧の名前が 2 つ以上の節で重なるときと、節の文が `try` と同じ行にあるとき(行で数える lcov では判定できない)を失敗にした。`--lcov` は検査そのものを試すための引数で CI は使わないことを書いた。飛ばしの決まり: `skipWhen` は飛ばす条件にかかわらず理由が一覧にあるかを確かめ、grep の対象に `test/support/*.ts` と省略記法(`{ skip }`)を加えた。`RELEASING.md` に、grep で止められる範囲の限界(早い `return`・`continue` は個別の仕組みで守る)と、「CI」の意味(環境変数 `CI` が空でも `"false"` でもないとき)を書いた(種類 C)
|
|
106
|
-
- `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)
|
|
107
|
-
- 飛ばしの決まり: 前提がそろわないときに飛ばす箇所を補助の関数(`test/support/skip.ts` の `skipWhen`・`todoFor`)に集め、理由を意図した飛ばしの一覧から引くようにした(タイムゾーンを変えた実行、`ORACLE_JOINT`、Temporal のない実行環境、手元で前の版のタグが読めないとき、合成の既知の不具合の `todo`)。CI では、一覧にない理由と CI では飛ばさない理由を失敗にする。補助の関数を通さない飛ばしは grep の検査(`test/skip-policy.test.ts`)が止める(黙って飛ばす穴。種類 C)
|
|
108
|
-
- 診断と判定の一致のテストの全件(150 件)を、`CONSISTENCY_FULL=1` で CI の `diagnose-consistency` ジョブで動かす(`pnpm check` は 12 件)。スケジュールから作ったカレンダーのテストで、`daysBetween` も未確定の祝日で投げることを確かめ、スケジュールの第 n 営業日の規則が基準のカレンダーを必須とする理由をコメントに書いた
|
|
109
|
-
- 失敗を注入する祝日の提供元(`test/support/faulty.ts`。特定の年で例外を投げる・ある年だけ不正なデータ(日付の書式・重複・型の違う項目)を返す・途中の年を未確定にする)を作り、判定・診断・合成の結果が文書のとおりかを確かめるテスト(`test/faulty-provider.test.ts`)を足した。文書が何も言っていなかった組み合わせ(例外を投げる提供元の判定・合成・診断、不正なデータの提供元の合成、未確定の祝日の診断)は、今の挙動を約束として `docs/providers.ja.md`・`docs/providers.md` の「提供元の約束と誤りの扱い」に書き、テストで確かめる。提供元の約束に「`holidaysInYear` は同じ年に同じ結果を返す」を足し、途中から例外を投げる提供元は約束の外とした(例外の経路の穴。種類 C)
|
|
110
|
-
- 診断のオラクル: カナリアの理由のテストで、`"over-holiday"` の開く規則を実際に取り除くと全日の結果が変わることまで確かめる。`test/properties.test.ts`: `PROPERTY_CONFIGS` に古い名前が残っていないこと、性質が 1 回の試行で 1 回だけ設定を作ることも確かめる。`scripts/record-generator-features.ts`: 作業ツリーの指定を真偽値で持ち、`"worktree"` という名前の参照と取り違えない。`RELEASING.md`・オラクルの冒頭のコメント: タイムゾーンを変えた実行で飛ばすのはオラクルの総当たりで、カナリアの 2 件は動かすと直した
|
|
111
|
-
- `scripts/record-generator-features.ts`: 作業ツリーは `--worktree` で指すようにした。`--ref HEAD`(git ではコミットを指す名前)は、`--worktree` を案内する使い方の誤りにした。CI の `generator-features` ジョブも `--worktree --check` にした
|
|
112
|
-
- `RELEASING.md`: オラクルと生成範囲の行を実装と 1 文ずつ突き合わせ、消えていた「タイムゾーンを変えた実行では、オラクルと日本の全範囲の走査を飛ばす」を戻し、組み合わせの一覧の検査・カナリアの理由の確認・0 件の検査・`ORACLE_SHARD` の条件・CI の実測の時間を書いた
|
|
113
|
-
|
|
114
90
|
## [0.30.5] - 2026-11-01
|
|
115
91
|
|
|
116
92
|
0.30.4 の品質基盤の補修です。公開物の `.js` は 0.30.4 と同じです。0.30.4 で、品質基盤が「動いているように見えて、実は見ていない」箇所と、乱数のテストの生成範囲が縮んだ箇所が見つかったので、それだけを直しました。テスト拡充案の段の番号を 1 つずつずらし、第 2 段は 0.30.6、第 3 段は 0.30.7 で出します。
|
|
117
93
|
|
|
118
|
-
### 開発
|
|
119
|
-
|
|
120
|
-
- 生成範囲を減らさない検査を入れた(`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)
|
|
121
|
-
- 呼び出し側の設定の作り方を `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)
|
|
122
|
-
- 生成器の到達性を、呼び出し側の文脈ごと・規則の形ごとに確かめるようにした(`test/catalog.test.ts`)。これまではキーを全部の形の和集合で数え、ある形でだけ作られないキーを見逃していた。文脈は `test/support/sites.ts` の `CONTEXT_USES` に書き出し、文脈で作らない形(提供元のない設定の祝日に従属する形、0.22.2 と比べる設定の週の第 n 営業日)は理由付きで除く(種類 A)
|
|
123
|
-
- 目録の除外の一覧を `"型.キー"` で引くようにし、除外したキーが `etc/api.md` に実在すること、呼び出し側が実際には作らないことも確かめる。0.30.4 の一覧は、作っているキー(`weekdayValues`・`sameAs`・`value`)を除外し、`calendar` を「スケジュールの生成器が別に付ける」としていたが、どの生成器も付けていなかった(種類 A)
|
|
124
|
-
- `scripts/result-compare.ts`: スケジュールの第 n 営業日の規則に、数える基準のカレンダー(`calendar`)を付けるようにした。これまでは付けていなかったので、その設定は前の版・今回の版のどちらでも作成が `invalid-option` になり、結果を一度も比べていなかった(v0.30.3 から)。入力の誤りの設定(生成器が意図して混ぜ、規則に印を付けたもの)の件数を Job Summary に出し、印のない設定の作成の失敗(意図せず作成に失敗した設定)が 1 件でもあれば失敗にし、入力の誤りの設定が 0 件のときも空振りとして失敗にする。エラーコードでは分けない。印は規則のオブジェクトに付くので、印が誤りの形の規則とそろうこと(写した規則で消えていないこと)を `test/catalog.test.ts` で確かめる(黙って見ていない穴。種類 C)
|
|
125
|
-
- 診断のオラクルの項目を、目録の乱数から切り離して明示した一覧(`test/fixtures/oracle-items.json`。0.30.4 の項目と同じ)にした。目録の値の候補を広げても、オラクルの項目は意図して変えない限り変わらない。一覧が目録のすべての形とキーを含むことを確かめ、今の不足(曜日の規則の `nth`・`months`・`skipWeekdays` など 8 つ)は `ITEM_GAPS` に理由付きで載せた(項目を足すと組み合わせが約 1.4 倍になり全件の実行が CI の時間を超えるので、全件の実行を行列に分けてから足す)(種類 B)
|
|
126
|
-
- 黙って飛ばさない: `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)
|
|
127
|
-
- 診断のオラクルの完全性の報告(取り除けるのに何も出ない項目)を確かめられるようにした。0 件のときは「なし」と出す。0 件だったのは項目の違いで、集計の誤りではなかった(外部のレビューの試作の項目を正式版のオラクルで動かすと、試作と同じく開く規則「5・7 月の月曜」の 2 件が出た)。その設定をカナリアとして固定し、報告に出ることを確かめる。全件では、`shadowed`・`never-matches`・`redundant`・`expired` がどれも 1 件以上出ることも確かめる(報告の仕組みが壊れても気づけない穴。種類 B)
|
|
128
|
-
- 診断のオラクルの範囲を広げた。項目の一覧に、目録の形とキーの不足を埋める 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)
|
|
129
|
-
- 診断の `counting-basis` の文を、毎週の曜日の規則が開く規則か閉じる規則かの両側で確かめる単体テストを足した(`test/counting-basis.test.ts`)(文の分岐を確かめていなかった穴。種類 C)
|
|
130
|
-
- 生成範囲の検査の補修: 特徴の取り出しの診断の走査の範囲(`diagnoseRangeOf`)に、対応年が 1900〜2099 年と重ならないときに先頭の 200 年にする扱いを入れ、単体テストで確かめる(`test/features.test.ts`)。記録を作り直す(`--update`)ときは、呼び出し側の終了コード 0 を必須にした(比べるときは見ない。理由はスクリプトの冒頭)。テストとスクリプトで result-compare の拾える特徴の数が違う理由(差はすべて、スケジュールの基準のカレンダーにライブラリが問い合わせた日付の特徴)をテストに書いた。生成範囲の検査が守るのは個々の特徴だけで、特徴の組み合わせは守らない(組み合わせは診断のオラクルの総当たりでしか守られていない)ことを `RELEASING.md` に書いた(種類 A)
|
|
131
|
-
- `RELEASING.md`: 診断のオラクルの環境変数(`ORACLE_FULL`・`ORACLE_SHARD`・`ORACLE_TARGET`・`ORACLE_JOINT`)と、全件の実行の時間の決まりを書いた
|
|
132
|
-
- `test/diagnose-properties.test.ts` の冒頭に二重に残っていた古い説明のコメントを消した
|
|
133
|
-
- `RELEASING.md`: 品質の確認に生成範囲の行を足し、目録・オラクルの行を今の検査に合わせた。生成範囲の記録は基準の版(v0.30.3)から取り、作り直すのは比べ方(特徴の取り出し方)を変えたときだけにして、CHANGELOG の「開発」に理由を書くことを書いた
|
|
134
|
-
|
|
135
94
|
## [0.30.4] - 2026-11-01
|
|
136
95
|
|
|
137
96
|
品質基盤の整備の第 1 段(正解の定義)です。規則と設定の目録と、診断の総当たりのオラクルを入れました。オラクルで見つけた診断の文の誤りを 1 つ直しました(判定の結果は変わりません)。
|
|
@@ -140,16 +99,6 @@
|
|
|
140
99
|
|
|
141
100
|
- 診断: 第 n 営業日の規則と、毎週の曜日を開く繰り返しの規則がある設定で、`counting-basis` の文が「その曜日の規則は数を減らさない」と、閉じる規則のときの説明をしていた。開く規則のときは「その規則が開いた日は数えない」と説明する。メッセージは API ではないので、診断の `code`・`path` は変わらない(総当たりのオラクルで約束を確かめるときに見つけた。種類は文章の主張の未検証)
|
|
142
101
|
|
|
143
|
-
### 開発
|
|
144
|
-
|
|
145
|
-
- 規則と設定の目録 `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` を見逃した種類)
|
|
146
|
-
- `test/properties.test.ts` のカレンダーに、目録の繰り返しの規則を入れた(これまでは繰り返しの規則のないカレンダーだけを試していた)。営業日のないカレンダーになった試行は、性質の前提を満たさないので飛ばす(1 割まで)
|
|
147
|
-
- `test/diagnose-properties.test.ts` は、対応年の短い自作の提供元(`test/support/provider.ts`)で全日を比べる(400 日の抜き出しをやめた)
|
|
148
|
-
- 診断の総当たりのオラクル `test/diagnose-oracle.test.ts` を入れた。目録の規則の形の代表と個別の日付・毎年の月日の 2 つまでの組み合わせで、出た項目を取り除いて全日の結果を比べ、`expired`・`no-business-day`・`counting-basis` の約束も確かめる。`pnpm check` は決まった抜き出し、CI の `oracle` ジョブはすべての組み合わせを試し、完全性(取り除けるのに何も出ない項目)を Job Summary に報告する。出た項目をまとめて取り除いても変わらない性質(診断の判定の作り直し(0.31.0)の正解の定義)は、印を付けて用意した(`ORACLE_JOINT=1` で試せる)。0.30.2 に向けると、すべての組み合わせで第 n 営業日の誤った `redundant` を検出する(正解と突き合わせる仕組みの不在の穴を塞ぐ)
|
|
149
|
-
- `scripts/test-tz.ts`: タイムゾーンを変えた実行では、オラクルを飛ばす(暦日だけで決まるので)
|
|
150
|
-
- `RELEASING.md`: 品質の確認に目録とオラクルを足し、手元の確認は前の版のタグを読める状態で通すことを書いた
|
|
151
|
-
- サイズ(gzip): `./diagnose` 25,321 → 25,360(測定 25,360。上の Fixed の文の分)。上限は変えていない
|
|
152
|
-
|
|
153
102
|
## [0.30.3] - 2026-11-01
|
|
154
103
|
|
|
155
104
|
診断の不具合を直すパッチ版です。あわせて、0.30.2 の後に main で整えた決定の文書・規約・CI を含みます。カレンダー・スケジュールの判定の結果は変わりません。
|
|
@@ -169,20 +118,6 @@
|
|
|
169
118
|
- 規約を見直した(`docs/decisions.md` の 25・26・32・33・37 番、`RELEASING.md`): 約束した挙動から外れていた不具合の修正は、入った版を問わずパッチにする(これまでは直前の版で入った退行だけ)。誤った診断を直したときは、前の版の診断の結果が消えることがある。性能の比較は、正しさのために遅くなることを CHANGELOG に書いた版を通す。同梱の提供元の内部は、前の版との祝日データの比較で差分がなければ置き換えてよい。誤った祝日の `key` を直す手順を決めた
|
|
170
119
|
- ガイド(英日)の「0.30.0 より前に保存した設定」に 0.30.2 で足した、書き換えた後に診断を実行する例の設定が、`timeZone` を書いていないので `time-zone-conflict`(error)になっていた(日本と英国の提供元はタイムゾーンが違う)。例は `deprecated-option` だけを取り出していたので、コード例の検査は通っていた。`timeZone: "Asia/Tokyo"` と `holidayPolicy: "open"` を足し、診断の結果をすべて示す形にした(誤りがあれば例の検査で止まる)
|
|
171
120
|
|
|
172
|
-
### 開発
|
|
173
|
-
|
|
174
|
-
- `test/diagnose.test.ts`・`test/diagnose-properties.test.ts`: 上の Fixed の 4 例(月・週の第 n 営業日、閉じる・開く規則)と、スケジュールの第 n 営業日の規則では結果が変わらないことのテストを足した。性質のテストの設定の生成に第 n 営業日の規則を足し、第 n 営業日の規則と個別の日付を必ず持つ設定の性質を足した(0.30.2 では失敗する。生成に入っていなかったので、この不具合を見逃していた)
|
|
175
|
-
- `scripts/result-compare.ts`: 意図した差分を、診断の消えた結果のコード(`removedCodes`)で絞れるようにした。上の Fixed の差分を、第 n 営業日の規則と個別の日付・毎年の月日を持つ設定の `redundant` が消えたものだけに絞って許す(`counting-rules-with-dates`)。上の Fixed の例を固定の設定に足した(週の第 n 営業日の例は、それがない 0.22.2 とは比べない)
|
|
176
|
-
- サイズの上限: `./diagnose` を 25,000 から 25,800 に上げた(上の Fixed で上限を超えたため。測定値に小さな余裕を足した値)
|
|
177
|
-
- サイズ(gzip): `./diagnose` 24,753 → 25,321(測定 25,321)。ルート 17,997(測定 17,997)と `./jp` 20,226(測定 20,226)は変わらない
|
|
178
|
-
- 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 時間を過ぎた版)
|
|
179
|
-
- `scripts/check-package.ts`: 決定の文書の目次が本文の章・見出しと一致すること(番号の重複も)を確かめる。CHANGELOG の 0.30.2 までの節の番号は旧番号の対応表で確かめ、`` `docs/decisions.md` の N 番 `` のようにバッククォートで囲んだ参照も確かめるようにした(これまでは見ていなかった)。「番」を書き忘れた参照(`decisions.md の 15`)は形の誤りとして止める
|
|
180
|
-
- `scripts/bench-compare.ts`: CHANGELOG の今の版(または [Unreleased])の「開発」に決まった言葉で理由を書いた版は、2 倍を超えて遅くなっても表に記録して合格にする(言葉は `RELEASING.md` の品質の確認の表)
|
|
181
|
-
- `etc/result-changes.json` に 0.30.1 の修正(和集合の旧名 `"national"`)を足した。公開済みの 0.30.0 → 0.30.1 を比べたとき、意図した修正ではなく診断の退行だけが「許していない差分」として出る
|
|
182
|
-
|
|
183
|
-
- `scripts/result-compare.ts`: 意図した差分を許す特徴を、比べた対象ごとに付けるようにした。0.30.2 では合成の組の相手の特徴まで付けていたので、相手だけが日本の提供元と `kinds: ["regular"]` を持つ組では、元のカレンダー単独の差分まで許していた。合成だけ組の両方の設定から、ほかはその設定だけから付ける。日本の提供元だけの設定の `"national"` の特徴は、同じ配列に同じ形で `"regular"` を含む規則もあるときだけ付ける(名前を `kinds-national-and-regular-with-jp-only` に改めた。前の版が 0.30.1 のときだけ効く項目)
|
|
184
|
-
- `test/fixtures/national-union-0.22.2.json` の出典の説明で、`"national"` の扱いの根拠を旧 55 番としていたのを旧 54 番(今の 10 番)に直した
|
|
185
|
-
|
|
186
121
|
## [0.30.2] - 2026-10-30
|
|
187
122
|
|
|
188
123
|
0.30.0・0.30.1 の改名の後始末の続きの版です。新しい設定・関数・診断コードはありません。公開物の `.js` の挙動が変わるのは Fixed の 1 つ(診断の結果)で、カレンダー・スケジュールの判定の結果は変わりません。
|
|
@@ -201,13 +136,6 @@
|
|
|
201
136
|
- ソースのコメントとテストで、`"national"` の扱いの根拠を 55 番としていたのを 54 番に直した
|
|
202
137
|
- `docs/decisions.md`: 54 番に 0.30.2 の追記(返す値の改名は「改名は結果を変えない」の例外であること、規則どうしの診断の項を実際の挙動に合わせた)を足し、55 番の対象を「直前の版(マイナー版・パッチ版)」に改め、56 番(同じ設定の結果を前の版と CI で比べる)を足した。旧名を本文に持つ 14・16・36・43・44 番に、0.30.0 の改名の追記を足した。`RELEASING.md`: パッチの区分を「直前の版」に改め、互換性の約束の診断の項に前の版の結果は新しい版でも返すことを、品質の確認に決定の文書の旧名と返す値の改名の確かめ方を足した
|
|
203
138
|
|
|
204
|
-
### 開発
|
|
205
|
-
|
|
206
|
-
- 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 で上の診断の退行を検出する
|
|
207
|
-
- `scripts/check-names.ts`: 前の版を動かす `scripts/result-compare.ts` を、旧名の検査(C14)の対象から外した
|
|
208
|
-
- `test/national-union.test.ts` に、日本の提供元だけの設定の `shadowed` の確認を足した
|
|
209
|
-
- サイズ(gzip): ルート 18,054 → 17,997(測定 17,997)、`./jp` 20,288 → 20,226(測定 20,226)、`./diagnose` 24,492 → 24,753(測定 24,753)。上限は変えていない
|
|
210
|
-
|
|
211
139
|
## [0.30.1] - 2026-10-30
|
|
212
140
|
|
|
213
141
|
0.30.0 の改名の後始末の版です。新しい設定・関数・診断コードはありません。公開物の `.js` の挙動が変わるのは Fixed の 1 つだけです。
|
|
@@ -226,13 +154,6 @@
|
|
|
226
154
|
- README の祝日の種別の説明を今の値に直した。README(英日)の minify + gzip のサイズを測り直した(ルート 12.7 → 13.0 KB、日本込み 14.4 → 14.7 KB、英国込み 14.8 → 15.1 KB、フランス込み・シンガポール込み 13.6 → 13.9 KB)。`docs/providers.md` のコード例のコメントに残っていた置き換えの取り残し("US federal holidayProvider:" → "US federal holidays:")を直した
|
|
227
155
|
- `docs/decisions.md`: 55 番(直前の版で入った退行の修正はパッチ)を足し、42・50・52・54 番に追記した。`RELEASING.md`: パッチの区分に退行の修正を足し、互換性の約束から型の名前の列挙をやめ、旧名(`outOfRange`)を直した。`src/core/schedule.ts`・`calendar.ts` の冒頭の判定の順番の写しを削り、ガイドと 12 番を指すようにした
|
|
228
156
|
|
|
229
|
-
### 開発
|
|
230
|
-
|
|
231
|
-
- `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:` を検出する
|
|
232
|
-
- `scripts/check-size.ts`: 上限を変えた版で、CHANGELOG の測定値(「(測定 N)」の形)を 1 つも照合できなければ失敗にし、照合した件数を出すようにした。0.30.0 の節は測定値をこの形で書いておらず、照合が 0 件のまま合格していた(記載の値は、測定の後の内部の関数名の変更で公開物と 6〜7 バイト違っていた)
|
|
233
|
-
- 和集合の `"national"` のテスト(`test/national-union.test.ts`)を足した。日本の提供元を包んだ設定との関係を対応年のすべてで確かめ、公開済みの 0.22.2 の結果(2020〜2027 年)を錨にする(`test/fixtures/national-union-0.22.2.json`)
|
|
234
|
-
- サイズ(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%)
|
|
235
|
-
|
|
236
157
|
## [0.30.0] - 2026-10-27
|
|
237
158
|
|
|
238
159
|
公開する名前を 1 つの規則に合わせて改めた版です(`docs/decisions.md` の 54 番)。名前の整理の版を区切るため、版の番号を 0.30.0 にしました(0.23.0〜0.29.0 は欠番)。旧名は 1.0.0 まで受け付けます。作業は「移行」と `docs/migration.md` の 0.30.0 の節にあります。
|
|
@@ -260,7 +181,7 @@
|
|
|
260
181
|
|
|
261
182
|
- 日本の祝日の `kind` の `"national"` を `"regular"` にした(日付・名称・`key` は変わらない)
|
|
262
183
|
|
|
263
|
-
###
|
|
184
|
+
### Migration
|
|
264
185
|
|
|
265
186
|
- 実行時は旧名のままでも動くが、返す値の変更・対応年の端の挙動・TypeScript で必須のキーの旧名・`dayInfoOn` の結果を丸ごと比べるテストは 0.30.0 に上げた時点で対応が要る(下の箇条)。それ以外は TypeScript の取り消し線と診断の `deprecated-option` を手がかりに新しい名前に書き換える。保存した設定は `migrateCalendarOptions`・`migrateScheduleOptions` で書き換えられる
|
|
266
187
|
- 型が旧名を持つのは省略可能なキーだけなので、スケジュールの `weekly`・合成の `businessDay`・期日の `day`・振替の `rules`・規則の `day` は、TypeScript では新しい名前に書き換える
|
|
@@ -268,15 +189,6 @@
|
|
|
268
189
|
- `dayInfoOn` の結果を `deepEqual` で比べているテストは、期待値に `open` と、`rulePath` があれば `optionPath` を足し、`reason` が `"regular"` なら `"default"`(`createCalendarFromSchedule` では `"open-weekday"`)に直す
|
|
269
190
|
- 対応年の最後の日付の近くで祝前日・祝日の翌日・振替の規則を使っていて例外になったら、`outOfRangePolicy: "ignore"` にするか、対応年の中で使う
|
|
270
191
|
|
|
271
|
-
### 開発
|
|
272
|
-
|
|
273
|
-
- 名前の規則の検査 `scripts/check-names.ts` を `pnpm check` に足した(`etc/naming.md` の用語集・外部の名前の出典と、移行ガイドの削除予定の表に照らす。名前を許す一覧は持たない)。名前が約束する意味は `test/naming.test.ts` の性質のテストで確かめる
|
|
274
|
-
- 改名の表を `src/core/renamed.ts` の 1 か所に置き、読み替え・診断・`migrate…` がこの表だけを使う
|
|
275
|
-
- `scripts/bench.ts` は、前の版が新しい名前を知らないときは設定を旧名に戻して渡す(CI の bench が同じ場面を比べるため)
|
|
276
|
-
- `scripts/check-readme-examples.ts` は、0.30.x の間だけ返す旧名の項目(削除予定の表から決める)を比べない
|
|
277
|
-
- サイズの上限を上げた(ルート 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 バイト
|
|
278
|
-
- README のサイズの値を 0.30.0 で測り直した
|
|
279
|
-
|
|
280
192
|
## [0.22.2] - 2026-10-27
|
|
281
193
|
|
|
282
194
|
### Changed
|
|
@@ -314,13 +226,13 @@
|
|
|
314
226
|
- `docs/decisions.md`: 53 番(日単位の周期の規則、祝日の翌日・祝前日の絞り込みと `skipWeekdays`、前への振替を足さない判断、`@public` への格上げ)を追加し、15・33・35・43・46・47 番に追記した
|
|
315
227
|
- `docs/migration.md`: 1.0.0 で削除する非推奨の API の一覧を足した
|
|
316
228
|
|
|
317
|
-
###
|
|
229
|
+
### Migration
|
|
318
230
|
|
|
319
231
|
- 動作が変わる既存の API はない。祝日の翌日・祝前日の規則に `kinds`・`keys`・`skipWeekdays` を付けて `invalid-option` になることを確かめていたテストは、例外が出なくなるので失敗する。テストを書き換える(`docs/migration.md`)
|
|
320
232
|
|
|
321
233
|
### 開発
|
|
322
234
|
|
|
323
|
-
- サイズの上限(`size-limits.json
|
|
235
|
+
- サイズの上限(`size-limits.json`)を上げた
|
|
324
236
|
|
|
325
237
|
## [0.21.4] - 2026-10-26
|
|
326
238
|
|
|
@@ -333,9 +245,9 @@
|
|
|
333
245
|
|
|
334
246
|
### 開発
|
|
335
247
|
|
|
336
|
-
- `pnpm check`(`scripts/check-package.ts`)に、コメントと文書の参照の検査を足した(decisions.md の 52
|
|
337
|
-
- スクリプト・ワークフロー・テスト・`src` のコメント(型定義に出る TSDoc を含む)から、決定の文書と重複する理由の説明、版の経緯(「0.18.0
|
|
338
|
-
- サイズの上限(`size-limits.json`)を、コメントを除いた `.js`
|
|
248
|
+
- `pnpm check`(`scripts/check-package.ts`)に、コメントと文書の参照の検査を足した(decisions.md の 52 番)
|
|
249
|
+
- スクリプト・ワークフロー・テスト・`src` のコメント(型定義に出る TSDoc を含む)から、決定の文書と重複する理由の説明、版の経緯(「0.18.0 で追加」など)、利用元の一覧、変わりうる事実を削り、何をするか・使い方・決定の文書の番号だけを残した(52 番)
|
|
250
|
+
- サイズの上限(`size-limits.json`)を、コメントを除いた `.js` の実測に合わせて下げた
|
|
339
251
|
|
|
340
252
|
## [0.21.3] - 2026-10-26
|
|
341
253
|
|
|
@@ -348,9 +260,9 @@
|
|
|
348
260
|
|
|
349
261
|
### 開発
|
|
350
262
|
|
|
351
|
-
- `pnpm check`(`scripts/check-package.ts`)に、ドキュメントの数値・一覧を `dist` とソースの型と照合する検査を足した(decisions.md の 51
|
|
352
|
-
- CI に `data-compare`
|
|
353
|
-
- README のサイズを測る `scripts/measure-bundle.ts`
|
|
263
|
+
- `pnpm check`(`scripts/check-package.ts`)に、ドキュメントの数値・一覧を `dist` とソースの型と照合する検査を足した(decisions.md の 51 番)
|
|
264
|
+
- CI に `data-compare` ジョブを足した
|
|
265
|
+
- README のサイズを測る `scripts/measure-bundle.ts` を足した
|
|
354
266
|
|
|
355
267
|
## [0.21.2] - 2026-10-26
|
|
356
268
|
|
|
@@ -360,7 +272,7 @@
|
|
|
360
272
|
|
|
361
273
|
### 開発
|
|
362
274
|
|
|
363
|
-
- 納品の検査を `pnpm check` に 3 つ足した(decisions.md の 50
|
|
275
|
+
- 納品の検査を `pnpm check` に 3 つ足した(decisions.md の 50 番)
|
|
364
276
|
|
|
365
277
|
## [0.21.1] - 2026-10-26
|
|
366
278
|
|
|
@@ -374,7 +286,7 @@
|
|
|
374
286
|
|
|
375
287
|
## [0.21.0] - 2026-10-25
|
|
376
288
|
|
|
377
|
-
###
|
|
289
|
+
### Migration
|
|
378
290
|
|
|
379
291
|
動作が変わる既存の API はない(2012 年以降の英国の祝日は変わらない)。英国の 4 つの提供元の `supportedYears.from` が 2012 から 1974 になり、これまで `out-of-range` だった 1974〜2011 年の日付が結果を返すようになる。
|
|
380
292
|
|
|
@@ -391,12 +303,12 @@
|
|
|
391
303
|
|
|
392
304
|
### 開発
|
|
393
305
|
|
|
394
|
-
- テスト: `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`
|
|
395
|
-
- サイズの上限(`size-limits.json
|
|
306
|
+
- テスト: `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` を追加した
|
|
307
|
+
- サイズの上限(`size-limits.json`)を上げた
|
|
396
308
|
|
|
397
309
|
## [0.20.0] - 2026-10-25
|
|
398
310
|
|
|
399
|
-
###
|
|
311
|
+
### Migration
|
|
400
312
|
|
|
401
313
|
動作が変わる既存の API はない。サブパス `bizdays-toolkit/fr` が増える。版ごとの作業は [docs/migration.md](./docs/migration.md) にまとめた。
|
|
402
314
|
|
|
@@ -415,13 +327,13 @@
|
|
|
415
327
|
|
|
416
328
|
### 開発
|
|
417
329
|
|
|
418
|
-
- 監視のワークフロー `data-watch.yml` に data.gouv.fr
|
|
330
|
+
- 監視のワークフロー `data-watch.yml` に data.gouv.fr の照合を足した。`scripts/verify-datagouv.ts`(`pnpm verify:datagouv`)を追加した
|
|
419
331
|
- テスト: `test/fr-rules.test.ts`・`test/fr-datagouv.test.ts` を追加し、`test/holiday-key.test.ts`・ESM/CJS/ブラウザー/workerd の確認・利用者の型チェックにフランスを足した
|
|
420
332
|
- サイズの上限(`size-limits.json`)に `./fr` 6,500(測定 5,404)を足した(gzip)
|
|
421
333
|
|
|
422
334
|
## [0.19.0] - 2026-10-25
|
|
423
335
|
|
|
424
|
-
###
|
|
336
|
+
### Migration
|
|
425
337
|
|
|
426
338
|
動作が変わる既存の API はない(`"after-holiday"` の規則に `skipWeekdays` を付けなければ振替先はこれまでどおり)。繰り返しの規則の形 `{ businessDayOfMonth }` と項目 `skipWeekdays`・`calendar`、診断コード `counting-basis` が増える。版ごとの作業は [docs/migration.md](./docs/migration.md) にまとめた。
|
|
427
339
|
|
|
@@ -439,13 +351,13 @@
|
|
|
439
351
|
|
|
440
352
|
### 開発
|
|
441
353
|
|
|
442
|
-
-
|
|
354
|
+
- 監視の照合スクリプトの「確認した日付」を UTC から日本時間に揃えた(issue のコメントの日付と同じ基準)
|
|
443
355
|
- テスト: `test/business-day-of-month.test.ts`・`test/skip-weekdays.test.ts` を追加し、`test/types.check.ts`・利用者の型チェックに新しい規則を足した
|
|
444
|
-
- サイズの上限(`size-limits.json
|
|
356
|
+
- サイズの上限(`size-limits.json`)を上げた
|
|
445
357
|
|
|
446
358
|
## [0.18.0] - 2026-10-25
|
|
447
359
|
|
|
448
|
-
###
|
|
360
|
+
### Migration
|
|
449
361
|
|
|
450
362
|
動作が変わる既存の API はない。同梱の提供元が返す祝日に省略可能な項目 `key` が加わるので、`dayInfo` の結果や `holidaysInYear` の要素を `deepEqual` で比べているテストは期待値に足す(国民の休日・臨時の祝日には付かない)。祝日の規則に省略可能な `keys` が加わる。版ごとの作業は [docs/migration.md](./docs/migration.md) にまとめた。
|
|
451
363
|
|
|
@@ -464,9 +376,9 @@
|
|
|
464
376
|
|
|
465
377
|
### 開発
|
|
466
378
|
|
|
467
|
-
- 監視のワークフロー `data-watch.yml` に内閣府「国民の祝日」CSV
|
|
468
|
-
- テスト: `test/holiday-key.test.ts` を追加し、`test/provider.test.ts` に `substituteDays`(同梱の 3
|
|
469
|
-
- サイズの上限(`size-limits.json
|
|
379
|
+
- 監視のワークフロー `data-watch.yml` に内閣府「国民の祝日」CSV の照合を足した(`scripts/verify-cao.ts`。`--report`・`--simulate`)
|
|
380
|
+
- テスト: `test/holiday-key.test.ts` を追加し、`test/provider.test.ts` に `substituteDays`(同梱の 3 か国との同値・向き・名称・入力の検証)を足した
|
|
381
|
+
- サイズの上限(`size-limits.json`)を上げた
|
|
470
382
|
|
|
471
383
|
## [0.17.1] - 2026-10-25
|
|
472
384
|
|
|
@@ -476,12 +388,12 @@
|
|
|
476
388
|
|
|
477
389
|
### 開発
|
|
478
390
|
|
|
479
|
-
- `pnpm check`:
|
|
391
|
+
- `pnpm check`: 英語と日本語のドキュメントの対の見出しの数とコードブロックの数の一致、互いへのリンク、`docs/*.md` の見出しへのリンク(`#…`)の実在を確かめる(`scripts/check-package.ts`)
|
|
480
392
|
- `RELEASING.md`・`docs/decisions.md` の 22・27 番に、ドキュメントの対が増えたことを書いた
|
|
481
393
|
|
|
482
394
|
## [0.17.0] - 2026-10-25
|
|
483
395
|
|
|
484
|
-
###
|
|
396
|
+
### Migration
|
|
485
397
|
|
|
486
398
|
動作が変わる既存の API はない(既定値はこれまでどおり)。`Calendar`・`Schedule`・`HolidayLookup` に項目 `unconfirmedHolidays` が加わり、`createCalendar`・`createSchedule` の設定と `diagnoseCalendar`・`diagnoseSchedule` の第 2 引数が増える。監視のワークフローの改名(`govuk-watch.yml` → `data-watch.yml`)により、cron-job.org の URL を直す(RELEASING.md)。版ごとの作業は [docs/migration.md](./docs/migration.md) にまとめた。
|
|
487
399
|
|
|
@@ -502,13 +414,13 @@
|
|
|
502
414
|
|
|
503
415
|
### 開発
|
|
504
416
|
|
|
505
|
-
- 監視のワークフローを `govuk-watch.yml` から `data-watch.yml` に改名し、英国とシンガポールの照合を 1
|
|
417
|
+
- 監視のワークフローを `govuk-watch.yml` から `data-watch.yml` に改名し、英国とシンガポールの照合を 1 回の起動で順に行う。`scripts/verify-datagovsg.ts`(`pnpm verify:datagovsg`。`--file`・`--write`・`--report`・`--simulate`)を追加した
|
|
506
418
|
- テスト: `test/unconfirmed-holidays.test.ts`・`test/diagnose-as-of.test.ts`・`test/sg-rules.test.ts`・`test/sg-datagovsg.test.ts` を追加し、`smoke.mjs`・CJS・利用者の型チェックにシンガポールと新しい設定を足した
|
|
507
|
-
- サイズの上限(`size-limits.json`)を上げ、`./sg`
|
|
419
|
+
- サイズの上限(`size-limits.json`)を上げ、`./sg` のエントリーを足した
|
|
508
420
|
|
|
509
421
|
## [0.16.0] - 2026-10-23
|
|
510
422
|
|
|
511
|
-
###
|
|
423
|
+
### Migration
|
|
512
424
|
|
|
513
425
|
日時の文字列の区切りは `T` だけになり、空白で区切った文字列(`"2026-11-23 10:00"`)は `invalid-time` の Error になる(これまでは実行時だけ受け付けていた。型 `DateTimeInput` は以前から `T` 区切りだけ)。合成した `dayInfo` に `decidedByPath` が加わるので、`deepEqual` で比べているテストは期待値に足す。ほかは動作が変わらない(祝前日の規則・サブパス・合成の項目の追加)。版ごとの作業は [docs/migration.md](./docs/migration.md) にまとめた。
|
|
514
426
|
|
|
@@ -527,14 +439,14 @@
|
|
|
527
439
|
|
|
528
440
|
### 開発
|
|
529
441
|
|
|
530
|
-
- CI に `bun`・`deno`
|
|
531
|
-
- `easterSunday` を `src/uk/rules.ts` から `src/core/date.ts`
|
|
532
|
-
-
|
|
533
|
-
- サイズの上限(`size-limits.json`)を上げ、`./provider`
|
|
442
|
+
- CI に `bun`・`deno` ジョブを追加した(Deno は `--unstable-temporal` で本物の Temporal も確かめる)
|
|
443
|
+
- `easterSunday` を `src/uk/rules.ts` から `src/core/date.ts` に移した
|
|
444
|
+
- 規則の診断の性質のテストの生成器に祝前日を加えた
|
|
445
|
+
- サイズの上限(`size-limits.json`)を上げ、`./provider` のエントリーを足した
|
|
534
446
|
|
|
535
447
|
## [0.15.0] - 2026-10-21
|
|
536
448
|
|
|
537
|
-
###
|
|
449
|
+
### Migration
|
|
538
450
|
|
|
539
451
|
`businessDayOnOrAfter` に `cutoff` を指定するときは、時刻を持つ入力(`Date`・日時の文字列・時刻を持つ Temporal の値)を渡す。時刻のない入力(暦日の文字列・`PlainDate`)との組み合わせは、これまで暦日を 0 時として扱い締め時刻を黙って無視していたが、`invalid-argument` の Error になる。ほかは動作が変わらない(規則の絞り込み・カレンダーのメソッド・型の追加)。版ごとの作業は [docs/migration.md](./docs/migration.md) にまとめた。
|
|
540
452
|
|
|
@@ -552,8 +464,8 @@
|
|
|
552
464
|
|
|
553
465
|
### 開発
|
|
554
466
|
|
|
555
|
-
- 性質のテストに、休業日を起点にした `addBusinessDays
|
|
556
|
-
- サイズの上限(`size-limits.json
|
|
467
|
+
- 性質のテストに、休業日を起点にした `addBusinessDays` と、営業日を考慮した締め日を足した
|
|
468
|
+
- サイズの上限(`size-limits.json`)を上げた
|
|
557
469
|
|
|
558
470
|
## [0.14.1] - 2026-10-20
|
|
559
471
|
|
|
@@ -561,12 +473,12 @@
|
|
|
561
473
|
|
|
562
474
|
### 開発
|
|
563
475
|
|
|
564
|
-
- `createCalendar`・`createSchedule` の作成が 0.13.0 で約 30%
|
|
476
|
+
- `createCalendar`・`createSchedule` の作成が 0.13.0 で約 30% 遅くなっていたのを直した
|
|
565
477
|
- `docs/decisions.md`: 38 番にこの原因と「作ったあとに印を付けず、リテラルに含める」知見を追記した
|
|
566
478
|
|
|
567
479
|
## [0.14.0] - 2026-10-20
|
|
568
480
|
|
|
569
|
-
###
|
|
481
|
+
### Migration
|
|
570
482
|
|
|
571
483
|
動作は変わりません(締め期間と、暦日と時刻から瞬間への変換の追加)。版ごとの作業は [docs/migration.md](./docs/migration.md) にまとめた。
|
|
572
484
|
|
|
@@ -583,11 +495,11 @@
|
|
|
583
495
|
|
|
584
496
|
### 開発
|
|
585
497
|
|
|
586
|
-
- サイズの上限(`size-limits.json
|
|
498
|
+
- サイズの上限(`size-limits.json`)を上げた
|
|
587
499
|
|
|
588
500
|
## [0.13.0] - 2026-10-20
|
|
589
501
|
|
|
590
|
-
###
|
|
502
|
+
### Migration
|
|
591
503
|
|
|
592
504
|
動作は変わりません(スケジュールから営業日カレンダーを作る関数と、判定の理由の新しい値の追加。CI の改善)。版ごとの作業は [docs/migration.md](./docs/migration.md) にまとめた。
|
|
593
505
|
|
|
@@ -603,13 +515,13 @@
|
|
|
603
515
|
|
|
604
516
|
### 開発
|
|
605
517
|
|
|
606
|
-
- CI に `consumer-types`
|
|
607
|
-
- `scripts/check-consumer-types.ts` に `--tsc <path>` を足し、わざと型エラーを含む `test/consumer/consumer-error.mts`
|
|
608
|
-
- `createCalendar` の `dayInfo` の変換を `createCalendarFromSchedule`
|
|
518
|
+
- CI に `consumer-types` ジョブを追加した
|
|
519
|
+
- `scripts/check-consumer-types.ts` に `--tsc <path>` を足し、わざと型エラーを含む `test/consumer/consumer-error.mts` が各版で失敗として報告されること(検査が機能していること)も確かめるようにした
|
|
520
|
+
- `createCalendar` の `dayInfo` の変換を `createCalendarFromSchedule` と共用の内部関数に切り出した
|
|
609
521
|
|
|
610
522
|
## [0.12.0] - 2026-10-20
|
|
611
523
|
|
|
612
|
-
###
|
|
524
|
+
### Migration
|
|
613
525
|
|
|
614
526
|
動作は変わりません(繰り返しの規則の新しい形・`dayInfo` の新しい項目の追加と、診断・CI の改善)。`bizdays-toolkit/jp`・`bizdays-toolkit/uk` の定数 `dataVersion`・`confirmedThrough` が非推奨になったので、使っていれば提供元の項目(`jp.dataVersion`・`england.confirmedThrough` など)に書き換える。版ごとの作業は [docs/migration.md](./docs/migration.md) にまとめた。
|
|
615
527
|
|
|
@@ -632,9 +544,9 @@
|
|
|
632
544
|
|
|
633
545
|
### 開発
|
|
634
546
|
|
|
635
|
-
- CI に `bench`
|
|
636
|
-
- サイズの上限(`size-limits.json
|
|
637
|
-
-
|
|
547
|
+
- CI に `bench` ジョブを追加した。`scripts/bench.ts` に `--package <dir>`・`--json <file>` を足した
|
|
548
|
+
- サイズの上限(`size-limits.json`)を上げた
|
|
549
|
+
- 性質のテストに祝日の規則を加えた
|
|
638
550
|
- ライブラリ内のテストとスクリプトで、非推奨にした定数 `confirmedThrough` の代わりに提供元の項目を使うようにした
|
|
639
551
|
|
|
640
552
|
## [0.11.1] - 2026-10-19
|
|
@@ -648,7 +560,7 @@
|
|
|
648
560
|
|
|
649
561
|
## [0.11.0] - 2026-10-19
|
|
650
562
|
|
|
651
|
-
###
|
|
563
|
+
### Migration
|
|
652
564
|
|
|
653
565
|
作業は要りません(繰り返しの規則の新しい形と、カレンダーを合成する関数の追加)。版ごとの作業は [docs/migration.md](./docs/migration.md) にまとめた。
|
|
654
566
|
|
|
@@ -667,13 +579,13 @@
|
|
|
667
579
|
|
|
668
580
|
### 開発
|
|
669
581
|
|
|
670
|
-
- サイズの上限(`size-limits.json
|
|
671
|
-
- `createCalendar` の営業日の探索・調整・月の営業日の実装を、祝日を調べる機能と 1 日分の判定を引数に取る内部関数(`buildCalendar`)に切り出し、`combineCalendars`
|
|
582
|
+
- サイズの上限(`size-limits.json`)を上げた
|
|
583
|
+
- `createCalendar` の営業日の探索・調整・月の営業日の実装を、祝日を調べる機能と 1 日分の判定を引数に取る内部関数(`buildCalendar`)に切り出し、`combineCalendars` と共用した
|
|
672
584
|
- 性質のテストに祝日の翌日の規則を加えた
|
|
673
585
|
|
|
674
586
|
## [0.10.0] - 2026-10-19
|
|
675
587
|
|
|
676
|
-
###
|
|
588
|
+
### Migration
|
|
677
589
|
|
|
678
590
|
動作は変わりません(繰り返しの規則・毎年の月日の規則への省略可能な項目の追加と、診断の改善)。`bizdays-toolkit/jp` の `toJapanDate`・`toJapanDateTime` が非推奨になったので、使っていれば `toDateString(input, "Asia/Tokyo")`・`toDateTimeParts(input, "Asia/Tokyo")`(または営業日カレンダー・スケジュールの `dateOf`・`civilOf`)に書き換える。書き換え方は [docs/migration.md](./docs/migration.md)。
|
|
679
591
|
|
|
@@ -696,8 +608,8 @@
|
|
|
696
608
|
|
|
697
609
|
### 開発
|
|
698
610
|
|
|
699
|
-
- サイズの上限(`size-limits.json
|
|
700
|
-
-
|
|
611
|
+
- サイズの上限(`size-limits.json`)を上げた
|
|
612
|
+
- 性質のテストで、有効期間と周期のある規則も作るようにした
|
|
701
613
|
|
|
702
614
|
## [0.9.1] - 2026-10-18
|
|
703
615
|
|
|
@@ -709,11 +621,11 @@
|
|
|
709
621
|
|
|
710
622
|
### 開発
|
|
711
623
|
|
|
712
|
-
- ブラウザーでの確認の Edge の起動オプションに、`--disable-dev-shm-usage` と `--disable-gpu`
|
|
624
|
+
- ブラウザーでの確認の Edge の起動オプションに、`--disable-dev-shm-usage` と `--disable-gpu` を足した
|
|
713
625
|
|
|
714
626
|
## [0.9.0] - 2026-10-18
|
|
715
627
|
|
|
716
|
-
###
|
|
628
|
+
### Migration
|
|
717
629
|
|
|
718
630
|
作業は要りません(機能の追加だけ)。時刻を必ず持つ入力では `time` の型が `string` になったので、これまでの `null` の分岐は不要になります(残しても動く)。版ごとの作業は [docs/migration.md](./docs/migration.md) にまとめた。
|
|
719
631
|
|
|
@@ -731,11 +643,9 @@
|
|
|
731
643
|
|
|
732
644
|
### 開発
|
|
733
645
|
|
|
734
|
-
- `pnpm check`
|
|
735
|
-
|
|
736
|
-
-
|
|
737
|
-
|
|
738
|
-
- ブラウザーでの確認(`scripts/test-browsers.ts`)に時間制限を設けた。ページの読み込みとスクリプトの実行は 30 秒(WebDriver の `timeouts`)、ドライバーへの各呼び出しは 60 秒。結果を受け取る前の段階(ドライバーの起動・セッションの作成・ページの読み込み・結果の待ち)で止まったときだけ、ドライバーを起動し直して 1 回だけやり直し、その理由を `RETRY` としてログに出す。確認の結果が FAIL のときはやり直さない。CI でランナー上の Edge がページの読み込みで応答しなくなり、既定の 300 秒を待って失敗したため
|
|
646
|
+
- `pnpm check` で、利用者のプロジェクトとして公開する型定義を型チェックするようにした
|
|
647
|
+
- GOV.UK の監視を、外部の cron サービス(cron-job.org)から `workflow_dispatch` で起動する形にした(毎日 06:00 日本時間)
|
|
648
|
+
- ブラウザーでの確認(`scripts/test-browsers.ts`)に時間制限を設けた
|
|
739
649
|
|
|
740
650
|
## [0.8.1] - 2026-10-18
|
|
741
651
|
|
|
@@ -748,14 +658,13 @@
|
|
|
748
658
|
|
|
749
659
|
### 開発
|
|
750
660
|
|
|
751
|
-
- 公開する `dist` を ESM(`import`)と CommonJS(`require()`)で確かめるテスト(`
|
|
752
|
-
|
|
753
|
-
-
|
|
754
|
-
- `pnpm check
|
|
755
|
-
-
|
|
756
|
-
-
|
|
757
|
-
-
|
|
758
|
-
- GOV.UK の監視のワークフローに、手動実行の入力 `simulate` を追加した。架空の祝日を 1 件足して照合し(`pnpm verify:govuk --simulate`)、ラベル `govuk-data-simulation` の issue で差分の経路を確かめられる
|
|
661
|
+
- 公開する `dist` を ESM(`import`)と CommonJS(`require()`)で確かめるテスト(`pnpm test:compat`)を追加し、`pnpm check` に含めた
|
|
662
|
+
- CI に、公開する `dist` をブラウザーと Cloudflare Workers で確かめるジョブを追加した
|
|
663
|
+
- `pnpm check` で、README(英語・日本語)のコード例を実行し、コメントに書いた結果と比べるようにした
|
|
664
|
+
- `pnpm check`(`scripts/check-package.ts`)で、`src` が Node.js 固有の機能を使っていないことを確かめるようにした
|
|
665
|
+
- 自前のスクリプトとテストで Node.js の警告が出たら失敗にするようにした
|
|
666
|
+
- `pnpm check` の最初に、開発用のツールの版を確かめる `scripts/check-toolchain.ts` を追加した
|
|
667
|
+
- GOV.UK の監視のワークフローに、手動実行の入力 `simulate` を追加した(`pnpm verify:govuk --simulate`)
|
|
759
668
|
- `pnpm check` のパッケージの中身の検査(`npm pack --dry-run`)を、Windows で Node.js の非推奨の警告(DEP0190)が出ない形で npm を起動するようにした
|
|
760
669
|
|
|
761
670
|
## [0.8.0] - 2026-10-17
|
|
@@ -772,12 +681,12 @@
|
|
|
772
681
|
|
|
773
682
|
### 開発
|
|
774
683
|
|
|
775
|
-
- `bizdays-toolkit/uk` のサイズの上限(gzip 6,700 バイト)を `size-limits.json` に追加した(エントリーの追加。計測は 6,225
|
|
776
|
-
- GOV.UK の bank holidays を毎日照合するワークフロー(`.github/workflows/govuk-watch.yml
|
|
777
|
-
- CI に、ワークフローを actionlint
|
|
684
|
+
- `bizdays-toolkit/uk` のサイズの上限(gzip 6,700 バイト)を `size-limits.json` に追加した(エントリーの追加。計測は 6,225 バイト)
|
|
685
|
+
- GOV.UK の bank holidays を毎日照合するワークフロー(`.github/workflows/govuk-watch.yml`。`pnpm verify:govuk`)を追加した
|
|
686
|
+
- CI に、ワークフローを actionlint で検査するジョブを追加した
|
|
778
687
|
- CI・リリース・監視のワークフローの Node.js を 24.21.0 から 24.22.0 に、pnpm を 12.11.2 から 12.14.0 に上げた(手元の開発環境に合わせる)
|
|
779
688
|
- `pnpm check`(`scripts/check-package.ts`)で、`README.md` と `docs/README.ja.md` の見出しの数(段ごと)とコードブロックの数が一致し、互いへの切り替えのリンクがあることを確かめるようにした
|
|
780
|
-
- `pnpm check` が、パッケージの中身を `files` の指定からの推定ではなく、実際の `npm pack --dry-run --json`
|
|
689
|
+
- `pnpm check` が、パッケージの中身を `files` の指定からの推定ではなく、実際の `npm pack --dry-run --json` の結果で確かめるようにした
|
|
781
690
|
|
|
782
691
|
## [0.7.0] - 2026-10-16
|
|
783
692
|
|
|
@@ -787,7 +696,7 @@
|
|
|
787
696
|
|
|
788
697
|
### 開発
|
|
789
698
|
|
|
790
|
-
- `size-limits.json` の値を上げるときの理由は、コミットメッセージではなく CHANGELOG
|
|
699
|
+
- `size-limits.json` の値を上げるときの理由は、コミットメッセージではなく CHANGELOG の「開発」に書く取り決めにした
|
|
791
700
|
|
|
792
701
|
## [0.6.0] - 2026-10-16
|
|
793
702
|
|
|
@@ -805,7 +714,7 @@
|
|
|
805
714
|
- `pnpm check`(`scripts/check-package.ts`)で、CHANGELOG の版の節の並び・日付と、末尾のリンク定義が節とそろっていることを確かめるようにした(0.5.0 でリンク定義の更新漏れがあったため)
|
|
806
715
|
- リリースのワークフローで、CHANGELOG の日付が `YYYY-MM-DD` のまま・見出しがないときの表示を分かりやすくした(止まる条件は変わらない)
|
|
807
716
|
- 月の計算と日付の調整の性質のテストを追加
|
|
808
|
-
-
|
|
717
|
+
- サイズの上限を上げた
|
|
809
718
|
- `docs/decisions.md` に 16 番目(日付の調整と月の期日の設計)を追加
|
|
810
719
|
|
|
811
720
|
## [0.5.0] - 2026-10-16
|
|
@@ -824,7 +733,7 @@
|
|
|
824
733
|
|
|
825
734
|
### 開発
|
|
826
735
|
|
|
827
|
-
-
|
|
736
|
+
- 診断の性質のテスト: 使われない・取り除いても変わらないと診断した規則を実際に取り除き、結果が変わらないことを乱数の設定で確かめる
|
|
828
737
|
- サイズの上限に `./diagnose` を追加
|
|
829
738
|
- `docs/decisions.md` に 15 番目(規則の診断の設計)を追加
|
|
830
739
|
|
|
@@ -845,7 +754,7 @@
|
|
|
845
754
|
### 開発
|
|
846
755
|
|
|
847
756
|
- 性能の計測(`pnpm bench`、依存なし)を追加
|
|
848
|
-
- README
|
|
757
|
+
- README に繰り返しの規則の節と、よくある設定の例を追加
|
|
849
758
|
|
|
850
759
|
## [0.3.1] - 2026-10-15
|
|
851
760
|
|
|
@@ -854,7 +763,7 @@
|
|
|
854
763
|
### 開発
|
|
855
764
|
|
|
856
765
|
- lint に oxlint(1.88.0)を導入し、`pnpm check` と CI で実行するようにした(`.oxlintrc.json`)
|
|
857
|
-
-
|
|
766
|
+
- 型チェックを強めた
|
|
858
767
|
- oxfmt を 0.73.0 に更新
|
|
859
768
|
- 改行コードを LF に統一した(`.gitattributes`)
|
|
860
769
|
|
|
@@ -933,7 +842,9 @@
|
|
|
933
842
|
|
|
934
843
|
- 日本: 2026 年 2 月の官報(2027 年の春分・秋分の日)まで反映(`dataVersion: "2026-02"`、`confirmedThrough: 2027`)
|
|
935
844
|
|
|
936
|
-
[Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.
|
|
845
|
+
[Unreleased]: https://github.com/inohan77/bizdays-toolkit/compare/v0.31.0...HEAD
|
|
846
|
+
[0.31.0]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.9...v0.31.0
|
|
847
|
+
[0.30.9]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.8...v0.30.9
|
|
937
848
|
[0.30.8]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.7...v0.30.8
|
|
938
849
|
[0.30.7]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.6...v0.30.7
|
|
939
850
|
[0.30.6]: https://github.com/inohan77/bizdays-toolkit/compare/v0.30.5...v0.30.6
|