gedcom-ts 2026.5.2 → 2026.5.4

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

@@ -0,0 +1,7 @@
+import type { BookletLocale } from './booklet-locale';
+import type { BookletPersonEntry } from './booklet-person';
+import type { BookletChapter, BookletDetailLevel, BookletFamilyUnit } from './booklet-structure';
+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

@@ -0,0 +1,35 @@
+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;
+    readonly scopeLabel: string;
+    readonly personCount: number;
+    readonly referenceName?: string;
+}
+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

@@ -0,0 +1,51 @@
+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;
+    readonly name: string;
+    readonly datesLabel: string;
+    readonly sex: BookletSex;
+}
+export interface BookletEventLine {
+    readonly kind: string;
+    readonly label: string;
+    readonly date: string;
+    readonly place: string;
+}
+export interface BookletUnionEntry {
+    readonly familyId: number;
+    readonly coParent: BookletRelationRef;
+    readonly children: readonly BookletRelationRef[];
+    readonly marriageLabel: string | null;
+}
+export interface BookletPersonEntry {
+    readonly indi: number;
+    readonly name: string;
+    readonly sex: BookletSex;
+    readonly datesLabel: string;
+    readonly sosa: number | null;
+    readonly generation: number | null;
+    readonly events: readonly BookletEventLine[];
+    readonly notesPreview: string | null;
+    readonly parents: readonly BookletRelationRef[];
+    readonly unions: readonly BookletUnionEntry[];
+}
+export declare function personDisplayName(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, locale?: BookletLocale): BookletPersonEntry;
+export declare function sortBookletEntries(entries: BookletPersonEntry[], locale?: BookletLocale): BookletPersonEntry[];
+export type BookletScope = 'all' | 'from-reference';
+export interface BookletCollectOptions {
+    readonly scope: BookletScope;
+    readonly ged: ReadGed;
+    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-fr.d.ts

@@ -0,0 +1,24 @@
+export interface ParsedPlace {
+    readonly city: string | null;
+    readonly country: string | null;
+    readonly raw: string;
+}
+/** Découpe « ville, pays » issu de actPlaceLabel. */
+export declare function parsePlaceLabel(label: string): ParsedPlace | null;
+/** Noyau du lieu sans préposition initiale : « Poissy », « Poissy, en France », « en France ». */
+export declare function placeCore(label: string): string;
+/** Lieu après une date ou un événement : « à Poissy », « en France », « , à Poissy » si date = année. */
+export declare function afterDateLocation(dateLabel: string, placeLabel: string): string;
+/** Lieu seul (sans date avant) : « à Poissy, en France ». */
+export declare function atLocation(placeLabel: string): string;
+/** Lieu de naissance et de décès : évite de répéter le lieu si identique. */
+export declare function birthDeathLocationPhrases(birthDate: string, birthPlace: string, deathDate: string, deathPlace: string): {
+    readonly birth: string;
+    readonly death: string;
+};
+/** Lieu(x) après une fourchette de dates de vie. */
+export declare function lifeRangeLocation(birthPlace: string, deathPlace: string): string;
+/** « en 1991, à Poissy, en France » — date et lieu pour un mariage. */
+export declare function marriageWhenWhere(dateLabel: string, placeLabel: string): string | null;
+/** Espace + fragment mariage pour l’insérer après un verbe (« se marient en 1991… »). */
+export declare function embedMarriageWhenWhere(label: string | null | undefined): string;

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

@@ -0,0 +1,24 @@
+import type { BookletPersonEntry, BookletRelationRef } from './booklet-person';
+import type { BookletLocale } from './booklet-locale';
+export type BookletDetailLevel = 'summary' | 'detailed';
+export type { BookletRelationRef };
+export interface BookletFamilyUnit {
+    readonly familyId: number;
+    readonly partners: readonly BookletRelationRef[];
+    readonly children: readonly BookletRelationRef[];
+    readonly marriageLabel: string | null;
+}
+export interface BookletChapter {
+    readonly key: string;
+    readonly title: string;
+    readonly subtitle: string;
+    readonly entries: readonly BookletPersonEntry[];
+    readonly families: readonly BookletFamilyUnit[];
+}
+export interface BookletTocEntry {
+    readonly title: string;
+    readonly page: number;
+}
+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, locale?: BookletLocale): string;

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

@@ -0,0 +1,2 @@
+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/booklet-timeline.d.ts

@@ -0,0 +1,31 @@
+import type { BookletChapter } from './booklet-structure';
+export type BookletTimelineStyle = 'off' | 'canvas';
+export type TimelineMarkerKind = 'birth' | 'death' | 'marriage';
+export interface TimelineMarker {
+    readonly year: number;
+    readonly kind: TimelineMarkerKind;
+}
+export interface TimelineRow {
+    readonly name: string;
+    readonly shortName: string;
+    readonly birthYear: number | null;
+    readonly deathYear: number | null;
+    readonly markers: readonly TimelineMarker[];
+    readonly hasLifeSpan: boolean;
+}
+export interface GenerationTimelineLayout {
+    readonly chapterTitle: string;
+    readonly yearMin: number;
+    readonly yearMax: number;
+    readonly tickStep: number;
+    readonly tickYears: readonly number[];
+    readonly rows: readonly TimelineRow[];
+    readonly overflowCount: number;
+    readonly pageCount: number;
+}
+export declare function chapterSupportsTimeline(chapter: BookletChapter): boolean;
+export declare function parseYearFromDate(date: string): number | null;
+export declare function timelineRowCount(chapter: BookletChapter): number;
+export declare function buildGenerationTimeline(chapter: BookletChapter, rowStart?: number, rowCount?: number): GenerationTimelineLayout | null;
+/** Position X normalisée 0–1 dans la plage [yearMin, yearMax]. */
+export declare function timelineXNorm(year: number, yearMin: number, yearMax: number): 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/gedcom-ts-logo.paths.d.ts

@@ -0,0 +1,3 @@
+/** Chemins du logo gedcom-ts (viewBox commun). */
+export declare const GEDCOM_TS_LOGO_VIEWBOX = "28.136896362304697 238.4370489501953 1352.32712890625 293.0861376953125";
+export declare const GEDCOM_TS_LOGO_PATHS: readonly ["M 1305.159,272.478 C 1306.112,274.485 1307.065,276.493 1308.018,278.500 C 1308.932,313.833 1307.845,349.167 1307.759,384.500 C 1307.673,419.833 1307.586,455.167 1307.500,490.500 C 1306.736,491.932 1305.971,493.363 1305.207,494.795 C 1301.672,501.415 1296.377,506.667 1290.161,509.720 C 1288.274,510.647 1286.387,511.573 1284.500,512.500 C 1249.167,512.500 1213.833,512.500 1178.500,512.500 C 1143.167,512.500 1107.833,512.500 1072.500,512.500 C 1070.833,511.677 1069.167,510.855 1067.500,510.032 C 1060.247,506.452 1053.705,499.501 1051.143,492.653 C 1049.003,486.933 1049,486.781 1049,383.500 C 1049,281.958 1049.037,279.976 1051.033,274.640 C 1053.622,267.719 1059.317,261.248 1066.145,257.466 C 1067.930,256.477 1069.715,255.489 1071.500,254.500 C 1106.646,254.411 1141.792,254.321 1176.938,254.232 C 1271.064,253.993 1282.889,254.135 1287.158,255.553 C 1293.887,257.788 1301.651,265.088 1305.159,272.478 ZM 1148.500,369 C 1134,369 1119.500,369 1105,369 C 1105,372.500 1105,376 1105,379.500 C 1105,383 1105,386.500 1105,390 C 1110.333,390 1115.667,390 1121,390 C 1126.333,390 1131.667,390 1137,390 C 1137,405.833 1137,421.667 1137,437.500 C 1137,453.333 1137,469.167 1137,485 C 1140.833,485 1144.667,485 1148.500,485 C 1152.333,485 1156.167,485 1160,485 C 1160,469.167 1160,453.333 1160,437.500 C 1160,421.667 1160,405.833 1160,390 C 1165.333,390 1170.667,390 1176,390 C 1181.333,390 1186.667,390 1192,390 C 1192,386.500 1192,383 1192,379.500 C 1192,376 1192,372.500 1192,369 C 1177.500,369 1163,369 1148.500,369 ZM 1203.739,460.228 C 1200.990,462.143 1200.986,462.167 1202.739,465.168 C 1211.828,480.727 1230.452,488.669 1251.571,485.991 C 1265.570,484.216 1274.010,478.789 1279.215,468.214 C 1282.177,462.198 1282.494,460.702 1282.434,453.020 C 1282.293,434.845 1274.476,425.946 1249.377,415.384 C 1235.916,409.720 1231.345,406.356 1230.423,401.441 C 1228.911,393.378 1234.308,388.492 1243.956,389.190 C 1249.947,389.623 1253.327,391.486 1256.673,396.196 C 1257.314,397.098 1257.954,398 1258.595,398.902 C 1261.489,397.002 1264.384,395.101 1267.279,393.201 C 1272.055,390.065 1275.971,386.844 1275.981,386.043 C 1275.991,385.242 1273.176,381.831 1269.725,378.464 C 1262.318,371.237 1257.195,369.096 1245.369,368.288 C 1229.582,367.210 1216.149,373.886 1210.351,385.693 C 1207.842,390.803 1207.505,392.580 1207.542,400.500 C 1207.578,408.209 1207.960,410.223 1210.203,414.540 C 1214.235,422.301 1220.653,427.492 1233.837,433.652 C 1240.251,436.649 1247.525,440.157 1250,441.448 C 1262.500,447.967 1261.922,461.901 1249.023,464.995 C 1243.341,466.358 1237.206,465.625 1231.932,462.953 C 1228.390,461.159 1221.668,454.505 1220.817,451.951 C 1220.493,450.977 1218.507,451.654 1213.437,454.462 C 1209.622,456.575 1205.258,459.170 1203.739,460.228 Z", "M 225.380,335.713 C 225.772,336.105 225.942,365.918 225.759,401.963 C 225.461,460.487 225.241,468.142 223.695,473.500 C 215.587,501.606 191.466,517.459 159.500,515.688 C 147.674,515.033 139.874,513.136 131,508.756 C 123.005,504.810 112.315,494.528 108.616,487.228 C 107.728,485.475 106.839,483.722 105.951,481.969 C 106.782,481.653 107.613,481.337 108.444,481.021 C 109.815,480.500 114.203,478.684 118.194,476.985 C 126.258,473.553 125.247,473.202 130,481.096 C 133.139,486.309 139.532,491.270 146.847,494.169 C 151.547,496.032 154.438,496.410 164,496.410 C 179.109,496.410 184.874,494.302 193.588,485.588 C 202.242,476.934 204.180,471.495 204.776,454.201 C 204.929,449.768 205.081,445.336 205.234,440.903 C 203.339,442.890 201.444,444.876 199.549,446.863 C 183.362,463.834 157.572,467.618 134.090,456.466 C 123.991,451.670 112.996,440.613 107.772,430 C 102.187,418.653 100.588,411.423 100.583,397.500 C 100.576,376.858 105.878,363.166 119,349.939 C 127.108,341.766 136.428,336.423 147,333.887 C 153.967,332.216 167.851,332.242 175,333.939 C 183.154,335.875 193.353,341.580 199.534,347.663 C 201.356,349.456 203.178,351.249 205,353.042 C 205.003,351.785 205.006,350.528 205.009,349.271 C 205.014,347.197 205.301,343.138 205.648,340.250 C 205.858,338.500 206.069,336.750 206.279,335 C 209.344,335 212.408,335 215.473,335 C 220.530,335 224.988,335.321 225.380,335.713 ZM 122.022,389.200 C 120.892,396.956 120.930,398.721 122.415,407.042 C 125.883,426.478 138.872,440.098 156.884,443.187 C 178.669,446.923 199.317,432.057 204.057,409.224 C 205.748,401.078 204.781,385.847 202.140,379.023 C 197.584,367.254 188.711,358.051 177.780,353.757 C 170.193,350.777 156.539,350.809 149,353.827 C 134.233,359.738 124.444,372.573 122.022,389.200 Z", "M 508,286 C 511.333,286 514.667,286 518,286 C 518,315.333 518,344.667 518,374 C 518,403.333 518,432.667 518,462 C 514.667,462 511.333,462 508,462 C 504.667,462 501.333,462 498,462 C 498,458.811 498,455.622 498,452.433 C 498,449.244 498,446.055 498,442.866 C 495.875,445.022 493.751,447.179 491.626,449.335 C 474.540,466.675 446.501,470.165 422.906,457.890 C 408.340,450.312 396.391,434.668 391.972,417.391 C 388.015,401.918 389.862,381.623 396.507,367.577 C 400.385,359.380 408.939,349.034 415.841,344.192 C 427.939,335.706 438.526,332.467 453.542,332.658 C 469.877,332.865 483.504,338.894 493.518,350.342 C 495.012,352.050 496.506,353.758 498,355.466 C 498,343.888 498,332.311 498,320.733 C 498,309.155 498,297.578 498,286 C 501.333,286 504.667,286 508,286 ZM 412.082,387.108 C 407.475,410.565 417.567,433.256 436.808,442.705 C 442.038,445.273 443.434,445.500 454,445.500 C 465.062,445.500 465.756,445.371 472.210,442.132 C 495.351,430.518 504.420,400.706 492.324,376.013 C 481.485,353.887 457.114,345.306 435.411,355.974 C 424.494,361.340 414.531,374.636 412.082,387.108 Z", "M 805.897,388.107 C 807.087,395.930 806.409,408.990 804.410,416.736 C 799.555,435.549 786.507,451.242 769.077,459.232 C 745.708,469.945 715.450,465.632 696.694,448.915 C 689.676,442.660 681.914,431.161 679.116,422.876 C 673.975,407.652 674.080,389.135 679.392,374.501 C 686.555,354.768 703.236,339.744 724,334.324 C 734.342,331.625 751.409,332.097 761.500,335.361 C 772.424,338.895 781.049,344.251 788.454,352.100 C 798.280,362.514 803.708,373.720 805.897,388.107 ZM 697.009,389.528 C 695.771,396.453 696.744,408.291 699.139,415.462 C 703.243,427.747 711.279,436.868 722.820,442.335 C 729.114,445.317 730.163,445.500 741,445.500 C 751.817,445.500 752.893,445.314 759.123,442.362 C 775.696,434.509 785.195,418.938 785.270,399.500 C 785.328,384.498 780.452,372.423 770.416,362.710 C 761.762,354.334 746.457,349.659 734.435,351.718 C 726.976,352.996 718.387,356.734 712.871,361.102 C 705.470,366.964 698.956,378.639 697.009,389.528 Z", "M 1012.963,373.810 C 1013.395,377.489 1013.692,398.725 1013.624,421 C 1013.583,434.500 1013.541,448 1013.500,461.500 C 1010.108,461.595 1006.717,461.689 1003.325,461.784 C 999.933,461.879 996.542,461.973 993.150,462.068 C 993.020,447.640 992.891,433.212 992.761,418.784 C 992.331,370.854 992.138,369.271 985.715,360.849 C 980.815,354.425 974.329,351.515 965.052,351.578 C 959.350,351.617 956.364,352.178 952.864,353.871 C 946.122,357.131 940.271,362.531 937.452,368.095 C 932.317,378.228 932,381.430 932,423.210 C 932,436.140 932,449.070 932,462 C 928.525,462 925.050,462 921.575,462 C 918.100,462 914.624,462 911.149,462 C 911.032,447.583 910.917,433.167 910.800,418.750 C 910.467,377.548 910.349,375.230 908.322,369.810 C 905.317,361.776 901.672,357.478 895.150,354.275 C 876.725,345.227 855.437,358.603 850.996,382.020 C 850.446,384.921 850,404.004 850,424.636 C 850,437.091 850,449.546 850,462 C 846.500,462 843,462 839.500,462 C 836,462 832.500,462 829,462 C 829,440.821 829,419.643 829,398.464 C 829,377.285 829,356.107 829,334.928 C 832.250,335.023 835.500,335.119 838.750,335.214 C 842,335.309 845.250,335.405 848.500,335.500 C 848.667,338.436 848.833,341.371 849,344.307 C 849.167,347.243 849.333,350.177 849.500,353.113 C 850.536,351.762 851.571,350.412 852.607,349.061 C 862.146,336.620 877.850,330.621 894.731,332.969 C 907.103,334.690 916.916,340.693 922.924,350.218 C 924.065,352.028 925.208,353.837 926.349,355.647 C 927.727,353.956 929.105,352.264 930.483,350.573 C 941.697,336.811 957.957,330.521 975.954,332.982 C 997.187,335.886 1010.194,350.235 1012.963,373.810 Z", "M 370.503,382.500 C 371.227,386.350 371.860,392.763 371.910,396.750 C 371.940,399.167 371.970,401.583 372,404 C 354.953,404 337.907,404 320.860,404 C 303.813,404 286.767,404 269.720,404 C 269.911,405.853 270.103,407.707 270.294,409.560 C 271.046,416.849 276.054,427.420 281.304,432.801 C 291.031,442.771 300.809,446.451 315.887,445.818 C 324.320,445.464 326.327,445.005 332.234,442.078 C 339.025,438.713 346.918,431.468 349.164,426.539 C 349.800,425.143 350.636,424 351.022,424 C 352.590,424 369,432.158 369,432.938 C 369,434.517 360.340,445.489 355.851,449.598 C 350.204,454.767 343.577,458.665 335.120,461.788 C 325.969,465.168 308.541,465.988 297.603,463.555 C 267.364,456.827 248,431.474 248,398.608 C 248,366.704 267.142,340.922 296,333.958 C 303.636,332.115 320.091,332.296 327.725,334.306 C 350.643,340.342 365.780,357.394 370.503,382.500 ZM 272.456,378.727 C 271.175,382.394 270.349,385.757 270.622,386.198 C 270.895,386.639 288.866,387 310.559,387 C 343.627,387 350,386.774 350,385.605 C 350,384.838 349.111,381.332 348.024,377.813 C 344.295,365.739 337.509,358.326 326.048,353.804 C 321.697,352.087 318.343,351.604 310.500,351.563 C 301.680,351.517 299.823,351.827 294.765,354.193 C 283.347,359.534 276.552,367.006 272.456,378.727 Z", "M 660.250,429.675 C 661.292,430.291 661.220,430.668 659.367,434.300 C 656.179,440.550 647.510,450.122 641.029,454.550 C 631.093,461.339 621.848,464.224 608.217,464.788 C 587.580,465.642 573.088,460.230 559.429,446.571 C 550.521,437.663 545.570,429.081 542.352,416.968 C 540.042,408.273 540.027,389.837 542.322,381 C 548.423,357.512 565.289,340.301 588,334.388 C 596.625,332.143 613.350,332.135 621.928,334.373 C 631.105,336.767 640.468,341.661 646.611,347.275 C 652.865,352.991 660.217,363.569 659.796,366.247 C 659.594,367.534 656.997,369.216 651.583,371.565 C 647.229,373.454 643.178,375 642.581,375 C 641.984,375 640.422,372.975 639.109,370.499 C 634.163,361.177 623.375,354.023 610.963,351.837 C 594.304,348.903 576.137,357.886 568.051,373.056 C 563.539,381.521 562.026,387.907 562.012,398.540 C 561.991,414.722 566.382,425.510 576.990,435.331 C 584.699,442.468 591.621,445.227 603.201,445.780 C 618.135,446.493 630.041,440.788 638.282,428.971 C 640.380,425.962 642.530,423.348 643.061,423.162 C 643.849,422.886 657.542,428.075 660.250,429.675 Z"];

package/dist/booklet/index.d.ts

@@ -0,0 +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 { 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 { 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;