tempest-react-sdk 0.78.0 → 0.80.0

package/dist/br/holidays.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"holidays.cjs","names":[],"sources":["../../src/br/holidays.ts"],"sourcesContent":["/**\n * How binding a non-working day is.\n *\n * - `\"national\"` — a feriado nacional in federal law. Nobody works, and a\n *   deadline that lands here moves.\n * - `\"banking\"` — not a statutory holiday, but a day the national financial\n *   system does not operate: Carnaval (Monday and Tuesday), Sexta-feira da\n *   Paixão and Corpus Christi. Bank branches are shut and compensation does not\n *   run, so a boleto or a TED dated here settles later — but an employer may\n *   legally require work, which is why the two kinds are separate.\n */\nexport type HolidayKind = \"national\" | \"banking\";\n\n/** One non-working day in a given year. */\nexport interface Holiday {\n    /** `YYYY-MM-DD` in the local calendar. */\n    date: string;\n    /** Portuguese name, as the law or the Bacen calendar spells it. */\n    name: string;\n    kind: HolidayKind;\n    /** `true` when the date is derived from Easter rather than fixed. */\n    movable: boolean;\n}\n\n/** Anything these helpers accept as a day. */\nexport type DateInput = Date | string;\n\n/** Options shared by the calendar helpers. */\nexport interface BusinessDayOptions {\n    /**\n     * Which kinds count as non-working. Default `[\"national\", \"banking\"]`, i.e.\n     * the Bacen calendar — the right default for anything money moves through.\n     * Pass `[\"national\"]` for a labour-law calendar.\n     */\n    kinds?: readonly HolidayKind[];\n    /**\n     * Extra non-working days, as `YYYY-MM-DD` or `Date`. This is where state and\n     * municipal holidays go: they are **not** in the built-in table and never will\n     * be — there are 5 570 municipalities, each free to declare its own.\n     */\n    extra?: readonly DateInput[];\n    /**\n     * Days of the week that are not worked, `0` = Sunday. Default `[0, 6]`.\n     */\n    weekend?: readonly number[];\n}\n\n/** Fixed-date national holidays, with the year each became one. */\nconst FIXED_HOLIDAYS: readonly {\n    month: number;\n    day: number;\n    name: string;\n    kind: HolidayKind;\n    since?: number;\n}[] = [\n    { month: 1, day: 1, name: \"Confraternização Universal\", kind: \"national\" },\n    { month: 4, day: 21, name: \"Tiradentes\", kind: \"national\" },\n    { month: 5, day: 1, name: \"Dia do Trabalho\", kind: \"national\" },\n    { month: 9, day: 7, name: \"Independência do Brasil\", kind: \"national\" },\n    { month: 10, day: 12, name: \"Nossa Senhora Aparecida\", kind: \"national\" },\n    { month: 11, day: 2, name: \"Finados\", kind: \"national\" },\n    { month: 11, day: 15, name: \"Proclamação da República\", kind: \"national\" },\n    {\n        month: 11,\n        day: 20,\n        name: \"Dia Nacional de Zumbi e da Consciência Negra\",\n        kind: \"national\",\n        since: 2024,\n    },\n    { month: 12, day: 25, name: \"Natal\", kind: \"national\" },\n];\n\n/** Easter-relative holidays, as a day offset from Easter Sunday. */\nconst MOVABLE_HOLIDAYS: readonly { offset: number; name: string; kind: HolidayKind }[] = [\n    { offset: -48, name: \"Carnaval (segunda-feira)\", kind: \"banking\" },\n    { offset: -47, name: \"Carnaval (terça-feira)\", kind: \"banking\" },\n    { offset: -2, name: \"Sexta-feira da Paixão\", kind: \"banking\" },\n    { offset: 60, name: \"Corpus Christi\", kind: \"banking\" },\n];\n\nconst DEFAULT_KINDS: readonly HolidayKind[] = [\"national\", \"banking\"];\nconst DEFAULT_WEEKEND: readonly number[] = [0, 6];\nconst MS_PER_DAY = 86_400_000;\n\n/**\n * How far a walk may go before it is treated as a bug rather than a long holiday.\n *\n * A real calendar never has more than a handful of consecutive non-working days,\n * so hitting this means `extra` or `weekend` marked every day off, and looping\n * forever is worse than an error.\n */\nconst MAX_WALK_DAYS = 400;\n\n/** `YYYY-MM-DD` from a local-calendar date. */\nfunction toIso(year: number, month: number, day: number): string {\n    return `${String(year).padStart(4, \"0\")}-${String(month).padStart(2, \"0\")}-${String(day).padStart(2, \"0\")}`;\n}\n\n/**\n * Local midnight for any accepted input.\n *\n * Everything here works on local calendar components, never on UTC: `new Date(y,\n * m, d)` and `getFullYear()/getMonth()/getDate()`. Going through `toISOString()`\n * would shift the day for every viewer east of Greenwich, and \"is today a\n * holiday\" is a question about the viewer's calendar.\n *\n * @throws {RangeError} When a string is not `YYYY-MM-DD` or a `Date` is invalid.\n */\nfunction toLocalDate(input: DateInput): Date {\n    if (typeof input === \"string\") {\n        const match = /^(\\d{4})-(\\d{2})-(\\d{2})$/.exec(input.trim());\n        if (match === null) {\n            throw new RangeError(`Expected a YYYY-MM-DD date, got ${JSON.stringify(input)}.`);\n        }\n        return new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3]));\n    }\n    if (Number.isNaN(input.getTime())) throw new RangeError(\"Received an Invalid Date.\");\n    return new Date(input.getFullYear(), input.getMonth(), input.getDate());\n}\n\n/** `YYYY-MM-DD` for any accepted input. */\nfunction isoOf(input: DateInput): string {\n    const date = toLocalDate(input);\n    return toIso(date.getFullYear(), date.getMonth() + 1, date.getDate());\n}\n\n/**\n * Easter Sunday in the Gregorian calendar.\n *\n * The anonymous Gregorian computus (Meeus/Jones/Butcher): pure integer\n * arithmetic over the year, no tables and no dependency. It is exact for every\n * Gregorian year, which is why the four movable Brazilian holidays are derived\n * from it rather than listed.\n *\n * @param year - Gregorian year.\n * @returns Local midnight of Easter Sunday.\n *\n * @example\n * easterSunday(2026); // 2026-04-05\n */\nexport function easterSunday(year: number): Date {\n    const a = year % 19;\n    const b = Math.floor(year / 100);\n    const c = year % 100;\n    const d = Math.floor(b / 4);\n    const e = b % 4;\n    const f = Math.floor((b + 8) / 25);\n    const g = Math.floor((b - f + 1) / 3);\n    const h = (19 * a + b - d - g + 15) % 30;\n    const i = Math.floor(c / 4);\n    const k = c % 4;\n    const l = (32 + 2 * e + 2 * i - h - k) % 7;\n    const m = Math.floor((a + 11 * h + 22 * l) / 451);\n    const month = Math.floor((h + l - 7 * m + 114) / 31);\n    const day = ((h + l - 7 * m + 114) % 31) + 1;\n    return new Date(year, month - 1, day);\n}\n\n/**\n * Every national non-working day in a year, ordered by date.\n *\n * **What is here:** the nine feriados nacionais in federal law (Lei 662/1949 as\n * amended by Lei 10.607/2002, Lei 6.802/1980 for 12 October, and Lei 14.759/2023\n * for 20 November, which is why that one only appears from 2024), plus the four\n * movable days the national financial system observes.\n *\n * **What is deliberately not here**, and will not be:\n *\n * - **State and municipal holidays.** A data magna varies by state and each of the\n *   5 570 municipalities may declare its own, including up to four religious\n *   days. No table can be both complete and current; pass them through\n *   `options.extra`.\n * - **Ponto facultativo.** A federal decree that lets public servants off is not a\n *   holiday and binds nobody else, so it changes no deadline.\n * - **Pre-2002 history.** The table encodes the law as it stands today. Asking for\n *   1998 returns today's set shifted to 1998, not what was in force then.\n *\n * Carnaval, Sexta-feira da Paixão and Corpus Christi are the interesting case:\n * none of them is a feriado nacional in federal law, yet CMN Resolução 4.880/2020\n * closes the banks on all four days, so a payment cannot settle. They are returned\n * with `kind: \"banking\"` — counted by default, and excluded by passing\n * `kinds: [\"national\"]`.\n *\n * @param year - Gregorian year.\n * @returns The holidays of that year, ascending by date.\n *\n * @example\n * holidaysFor(2026).filter((holiday) => holiday.kind === \"national\").length; // 9\n */\nexport function holidaysFor(year: number): Holiday[] {\n    const holidays: Holiday[] = FIXED_HOLIDAYS.filter(\n        (entry) => entry.since === undefined || year >= entry.since,\n    ).map((entry) => ({\n        date: toIso(year, entry.month, entry.day),\n        name: entry.name,\n        kind: entry.kind,\n        movable: false,\n    }));\n\n    const easter = easterSunday(year);\n    for (const entry of MOVABLE_HOLIDAYS) {\n        const date = new Date(easter.getTime() + entry.offset * MS_PER_DAY);\n        holidays.push({\n            date: toIso(date.getFullYear(), date.getMonth() + 1, date.getDate()),\n            name: entry.name,\n            kind: entry.kind,\n            movable: true,\n        });\n    }\n\n    return holidays.sort((left, right) => left.date.localeCompare(right.date));\n}\n\n/** The set of `YYYY-MM-DD` strings that count as off for a given year. */\nfunction offDays(year: number, options: BusinessDayOptions): Set<string> {\n    const kinds = options.kinds ?? DEFAULT_KINDS;\n    const days = new Set(\n        holidaysFor(year)\n            .filter((holiday) => kinds.includes(holiday.kind))\n            .map((holiday) => holiday.date),\n    );\n    for (const entry of options.extra ?? []) days.add(isoOf(entry));\n    return days;\n}\n\n/**\n * Whether a date is a national holiday.\n *\n * @param date - `YYYY-MM-DD` or a `Date`. Only the local calendar day matters.\n * @param options - See {@link BusinessDayOptions}. `weekend` is ignored here — a\n * Sunday is not a holiday, it is a Sunday.\n * @returns `true` when the day is in the table (or in `extra`).\n * @throws {RangeError} On a malformed string or an Invalid Date.\n *\n * @example\n * isHoliday(\"2026-11-20\"); // true\n * isHoliday(\"2026-02-17\"); // true — Carnaval\n * isHoliday(\"2026-02-17\", { kinds: [\"national\"] }); // false\n */\nexport function isHoliday(date: DateInput, options: BusinessDayOptions = {}): boolean {\n    const iso = isoOf(date);\n    return offDays(Number(iso.slice(0, 4)), options).has(iso);\n}\n\n/**\n * Whether a date is a working day: not a weekend, not a holiday.\n *\n * @param date - `YYYY-MM-DD` or a `Date`.\n * @param options - See {@link BusinessDayOptions}.\n * @returns `true` when work happens on that day.\n * @throws {RangeError} On a malformed string or an Invalid Date.\n *\n * @example\n * isBusinessDay(\"2026-04-03\"); // false — Sexta-feira da Paixão\n */\nexport function isBusinessDay(date: DateInput, options: BusinessDayOptions = {}): boolean {\n    const local = toLocalDate(date);\n    const weekend = options.weekend ?? DEFAULT_WEEKEND;\n    if (weekend.includes(local.getDay())) return false;\n    return !isHoliday(local, options);\n}\n\n/**\n * The first working day strictly after a date.\n *\n * Strictly after: calling it on a Wednesday returns Thursday, never the same\n * Wednesday. That is what a \"prazo de D+1\" means, and it makes the function safe\n * to call in a loop.\n *\n * @param date - `YYYY-MM-DD` or a `Date`.\n * @param options - See {@link BusinessDayOptions}.\n * @returns Local midnight of the next working day.\n * @throws {RangeError} On a malformed input, or when `options` marked so many days\n * off that no working day exists within {@link MAX_WALK_DAYS}.\n *\n * @example\n * nextBusinessDay(\"2026-12-24\"); // 2026-12-28 — the 25th is Natal, then a weekend\n */\nexport function nextBusinessDay(date: DateInput, options: BusinessDayOptions = {}): Date {\n    const cursor = toLocalDate(date);\n    for (let step = 0; step < MAX_WALK_DAYS; step += 1) {\n        cursor.setDate(cursor.getDate() + 1);\n        if (isBusinessDay(cursor, options)) return cursor;\n    }\n    throw new RangeError(\n        `No business day within ${MAX_WALK_DAYS} days of ${isoOf(date)} — check \\`weekend\\` and \\`extra\\`.`,\n    );\n}\n\n/**\n * Move a date by a number of working days.\n *\n * `n` days forward means `n` calls to {@link nextBusinessDay}; a negative `n`\n * walks backwards the same way. `n === 0` returns the day unchanged **even when it\n * is not a working day** — snapping silently would hide the case a caller most\n * needs to see.\n *\n * @param date - `YYYY-MM-DD` or a `Date`.\n * @param days - Working days to add. May be negative.\n * @param options - See {@link BusinessDayOptions}.\n * @returns Local midnight of the resulting day.\n * @throws {RangeError} On a malformed input, or on a calendar with no working days.\n *\n * @example\n * addBusinessDays(\"2026-04-01\", 2); // 2026-04-06 — skips Good Friday and the weekend\n */\nexport function addBusinessDays(\n    date: DateInput,\n    days: number,\n    options: BusinessDayOptions = {},\n): Date {\n    const cursor = toLocalDate(date);\n    const direction = days < 0 ? -1 : 1;\n    for (let moved = 0; moved < Math.abs(days); moved += 1) {\n        let landed = false;\n        for (let step = 0; step < MAX_WALK_DAYS && !landed; step += 1) {\n            cursor.setDate(cursor.getDate() + direction);\n            landed = isBusinessDay(cursor, options);\n        }\n        if (!landed) {\n            throw new RangeError(\n                `No business day within ${MAX_WALK_DAYS} days while walking from ${isoOf(date)} — ` +\n                    \"check `weekend` and `extra`.\",\n            );\n        }\n    }\n    return cursor;\n}\n"],"mappings":"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"}
+{"version":3,"file":"holidays.cjs","names":["FIXED_HOLIDAYS","MOVABLE_HOLIDAYS","DEFAULT_KINDS","DEFAULT_WEEKEND","MS_PER_DAY","MAX_WALK_DAYS","toIso","year","month","day","toLocalDate","input","match","isoOf","date","easterSunday","a","b","c","d","e","f","g","h","i","k","l","m","holidaysFor","holidays","entry","easter","left","right","offDays","kinds","options","days","holiday","isHoliday","iso","isBusinessDay","local","nextBusinessDay","cursor","step","addBusinessDays","direction","moved","landed"],"sources":["../../src/br/holidays.ts"],"sourcesContent":["/**\n * How binding a non-working day is.\n *\n * - `\"national\"` — a feriado nacional in federal law. Nobody works, and a\n *   deadline that lands here moves.\n * - `\"banking\"` — not a statutory holiday, but a day the national financial\n *   system does not operate: Carnaval (Monday and Tuesday), Sexta-feira da\n *   Paixão and Corpus Christi. Bank branches are shut and compensation does not\n *   run, so a boleto or a TED dated here settles later — but an employer may\n *   legally require work, which is why the two kinds are separate.\n */\nexport type HolidayKind = \"national\" | \"banking\";\n\n/** One non-working day in a given year. */\nexport interface Holiday {\n    /** `YYYY-MM-DD` in the local calendar. */\n    date: string;\n    /** Portuguese name, as the law or the Bacen calendar spells it. */\n    name: string;\n    kind: HolidayKind;\n    /** `true` when the date is derived from Easter rather than fixed. */\n    movable: boolean;\n}\n\n/** Anything these helpers accept as a day. */\nexport type DateInput = Date | string;\n\n/** Options shared by the calendar helpers. */\nexport interface BusinessDayOptions {\n    /**\n     * Which kinds count as non-working. Default `[\"national\", \"banking\"]`, i.e.\n     * the Bacen calendar — the right default for anything money moves through.\n     * Pass `[\"national\"]` for a labour-law calendar.\n     */\n    kinds?: readonly HolidayKind[];\n    /**\n     * Extra non-working days, as `YYYY-MM-DD` or `Date`. This is where state and\n     * municipal holidays go: they are **not** in the built-in table and never will\n     * be — there are 5 570 municipalities, each free to declare its own.\n     */\n    extra?: readonly DateInput[];\n    /**\n     * Days of the week that are not worked, `0` = Sunday. Default `[0, 6]`.\n     */\n    weekend?: readonly number[];\n}\n\n/** Fixed-date national holidays, with the year each became one. */\nconst FIXED_HOLIDAYS: readonly {\n    month: number;\n    day: number;\n    name: string;\n    kind: HolidayKind;\n    since?: number;\n}[] = [\n    { month: 1, day: 1, name: \"Confraternização Universal\", kind: \"national\" },\n    { month: 4, day: 21, name: \"Tiradentes\", kind: \"national\" },\n    { month: 5, day: 1, name: \"Dia do Trabalho\", kind: \"national\" },\n    { month: 9, day: 7, name: \"Independência do Brasil\", kind: \"national\" },\n    { month: 10, day: 12, name: \"Nossa Senhora Aparecida\", kind: \"national\" },\n    { month: 11, day: 2, name: \"Finados\", kind: \"national\" },\n    { month: 11, day: 15, name: \"Proclamação da República\", kind: \"national\" },\n    {\n        month: 11,\n        day: 20,\n        name: \"Dia Nacional de Zumbi e da Consciência Negra\",\n        kind: \"national\",\n        since: 2024,\n    },\n    { month: 12, day: 25, name: \"Natal\", kind: \"national\" },\n];\n\n/** Easter-relative holidays, as a day offset from Easter Sunday. */\nconst MOVABLE_HOLIDAYS: readonly { offset: number; name: string; kind: HolidayKind }[] = [\n    { offset: -48, name: \"Carnaval (segunda-feira)\", kind: \"banking\" },\n    { offset: -47, name: \"Carnaval (terça-feira)\", kind: \"banking\" },\n    { offset: -2, name: \"Sexta-feira da Paixão\", kind: \"banking\" },\n    { offset: 60, name: \"Corpus Christi\", kind: \"banking\" },\n];\n\nconst DEFAULT_KINDS: readonly HolidayKind[] = [\"national\", \"banking\"];\nconst DEFAULT_WEEKEND: readonly number[] = [0, 6];\nconst MS_PER_DAY = 86_400_000;\n\n/**\n * How far a walk may go before it is treated as a bug rather than a long holiday.\n *\n * A real calendar never has more than a handful of consecutive non-working days,\n * so hitting this means `extra` or `weekend` marked every day off, and looping\n * forever is worse than an error.\n */\nconst MAX_WALK_DAYS = 400;\n\n/** `YYYY-MM-DD` from a local-calendar date. */\nfunction toIso(year: number, month: number, day: number): string {\n    return `${String(year).padStart(4, \"0\")}-${String(month).padStart(2, \"0\")}-${String(day).padStart(2, \"0\")}`;\n}\n\n/**\n * Local midnight for any accepted input.\n *\n * Everything here works on local calendar components, never on UTC: `new Date(y,\n * m, d)` and `getFullYear()/getMonth()/getDate()`. Going through `toISOString()`\n * would shift the day for every viewer east of Greenwich, and \"is today a\n * holiday\" is a question about the viewer's calendar.\n *\n * @throws {RangeError} When a string is not `YYYY-MM-DD` or a `Date` is invalid.\n */\nfunction toLocalDate(input: DateInput): Date {\n    if (typeof input === \"string\") {\n        const match = /^(\\d{4})-(\\d{2})-(\\d{2})$/.exec(input.trim());\n        if (match === null) {\n            throw new RangeError(`Expected a YYYY-MM-DD date, got ${JSON.stringify(input)}.`);\n        }\n        return new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3]));\n    }\n    if (Number.isNaN(input.getTime())) throw new RangeError(\"Received an Invalid Date.\");\n    return new Date(input.getFullYear(), input.getMonth(), input.getDate());\n}\n\n/** `YYYY-MM-DD` for any accepted input. */\nfunction isoOf(input: DateInput): string {\n    const date = toLocalDate(input);\n    return toIso(date.getFullYear(), date.getMonth() + 1, date.getDate());\n}\n\n/**\n * Easter Sunday in the Gregorian calendar.\n *\n * The anonymous Gregorian computus (Meeus/Jones/Butcher): pure integer\n * arithmetic over the year, no tables and no dependency. It is exact for every\n * Gregorian year, which is why the four movable Brazilian holidays are derived\n * from it rather than listed.\n *\n * @param year - Gregorian year.\n * @returns Local midnight of Easter Sunday.\n *\n * @example\n * easterSunday(2026); // 2026-04-05\n */\nexport function easterSunday(year: number): Date {\n    const a = year % 19;\n    const b = Math.floor(year / 100);\n    const c = year % 100;\n    const d = Math.floor(b / 4);\n    const e = b % 4;\n    const f = Math.floor((b + 8) / 25);\n    const g = Math.floor((b - f + 1) / 3);\n    const h = (19 * a + b - d - g + 15) % 30;\n    const i = Math.floor(c / 4);\n    const k = c % 4;\n    const l = (32 + 2 * e + 2 * i - h - k) % 7;\n    const m = Math.floor((a + 11 * h + 22 * l) / 451);\n    const month = Math.floor((h + l - 7 * m + 114) / 31);\n    const day = ((h + l - 7 * m + 114) % 31) + 1;\n    return new Date(year, month - 1, day);\n}\n\n/**\n * Every national non-working day in a year, ordered by date.\n *\n * **What is here:** the nine feriados nacionais in federal law (Lei 662/1949 as\n * amended by Lei 10.607/2002, Lei 6.802/1980 for 12 October, and Lei 14.759/2023\n * for 20 November, which is why that one only appears from 2024), plus the four\n * movable days the national financial system observes.\n *\n * **What is deliberately not here**, and will not be:\n *\n * - **State and municipal holidays.** A data magna varies by state and each of the\n *   5 570 municipalities may declare its own, including up to four religious\n *   days. No table can be both complete and current; pass them through\n *   `options.extra`.\n * - **Ponto facultativo.** A federal decree that lets public servants off is not a\n *   holiday and binds nobody else, so it changes no deadline.\n * - **Pre-2002 history.** The table encodes the law as it stands today. Asking for\n *   1998 returns today's set shifted to 1998, not what was in force then.\n *\n * Carnaval, Sexta-feira da Paixão and Corpus Christi are the interesting case:\n * none of them is a feriado nacional in federal law, yet CMN Resolução 4.880/2020\n * closes the banks on all four days, so a payment cannot settle. They are returned\n * with `kind: \"banking\"` — counted by default, and excluded by passing\n * `kinds: [\"national\"]`.\n *\n * @param year - Gregorian year.\n * @returns The holidays of that year, ascending by date.\n *\n * @example\n * holidaysFor(2026).filter((holiday) => holiday.kind === \"national\").length; // 9\n */\nexport function holidaysFor(year: number): Holiday[] {\n    const holidays: Holiday[] = FIXED_HOLIDAYS.filter(\n        (entry) => entry.since === undefined || year >= entry.since,\n    ).map((entry) => ({\n        date: toIso(year, entry.month, entry.day),\n        name: entry.name,\n        kind: entry.kind,\n        movable: false,\n    }));\n\n    const easter = easterSunday(year);\n    for (const entry of MOVABLE_HOLIDAYS) {\n        const date = new Date(easter.getTime() + entry.offset * MS_PER_DAY);\n        holidays.push({\n            date: toIso(date.getFullYear(), date.getMonth() + 1, date.getDate()),\n            name: entry.name,\n            kind: entry.kind,\n            movable: true,\n        });\n    }\n\n    return holidays.sort((left, right) => left.date.localeCompare(right.date));\n}\n\n/** The set of `YYYY-MM-DD` strings that count as off for a given year. */\nfunction offDays(year: number, options: BusinessDayOptions): Set<string> {\n    const kinds = options.kinds ?? DEFAULT_KINDS;\n    const days = new Set(\n        holidaysFor(year)\n            .filter((holiday) => kinds.includes(holiday.kind))\n            .map((holiday) => holiday.date),\n    );\n    for (const entry of options.extra ?? []) days.add(isoOf(entry));\n    return days;\n}\n\n/**\n * Whether a date is a national holiday.\n *\n * @param date - `YYYY-MM-DD` or a `Date`. Only the local calendar day matters.\n * @param options - See {@link BusinessDayOptions}. `weekend` is ignored here — a\n * Sunday is not a holiday, it is a Sunday.\n * @returns `true` when the day is in the table (or in `extra`).\n * @throws {RangeError} On a malformed string or an Invalid Date.\n *\n * @example\n * isHoliday(\"2026-11-20\"); // true\n * isHoliday(\"2026-02-17\"); // true — Carnaval\n * isHoliday(\"2026-02-17\", { kinds: [\"national\"] }); // false\n */\nexport function isHoliday(date: DateInput, options: BusinessDayOptions = {}): boolean {\n    const iso = isoOf(date);\n    return offDays(Number(iso.slice(0, 4)), options).has(iso);\n}\n\n/**\n * Whether a date is a working day: not a weekend, not a holiday.\n *\n * @param date - `YYYY-MM-DD` or a `Date`.\n * @param options - See {@link BusinessDayOptions}.\n * @returns `true` when work happens on that day.\n * @throws {RangeError} On a malformed string or an Invalid Date.\n *\n * @example\n * isBusinessDay(\"2026-04-03\"); // false — Sexta-feira da Paixão\n */\nexport function isBusinessDay(date: DateInput, options: BusinessDayOptions = {}): boolean {\n    const local = toLocalDate(date);\n    const weekend = options.weekend ?? DEFAULT_WEEKEND;\n    if (weekend.includes(local.getDay())) return false;\n    return !isHoliday(local, options);\n}\n\n/**\n * The first working day strictly after a date.\n *\n * Strictly after: calling it on a Wednesday returns Thursday, never the same\n * Wednesday. That is what a \"prazo de D+1\" means, and it makes the function safe\n * to call in a loop.\n *\n * @param date - `YYYY-MM-DD` or a `Date`.\n * @param options - See {@link BusinessDayOptions}.\n * @returns Local midnight of the next working day.\n * @throws {RangeError} On a malformed input, or when `options` marked so many days\n * off that no working day exists within {@link MAX_WALK_DAYS}.\n *\n * @example\n * nextBusinessDay(\"2026-12-24\"); // 2026-12-28 — the 25th is Natal, then a weekend\n */\nexport function nextBusinessDay(date: DateInput, options: BusinessDayOptions = {}): Date {\n    const cursor = toLocalDate(date);\n    for (let step = 0; step < MAX_WALK_DAYS; step += 1) {\n        cursor.setDate(cursor.getDate() + 1);\n        if (isBusinessDay(cursor, options)) return cursor;\n    }\n    throw new RangeError(\n        `No business day within ${MAX_WALK_DAYS} days of ${isoOf(date)} — check \\`weekend\\` and \\`extra\\`.`,\n    );\n}\n\n/**\n * Move a date by a number of working days.\n *\n * `n` days forward means `n` calls to {@link nextBusinessDay}; a negative `n`\n * walks backwards the same way. `n === 0` returns the day unchanged **even when it\n * is not a working day** — snapping silently would hide the case a caller most\n * needs to see.\n *\n * @param date - `YYYY-MM-DD` or a `Date`.\n * @param days - Working days to add. May be negative.\n * @param options - See {@link BusinessDayOptions}.\n * @returns Local midnight of the resulting day.\n * @throws {RangeError} On a malformed input, or on a calendar with no working days.\n *\n * @example\n * addBusinessDays(\"2026-04-01\", 2); // 2026-04-06 — skips Good Friday and the weekend\n */\nexport function addBusinessDays(\n    date: DateInput,\n    days: number,\n    options: BusinessDayOptions = {},\n): Date {\n    const cursor = toLocalDate(date);\n    const direction = days < 0 ? -1 : 1;\n    for (let moved = 0; moved < Math.abs(days); moved += 1) {\n        let landed = false;\n        for (let step = 0; step < MAX_WALK_DAYS && !landed; step += 1) {\n            cursor.setDate(cursor.getDate() + direction);\n            landed = isBusinessDay(cursor, options);\n        }\n        if (!landed) {\n            throw new RangeError(\n                `No business day within ${MAX_WALK_DAYS} days while walking from ${isoOf(date)} — ` +\n                    \"check `weekend` and `extra`.\",\n            );\n        }\n    }\n    return cursor;\n}\n"],"mappings":"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"}

package/dist/br/holidays.js.map

@@ -1 +1 @@
-{"version":3,"file":"holidays.js","names":[],"sources":["../../src/br/holidays.ts"],"sourcesContent":["/**\n * How binding a non-working day is.\n *\n * - `\"national\"` — a feriado nacional in federal law. Nobody works, and a\n *   deadline that lands here moves.\n * - `\"banking\"` — not a statutory holiday, but a day the national financial\n *   system does not operate: Carnaval (Monday and Tuesday), Sexta-feira da\n *   Paixão and Corpus Christi. Bank branches are shut and compensation does not\n *   run, so a boleto or a TED dated here settles later — but an employer may\n *   legally require work, which is why the two kinds are separate.\n */\nexport type HolidayKind = \"national\" | \"banking\";\n\n/** One non-working day in a given year. */\nexport interface Holiday {\n    /** `YYYY-MM-DD` in the local calendar. */\n    date: string;\n    /** Portuguese name, as the law or the Bacen calendar spells it. */\n    name: string;\n    kind: HolidayKind;\n    /** `true` when the date is derived from Easter rather than fixed. */\n    movable: boolean;\n}\n\n/** Anything these helpers accept as a day. */\nexport type DateInput = Date | string;\n\n/** Options shared by the calendar helpers. */\nexport interface BusinessDayOptions {\n    /**\n     * Which kinds count as non-working. Default `[\"national\", \"banking\"]`, i.e.\n     * the Bacen calendar — the right default for anything money moves through.\n     * Pass `[\"national\"]` for a labour-law calendar.\n     */\n    kinds?: readonly HolidayKind[];\n    /**\n     * Extra non-working days, as `YYYY-MM-DD` or `Date`. This is where state and\n     * municipal holidays go: they are **not** in the built-in table and never will\n     * be — there are 5 570 municipalities, each free to declare its own.\n     */\n    extra?: readonly DateInput[];\n    /**\n     * Days of the week that are not worked, `0` = Sunday. Default `[0, 6]`.\n     */\n    weekend?: readonly number[];\n}\n\n/** Fixed-date national holidays, with the year each became one. */\nconst FIXED_HOLIDAYS: readonly {\n    month: number;\n    day: number;\n    name: string;\n    kind: HolidayKind;\n    since?: number;\n}[] = [\n    { month: 1, day: 1, name: \"Confraternização Universal\", kind: \"national\" },\n    { month: 4, day: 21, name: \"Tiradentes\", kind: \"national\" },\n    { month: 5, day: 1, name: \"Dia do Trabalho\", kind: \"national\" },\n    { month: 9, day: 7, name: \"Independência do Brasil\", kind: \"national\" },\n    { month: 10, day: 12, name: \"Nossa Senhora Aparecida\", kind: \"national\" },\n    { month: 11, day: 2, name: \"Finados\", kind: \"national\" },\n    { month: 11, day: 15, name: \"Proclamação da República\", kind: \"national\" },\n    {\n        month: 11,\n        day: 20,\n        name: \"Dia Nacional de Zumbi e da Consciência Negra\",\n        kind: \"national\",\n        since: 2024,\n    },\n    { month: 12, day: 25, name: \"Natal\", kind: \"national\" },\n];\n\n/** Easter-relative holidays, as a day offset from Easter Sunday. */\nconst MOVABLE_HOLIDAYS: readonly { offset: number; name: string; kind: HolidayKind }[] = [\n    { offset: -48, name: \"Carnaval (segunda-feira)\", kind: \"banking\" },\n    { offset: -47, name: \"Carnaval (terça-feira)\", kind: \"banking\" },\n    { offset: -2, name: \"Sexta-feira da Paixão\", kind: \"banking\" },\n    { offset: 60, name: \"Corpus Christi\", kind: \"banking\" },\n];\n\nconst DEFAULT_KINDS: readonly HolidayKind[] = [\"national\", \"banking\"];\nconst DEFAULT_WEEKEND: readonly number[] = [0, 6];\nconst MS_PER_DAY = 86_400_000;\n\n/**\n * How far a walk may go before it is treated as a bug rather than a long holiday.\n *\n * A real calendar never has more than a handful of consecutive non-working days,\n * so hitting this means `extra` or `weekend` marked every day off, and looping\n * forever is worse than an error.\n */\nconst MAX_WALK_DAYS = 400;\n\n/** `YYYY-MM-DD` from a local-calendar date. */\nfunction toIso(year: number, month: number, day: number): string {\n    return `${String(year).padStart(4, \"0\")}-${String(month).padStart(2, \"0\")}-${String(day).padStart(2, \"0\")}`;\n}\n\n/**\n * Local midnight for any accepted input.\n *\n * Everything here works on local calendar components, never on UTC: `new Date(y,\n * m, d)` and `getFullYear()/getMonth()/getDate()`. Going through `toISOString()`\n * would shift the day for every viewer east of Greenwich, and \"is today a\n * holiday\" is a question about the viewer's calendar.\n *\n * @throws {RangeError} When a string is not `YYYY-MM-DD` or a `Date` is invalid.\n */\nfunction toLocalDate(input: DateInput): Date {\n    if (typeof input === \"string\") {\n        const match = /^(\\d{4})-(\\d{2})-(\\d{2})$/.exec(input.trim());\n        if (match === null) {\n            throw new RangeError(`Expected a YYYY-MM-DD date, got ${JSON.stringify(input)}.`);\n        }\n        return new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3]));\n    }\n    if (Number.isNaN(input.getTime())) throw new RangeError(\"Received an Invalid Date.\");\n    return new Date(input.getFullYear(), input.getMonth(), input.getDate());\n}\n\n/** `YYYY-MM-DD` for any accepted input. */\nfunction isoOf(input: DateInput): string {\n    const date = toLocalDate(input);\n    return toIso(date.getFullYear(), date.getMonth() + 1, date.getDate());\n}\n\n/**\n * Easter Sunday in the Gregorian calendar.\n *\n * The anonymous Gregorian computus (Meeus/Jones/Butcher): pure integer\n * arithmetic over the year, no tables and no dependency. It is exact for every\n * Gregorian year, which is why the four movable Brazilian holidays are derived\n * from it rather than listed.\n *\n * @param year - Gregorian year.\n * @returns Local midnight of Easter Sunday.\n *\n * @example\n * easterSunday(2026); // 2026-04-05\n */\nexport function easterSunday(year: number): Date {\n    const a = year % 19;\n    const b = Math.floor(year / 100);\n    const c = year % 100;\n    const d = Math.floor(b / 4);\n    const e = b % 4;\n    const f = Math.floor((b + 8) / 25);\n    const g = Math.floor((b - f + 1) / 3);\n    const h = (19 * a + b - d - g + 15) % 30;\n    const i = Math.floor(c / 4);\n    const k = c % 4;\n    const l = (32 + 2 * e + 2 * i - h - k) % 7;\n    const m = Math.floor((a + 11 * h + 22 * l) / 451);\n    const month = Math.floor((h + l - 7 * m + 114) / 31);\n    const day = ((h + l - 7 * m + 114) % 31) + 1;\n    return new Date(year, month - 1, day);\n}\n\n/**\n * Every national non-working day in a year, ordered by date.\n *\n * **What is here:** the nine feriados nacionais in federal law (Lei 662/1949 as\n * amended by Lei 10.607/2002, Lei 6.802/1980 for 12 October, and Lei 14.759/2023\n * for 20 November, which is why that one only appears from 2024), plus the four\n * movable days the national financial system observes.\n *\n * **What is deliberately not here**, and will not be:\n *\n * - **State and municipal holidays.** A data magna varies by state and each of the\n *   5 570 municipalities may declare its own, including up to four religious\n *   days. No table can be both complete and current; pass them through\n *   `options.extra`.\n * - **Ponto facultativo.** A federal decree that lets public servants off is not a\n *   holiday and binds nobody else, so it changes no deadline.\n * - **Pre-2002 history.** The table encodes the law as it stands today. Asking for\n *   1998 returns today's set shifted to 1998, not what was in force then.\n *\n * Carnaval, Sexta-feira da Paixão and Corpus Christi are the interesting case:\n * none of them is a feriado nacional in federal law, yet CMN Resolução 4.880/2020\n * closes the banks on all four days, so a payment cannot settle. They are returned\n * with `kind: \"banking\"` — counted by default, and excluded by passing\n * `kinds: [\"national\"]`.\n *\n * @param year - Gregorian year.\n * @returns The holidays of that year, ascending by date.\n *\n * @example\n * holidaysFor(2026).filter((holiday) => holiday.kind === \"national\").length; // 9\n */\nexport function holidaysFor(year: number): Holiday[] {\n    const holidays: Holiday[] = FIXED_HOLIDAYS.filter(\n        (entry) => entry.since === undefined || year >= entry.since,\n    ).map((entry) => ({\n        date: toIso(year, entry.month, entry.day),\n        name: entry.name,\n        kind: entry.kind,\n        movable: false,\n    }));\n\n    const easter = easterSunday(year);\n    for (const entry of MOVABLE_HOLIDAYS) {\n        const date = new Date(easter.getTime() + entry.offset * MS_PER_DAY);\n        holidays.push({\n            date: toIso(date.getFullYear(), date.getMonth() + 1, date.getDate()),\n            name: entry.name,\n            kind: entry.kind,\n            movable: true,\n        });\n    }\n\n    return holidays.sort((left, right) => left.date.localeCompare(right.date));\n}\n\n/** The set of `YYYY-MM-DD` strings that count as off for a given year. */\nfunction offDays(year: number, options: BusinessDayOptions): Set<string> {\n    const kinds = options.kinds ?? DEFAULT_KINDS;\n    const days = new Set(\n        holidaysFor(year)\n            .filter((holiday) => kinds.includes(holiday.kind))\n            .map((holiday) => holiday.date),\n    );\n    for (const entry of options.extra ?? []) days.add(isoOf(entry));\n    return days;\n}\n\n/**\n * Whether a date is a national holiday.\n *\n * @param date - `YYYY-MM-DD` or a `Date`. Only the local calendar day matters.\n * @param options - See {@link BusinessDayOptions}. `weekend` is ignored here — a\n * Sunday is not a holiday, it is a Sunday.\n * @returns `true` when the day is in the table (or in `extra`).\n * @throws {RangeError} On a malformed string or an Invalid Date.\n *\n * @example\n * isHoliday(\"2026-11-20\"); // true\n * isHoliday(\"2026-02-17\"); // true — Carnaval\n * isHoliday(\"2026-02-17\", { kinds: [\"national\"] }); // false\n */\nexport function isHoliday(date: DateInput, options: BusinessDayOptions = {}): boolean {\n    const iso = isoOf(date);\n    return offDays(Number(iso.slice(0, 4)), options).has(iso);\n}\n\n/**\n * Whether a date is a working day: not a weekend, not a holiday.\n *\n * @param date - `YYYY-MM-DD` or a `Date`.\n * @param options - See {@link BusinessDayOptions}.\n * @returns `true` when work happens on that day.\n * @throws {RangeError} On a malformed string or an Invalid Date.\n *\n * @example\n * isBusinessDay(\"2026-04-03\"); // false — Sexta-feira da Paixão\n */\nexport function isBusinessDay(date: DateInput, options: BusinessDayOptions = {}): boolean {\n    const local = toLocalDate(date);\n    const weekend = options.weekend ?? DEFAULT_WEEKEND;\n    if (weekend.includes(local.getDay())) return false;\n    return !isHoliday(local, options);\n}\n\n/**\n * The first working day strictly after a date.\n *\n * Strictly after: calling it on a Wednesday returns Thursday, never the same\n * Wednesday. That is what a \"prazo de D+1\" means, and it makes the function safe\n * to call in a loop.\n *\n * @param date - `YYYY-MM-DD` or a `Date`.\n * @param options - See {@link BusinessDayOptions}.\n * @returns Local midnight of the next working day.\n * @throws {RangeError} On a malformed input, or when `options` marked so many days\n * off that no working day exists within {@link MAX_WALK_DAYS}.\n *\n * @example\n * nextBusinessDay(\"2026-12-24\"); // 2026-12-28 — the 25th is Natal, then a weekend\n */\nexport function nextBusinessDay(date: DateInput, options: BusinessDayOptions = {}): Date {\n    const cursor = toLocalDate(date);\n    for (let step = 0; step < MAX_WALK_DAYS; step += 1) {\n        cursor.setDate(cursor.getDate() + 1);\n        if (isBusinessDay(cursor, options)) return cursor;\n    }\n    throw new RangeError(\n        `No business day within ${MAX_WALK_DAYS} days of ${isoOf(date)} — check \\`weekend\\` and \\`extra\\`.`,\n    );\n}\n\n/**\n * Move a date by a number of working days.\n *\n * `n` days forward means `n` calls to {@link nextBusinessDay}; a negative `n`\n * walks backwards the same way. `n === 0` returns the day unchanged **even when it\n * is not a working day** — snapping silently would hide the case a caller most\n * needs to see.\n *\n * @param date - `YYYY-MM-DD` or a `Date`.\n * @param days - Working days to add. May be negative.\n * @param options - See {@link BusinessDayOptions}.\n * @returns Local midnight of the resulting day.\n * @throws {RangeError} On a malformed input, or on a calendar with no working days.\n *\n * @example\n * addBusinessDays(\"2026-04-01\", 2); // 2026-04-06 — skips Good Friday and the weekend\n */\nexport function addBusinessDays(\n    date: DateInput,\n    days: number,\n    options: BusinessDayOptions = {},\n): Date {\n    const cursor = toLocalDate(date);\n    const direction = days < 0 ? -1 : 1;\n    for (let moved = 0; moved < Math.abs(days); moved += 1) {\n        let landed = false;\n        for (let step = 0; step < MAX_WALK_DAYS && !landed; step += 1) {\n            cursor.setDate(cursor.getDate() + direction);\n            landed = isBusinessDay(cursor, options);\n        }\n        if (!landed) {\n            throw new RangeError(\n                `No business day within ${MAX_WALK_DAYS} days while walking from ${isoOf(date)} — ` +\n                    \"check `weekend` and `extra`.\",\n            );\n        }\n    }\n    return cursor;\n}\n"],"mappings":"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"}
+{"version":3,"file":"holidays.js","names":["FIXED_HOLIDAYS","MOVABLE_HOLIDAYS","DEFAULT_KINDS","DEFAULT_WEEKEND","MS_PER_DAY","MAX_WALK_DAYS","toIso","year","month","day","toLocalDate","input","match","isoOf","date","easterSunday","a","b","c","d","e","f","g","h","i","k","l","m","holidaysFor","holidays","entry","easter","left","right","offDays","kinds","options","days","holiday","isHoliday","iso","isBusinessDay","local","nextBusinessDay","cursor","step","addBusinessDays","direction","moved","landed"],"sources":["../../src/br/holidays.ts"],"sourcesContent":["/**\n * How binding a non-working day is.\n *\n * - `\"national\"` — a feriado nacional in federal law. Nobody works, and a\n *   deadline that lands here moves.\n * - `\"banking\"` — not a statutory holiday, but a day the national financial\n *   system does not operate: Carnaval (Monday and Tuesday), Sexta-feira da\n *   Paixão and Corpus Christi. Bank branches are shut and compensation does not\n *   run, so a boleto or a TED dated here settles later — but an employer may\n *   legally require work, which is why the two kinds are separate.\n */\nexport type HolidayKind = \"national\" | \"banking\";\n\n/** One non-working day in a given year. */\nexport interface Holiday {\n    /** `YYYY-MM-DD` in the local calendar. */\n    date: string;\n    /** Portuguese name, as the law or the Bacen calendar spells it. */\n    name: string;\n    kind: HolidayKind;\n    /** `true` when the date is derived from Easter rather than fixed. */\n    movable: boolean;\n}\n\n/** Anything these helpers accept as a day. */\nexport type DateInput = Date | string;\n\n/** Options shared by the calendar helpers. */\nexport interface BusinessDayOptions {\n    /**\n     * Which kinds count as non-working. Default `[\"national\", \"banking\"]`, i.e.\n     * the Bacen calendar — the right default for anything money moves through.\n     * Pass `[\"national\"]` for a labour-law calendar.\n     */\n    kinds?: readonly HolidayKind[];\n    /**\n     * Extra non-working days, as `YYYY-MM-DD` or `Date`. This is where state and\n     * municipal holidays go: they are **not** in the built-in table and never will\n     * be — there are 5 570 municipalities, each free to declare its own.\n     */\n    extra?: readonly DateInput[];\n    /**\n     * Days of the week that are not worked, `0` = Sunday. Default `[0, 6]`.\n     */\n    weekend?: readonly number[];\n}\n\n/** Fixed-date national holidays, with the year each became one. */\nconst FIXED_HOLIDAYS: readonly {\n    month: number;\n    day: number;\n    name: string;\n    kind: HolidayKind;\n    since?: number;\n}[] = [\n    { month: 1, day: 1, name: \"Confraternização Universal\", kind: \"national\" },\n    { month: 4, day: 21, name: \"Tiradentes\", kind: \"national\" },\n    { month: 5, day: 1, name: \"Dia do Trabalho\", kind: \"national\" },\n    { month: 9, day: 7, name: \"Independência do Brasil\", kind: \"national\" },\n    { month: 10, day: 12, name: \"Nossa Senhora Aparecida\", kind: \"national\" },\n    { month: 11, day: 2, name: \"Finados\", kind: \"national\" },\n    { month: 11, day: 15, name: \"Proclamação da República\", kind: \"national\" },\n    {\n        month: 11,\n        day: 20,\n        name: \"Dia Nacional de Zumbi e da Consciência Negra\",\n        kind: \"national\",\n        since: 2024,\n    },\n    { month: 12, day: 25, name: \"Natal\", kind: \"national\" },\n];\n\n/** Easter-relative holidays, as a day offset from Easter Sunday. */\nconst MOVABLE_HOLIDAYS: readonly { offset: number; name: string; kind: HolidayKind }[] = [\n    { offset: -48, name: \"Carnaval (segunda-feira)\", kind: \"banking\" },\n    { offset: -47, name: \"Carnaval (terça-feira)\", kind: \"banking\" },\n    { offset: -2, name: \"Sexta-feira da Paixão\", kind: \"banking\" },\n    { offset: 60, name: \"Corpus Christi\", kind: \"banking\" },\n];\n\nconst DEFAULT_KINDS: readonly HolidayKind[] = [\"national\", \"banking\"];\nconst DEFAULT_WEEKEND: readonly number[] = [0, 6];\nconst MS_PER_DAY = 86_400_000;\n\n/**\n * How far a walk may go before it is treated as a bug rather than a long holiday.\n *\n * A real calendar never has more than a handful of consecutive non-working days,\n * so hitting this means `extra` or `weekend` marked every day off, and looping\n * forever is worse than an error.\n */\nconst MAX_WALK_DAYS = 400;\n\n/** `YYYY-MM-DD` from a local-calendar date. */\nfunction toIso(year: number, month: number, day: number): string {\n    return `${String(year).padStart(4, \"0\")}-${String(month).padStart(2, \"0\")}-${String(day).padStart(2, \"0\")}`;\n}\n\n/**\n * Local midnight for any accepted input.\n *\n * Everything here works on local calendar components, never on UTC: `new Date(y,\n * m, d)` and `getFullYear()/getMonth()/getDate()`. Going through `toISOString()`\n * would shift the day for every viewer east of Greenwich, and \"is today a\n * holiday\" is a question about the viewer's calendar.\n *\n * @throws {RangeError} When a string is not `YYYY-MM-DD` or a `Date` is invalid.\n */\nfunction toLocalDate(input: DateInput): Date {\n    if (typeof input === \"string\") {\n        const match = /^(\\d{4})-(\\d{2})-(\\d{2})$/.exec(input.trim());\n        if (match === null) {\n            throw new RangeError(`Expected a YYYY-MM-DD date, got ${JSON.stringify(input)}.`);\n        }\n        return new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3]));\n    }\n    if (Number.isNaN(input.getTime())) throw new RangeError(\"Received an Invalid Date.\");\n    return new Date(input.getFullYear(), input.getMonth(), input.getDate());\n}\n\n/** `YYYY-MM-DD` for any accepted input. */\nfunction isoOf(input: DateInput): string {\n    const date = toLocalDate(input);\n    return toIso(date.getFullYear(), date.getMonth() + 1, date.getDate());\n}\n\n/**\n * Easter Sunday in the Gregorian calendar.\n *\n * The anonymous Gregorian computus (Meeus/Jones/Butcher): pure integer\n * arithmetic over the year, no tables and no dependency. It is exact for every\n * Gregorian year, which is why the four movable Brazilian holidays are derived\n * from it rather than listed.\n *\n * @param year - Gregorian year.\n * @returns Local midnight of Easter Sunday.\n *\n * @example\n * easterSunday(2026); // 2026-04-05\n */\nexport function easterSunday(year: number): Date {\n    const a = year % 19;\n    const b = Math.floor(year / 100);\n    const c = year % 100;\n    const d = Math.floor(b / 4);\n    const e = b % 4;\n    const f = Math.floor((b + 8) / 25);\n    const g = Math.floor((b - f + 1) / 3);\n    const h = (19 * a + b - d - g + 15) % 30;\n    const i = Math.floor(c / 4);\n    const k = c % 4;\n    const l = (32 + 2 * e + 2 * i - h - k) % 7;\n    const m = Math.floor((a + 11 * h + 22 * l) / 451);\n    const month = Math.floor((h + l - 7 * m + 114) / 31);\n    const day = ((h + l - 7 * m + 114) % 31) + 1;\n    return new Date(year, month - 1, day);\n}\n\n/**\n * Every national non-working day in a year, ordered by date.\n *\n * **What is here:** the nine feriados nacionais in federal law (Lei 662/1949 as\n * amended by Lei 10.607/2002, Lei 6.802/1980 for 12 October, and Lei 14.759/2023\n * for 20 November, which is why that one only appears from 2024), plus the four\n * movable days the national financial system observes.\n *\n * **What is deliberately not here**, and will not be:\n *\n * - **State and municipal holidays.** A data magna varies by state and each of the\n *   5 570 municipalities may declare its own, including up to four religious\n *   days. No table can be both complete and current; pass them through\n *   `options.extra`.\n * - **Ponto facultativo.** A federal decree that lets public servants off is not a\n *   holiday and binds nobody else, so it changes no deadline.\n * - **Pre-2002 history.** The table encodes the law as it stands today. Asking for\n *   1998 returns today's set shifted to 1998, not what was in force then.\n *\n * Carnaval, Sexta-feira da Paixão and Corpus Christi are the interesting case:\n * none of them is a feriado nacional in federal law, yet CMN Resolução 4.880/2020\n * closes the banks on all four days, so a payment cannot settle. They are returned\n * with `kind: \"banking\"` — counted by default, and excluded by passing\n * `kinds: [\"national\"]`.\n *\n * @param year - Gregorian year.\n * @returns The holidays of that year, ascending by date.\n *\n * @example\n * holidaysFor(2026).filter((holiday) => holiday.kind === \"national\").length; // 9\n */\nexport function holidaysFor(year: number): Holiday[] {\n    const holidays: Holiday[] = FIXED_HOLIDAYS.filter(\n        (entry) => entry.since === undefined || year >= entry.since,\n    ).map((entry) => ({\n        date: toIso(year, entry.month, entry.day),\n        name: entry.name,\n        kind: entry.kind,\n        movable: false,\n    }));\n\n    const easter = easterSunday(year);\n    for (const entry of MOVABLE_HOLIDAYS) {\n        const date = new Date(easter.getTime() + entry.offset * MS_PER_DAY);\n        holidays.push({\n            date: toIso(date.getFullYear(), date.getMonth() + 1, date.getDate()),\n            name: entry.name,\n            kind: entry.kind,\n            movable: true,\n        });\n    }\n\n    return holidays.sort((left, right) => left.date.localeCompare(right.date));\n}\n\n/** The set of `YYYY-MM-DD` strings that count as off for a given year. */\nfunction offDays(year: number, options: BusinessDayOptions): Set<string> {\n    const kinds = options.kinds ?? DEFAULT_KINDS;\n    const days = new Set(\n        holidaysFor(year)\n            .filter((holiday) => kinds.includes(holiday.kind))\n            .map((holiday) => holiday.date),\n    );\n    for (const entry of options.extra ?? []) days.add(isoOf(entry));\n    return days;\n}\n\n/**\n * Whether a date is a national holiday.\n *\n * @param date - `YYYY-MM-DD` or a `Date`. Only the local calendar day matters.\n * @param options - See {@link BusinessDayOptions}. `weekend` is ignored here — a\n * Sunday is not a holiday, it is a Sunday.\n * @returns `true` when the day is in the table (or in `extra`).\n * @throws {RangeError} On a malformed string or an Invalid Date.\n *\n * @example\n * isHoliday(\"2026-11-20\"); // true\n * isHoliday(\"2026-02-17\"); // true — Carnaval\n * isHoliday(\"2026-02-17\", { kinds: [\"national\"] }); // false\n */\nexport function isHoliday(date: DateInput, options: BusinessDayOptions = {}): boolean {\n    const iso = isoOf(date);\n    return offDays(Number(iso.slice(0, 4)), options).has(iso);\n}\n\n/**\n * Whether a date is a working day: not a weekend, not a holiday.\n *\n * @param date - `YYYY-MM-DD` or a `Date`.\n * @param options - See {@link BusinessDayOptions}.\n * @returns `true` when work happens on that day.\n * @throws {RangeError} On a malformed string or an Invalid Date.\n *\n * @example\n * isBusinessDay(\"2026-04-03\"); // false — Sexta-feira da Paixão\n */\nexport function isBusinessDay(date: DateInput, options: BusinessDayOptions = {}): boolean {\n    const local = toLocalDate(date);\n    const weekend = options.weekend ?? DEFAULT_WEEKEND;\n    if (weekend.includes(local.getDay())) return false;\n    return !isHoliday(local, options);\n}\n\n/**\n * The first working day strictly after a date.\n *\n * Strictly after: calling it on a Wednesday returns Thursday, never the same\n * Wednesday. That is what a \"prazo de D+1\" means, and it makes the function safe\n * to call in a loop.\n *\n * @param date - `YYYY-MM-DD` or a `Date`.\n * @param options - See {@link BusinessDayOptions}.\n * @returns Local midnight of the next working day.\n * @throws {RangeError} On a malformed input, or when `options` marked so many days\n * off that no working day exists within {@link MAX_WALK_DAYS}.\n *\n * @example\n * nextBusinessDay(\"2026-12-24\"); // 2026-12-28 — the 25th is Natal, then a weekend\n */\nexport function nextBusinessDay(date: DateInput, options: BusinessDayOptions = {}): Date {\n    const cursor = toLocalDate(date);\n    for (let step = 0; step < MAX_WALK_DAYS; step += 1) {\n        cursor.setDate(cursor.getDate() + 1);\n        if (isBusinessDay(cursor, options)) return cursor;\n    }\n    throw new RangeError(\n        `No business day within ${MAX_WALK_DAYS} days of ${isoOf(date)} — check \\`weekend\\` and \\`extra\\`.`,\n    );\n}\n\n/**\n * Move a date by a number of working days.\n *\n * `n` days forward means `n` calls to {@link nextBusinessDay}; a negative `n`\n * walks backwards the same way. `n === 0` returns the day unchanged **even when it\n * is not a working day** — snapping silently would hide the case a caller most\n * needs to see.\n *\n * @param date - `YYYY-MM-DD` or a `Date`.\n * @param days - Working days to add. May be negative.\n * @param options - See {@link BusinessDayOptions}.\n * @returns Local midnight of the resulting day.\n * @throws {RangeError} On a malformed input, or on a calendar with no working days.\n *\n * @example\n * addBusinessDays(\"2026-04-01\", 2); // 2026-04-06 — skips Good Friday and the weekend\n */\nexport function addBusinessDays(\n    date: DateInput,\n    days: number,\n    options: BusinessDayOptions = {},\n): Date {\n    const cursor = toLocalDate(date);\n    const direction = days < 0 ? -1 : 1;\n    for (let moved = 0; moved < Math.abs(days); moved += 1) {\n        let landed = false;\n        for (let step = 0; step < MAX_WALK_DAYS && !landed; step += 1) {\n            cursor.setDate(cursor.getDate() + direction);\n            landed = isBusinessDay(cursor, options);\n        }\n        if (!landed) {\n            throw new RangeError(\n                `No business day within ${MAX_WALK_DAYS} days while walking from ${isoOf(date)} — ` +\n                    \"check `weekend` and `extra`.\",\n            );\n        }\n    }\n    return cursor;\n}\n"],"mappings":";AAgDA,IAAMA,IAMA;CACF;EAAE,OAAO;EAAG,KAAK;EAAG,MAAM;EAA8B,MAAM;CAAW;CACzE;EAAE,OAAO;EAAG,KAAK;EAAI,MAAM;EAAc,MAAM;CAAW;CAC1D;EAAE,OAAO;EAAG,KAAK;EAAG,MAAM;EAAmB,MAAM;CAAW;CAC9D;EAAE,OAAO;EAAG,KAAK;EAAG,MAAM;EAA2B,MAAM;CAAW;CACtE;EAAE,OAAO;EAAI,KAAK;EAAI,MAAM;EAA2B,MAAM;CAAW;CACxE;EAAE,OAAO;EAAI,KAAK;EAAG,MAAM;EAAW,MAAM;CAAW;CACvD;EAAE,OAAO;EAAI,KAAK;EAAI,MAAM;EAA4B,MAAM;CAAW;CACzE;EACI,OAAO;EACP,KAAK;EACL,MAAM;EACN,MAAM;EACN,OAAO;CACX;CACA;EAAE,OAAO;EAAI,KAAK;EAAI,MAAM;EAAS,MAAM;CAAW;AAC1D,GAGMC,IAAmF;CACrF;EAAE,QAAQ;EAAK,MAAM;EAA4B,MAAM;CAAU;CACjE;EAAE,QAAQ;EAAK,MAAM;EAA0B,MAAM;CAAU;CAC/D;EAAE,QAAQ;EAAI,MAAM;EAAyB,MAAM;CAAU;CAC7D;EAAE,QAAQ;EAAI,MAAM;EAAkB,MAAM;CAAU;AAC1D,GAEMC,IAAwC,CAAC,YAAY,SAAS,GAC9DC,IAAqC,CAAC,GAAG,CAAC,GAC1CC,IAAa,OASbC,IAAgB;AAGtB,SAASC,EAAM,GAAc,GAAe,GAAqB;CAC7D,OAAO,GAAG,OAAOC,CAAI,CAAC,CAAC,SAAS,GAAG,GAAG,EAAE,GAAG,OAAOC,CAAK,CAAC,CAAC,SAAS,GAAG,GAAG,EAAE,GAAG,OAAOC,CAAG,CAAC,CAAC,SAAS,GAAG,GAAG;AAC5G;AAYA,SAASC,EAAY,GAAwB;CACzC,IAAI,OAAOC,KAAU,UAAU;EAC3B,IAAMC,IAAQ,4BAA4B,KAAKD,EAAM,KAAK,CAAC;EAC3D,IAAIC,MAAU,MACV,MAAU,WAAW,mCAAmC,KAAK,UAAUD,CAAK,EAAE,EAAE;EAEpF,OAAO,IAAI,KAAK,OAAOC,EAAM,EAAE,GAAG,OAAOA,EAAM,EAAE,IAAI,GAAG,OAAOA,EAAM,EAAE,CAAC;CAC5E;CACA,IAAI,OAAO,MAAMD,EAAM,QAAQ,CAAC,GAAG,MAAU,WAAW,2BAA2B;CACnF,OAAO,IAAI,KAAKA,EAAM,YAAY,GAAGA,EAAM,SAAS,GAAGA,EAAM,QAAQ,CAAC;AAC1E;AAGA,SAASE,EAAM,GAA0B;CACrC,IAAMC,IAAOJ,EAAYC,CAAK;CAC9B,OAAOL,EAAMQ,EAAK,YAAY,GAAGA,EAAK,SAAS,IAAI,GAAGA,EAAK,QAAQ,CAAC;AACxE;AAgBA,SAAgBC,EAAa,GAAoB;CAC7C,IAAMC,IAAIT,IAAO,IACXU,IAAI,KAAK,MAAMV,IAAO,GAAG,GACzBW,IAAIX,IAAO,KACXY,IAAI,KAAK,MAAMF,IAAI,CAAC,GACpBG,IAAIH,IAAI,GACRI,IAAI,KAAK,OAAOJ,IAAI,KAAK,EAAE,GAC3BK,IAAI,KAAK,OAAOL,IAAII,IAAI,KAAK,CAAC,GAC9BE,KAAK,KAAKP,IAAIC,IAAIE,IAAIG,IAAI,MAAM,IAChCE,IAAI,KAAK,MAAMN,IAAI,CAAC,GACpBO,IAAIP,IAAI,GACRQ,KAAK,KAAK,IAAIN,IAAI,IAAII,IAAID,IAAIE,KAAK,GACnCE,IAAI,KAAK,OAAOX,IAAI,KAAKO,IAAI,KAAKG,KAAK,GAAG,GAC1ClB,IAAQ,KAAK,OAAOe,IAAIG,IAAI,IAAIC,IAAI,OAAO,EAAE,GAC7ClB,KAAQc,IAAIG,IAAI,IAAIC,IAAI,OAAO,KAAM;CAC3C,OAAO,IAAI,KAAKpB,GAAMC,IAAQ,GAAGC,CAAG;AACxC;AAiCA,SAAgBmB,EAAY,GAAyB;CACjD,IAAMC,IAAsB7B,EAAe,QACtC,MAAU8B,EAAM,UAAU,KAAA,KAAavB,KAAQuB,EAAM,KAC1D,CAAC,CAAC,KAAK,OAAW;EACd,MAAMxB,EAAMC,GAAMuB,EAAM,OAAOA,EAAM,GAAG;EACxC,MAAMA,EAAM;EACZ,MAAMA,EAAM;EACZ,SAAS;CACb,EAAE,GAEIC,IAAShB,EAAaR,CAAI;CAChC,KAAK,IAAMuB,KAAS7B,GAAkB;EAClC,IAAMa,IAAO,IAAI,KAAKiB,EAAO,QAAQ,IAAID,EAAM,SAAS1B,CAAU;EAClE,EAAS,KAAK;GACV,MAAME,EAAMQ,EAAK,YAAY,GAAGA,EAAK,SAAS,IAAI,GAAGA,EAAK,QAAQ,CAAC;GACnE,MAAMgB,EAAM;GACZ,MAAMA,EAAM;GACZ,SAAS;EACb,CAAC;CACL;CAEA,OAAOD,EAAS,MAAM,GAAM,MAAUG,EAAK,KAAK,cAAcC,EAAM,IAAI,CAAC;AAC7E;AAGA,SAASC,EAAQ,GAAc,GAA0C;CACrE,IAAMC,IAAQC,EAAQ,SAASlC,GACzBmC,IAAO,IAAI,IACbT,EAAYrB,CAAI,CAAC,CACZ,QAAQ,MAAY4B,EAAM,SAASG,EAAQ,IAAI,CAAC,CAAC,CACjD,KAAK,MAAYA,EAAQ,IAAI,CACtC;CACA,KAAK,IAAMR,KAASM,EAAQ,SAAS,CAAC,GAAG,EAAK,IAAIvB,EAAMiB,CAAK,CAAC;CAC9D,OAAOO;AACX;AAgBA,SAAgBE,EAAU,GAAiB,IAA8B,CAAC,GAAY;CAClF,IAAMC,IAAM3B,EAAMC,CAAI;CACtB,OAAOoB,EAAQ,OAAOM,EAAI,MAAM,GAAG,CAAC,CAAC,GAAGJ,CAAO,CAAC,CAAC,IAAII,CAAG;AAC5D;AAaA,SAAgBC,EAAc,GAAiB,IAA8B,CAAC,GAAY;CACtF,IAAMC,IAAQhC,EAAYI,CAAI;CAG9B,OADA,EADgBsB,EAAQ,WAAWjC,EAAA,CACvB,SAASuC,EAAM,OAAO,CAAC,KAC5B,CAACH,EAAUG,GAAON,CAAO;AACpC;AAkBA,SAAgBO,EAAgB,GAAiB,IAA8B,CAAC,GAAS;CACrF,IAAMC,IAASlC,EAAYI,CAAI;CAC/B,KAAK,IAAI+B,IAAO,GAAGA,IAAOxC,GAAe,KAAQ,GAE7C,IADAuC,EAAO,QAAQA,EAAO,QAAQ,IAAI,CAAC,GAC/BH,EAAcG,GAAQR,CAAO,GAAG,OAAOQ;CAE/C,MAAU,WACN,0BAA0BvC,EAAc,WAAWQ,EAAMC,CAAI,EAAE,oCACnE;AACJ;AAmBA,SAAgBgC,EACZ,GACA,GACA,IAA8B,CAAC,GAC3B;CACJ,IAAMF,IAASlC,EAAYI,CAAI,GACzBiC,IAAYV,IAAO,IAAI,KAAK;CAClC,KAAK,IAAIW,IAAQ,GAAGA,IAAQ,KAAK,IAAIX,CAAI,GAAG,KAAS,GAAG;EACpD,IAAIY,IAAS;EACb,KAAK,IAAIJ,IAAO,GAAGA,IAAOxC,KAAiB,CAAC4C,GAAQ,KAAQ,GAExD,AADAL,EAAO,QAAQA,EAAO,QAAQ,IAAIG,CAAS,GAC3C,IAASN,EAAcG,GAAQR,CAAO;EAE1C,IAAI,CAACa,GACD,MAAU,WACN,0BAA0B5C,EAAc,2BAA2BQ,EAAMC,CAAI,EAAE,oCAEnF;CAER;CACA,OAAO8B;AACX"}

package/dist/br/locations.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"locations.cjs","names":[],"sources":["../../src/br/locations.ts"],"sourcesContent":["import rawLocations from \"./data/br-locations.json\";\n\n/** The 27 Brazilian federative units (26 states + Federal District). */\nexport type UF =\n    | \"AC\"\n    | \"AL\"\n    | \"AP\"\n    | \"AM\"\n    | \"BA\"\n    | \"CE\"\n    | \"DF\"\n    | \"ES\"\n    | \"GO\"\n    | \"MA\"\n    | \"MT\"\n    | \"MS\"\n    | \"MG\"\n    | \"PA\"\n    | \"PB\"\n    | \"PR\"\n    | \"PE\"\n    | \"PI\"\n    | \"RJ\"\n    | \"RN\"\n    | \"RS\"\n    | \"RO\"\n    | \"RR\"\n    | \"SC\"\n    | \"SP\"\n    | \"SE\"\n    | \"TO\";\n\n/** The five Brazilian macro-regions (IBGE). */\nexport type BrRegion = \"Norte\" | \"Nordeste\" | \"Centro-Oeste\" | \"Sudeste\" | \"Sul\";\n\n/** A municipality, identified by the code that survives its renames. */\nexport interface BrazilMunicipality {\n    /** 7-digit IBGE code, e.g. `\"3550308\"`. Stable across a rename. */\n    id: string;\n    /** Current IBGE name, e.g. `\"São Paulo\"`. */\n    name: string;\n}\n\n/**\n * An administrative region of the Federal District.\n *\n * The DF has exactly one municipality — Brasília — and 35 administrative\n * regions inside it. Nobody in the DF writes \"Brasília\" in an address field,\n * so the regions are listed and resolvable; they are not municipalities, and\n * `municipalityId` is what they geocode through.\n */\nexport interface BrazilAdministrativeRegion {\n    /** IBGE subdistrict code, e.g. `\"53001080515\"` for Ceilândia. */\n    id: string;\n    /** IBGE name, e.g. `\"Sudoeste/Octogonal\"`. */\n    name: string;\n    /** The municipality it belongs to — Brasília (`\"5300108\"`) for all 35. */\n    municipalityId: string;\n}\n\n/** A federative unit with its display name and city list. */\nexport interface BrazilState {\n    /** Two-letter acronym, e.g. `\"SP\"`. */\n    uf: UF;\n    /** Full name, e.g. `\"São Paulo\"`. */\n    name: string;\n    /** Macro-region the state belongs to. */\n    region: BrRegion;\n    /** Municipality names within the state, alphabetically. */\n    cities: string[];\n    /** The same municipalities carrying their IBGE codes, same order. */\n    municipalities: readonly BrazilMunicipality[];\n    /** Administrative regions — 35 for `\"DF\"`, empty everywhere else. */\n    administrativeRegions: readonly BrazilAdministrativeRegion[];\n}\n\n/** A `{ value, label }` option, handy for `<Select>` / `<Combobox>`. */\nexport interface Choice {\n    value: string;\n    label: string;\n}\n\n/** IBGE macro-region of each federative unit. */\nconst REGION_BY_UF: Record<UF, BrRegion> = {\n    AC: \"Norte\",\n    AP: \"Norte\",\n    AM: \"Norte\",\n    PA: \"Norte\",\n    RO: \"Norte\",\n    RR: \"Norte\",\n    TO: \"Norte\",\n    AL: \"Nordeste\",\n    BA: \"Nordeste\",\n    CE: \"Nordeste\",\n    MA: \"Nordeste\",\n    PB: \"Nordeste\",\n    PE: \"Nordeste\",\n    PI: \"Nordeste\",\n    RN: \"Nordeste\",\n    SE: \"Nordeste\",\n    DF: \"Centro-Oeste\",\n    GO: \"Centro-Oeste\",\n    MT: \"Centro-Oeste\",\n    MS: \"Centro-Oeste\",\n    ES: \"Sudeste\",\n    MG: \"Sudeste\",\n    RJ: \"Sudeste\",\n    SP: \"Sudeste\",\n    PR: \"Sul\",\n    RS: \"Sul\",\n    SC: \"Sul\",\n};\n\n/** One `[IBGE code, name]` row as `br-locations.json` stores it. */\ntype RawEntry = [string, string];\n\ninterface RawState {\n    uf: string;\n    name: string;\n    cities: RawEntry[];\n}\n\ninterface RawLocations {\n    /**\n     * The two IBGE vintages this file was built from: `roster` is the day the\n     * municipality list was read, `mesh` the boundary release it was joined to.\n     */\n    vintage: { roster: string; mesh: string };\n    states: RawState[];\n    /** Administrative regions keyed by the municipality that contains them. */\n    administrativeRegions: Record<string, RawEntry[]>;\n    /** Every former name, mapped to the IBGE code that still answers to it. */\n    aliases: RawEntry[];\n    /** Municipalities the roster lists and the mesh has no geometry for. */\n    pendingGeometry: string[];\n}\n\nconst RAW = rawLocations as unknown as RawLocations;\n\n/**\n * Strip a name down to what two spellings of the same place share.\n *\n * Accents, case and apostrophes are exactly what differs between the spelling a\n * user typed, the one an app saved five years ago and the one IBGE publishes\n * today — `\"Sant'Ana do Livramento\"` and `\"Santana do Livramento\"` are the same\n * municipality, and `\"acu\"` should find `\"Açu\"`.\n *\n * @param value - A municipality, region or alias name.\n * @returns The comparable form: lowercase, unaccented, apostrophes dropped.\n */\nfunction foldName(value: string): string {\n    return value\n        .trim()\n        .normalize(\"NFD\")\n        .replace(/[\\u0300-\\u036f]/g, \"\")\n        .replace(/['\\u2019\\u0060]/g, \"\")\n        .toLowerCase();\n}\n\n/** The federative unit each IBGE code starts with. */\nconst UF_BY_CODE: Record<string, UF> = {\n    \"11\": \"RO\",\n    \"12\": \"AC\",\n    \"13\": \"AM\",\n    \"14\": \"RR\",\n    \"15\": \"PA\",\n    \"16\": \"AP\",\n    \"17\": \"TO\",\n    \"21\": \"MA\",\n    \"22\": \"PI\",\n    \"23\": \"CE\",\n    \"24\": \"RN\",\n    \"25\": \"PB\",\n    \"26\": \"PE\",\n    \"27\": \"AL\",\n    \"28\": \"SE\",\n    \"29\": \"BA\",\n    \"31\": \"MG\",\n    \"32\": \"ES\",\n    \"33\": \"RJ\",\n    \"35\": \"SP\",\n    \"41\": \"PR\",\n    \"42\": \"SC\",\n    \"43\": \"RS\",\n    \"50\": \"MS\",\n    \"51\": \"MT\",\n    \"52\": \"GO\",\n    \"53\": \"DF\",\n};\n\n/**\n * The municipality an IBGE code belongs to.\n *\n * A municipality code is 7 digits and a subdistrict code extends it with 4 more\n * — `\"53001080515\"` (Ceilândia) is Brasília's `\"5300108\"` plus `\"0515\"` — so the\n * containing municipality is a prefix, not a lookup.\n *\n * @param id - A municipality or subdistrict IBGE code.\n * @returns The 7-digit municipality code.\n */\nfunction municipalityIdOf(id: string): string {\n    return id.slice(0, 7);\n}\n\n/** Administrative regions of a municipality, or `[]` when it has none. */\nfunction regionsOf(municipalityId: string): readonly BrazilAdministrativeRegion[] {\n    return (RAW.administrativeRegions[municipalityId] ?? []).map(([id, name]) => ({\n        id,\n        name,\n        municipalityId,\n    }));\n}\n\n/** Normalized, frozen list of all 27 states (built once at module load). */\nconst STATES: readonly BrazilState[] = RAW.states\n    .map((entry) => {\n        const uf = entry.uf as UF;\n        const municipalities = entry.cities.map(([id, name]) => ({ id, name }));\n        return {\n            uf,\n            name: entry.name,\n            region: REGION_BY_UF[uf],\n            cities: municipalities.map((m) => m.name),\n            municipalities,\n            administrativeRegions: municipalities.flatMap((m) => regionsOf(m.id)),\n        };\n    })\n    .sort((a, b) => a.name.localeCompare(b.name, \"pt-BR\"));\n\nconst STATE_BY_UF = new Map<UF, BrazilState>(STATES.map((s) => [s.uf, s]));\n\n/**\n * Every name that resolves to a municipality, folded, keyed by `<UF>:<name>`.\n *\n * Three kinds of name land here and the precedence matters: a current IBGE name\n * wins, then a former name from `aliases`, then an administrative region of the\n * DF. A rename never shadows a live municipality — `Campo Grande` is a live\n * municipality in both MS and RN, and in RN it is also the former name of\n * nothing, so the live entry has to be written last.\n */\nconst ID_BY_FOLDED_NAME = new Map<string, string>();\nfor (const [name, id] of RAW.aliases) {\n    const uf = UF_BY_CODE[id.slice(0, 2)];\n    if (uf !== undefined) ID_BY_FOLDED_NAME.set(`${uf}:${foldName(name)}`, municipalityIdOf(id));\n}\nfor (const state of STATES) {\n    for (const region of state.administrativeRegions) {\n        ID_BY_FOLDED_NAME.set(`${state.uf}:${foldName(region.name)}`, region.municipalityId);\n    }\n}\nfor (const state of STATES) {\n    for (const municipality of state.municipalities) {\n        ID_BY_FOLDED_NAME.set(`${state.uf}:${foldName(municipality.name)}`, municipality.id);\n    }\n}\n\nconst MUNICIPALITY_BY_ID = new Map<string, BrazilMunicipality>(\n    STATES.flatMap((s) => s.municipalities).map((m) => [m.id, m]),\n);\n\n/** All 27 federative units, sorted by name. */\nexport function listStates(): readonly BrazilState[] {\n    return STATES;\n}\n\n/** Look up a single state by acronym (case-insensitive). Returns `null` if unknown. */\nexport function getState(uf: string): BrazilState | null {\n    const normalized = normalizeUf(uf);\n    return normalized ? (STATE_BY_UF.get(normalized) ?? null) : null;\n}\n\n/**\n * City names for a federative unit (case-insensitive acronym). Returns an empty\n * array for an unknown UF — \"no matches\" is a valid result, not an error.\n */\nexport function citiesByUf(uf: string): string[] {\n    return getState(uf)?.cities ?? [];\n}\n\n/** States belonging to a macro-region. */\nexport function statesByRegion(region: BrRegion): readonly BrazilState[] {\n    return STATES.filter((s) => s.region === region);\n}\n\n/** True when `value` is one of the 27 valid acronyms (case-insensitive). */\nexport function isValidUf(value: string): boolean {\n    return normalizeUf(value) !== null;\n}\n\n/**\n * Normalize an acronym to canonical uppercase form, or `null` if it is not a\n * valid UF. `\"sp\"` → `\"SP\"`, `\"xx\"` → `null`.\n */\nexport function normalizeUf(value: string): UF | null {\n    const upper = value.trim().toUpperCase();\n    return (REGION_BY_UF as Record<string, BrRegion>)[upper] ? (upper as UF) : null;\n}\n\n/** True when `city` exists within `uf` (both case-insensitive). */\nexport function isValidCity(uf: string, city: string): boolean {\n    const target = city.trim().toLowerCase();\n    return citiesByUf(uf).some((c) => c.toLowerCase() === target);\n}\n\n/** `{ value: uf, label: name }` options for every state, for a `<Select>`. */\nexport function ufChoices(): Choice[] {\n    return STATES.map((s) => ({ value: s.uf, label: s.name }));\n}\n\n/** `{ value, label }` options for every city in a UF (value === label). */\nexport function cityChoices(uf: string): Choice[] {\n    return citiesByUf(uf).map((c) => ({ value: c, label: c }));\n}\n\n/**\n * Municipalities of a federative unit, each carrying its IBGE code.\n *\n * The code is what a backend wants stored: it survives the renames that keep\n * happening (`Presidente Juscelino` became `Serra Caiada` in 2013) and it is the\n * key every other dataset in this module joins on.\n *\n * @param uf - Federative unit acronym, case-insensitive.\n * @returns The municipalities, alphabetically. Empty for an unknown UF.\n */\nexport function municipalitiesByUf(uf: string): readonly BrazilMunicipality[] {\n    return getState(uf)?.municipalities ?? [];\n}\n\n/**\n * Administrative regions of a federative unit.\n *\n * Only the Federal District has any — 35 of them, inside its single\n * municipality. Every other UF answers `[]`, which is a valid result and not an\n * error.\n *\n * @param uf - Federative unit acronym, case-insensitive.\n * @returns The regions, alphabetically. Empty outside the DF.\n */\nexport function administrativeRegionsByUf(uf: string): readonly BrazilAdministrativeRegion[] {\n    return getState(uf)?.administrativeRegions ?? [];\n}\n\n/**\n * Find the municipality a name refers to, however it was written down.\n *\n * Four kinds of name resolve, which is the point — an address saved years ago\n * has to keep pointing at the same place:\n *\n * 1. The current IBGE name (`\"Serra Caiada\"`).\n * 2. A former name (`\"Presidente Juscelino\"`), from the alias table the\n *    generator builds by diffing vintages.\n * 3. A different spelling — accents, case and apostrophes are folded, so\n *    `\"sant'ana do livramento\"` finds `\"Sant'Ana do Livramento\"`.\n * 4. An administrative region of the DF (`\"Ceilândia\"`), which resolves to\n *    Brasília — the municipality it is part of.\n *\n * A live municipality always wins over a former name, so a name that is current\n * in one UF and historical in another resolves to the live one in each.\n *\n * @param uf - Federative unit acronym, case-insensitive.\n * @param name - The municipality, region or former name.\n * @returns The municipality, or `null` when nothing in that UF answers to it.\n */\nexport function resolveMunicipality(uf: string, name: string): BrazilMunicipality | null {\n    const normalized = normalizeUf(uf);\n    if (normalized === null) return null;\n    const id = ID_BY_FOLDED_NAME.get(`${normalized}:${foldName(name)}`);\n    return id === undefined ? null : (MUNICIPALITY_BY_ID.get(id) ?? null);\n}\n\n/**\n * The IBGE vintages the bundled datasets were built from.\n *\n * `roster` is the day the municipality list was read and `mesh` the boundary\n * release it was joined to. They differ on purpose: IBGE publishes new\n * municipalities before it publishes their boundaries, and the gap is what\n * {@link pendingGeometryIds} enumerates.\n *\n * @returns The two vintages, as they were written into the data file.\n */\nexport function datasetVintage(): { roster: string; mesh: string } {\n    return RAW.vintage;\n}\n\n/**\n * Municipalities that exist in the roster and have no boundary yet.\n *\n * One today: Boa Esperança do Norte (MT), installed in 2023, for which IBGE\n * serves no mesh at any endpoint. It is listed and selectable, and it is the one\n * municipality `geocodeMunicipality` cannot place — so a caller that must plot\n * every selection can check this list up front instead of discovering it as an\n * empty result.\n *\n * @returns The IBGE codes, in the order the data file declares them.\n */\nexport function pendingGeometryIds(): readonly string[] {\n    return RAW.pendingGeometry;\n}\n"],"mappings":"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"}
+{"version":3,"file":"locations.cjs","names":["rawLocations","require_br_locations","REGION_BY_UF","RAW","foldName","value","UF_BY_CODE","municipalityIdOf","id","regionsOf","municipalityId","name","STATES","uf","entry","municipalities","m","a","b","STATE_BY_UF","s","ID_BY_FOLDED_NAME","state","region","municipality","MUNICIPALITY_BY_ID","listStates","getState","normalized","normalizeUf","citiesByUf","statesByRegion","isValidUf","upper","isValidCity","target","city","c","ufChoices","cityChoices","municipalitiesByUf","administrativeRegionsByUf","resolveMunicipality","datasetVintage","pendingGeometryIds"],"sources":["../../src/br/locations.ts"],"sourcesContent":["import rawLocations from \"./data/br-locations.json\";\n\n/** The 27 Brazilian federative units (26 states + Federal District). */\nexport type UF =\n    | \"AC\"\n    | \"AL\"\n    | \"AP\"\n    | \"AM\"\n    | \"BA\"\n    | \"CE\"\n    | \"DF\"\n    | \"ES\"\n    | \"GO\"\n    | \"MA\"\n    | \"MT\"\n    | \"MS\"\n    | \"MG\"\n    | \"PA\"\n    | \"PB\"\n    | \"PR\"\n    | \"PE\"\n    | \"PI\"\n    | \"RJ\"\n    | \"RN\"\n    | \"RS\"\n    | \"RO\"\n    | \"RR\"\n    | \"SC\"\n    | \"SP\"\n    | \"SE\"\n    | \"TO\";\n\n/** The five Brazilian macro-regions (IBGE). */\nexport type BrRegion = \"Norte\" | \"Nordeste\" | \"Centro-Oeste\" | \"Sudeste\" | \"Sul\";\n\n/** A municipality, identified by the code that survives its renames. */\nexport interface BrazilMunicipality {\n    /** 7-digit IBGE code, e.g. `\"3550308\"`. Stable across a rename. */\n    id: string;\n    /** Current IBGE name, e.g. `\"São Paulo\"`. */\n    name: string;\n}\n\n/**\n * An administrative region of the Federal District.\n *\n * The DF has exactly one municipality — Brasília — and 35 administrative\n * regions inside it. Nobody in the DF writes \"Brasília\" in an address field,\n * so the regions are listed and resolvable; they are not municipalities, and\n * `municipalityId` is what they geocode through.\n */\nexport interface BrazilAdministrativeRegion {\n    /** IBGE subdistrict code, e.g. `\"53001080515\"` for Ceilândia. */\n    id: string;\n    /** IBGE name, e.g. `\"Sudoeste/Octogonal\"`. */\n    name: string;\n    /** The municipality it belongs to — Brasília (`\"5300108\"`) for all 35. */\n    municipalityId: string;\n}\n\n/** A federative unit with its display name and city list. */\nexport interface BrazilState {\n    /** Two-letter acronym, e.g. `\"SP\"`. */\n    uf: UF;\n    /** Full name, e.g. `\"São Paulo\"`. */\n    name: string;\n    /** Macro-region the state belongs to. */\n    region: BrRegion;\n    /** Municipality names within the state, alphabetically. */\n    cities: string[];\n    /** The same municipalities carrying their IBGE codes, same order. */\n    municipalities: readonly BrazilMunicipality[];\n    /** Administrative regions — 35 for `\"DF\"`, empty everywhere else. */\n    administrativeRegions: readonly BrazilAdministrativeRegion[];\n}\n\n/** A `{ value, label }` option, handy for `<Select>` / `<Combobox>`. */\nexport interface Choice {\n    value: string;\n    label: string;\n}\n\n/** IBGE macro-region of each federative unit. */\nconst REGION_BY_UF: Record<UF, BrRegion> = {\n    AC: \"Norte\",\n    AP: \"Norte\",\n    AM: \"Norte\",\n    PA: \"Norte\",\n    RO: \"Norte\",\n    RR: \"Norte\",\n    TO: \"Norte\",\n    AL: \"Nordeste\",\n    BA: \"Nordeste\",\n    CE: \"Nordeste\",\n    MA: \"Nordeste\",\n    PB: \"Nordeste\",\n    PE: \"Nordeste\",\n    PI: \"Nordeste\",\n    RN: \"Nordeste\",\n    SE: \"Nordeste\",\n    DF: \"Centro-Oeste\",\n    GO: \"Centro-Oeste\",\n    MT: \"Centro-Oeste\",\n    MS: \"Centro-Oeste\",\n    ES: \"Sudeste\",\n    MG: \"Sudeste\",\n    RJ: \"Sudeste\",\n    SP: \"Sudeste\",\n    PR: \"Sul\",\n    RS: \"Sul\",\n    SC: \"Sul\",\n};\n\n/** One `[IBGE code, name]` row as `br-locations.json` stores it. */\ntype RawEntry = [string, string];\n\ninterface RawState {\n    uf: string;\n    name: string;\n    cities: RawEntry[];\n}\n\ninterface RawLocations {\n    /**\n     * The two IBGE vintages this file was built from: `roster` is the day the\n     * municipality list was read, `mesh` the boundary release it was joined to.\n     */\n    vintage: { roster: string; mesh: string };\n    states: RawState[];\n    /** Administrative regions keyed by the municipality that contains them. */\n    administrativeRegions: Record<string, RawEntry[]>;\n    /** Every former name, mapped to the IBGE code that still answers to it. */\n    aliases: RawEntry[];\n    /** Municipalities the roster lists and the mesh has no geometry for. */\n    pendingGeometry: string[];\n}\n\nconst RAW = rawLocations as unknown as RawLocations;\n\n/**\n * Strip a name down to what two spellings of the same place share.\n *\n * Accents, case and apostrophes are exactly what differs between the spelling a\n * user typed, the one an app saved five years ago and the one IBGE publishes\n * today — `\"Sant'Ana do Livramento\"` and `\"Santana do Livramento\"` are the same\n * municipality, and `\"acu\"` should find `\"Açu\"`.\n *\n * @param value - A municipality, region or alias name.\n * @returns The comparable form: lowercase, unaccented, apostrophes dropped.\n */\nfunction foldName(value: string): string {\n    return value\n        .trim()\n        .normalize(\"NFD\")\n        .replace(/[\\u0300-\\u036f]/g, \"\")\n        .replace(/['\\u2019\\u0060]/g, \"\")\n        .toLowerCase();\n}\n\n/** The federative unit each IBGE code starts with. */\nconst UF_BY_CODE: Record<string, UF> = {\n    \"11\": \"RO\",\n    \"12\": \"AC\",\n    \"13\": \"AM\",\n    \"14\": \"RR\",\n    \"15\": \"PA\",\n    \"16\": \"AP\",\n    \"17\": \"TO\",\n    \"21\": \"MA\",\n    \"22\": \"PI\",\n    \"23\": \"CE\",\n    \"24\": \"RN\",\n    \"25\": \"PB\",\n    \"26\": \"PE\",\n    \"27\": \"AL\",\n    \"28\": \"SE\",\n    \"29\": \"BA\",\n    \"31\": \"MG\",\n    \"32\": \"ES\",\n    \"33\": \"RJ\",\n    \"35\": \"SP\",\n    \"41\": \"PR\",\n    \"42\": \"SC\",\n    \"43\": \"RS\",\n    \"50\": \"MS\",\n    \"51\": \"MT\",\n    \"52\": \"GO\",\n    \"53\": \"DF\",\n};\n\n/**\n * The municipality an IBGE code belongs to.\n *\n * A municipality code is 7 digits and a subdistrict code extends it with 4 more\n * — `\"53001080515\"` (Ceilândia) is Brasília's `\"5300108\"` plus `\"0515\"` — so the\n * containing municipality is a prefix, not a lookup.\n *\n * @param id - A municipality or subdistrict IBGE code.\n * @returns The 7-digit municipality code.\n */\nfunction municipalityIdOf(id: string): string {\n    return id.slice(0, 7);\n}\n\n/** Administrative regions of a municipality, or `[]` when it has none. */\nfunction regionsOf(municipalityId: string): readonly BrazilAdministrativeRegion[] {\n    return (RAW.administrativeRegions[municipalityId] ?? []).map(([id, name]) => ({\n        id,\n        name,\n        municipalityId,\n    }));\n}\n\n/** Normalized, frozen list of all 27 states (built once at module load). */\nconst STATES: readonly BrazilState[] = RAW.states\n    .map((entry) => {\n        const uf = entry.uf as UF;\n        const municipalities = entry.cities.map(([id, name]) => ({ id, name }));\n        return {\n            uf,\n            name: entry.name,\n            region: REGION_BY_UF[uf],\n            cities: municipalities.map((m) => m.name),\n            municipalities,\n            administrativeRegions: municipalities.flatMap((m) => regionsOf(m.id)),\n        };\n    })\n    .sort((a, b) => a.name.localeCompare(b.name, \"pt-BR\"));\n\nconst STATE_BY_UF = new Map<UF, BrazilState>(STATES.map((s) => [s.uf, s]));\n\n/**\n * Every name that resolves to a municipality, folded, keyed by `<UF>:<name>`.\n *\n * Three kinds of name land here and the precedence matters: a current IBGE name\n * wins, then a former name from `aliases`, then an administrative region of the\n * DF. A rename never shadows a live municipality — `Campo Grande` is a live\n * municipality in both MS and RN, and in RN it is also the former name of\n * nothing, so the live entry has to be written last.\n */\nconst ID_BY_FOLDED_NAME = new Map<string, string>();\nfor (const [name, id] of RAW.aliases) {\n    const uf = UF_BY_CODE[id.slice(0, 2)];\n    if (uf !== undefined) ID_BY_FOLDED_NAME.set(`${uf}:${foldName(name)}`, municipalityIdOf(id));\n}\nfor (const state of STATES) {\n    for (const region of state.administrativeRegions) {\n        ID_BY_FOLDED_NAME.set(`${state.uf}:${foldName(region.name)}`, region.municipalityId);\n    }\n}\nfor (const state of STATES) {\n    for (const municipality of state.municipalities) {\n        ID_BY_FOLDED_NAME.set(`${state.uf}:${foldName(municipality.name)}`, municipality.id);\n    }\n}\n\nconst MUNICIPALITY_BY_ID = new Map<string, BrazilMunicipality>(\n    STATES.flatMap((s) => s.municipalities).map((m) => [m.id, m]),\n);\n\n/** All 27 federative units, sorted by name. */\nexport function listStates(): readonly BrazilState[] {\n    return STATES;\n}\n\n/** Look up a single state by acronym (case-insensitive). Returns `null` if unknown. */\nexport function getState(uf: string): BrazilState | null {\n    const normalized = normalizeUf(uf);\n    return normalized ? (STATE_BY_UF.get(normalized) ?? null) : null;\n}\n\n/**\n * City names for a federative unit (case-insensitive acronym). Returns an empty\n * array for an unknown UF — \"no matches\" is a valid result, not an error.\n */\nexport function citiesByUf(uf: string): string[] {\n    return getState(uf)?.cities ?? [];\n}\n\n/** States belonging to a macro-region. */\nexport function statesByRegion(region: BrRegion): readonly BrazilState[] {\n    return STATES.filter((s) => s.region === region);\n}\n\n/** True when `value` is one of the 27 valid acronyms (case-insensitive). */\nexport function isValidUf(value: string): boolean {\n    return normalizeUf(value) !== null;\n}\n\n/**\n * Normalize an acronym to canonical uppercase form, or `null` if it is not a\n * valid UF. `\"sp\"` → `\"SP\"`, `\"xx\"` → `null`.\n */\nexport function normalizeUf(value: string): UF | null {\n    const upper = value.trim().toUpperCase();\n    return (REGION_BY_UF as Record<string, BrRegion>)[upper] ? (upper as UF) : null;\n}\n\n/** True when `city` exists within `uf` (both case-insensitive). */\nexport function isValidCity(uf: string, city: string): boolean {\n    const target = city.trim().toLowerCase();\n    return citiesByUf(uf).some((c) => c.toLowerCase() === target);\n}\n\n/** `{ value: uf, label: name }` options for every state, for a `<Select>`. */\nexport function ufChoices(): Choice[] {\n    return STATES.map((s) => ({ value: s.uf, label: s.name }));\n}\n\n/** `{ value, label }` options for every city in a UF (value === label). */\nexport function cityChoices(uf: string): Choice[] {\n    return citiesByUf(uf).map((c) => ({ value: c, label: c }));\n}\n\n/**\n * Municipalities of a federative unit, each carrying its IBGE code.\n *\n * The code is what a backend wants stored: it survives the renames that keep\n * happening (`Presidente Juscelino` became `Serra Caiada` in 2013) and it is the\n * key every other dataset in this module joins on.\n *\n * @param uf - Federative unit acronym, case-insensitive.\n * @returns The municipalities, alphabetically. Empty for an unknown UF.\n */\nexport function municipalitiesByUf(uf: string): readonly BrazilMunicipality[] {\n    return getState(uf)?.municipalities ?? [];\n}\n\n/**\n * Administrative regions of a federative unit.\n *\n * Only the Federal District has any — 35 of them, inside its single\n * municipality. Every other UF answers `[]`, which is a valid result and not an\n * error.\n *\n * @param uf - Federative unit acronym, case-insensitive.\n * @returns The regions, alphabetically. Empty outside the DF.\n */\nexport function administrativeRegionsByUf(uf: string): readonly BrazilAdministrativeRegion[] {\n    return getState(uf)?.administrativeRegions ?? [];\n}\n\n/**\n * Find the municipality a name refers to, however it was written down.\n *\n * Four kinds of name resolve, which is the point — an address saved years ago\n * has to keep pointing at the same place:\n *\n * 1. The current IBGE name (`\"Serra Caiada\"`).\n * 2. A former name (`\"Presidente Juscelino\"`), from the alias table the\n *    generator builds by diffing vintages.\n * 3. A different spelling — accents, case and apostrophes are folded, so\n *    `\"sant'ana do livramento\"` finds `\"Sant'Ana do Livramento\"`.\n * 4. An administrative region of the DF (`\"Ceilândia\"`), which resolves to\n *    Brasília — the municipality it is part of.\n *\n * A live municipality always wins over a former name, so a name that is current\n * in one UF and historical in another resolves to the live one in each.\n *\n * @param uf - Federative unit acronym, case-insensitive.\n * @param name - The municipality, region or former name.\n * @returns The municipality, or `null` when nothing in that UF answers to it.\n */\nexport function resolveMunicipality(uf: string, name: string): BrazilMunicipality | null {\n    const normalized = normalizeUf(uf);\n    if (normalized === null) return null;\n    const id = ID_BY_FOLDED_NAME.get(`${normalized}:${foldName(name)}`);\n    return id === undefined ? null : (MUNICIPALITY_BY_ID.get(id) ?? null);\n}\n\n/**\n * The IBGE vintages the bundled datasets were built from.\n *\n * `roster` is the day the municipality list was read and `mesh` the boundary\n * release it was joined to. They differ on purpose: IBGE publishes new\n * municipalities before it publishes their boundaries, and the gap is what\n * {@link pendingGeometryIds} enumerates.\n *\n * @returns The two vintages, as they were written into the data file.\n */\nexport function datasetVintage(): { roster: string; mesh: string } {\n    return RAW.vintage;\n}\n\n/**\n * Municipalities that exist in the roster and have no boundary yet.\n *\n * One today: Boa Esperança do Norte (MT), installed in 2023, for which IBGE\n * serves no mesh at any endpoint. It is listed and selectable, and it is the one\n * municipality `geocodeMunicipality` cannot place — so a caller that must plot\n * every selection can check this list up front instead of discovering it as an\n * empty result.\n *\n * @returns The IBGE codes, in the order the data file declares them.\n */\nexport function pendingGeometryIds(): readonly string[] {\n    return RAW.pendingGeometry;\n}\n"],"mappings":"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"}

package/dist/br/locations.js.map

@@ -1 +1 @@
-{"version":3,"file":"locations.js","names":[],"sources":["../../src/br/locations.ts"],"sourcesContent":["import rawLocations from \"./data/br-locations.json\";\n\n/** The 27 Brazilian federative units (26 states + Federal District). */\nexport type UF =\n    | \"AC\"\n    | \"AL\"\n    | \"AP\"\n    | \"AM\"\n    | \"BA\"\n    | \"CE\"\n    | \"DF\"\n    | \"ES\"\n    | \"GO\"\n    | \"MA\"\n    | \"MT\"\n    | \"MS\"\n    | \"MG\"\n    | \"PA\"\n    | \"PB\"\n    | \"PR\"\n    | \"PE\"\n    | \"PI\"\n    | \"RJ\"\n    | \"RN\"\n    | \"RS\"\n    | \"RO\"\n    | \"RR\"\n    | \"SC\"\n    | \"SP\"\n    | \"SE\"\n    | \"TO\";\n\n/** The five Brazilian macro-regions (IBGE). */\nexport type BrRegion = \"Norte\" | \"Nordeste\" | \"Centro-Oeste\" | \"Sudeste\" | \"Sul\";\n\n/** A municipality, identified by the code that survives its renames. */\nexport interface BrazilMunicipality {\n    /** 7-digit IBGE code, e.g. `\"3550308\"`. Stable across a rename. */\n    id: string;\n    /** Current IBGE name, e.g. `\"São Paulo\"`. */\n    name: string;\n}\n\n/**\n * An administrative region of the Federal District.\n *\n * The DF has exactly one municipality — Brasília — and 35 administrative\n * regions inside it. Nobody in the DF writes \"Brasília\" in an address field,\n * so the regions are listed and resolvable; they are not municipalities, and\n * `municipalityId` is what they geocode through.\n */\nexport interface BrazilAdministrativeRegion {\n    /** IBGE subdistrict code, e.g. `\"53001080515\"` for Ceilândia. */\n    id: string;\n    /** IBGE name, e.g. `\"Sudoeste/Octogonal\"`. */\n    name: string;\n    /** The municipality it belongs to — Brasília (`\"5300108\"`) for all 35. */\n    municipalityId: string;\n}\n\n/** A federative unit with its display name and city list. */\nexport interface BrazilState {\n    /** Two-letter acronym, e.g. `\"SP\"`. */\n    uf: UF;\n    /** Full name, e.g. `\"São Paulo\"`. */\n    name: string;\n    /** Macro-region the state belongs to. */\n    region: BrRegion;\n    /** Municipality names within the state, alphabetically. */\n    cities: string[];\n    /** The same municipalities carrying their IBGE codes, same order. */\n    municipalities: readonly BrazilMunicipality[];\n    /** Administrative regions — 35 for `\"DF\"`, empty everywhere else. */\n    administrativeRegions: readonly BrazilAdministrativeRegion[];\n}\n\n/** A `{ value, label }` option, handy for `<Select>` / `<Combobox>`. */\nexport interface Choice {\n    value: string;\n    label: string;\n}\n\n/** IBGE macro-region of each federative unit. */\nconst REGION_BY_UF: Record<UF, BrRegion> = {\n    AC: \"Norte\",\n    AP: \"Norte\",\n    AM: \"Norte\",\n    PA: \"Norte\",\n    RO: \"Norte\",\n    RR: \"Norte\",\n    TO: \"Norte\",\n    AL: \"Nordeste\",\n    BA: \"Nordeste\",\n    CE: \"Nordeste\",\n    MA: \"Nordeste\",\n    PB: \"Nordeste\",\n    PE: \"Nordeste\",\n    PI: \"Nordeste\",\n    RN: \"Nordeste\",\n    SE: \"Nordeste\",\n    DF: \"Centro-Oeste\",\n    GO: \"Centro-Oeste\",\n    MT: \"Centro-Oeste\",\n    MS: \"Centro-Oeste\",\n    ES: \"Sudeste\",\n    MG: \"Sudeste\",\n    RJ: \"Sudeste\",\n    SP: \"Sudeste\",\n    PR: \"Sul\",\n    RS: \"Sul\",\n    SC: \"Sul\",\n};\n\n/** One `[IBGE code, name]` row as `br-locations.json` stores it. */\ntype RawEntry = [string, string];\n\ninterface RawState {\n    uf: string;\n    name: string;\n    cities: RawEntry[];\n}\n\ninterface RawLocations {\n    /**\n     * The two IBGE vintages this file was built from: `roster` is the day the\n     * municipality list was read, `mesh` the boundary release it was joined to.\n     */\n    vintage: { roster: string; mesh: string };\n    states: RawState[];\n    /** Administrative regions keyed by the municipality that contains them. */\n    administrativeRegions: Record<string, RawEntry[]>;\n    /** Every former name, mapped to the IBGE code that still answers to it. */\n    aliases: RawEntry[];\n    /** Municipalities the roster lists and the mesh has no geometry for. */\n    pendingGeometry: string[];\n}\n\nconst RAW = rawLocations as unknown as RawLocations;\n\n/**\n * Strip a name down to what two spellings of the same place share.\n *\n * Accents, case and apostrophes are exactly what differs between the spelling a\n * user typed, the one an app saved five years ago and the one IBGE publishes\n * today — `\"Sant'Ana do Livramento\"` and `\"Santana do Livramento\"` are the same\n * municipality, and `\"acu\"` should find `\"Açu\"`.\n *\n * @param value - A municipality, region or alias name.\n * @returns The comparable form: lowercase, unaccented, apostrophes dropped.\n */\nfunction foldName(value: string): string {\n    return value\n        .trim()\n        .normalize(\"NFD\")\n        .replace(/[\\u0300-\\u036f]/g, \"\")\n        .replace(/['\\u2019\\u0060]/g, \"\")\n        .toLowerCase();\n}\n\n/** The federative unit each IBGE code starts with. */\nconst UF_BY_CODE: Record<string, UF> = {\n    \"11\": \"RO\",\n    \"12\": \"AC\",\n    \"13\": \"AM\",\n    \"14\": \"RR\",\n    \"15\": \"PA\",\n    \"16\": \"AP\",\n    \"17\": \"TO\",\n    \"21\": \"MA\",\n    \"22\": \"PI\",\n    \"23\": \"CE\",\n    \"24\": \"RN\",\n    \"25\": \"PB\",\n    \"26\": \"PE\",\n    \"27\": \"AL\",\n    \"28\": \"SE\",\n    \"29\": \"BA\",\n    \"31\": \"MG\",\n    \"32\": \"ES\",\n    \"33\": \"RJ\",\n    \"35\": \"SP\",\n    \"41\": \"PR\",\n    \"42\": \"SC\",\n    \"43\": \"RS\",\n    \"50\": \"MS\",\n    \"51\": \"MT\",\n    \"52\": \"GO\",\n    \"53\": \"DF\",\n};\n\n/**\n * The municipality an IBGE code belongs to.\n *\n * A municipality code is 7 digits and a subdistrict code extends it with 4 more\n * — `\"53001080515\"` (Ceilândia) is Brasília's `\"5300108\"` plus `\"0515\"` — so the\n * containing municipality is a prefix, not a lookup.\n *\n * @param id - A municipality or subdistrict IBGE code.\n * @returns The 7-digit municipality code.\n */\nfunction municipalityIdOf(id: string): string {\n    return id.slice(0, 7);\n}\n\n/** Administrative regions of a municipality, or `[]` when it has none. */\nfunction regionsOf(municipalityId: string): readonly BrazilAdministrativeRegion[] {\n    return (RAW.administrativeRegions[municipalityId] ?? []).map(([id, name]) => ({\n        id,\n        name,\n        municipalityId,\n    }));\n}\n\n/** Normalized, frozen list of all 27 states (built once at module load). */\nconst STATES: readonly BrazilState[] = RAW.states\n    .map((entry) => {\n        const uf = entry.uf as UF;\n        const municipalities = entry.cities.map(([id, name]) => ({ id, name }));\n        return {\n            uf,\n            name: entry.name,\n            region: REGION_BY_UF[uf],\n            cities: municipalities.map((m) => m.name),\n            municipalities,\n            administrativeRegions: municipalities.flatMap((m) => regionsOf(m.id)),\n        };\n    })\n    .sort((a, b) => a.name.localeCompare(b.name, \"pt-BR\"));\n\nconst STATE_BY_UF = new Map<UF, BrazilState>(STATES.map((s) => [s.uf, s]));\n\n/**\n * Every name that resolves to a municipality, folded, keyed by `<UF>:<name>`.\n *\n * Three kinds of name land here and the precedence matters: a current IBGE name\n * wins, then a former name from `aliases`, then an administrative region of the\n * DF. A rename never shadows a live municipality — `Campo Grande` is a live\n * municipality in both MS and RN, and in RN it is also the former name of\n * nothing, so the live entry has to be written last.\n */\nconst ID_BY_FOLDED_NAME = new Map<string, string>();\nfor (const [name, id] of RAW.aliases) {\n    const uf = UF_BY_CODE[id.slice(0, 2)];\n    if (uf !== undefined) ID_BY_FOLDED_NAME.set(`${uf}:${foldName(name)}`, municipalityIdOf(id));\n}\nfor (const state of STATES) {\n    for (const region of state.administrativeRegions) {\n        ID_BY_FOLDED_NAME.set(`${state.uf}:${foldName(region.name)}`, region.municipalityId);\n    }\n}\nfor (const state of STATES) {\n    for (const municipality of state.municipalities) {\n        ID_BY_FOLDED_NAME.set(`${state.uf}:${foldName(municipality.name)}`, municipality.id);\n    }\n}\n\nconst MUNICIPALITY_BY_ID = new Map<string, BrazilMunicipality>(\n    STATES.flatMap((s) => s.municipalities).map((m) => [m.id, m]),\n);\n\n/** All 27 federative units, sorted by name. */\nexport function listStates(): readonly BrazilState[] {\n    return STATES;\n}\n\n/** Look up a single state by acronym (case-insensitive). Returns `null` if unknown. */\nexport function getState(uf: string): BrazilState | null {\n    const normalized = normalizeUf(uf);\n    return normalized ? (STATE_BY_UF.get(normalized) ?? null) : null;\n}\n\n/**\n * City names for a federative unit (case-insensitive acronym). Returns an empty\n * array for an unknown UF — \"no matches\" is a valid result, not an error.\n */\nexport function citiesByUf(uf: string): string[] {\n    return getState(uf)?.cities ?? [];\n}\n\n/** States belonging to a macro-region. */\nexport function statesByRegion(region: BrRegion): readonly BrazilState[] {\n    return STATES.filter((s) => s.region === region);\n}\n\n/** True when `value` is one of the 27 valid acronyms (case-insensitive). */\nexport function isValidUf(value: string): boolean {\n    return normalizeUf(value) !== null;\n}\n\n/**\n * Normalize an acronym to canonical uppercase form, or `null` if it is not a\n * valid UF. `\"sp\"` → `\"SP\"`, `\"xx\"` → `null`.\n */\nexport function normalizeUf(value: string): UF | null {\n    const upper = value.trim().toUpperCase();\n    return (REGION_BY_UF as Record<string, BrRegion>)[upper] ? (upper as UF) : null;\n}\n\n/** True when `city` exists within `uf` (both case-insensitive). */\nexport function isValidCity(uf: string, city: string): boolean {\n    const target = city.trim().toLowerCase();\n    return citiesByUf(uf).some((c) => c.toLowerCase() === target);\n}\n\n/** `{ value: uf, label: name }` options for every state, for a `<Select>`. */\nexport function ufChoices(): Choice[] {\n    return STATES.map((s) => ({ value: s.uf, label: s.name }));\n}\n\n/** `{ value, label }` options for every city in a UF (value === label). */\nexport function cityChoices(uf: string): Choice[] {\n    return citiesByUf(uf).map((c) => ({ value: c, label: c }));\n}\n\n/**\n * Municipalities of a federative unit, each carrying its IBGE code.\n *\n * The code is what a backend wants stored: it survives the renames that keep\n * happening (`Presidente Juscelino` became `Serra Caiada` in 2013) and it is the\n * key every other dataset in this module joins on.\n *\n * @param uf - Federative unit acronym, case-insensitive.\n * @returns The municipalities, alphabetically. Empty for an unknown UF.\n */\nexport function municipalitiesByUf(uf: string): readonly BrazilMunicipality[] {\n    return getState(uf)?.municipalities ?? [];\n}\n\n/**\n * Administrative regions of a federative unit.\n *\n * Only the Federal District has any — 35 of them, inside its single\n * municipality. Every other UF answers `[]`, which is a valid result and not an\n * error.\n *\n * @param uf - Federative unit acronym, case-insensitive.\n * @returns The regions, alphabetically. Empty outside the DF.\n */\nexport function administrativeRegionsByUf(uf: string): readonly BrazilAdministrativeRegion[] {\n    return getState(uf)?.administrativeRegions ?? [];\n}\n\n/**\n * Find the municipality a name refers to, however it was written down.\n *\n * Four kinds of name resolve, which is the point — an address saved years ago\n * has to keep pointing at the same place:\n *\n * 1. The current IBGE name (`\"Serra Caiada\"`).\n * 2. A former name (`\"Presidente Juscelino\"`), from the alias table the\n *    generator builds by diffing vintages.\n * 3. A different spelling — accents, case and apostrophes are folded, so\n *    `\"sant'ana do livramento\"` finds `\"Sant'Ana do Livramento\"`.\n * 4. An administrative region of the DF (`\"Ceilândia\"`), which resolves to\n *    Brasília — the municipality it is part of.\n *\n * A live municipality always wins over a former name, so a name that is current\n * in one UF and historical in another resolves to the live one in each.\n *\n * @param uf - Federative unit acronym, case-insensitive.\n * @param name - The municipality, region or former name.\n * @returns The municipality, or `null` when nothing in that UF answers to it.\n */\nexport function resolveMunicipality(uf: string, name: string): BrazilMunicipality | null {\n    const normalized = normalizeUf(uf);\n    if (normalized === null) return null;\n    const id = ID_BY_FOLDED_NAME.get(`${normalized}:${foldName(name)}`);\n    return id === undefined ? null : (MUNICIPALITY_BY_ID.get(id) ?? null);\n}\n\n/**\n * The IBGE vintages the bundled datasets were built from.\n *\n * `roster` is the day the municipality list was read and `mesh` the boundary\n * release it was joined to. They differ on purpose: IBGE publishes new\n * municipalities before it publishes their boundaries, and the gap is what\n * {@link pendingGeometryIds} enumerates.\n *\n * @returns The two vintages, as they were written into the data file.\n */\nexport function datasetVintage(): { roster: string; mesh: string } {\n    return RAW.vintage;\n}\n\n/**\n * Municipalities that exist in the roster and have no boundary yet.\n *\n * One today: Boa Esperança do Norte (MT), installed in 2023, for which IBGE\n * serves no mesh at any endpoint. It is listed and selectable, and it is the one\n * municipality `geocodeMunicipality` cannot place — so a caller that must plot\n * every selection can check this list up front instead of discovering it as an\n * empty result.\n *\n * @returns The IBGE codes, in the order the data file declares them.\n */\nexport function pendingGeometryIds(): readonly string[] {\n    return RAW.pendingGeometry;\n}\n"],"mappings":"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"}
+{"version":3,"file":"locations.js","names":["rawLocations","br_locations_default","REGION_BY_UF","RAW","foldName","value","UF_BY_CODE","municipalityIdOf","id","regionsOf","municipalityId","name","STATES","uf","entry","municipalities","m","a","b","STATE_BY_UF","s","ID_BY_FOLDED_NAME","state","region","municipality","MUNICIPALITY_BY_ID","listStates","getState","normalized","normalizeUf","citiesByUf","statesByRegion","isValidUf","upper","isValidCity","target","city","c","ufChoices","cityChoices","municipalitiesByUf","administrativeRegionsByUf","resolveMunicipality","datasetVintage","pendingGeometryIds"],"sources":["../../src/br/locations.ts"],"sourcesContent":["import rawLocations from \"./data/br-locations.json\";\n\n/** The 27 Brazilian federative units (26 states + Federal District). */\nexport type UF =\n    | \"AC\"\n    | \"AL\"\n    | \"AP\"\n    | \"AM\"\n    | \"BA\"\n    | \"CE\"\n    | \"DF\"\n    | \"ES\"\n    | \"GO\"\n    | \"MA\"\n    | \"MT\"\n    | \"MS\"\n    | \"MG\"\n    | \"PA\"\n    | \"PB\"\n    | \"PR\"\n    | \"PE\"\n    | \"PI\"\n    | \"RJ\"\n    | \"RN\"\n    | \"RS\"\n    | \"RO\"\n    | \"RR\"\n    | \"SC\"\n    | \"SP\"\n    | \"SE\"\n    | \"TO\";\n\n/** The five Brazilian macro-regions (IBGE). */\nexport type BrRegion = \"Norte\" | \"Nordeste\" | \"Centro-Oeste\" | \"Sudeste\" | \"Sul\";\n\n/** A municipality, identified by the code that survives its renames. */\nexport interface BrazilMunicipality {\n    /** 7-digit IBGE code, e.g. `\"3550308\"`. Stable across a rename. */\n    id: string;\n    /** Current IBGE name, e.g. `\"São Paulo\"`. */\n    name: string;\n}\n\n/**\n * An administrative region of the Federal District.\n *\n * The DF has exactly one municipality — Brasília — and 35 administrative\n * regions inside it. Nobody in the DF writes \"Brasília\" in an address field,\n * so the regions are listed and resolvable; they are not municipalities, and\n * `municipalityId` is what they geocode through.\n */\nexport interface BrazilAdministrativeRegion {\n    /** IBGE subdistrict code, e.g. `\"53001080515\"` for Ceilândia. */\n    id: string;\n    /** IBGE name, e.g. `\"Sudoeste/Octogonal\"`. */\n    name: string;\n    /** The municipality it belongs to — Brasília (`\"5300108\"`) for all 35. */\n    municipalityId: string;\n}\n\n/** A federative unit with its display name and city list. */\nexport interface BrazilState {\n    /** Two-letter acronym, e.g. `\"SP\"`. */\n    uf: UF;\n    /** Full name, e.g. `\"São Paulo\"`. */\n    name: string;\n    /** Macro-region the state belongs to. */\n    region: BrRegion;\n    /** Municipality names within the state, alphabetically. */\n    cities: string[];\n    /** The same municipalities carrying their IBGE codes, same order. */\n    municipalities: readonly BrazilMunicipality[];\n    /** Administrative regions — 35 for `\"DF\"`, empty everywhere else. */\n    administrativeRegions: readonly BrazilAdministrativeRegion[];\n}\n\n/** A `{ value, label }` option, handy for `<Select>` / `<Combobox>`. */\nexport interface Choice {\n    value: string;\n    label: string;\n}\n\n/** IBGE macro-region of each federative unit. */\nconst REGION_BY_UF: Record<UF, BrRegion> = {\n    AC: \"Norte\",\n    AP: \"Norte\",\n    AM: \"Norte\",\n    PA: \"Norte\",\n    RO: \"Norte\",\n    RR: \"Norte\",\n    TO: \"Norte\",\n    AL: \"Nordeste\",\n    BA: \"Nordeste\",\n    CE: \"Nordeste\",\n    MA: \"Nordeste\",\n    PB: \"Nordeste\",\n    PE: \"Nordeste\",\n    PI: \"Nordeste\",\n    RN: \"Nordeste\",\n    SE: \"Nordeste\",\n    DF: \"Centro-Oeste\",\n    GO: \"Centro-Oeste\",\n    MT: \"Centro-Oeste\",\n    MS: \"Centro-Oeste\",\n    ES: \"Sudeste\",\n    MG: \"Sudeste\",\n    RJ: \"Sudeste\",\n    SP: \"Sudeste\",\n    PR: \"Sul\",\n    RS: \"Sul\",\n    SC: \"Sul\",\n};\n\n/** One `[IBGE code, name]` row as `br-locations.json` stores it. */\ntype RawEntry = [string, string];\n\ninterface RawState {\n    uf: string;\n    name: string;\n    cities: RawEntry[];\n}\n\ninterface RawLocations {\n    /**\n     * The two IBGE vintages this file was built from: `roster` is the day the\n     * municipality list was read, `mesh` the boundary release it was joined to.\n     */\n    vintage: { roster: string; mesh: string };\n    states: RawState[];\n    /** Administrative regions keyed by the municipality that contains them. */\n    administrativeRegions: Record<string, RawEntry[]>;\n    /** Every former name, mapped to the IBGE code that still answers to it. */\n    aliases: RawEntry[];\n    /** Municipalities the roster lists and the mesh has no geometry for. */\n    pendingGeometry: string[];\n}\n\nconst RAW = rawLocations as unknown as RawLocations;\n\n/**\n * Strip a name down to what two spellings of the same place share.\n *\n * Accents, case and apostrophes are exactly what differs between the spelling a\n * user typed, the one an app saved five years ago and the one IBGE publishes\n * today — `\"Sant'Ana do Livramento\"` and `\"Santana do Livramento\"` are the same\n * municipality, and `\"acu\"` should find `\"Açu\"`.\n *\n * @param value - A municipality, region or alias name.\n * @returns The comparable form: lowercase, unaccented, apostrophes dropped.\n */\nfunction foldName(value: string): string {\n    return value\n        .trim()\n        .normalize(\"NFD\")\n        .replace(/[\\u0300-\\u036f]/g, \"\")\n        .replace(/['\\u2019\\u0060]/g, \"\")\n        .toLowerCase();\n}\n\n/** The federative unit each IBGE code starts with. */\nconst UF_BY_CODE: Record<string, UF> = {\n    \"11\": \"RO\",\n    \"12\": \"AC\",\n    \"13\": \"AM\",\n    \"14\": \"RR\",\n    \"15\": \"PA\",\n    \"16\": \"AP\",\n    \"17\": \"TO\",\n    \"21\": \"MA\",\n    \"22\": \"PI\",\n    \"23\": \"CE\",\n    \"24\": \"RN\",\n    \"25\": \"PB\",\n    \"26\": \"PE\",\n    \"27\": \"AL\",\n    \"28\": \"SE\",\n    \"29\": \"BA\",\n    \"31\": \"MG\",\n    \"32\": \"ES\",\n    \"33\": \"RJ\",\n    \"35\": \"SP\",\n    \"41\": \"PR\",\n    \"42\": \"SC\",\n    \"43\": \"RS\",\n    \"50\": \"MS\",\n    \"51\": \"MT\",\n    \"52\": \"GO\",\n    \"53\": \"DF\",\n};\n\n/**\n * The municipality an IBGE code belongs to.\n *\n * A municipality code is 7 digits and a subdistrict code extends it with 4 more\n * — `\"53001080515\"` (Ceilândia) is Brasília's `\"5300108\"` plus `\"0515\"` — so the\n * containing municipality is a prefix, not a lookup.\n *\n * @param id - A municipality or subdistrict IBGE code.\n * @returns The 7-digit municipality code.\n */\nfunction municipalityIdOf(id: string): string {\n    return id.slice(0, 7);\n}\n\n/** Administrative regions of a municipality, or `[]` when it has none. */\nfunction regionsOf(municipalityId: string): readonly BrazilAdministrativeRegion[] {\n    return (RAW.administrativeRegions[municipalityId] ?? []).map(([id, name]) => ({\n        id,\n        name,\n        municipalityId,\n    }));\n}\n\n/** Normalized, frozen list of all 27 states (built once at module load). */\nconst STATES: readonly BrazilState[] = RAW.states\n    .map((entry) => {\n        const uf = entry.uf as UF;\n        const municipalities = entry.cities.map(([id, name]) => ({ id, name }));\n        return {\n            uf,\n            name: entry.name,\n            region: REGION_BY_UF[uf],\n            cities: municipalities.map((m) => m.name),\n            municipalities,\n            administrativeRegions: municipalities.flatMap((m) => regionsOf(m.id)),\n        };\n    })\n    .sort((a, b) => a.name.localeCompare(b.name, \"pt-BR\"));\n\nconst STATE_BY_UF = new Map<UF, BrazilState>(STATES.map((s) => [s.uf, s]));\n\n/**\n * Every name that resolves to a municipality, folded, keyed by `<UF>:<name>`.\n *\n * Three kinds of name land here and the precedence matters: a current IBGE name\n * wins, then a former name from `aliases`, then an administrative region of the\n * DF. A rename never shadows a live municipality — `Campo Grande` is a live\n * municipality in both MS and RN, and in RN it is also the former name of\n * nothing, so the live entry has to be written last.\n */\nconst ID_BY_FOLDED_NAME = new Map<string, string>();\nfor (const [name, id] of RAW.aliases) {\n    const uf = UF_BY_CODE[id.slice(0, 2)];\n    if (uf !== undefined) ID_BY_FOLDED_NAME.set(`${uf}:${foldName(name)}`, municipalityIdOf(id));\n}\nfor (const state of STATES) {\n    for (const region of state.administrativeRegions) {\n        ID_BY_FOLDED_NAME.set(`${state.uf}:${foldName(region.name)}`, region.municipalityId);\n    }\n}\nfor (const state of STATES) {\n    for (const municipality of state.municipalities) {\n        ID_BY_FOLDED_NAME.set(`${state.uf}:${foldName(municipality.name)}`, municipality.id);\n    }\n}\n\nconst MUNICIPALITY_BY_ID = new Map<string, BrazilMunicipality>(\n    STATES.flatMap((s) => s.municipalities).map((m) => [m.id, m]),\n);\n\n/** All 27 federative units, sorted by name. */\nexport function listStates(): readonly BrazilState[] {\n    return STATES;\n}\n\n/** Look up a single state by acronym (case-insensitive). Returns `null` if unknown. */\nexport function getState(uf: string): BrazilState | null {\n    const normalized = normalizeUf(uf);\n    return normalized ? (STATE_BY_UF.get(normalized) ?? null) : null;\n}\n\n/**\n * City names for a federative unit (case-insensitive acronym). Returns an empty\n * array for an unknown UF — \"no matches\" is a valid result, not an error.\n */\nexport function citiesByUf(uf: string): string[] {\n    return getState(uf)?.cities ?? [];\n}\n\n/** States belonging to a macro-region. */\nexport function statesByRegion(region: BrRegion): readonly BrazilState[] {\n    return STATES.filter((s) => s.region === region);\n}\n\n/** True when `value` is one of the 27 valid acronyms (case-insensitive). */\nexport function isValidUf(value: string): boolean {\n    return normalizeUf(value) !== null;\n}\n\n/**\n * Normalize an acronym to canonical uppercase form, or `null` if it is not a\n * valid UF. `\"sp\"` → `\"SP\"`, `\"xx\"` → `null`.\n */\nexport function normalizeUf(value: string): UF | null {\n    const upper = value.trim().toUpperCase();\n    return (REGION_BY_UF as Record<string, BrRegion>)[upper] ? (upper as UF) : null;\n}\n\n/** True when `city` exists within `uf` (both case-insensitive). */\nexport function isValidCity(uf: string, city: string): boolean {\n    const target = city.trim().toLowerCase();\n    return citiesByUf(uf).some((c) => c.toLowerCase() === target);\n}\n\n/** `{ value: uf, label: name }` options for every state, for a `<Select>`. */\nexport function ufChoices(): Choice[] {\n    return STATES.map((s) => ({ value: s.uf, label: s.name }));\n}\n\n/** `{ value, label }` options for every city in a UF (value === label). */\nexport function cityChoices(uf: string): Choice[] {\n    return citiesByUf(uf).map((c) => ({ value: c, label: c }));\n}\n\n/**\n * Municipalities of a federative unit, each carrying its IBGE code.\n *\n * The code is what a backend wants stored: it survives the renames that keep\n * happening (`Presidente Juscelino` became `Serra Caiada` in 2013) and it is the\n * key every other dataset in this module joins on.\n *\n * @param uf - Federative unit acronym, case-insensitive.\n * @returns The municipalities, alphabetically. Empty for an unknown UF.\n */\nexport function municipalitiesByUf(uf: string): readonly BrazilMunicipality[] {\n    return getState(uf)?.municipalities ?? [];\n}\n\n/**\n * Administrative regions of a federative unit.\n *\n * Only the Federal District has any — 35 of them, inside its single\n * municipality. Every other UF answers `[]`, which is a valid result and not an\n * error.\n *\n * @param uf - Federative unit acronym, case-insensitive.\n * @returns The regions, alphabetically. Empty outside the DF.\n */\nexport function administrativeRegionsByUf(uf: string): readonly BrazilAdministrativeRegion[] {\n    return getState(uf)?.administrativeRegions ?? [];\n}\n\n/**\n * Find the municipality a name refers to, however it was written down.\n *\n * Four kinds of name resolve, which is the point — an address saved years ago\n * has to keep pointing at the same place:\n *\n * 1. The current IBGE name (`\"Serra Caiada\"`).\n * 2. A former name (`\"Presidente Juscelino\"`), from the alias table the\n *    generator builds by diffing vintages.\n * 3. A different spelling — accents, case and apostrophes are folded, so\n *    `\"sant'ana do livramento\"` finds `\"Sant'Ana do Livramento\"`.\n * 4. An administrative region of the DF (`\"Ceilândia\"`), which resolves to\n *    Brasília — the municipality it is part of.\n *\n * A live municipality always wins over a former name, so a name that is current\n * in one UF and historical in another resolves to the live one in each.\n *\n * @param uf - Federative unit acronym, case-insensitive.\n * @param name - The municipality, region or former name.\n * @returns The municipality, or `null` when nothing in that UF answers to it.\n */\nexport function resolveMunicipality(uf: string, name: string): BrazilMunicipality | null {\n    const normalized = normalizeUf(uf);\n    if (normalized === null) return null;\n    const id = ID_BY_FOLDED_NAME.get(`${normalized}:${foldName(name)}`);\n    return id === undefined ? null : (MUNICIPALITY_BY_ID.get(id) ?? null);\n}\n\n/**\n * The IBGE vintages the bundled datasets were built from.\n *\n * `roster` is the day the municipality list was read and `mesh` the boundary\n * release it was joined to. They differ on purpose: IBGE publishes new\n * municipalities before it publishes their boundaries, and the gap is what\n * {@link pendingGeometryIds} enumerates.\n *\n * @returns The two vintages, as they were written into the data file.\n */\nexport function datasetVintage(): { roster: string; mesh: string } {\n    return RAW.vintage;\n}\n\n/**\n * Municipalities that exist in the roster and have no boundary yet.\n *\n * One today: Boa Esperança do Norte (MT), installed in 2023, for which IBGE\n * serves no mesh at any endpoint. It is listed and selectable, and it is the one\n * municipality `geocodeMunicipality` cannot place — so a caller that must plot\n * every selection can check this list up front instead of discovering it as an\n * empty result.\n *\n * @returns The IBGE codes, in the order the data file declares them.\n */\nexport function pendingGeometryIds(): readonly string[] {\n    return RAW.pendingGeometry;\n}\n"],"mappings":"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"}

package/dist/br/nfe.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"nfe.cjs","names":[],"sources":["../../src/br/nfe.ts"],"sourcesContent":["import type { UF } from \"./locations\";\n\n/**\n * A 44-digit fiscal access key could not be read.\n *\n * Its own class so a scanner screen can tell a bad key apart from a bug and show\n * the message to the operator unchanged.\n */\nexport class ChaveNFeError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ChaveNFeError\";\n    }\n}\n\n/** A fiscal access key taken apart. */\nexport interface ChaveNFe {\n    /** Federative unit of the issuer, resolved from {@link cUF}. */\n    uf: UF;\n    /** The raw 2-digit IBGE code, positions 1-2. */\n    cUF: string;\n    /** Positions 3-6, `AAMM` — the two-digit year and the month of issue. */\n    anoMes: string;\n    /** Four-digit year derived from {@link anoMes}. */\n    ano: number;\n    /** Month of issue, 1-12. */\n    mes: number;\n    /** Positions 7-20, the issuer's CNPJ. */\n    cnpj: string;\n    /** Positions 21-22, `mod`. `\"55\"` is an NF-e, `\"65\"` an NFC-e. */\n    modelo: string;\n    /** Human label for {@link modelo}, or `null` for a model outside the table. */\n    modeloLabel: string | null;\n    /** Positions 23-25. */\n    serie: string;\n    /** Positions 26-34, `nNF`. */\n    numero: string;\n    /** Position 35, `tpEmis`. */\n    tipoEmissao: string;\n    /** Human label for {@link tipoEmissao}, or `null` for a value outside the table. */\n    tipoEmissaoLabel: string | null;\n    /** Positions 36-43, `cNF` — the issuer's random code. */\n    codigoNumerico: string;\n    /** Position 44, `cDV`. */\n    dv: string;\n}\n\n/**\n * IBGE code of each federative unit, as `cUF` carries it.\n *\n * Only the numeric codes live here — the acronyms are the `UF` union from\n * `./locations`, so a state added or renamed there flows through. Ported from the\n * IBGE table of \"códigos dos municípios\" (the two leading digits of every\n * municipality code), which is the same table the NF-e manual points at.\n */\nconst UF_BY_CODE: Record<string, UF> = {\n    \"11\": \"RO\",\n    \"12\": \"AC\",\n    \"13\": \"AM\",\n    \"14\": \"RR\",\n    \"15\": \"PA\",\n    \"16\": \"AP\",\n    \"17\": \"TO\",\n    \"21\": \"MA\",\n    \"22\": \"PI\",\n    \"23\": \"CE\",\n    \"24\": \"RN\",\n    \"25\": \"PB\",\n    \"26\": \"PE\",\n    \"27\": \"AL\",\n    \"28\": \"SE\",\n    \"29\": \"BA\",\n    \"31\": \"MG\",\n    \"32\": \"ES\",\n    \"33\": \"RJ\",\n    \"35\": \"SP\",\n    \"41\": \"PR\",\n    \"42\": \"SC\",\n    \"43\": \"RS\",\n    \"50\": \"MS\",\n    \"51\": \"MT\",\n    \"52\": \"GO\",\n    \"53\": \"DF\",\n};\n\n/** The document models that share the 44-digit key layout. */\nconst MODELO_LABELS: Record<string, string> = {\n    \"55\": \"NF-e\",\n    \"57\": \"CT-e\",\n    \"58\": \"MDF-e\",\n    \"59\": \"SAT-CF-e\",\n    \"63\": \"BP-e\",\n    \"65\": \"NFC-e\",\n    \"66\": \"NF3e\",\n    \"67\": \"CT-e OS\",\n};\n\n/** `tpEmis` values from the NF-e manual. */\nconst TIPO_EMISSAO_LABELS: Record<string, string> = {\n    \"1\": \"Normal\",\n    \"2\": \"Contingência FS-IA\",\n    \"3\": \"Contingência SCAN\",\n    \"4\": \"Contingência DPEC/EPEC\",\n    \"5\": \"Contingência FS-DA\",\n    \"6\": \"Contingência SVC-AN\",\n    \"7\": \"Contingência SVC-RS\",\n    \"9\": \"Contingência off-line (NFC-e)\",\n};\n\n/** Weight cycle of the módulo 11 check digit, applied right to left. */\nconst DV_WEIGHT_FIRST = 2;\nconst DV_WEIGHT_LAST = 9;\n\n/** Length of the key, and of the body the check digit protects. */\nconst CHAVE_LENGTH = 44;\nconst CHAVE_BODY_LENGTH = 43;\n\n/** Century the two-digit `AAMM` year resolves into. NF-e went live in 2006. */\nconst CHAVE_YEAR_BASE = 2000;\n\n/** Digits of a key that may carry spaces or dots from a copy-paste. */\nfunction digits(value: string): string {\n    return value.replace(/\\D/g, \"\");\n}\n\n/**\n * The check digit a 43-digit key body requires.\n *\n * Módulo 11: each digit is multiplied by weights cycling `2…9` from right to\n * left, the products are summed, and the digit is `11 - (sum mod 11)` — except\n * that a remainder of `0` or `1` yields `0`, since `11` and `10` do not fit one\n * position.\n *\n * Note this is the **fiscal** flavour of módulo 11. The cobrança boleto resolves\n * those same remainders to `1`; see `mod11DacCobranca` in `./boleto`.\n *\n * @param body - The first 43 digits of the key.\n * @returns The check digit, 0-9.\n * @throws {ChaveNFeError} When `body` is not exactly 43 digits.\n */\nexport function chaveNFeCheckDigit(body: string): number {\n    if (!new RegExp(`^\\\\d{${CHAVE_BODY_LENGTH}}$`).test(body)) {\n        throw new ChaveNFeError(\n            `The check digit is computed over ${CHAVE_BODY_LENGTH} digits, got ${body.length}.`,\n        );\n    }\n    const span = DV_WEIGHT_LAST - DV_WEIGHT_FIRST + 1;\n    let sum = 0;\n    for (let index = 0; index < body.length; index += 1) {\n        const fromRight = body.length - 1 - index;\n        sum += Number(body[index]) * (DV_WEIGHT_FIRST + (fromRight % span));\n    }\n    const remainder = sum % 11;\n    return remainder === 0 || remainder === 1 ? 0 : 11 - remainder;\n}\n\n/**\n * Whether a fiscal access key is well formed.\n *\n * Three things have to hold: 44 digits, a `cUF` that is a real federative unit,\n * and a check digit that recomputes. It says nothing about whether the document\n * exists or was authorised — only SEFAZ can answer that — but it catches the\n * failure that actually happens, a key transcribed by hand or truncated by a\n * spreadsheet.\n *\n * @param chave - The key, with or without the spaces a DANFE prints.\n * @returns `true` when all three hold.\n *\n * @example\n * if (!validateChaveNFe(input)) setError(\"Chave inválida.\");\n */\nexport function validateChaveNFe(chave: string): boolean {\n    const raw = digits(chave);\n    if (raw.length !== CHAVE_LENGTH) return false;\n    if (UF_BY_CODE[raw.slice(0, 2)] === undefined) return false;\n    return String(chaveNFeCheckDigit(raw.slice(0, CHAVE_BODY_LENGTH))) === raw.slice(43);\n}\n\n/**\n * Read a 44-digit fiscal access key into its fields.\n *\n * The layout is fixed and shared by every document type that carries a key —\n * NF-e, NFC-e, CT-e, MDF-e — so `modelo` is what tells you which one you are\n * holding, not the length.\n *\n * ```text\n * 35 2601 12345678000195 55 001 000000123 1 12345678 4\n * cUF AAMM CNPJ           mod série nNF    tp cNF     cDV\n * ```\n *\n * @param chave - The key, with or without the spaces a DANFE prints.\n * @returns The parsed key.\n * @throws {ChaveNFeError} On a length other than 44, an unknown `cUF`, a month\n * outside 1-12, or a check digit that does not recompute.\n *\n * @example\n * const { uf, cnpj, numero, modeloLabel } = parseChaveNFe(scanned);\n */\nexport function parseChaveNFe(chave: string): ChaveNFe {\n    const raw = digits(chave);\n    if (raw.length !== CHAVE_LENGTH) {\n        throw new ChaveNFeError(`An access key has ${CHAVE_LENGTH} digits, got ${raw.length}.`);\n    }\n\n    const cUF = raw.slice(0, 2);\n    const uf = UF_BY_CODE[cUF];\n    if (uf === undefined) {\n        throw new ChaveNFeError(`${cUF} is not an IBGE code for a federative unit.`);\n    }\n\n    const anoMes = raw.slice(2, 6);\n    const mes = Number(anoMes.slice(2, 4));\n    if (mes < 1 || mes > 12) {\n        throw new ChaveNFeError(`Month ${anoMes.slice(2, 4)} in AAMM is not a month.`);\n    }\n\n    const dv = raw.slice(43);\n    const expected = chaveNFeCheckDigit(raw.slice(0, CHAVE_BODY_LENGTH));\n    if (String(expected) !== dv) {\n        throw new ChaveNFeError(`Check digit is ${dv}, recomputed ${expected}.`);\n    }\n\n    const modelo = raw.slice(20, 22);\n    const tipoEmissao = raw.slice(34, 35);\n    return {\n        uf,\n        cUF,\n        anoMes,\n        ano: CHAVE_YEAR_BASE + Number(anoMes.slice(0, 2)),\n        mes,\n        cnpj: raw.slice(6, 20),\n        modelo,\n        modeloLabel: MODELO_LABELS[modelo] ?? null,\n        serie: raw.slice(22, 25),\n        numero: raw.slice(25, 34),\n        tipoEmissao,\n        tipoEmissaoLabel: TIPO_EMISSAO_LABELS[tipoEmissao] ?? null,\n        codigoNumerico: raw.slice(35, 43),\n        dv,\n    };\n}\n\n/**\n * Group a key in blocks of four, the way a DANFE prints it.\n *\n * @param chave - The key, masked or not.\n * @returns Eleven groups of four digits separated by spaces, or the input\n * unchanged when it is not 44 digits — this is a display helper, not a validator.\n *\n * @example\n * formatChaveNFe(\"35260112345678000195550010000001231123456784\");\n * // \"3526 0112 3456 7800 0195 5500 1000 0001 2311 2345 6784\"\n */\nexport function formatChaveNFe(chave: string): string {\n    const raw = digits(chave);\n    if (raw.length !== CHAVE_LENGTH) return chave;\n    return raw.replace(/(\\d{4})(?=\\d)/g, \"$1 \");\n}\n"],"mappings":"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"}
+{"version":3,"file":"nfe.cjs","names":["ChaveNFeError","message","UF_BY_CODE","MODELO_LABELS","TIPO_EMISSAO_LABELS","DV_WEIGHT_FIRST","CHAVE_LENGTH","CHAVE_BODY_LENGTH","CHAVE_YEAR_BASE","digits","value","chaveNFeCheckDigit","body","sum","index","fromRight","remainder","validateChaveNFe","raw","chave","parseChaveNFe","cUF","uf","anoMes","mes","dv","expected","modelo","tipoEmissao","formatChaveNFe"],"sources":["../../src/br/nfe.ts"],"sourcesContent":["import type { UF } from \"./locations\";\n\n/**\n * A 44-digit fiscal access key could not be read.\n *\n * Its own class so a scanner screen can tell a bad key apart from a bug and show\n * the message to the operator unchanged.\n */\nexport class ChaveNFeError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ChaveNFeError\";\n    }\n}\n\n/** A fiscal access key taken apart. */\nexport interface ChaveNFe {\n    /** Federative unit of the issuer, resolved from {@link cUF}. */\n    uf: UF;\n    /** The raw 2-digit IBGE code, positions 1-2. */\n    cUF: string;\n    /** Positions 3-6, `AAMM` — the two-digit year and the month of issue. */\n    anoMes: string;\n    /** Four-digit year derived from {@link anoMes}. */\n    ano: number;\n    /** Month of issue, 1-12. */\n    mes: number;\n    /** Positions 7-20, the issuer's CNPJ. */\n    cnpj: string;\n    /** Positions 21-22, `mod`. `\"55\"` is an NF-e, `\"65\"` an NFC-e. */\n    modelo: string;\n    /** Human label for {@link modelo}, or `null` for a model outside the table. */\n    modeloLabel: string | null;\n    /** Positions 23-25. */\n    serie: string;\n    /** Positions 26-34, `nNF`. */\n    numero: string;\n    /** Position 35, `tpEmis`. */\n    tipoEmissao: string;\n    /** Human label for {@link tipoEmissao}, or `null` for a value outside the table. */\n    tipoEmissaoLabel: string | null;\n    /** Positions 36-43, `cNF` — the issuer's random code. */\n    codigoNumerico: string;\n    /** Position 44, `cDV`. */\n    dv: string;\n}\n\n/**\n * IBGE code of each federative unit, as `cUF` carries it.\n *\n * Only the numeric codes live here — the acronyms are the `UF` union from\n * `./locations`, so a state added or renamed there flows through. Ported from the\n * IBGE table of \"códigos dos municípios\" (the two leading digits of every\n * municipality code), which is the same table the NF-e manual points at.\n */\nconst UF_BY_CODE: Record<string, UF> = {\n    \"11\": \"RO\",\n    \"12\": \"AC\",\n    \"13\": \"AM\",\n    \"14\": \"RR\",\n    \"15\": \"PA\",\n    \"16\": \"AP\",\n    \"17\": \"TO\",\n    \"21\": \"MA\",\n    \"22\": \"PI\",\n    \"23\": \"CE\",\n    \"24\": \"RN\",\n    \"25\": \"PB\",\n    \"26\": \"PE\",\n    \"27\": \"AL\",\n    \"28\": \"SE\",\n    \"29\": \"BA\",\n    \"31\": \"MG\",\n    \"32\": \"ES\",\n    \"33\": \"RJ\",\n    \"35\": \"SP\",\n    \"41\": \"PR\",\n    \"42\": \"SC\",\n    \"43\": \"RS\",\n    \"50\": \"MS\",\n    \"51\": \"MT\",\n    \"52\": \"GO\",\n    \"53\": \"DF\",\n};\n\n/** The document models that share the 44-digit key layout. */\nconst MODELO_LABELS: Record<string, string> = {\n    \"55\": \"NF-e\",\n    \"57\": \"CT-e\",\n    \"58\": \"MDF-e\",\n    \"59\": \"SAT-CF-e\",\n    \"63\": \"BP-e\",\n    \"65\": \"NFC-e\",\n    \"66\": \"NF3e\",\n    \"67\": \"CT-e OS\",\n};\n\n/** `tpEmis` values from the NF-e manual. */\nconst TIPO_EMISSAO_LABELS: Record<string, string> = {\n    \"1\": \"Normal\",\n    \"2\": \"Contingência FS-IA\",\n    \"3\": \"Contingência SCAN\",\n    \"4\": \"Contingência DPEC/EPEC\",\n    \"5\": \"Contingência FS-DA\",\n    \"6\": \"Contingência SVC-AN\",\n    \"7\": \"Contingência SVC-RS\",\n    \"9\": \"Contingência off-line (NFC-e)\",\n};\n\n/** Weight cycle of the módulo 11 check digit, applied right to left. */\nconst DV_WEIGHT_FIRST = 2;\nconst DV_WEIGHT_LAST = 9;\n\n/** Length of the key, and of the body the check digit protects. */\nconst CHAVE_LENGTH = 44;\nconst CHAVE_BODY_LENGTH = 43;\n\n/** Century the two-digit `AAMM` year resolves into. NF-e went live in 2006. */\nconst CHAVE_YEAR_BASE = 2000;\n\n/** Digits of a key that may carry spaces or dots from a copy-paste. */\nfunction digits(value: string): string {\n    return value.replace(/\\D/g, \"\");\n}\n\n/**\n * The check digit a 43-digit key body requires.\n *\n * Módulo 11: each digit is multiplied by weights cycling `2…9` from right to\n * left, the products are summed, and the digit is `11 - (sum mod 11)` — except\n * that a remainder of `0` or `1` yields `0`, since `11` and `10` do not fit one\n * position.\n *\n * Note this is the **fiscal** flavour of módulo 11. The cobrança boleto resolves\n * those same remainders to `1`; see `mod11DacCobranca` in `./boleto`.\n *\n * @param body - The first 43 digits of the key.\n * @returns The check digit, 0-9.\n * @throws {ChaveNFeError} When `body` is not exactly 43 digits.\n */\nexport function chaveNFeCheckDigit(body: string): number {\n    if (!new RegExp(`^\\\\d{${CHAVE_BODY_LENGTH}}$`).test(body)) {\n        throw new ChaveNFeError(\n            `The check digit is computed over ${CHAVE_BODY_LENGTH} digits, got ${body.length}.`,\n        );\n    }\n    const span = DV_WEIGHT_LAST - DV_WEIGHT_FIRST + 1;\n    let sum = 0;\n    for (let index = 0; index < body.length; index += 1) {\n        const fromRight = body.length - 1 - index;\n        sum += Number(body[index]) * (DV_WEIGHT_FIRST + (fromRight % span));\n    }\n    const remainder = sum % 11;\n    return remainder === 0 || remainder === 1 ? 0 : 11 - remainder;\n}\n\n/**\n * Whether a fiscal access key is well formed.\n *\n * Three things have to hold: 44 digits, a `cUF` that is a real federative unit,\n * and a check digit that recomputes. It says nothing about whether the document\n * exists or was authorised — only SEFAZ can answer that — but it catches the\n * failure that actually happens, a key transcribed by hand or truncated by a\n * spreadsheet.\n *\n * @param chave - The key, with or without the spaces a DANFE prints.\n * @returns `true` when all three hold.\n *\n * @example\n * if (!validateChaveNFe(input)) setError(\"Chave inválida.\");\n */\nexport function validateChaveNFe(chave: string): boolean {\n    const raw = digits(chave);\n    if (raw.length !== CHAVE_LENGTH) return false;\n    if (UF_BY_CODE[raw.slice(0, 2)] === undefined) return false;\n    return String(chaveNFeCheckDigit(raw.slice(0, CHAVE_BODY_LENGTH))) === raw.slice(43);\n}\n\n/**\n * Read a 44-digit fiscal access key into its fields.\n *\n * The layout is fixed and shared by every document type that carries a key —\n * NF-e, NFC-e, CT-e, MDF-e — so `modelo` is what tells you which one you are\n * holding, not the length.\n *\n * ```text\n * 35 2601 12345678000195 55 001 000000123 1 12345678 4\n * cUF AAMM CNPJ           mod série nNF    tp cNF     cDV\n * ```\n *\n * @param chave - The key, with or without the spaces a DANFE prints.\n * @returns The parsed key.\n * @throws {ChaveNFeError} On a length other than 44, an unknown `cUF`, a month\n * outside 1-12, or a check digit that does not recompute.\n *\n * @example\n * const { uf, cnpj, numero, modeloLabel } = parseChaveNFe(scanned);\n */\nexport function parseChaveNFe(chave: string): ChaveNFe {\n    const raw = digits(chave);\n    if (raw.length !== CHAVE_LENGTH) {\n        throw new ChaveNFeError(`An access key has ${CHAVE_LENGTH} digits, got ${raw.length}.`);\n    }\n\n    const cUF = raw.slice(0, 2);\n    const uf = UF_BY_CODE[cUF];\n    if (uf === undefined) {\n        throw new ChaveNFeError(`${cUF} is not an IBGE code for a federative unit.`);\n    }\n\n    const anoMes = raw.slice(2, 6);\n    const mes = Number(anoMes.slice(2, 4));\n    if (mes < 1 || mes > 12) {\n        throw new ChaveNFeError(`Month ${anoMes.slice(2, 4)} in AAMM is not a month.`);\n    }\n\n    const dv = raw.slice(43);\n    const expected = chaveNFeCheckDigit(raw.slice(0, CHAVE_BODY_LENGTH));\n    if (String(expected) !== dv) {\n        throw new ChaveNFeError(`Check digit is ${dv}, recomputed ${expected}.`);\n    }\n\n    const modelo = raw.slice(20, 22);\n    const tipoEmissao = raw.slice(34, 35);\n    return {\n        uf,\n        cUF,\n        anoMes,\n        ano: CHAVE_YEAR_BASE + Number(anoMes.slice(0, 2)),\n        mes,\n        cnpj: raw.slice(6, 20),\n        modelo,\n        modeloLabel: MODELO_LABELS[modelo] ?? null,\n        serie: raw.slice(22, 25),\n        numero: raw.slice(25, 34),\n        tipoEmissao,\n        tipoEmissaoLabel: TIPO_EMISSAO_LABELS[tipoEmissao] ?? null,\n        codigoNumerico: raw.slice(35, 43),\n        dv,\n    };\n}\n\n/**\n * Group a key in blocks of four, the way a DANFE prints it.\n *\n * @param chave - The key, masked or not.\n * @returns Eleven groups of four digits separated by spaces, or the input\n * unchanged when it is not 44 digits — this is a display helper, not a validator.\n *\n * @example\n * formatChaveNFe(\"35260112345678000195550010000001231123456784\");\n * // \"3526 0112 3456 7800 0195 5500 1000 0001 2311 2345 6784\"\n */\nexport function formatChaveNFe(chave: string): string {\n    const raw = digits(chave);\n    if (raw.length !== CHAVE_LENGTH) return chave;\n    return raw.replace(/(\\d{4})(?=\\d)/g, \"$1 \");\n}\n"],"mappings":"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"}

package/dist/br/nfe.js.map

@@ -1 +1 @@
-{"version":3,"file":"nfe.js","names":[],"sources":["../../src/br/nfe.ts"],"sourcesContent":["import type { UF } from \"./locations\";\n\n/**\n * A 44-digit fiscal access key could not be read.\n *\n * Its own class so a scanner screen can tell a bad key apart from a bug and show\n * the message to the operator unchanged.\n */\nexport class ChaveNFeError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ChaveNFeError\";\n    }\n}\n\n/** A fiscal access key taken apart. */\nexport interface ChaveNFe {\n    /** Federative unit of the issuer, resolved from {@link cUF}. */\n    uf: UF;\n    /** The raw 2-digit IBGE code, positions 1-2. */\n    cUF: string;\n    /** Positions 3-6, `AAMM` — the two-digit year and the month of issue. */\n    anoMes: string;\n    /** Four-digit year derived from {@link anoMes}. */\n    ano: number;\n    /** Month of issue, 1-12. */\n    mes: number;\n    /** Positions 7-20, the issuer's CNPJ. */\n    cnpj: string;\n    /** Positions 21-22, `mod`. `\"55\"` is an NF-e, `\"65\"` an NFC-e. */\n    modelo: string;\n    /** Human label for {@link modelo}, or `null` for a model outside the table. */\n    modeloLabel: string | null;\n    /** Positions 23-25. */\n    serie: string;\n    /** Positions 26-34, `nNF`. */\n    numero: string;\n    /** Position 35, `tpEmis`. */\n    tipoEmissao: string;\n    /** Human label for {@link tipoEmissao}, or `null` for a value outside the table. */\n    tipoEmissaoLabel: string | null;\n    /** Positions 36-43, `cNF` — the issuer's random code. */\n    codigoNumerico: string;\n    /** Position 44, `cDV`. */\n    dv: string;\n}\n\n/**\n * IBGE code of each federative unit, as `cUF` carries it.\n *\n * Only the numeric codes live here — the acronyms are the `UF` union from\n * `./locations`, so a state added or renamed there flows through. Ported from the\n * IBGE table of \"códigos dos municípios\" (the two leading digits of every\n * municipality code), which is the same table the NF-e manual points at.\n */\nconst UF_BY_CODE: Record<string, UF> = {\n    \"11\": \"RO\",\n    \"12\": \"AC\",\n    \"13\": \"AM\",\n    \"14\": \"RR\",\n    \"15\": \"PA\",\n    \"16\": \"AP\",\n    \"17\": \"TO\",\n    \"21\": \"MA\",\n    \"22\": \"PI\",\n    \"23\": \"CE\",\n    \"24\": \"RN\",\n    \"25\": \"PB\",\n    \"26\": \"PE\",\n    \"27\": \"AL\",\n    \"28\": \"SE\",\n    \"29\": \"BA\",\n    \"31\": \"MG\",\n    \"32\": \"ES\",\n    \"33\": \"RJ\",\n    \"35\": \"SP\",\n    \"41\": \"PR\",\n    \"42\": \"SC\",\n    \"43\": \"RS\",\n    \"50\": \"MS\",\n    \"51\": \"MT\",\n    \"52\": \"GO\",\n    \"53\": \"DF\",\n};\n\n/** The document models that share the 44-digit key layout. */\nconst MODELO_LABELS: Record<string, string> = {\n    \"55\": \"NF-e\",\n    \"57\": \"CT-e\",\n    \"58\": \"MDF-e\",\n    \"59\": \"SAT-CF-e\",\n    \"63\": \"BP-e\",\n    \"65\": \"NFC-e\",\n    \"66\": \"NF3e\",\n    \"67\": \"CT-e OS\",\n};\n\n/** `tpEmis` values from the NF-e manual. */\nconst TIPO_EMISSAO_LABELS: Record<string, string> = {\n    \"1\": \"Normal\",\n    \"2\": \"Contingência FS-IA\",\n    \"3\": \"Contingência SCAN\",\n    \"4\": \"Contingência DPEC/EPEC\",\n    \"5\": \"Contingência FS-DA\",\n    \"6\": \"Contingência SVC-AN\",\n    \"7\": \"Contingência SVC-RS\",\n    \"9\": \"Contingência off-line (NFC-e)\",\n};\n\n/** Weight cycle of the módulo 11 check digit, applied right to left. */\nconst DV_WEIGHT_FIRST = 2;\nconst DV_WEIGHT_LAST = 9;\n\n/** Length of the key, and of the body the check digit protects. */\nconst CHAVE_LENGTH = 44;\nconst CHAVE_BODY_LENGTH = 43;\n\n/** Century the two-digit `AAMM` year resolves into. NF-e went live in 2006. */\nconst CHAVE_YEAR_BASE = 2000;\n\n/** Digits of a key that may carry spaces or dots from a copy-paste. */\nfunction digits(value: string): string {\n    return value.replace(/\\D/g, \"\");\n}\n\n/**\n * The check digit a 43-digit key body requires.\n *\n * Módulo 11: each digit is multiplied by weights cycling `2…9` from right to\n * left, the products are summed, and the digit is `11 - (sum mod 11)` — except\n * that a remainder of `0` or `1` yields `0`, since `11` and `10` do not fit one\n * position.\n *\n * Note this is the **fiscal** flavour of módulo 11. The cobrança boleto resolves\n * those same remainders to `1`; see `mod11DacCobranca` in `./boleto`.\n *\n * @param body - The first 43 digits of the key.\n * @returns The check digit, 0-9.\n * @throws {ChaveNFeError} When `body` is not exactly 43 digits.\n */\nexport function chaveNFeCheckDigit(body: string): number {\n    if (!new RegExp(`^\\\\d{${CHAVE_BODY_LENGTH}}$`).test(body)) {\n        throw new ChaveNFeError(\n            `The check digit is computed over ${CHAVE_BODY_LENGTH} digits, got ${body.length}.`,\n        );\n    }\n    const span = DV_WEIGHT_LAST - DV_WEIGHT_FIRST + 1;\n    let sum = 0;\n    for (let index = 0; index < body.length; index += 1) {\n        const fromRight = body.length - 1 - index;\n        sum += Number(body[index]) * (DV_WEIGHT_FIRST + (fromRight % span));\n    }\n    const remainder = sum % 11;\n    return remainder === 0 || remainder === 1 ? 0 : 11 - remainder;\n}\n\n/**\n * Whether a fiscal access key is well formed.\n *\n * Three things have to hold: 44 digits, a `cUF` that is a real federative unit,\n * and a check digit that recomputes. It says nothing about whether the document\n * exists or was authorised — only SEFAZ can answer that — but it catches the\n * failure that actually happens, a key transcribed by hand or truncated by a\n * spreadsheet.\n *\n * @param chave - The key, with or without the spaces a DANFE prints.\n * @returns `true` when all three hold.\n *\n * @example\n * if (!validateChaveNFe(input)) setError(\"Chave inválida.\");\n */\nexport function validateChaveNFe(chave: string): boolean {\n    const raw = digits(chave);\n    if (raw.length !== CHAVE_LENGTH) return false;\n    if (UF_BY_CODE[raw.slice(0, 2)] === undefined) return false;\n    return String(chaveNFeCheckDigit(raw.slice(0, CHAVE_BODY_LENGTH))) === raw.slice(43);\n}\n\n/**\n * Read a 44-digit fiscal access key into its fields.\n *\n * The layout is fixed and shared by every document type that carries a key —\n * NF-e, NFC-e, CT-e, MDF-e — so `modelo` is what tells you which one you are\n * holding, not the length.\n *\n * ```text\n * 35 2601 12345678000195 55 001 000000123 1 12345678 4\n * cUF AAMM CNPJ           mod série nNF    tp cNF     cDV\n * ```\n *\n * @param chave - The key, with or without the spaces a DANFE prints.\n * @returns The parsed key.\n * @throws {ChaveNFeError} On a length other than 44, an unknown `cUF`, a month\n * outside 1-12, or a check digit that does not recompute.\n *\n * @example\n * const { uf, cnpj, numero, modeloLabel } = parseChaveNFe(scanned);\n */\nexport function parseChaveNFe(chave: string): ChaveNFe {\n    const raw = digits(chave);\n    if (raw.length !== CHAVE_LENGTH) {\n        throw new ChaveNFeError(`An access key has ${CHAVE_LENGTH} digits, got ${raw.length}.`);\n    }\n\n    const cUF = raw.slice(0, 2);\n    const uf = UF_BY_CODE[cUF];\n    if (uf === undefined) {\n        throw new ChaveNFeError(`${cUF} is not an IBGE code for a federative unit.`);\n    }\n\n    const anoMes = raw.slice(2, 6);\n    const mes = Number(anoMes.slice(2, 4));\n    if (mes < 1 || mes > 12) {\n        throw new ChaveNFeError(`Month ${anoMes.slice(2, 4)} in AAMM is not a month.`);\n    }\n\n    const dv = raw.slice(43);\n    const expected = chaveNFeCheckDigit(raw.slice(0, CHAVE_BODY_LENGTH));\n    if (String(expected) !== dv) {\n        throw new ChaveNFeError(`Check digit is ${dv}, recomputed ${expected}.`);\n    }\n\n    const modelo = raw.slice(20, 22);\n    const tipoEmissao = raw.slice(34, 35);\n    return {\n        uf,\n        cUF,\n        anoMes,\n        ano: CHAVE_YEAR_BASE + Number(anoMes.slice(0, 2)),\n        mes,\n        cnpj: raw.slice(6, 20),\n        modelo,\n        modeloLabel: MODELO_LABELS[modelo] ?? null,\n        serie: raw.slice(22, 25),\n        numero: raw.slice(25, 34),\n        tipoEmissao,\n        tipoEmissaoLabel: TIPO_EMISSAO_LABELS[tipoEmissao] ?? null,\n        codigoNumerico: raw.slice(35, 43),\n        dv,\n    };\n}\n\n/**\n * Group a key in blocks of four, the way a DANFE prints it.\n *\n * @param chave - The key, masked or not.\n * @returns Eleven groups of four digits separated by spaces, or the input\n * unchanged when it is not 44 digits — this is a display helper, not a validator.\n *\n * @example\n * formatChaveNFe(\"35260112345678000195550010000001231123456784\");\n * // \"3526 0112 3456 7800 0195 5500 1000 0001 2311 2345 6784\"\n */\nexport function formatChaveNFe(chave: string): string {\n    const raw = digits(chave);\n    if (raw.length !== CHAVE_LENGTH) return chave;\n    return raw.replace(/(\\d{4})(?=\\d)/g, \"$1 \");\n}\n"],"mappings":";AAQA,IAAa,IAAb,cAAmC,MAAM;CACrC,YAAY,GAAiB;EAEzB,AADA,MAAM,CAAO,GACb,KAAK,OAAO;CAChB;AACJ,GA0CM,IAAiC;CACnC,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;AACV,GAGM,IAAwC;CAC1C,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;CACN,IAAM;AACV,GAGM,IAA8C;CAChD,GAAK;CACL,GAAK;CACL,GAAK;CACL,GAAK;CACL,GAAK;CACL,GAAK;CACL,GAAK;CACL,GAAK;AACT,GAGM,IAAkB,GAIlB,IAAe,IACf,IAAoB,IAGpB,IAAkB;AAGxB,SAAS,EAAO,GAAuB;CACnC,OAAO,EAAM,QAAQ,OAAO,EAAE;AAClC;AAiBA,SAAgB,EAAmB,GAAsB;CACrD,IAAI,CAAK,OAAO,QAAQ,EAAkB,GAAG,CAAC,CAAC,KAAK,CAAI,GACpD,MAAM,IAAI,EACN,oCAAoC,EAAkB,eAAe,EAAK,OAAO,EACrF;CAEJ,IACI,IAAM;CACV,KAAK,IAAI,IAAQ,GAAG,IAAQ,EAAK,QAAQ,KAAS,GAAG;EACjD,IAAM,IAAY,EAAK,SAAS,IAAI;EACpC,KAAO,OAAO,EAAK,EAAM,KAAK,IAAmB,IAAY;CACjE;CACA,IAAM,IAAY,IAAM;CACxB,OAAO,MAAc,KAAK,MAAc,IAAI,IAAI,KAAK;AACzD;AAiBA,SAAgB,EAAiB,GAAwB;CACrD,IAAM,IAAM,EAAO,CAAK;CAGxB,OAFI,EAAI,WAAW,KACf,EAAW,EAAI,MAAM,GAAG,CAAC,OAAO,KAAA,IAAkB,KAC/C,OAAO,EAAmB,EAAI,MAAM,GAAG,CAAiB,CAAC,CAAC,MAAM,EAAI,MAAM,EAAE;AACvF;AAsBA,SAAgB,EAAc,GAAyB;CACnD,IAAM,IAAM,EAAO,CAAK;CACxB,IAAI,EAAI,WAAW,GACf,MAAM,IAAI,EAAc,qBAAqB,EAAa,eAAe,EAAI,OAAO,EAAE;CAG1F,IAAM,IAAM,EAAI,MAAM,GAAG,CAAC,GACpB,IAAK,EAAW;CACtB,IAAI,MAAO,KAAA,GACP,MAAM,IAAI,EAAc,GAAG,EAAI,4CAA4C;CAG/E,IAAM,IAAS,EAAI,MAAM,GAAG,CAAC,GACvB,IAAM,OAAO,EAAO,MAAM,GAAG,CAAC,CAAC;CACrC,IAAI,IAAM,KAAK,IAAM,IACjB,MAAM,IAAI,EAAc,SAAS,EAAO,MAAM,GAAG,CAAC,EAAE,yBAAyB;CAGjF,IAAM,IAAK,EAAI,MAAM,EAAE,GACjB,IAAW,EAAmB,EAAI,MAAM,GAAG,CAAiB,CAAC;CACnE,IAAI,OAAO,CAAQ,MAAM,GACrB,MAAM,IAAI,EAAc,kBAAkB,EAAG,eAAe,EAAS,EAAE;CAG3E,IAAM,IAAS,EAAI,MAAM,IAAI,EAAE,GACzB,IAAc,EAAI,MAAM,IAAI,EAAE;CACpC,OAAO;EACH;EACA;EACA;EACA,KAAK,IAAkB,OAAO,EAAO,MAAM,GAAG,CAAC,CAAC;EAChD;EACA,MAAM,EAAI,MAAM,GAAG,EAAE;EACrB;EACA,aAAa,EAAc,MAAW;EACtC,OAAO,EAAI,MAAM,IAAI,EAAE;EACvB,QAAQ,EAAI,MAAM,IAAI,EAAE;EACxB;EACA,kBAAkB,EAAoB,MAAgB;EACtD,gBAAgB,EAAI,MAAM,IAAI,EAAE;EAChC;CACJ;AACJ;AAaA,SAAgB,EAAe,GAAuB;CAClD,IAAM,IAAM,EAAO,CAAK;CAExB,OADI,EAAI,WAAW,IACZ,EAAI,QAAQ,kBAAkB,KAAK,IADF;AAE5C"}
+{"version":3,"file":"nfe.js","names":["ChaveNFeError","message","UF_BY_CODE","MODELO_LABELS","TIPO_EMISSAO_LABELS","DV_WEIGHT_FIRST","CHAVE_LENGTH","CHAVE_BODY_LENGTH","CHAVE_YEAR_BASE","digits","value","chaveNFeCheckDigit","body","sum","index","fromRight","remainder","validateChaveNFe","raw","chave","parseChaveNFe","cUF","uf","anoMes","mes","dv","expected","modelo","tipoEmissao","formatChaveNFe"],"sources":["../../src/br/nfe.ts"],"sourcesContent":["import type { UF } from \"./locations\";\n\n/**\n * A 44-digit fiscal access key could not be read.\n *\n * Its own class so a scanner screen can tell a bad key apart from a bug and show\n * the message to the operator unchanged.\n */\nexport class ChaveNFeError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ChaveNFeError\";\n    }\n}\n\n/** A fiscal access key taken apart. */\nexport interface ChaveNFe {\n    /** Federative unit of the issuer, resolved from {@link cUF}. */\n    uf: UF;\n    /** The raw 2-digit IBGE code, positions 1-2. */\n    cUF: string;\n    /** Positions 3-6, `AAMM` — the two-digit year and the month of issue. */\n    anoMes: string;\n    /** Four-digit year derived from {@link anoMes}. */\n    ano: number;\n    /** Month of issue, 1-12. */\n    mes: number;\n    /** Positions 7-20, the issuer's CNPJ. */\n    cnpj: string;\n    /** Positions 21-22, `mod`. `\"55\"` is an NF-e, `\"65\"` an NFC-e. */\n    modelo: string;\n    /** Human label for {@link modelo}, or `null` for a model outside the table. */\n    modeloLabel: string | null;\n    /** Positions 23-25. */\n    serie: string;\n    /** Positions 26-34, `nNF`. */\n    numero: string;\n    /** Position 35, `tpEmis`. */\n    tipoEmissao: string;\n    /** Human label for {@link tipoEmissao}, or `null` for a value outside the table. */\n    tipoEmissaoLabel: string | null;\n    /** Positions 36-43, `cNF` — the issuer's random code. */\n    codigoNumerico: string;\n    /** Position 44, `cDV`. */\n    dv: string;\n}\n\n/**\n * IBGE code of each federative unit, as `cUF` carries it.\n *\n * Only the numeric codes live here — the acronyms are the `UF` union from\n * `./locations`, so a state added or renamed there flows through. Ported from the\n * IBGE table of \"códigos dos municípios\" (the two leading digits of every\n * municipality code), which is the same table the NF-e manual points at.\n */\nconst UF_BY_CODE: Record<string, UF> = {\n    \"11\": \"RO\",\n    \"12\": \"AC\",\n    \"13\": \"AM\",\n    \"14\": \"RR\",\n    \"15\": \"PA\",\n    \"16\": \"AP\",\n    \"17\": \"TO\",\n    \"21\": \"MA\",\n    \"22\": \"PI\",\n    \"23\": \"CE\",\n    \"24\": \"RN\",\n    \"25\": \"PB\",\n    \"26\": \"PE\",\n    \"27\": \"AL\",\n    \"28\": \"SE\",\n    \"29\": \"BA\",\n    \"31\": \"MG\",\n    \"32\": \"ES\",\n    \"33\": \"RJ\",\n    \"35\": \"SP\",\n    \"41\": \"PR\",\n    \"42\": \"SC\",\n    \"43\": \"RS\",\n    \"50\": \"MS\",\n    \"51\": \"MT\",\n    \"52\": \"GO\",\n    \"53\": \"DF\",\n};\n\n/** The document models that share the 44-digit key layout. */\nconst MODELO_LABELS: Record<string, string> = {\n    \"55\": \"NF-e\",\n    \"57\": \"CT-e\",\n    \"58\": \"MDF-e\",\n    \"59\": \"SAT-CF-e\",\n    \"63\": \"BP-e\",\n    \"65\": \"NFC-e\",\n    \"66\": \"NF3e\",\n    \"67\": \"CT-e OS\",\n};\n\n/** `tpEmis` values from the NF-e manual. */\nconst TIPO_EMISSAO_LABELS: Record<string, string> = {\n    \"1\": \"Normal\",\n    \"2\": \"Contingência FS-IA\",\n    \"3\": \"Contingência SCAN\",\n    \"4\": \"Contingência DPEC/EPEC\",\n    \"5\": \"Contingência FS-DA\",\n    \"6\": \"Contingência SVC-AN\",\n    \"7\": \"Contingência SVC-RS\",\n    \"9\": \"Contingência off-line (NFC-e)\",\n};\n\n/** Weight cycle of the módulo 11 check digit, applied right to left. */\nconst DV_WEIGHT_FIRST = 2;\nconst DV_WEIGHT_LAST = 9;\n\n/** Length of the key, and of the body the check digit protects. */\nconst CHAVE_LENGTH = 44;\nconst CHAVE_BODY_LENGTH = 43;\n\n/** Century the two-digit `AAMM` year resolves into. NF-e went live in 2006. */\nconst CHAVE_YEAR_BASE = 2000;\n\n/** Digits of a key that may carry spaces or dots from a copy-paste. */\nfunction digits(value: string): string {\n    return value.replace(/\\D/g, \"\");\n}\n\n/**\n * The check digit a 43-digit key body requires.\n *\n * Módulo 11: each digit is multiplied by weights cycling `2…9` from right to\n * left, the products are summed, and the digit is `11 - (sum mod 11)` — except\n * that a remainder of `0` or `1` yields `0`, since `11` and `10` do not fit one\n * position.\n *\n * Note this is the **fiscal** flavour of módulo 11. The cobrança boleto resolves\n * those same remainders to `1`; see `mod11DacCobranca` in `./boleto`.\n *\n * @param body - The first 43 digits of the key.\n * @returns The check digit, 0-9.\n * @throws {ChaveNFeError} When `body` is not exactly 43 digits.\n */\nexport function chaveNFeCheckDigit(body: string): number {\n    if (!new RegExp(`^\\\\d{${CHAVE_BODY_LENGTH}}$`).test(body)) {\n        throw new ChaveNFeError(\n            `The check digit is computed over ${CHAVE_BODY_LENGTH} digits, got ${body.length}.`,\n        );\n    }\n    const span = DV_WEIGHT_LAST - DV_WEIGHT_FIRST + 1;\n    let sum = 0;\n    for (let index = 0; index < body.length; index += 1) {\n        const fromRight = body.length - 1 - index;\n        sum += Number(body[index]) * (DV_WEIGHT_FIRST + (fromRight % span));\n    }\n    const remainder = sum % 11;\n    return remainder === 0 || remainder === 1 ? 0 : 11 - remainder;\n}\n\n/**\n * Whether a fiscal access key is well formed.\n *\n * Three things have to hold: 44 digits, a `cUF` that is a real federative unit,\n * and a check digit that recomputes. It says nothing about whether the document\n * exists or was authorised — only SEFAZ can answer that — but it catches the\n * failure that actually happens, a key transcribed by hand or truncated by a\n * spreadsheet.\n *\n * @param chave - The key, with or without the spaces a DANFE prints.\n * @returns `true` when all three hold.\n *\n * @example\n * if (!validateChaveNFe(input)) setError(\"Chave inválida.\");\n */\nexport function validateChaveNFe(chave: string): boolean {\n    const raw = digits(chave);\n    if (raw.length !== CHAVE_LENGTH) return false;\n    if (UF_BY_CODE[raw.slice(0, 2)] === undefined) return false;\n    return String(chaveNFeCheckDigit(raw.slice(0, CHAVE_BODY_LENGTH))) === raw.slice(43);\n}\n\n/**\n * Read a 44-digit fiscal access key into its fields.\n *\n * The layout is fixed and shared by every document type that carries a key —\n * NF-e, NFC-e, CT-e, MDF-e — so `modelo` is what tells you which one you are\n * holding, not the length.\n *\n * ```text\n * 35 2601 12345678000195 55 001 000000123 1 12345678 4\n * cUF AAMM CNPJ           mod série nNF    tp cNF     cDV\n * ```\n *\n * @param chave - The key, with or without the spaces a DANFE prints.\n * @returns The parsed key.\n * @throws {ChaveNFeError} On a length other than 44, an unknown `cUF`, a month\n * outside 1-12, or a check digit that does not recompute.\n *\n * @example\n * const { uf, cnpj, numero, modeloLabel } = parseChaveNFe(scanned);\n */\nexport function parseChaveNFe(chave: string): ChaveNFe {\n    const raw = digits(chave);\n    if (raw.length !== CHAVE_LENGTH) {\n        throw new ChaveNFeError(`An access key has ${CHAVE_LENGTH} digits, got ${raw.length}.`);\n    }\n\n    const cUF = raw.slice(0, 2);\n    const uf = UF_BY_CODE[cUF];\n    if (uf === undefined) {\n        throw new ChaveNFeError(`${cUF} is not an IBGE code for a federative unit.`);\n    }\n\n    const anoMes = raw.slice(2, 6);\n    const mes = Number(anoMes.slice(2, 4));\n    if (mes < 1 || mes > 12) {\n        throw new ChaveNFeError(`Month ${anoMes.slice(2, 4)} in AAMM is not a month.`);\n    }\n\n    const dv = raw.slice(43);\n    const expected = chaveNFeCheckDigit(raw.slice(0, CHAVE_BODY_LENGTH));\n    if (String(expected) !== dv) {\n        throw new ChaveNFeError(`Check digit is ${dv}, recomputed ${expected}.`);\n    }\n\n    const modelo = raw.slice(20, 22);\n    const tipoEmissao = raw.slice(34, 35);\n    return {\n        uf,\n        cUF,\n        anoMes,\n        ano: CHAVE_YEAR_BASE + Number(anoMes.slice(0, 2)),\n        mes,\n        cnpj: raw.slice(6, 20),\n        modelo,\n        modeloLabel: MODELO_LABELS[modelo] ?? null,\n        serie: raw.slice(22, 25),\n        numero: raw.slice(25, 34),\n        tipoEmissao,\n        tipoEmissaoLabel: TIPO_EMISSAO_LABELS[tipoEmissao] ?? null,\n        codigoNumerico: raw.slice(35, 43),\n        dv,\n    };\n}\n\n/**\n * Group a key in blocks of four, the way a DANFE prints it.\n *\n * @param chave - The key, masked or not.\n * @returns Eleven groups of four digits separated by spaces, or the input\n * unchanged when it is not 44 digits — this is a display helper, not a validator.\n *\n * @example\n * formatChaveNFe(\"35260112345678000195550010000001231123456784\");\n * // \"3526 0112 3456 7800 0195 5500 1000 0001 2311 2345 6784\"\n */\nexport function formatChaveNFe(chave: string): string {\n    const raw = digits(chave);\n    if (raw.length !== CHAVE_LENGTH) return chave;\n    return raw.replace(/(\\d{4})(?=\\d)/g, \"$1 \");\n}\n"],"mappings":"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"}

package/dist/br/pix.cjs

@@ -1,2 +1,2 @@
-const e=require("../forms/br-validators.cjs");var t=class extends Error{constructor(e){super(e),this.name=`PixError`}},n=4129,r=65535,i=65535,a=`00`,o=`01`,s=`26`,c=`52`,l=`53`,u=`54`,d=`58`,f=`59`,p=`60`,m=`61`,h=`62`,g=`63`,_=`00`,v=`01`,y=`02`,b=`25`,x=`05`,S=`br.gov.bcb.pix`,C=`01`,w=`11`,T=`12`,E=`0000`,D=`986`,O=`BR`,k=`***`,A=25,j=15,M=25,N=99,P=77,F=/^\d+(?:\.\d{0,2})?$/,I=13;function L(e){let t=new TextEncoder().encode(e),a=r;for(let e of t){a^=e<<8;for(let e=0;e<8;e+=1)a=a&32768?(a<<1^n)&i:a<<1&i}return a.toString(16).toUpperCase().padStart(4,`0`)}function R(e){return e.replace(/\D/g,``)}function z(e,n){let r=e.normalize(`NFD`).replace(/\p{Diacritic}/gu,``);if(/[^\x20-\x7E]/.test(r))throw new t(`${n} has characters the BR Code cannot carry: ${JSON.stringify(e)}. Use unaccented ASCII.`);return r}var B=/^[\x20-\x7E]*$/;function V(e,n){if(!B.test(n))throw new t(`Tag ${e} has characters outside the EMV common character set (printable ASCII): ${JSON.stringify(n)}.`);if(n.length>N)throw new t(`Tag ${e} is ${n.length} characters; the EMV length field holds at most ${N}.`);return`${e}${String(n.length).padStart(2,`0`)}${n}`}function H(t){let n=t.trim();if(n===``)return null;if(n.includes(`@`))return/^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/.test(n)&&n.length<=P?`email`:null;if(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(n))return`evp`;let r=R(n);return r.length===14?e.validateCNPJ(r)?`cnpj`:null:r.length===11&&e.validateCPF(r)?`cpf`:n.startsWith(`+`)?/^\+55\d{10,11}$/.test(`+${r}`)?`phone`:null:r.length===10||r.length===11||(r.length===12||r.length===13)&&r.startsWith(`55`)?`phone`:null}function U(e){let n=e.trim(),r=H(n);if(r===null)throw new t(`Not a Pix key: ${JSON.stringify(e)}. Expected a CPF, CNPJ, e-mail, phone (+5511987654321) or EVP (UUID).`);if(r===`email`||r===`evp`)return{type:r,value:n.toLowerCase()};if(r===`phone`){let e=R(n);return{type:r,value:`+55${e.length>11?e.slice(2):e}`}}return{type:r,value:R(n)}}function W(e){if(!Number.isFinite(e))throw new t(`Amount must be a finite number, got ${e}.`);if(e<=0)throw new t(`Amount must be positive, got ${e}. Omit \`amount\` for a QR whose value the payer types.`);let n=e.toFixed(2);if(Number(n)<=0)throw new t(`Amount ${e} rounds to ${n} at two decimals. Omit \`amount\` for a QR whose value the payer types.`);if(n.length>13)throw new t(`Amount ${n} does not fit tag 54, which holds 13 characters.`);return n}function G(e,n,r){let i=z(e.trim(),r);if(i===``)throw new t(`${r} is required.`);if(i.length>n)throw new t(`${r} is ${i.length} characters; the BR Code allows ${n}. Shorten it — truncating here would silently change what the payer sees.`);return i}function K(e){let n=e?.trim()??``;if(n===``||n===k)return V(h,V(x,k));if(!RegExp(`^[A-Za-z0-9]{1,${M}}$`).test(n))throw new t(`txid must be 1 to ${M} letters or digits, got ${JSON.stringify(e)}.`);return V(h,V(x,n))}function q(e){let{value:n}=U(e.key),r=V(_,S)+V(v,n),i=e.description?.trim();if(i!==void 0&&i!==``&&(r+=V(y,z(i,`description`))),r.length>N)throw new t(`Tag 26 is ${r.length} characters, over the ${N} the length field allows. Shorten \`description\`.`);return V(s,r)}function J(e){let n=z(e.url.trim(),`url`).replace(/^https?:\/\//i,``);if(n===``)throw new t(`url is required for a dynamic BR Code.`);let r=V(_,S)+V(b,n);if(r.length>N)throw new t(`Tag 26 is ${r.length} characters, over the ${N} the length field allows. Shorten the payload URL.`);return V(s,r)}function Y(e){let t=e.kind===`dynamic`,n=e.oneTime??t,r=V(a,C);r+=V(o,n?T:w),r+=t?J(e):q(e),r+=V(c,E),r+=V(l,D),!t&&e.amount!==void 0&&(r+=V(u,W(e.amount))),r+=V(d,O),r+=V(f,G(e.merchantName,A,`merchantName`)),r+=V(p,G(e.merchantCity,j,`merchantCity`));let i=e.postalCode===void 0?``:R(e.postalCode);i!==``&&(r+=V(m,i)),r+=K(t?k:e.txid);let s=`${r}${g}04`;return`${s}${L(s)}`}function X(e,n){let r=Array.from(e),i=[],a=0;for(;a<r.length;){let e=r.slice(a,a+2).join(``),o=r.slice(a+2,a+4).join(``);if(!/^\d{2}$/.test(e)||!/^\d{2}$/.test(o))throw new t(`Malformed TLV in ${n} at offset ${a}: expected a 2-digit tag and length.`);let s=Number(o),c=a+4;if(c+s>r.length)throw new t(`Tag ${e} in ${n} declares ${s} characters but only ${r.length-c} remain.`);if(i.some(t=>t.id===e))throw new t(`Tag ${e} in ${n} appears more than once; a BR Code carries each tag once per level.`);i.push({id:e,value:r.slice(c,c+s).join(``)}),a=c+s}return i}function Z(e,t){return e.find(e=>e.id===t)?.value}function Q(e){if(e.length>I||!F.test(e))throw new t(`Tag 54 (amount) must be an amount like "25.50", with "." as the decimal mark, at most two decimals and ${I} characters; got ${JSON.stringify(e)}.`);return Number(e)}function $(e,n={}){let{requireCrc:r=!0}=n,i=e.trim();if(i.length<8)throw new t(`Payload is too short to be a BR Code.`);let C=i.length-8;if(i.slice(C,C+4)!==`${g}04`)throw new t("Payload does not end in a `6304` CRC tag.");let w=i.slice(-4).toUpperCase(),E=L(i.slice(0,-4)),D=w===E;if(!D&&r)throw new t(`CRC mismatch: payload says ${w}, recomputed ${E}.`);let O=X(i.slice(0,C),`payload`);if(O[0]?.id!==a)throw new t(`Tag 00 (payload format indicator) must be the first tag of a BR Code.`);if(O.some(e=>e.id===g))throw new t(`Tag 63 (CRC) must be the last tag of a BR Code; this payload carries another one before the end.`);let k=Z(O,s);if(k===void 0)throw new t(`Payload has no tag 26 (merchant account information).`);let A=X(k,`tag 26`),j=Z(A,_);if(j?.toLowerCase()!==S)throw new t(`Tag 26 is not a Pix account: expected GUI ${S}, got ${JSON.stringify(j)}.`);let M=Z(A,b),N=Z(A,v);if(M!==void 0&&N!==void 0)throw new t(`Tag 26 carries both a key (01) and a URL (25); a BR Code is either static or dynamic, not both.`);let P=Z(O,u),F=Z(X(Z(O,h)??``,`tag 62`),x);return{kind:M===void 0?`static`:`dynamic`,...N===void 0?{}:{key:N,keyType:H(N)??void 0},...M===void 0?{}:{url:M},merchantName:Z(O,f)??``,merchantCity:Z(O,p)??``,...P===void 0?{}:{amount:Q(P)},currency:Z(O,l)??``,countryCode:Z(O,d)??``,merchantCategoryCode:Z(O,c)??``,...F===void 0?{}:{txid:F},...Z(A,y)===void 0?{}:{description:Z(A,y)},...Z(O,m)===void 0?{}:{postalCode:Z(O,m)},oneTime:Z(O,o)===T,crc:w,crcValid:D,fields:O}}exports.PixError=t,exports.normalizePixKey=U,exports.parsePixPayload=$,exports.pixCrc16=L,exports.pixKeyType=H,exports.pixPayload=Y;
+const e=require("../forms/br-validators.cjs");var t=class extends Error{constructor(e){super(e),this.name=`PixError`}},n=4129,r=65535,i=65535,a=`00`,o=`01`,s=`26`,c=`52`,l=`53`,u=`54`,d=`58`,f=`59`,p=`60`,m=`61`,h=`62`,g=`63`,_=`64`,v=80,y=`00`,b=`01`,x=`02`,S=`25`,C=`05`,w=`br.gov.bcb.pix`,T=`01`,E=`11`,D=`12`,O=`0000`,k=`986`,A=`BR`,j=`***`,M=25,N=15,P=25,F=99,I=77,L=/^\d+(?:\.\d{0,2})?$/,R=13;function z(e){let t=new TextEncoder().encode(e),a=r;for(let e of t){a^=e<<8;for(let e=0;e<8;e+=1)a=a&32768?(a<<1^n)&i:a<<1&i}return a.toString(16).toUpperCase().padStart(4,`0`)}function B(e){return e.replace(/\D/g,``)}function V(e,n){let r=e.normalize(`NFD`).replace(/\p{Diacritic}/gu,``);if(/[^\x20-\x7E]/.test(r))throw new t(`${n} has characters the BR Code cannot carry: ${JSON.stringify(e)}. Use unaccented ASCII.`);return r}var H=/^[\x20-\x7E]*$/;function U(e,n){if(!H.test(n))throw new t(`Tag ${e} has characters outside the EMV common character set (printable ASCII): ${JSON.stringify(n)}.`);if(n.length>F)throw new t(`Tag ${e} is ${n.length} characters; the EMV length field holds at most ${F}.`);return`${e}${String(n.length).padStart(2,`0`)}${n}`}function W(t){let n=t.trim();if(n===``)return null;if(n.includes(`@`))return/^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/.test(n)&&n.length<=I?`email`:null;if(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(n))return`evp`;let r=B(n);return r.length===14?e.validateCNPJ(r)?`cnpj`:null:r.length===11&&e.validateCPF(r)?`cpf`:n.startsWith(`+`)?/^\+55\d{10,11}$/.test(`+${r}`)?`phone`:null:r.length===10||r.length===11||(r.length===12||r.length===13)&&r.startsWith(`55`)?`phone`:null}function G(e){let n=e.trim(),r=W(n);if(r===null)throw new t(`Not a Pix key: ${JSON.stringify(e)}. Expected a CPF, CNPJ, e-mail, phone (+5511987654321) or EVP (UUID).`);if(r===`email`||r===`evp`)return{type:r,value:n.toLowerCase()};if(r===`phone`){let e=B(n);return{type:r,value:`+55${e.length>11?e.slice(2):e}`}}return{type:r,value:B(n)}}function K(e){if(!Number.isFinite(e))throw new t(`Amount must be a finite number, got ${e}.`);if(e<=0)throw new t(`Amount must be positive, got ${e}. Omit \`amount\` for a QR whose value the payer types.`);let n=e.toFixed(2);if(Number(n)<=0)throw new t(`Amount ${e} rounds to ${n} at two decimals. Omit \`amount\` for a QR whose value the payer types.`);if(n.length>13)throw new t(`Amount ${n} does not fit tag 54, which holds 13 characters.`);return n}function q(e,n,r){let i=V(e.trim(),r);if(i===``)throw new t(`${r} is required.`);if(i.length>n)throw new t(`${r} is ${i.length} characters; the BR Code allows ${n}. Shorten it — truncating here would silently change what the payer sees.`);return i}function ee(e){let n=e?.trim()??``;if(n===``||n===j)return U(h,U(C,j));if(!RegExp(`^[A-Za-z0-9]{1,${P}}$`).test(n))throw new t(`txid must be 1 to ${P} letters or digits, got ${JSON.stringify(e)}.`);return U(h,U(C,n))}function J(e){let{value:n}=G(e.key),r=U(y,w)+U(b,n),i=e.description?.trim();if(i!==void 0&&i!==``&&(r+=U(x,V(i,`description`))),r.length>F)throw new t(`Tag 26 is ${r.length} characters, over the ${F} the length field allows. Shorten \`description\`.`);return U(s,r)}function Y(e){let n=V(e.url.trim(),`url`).replace(/^https?:\/\//i,``);if(n===``)throw new t(`url is required for a dynamic BR Code.`);let r=U(y,w)+U(S,n);if(r.length>F)throw new t(`Tag 26 is ${r.length} characters, over the ${F} the length field allows. Shorten the payload URL.`);return U(s,r)}function X(e){let t=e.kind===`dynamic`,n=e.oneTime??t,r=U(a,T);r+=U(o,n?D:E),r+=t?Y(e):J(e),r+=U(c,O),r+=U(l,k),!t&&e.amount!==void 0&&(r+=U(u,K(e.amount))),r+=U(d,A),r+=U(f,q(e.merchantName,M,`merchantName`)),r+=U(p,q(e.merchantCity,N,`merchantCity`));let i=e.postalCode===void 0?``:B(e.postalCode);i!==``&&(r+=U(m,i)),r+=ee(t?j:e.txid);let s=`${r}${g}04`;return`${s}${z(s)}`}function Z(e,n){let r=Array.from(e),i=[],a=0;for(;a<r.length;){let e=r.slice(a,a+2).join(``),o=r.slice(a+2,a+4).join(``);if(!/^\d{2}$/.test(e)||!/^\d{2}$/.test(o))throw new t(`Malformed TLV in ${n} at offset ${a}: expected a 2-digit tag and length.`);let s=Number(o),c=a+4;if(c+s>r.length)throw new t(`Tag ${e} in ${n} declares ${s} characters but only ${r.length-c} remain.`);if(i.some(t=>t.id===e))throw new t(`Tag ${e} in ${n} appears more than once; a BR Code carries each tag once per level.`);i.push({id:e,value:r.slice(c,c+s).join(``)}),a=c+s}return i}function Q(e){return e===_||Number(e)>=v}var te=[{name:`UTF-8 bytes`,width:e=>e<128?1:e<2048?2:e<65536?3:4},{name:`UTF-16 units`,width:e=>e>65535?2:1}];function ne(e,t){let n=[],r=0;for(;r<e.length;){let i=e.slice(r,r+2).join(``),a=e.slice(r+2,r+4).join(``);if(!/^\d{2}$/.test(i)||!/^\d{2}$/.test(a))return null;let o=Number(a),s=r+4;for(;o>0&&s<e.length;)o-=t(e[s]?.codePointAt(0)??0),s+=1;if(o!==0)return null;n.push({id:i,value:e.slice(r+4,s).join(``)}),r=s}return n}function re(e,n){for(let e of n)if(!Q(e.id)&&!H.test(e.value))throw new t(`Tag ${e.id} has characters outside the EMV common character set (printable ASCII): ${JSON.stringify(e.value)}. Only tag 64 and the unreserved templates 80–99 may carry other text.`);if(H.test(e))return;let r=Array.from(e);for(let e of te){let i=ne(r,e.width);if(i!==null&&JSON.stringify(i)!==JSON.stringify(n))throw new t(`Payload reads as other tags when its TLV lengths count ${e.name}: ${i.map(e=>e.id).join()}.`)}}function $(e,t){return e.find(e=>e.id===t)?.value}function ie(e){if(e.length>R||!L.test(e))throw new t(`Tag 54 (amount) must be an amount like "25.50", with "." as the decimal mark, at most two decimals and ${R} characters; got ${JSON.stringify(e)}.`);return Number(e)}function ae(e,n={}){let{requireCrc:r=!0}=n,i=e.trim();if(i.length<8)throw new t(`Payload is too short to be a BR Code.`);let _=i.length-8;if(i.slice(_,_+4)!==`${g}04`)throw new t("Payload does not end in a `6304` CRC tag.");let v=i.slice(-4).toUpperCase(),T=z(i.slice(0,-4)),E=v===T;if(!E&&r)throw new t(`CRC mismatch: payload says ${v}, recomputed ${T}.`);let O=i.slice(0,_),k=Z(O,`payload`);if(re(O,k),k[0]?.id!==a)throw new t(`Tag 00 (payload format indicator) must be the first tag of a BR Code.`);if(k.some(e=>e.id===g))throw new t(`Tag 63 (CRC) must be the last tag of a BR Code; this payload carries another one before the end.`);let A=$(k,s);if(A===void 0)throw new t(`Payload has no tag 26 (merchant account information).`);let j=Z(A,`tag 26`),M=$(j,y);if(M?.toLowerCase()!==w)throw new t(`Tag 26 is not a Pix account: expected GUI ${w}, got ${JSON.stringify(M)}.`);let N=$(j,S),P=$(j,b);if(N!==void 0&&P!==void 0)throw new t(`Tag 26 carries both a key (01) and a URL (25); a BR Code is either static or dynamic, not both.`);let F=$(k,u),I=$(Z($(k,h)??``,`tag 62`),C);return{kind:N===void 0?`static`:`dynamic`,...P===void 0?{}:{key:P,keyType:W(P)??void 0},...N===void 0?{}:{url:N},merchantName:$(k,f)??``,merchantCity:$(k,p)??``,...F===void 0?{}:{amount:ie(F)},currency:$(k,l)??``,countryCode:$(k,d)??``,merchantCategoryCode:$(k,c)??``,...I===void 0?{}:{txid:I},...$(j,x)===void 0?{}:{description:$(j,x)},...$(k,m)===void 0?{}:{postalCode:$(k,m)},oneTime:$(k,o)===D,crc:v,crcValid:E,fields:k}}exports.PixError=t,exports.normalizePixKey=G,exports.parsePixPayload=ae,exports.pixCrc16=z,exports.pixKeyType=W,exports.pixPayload=X;
 //# sourceMappingURL=pix.cjs.map