@fin.cx/opendata 3.6.0 → 4.1.0

package/dist_ts/handelsregister/references.js

@@ -0,0 +1,146 @@
+import { registerTypes } from './constants.js';
+import { registerCourts } from './data.codelists.js';
+const collapse = (textArg) => textArg.replace(/\s+/g, ' ').trim();
+/** German letters as a text without them spells them: `Muenchen` is `München` */
+const spelledOut = { 'ä': 'ae', 'ö': 'oe', 'ü': 'ue', 'ß': 'ss' };
+/** words that name a court or a register rather than its place */
+const courtWords = 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) => {
+    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(' ');
+};
+/**
+ * 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 = {
+    '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) => {
+    const byKey = new Map();
+    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;
+/**
+ * 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, courtsArg = registerCourts) => {
+    if (typeof codeOrNameArg !== 'string') {
+        return undefined;
+    }
+    const text = collapse(codeOrNameArg);
+    if (!text) {
+        return undefined;
+    }
+    const byCode = courtsArg.find((courtArg) => courtArg.code.toUpperCase() === text.toUpperCase());
+    if (byCode) {
+        return byCode;
+    }
+    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 */
+export const toRegisterType = (textArg) => registerTypes.find((typeArg) => typeArg.toLowerCase() === collapse(textArg).toLowerCase());
+/** splits `35230 HB`, `35230HB` or `35230` into digits and location suffix */
+export const parseRegisterNumber = (textArg) => {
+    const match = /^(\d{1,9})\s*([A-Za-zÄÖÜäöü]{1,5})?$/.exec(collapse(textArg));
+    if (!match) {
+        return undefined;
+    }
+    return match[2] ? { digits: match[1], suffix: match[2].toLocaleUpperCase('de-DE') } : { digits: match[1] };
+};
+export const formatRegisterNumber = (partsArg) => partsArg.suffix ? `${partsArg.digits} ${partsArg.suffix}` : partsArg.digits;
+/**
+ * Reads a register reference as businesses print it: `Amtsgericht Bremen HRB 35230 HB`,
+ * `AG Bremen, HRB 35230`, `HRB 35230 HB`. Returns undefined for text it cannot read. A court name
+ * that fits no register court leaves `court` absent and keeps the text in `courtText`.
+ */
+export const parseRegisterReferenceText = (textArg, courtsArg = registerCourts) => {
+    const text = collapse(textArg);
+    const match = /^(.*?)[\s,;:]*\b(HRA|HRB|GnR|PR|VR|GsR)\b\.?\s*(?:Nr\.?\s*)?(\d{1,9}(?:\s*[A-Za-zÄÖÜäöü]{1,5})?)(?=\s|$)(?:\s+früher\s+Amtsgericht\s+.+)?$/i.exec(text);
+    if (!match) {
+        return undefined;
+    }
+    const type = toRegisterType(match[2]);
+    const number = parseRegisterNumber(match[3]);
+    if (!type || !number) {
+        return undefined;
+    }
+    const courtText = collapse(match[1].replace(/[,;:]+$/, ''));
+    const result = { type, number: formatRegisterNumber(number) };
+    if (courtText) {
+        result.courtText = courtText;
+        const court = findRegisterCourt(courtText, courtsArg);
+        if (court) {
+            result.court = court;
+        }
+    }
+    return result;
+};
+/** `Amtsgericht Bremen HRB 35230 HB` */
+export const formatRegisterReference = (referenceArg) => `Amtsgericht ${referenceArg.court.name} ${referenceArg.type} ${referenceArg.number}`;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVmZXJlbmNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2hhbmRlbHNyZWdpc3Rlci9yZWZlcmVuY2VzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUMvQyxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFvQnJELE1BQU0sUUFBUSxHQUFHLENBQUMsT0FBZSxFQUFVLEVBQUUsQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLE1BQU0sRUFBRSxHQUFHLENBQUMsQ0FBQyxJQUFJLEVBQUUsQ0FBQztBQUVsRixpRkFBaUY7QUFDakYsTUFBTSxVQUFVLEdBQXFDLEVBQUUsR0FBRyxFQUFFLElBQUksRUFBRSxHQUFHLEVBQUUsSUFBSSxFQUFFLEdBQUcsRUFBRSxJQUFJLEVBQUUsR0FBRyxFQUFFLElBQUksRUFBRSxDQUFDO0FBRXBHLGtFQUFrRTtBQUNsRSxNQUFNLFVBQVUsR0FBd0IsSUFBSSxHQUFHLENBQUM7SUFDOUMsYUFBYTtJQUNiLGNBQWM7SUFDZCxJQUFJO0lBQ0osaUJBQWlCO0lBQ2pCLGtCQUFrQjtJQUNsQixpQkFBaUI7SUFDakIseUJBQXlCO0lBQ3pCLHdCQUF3QjtJQUN4QixpQkFBaUI7SUFDakIsdUJBQXVCO0lBQ3ZCLFdBQVc7SUFDWCxNQUFNO0lBQ04sS0FBSztJQUNMLEtBQUs7Q0FDTixDQUFDLENBQUM7QUFFSDs7Ozs7R0FLRztBQUNILE1BQU0sUUFBUSxHQUFHLENBQUMsT0FBZSxFQUFVLEVBQUU7SUFDM0MsTUFBTSxLQUFLLEdBQUcsT0FBTztTQUNsQixTQUFTLENBQUMsS0FBSyxDQUFDO1NBQ2hCLGlCQUFpQixDQUFDLE9BQU8sQ0FBQztTQUMxQixPQUFPLENBQUMsU0FBUyxFQUFFLENBQUMsU0FBUyxFQUFFLEVBQUUsQ0FBQyxVQUFVLENBQUMsU0FBUyxDQUFDLElBQUksU0FBUyxDQUFDO1NBQ3JFLEtB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

package/dist_ts/holidays/calendar.d.ts

@@ -0,0 +1,32 @@
+import type { IGermanState, IPublicHoliday, IWorkingDayOptions, TGermanStateCode, TIsoDate } from './interfaces.js';
+/**
+ * Easter Sunday of a year of the Gregorian calendar, by the algorithm of Meeus, Jones and
+ * Butcher. The Easter-based holidays follow from it.
+ */
+export declare const easterSunday: (yearArg: number) => TIsoDate;
+/**
+ * The statutory public holidays of a state in a year, in the order of their dates. Regional
+ * holidays are included with `scope: 'regional'` and the part of the state they apply to.
+ */
+export declare const getPublicHolidays: (yearArg: number, stateArg: TGermanStateCode) => IPublicHoliday[];
+/** The statutory public holidays of a state on a date, regional ones included. */
+export declare const getPublicHolidaysOn: (dateArg: TIsoDate, stateArg: TGermanStateCode) => IPublicHoliday[];
+/** Whether a date is a statutory public holiday in a state. */
+export declare const isPublicHoliday: (dateArg: TIsoDate, stateArg: TGermanStateCode, optionsArg: IWorkingDayOptions) => boolean;
+/**
+ * Whether a date is a working day in a state in the sense of § 193 BGB: neither a Saturday, nor a
+ * Sunday, nor a statutory public holiday.
+ */
+export declare const isWorkingDay: (dateArg: TIsoDate, stateArg: TGermanStateCode, optionsArg: IWorkingDayOptions) => boolean;
+/** The first working day after a date (§ 193 BGB: not a Saturday, Sunday or public holiday). */
+export declare const nextWorkingDay: (dateArg: TIsoDate, stateArg: TGermanStateCode, optionsArg: IWorkingDayOptions) => TIsoDate;
+/**
+ * The date itself when it is a working day, otherwise the next working day: the day that takes the
+ * place of a fixed day or of the last day of a period under § 193 BGB.
+ */
+export declare const workingDayOnOrAfter: (dateArg: TIsoDate, stateArg: TGermanStateCode, optionsArg: IWorkingDayOptions) => TIsoDate;
+/**
+ * The federal state for a code or a name: `DE-BY`, `BY` or `Bayern`, compared without regard to
+ * case and surrounding whitespace.
+ */
+export declare const findGermanState: (valueArg: string) => IGermanState | undefined;

package/dist_ts/holidays/calendar.js

@@ -0,0 +1,200 @@
+import { HolidayCalendarError } from './classes.holidaycalendarerror.js';
+import { germanStates, holidayCalendarFirstYear, holidayRules } from './data.holidays.js';
+const dayMs = 86_400_000;
+const lastYear = 9999;
+const pad = (valueArg, lengthArg) => String(valueArg).padStart(lengthArg, '0');
+const toIsoDate = (utcArg) => {
+    const date = new Date(utcArg);
+    return `${pad(date.getUTCFullYear(), 4)}-${pad(date.getUTCMonth() + 1, 2)}-${pad(date.getUTCDate(), 2)}`;
+};
+const utcOf = (yearArg, monthArg, dayArg) => {
+    const date = new Date(0);
+    date.setUTCFullYear(yearArg, monthArg - 1, dayArg);
+    date.setUTCHours(0, 0, 0, 0);
+    return date.getTime();
+};
+const checkYear = (yearArg) => {
+    if (!Number.isInteger(yearArg) || yearArg < holidayCalendarFirstYear || yearArg > lastYear) {
+        throw new HolidayCalendarError('unsupported_year', `The holiday calendar answers for the years ${holidayCalendarFirstYear} to ${lastYear}, not for ${String(yearArg)}.`);
+    }
+};
+const parseIsoDate = (dateArg) => {
+    const match = typeof dateArg === 'string' ? /^(\d{4})-(\d{2})-(\d{2})$/.exec(dateArg) : null;
+    if (!match) {
+        throw new HolidayCalendarError('invalid_date', `A date is written YYYY-MM-DD; ${JSON.stringify(dateArg)} is not.`);
+    }
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    checkYear(year);
+    const utc = utcOf(year, month, day);
+    if (toIsoDate(utc) !== dateArg) {
+        throw new HolidayCalendarError('invalid_date', `${dateArg} is not a date of the calendar.`);
+    }
+    return { year, utc };
+};
+const checkState = (stateArg) => {
+    if (!germanStates.some((stateEntry) => stateEntry.code === stateArg)) {
+        throw new HolidayCalendarError('unknown_state', `${JSON.stringify(stateArg)} is not the ISO 3166-2 code of a German federal state, such as DE-BY.`);
+    }
+};
+const checkOptions = (optionsArg) => {
+    const policy = optionsArg?.regionalHolidays;
+    if (policy !== 'count' && policy !== 'ignore') {
+        throw new HolidayCalendarError('invalid_options', 'Say how regional holidays are treated: { regionalHolidays: "count" } or { regionalHolidays: "ignore" }.');
+    }
+};
+/**
+ * Easter Sunday of a year of the Gregorian calendar, by the algorithm of Meeus, Jones and
+ * Butcher. The Easter-based holidays follow from it.
+ */
+export const easterSunday = (yearArg) => {
+    checkYear(yearArg);
+    return toIsoDate(easterUtc(yearArg));
+};
+const easterUtc = (yearArg) => {
+    const a = yearArg % 19;
+    const b = Math.floor(yearArg / 100);
+    const c = yearArg % 100;
+    const d = Math.floor(b / 4);
+    const e = b % 4;
+    const f = Math.floor((b + 8) / 25);
+    const g = Math.floor((b - f + 1) / 3);
+    const h = (19 * a + b - d - g + 15) % 30;
+    const i = Math.floor(c / 4);
+    const k = c % 4;
+    const l = (32 + 2 * e + 2 * i - h - k) % 7;
+    const m = Math.floor((a + 11 * h + 22 * l) / 451);
+    const month = Math.floor((h + l - 7 * m + 114) / 31);
+    const day = ((h + l - 7 * m + 114) % 31) + 1;
+    return utcOf(yearArg, month, day);
+};
+/** the Wednesday before the last Sunday before the first Sunday of Advent (16 to 22 November) */
+const bussUndBettagUtc = (yearArg) => {
+    const christmasEve = utcOf(yearArg, 12, 24);
+    const fourthAdvent = christmasEve - new Date(christmasEve).getUTCDay() * dayMs;
+    const firstAdvent = fourthAdvent - 21 * dayMs;
+    return firstAdvent - 11 * dayMs;
+};
+const dateOf = (ruleArg, yearArg) => {
+    switch (ruleArg.kind) {
+        case 'fixed':
+            return utcOf(yearArg, ruleArg.month, ruleArg.day);
+        case 'easter':
+            return easterUtc(yearArg) + ruleArg.offset * dayMs;
+        case 'buss-und-bettag':
+            return bussUndBettagUtc(yearArg);
+    }
+};
+const appliesIn = (ruleArg, yearArg) => (ruleArg.onlyYear === undefined || ruleArg.onlyYear === yearArg) &&
+    (ruleArg.fromYear === undefined || yearArg >= ruleArg.fromYear);
+const holidaysByYearAndState = new Map();
+const holidaysOf = (yearArg, stateArg) => {
+    const key = `${yearArg}:${stateArg}`;
+    const known = holidaysByYearAndState.get(key);
+    if (known) {
+        return known;
+    }
+    const holidays = holidayRules
+        .filter((ruleArg) => ruleArg.state === stateArg && appliesIn(ruleArg, yearArg))
+        .map((ruleArg) => ({ utc: dateOf(ruleArg.date, yearArg), rule: ruleArg }))
+        .sort((leftArg, rightArg) => leftArg.utc - rightArg.utc)
+        .map(({ utc, rule }) => {
+        const holiday = {
+            date: toIsoDate(utc),
+            id: rule.id,
+            name: rule.name,
+            state: rule.state,
+            scope: rule.scope,
+            legalBasis: rule.legalBasis,
+        };
+        if (rule.region !== undefined) {
+            holiday.region = rule.region;
+        }
+        return Object.freeze(holiday);
+    });
+    const frozen = Object.freeze(holidays);
+    holidaysByYearAndState.set(key, frozen);
+    return frozen;
+};
+/**
+ * The statutory public holidays of a state in a year, in the order of their dates. Regional
+ * holidays are included with `scope: 'regional'` and the part of the state they apply to.
+ */
+export const getPublicHolidays = (yearArg, stateArg) => {
+    checkYear(yearArg);
+    checkState(stateArg);
+    return [...holidaysOf(yearArg, stateArg)];
+};
+/** The statutory public holidays of a state on a date, regional ones included. */
+export const getPublicHolidaysOn = (dateArg, stateArg) => {
+    const day = parseIsoDate(dateArg);
+    checkState(stateArg);
+    return holidaysOf(day.year, stateArg).filter((holidayArg) => holidayArg.date === dateArg);
+};
+const isHolidayUtc = (utcArg, stateArg, optionsArg) => {
+    const date = toIsoDate(utcArg);
+    const year = new Date(utcArg).getUTCFullYear();
+    checkYear(year);
+    return holidaysOf(year, stateArg).some((holidayArg) => holidayArg.date === date && (holidayArg.scope === 'state' || optionsArg.regionalHolidays === 'count'));
+};
+const isWorkingDayUtc = (utcArg, stateArg, optionsArg) => {
+    const weekday = new Date(utcArg).getUTCDay();
+    return weekday !== 0 && weekday !== 6 && !isHolidayUtc(utcArg, stateArg, optionsArg);
+};
+/** Whether a date is a statutory public holiday in a state. */
+export const isPublicHoliday = (dateArg, stateArg, optionsArg) => {
+    const day = parseIsoDate(dateArg);
+    checkState(stateArg);
+    checkOptions(optionsArg);
+    return isHolidayUtc(day.utc, stateArg, optionsArg);
+};
+/**
+ * Whether a date is a working day in a state in the sense of § 193 BGB: neither a Saturday, nor a
+ * Sunday, nor a statutory public holiday.
+ */
+export const isWorkingDay = (dateArg, stateArg, optionsArg) => {
+    const day = parseIsoDate(dateArg);
+    checkState(stateArg);
+    checkOptions(optionsArg);
+    return isWorkingDayUtc(day.utc, stateArg, optionsArg);
+};
+/** The first working day after a date (§ 193 BGB: not a Saturday, Sunday or public holiday). */
+export const nextWorkingDay = (dateArg, stateArg, optionsArg) => {
+    const day = parseIsoDate(dateArg);
+    checkState(stateArg);
+    checkOptions(optionsArg);
+    let utc = day.utc + dayMs;
+    while (!isWorkingDayUtc(utc, stateArg, optionsArg)) {
+        utc += dayMs;
+    }
+    return toIsoDate(utc);
+};
+/**
+ * The date itself when it is a working day, otherwise the next working day: the day that takes the
+ * place of a fixed day or of the last day of a period under § 193 BGB.
+ */
+export const workingDayOnOrAfter = (dateArg, stateArg, optionsArg) => {
+    const day = parseIsoDate(dateArg);
+    checkState(stateArg);
+    checkOptions(optionsArg);
+    let utc = day.utc;
+    while (!isWorkingDayUtc(utc, stateArg, optionsArg)) {
+        utc += dayMs;
+    }
+    return toIsoDate(utc);
+};
+/**
+ * The federal state for a code or a name: `DE-BY`, `BY` or `Bayern`, compared without regard to
+ * case and surrounding whitespace.
+ */
+export const findGermanState = (valueArg) => {
+    if (typeof valueArg !== 'string') {
+        return undefined;
+    }
+    const value = valueArg.trim().toLocaleLowerCase('de-DE');
+    return germanStates.find((stateArg) => stateArg.code.toLowerCase() === value ||
+        stateArg.code.slice(3).toLowerCase() === value ||
+        stateArg.name.toLocaleLowerCase('de-DE') === value);
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2FsZW5kYXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9ob2xpZGF5cy9jYWxlbmRhci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSxtQ0FBbUMsQ0FBQztBQUN6RSxPQUFPLEVBQUUsWUFBWSxFQUFFLHdCQUF3QixFQUFFLFlBQVksRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBVTFGLE1BQU0sS0FBSyxHQUFHLFVBQVUsQ0FBQztBQUN6QixNQUFNLFFBQVEsR0FBRyxJQUFJLENBQUM7QUFRdEIsTUFBTSxHQUFHLEdBQUcsQ0FBQyxRQUFnQixFQUFFLFNBQWlCLEVBQVUsRUFBRSxDQUFDLE1BQU0sQ0FBQyxRQUFRLENBQUMsQ0FBQyxRQUFRLENBQUMsU0FBUyxFQUFFLEdBQUcsQ0FBQyxDQUFDO0FBRXZHLE1BQU0sU0FBUyxHQUFHLENBQUMsTUFBYyxFQUFZLEVBQUU7SUFDN0MsTUFBTSxJQUFJLEdBQUcsSUFBSSxJQUFJLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDOUIsT0FBTyxHQUFHLEdBQUcsQ0FBQyxJQUFJLENBQUMsY0FBYyxFQUFFLEVBQUUsQ0FBQyxDQUFDLElBQUksR0FBRyxDQUFDLElBQUksQ0FBQyxXQUFXLEVBQUUsR0FBRyxDQUFDLEVBQUUsQ0FBQyxDQUFDLElBQUksR0FBRyxDQUFDLElBQUksQ0FBQyxVQUFVLEVBQUUsRUFBRSxDQUFDLENBQUMsRUFBRSxDQUFDO0FBQzNHLENBQUMsQ0FBQztBQUVGLE1BQU0sS0FBSyxHQUFHLENBQUMsT0FBZSxFQUFFLFFBQWdCLEVBQUUsTUFBYyxFQUFVLEVBQUU7SUFDMUUsTUFBTSxJQUFJLEdBQUcsSUFBSSxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDekIsSUFBSSxDQUFDLGNBQWMsQ0FBQyxPQUFPLEVBQUUsUUFBUSxHQUFHLENBQUMsRUFBRSxNQUFNLENBQUMsQ0FBQztJQUNuRCxJQUFJLENBQUMsV0FBVyxD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

package/dist_ts/holidays/classes.holidaycalendarerror.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Why a question to the holiday calendar was refused:
+ * - `invalid_date`: the value is not a calendar date written `YYYY-MM-DD`;
+ * - `unsupported_year`: the year lies before the first year the calendar answers for (2018) or
+ *   after 9999;
+ * - `unknown_state`: the value is not the code of a German federal state;
+ * - `invalid_options`: the options do not say how to treat regional holidays.
+ */
+export type THolidayCalendarErrorCode = 'invalid_date' | 'unsupported_year' | 'unknown_state' | 'invalid_options';
+/** The typed error of the holiday calendar. */
+export declare class HolidayCalendarError extends Error {
+    readonly code: THolidayCalendarErrorCode;
+    constructor(code: THolidayCalendarErrorCode, message: string);
+}

package/dist_ts/holidays/classes.holidaycalendarerror.js

@@ -0,0 +1,10 @@
+/** The typed error of the holiday calendar. */
+export class HolidayCalendarError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'HolidayCalendarError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5ob2xpZGF5Y2FsZW5kYXJlcnJvci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2hvbGlkYXlzL2NsYXNzZXMuaG9saWRheWNhbGVuZGFyZXJyb3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBVUEsK0NBQStDO0FBQy9DLE1BQU0sT0FBTyxvQkFBcUIsU0FBUSxLQUFLO0lBQzdCLElBQUksQ0FBNEI7SUFFaEQsWUFBWSxJQUErQixFQUFFLE9BQWU7UUFDMUQsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQ2YsSUFBSSxDQUFDLElBQUksR0FBRyxzQkFBc0IsQ0FBQztRQUNuQyxJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQztJQUNuQixDQUFDO0NBQ0YifQ==

package/dist_ts/holidays/data.holidays.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The statutory public holidays of the German federal states, taken from the holiday laws of the
+ * states (Feiertagsgesetze) and, for 3 October, from Art. 2 Abs. 2 of the Unification Treaty
+ * (Einigungsvertrag). The provisions were read on 2026-09-24 in the official law portals of the
+ * states; the readme lists them with their links.
+ *
+ * The rules cover the years from 2018 on. Every change of a state's list since then is recorded
+ * with the year it first applies: 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 (2020, 2025, 2028).
+ */
+import type { IGermanState, TGermanStateCode, TPublicHolidayId, TPublicHolidayScope } from './interfaces.js';
+/** the first year the calendar answers for */
+export declare const holidayCalendarFirstYear = 2018;
+/** the day the holiday laws were read; later changes need a new release */
+export declare const holidayLawsReadOn = "2026-09-24";
+export declare const germanStates: readonly IGermanState[];
+/** how the date of a holiday follows from the year */
+export type THolidayDateRule = {
+    kind: 'fixed';
+    month: number;
+    day: number;
+}
+/** days after Easter Sunday; negative before it */
+ | {
+    kind: 'easter';
+    offset: number;
+}
+/** the Wednesday before the last Sunday before the first Sunday of Advent */
+ | {
+    kind: 'buss-und-bettag';
+};
+export interface IHolidayRule {
+    id: TPublicHolidayId;
+    name: string;
+    date: THolidayDateRule;
+    state: TGermanStateCode;
+    scope: TPublicHolidayScope;
+    region?: string;
+    legalBasis: string;
+    /** the first year the holiday applies */
+    fromYear?: number;
+    /** the only year a one-off holiday applies */
+    onlyYear?: number;
+}
+export declare const holidayRules: readonly IHolidayRule[];

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