gedcom-ts 2026.5.3 → 2026.6.0

package/dist/booklet/booklet-logo.d.ts

@@ -1,9 +1,7 @@
-import { type PDFPage, type RGB } from 'pdf-lib';
-export { GEDCOM_TS_LOGO_PATHS, GEDCOM_TS_LOGO_VIEWBOX } from "./gedcom-ts-logo.paths";
+import { type RGB } from 'pdf-lib';
 /** Couleur de marque gedcom-ts (#19196f), pour pdf-lib `rgb(...)`. */
 export declare const BOOKLET_BRAND_RGB: RGB;
 export interface GedcomTsLogoLayout {
-    /** Ordonnée PDF du bas du logo (pour placer texte et barre en dessous). */
     readonly bottomY: number;
     readonly height: number;
 }
@@ -15,5 +13,3 @@ export interface DrawGedcomTsLogoOptions {
 }
 /** Options par défaut du logo sur une page A4 (couverture du livret). */
 export declare function defaultCoverLogoOptions(pageWidth?: number, pageHeight?: number): DrawGedcomTsLogoOptions;
-/** Dessine le logo gedcom-ts en vecteur SVG sur la page (pdf-lib drawSvgPath). */
-export declare function drawGedcomTsLogoOnPage(page: PDFPage, options?: DrawGedcomTsLogoOptions): GedcomTsLogoLayout;

package/dist/booklet/booklet-messages-data.d.ts

@@ -0,0 +1,15 @@
+import type { BookletMessages } from './booklet-messages-types';
+import type { BookletLocale } from './booklet-locale';
+export declare const MESSAGES_EN: BookletMessages;
+export declare const MESSAGES_FR: BookletMessages;
+export declare const MESSAGES_DE: BookletMessages;
+export declare const MESSAGES_NL: BookletMessages;
+export declare const MESSAGES_ES: BookletMessages;
+export declare const MESSAGES_ZH: BookletMessages;
+export declare const MESSAGES_IT: BookletMessages;
+export declare const MESSAGES_PT: BookletMessages;
+export declare const MESSAGES_PL: BookletMessages;
+export declare const MESSAGES_AR: BookletMessages;
+export declare const MESSAGES_HE: BookletMessages;
+export declare const BOOKLET_MESSAGES: Record<BookletLocale, BookletMessages>;
+export declare function messagesForLocale(locale: BookletLocale): BookletMessages;

package/dist/booklet/booklet-messages-types.d.ts

@@ -0,0 +1,46 @@
+import type { BookletLocale } from './booklet-locale';
+export interface BookletMessages {
+    readonly unknownDates: string;
+    readonly unknownDate: string;
+    readonly chapterUnknownDates: string;
+    readonly generation1Title: string;
+    readonly generationTitle: (gen: number) => string;
+    readonly letterTitle: (letter: string) => string;
+    readonly chapterSubtitle: (count: number, dateRange: string) => string;
+    readonly chapterDateAbout: string;
+    readonly childrenNone: string;
+    readonly childrenMore: (n: number) => string;
+    readonly pagesEstimate: (n: number) => string;
+    readonly pagesEmpty: string;
+    readonly adviceDetailed120: string;
+    readonly adviceDetailed50: string;
+    readonly adviceSummary25: string;
+    readonly actTypeLabels: Partial<Record<string, string>>;
+    readonly spouseUnknown: string;
+    readonly timelineTitle: (chapterTitle: string) => string;
+    readonly timelineUnknownDates: string;
+    readonly pdf: {
+        readonly coverSubtitle: string;
+        readonly referencePerson: (name: string) => string;
+        readonly personCount: (n: number) => string;
+        readonly localNote: string;
+        readonly tocTitle: string;
+        readonly modeSummary: string;
+        readonly modeDetailed: string;
+        readonly contentHeading: string;
+        readonly introSummary: string;
+        readonly introDetailed: string;
+        readonly introSosa: string;
+        readonly familyHeading: (names: string) => string;
+        readonly generationLabel: (gen: number) => string;
+        readonly pageFooter: (n: number) => string;
+    };
+    readonly timeline: {
+        readonly legendBirth: string;
+        readonly legendDeath: string;
+        readonly legendMarriage: string;
+        readonly overflow: (n: number) => string;
+        readonly continuation: string;
+    };
+}
+export type { BookletLocale };

package/dist/booklet/booklet-messages.d.ts

@@ -0,0 +1,7 @@
+import type { BookletLocale } from './booklet-locale';
+export type { BookletMessages } from './booklet-messages-types';
+export { ensureBookletLocale, clearBookletLocaleCache, isBookletLocaleLoaded } from './booklet-locale-loader';
+export declare function getBookletMessages(locale?: BookletLocale): import("./booklet-messages-types").BookletMessages;
+export declare function actTypeLabel(type: string, locale?: BookletLocale): string;
+/** Loads locale data then returns messages (convenience for async call sites). */
+export declare function loadBookletMessages(locale?: BookletLocale): Promise<import("./booklet-messages-types").BookletMessages>;

package/dist/booklet/booklet-narrative-en.d.ts

@@ -0,0 +1,10 @@
+import type { BookletPersonEntry } from './booklet-person';
+import type { BookletChapter, BookletDetailLevel, BookletFamilyUnit } from './booklet-structure';
+/** Chapter: narrative opening sentence. */
+export declare function buildChapterIntroNarrative(chapter: BookletChapter): string;
+/** Family sheet as narrative. */
+export declare function buildFamilyNarrative(family: BookletFamilyUnit, detailLevel: BookletDetailLevel): readonly string[];
+/** Condensed portrait: one flowing paragraph, name cited once. */
+export declare function buildPersonSummaryNarrative(entry: BookletPersonEntry): string;
+/** Detailed portrait: a few paragraphs, without redundant birth/death. */
+export declare function buildPersonDetailedNarratives(entry: BookletPersonEntry): readonly string[];

package/dist/booklet/booklet-narrative-engine.d.ts

@@ -0,0 +1,17 @@
+import type { BookletDateModule } from './booklet-date-factory';
+import type { BookletPlaceModule } from './booklet-place-factory';
+import type { BookletLocale } from './booklet-locale';
+import type { NarrativeStrings } from './booklet-narrative-i18n';
+import type { BookletPersonEntry } from './booklet-person';
+import type { BookletChapter, BookletDetailLevel, BookletFamilyUnit } from './booklet-structure';
+export interface NarrativeModule {
+    buildChapterIntroNarrative: (chapter: BookletChapter) => string;
+    buildFamilyNarrative: (family: BookletFamilyUnit, detailLevel: BookletDetailLevel) => readonly string[];
+    buildPersonSummaryNarrative: (entry: BookletPersonEntry) => string;
+    buildPersonDetailedNarratives: (entry: BookletPersonEntry) => readonly string[];
+}
+export declare function createNarrativeModule(locale: BookletLocale, strings: NarrativeStrings, deps: {
+    readonly dateModule: BookletDateModule;
+    readonly placeModule: BookletPlaceModule;
+    readonly unknownDates: string;
+}): NarrativeModule;

package/dist/booklet/booklet-narrative-fr.d.ts

@@ -0,0 +1,10 @@
+import type { BookletPersonEntry } from './booklet-person';
+import type { BookletChapter, BookletDetailLevel, BookletFamilyUnit } from './booklet-structure';
+/** Chapitre : phrase d'ouverture narrative. */
+export declare function buildChapterIntroNarrative(chapter: BookletChapter): string;
+/** Fiche famille en récit. */
+export declare function buildFamilyNarrative(family: BookletFamilyUnit, detailLevel: BookletDetailLevel): readonly string[];
+/** Portrait condensé : un paragraphe fluide, nom cité une fois. */
+export declare function buildPersonSummaryNarrative(entry: BookletPersonEntry): string;
+/** Portrait détaillé : peu de paragraphes, sans redondance naissance/décès. */
+export declare function buildPersonDetailedNarratives(entry: BookletPersonEntry): readonly string[];

package/dist/booklet/booklet-narrative-i18n.d.ts

@@ -0,0 +1,44 @@
+import type { BookletLocale } from './booklet-locale';
+import type { PersonGenderWords } from './booklet-gender';
+export type NarrativeI18nLocale = Exclude<BookletLocale, 'en' | 'fr'>;
+export interface NarrativeStrings {
+    readonly listConjunction: string;
+    readonly defaultAncestor: string;
+    readonly parentsSingle: (name: string, g: PersonGenderWords) => readonly string[];
+    readonly parentsMultiple: (names: string, g: PersonGenderWords) => readonly string[];
+    readonly unionWithMarriage: (spouse: string, marriageEmbed: string) => readonly string[];
+    readonly unionWithoutMarriage: (spouse: string, g: PersonGenderWords) => readonly string[];
+    readonly unionOneChild: (child: string, g: PersonGenderWords) => readonly string[];
+    readonly unionManyChildren: (children: string, g: PersonGenderWords) => readonly string[];
+    readonly lifeBornAndDied: (name: string, g: PersonGenderWords, born: string, birthPlace: string, died: string, deathPlace: string, lifeRange: string, rangeLoc: string, seesDay: string, afterBirthLoc: string) => readonly string[];
+    readonly lifeBirthOnly: (name: string, g: PersonGenderWords, born: string, where: string, seesDay: string) => readonly string[];
+    readonly lifeDeathOnly: (name: string, g: PersonGenderWords, died: string, where: string) => readonly string[];
+    readonly lifeApproxDates: (name: string, g: PersonGenderWords, datesLabel: string) => readonly string[];
+    readonly eventMarriage: (when: string, where: string) => readonly string[];
+    readonly eventDivorce: (when: string, where: string) => string;
+    readonly eventBaptism: (when: string, where: string, g: PersonGenderWords) => readonly string[];
+    readonly eventBurial: (when: string, where: string) => readonly string[];
+    readonly eventCremation: (when: string, where: string) => string;
+    readonly eventOccupation: (date: string, atPlace: string) => string;
+    readonly chapterGen1: (count: number, plural: string) => readonly string[];
+    readonly chapterGenN: (gen: number, count: number, plural: string, range: string) => readonly string[];
+    readonly chapterLetter: (title: string, count: number, plural: string, letter: string, range: string) => readonly string[];
+    readonly familyCouple: (short1: string, short2: string, full1: string, full2: string) => readonly string[];
+    readonly familyUnionWithMarriage: (marriageEmbed: string) => readonly string[];
+    readonly familyUnionWithoutMarriage: readonly string[];
+    readonly familyNoDescendants: string;
+    readonly familyOneChild: (name: string) => readonly string[];
+    readonly familyNChildren: (count: number, names: string) => string;
+    readonly familyDescendantsList: (names: string) => string;
+    readonly familyLoneFigure: (shortName: string, fullName: string) => readonly string[];
+    readonly familyMarriageNoted: (marriageEmbed: string) => readonly string[];
+    readonly familyDescendantsNoted: (names: string) => readonly string[];
+    readonly familyDescendantsRecensed: (recensed: string, names: string) => string;
+    readonly personBranchPresent: (name: string, g: PersonGenderWords) => readonly string[];
+    readonly personFewRecords: (name: string) => string;
+    readonly personResearchHint: string;
+    readonly personPortraitIncomplete: (name: string) => string;
+    readonly personUnionSection: (clauses: string) => readonly string[];
+    readonly personResearchNote: (preview: string) => readonly string[];
+}
+export declare const NARRATIVE_STRINGS: Record<NarrativeI18nLocale, NarrativeStrings>;

package/dist/booklet/booklet-narrative-locales.d.ts

@@ -0,0 +1,3 @@
+import type { BookletLocale } from './booklet-locale';
+import type { NarrativeModule } from './booklet-narrative-engine';
+export declare function getNarrativeModule(locale?: BookletLocale): NarrativeModule;

package/dist/booklet/booklet-narrative.d.ts

@@ -1,10 +1,7 @@
+import type { BookletLocale } from './booklet-locale';
 import type { BookletPersonEntry } from './booklet-person';
 import type { BookletChapter, BookletDetailLevel, BookletFamilyUnit } from './booklet-structure';
-/** Chapitre : phrase d'ouverture narrative. */
-export declare function buildChapterIntroNarrative(chapter: BookletChapter): string;
-/** Fiche famille en récit. */
-export declare function buildFamilyNarrative(family: BookletFamilyUnit, detailLevel: BookletDetailLevel): readonly string[];
-/** Portrait condensé : un paragraphe fluide, nom cité une fois. */
-export declare function buildPersonSummaryNarrative(entry: BookletPersonEntry): string;
-/** Portrait détaillé : peu de paragraphes, sans redondance naissance/décès. */
-export declare function buildPersonDetailedNarratives(entry: BookletPersonEntry): readonly string[];
+export declare function buildChapterIntroNarrative(chapter: BookletChapter, locale?: BookletLocale): string;
+export declare function buildFamilyNarrative(family: BookletFamilyUnit, detailLevel: BookletDetailLevel, locale?: BookletLocale): readonly string[];
+export declare function buildPersonSummaryNarrative(entry: BookletPersonEntry, locale?: BookletLocale): string;
+export declare function buildPersonDetailedNarratives(entry: BookletPersonEntry, locale?: BookletLocale): readonly string[];

package/dist/booklet/booklet-pdf-bidi.d.ts

@@ -0,0 +1,5 @@
+import type { BookletLocale } from './booklet-locale';
+/** Reorders mixed RTL/LTR text for pdf-lib (LTR drawText positions). */
+export declare function toPdfVisualLine(text: string, locale?: BookletLocale): string;
+/** Applies Arabic joining forms (Presentation Forms-B) before PDF drawText. */
+export declare function shapeScriptForPdf(text: string, locale?: BookletLocale): string;

package/dist/booklet/booklet-pdf-content-text.d.ts

@@ -0,0 +1,11 @@
+import type { BookletLocale } from './booklet-locale';
+import type { BookletPersonEntry } from './booklet-person';
+import type { BookletChapter, BookletDetailLevel } from './booklet-structure';
+export interface BookletPdfContentMeta {
+    readonly title: string;
+    readonly scopeLabel: string;
+    readonly referenceName?: string;
+    readonly personCount: number;
+}
+/** All strings embedded in a booklet PDF (for runtime font subsetting). */
+export declare function collectBookletPdfContentText(entries: readonly BookletPersonEntry[], meta: BookletPdfContentMeta, chapters: readonly BookletChapter[], detailLevel: BookletDetailLevel, locale?: BookletLocale): string;

package/dist/booklet/booklet-pdf-font-runtime.d.ts

@@ -0,0 +1,8 @@
+import type { BookletLocale } from './booklet-locale';
+/** CJK / fullwidth codepoints routed to the Unicode PDF font. */
+export declare function isUnicodePdfScriptChar(ch: string): boolean;
+export declare function missingUnicodeFontChars(contentText: string, locale: BookletLocale, extraCovered?: string): string;
+export declare function fetchFullBookletFont(locale: BookletLocale): Promise<Uint8Array>;
+/** Larger zh subset (UI + common Han); lazy-loaded when the static chunk misses GEDCOM glyphs. */
+export declare function loadZhExtendedPdfFontBytes(): Promise<Uint8Array>;
+export declare function clearBookletFullFontCache(): void;

package/dist/booklet/booklet-pdf-font-runtime.node.d.ts

@@ -0,0 +1,3 @@
+import type { BookletLocale } from './booklet-locale';
+/** Node / tests: exact Noto subset for arbitrary PDF content (GEDCOM names, etc.). */
+export declare function subsetBookletPdfFontForContent(locale: BookletLocale, contentText: string): Promise<Uint8Array>;

package/dist/booklet/booklet-pdf-font-sources.d.ts

@@ -0,0 +1,6 @@
+/** Full Noto sources for runtime PDF font subsetting (same URLs as scripts/prepare-booklet-fonts.mjs). */
+export declare const BOOKLET_FULL_FONT_URLS: {
+    readonly zh: "https://cdn.jsdelivr.net/gh/notofonts/noto-cjk@main/Sans/SubsetOTF/SC/NotoSansSC-Regular.otf";
+    readonly ar: "https://cdn.jsdelivr.net/gh/notofonts/noto-fonts@main/hinted/ttf/NotoSansArabic/NotoSansArabic-Regular.ttf";
+    readonly he: "https://cdn.jsdelivr.net/gh/notofonts/noto-fonts@main/hinted/ttf/NotoSansHebrew/NotoSansHebrew-Regular.ttf";
+};

package/dist/booklet/booklet-pdf-font.d.ts

@@ -0,0 +1,14 @@
+import type { BookletLocale } from './booklet-locale';
+/** Locales whose PDF body text needs a Unicode-capable font (StandardFonts are Latin-1 only). */
+export declare function localeNeedsUnicodePdfFont(locale?: BookletLocale): boolean;
+/** Registers preloaded font bytes (host app explicit chunk import). */
+export declare function registerBookletPdfFontBytes(locale: BookletLocale, bytes: Uint8Array): void;
+/** Clears cached font bytes (tests / forced reload). */
+export declare function clearBookletPdfFontCache(): void;
+/**
+ * Lazy-loads subset Noto font bytes for zh / ar / he (separate chunks, not in the main bundle).
+ * Pass `override` to replace the built-in font.
+ */
+export declare function loadBookletPdfFontBytes(locale?: BookletLocale, override?: Uint8Array, contentText?: string): Promise<Uint8Array | undefined>;
+/** Returns cached bundled font bytes when already loaded. */
+export declare function bundledBookletPdfFontBytes(locale?: BookletLocale): Uint8Array | undefined;

package/dist/booklet/booklet-pdf-fontkit.d.ts

@@ -0,0 +1,6 @@
+/** Injects fontkit from the host app (required when @pdf-lib/fontkit is an external). */
+export declare function registerPdfFontkit(fontkit: unknown): void;
+/** Loads @pdf-lib/fontkit only when embedding TTF/OTF (zh / ar / he). */
+export declare function loadPdfFontkit(): Promise<unknown>;
+/** Clears cached fontkit module (tests). */
+export declare function clearPdfFontkitCache(): void;

package/dist/booklet/booklet-pdf-text.d.ts

@@ -0,0 +1,24 @@
+import type { PDFFont, PDFPage } from 'pdf-lib';
+import { rgb } from 'pdf-lib';
+import type { BookletLocale } from './booklet-locale';
+import { type PdfTextOptions } from './booklet-pdf';
+export interface PdfFontPair {
+    readonly latin: PDFFont;
+    readonly latinBold: PDFFont;
+    readonly script?: PDFFont;
+}
+export interface TextRun {
+    readonly text: string;
+    readonly script: boolean;
+}
+/** Split text into Latin (Helvetica / WinAnsi) vs script (Noto) runs. */
+export declare function splitPdfTextRuns(text: string): TextRun[];
+export declare function usesScriptFont(text: string): boolean;
+export interface PdfDrawPart {
+    readonly text: string;
+    readonly script: boolean;
+}
+/** Bidi reorder (RTL locales), split fonts, shape Arabic — ready for pdf-lib drawText. */
+export declare function preparePdfDrawParts(text: string, locale: BookletLocale | undefined, textOptions?: PdfTextOptions): PdfDrawPart[];
+export declare function measureMixedTextWidth(text: string, fonts: PdfFontPair, size: number, bold?: boolean, textOptions?: PdfTextOptions, locale?: BookletLocale): number;
+export declare function drawMixedTextLine(page: PDFPage, text: string, xStart: number, y: number, fonts: PdfFontPair, size: number, color: ReturnType<typeof rgb>, alignRtl: boolean, bold?: boolean, textOptions?: PdfTextOptions, locale?: BookletLocale): void;

package/dist/booklet/booklet-pdf.d.ts

@@ -1,6 +1,7 @@
 import { type DrawGedcomTsLogoOptions } from './booklet-logo';
 import type { BookletPersonEntry } from './booklet-person';
 import { type BookletTimelineStyle } from './booklet-timeline';
+import type { BookletLocale } from './booklet-locale';
 import { type BookletDetailLevel } from './booklet-structure';
 export interface BookletPdfMeta {
     readonly title: string;
@@ -11,12 +12,24 @@ export interface BookletPdfMeta {
 export interface BookletPdfOptions {
     readonly detailLevel: BookletDetailLevel;
     readonly timelineStyle: BookletTimelineStyle;
+    /** Booklet narrative language (default English). */
+    readonly locale?: BookletLocale;
     /**
      * Logo gedcom-ts sur la page de couverture (vecteur, inclus dans le paquet).
      * Défaut : affiché. `false` pour masquer ; sinon options passées à `drawGedcomTsLogoOnPage`.
      */
     readonly coverLogo?: boolean | DrawGedcomTsLogoOptions;
+    /**
+     * Optional TTF/OTF font bytes for Unicode scripts (Arabic, Hebrew, Chinese, etc.).
+     * When omitted, Noto fonts are fetched automatically for `zh`, `ar`, and `he`.
+     */
+    readonly unicodeFont?: Uint8Array;
+}
+export interface PdfTextOptions {
+    /** Keep non-Latin characters (requires a Unicode-capable PDF font). */
+    readonly preserveUnicode?: boolean;
 }
+export declare function preparePdfText(text: string, options?: PdfTextOptions): string;
 export declare function toPdfText(text: string): string;
 export declare function generateGenealogyBookletPdf(entries: readonly BookletPersonEntry[], meta: BookletPdfMeta, options: BookletPdfOptions): Promise<Uint8Array>;
 export declare function downloadBookletPdf(bytes: Uint8Array, filename: string): void;

package/dist/booklet/booklet-person.d.ts

@@ -1,6 +1,7 @@
 import { type Person } from "../commons/Person";
 import type { ReadGed } from "../import/ReadGed";
 import type { BookletSex } from './booklet-gender';
+import type { BookletLocale } from './booklet-locale';
 export type { BookletSex } from './booklet-gender';
 export interface BookletRelationRef {
     readonly indi: number;
@@ -33,10 +34,10 @@ export interface BookletPersonEntry {
     readonly unions: readonly BookletUnionEntry[];
 }
 export declare function personDisplayName(person: Person): string;
-export declare function personDatesLabel(person: Person): string;
+export declare function personDatesLabel(person: Person, locale?: BookletLocale): string;
 export declare function bookletSexFromPerson(person: Person): BookletSex;
-export declare function buildBookletPersonEntry(person: Person, ged: ReadGed, sosa: number | null): BookletPersonEntry;
-export declare function sortBookletEntries(entries: BookletPersonEntry[]): BookletPersonEntry[];
+export declare function buildBookletPersonEntry(person: Person, ged: ReadGed, sosa: number | null, locale?: BookletLocale): BookletPersonEntry;
+export declare function sortBookletEntries(entries: BookletPersonEntry[], locale?: BookletLocale): BookletPersonEntry[];
 export type BookletScope = 'all' | 'from-reference';
 export interface BookletCollectOptions {
     readonly scope: BookletScope;
@@ -44,5 +45,7 @@ export interface BookletCollectOptions {
     readonly referencePerson: Person | null;
     /** Limite de génération SOSA (1 = racine seulement). Ignoré si « tout l’arbre ». */
     readonly maxGeneration?: number | null;
+    /** Booklet narrative language (default English). */
+    readonly locale?: BookletLocale;
 }
 export declare function collectBookletPersons(options: BookletCollectOptions): BookletPersonEntry[];

package/dist/booklet/booklet-place-en.d.ts

@@ -0,0 +1,16 @@
+export interface ParsedPlace {
+    readonly city: string | null;
+    readonly country: string | null;
+    readonly raw: string;
+}
+export declare function parsePlaceLabel(label: string): ParsedPlace | null;
+export declare function placeCore(label: string): string;
+export declare function afterDateLocation(dateLabel: string, placeLabel: string): string;
+export declare function atLocation(placeLabel: string): string;
+export declare function birthDeathLocationPhrases(birthDate: string, birthPlace: string, deathDate: string, deathPlace: string): {
+    readonly birth: string;
+    readonly death: string;
+};
+export declare function lifeRangeLocation(birthPlace: string, deathPlace: string): string;
+export declare function marriageWhenWhere(dateLabel: string, placeLabel: string): string | null;
+export declare function embedMarriageWhenWhere(label: string | null | undefined): string;

package/dist/booklet/booklet-place-factory.d.ts

@@ -0,0 +1,28 @@
+import type { BookletDateModule } from './booklet-date-factory';
+export interface ParsedPlace {
+    readonly city: string | null;
+    readonly country: string | null;
+    readonly raw: string;
+}
+export interface BookletPlaceConfig {
+    readonly countryPrefixes: readonly string[];
+    readonly countryPhrase: (country: string) => string;
+    readonly locationPhrase: (core: string) => string;
+    readonly lifeRangeSame: (core: string) => string;
+    readonly lifeRangeFromTo: (from: string, to: string) => string;
+    readonly lifeRangeSingle: (core: string) => string;
+}
+export interface BookletPlaceModule {
+    parsePlaceLabel(label: string): ParsedPlace | null;
+    placeCore(label: string): string;
+    afterDateLocation(dateLabel: string, placeLabel: string): string;
+    atLocation(placeLabel: string): string;
+    birthDeathLocationPhrases(birthDate: string, birthPlace: string, deathDate: string, deathPlace: string): {
+        readonly birth: string;
+        readonly death: string;
+    };
+    lifeRangeLocation(birthPlace: string, deathPlace: string): string;
+    marriageWhenWhere(dateLabel: string, placeLabel: string): string | null;
+    embedMarriageWhenWhere(label: string | null | undefined): string;
+}
+export declare function createBookletPlaceModule(date: BookletDateModule, config: BookletPlaceConfig): BookletPlaceModule;

package/dist/booklet/booklet-place.d.ts

@@ -0,0 +1,13 @@
+import type { BookletLocale } from "./booklet-locale";
+export type { ParsedPlace } from "./booklet-place-factory";
+export declare function parsePlaceLabel(label: string, locale?: BookletLocale): import("./booklet-place-factory").ParsedPlace;
+export declare function placeCore(label: string, locale?: BookletLocale): string;
+export declare function afterDateLocation(dateLabel: string, placeLabel: string, locale?: BookletLocale): string;
+export declare function atLocation(placeLabel: string, locale?: BookletLocale): string;
+export declare function birthDeathLocationPhrases(birthDate: string, birthPlace: string, deathDate: string, deathPlace: string, locale?: BookletLocale): {
+    readonly birth: string;
+    readonly death: string;
+};
+export declare function lifeRangeLocation(birthPlace: string, deathPlace: string, locale?: BookletLocale): string;
+export declare function marriageWhenWhere(dateLabel: string, placeLabel: string, locale?: BookletLocale): string;
+export declare function embedMarriageWhenWhere(label: string | null | undefined, locale?: BookletLocale): string;

package/dist/booklet/booklet-structure.d.ts

@@ -1,4 +1,5 @@
 import type { BookletPersonEntry, BookletRelationRef } from './booklet-person';
+import type { BookletLocale } from './booklet-locale';
 export type BookletDetailLevel = 'summary' | 'detailed';
 export type { BookletRelationRef };
 export interface BookletFamilyUnit {
@@ -18,6 +19,6 @@ export interface BookletTocEntry {
     readonly title: string;
     readonly page: number;
 }
-export declare function groupBookletIntoChapters(entries: readonly BookletPersonEntry[]): BookletChapter[];
+export declare function groupBookletIntoChapters(entries: readonly BookletPersonEntry[], locale?: BookletLocale): BookletChapter[];
 export declare function partnerNamesLabel(partners: readonly BookletRelationRef[]): string;
-export declare function childrenNamesLabel(children: readonly BookletRelationRef[], max?: number): string;
+export declare function childrenNamesLabel(children: readonly BookletRelationRef[], max?: number, locale?: BookletLocale): string;

package/dist/booklet/booklet-timeline-canvas.d.ts

@@ -1,9 +1,2 @@
-import { type GenerationTimelineLayout } from './booklet-timeline';
-export declare const TIMELINE_CANVAS_WIDTH = 920;
-/** Hauteur du PNG (px) pour N lignes de frise. */
-export declare function timelineCanvasHeightPx(rowCount: number, continuationNote?: boolean): number;
-/** Hauteur en points PDF après mise à l'échelle dans le livret. */
-export declare function timelineScaledPdfHeight(rowCount: number, pdfMaxWidth: number, continuationNote?: boolean): number;
-/** Nombre maximal de lignes dont la frise tient dans la hauteur PDF disponible. */
-export declare function maxTimelineRowsForPdfHeight(availablePt: number, pdfMaxWidth: number, continuationNote?: boolean): number;
-export declare function rasterizeGenerationTimelinePng(layout: GenerationTimelineLayout, pageNote?: string): Promise<Uint8Array>;
+export { TIMELINE_CANVAS_WIDTH, maxTimelineRowsForPdfHeight, timelineCanvasHeightPx, timelineScaledPdfHeight, } from './booklet-timeline-metrics';
+export { ensureBookletTimelineRaster, clearBookletTimelineRasterCache, rasterizeGenerationTimelinePng, } from './booklet-timeline-loader';

package/dist/booklet/booklet-timeline-loader.d.ts

@@ -0,0 +1,6 @@
+import type { BookletLocale } from './booklet-locale';
+import type { GenerationTimelineLayout } from './booklet-timeline';
+export declare function clearBookletTimelineRasterCache(): void;
+/** Loads canvas timeline rasterization (only when `timelineStyle === 'canvas'`). */
+export declare function ensureBookletTimelineRaster(): Promise<void>;
+export declare function rasterizeGenerationTimelinePng(layout: GenerationTimelineLayout, pageNote?: string, locale?: BookletLocale): Promise<Uint8Array>;

package/dist/booklet/booklet-timeline-metrics.d.ts

@@ -0,0 +1,8 @@
+/** Layout metrics for canvas timelines (no canvas / PNG code). */
+export declare const TIMELINE_CANVAS_WIDTH = 920;
+/** Hauteur du PNG (px) pour N lignes de frise. */
+export declare function timelineCanvasHeightPx(rowCount: number, continuationNote?: boolean): number;
+/** Hauteur en points PDF après mise à l'échelle dans le livret. */
+export declare function timelineScaledPdfHeight(rowCount: number, pdfMaxWidth: number, continuationNote?: boolean): number;
+/** Nombre maximal de lignes dont la frise tient dans la hauteur PDF disponible. */
+export declare function maxTimelineRowsForPdfHeight(availablePt: number, pdfMaxWidth: number, continuationNote?: boolean): number;

package/dist/booklet/feature-chunks/booklet-logo-draw.d.ts

@@ -0,0 +1,15 @@
+import type { PDFPage, RGB } from 'pdf-lib';
+import { GEDCOM_TS_LOGO_PATHS, GEDCOM_TS_LOGO_VIEWBOX } from '../gedcom-ts-logo.paths';
+export { GEDCOM_TS_LOGO_PATHS, GEDCOM_TS_LOGO_VIEWBOX };
+export interface GedcomTsLogoLayout {
+    readonly bottomY: number;
+    readonly height: number;
+}
+export interface DrawGedcomTsLogoOptions {
+    readonly pageWidth?: number;
+    readonly maxWidth?: number;
+    readonly bottomY?: number;
+    readonly color?: RGB;
+}
+/** Dessine le logo gedcom-ts en vecteur SVG sur la page (pdf-lib drawSvgPath). */
+export declare function drawGedcomTsLogoOnPage(page: PDFPage, options?: DrawGedcomTsLogoOptions): GedcomTsLogoLayout;

package/dist/booklet/feature-chunks/booklet-timeline-raster.d.ts

@@ -0,0 +1,3 @@
+import type { BookletLocale } from '../booklet-locale';
+import { type GenerationTimelineLayout } from '../booklet-timeline';
+export declare function rasterizeGenerationTimelinePng(layout: GenerationTimelineLayout, pageNote?: string, locale?: BookletLocale): Promise<Uint8Array>;

package/dist/booklet/font-chunks/booklet-font-subset-chars.d.ts

@@ -0,0 +1,2 @@
+/** Auto-generated by scripts/prepare-booklet-fonts.mjs — do not edit. */
+export declare const BOOKLET_FONT_SUBSET_CHARS: Record<"ar" | "he" | "zh" | "zhExt", string>;

package/dist/booklet/font-chunks/booklet-pdf-font-bytes-ar.d.ts

@@ -0,0 +1,2 @@
+/** Auto-generated by scripts/prepare-booklet-fonts.mjs — do not edit. */
+export declare const BOOKLET_FONT_AR: Uint8Array<ArrayBufferLike>;

package/dist/booklet/font-chunks/booklet-pdf-font-bytes-he.d.ts

@@ -0,0 +1,2 @@
+/** Auto-generated by scripts/prepare-booklet-fonts.mjs — do not edit. */
+export declare const BOOKLET_FONT_HE: Uint8Array<ArrayBufferLike>;

package/dist/booklet/font-chunks/booklet-pdf-font-bytes-zh-ext.d.ts

@@ -0,0 +1,2 @@
+/** Auto-generated by scripts/prepare-booklet-fonts.mjs — do not edit. */
+export declare const BOOKLET_FONT_ZH_EXT: Uint8Array<ArrayBufferLike>;

package/dist/booklet/font-chunks/booklet-pdf-font-bytes-zh.d.ts

@@ -0,0 +1,2 @@
+/** Auto-generated by scripts/prepare-booklet-fonts.mjs — do not edit. */
+export declare const BOOKLET_FONT_ZH: Uint8Array<ArrayBufferLike>;

package/dist/booklet/index.d.ts

@@ -1,9 +1,17 @@
 export { buildBookletPersonEntry, bookletSexFromPerson, collectBookletPersons, personDisplayName, sortBookletEntries, type BookletCollectOptions, type BookletPersonEntry, type BookletRelationRef, type BookletScope, type BookletSex, type BookletUnionEntry, } from './booklet-person';
+export { DEFAULT_BOOKLET_LOCALE, BOOKLET_LOCALES, BOOKLET_LOCALES_IMPLEMENTED, BOOKLET_RTL_LOCALES, resolveBookletLocale, isBookletLocale, isBookletLocaleRtl, bookletTextDirection, bookletLocaleCompareTag, bookletLocaleToBcp47, type BookletLocale, } from './booklet-locale';
 export { personGenderWords, pluralS, pluralPick } from './booklet-gender';
+export { unknownDateLabel, onDate, lifeDateRange, seesDayOn, isYearOnlyDate } from './booklet-date';
 export { buildChapterIntroNarrative, buildFamilyNarrative, buildPersonDetailedNarratives, buildPersonSummaryNarrative, } from './booklet-narrative';
 export { buildGenerationTimeline, chapterSupportsTimeline, timelineRowCount, type BookletTimelineStyle, type GenerationTimelineLayout, } from './booklet-timeline';
 export { bookletSizeAdvice, estimateBookletSize, estimateTimelineSliceCount } from './booklet-estimate';
-export { rasterizeGenerationTimelinePng } from './booklet-timeline-canvas';
-export { BOOKLET_BRAND_RGB, defaultCoverLogoOptions, drawGedcomTsLogoOnPage, GEDCOM_TS_LOGO_PATHS, GEDCOM_TS_LOGO_VIEWBOX, type DrawGedcomTsLogoOptions, type GedcomTsLogoLayout, } from './booklet-logo';
+export { ensureBookletTimelineRaster, clearBookletTimelineRasterCache, rasterizeGenerationTimelinePng, TIMELINE_CANVAS_WIDTH, maxTimelineRowsForPdfHeight, timelineCanvasHeightPx, timelineScaledPdfHeight, } from './booklet-timeline-canvas';
+export { BOOKLET_BRAND_RGB, defaultCoverLogoOptions, type DrawGedcomTsLogoOptions, type GedcomTsLogoLayout, } from './booklet-logo';
+export { ensureBookletLogo, clearBookletLogoCache, drawGedcomTsLogoOnPage, getGedcomTsLogoPaths, getGedcomTsLogoViewbox, } from './booklet-logo-loader';
 export { groupBookletIntoChapters, partnerNamesLabel, type BookletChapter, type BookletDetailLevel, type BookletFamilyUnit, type BookletTocEntry, } from './booklet-structure';
-export { downloadBookletPdf, generateGenealogyBookletPdf, toPdfText, type BookletPdfMeta, type BookletPdfOptions, } from './booklet-pdf';
+export { bundledBookletPdfFontBytes, clearBookletPdfFontCache, loadBookletPdfFontBytes, localeNeedsUnicodePdfFont, registerBookletPdfFontBytes, } from './booklet-pdf-font';
+export { ensureBookletLocale, clearBookletLocaleCache, isBookletLocaleLoaded, type BookletLocaleBundle, } from './booklet-locale-loader';
+export { getBookletMessages, loadBookletMessages, actTypeLabel, } from './booklet-messages';
+export { drawMixedTextLine, measureMixedTextWidth, splitPdfTextRuns, type PdfFontPair, } from './booklet-pdf-text';
+export { downloadBookletPdf, generateGenealogyBookletPdf, preparePdfText, toPdfText, type BookletPdfMeta, type BookletPdfOptions, type PdfTextOptions, } from './booklet-pdf';
+export { registerPdfFontkit } from './booklet-pdf-fontkit';

package/dist/booklet/locale-chunks/booklet-locale-ar.d.ts

@@ -0,0 +1,3 @@
+import type { BookletLocaleBundle } from '../booklet-locale-loader';
+declare const bundle: BookletLocaleBundle;
+export default bundle;

package/dist/booklet/locale-chunks/booklet-locale-de.d.ts

@@ -0,0 +1,3 @@
+import type { BookletLocaleBundle } from '../booklet-locale-loader';
+declare const bundle: BookletLocaleBundle;
+export default bundle;

package/dist/booklet/locale-chunks/booklet-locale-en.d.ts

@@ -0,0 +1,3 @@
+import type { BookletLocaleBundle } from '../booklet-locale-loader';
+declare const bundle: BookletLocaleBundle;
+export default bundle;

package/dist/booklet/locale-chunks/booklet-locale-es.d.ts

@@ -0,0 +1,3 @@
+import type { BookletLocaleBundle } from '../booklet-locale-loader';
+declare const bundle: BookletLocaleBundle;
+export default bundle;

package/dist/booklet/locale-chunks/booklet-locale-fr.d.ts

@@ -0,0 +1,3 @@
+import type { BookletLocaleBundle } from '../booklet-locale-loader';
+declare const bundle: BookletLocaleBundle;
+export default bundle;

package/dist/booklet/locale-chunks/booklet-locale-he.d.ts

@@ -0,0 +1,3 @@
+import type { BookletLocaleBundle } from '../booklet-locale-loader';
+declare const bundle: BookletLocaleBundle;
+export default bundle;

package/dist/booklet/locale-chunks/booklet-locale-it.d.ts

@@ -0,0 +1,3 @@
+import type { BookletLocaleBundle } from '../booklet-locale-loader';
+declare const bundle: BookletLocaleBundle;
+export default bundle;

package/dist/booklet/locale-chunks/booklet-locale-nl.d.ts

@@ -0,0 +1,3 @@
+import type { BookletLocaleBundle } from '../booklet-locale-loader';
+declare const bundle: BookletLocaleBundle;
+export default bundle;

package/dist/booklet/locale-chunks/booklet-locale-pl.d.ts

@@ -0,0 +1,3 @@
+import type { BookletLocaleBundle } from '../booklet-locale-loader';
+declare const bundle: BookletLocaleBundle;
+export default bundle;

package/dist/booklet/locale-chunks/booklet-locale-pt.d.ts

@@ -0,0 +1,3 @@
+import type { BookletLocaleBundle } from '../booklet-locale-loader';
+declare const bundle: BookletLocaleBundle;
+export default bundle;

package/dist/booklet/locale-chunks/booklet-locale-zh.d.ts

@@ -0,0 +1,3 @@
+import type { BookletLocaleBundle } from '../booklet-locale-loader';
+declare const bundle: BookletLocaleBundle;
+export default bundle;