@fin.cx/opendata 4.0.0 → 4.1.0

package/dist_ts/holidays/data.holidays.js

@@ -0,0 +1,124 @@
+/** the first year the calendar answers for */
+export const holidayCalendarFirstYear = 2018;
+/** the day the holiday laws were read; later changes need a new release */
+export const holidayLawsReadOn = '2026-09-24';
+export const germanStates = Object.freeze([
+    { code: 'DE-BW', name: 'Baden-Württemberg' },
+    { code: 'DE-BY', name: 'Bayern' },
+    { code: 'DE-BE', name: 'Berlin' },
+    { code: 'DE-BB', name: 'Brandenburg' },
+    { code: 'DE-HB', name: 'Bremen' },
+    { code: 'DE-HH', name: 'Hamburg' },
+    { code: 'DE-HE', name: 'Hessen' },
+    { code: 'DE-MV', name: 'Mecklenburg-Vorpommern' },
+    { code: 'DE-NI', name: 'Niedersachsen' },
+    { code: 'DE-NW', name: 'Nordrhein-Westfalen' },
+    { code: 'DE-RP', name: 'Rheinland-Pfalz' },
+    { code: 'DE-SL', name: 'Saarland' },
+    { code: 'DE-SN', name: 'Sachsen' },
+    { code: 'DE-ST', name: 'Sachsen-Anhalt' },
+    { code: 'DE-SH', name: 'Schleswig-Holstein' },
+    { code: 'DE-TH', name: 'Thüringen' },
+]);
+/** the provision of each state's holiday law that lists its statutory holidays */
+const holidayListOf = {
+    'DE-BW': '§ 1 FTG (Baden-Württemberg)',
+    'DE-BY': 'Art. 1 Abs. 1 Nr. 1 FTG (Bayern)',
+    'DE-BE': '§ 1 Abs. 1 Gesetz über die Sonn- und Feiertage (Berlin)',
+    'DE-BB': '§ 2 Abs. 1 FTG (Brandenburg)',
+    'DE-HB': '§ 2 Abs. 1 Gesetz über die Sonn-, Gedenk- und Feiertage (Bremen)',
+    'DE-HH': '§ 1 Feiertagsgesetz (Hamburg)',
+    'DE-HE': '§ 1 Abs. 1 HFeiertagsG',
+    'DE-MV': '§ 2 Abs. 1 FTG M-V',
+    'DE-NI': '§ 2 Abs. 1 NFeiertagsG',
+    'DE-NW': '§ 2 Abs. 1 Feiertagsgesetz NW',
+    'DE-RP': '§ 2 Abs. 1 LFtG',
+    'DE-SL': '§ 2 Abs. 1 SFG',
+    'DE-SN': '§ 1 Abs. 1 SächsSFG',
+    'DE-ST': '§ 2 FeiertG LSA',
+    'DE-SH': '§ 2 Abs. 1 SFTG',
+    'DE-TH': '§ 2 Abs. 1 ThürFGtG',
+};
+const allStates = germanStates.map((stateArg) => stateArg.code);
+const fixed = (month, day) => ({ kind: 'fixed', month, day });
+const easter = (offset) => ({ kind: 'easter', offset });
+/** a holiday in the whole of each listed state, by that state's holiday list */
+const statewide = (id, name, date, states, extra = {}) => states.map((state) => ({ id, name, date, state, scope: 'state', legalBasis: holidayListOf[state], ...extra }));
+export const holidayRules = Object.freeze([
+    // in every state
+    ...statewide('neujahr', 'Neujahr', fixed(1, 1), allStates),
+    ...statewide('karfreitag', 'Karfreitag', easter(-2), allStates),
+    ...statewide('ostermontag', 'Ostermontag', easter(1), allStates),
+    ...statewide('tag-der-arbeit', 'Tag der Arbeit', fixed(5, 1), allStates),
+    ...statewide('christi-himmelfahrt', 'Christi Himmelfahrt', easter(39), allStates),
+    ...statewide('pfingstmontag', 'Pfingstmontag', easter(50), allStates),
+    ...allStates.map((state) => ({
+        id: 'tag-der-deutschen-einheit',
+        name: 'Tag der Deutschen Einheit',
+        date: fixed(10, 3),
+        state,
+        scope: 'state',
+        legalBasis: 'Art. 2 Abs. 2 Einigungsvertrag',
+    })),
+    ...statewide('erster-weihnachtstag', '1. Weihnachtstag', fixed(12, 25), allStates),
+    ...statewide('zweiter-weihnachtstag', '2. Weihnachtstag', fixed(12, 26), allStates),
+    // in some states
+    ...statewide('heilige-drei-koenige', 'Heilige Drei Könige', fixed(1, 6), ['DE-BW', 'DE-BY', 'DE-ST']),
+    ...statewide('frauentag', 'Frauentag', fixed(3, 8), ['DE-BE'], { fromYear: 2019 }),
+    ...statewide('frauentag', 'Frauentag', fixed(3, 8), ['DE-MV'], { fromYear: 2023 }),
+    ...statewide('ostersonntag', 'Ostersonntag', easter(0), ['DE-BB']),
+    ...statewide('pfingstsonntag', 'Pfingstsonntag', easter(49), ['DE-BB']),
+    ...statewide('fronleichnam', 'Fronleichnam', easter(60), ['DE-BW', 'DE-BY', 'DE-HE', 'DE-NW', 'DE-RP', 'DE-SL']),
+    ...statewide('mariae-himmelfahrt', 'Mariä Himmelfahrt', fixed(8, 15), ['DE-SL']),
+    ...statewide('weltkindertag', 'Weltkindertag', fixed(9, 20), ['DE-TH'], { fromYear: 2019 }),
+    ...statewide('reformationstag', 'Reformationstag', fixed(10, 31), ['DE-BB', 'DE-MV', 'DE-SN', 'DE-ST', 'DE-TH']),
+    ...statewide('reformationstag', 'Reformationstag', fixed(10, 31), ['DE-HB', 'DE-HH', 'DE-NI', 'DE-SH'], {
+        fromYear: 2018,
+    }),
+    ...statewide('allerheiligen', 'Allerheiligen', fixed(11, 1), ['DE-BW', 'DE-BY', 'DE-NW', 'DE-RP', 'DE-SL']),
+    ...statewide('buss-und-bettag', 'Buß- und Bettag', { kind: 'buss-und-bettag' }, ['DE-SN']),
+    // one-off holidays
+    ...statewide('tag-der-befreiung', 'Tag der Befreiung', fixed(5, 8), ['DE-BE'], { onlyYear: 2020 }),
+    ...statewide('tag-der-befreiung', 'Tag der Befreiung', fixed(5, 8), ['DE-BE'], { onlyYear: 2025 }),
+    ...statewide('jahrestag-17-juni-1953', '75. Jahrestag des Aufstandes vom 17. Juni 1953', fixed(6, 17), ['DE-BE'], {
+        onlyYear: 2028,
+    }),
+    // in part of a state
+    {
+        id: 'fronleichnam',
+        name: 'Fronleichnam',
+        date: easter(60),
+        state: 'DE-SN',
+        scope: 'regional',
+        region: 'die in der Anlage der FronleichnamsVO genannten Gemeinden der früheren Landkreise Bautzen, Hoyerswerda und Kamenz, nach einer Neugliederung nur der jeweilige Gemeindeteil',
+        legalBasis: '§ 1 Abs. 1 SächsSFG i. V. m. § 1 FronleichnamsVO',
+    },
+    {
+        id: 'fronleichnam',
+        name: 'Fronleichnam',
+        date: easter(60),
+        state: 'DE-TH',
+        scope: 'regional',
+        region: 'die Teile Thüringens, in denen Fronleichnam 1994 gesetzlicher Feiertag war',
+        legalBasis: '§ 2 Abs. 2 i. V. m. § 10 Abs. 1 ThürFGtG',
+    },
+    {
+        id: 'augsburger-friedensfest',
+        name: 'Augsburger Friedensfest',
+        date: fixed(8, 8),
+        state: 'DE-BY',
+        scope: 'regional',
+        region: 'Stadt Augsburg',
+        legalBasis: 'Art. 1 Abs. 2 FTG (Bayern)',
+    },
+    {
+        id: 'mariae-himmelfahrt',
+        name: 'Mariä Himmelfahrt',
+        date: fixed(8, 15),
+        state: 'DE-BY',
+        scope: 'regional',
+        region: 'Gemeinden mit überwiegend katholischer Bevölkerung, wie das Bayerische Landesamt für Statistik sie nach der letzten Volkszählung feststellt',
+        legalBasis: 'Art. 1 Abs. 1 Nr. 2, Abs. 3 FTG (Bayern)',
+    },
+]);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGF0YS5ob2xpZGF5cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2hvbGlkYXlzL2RhdGEuaG9saWRheXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBYUEsOENBQThDO0FBQzlDLE1BQU0sQ0FBQyxNQUFNLHdCQUF3QixHQUFHLElBQUksQ0FBQztBQUU3QywyRUFBMkU7QUFDM0UsTUFBTSxDQUFDLE1BQU0saUJBQWlCLEdBQUcsWUFBWSxDQUFDO0FBRTlDLE1BQU0sQ0FBQyxNQUFNLFlBQVksR0FBNEIsTUFBTSxDQUFDLE1BQU0sQ0FBQztJQUNqRSxFQUFFLElBQUksRUFBRSxPQUFPLEVBQUUsSUFBSSxFQUFFLG1CQUFtQixFQUFFO0lBQzVDLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUFFO0lBQ2pDLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUFFO0lBQ2pDLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUsYUFBYSxFQUFFO0lBQ3RDLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUFFO0lBQ2pDLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUsU0FBUyxFQUFFO0lBQ2xDLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUFFO0lBQ2pDLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUsd0JBQXdCLEVBQUU7SUFDakQsRUFBRSxJQUFJLEVBQUUsT0FBTyxFQUFFLElBQUksRUFBRSxlQUFlLEVBQUU7SUFDeEMsRUFBRSxJQUFJLEVBQUUsT0FBTyxFQUFFLElBQUksRUFBRSxxQkFBcUIsRUFBRTtJQUM5QyxFQUFFLElBQUksRUFBRSxPQUFPLEVBQUUsSUFBSSxFQUFFLGlCQUFpQixFQUFFO0lBQzFDLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUs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

package/dist_ts/holidays/index.d.ts

@@ -0,0 +1,4 @@
+export * from './interfaces.js';
+export { HolidayCalendarError, type THolidayCalendarErrorCode, } from './classes.holidaycalendarerror.js';
+export { germanStates, holidayCalendarFirstYear, holidayLawsReadOn } from './data.holidays.js';
+export { easterSunday, findGermanState, getPublicHolidays, getPublicHolidaysOn, isPublicHoliday, isWorkingDay, nextWorkingDay, workingDayOnOrAfter, } from './calendar.js';

package/dist_ts/holidays/index.js

@@ -0,0 +1,7 @@
+// This entry point stands alone: it imports nothing from the rest of the package, has no
+// dependencies and needs no storage or network.
+export * from './interfaces.js';
+export { HolidayCalendarError, } from './classes.holidaycalendarerror.js';
+export { germanStates, holidayCalendarFirstYear, holidayLawsReadOn } from './data.holidays.js';
+export { easterSunday, findGermanState, getPublicHolidays, getPublicHolidaysOn, isPublicHoliday, isWorkingDay, nextWorkingDay, workingDayOnOrAfter, } from './calendar.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9ob2xpZGF5cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSx5RkFBeUY7QUFDekYsZ0RBQWdEO0FBQ2hELGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsT0FBTyxFQUNMLG9CQUFvQixHQUVyQixNQUFNLG1DQUFtQyxDQUFDO0FBQzNDLE9BQU8sRUFBRSxZQUFZLEVBQUUsd0JBQXdCLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUMvRixPQUFPLEVBQ0wsWUFBWSxFQUNaLGVBQWUsRUFDZixpQkFBaUIsRUFDakIsbUJBQW1CLEVBQ25CLGVBQWUsRUFDZixZQUFZLEVBQ1osY0FBYyxFQUNkLG1CQUFtQixHQUNwQixNQUFNLGVBQWUsQ0FBQyJ9

package/dist_ts/holidays/interfaces.d.ts

@@ -0,0 +1,42 @@
+/** A German federal state, as its ISO 3166-2 subdivision code. */
+export type TGermanStateCode = 'DE-BW' | 'DE-BY' | 'DE-BE' | 'DE-BB' | 'DE-HB' | 'DE-HH' | 'DE-HE' | 'DE-MV' | 'DE-NI' | 'DE-NW' | 'DE-RP' | 'DE-SL' | 'DE-SN' | 'DE-ST' | 'DE-SH' | 'DE-TH';
+/** A federal state with its name. */
+export interface IGermanState {
+    code: TGermanStateCode;
+    /** the state's name, for example `Bayern` */
+    name: string;
+}
+/** A plain calendar date, `YYYY-MM-DD`. */
+export type TIsoDate = string;
+/** The statutory public holidays the calendar knows. */
+export type TPublicHolidayId = 'neujahr' | 'heilige-drei-koenige' | 'frauentag' | 'karfreitag' | 'ostersonntag' | 'ostermontag' | 'tag-der-arbeit' | 'tag-der-befreiung' | 'christi-himmelfahrt' | 'pfingstsonntag' | 'pfingstmontag' | 'jahrestag-17-juni-1953' | 'fronleichnam' | 'augsburger-friedensfest' | 'mariae-himmelfahrt' | 'weltkindertag' | 'tag-der-deutschen-einheit' | 'reformationstag' | 'allerheiligen' | 'buss-und-bettag' | 'erster-weihnachtstag' | 'zweiter-weihnachtstag';
+/**
+ * Where a holiday applies within its state:
+ * - `state`: in the whole state;
+ * - `regional`: only in part of the state (some municipalities or parts of municipalities), which
+ *   `region` describes. The calendar holds no list of those municipalities.
+ */
+export type TPublicHolidayScope = 'state' | 'regional';
+/** One statutory public holiday on one date in one state. */
+export interface IPublicHoliday {
+    date: TIsoDate;
+    id: TPublicHolidayId;
+    /** the German name, for example `Christi Himmelfahrt` */
+    name: string;
+    state: TGermanStateCode;
+    scope: TPublicHolidayScope;
+    /** for a regional holiday, the part of the state where it applies */
+    region?: string;
+    /** the provision that makes the day a statutory holiday, for example `§ 2 Abs. 1 NFeiertagsG` */
+    legalBasis: string;
+}
+/**
+ * How a question about working days treats regional holidays, which apply only in part of a state:
+ * - `count`: as holidays, as if the place in question lies in that part. A period then never ends
+ *   on a day that is a holiday at the place, at the price of ending one day later elsewhere;
+ * - `ignore`: as working days, when the place is known to lie outside that part.
+ */
+export type TRegionalHolidayPolicy = 'count' | 'ignore';
+export interface IWorkingDayOptions {
+    regionalHolidays: TRegionalHolidayPolicy;
+}

package/dist_ts/holidays/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2hvbGlkYXlzL2ludGVyZmFjZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@fin.cx/opendata",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "private": false,
-  "description": "Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, and stock and crypto prices and fundamentals from several providers.",
+  "description": "Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, the statutory public holidays of the German federal states, and stock and crypto prices and fundamentals from several providers.",
   "main": "dist_ts/index.js",
   "typings": "dist_ts/index.d.ts",
   "exports": {
@@ -14,6 +14,10 @@
       "types": "./dist_ts/handelsregister/index.d.ts",
       "import": "./dist_ts/handelsregister/index.js"
     },
+    "./holidays": {
+      "types": "./dist_ts/holidays/index.d.ts",
+      "import": "./dist_ts/holidays/index.js"
+    },
     "./package.json": "./package.json"
   },
   "type": "module",
@@ -70,7 +74,10 @@
     "data retrieval",
     "stock prices",
     "cryptocurrency",
-    "fundamentals"
+    "fundamentals",
+    "public holidays",
+    "Feiertage",
+    "working days"
   ],
   "scripts": {
     "test": "(tstest test/ --verbose)",

package/readme.md

@@ -1,12 +1,13 @@
 # @fin.cx/opendata
 
-`@fin.cx/opendata` is a TypeScript toolbox for open business and market data: stock and crypto prices, SEC fundamentals, and lookups in the German registers through the register portal of the federal states. It is built for programmers who want scriptable APIs and real workflows instead of a thin wrapper around one remote endpoint.
+`@fin.cx/opendata` is a TypeScript toolbox for open business and market data: stock and crypto prices, SEC fundamentals, lookups in the German registers through the register portal of the federal states, and the statutory public holidays of the German federal states. It is built for programmers who want scriptable APIs and real workflows instead of a thin wrapper around one remote endpoint.
 
-It gives you three practical lanes in one package:
+It gives you four practical lanes in one package:
 
 - `StockPriceService` for stock and crypto prices with caching, retries, failover, historical ranges, and intraday support
 - `FundamentalsService` and `StockDataService` for SEC fundamentals and combined price + fundamentals payloads
 - `HandelsregisterClient`, from `@fin.cx/opendata/handelsregister`, for single lookups in the commercial, cooperative, partnership, association and civil-law partnership registers over plain HTTP, without any storage
+- the holiday calendar, from `@fin.cx/opendata/holidays`, for the statutory public holidays of each German federal state and the working days of § 193 BGB, computed per year without data files or requests
 
 ## Issue Reporting and Security
 
@@ -48,6 +49,16 @@ Everything here comes from `@fin.cx/opendata/handelsregister`. That entry point
 - `registerCourts`, `findRegisterCourt()`, `parseRegisterReferenceText()`, `formatRegisterReference()`
   The 150 register courts with their XJustiz codes, and helpers for register references as businesses print them (`Amtsgericht Bremen HRB 35230 HB`).
 
+### German Public Holidays
+
+Everything here comes from `@fin.cx/opendata/holidays`. That entry point imports nothing else of the package, has no dependencies, and makes no request.
+
+- `getPublicHolidays(year, state)`, `getPublicHolidaysOn(date, state)`
+  The statutory public holidays of a federal state in a year or on a date, each with its legal basis.
+- `isPublicHoliday()`, `isWorkingDay()`, `nextWorkingDay()`, `workingDayOnOrAfter()`
+  Holidays and working days in the sense of § 193 BGB: neither a Saturday, nor a Sunday, nor a statutory public holiday.
+- `easterSunday(year)`, `germanStates`, `findGermanState()`
+
 ## Before You Start
 
 - No stock or fundamentals providers are pre-registered. You must register them before calling the services.
@@ -312,6 +323,57 @@ import { parseStructuredContent } from '@fin.cx/opendata/handelsregister';
 const content = parseStructuredContent(xmlText);
 ```
 
+#### Printed court names
+
+`findRegisterCourt()` takes a court's code or its name as the portal or a business prints it: `AG Bremen`, `Amtsgericht Bremen – Registergericht`, `Registergericht Bremen`, `Handelsregister B des Amtsgerichts Bremen`, `Amtsgericht Frankfurt a. M.`, `Frankfurt/O.`, `Kempten` for `Kempten (Allgäu)`, `Freiburg i. Br.`, and `AG Berlin` or `Charlottenburg` for the register court of Berlin. Umlauts may be spelled out (`Muenchen`). It returns a court only when exactly one fits: `Frankfurt` alone could be either Frankfurt am Main or Frankfurt (Oder) and names no court.
+
+### Public Holidays
+
+```ts
+import {
+  getPublicHolidays,
+  isWorkingDay,
+  nextWorkingDay,
+  workingDayOnOrAfter,
+} from '@fin.cx/opendata/holidays';
+
+getPublicHolidays(2026, 'DE-NI');
+// [{ date: '2026-01-01', id: 'neujahr', name: 'Neujahr', state: 'DE-NI', scope: 'state',
+//    legalBasis: '§ 2 Abs. 1 NFeiertagsG' }, …, { date: '2026-10-31', id: 'reformationstag', … }, …]
+
+isWorkingDay('2026-06-04', 'DE-HE', { regionalHolidays: 'ignore' }); // false: Fronleichnam
+nextWorkingDay('2026-04-02', 'DE-BY', { regionalHolidays: 'ignore' }); // '2026-04-07'
+
+// § 193 BGB: a deadline that ends on a Saturday, Sunday or holiday ends on the next working day
+workingDayOnOrAfter('2026-05-14', 'DE-BY', { regionalHolidays: 'ignore' }); // '2026-05-15'
+```
+
+States are ISO 3166-2 codes (`DE-BY`); `findGermanState('Bayern')` and `findGermanState('BY')` find one. Dates are plain calendar dates written `YYYY-MM-DD`, so no time zone can move them.
+
+#### Regional holidays
+
+Four holidays apply only in part of a state:
+
+| Holiday | State | Where | Legal basis |
+| --- | --- | --- | --- |
+| Augsburger Friedensfest (8 August) | Bayern | Stadt Augsburg | Art. 1 Abs. 2 FTG |
+| Mariä Himmelfahrt (15 August) | Bayern | municipalities with a predominantly Catholic population, as the Bayerisches Landesamt für Statistik determines them after the last census | Art. 1 Abs. 1 Nr. 2, Abs. 3 FTG |
+| Fronleichnam | Sachsen | the municipalities listed in the annex of the FronleichnamsVO (former districts Bautzen, Hoyerswerda and Kamenz), after a merger only the respective part of the municipality | § 1 Abs. 1 SächsSFG, § 1 FronleichnamsVO |
+| Fronleichnam | Thüringen | the parts of Thüringen where Fronleichnam was a statutory holiday in 1994 | § 2 Abs. 2, § 10 Abs. 1 ThürFGtG |
+
+`getPublicHolidays()` lists them with `scope: 'regional'` and the `region` they apply to. The calendar holds no list of these municipalities: the Bavarian list follows the census and the Saxon and Thuringian ones name parts of municipalities, so a place cannot be matched to them reliably by a key. Every working-day question therefore says how to treat them:
+
+- `{ regionalHolidays: 'count' }` treats them as holidays. A period then never ends on a day that is a holiday at the place in question, at the price of ending one day later where it is not. Use it when the place is unknown.
+- `{ regionalHolidays: 'ignore' }` treats them as working days, when the place is known to lie outside that part.
+
+#### What the calendar covers
+
+- The statutory public holidays of the 16 federal states from 2018 on, and 3 October from Art. 2 Abs. 2 of the Unification Treaty. Every change since 2018 applies from its year: Reformationstag in Bremen, Hamburg, Niedersachsen and Schleswig-Holstein (2018), Frauentag in Berlin (2019) and Mecklenburg-Vorpommern (2023), Weltkindertag in Thüringen (2019), and the one-off holidays of Berlin on 8 May 2020, 8 May 2025 and 17 June 2028. Years before 2018 end in `HolidayCalendarError` with the code `unsupported_year`.
+- Later years follow the laws as they stood when this version read them (`holidayLawsReadOn`). Several states allow their government to declare one-off holidays by ordinance; one declared after that day needs a new version.
+- The Easter-based holidays follow Easter Sunday of the Gregorian calendar; Buß- und Bettag (Sachsen) is the Wednesday before the last Sunday before the first Sunday of Advent.
+- The laws of Berlin and Hessen also count every Sunday as a public holiday, and Brandenburg names Ostersonntag and Pfingstsonntag. The calendar lists the Sundays Brandenburg names; for working days every Sunday is excluded anyway.
+- Religious holidays that protect only church services or give employees time off (for example Fronleichnam outside its region in Sachsen, § 3 SächsSFG) and memorial days (Gedenktage) are no statutory public holidays and are not listed.
+
 ## API At A Glance
 
 ### `StockPriceService`
@@ -375,11 +437,24 @@ const content = parseStructuredContent(xmlText);
 - `formatRegisterReference(reference)`
 - `structuredContentNotice`
 
+### Holiday calendar (`@fin.cx/opendata/holidays`)
+
+- `getPublicHolidays(year, state)`
+- `getPublicHolidaysOn(date, state)`
+- `isPublicHoliday(date, state, { regionalHolidays })`
+- `isWorkingDay(date, state, { regionalHolidays })`
+- `nextWorkingDay(date, state, { regionalHolidays })`
+- `workingDayOnOrAfter(date, state, { regionalHolidays })`
+- `easterSunday(year)`
+- `germanStates`, `findGermanState(codeOrName)`
+- `holidayCalendarFirstYear`, `holidayLawsReadOn`
+- `HolidayCalendarError` with the codes `invalid_date`, `unsupported_year`, `unknown_state` and `invalid_options`
+
 ## Data Sources
 
 The package ships no market or register data. Prices and fundamentals come at run time from the providers you register (Marketstack, CoinGecko, SEC EDGAR), and register entries come at run time from the register portal of the federal states (handelsregister.de), one lookup at a time.
 
-The only data the package carries are the code tables that `@fin.cx/opendata/handelsregister` uses to decode the structured register content (`ts/handelsregister/data.codelists.ts`). They are official code lists, published on XRepository (https://www.xrepository.de), and were taken on 2026-09-23:
+The package carries two kinds of data: the holiday rules of `@fin.cx/opendata/holidays` (`ts/holidays/data.holidays.ts`), described at the end of this section, and the code tables that `@fin.cx/opendata/handelsregister` uses to decode the structured register content (`ts/handelsregister/data.codelists.ts`). The code tables are official code lists, published on XRepository (https://www.xrepository.de), and were taken on 2026-09-23:
 
 | Table | Code list | Issued by |
 | --- | --- | --- |
@@ -399,6 +474,29 @@ Codes and designations are reproduced as published, without changes. The tables
 
 A later version of a code list may add codes. The parser keeps a code it does not know as a code, without a designation, and never guesses one.
 
+The holiday calendar is derived from the holiday laws of the federal states, read on 2026-09-24 in their official portals, from Art. 2 Abs. 2 of the Unification Treaty for 3 October, and it answers the question of § 193 BGB:
+
+| State | Law | Provision |
+| --- | --- | --- |
+| all | [Einigungsvertrag](https://www.gesetze-im-internet.de/einigvtr/art_2.html) | Art. 2 Abs. 2 (Tag der Deutschen Einheit) |
+| Baden-Württemberg | [Feiertagsgesetz (FTG)](https://www.landesrecht-bw.de/perma?j=FeiertG_BW_!_1) | § 1 |
+| Bayern | [Feiertagsgesetz (FTG)](https://www.gesetze-bayern.de/Content/Document/BayFTG-1) | Art. 1 |
+| Berlin | [Gesetz über die Sonn- und Feiertage](https://gesetze.berlin.de/perma?j=FeiertG_BE_!_1) | § 1 Abs. 1 |
+| Brandenburg | [Feiertagsgesetz (FTG)](https://bravors.brandenburg.de/gesetze/ftg_2015) | § 2 Abs. 1 |
+| Bremen | [Gesetz über die Sonn-, Gedenk- und Feiertage](https://www.transparenz.bremen.de/sixcms/detail.php?gsid=bremen2014_tp.c.145882.de) | § 2 Abs. 1 |
+| Hamburg | [Feiertagsgesetz](https://www.landesrecht-hamburg.de/perma?d=jlr-NNLHH00006CB9NN00000000002) | § 1 |
+| Hessen | [Hessisches Feiertagsgesetz (HFeiertagsG)](https://www.rv.hessenrecht.hessen.de/perma?j=FeiertG_HE_!_1) | § 1 Abs. 1 |
+| Mecklenburg-Vorpommern | [Feiertagsgesetz (FTG M-V)](https://www.landesrecht-mv.de/perma?d=jlr-NNLMV00007A2FNN00000000003) | § 2 Abs. 1 |
+| Niedersachsen | [Niedersächsisches Gesetz über die Feiertage (NFeiertagsG)](https://voris.wolterskluwer-online.de/browse/document/f74bc6e7-6ded-3c2c-9afb-b34620456e56) | § 2 Abs. 1 |
+| Nordrhein-Westfalen | [Gesetz über die Sonn- und Feiertage (Feiertagsgesetz NW)](https://recht.nrw.de/lrgv/gesetz/01012000-bekanntmachung-der-neufassung-des-gesetzes-ueber-die-sonn-und-feiertage) | § 2 Abs. 1 |
+| Rheinland-Pfalz | [Feiertagsgesetz (LFtG)](https://landesrecht.rlp.de/perma?d=jlr-NNLRP00006125NN00000000004) | § 2 Abs. 1 |
+| Saarland | [Feiertagsgesetz (SFG)](https://recht.saarland.de/perma?d=jlr-NNLSL0000A2D6NN00000000007) | § 2 Abs. 1 |
+| Sachsen | [Sächsisches Sonn- und Feiertagsgesetz (SächsSFG)](https://www.revosax.sachsen.de/vorschrift/3997-SaechsSFG), [FronleichnamsVO](https://www.revosax.sachsen.de/vorschrift/4142) | § 1 Abs. 1; § 1 and annex |
+| Sachsen-Anhalt | [Gesetz über die Sonn- und Feiertage (FeiertG LSA)](https://www.landesrecht.sachsen-anhalt.de/perma?d=jlr-NNLST0000411CNN00000000003) | § 2 |
+| Schleswig-Holstein | [Gesetz über Sonn- und Feiertage (SFTG)](https://www.gesetze-rechtsprechung.sh.juris.de/perma?j=FeiertG_SH_!_2) | § 2 Abs. 1 |
+| Thüringen | [Thüringer Feier- und Gedenktagsgesetz (ThürFGtG)](https://landesrecht.thueringen.de/perma?j=FeiertG_TH_!_2) | § 2, § 10 Abs. 1 |
+| all | [Bürgerliches Gesetzbuch](https://www.gesetze-im-internet.de/bgb/__193.html) | § 193 (Sonntag, Feiertag, Sonnabend) |
+
 ## Behavior And Caveats
 
 - Historical market data is cached aggressively because it is treated as immutable.

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@fin.cx/opendata',
-  version: '4.0.0',
-  description: 'Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, and stock and crypto prices and fundamentals from several providers.'
+  version: '4.1.0',
+  description: 'Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, the statutory public holidays of the German federal states, and stock and crypto prices and fundamentals from several providers.'
 }

package/ts/handelsregister/references.ts

@@ -21,25 +21,103 @@ export interface IParsedRegisterReferenceText {
 
 const collapse = (textArg: string): string => textArg.replace(/\s+/g, ' ').trim();
 
-const courtKey = (textArg: string): string =>
-  collapse(textArg)
-    .replace(/^(?:amtsgericht|registergericht|ag)\s+/i, '')
-    .toLocaleLowerCase('de-DE');
+/** German letters as a text without them spells them: `Muenchen` is `München` */
+const spelledOut: Readonly<Record<string, string>> = { 'ä': 'ae', 'ö': 'oe', 'ü': 'ue', 'ß': 'ss' };
 
-/** the alternative name the portal puts in brackets: `Berlin (Charlottenburg)` → `charlottenburg` */
-const courtAliasKey = (nameArg: string): string | undefined => {
-  const bracket = /\(([^()]+)\)\s*$/.exec(nameArg);
-  return bracket ? courtKey(bracket[1]) : undefined;
+/** words that name a court or a register rather than its place */
+const courtWords: ReadonlySet<string> = new Set([
+  'amtsgericht',
+  'amtsgerichts',
+  'ag',
+  'registergericht',
+  'registergerichts',
+  'handelsregister',
+  'genossenschaftsregister',
+  'partnerschaftsregister',
+  'vereinsregister',
+  'gesellschaftsregister',
+  'abteilung',
+  'beim',
+  'bei',
+  'des',
+]);
+
+/**
+ * The place a printed court name names, as courts are compared: lower case, German letters spelled
+ * out, punctuation as spaces, and without the words that name a court or a register or the
+ * division of the commercial register. `Handelsregister B des Amtsgerichts Frankfurt a. M.` is
+ * `frankfurt a m`.
+ */
+const placeKey = (textArg: string): string => {
+  const words = textArg
+    .normalize('NFC')
+    .toLocaleLowerCase('de-DE')
+    .replace(/[äöüß]/g, (letterArg) => spelledOut[letterArg] ?? letterArg)
+    .split(/[^\p{L}\p{N}]+/u)
+    .filter((wordArg) => wordArg !== '');
+  return words
+    .filter((wordArg, indexArg) => {
+      const previous = words[indexArg - 1];
+      const division = (previous === 'handelsregister' || previous === 'abteilung') && (wordArg === 'a' || wordArg === 'b');
+      return !courtWords.has(wordArg) && !division;
+    })
+    .join(' ');
 };
 
 /**
- * Finds a register court by its code or its name: `H1101`, `Bremen`, `Amtsgericht Bremen`,
- * `Berlin (Charlottenburg)` or `Charlottenburg`. Returns undefined unless exactly one court fits.
+ * Other names under which the register courts are printed, for courts whose name in the official
+ * list carries a qualifier that prints leave out, abbreviate or spell out. Each name here is a name
+ * of that court alone. `Frankfurt` without `am Main` or `(Oder)` is a name of neither of the two.
+ */
+const printedCourtNames: Readonly<Record<string, readonly string[]>> = {
+  'Bad Homburg v.d.H.': ['Bad Homburg', 'Bad Homburg vor der Höhe', 'Bad Homburg v. d. Höhe'],
+  'Berlin (Charlottenburg)': ['Berlin', 'Charlottenburg', 'Charlottenburg (Berlin)'],
+  'Frankfurt am Main': ['Frankfurt a. M.', 'Frankfurt a. Main', 'Frankfurt/M.', 'Frankfurt/Main', 'Frankfurt (Main)'],
+  'Frankfurt (Oder)': ['Frankfurt/O.', 'Frankfurt a. d. O.', 'Frankfurt an der Oder', 'Frankfurt a. d. Oder'],
+  'Freiburg': ['Freiburg im Breisgau', 'Freiburg i. Br.', 'Freiburg/Breisgau', 'Freiburg (Breisgau)'],
+  'Kempten (Allgäu)': ['Kempten'],
+  'Königstein': ['Königstein im Taunus', 'Königstein i. Ts.'],
+  'Landau': ['Landau in der Pfalz', 'Landau i. d. Pfalz', 'Landau/Pfalz'],
+  'Limburg': ['Limburg an der Lahn', 'Limburg a. d. Lahn'],
+  'Ludwigshafen a.Rhein (Ludwigshafen)': ['Ludwigshafen', 'Ludwigshafen am Rhein'],
+  'Offenbach am Main': ['Offenbach', 'Offenbach a. M.'],
+  'Oldenburg (Oldenburg)': ['Oldenburg', 'Oldenburg (Oldb.)', 'Oldenburg i. O.'],
+  'St. Ingbert (St Ingbert)': ['St. Ingbert', 'Sankt Ingbert'],
+  'St. Wendel (St Wendel)': ['St. Wendel', 'Sankt Wendel'],
+  'Weiden i. d. OPf.': ['Weiden', 'Weiden in der Oberpfalz'],
+};
+
+/** every place key of a list of courts with the courts it names */
+const courtsByPlaceKey = (courtsArg: readonly IRegisterCourt[]): ReadonlyMap<string, readonly IRegisterCourt[]> => {
+  const byKey = new Map<string, IRegisterCourt[]>();
+  for (const court of courtsArg) {
+    const keys = new Set([court.name, ...(printedCourtNames[court.name] ?? [])].map(placeKey));
+    for (const key of keys) {
+      if (key !== '') {
+        byKey.set(key, [...(byKey.get(key) ?? []), court]);
+      }
+    }
+  }
+  return byKey;
+};
+
+let officialCourtKeys: ReadonlyMap<string, readonly IRegisterCourt[]> | undefined;
+
+/**
+ * Finds a register court by its code or by its name as the portal or a business prints it: `H1101`,
+ * `Bremen`, `AG Bremen`, `Amtsgericht Bremen – Registergericht`, `Registergericht Bremen`,
+ * `Handelsregister B des Amtsgerichts Bremen`, `Amtsgericht Frankfurt a. M.`, `Frankfurt (Oder)`,
+ * `Kempten (Allgäu)` or `Kempten`, `Freiburg i. Br.`, `AG Berlin` or `Charlottenburg`. Umlauts may
+ * be spelled out (`Muenchen`). Returns undefined unless exactly one court fits: a place the list
+ * does not know, and `Frankfurt` alone, name no court.
  */
 export const findRegisterCourt = (
   codeOrNameArg: string,
   courtsArg: readonly IRegisterCourt[] = registerCourts
 ): IRegisterCourt | undefined => {
+  if (typeof codeOrNameArg !== 'string') {
+    return undefined;
+  }
   const text = collapse(codeOrNameArg);
   if (!text) {
     return undefined;
@@ -48,16 +126,12 @@ export const findRegisterCourt = (
   if (byCode) {
     return byCode;
   }
-  const key = courtKey(text);
-  const byName = courtsArg.filter((courtArg) => courtKey(courtArg.name) === key);
-  if (byName.length === 1) {
-    return byName[0];
-  }
-  if (byName.length > 1) {
-    return undefined;
-  }
-  const byAlias = courtsArg.filter((courtArg) => courtAliasKey(courtArg.name) === key);
-  return byAlias.length === 1 ? byAlias[0] : undefined;
+  const keys =
+    courtsArg === registerCourts
+      ? (officialCourtKeys ??= courtsByPlaceKey(registerCourts))
+      : courtsByPlaceKey(courtsArg);
+  const courts = keys.get(placeKey(text)) ?? [];
+  return courts.length === 1 ? courts[0] : undefined;
 };
 
 /** returns the canonical register type for `hrb`, `HRB`, `gnr` …, or undefined */