@unlev/exeq 0.5.6 → 0.6.0

package/dist/index.d.mts

@@ -1,76 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { PDFDocument } from 'pdf-lib';
-
-declare function generateId(): string;
-type FieldType = 'text' | 'dropdown' | 'signature' | 'signed-date' | 'checkbox' | 'initials' | 'blackout' | 'whiteout';
-type TextSubtype = 'freeform' | 'number' | 'date' | 'email' | 'phone';
-interface FormField {
-    id: string;
-    type: FieldType;
-    textSubtype?: TextSubtype;
-    label: string;
-    placeholder: string;
-    required: boolean;
-    assignee: string;
-    page: number;
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    fontSize: number;
-    value: string;
-    inkColor?: string;
-    letterSpacing?: number;
-    lineHeight?: number;
-    align?: 'left' | 'center' | 'right';
-    bold?: boolean;
-    italic?: boolean;
-    underline?: boolean;
-    strikethrough?: boolean;
-    minLength?: number;
-    maxLength?: number;
-    fontFamily?: string;
-    options?: string[];
-    formula?: string;
-    locked?: boolean;
-    autoShrink?: boolean;
-}
-interface Template {
-    fields: FormField[];
-    signerRoles: string[];
-    pdfUrl: string;
-}
-declare const DEFAULT_SIGNER_ROLES: string[];
-declare const SIGNER_ROLE_COLORS: Record<string, string>;
-declare function getSignerColor(role: string): string;
-declare function isRedactField(f: FormField | {
-    type: FieldType;
-}): boolean;
-declare function isSignatureField(f: FormField | {
-    type: FieldType;
-}): boolean;
-declare function isTextLikeField(f: FormField | {
-    type: FieldType;
-}): boolean;
-declare function getInputType(subtype?: TextSubtype): string;
-declare function getCssFontFamily(fontFamily?: string): string | undefined;
-declare function sortFieldsByPosition(fields: FormField[]): FormField[];
-declare function preserveFieldValues(oldFields: FormField[], newFields: FormField[]): FormField[];
-declare function getFieldValues(fields: FormField[]): Record<string, string>;
-declare const FONT_FAMILIES: readonly [{
-    readonly value: "Helvetica";
-    readonly label: "Helvetica";
-}, {
-    readonly value: "Courier";
-    readonly label: "Courier New";
-}, {
-    readonly value: "TimesRoman";
-    readonly label: "Times New Roman";
-}];
-declare const FIELD_DEFAULTS: Record<FieldType, Partial<FormField>>;
-/** Given a desired label and a list of existing labels, return a unique label by appending a number if needed. */
-declare function uniqueLabel(desired: string, existingLabels: string[]): string;
-declare function createField(type: FieldType, assignee: string, page: number, x: number, y: number, existingFields?: FormField[]): FormField;
+import { T as Template, a as TransformMap, F as FormField, b as FieldType } from './pdfFiller-Btf-SnEB.mjs';
+export { A as A4, B as BUILTIN_TRANSFORMS, C as Calibration, c as CreatePdfBuilderOptions, D as DEFAULT_CALIBRATION, d as DEFAULT_SIGNER_ROLES, e as FIELD_DEFAULTS, f as FONT_FAMILIES, g as FillPdfOptions, P as PdfBuilder, h as PdfMetadata, S as SIGNER_ROLE_COLORS, i as TextSubtype, j as TransformFn, U as US_LEGAL, k as US_LETTER, l as applyCalibration, m as createField, n as createPdfBuilder, o as downloadPdf, p as generateFilledPdf, q as generateId, r as getCssFontFamily, s as getFieldValues, t as getInputType, u as getSignerColor, v as isRedactField, w as isSignatureField, x as isTextLikeField, y as parseDate, z as postPdfToCallback, E as preserveFieldValues, G as resolveAllFormulas, H as resolveFormula, I as sortFieldsByPosition, J as uniqueLabel } from './pdfFiller-Btf-SnEB.mjs';
+import 'pdf-lib';
 
 interface DesignerViewProps {
     /** API key for authentication */
@@ -94,42 +25,6 @@ interface DesignerViewProps {
 }
 declare function DesignerView({ apiKey, initialPdfUrl, initialTemplate, onSave, onChange, hideHeader, headerPortalRef, }?: DesignerViewProps): react_jsx_runtime.JSX.Element;
 
-type TransformFn = (value: string) => string;
-type TransformMap = Record<string, TransformFn>;
-/**
- * Parse a date string robustly into a local Date (midnight, local TZ) so that
- * getMonth/getDate/getFullYear are calendar-correct. Handles:
- *  - ISO date-only "YYYY-MM-DD" → parsed as LOCAL (avoids the classic UTC
- *    off-by-one where "2024-03-15" becomes the 14th in western timezones).
- *  - Excel serial numbers (a bare integer, e.g. "45000") → converted.
- *  - Anything else → native `new Date` (handles "M/D/YYYY", ISO datetimes, …).
- * Returns null when unparseable.
- */
-declare function parseDate(value: string): Date | null;
-/** Built-in transforms that ship with exeq. */
-declare const BUILTIN_TRANSFORMS: TransformMap;
-/**
- * Resolve a single formula string against a set of fields and transforms.
- * Formula format: "{{Source Field Label | transform}}" or "{{Source Field Label}}" (no transform = raw value).
- * Multiple expressions can appear in one formula: "{{First}} {{Last}}" → "Jane Smith"
- *
- * Source resolution order for "{{Name}}":
- *   1. a placed field whose label (case-insensitive) or id matches Name
- *   2. `values[Name]` — imported/contextual data not tied to a placed field
- *   3. the built-in `today` / `now` source (current date)
- *
- * @param values Extra named values (e.g. imported CSV/form data) made available
- *   to formula sources even when there is no placed field for them.
- */
-declare function resolveFormula(formula: string, fields: FormField[], customTransforms?: TransformMap, values?: Record<string, string>): string;
-/**
- * Resolve all formula fields in a fields array.
- * Returns a new array with computed values filled in.
- *
- * @param values Extra named values available to formula sources (see resolveFormula).
- */
-declare function resolveAllFormulas(fields: FormField[], customTransforms?: TransformMap, values?: Record<string, string>): FormField[];
-
 interface SignerViewProps {
     /** API key for authentication */
     apiKey?: string;
@@ -240,124 +135,4 @@ interface SignerRoleSelectorProps {
 }
 declare function SignerRoleSelector({ roles, activeRole, onSetActiveRole, onAddRole, onRemoveRole, }: SignerRoleSelectorProps): react_jsx_runtime.JSX.Element;
 
-/** US Letter in PDF points (72pt = 1 in). */
-declare const US_LETTER: [number, number];
-/** US Legal in PDF points. */
-declare const US_LEGAL: [number, number];
-/** A4 in PDF points. */
-declare const A4: [number, number];
-/**
- * Linear calibration applied to every field's percentage position and size.
- * Use to align rendered output with a physical pre-printed form when the
- * template's source PDF and the real paper don't exactly agree on crop or
- * scale.
- *
- * Math (for an output page of size [pW, pH] pt):
- *   xPctOff = (xOffset / pW) * 100
- *   yPctOff = (yOffset / pH) * 100
- *   x' = x_pct * xScale + xPctOff
- *   y' = y_pct * yScale + yPctOff
- *   width'  = width_pct  * xScale
- *   height' = height_pct * yScale
- *
- * Defaults (scale=1, offsets=0) are a no-op.
- */
-interface Calibration {
-    /** Horizontal offset in PDF points; positive = right. */
-    xOffset: number;
-    /** Vertical offset in PDF points; positive = down (screen coords). */
-    yOffset: number;
-    /** Horizontal multiplier applied to x and width. */
-    xScale: number;
-    /** Vertical multiplier applied to y and height. */
-    yScale: number;
-}
-declare const DEFAULT_CALIBRATION: Calibration;
-/**
- * Returns a copy of `fields` with calibration applied to x / y / width /
- * height. The math is page-size-aware so an `xOffset` of 5pt actually
- * shifts the rendered output 5pt to the right.
- *
- * @param pageSize Output page size in pt used to convert pt offsets to
- *   percent offsets. Defaults to US Letter.
- */
-declare function applyCalibration(fields: FormField[], calibration: Calibration, pageSize?: [number, number]): FormField[];
-interface FillPdfOptions {
-    /** Source PDF used as the background.
-     *  - `string` (URL): fetched, embedded once per URL across the document.
-     *  - `ArrayBuffer`: embedded uniquely each call.
-     *  - `null`: render onto blank pages (overlay-only output). */
-    pdfSource: string | ArrayBuffer | null;
-    /** Fields to render on top of the background. */
-    fields: FormField[];
-    /** Override the output page size in PDF points.
-     *  - With a `pdfSource`, source pages are drawn stretched to fit.
-     *  - With `pdfSource: null`, blank pages of this size are created.
-     *  - When omitted with a source, output uses the source's page sizes.
-     *  - When omitted with `pdfSource: null`, defaults to US Letter. */
-    pageSize?: [number, number];
-    /** When `pdfSource` is null, how many blank pages to render. Default `1`.
-     * Fields with out-of-range `page` indices are skipped. */
-    pageCount?: number;
-    /** Run `resolveAllFormulas` on fields before rendering. */
-    resolveFormulas?: boolean;
-    /** Custom transforms merged with `BUILTIN_TRANSFORMS` during formula
-     * resolution. Only meaningful when `resolveFormulas` is true. */
-    customTransforms?: TransformMap;
-    /** Extra named values made available to formula sources (e.g. imported CSV/
-     * form data) even when there is no placed field for them. Only meaningful
-     * when `resolveFormulas` is true. */
-    formulaValues?: Record<string, string>;
-    /** Linear calibration applied to field positions before rendering. */
-    calibration?: Calibration;
-}
-/**
- * Generates one filled PDF.
- *
- *   const bytes = await generateFilledPdf({
- *     pdfSource: '/forms/template.pdf',
- *     fields: template.fields,
- *     pageSize: US_LETTER,
- *     resolveFormulas: true,
- *   });
- *
- * For multi-record output that shares a background, use `createPdfBuilder`
- * — it dedupes the embedded source across all pages.
- */
-declare function generateFilledPdf(opts: FillPdfOptions): Promise<Uint8Array>;
-interface PdfBuilder {
-    /** Underlying pdf-lib document — exposed for advanced post-processing
-     * (audit-trail pages, custom metadata, etc.). */
-    readonly doc: PDFDocument;
-    /** Append one record's pages to the output. */
-    addRecord(opts: FillPdfOptions): Promise<void>;
-    /** Finalize and return the merged PDF bytes. */
-    save(): Promise<Uint8Array>;
-}
-interface CreatePdfBuilderOptions {
-    /** Default `pageSize` for any `addRecord` call that doesn't set its own. */
-    pageSize?: [number, number];
-}
-/**
- * Creates a builder that merges multiple filled records into one PDF.
- *
- * Resources (source PDFs indexed by URL, embedded fonts, signature PNGs) are
- * embedded once across the whole document and reused — critical for
- * mail-merge style batches where dozens of records share the same background.
- *
- *   const builder = await createPdfBuilder({ pageSize: US_LETTER });
- *   for (const record of records) {
- *     await builder.addRecord({
- *       pdfSource: '/forms/template.pdf',
- *       fields: record.fields,
- *       resolveFormulas: true,
- *     });
- *   }
- *   const bytes = await builder.save();
- *   downloadPdf(bytes, 'merged.pdf');
- */
-declare function createPdfBuilder(defaults?: CreatePdfBuilderOptions): Promise<PdfBuilder>;
-declare function downloadPdf(bytes: Uint8Array, filename: string): void;
-declare function postPdfToCallback(bytes: Uint8Array, callbackUrl: string, filename: string): Promise<void>;
-
-export { A4, BUILTIN_TRANSFORMS, type Calibration, type CreatePdfBuilderOptions, DEFAULT_CALIBRATION, DEFAULT_SIGNER_ROLES, DesignerView, type DesignerViewProps, FIELD_DEFAULTS, FONT_FAMILIES, FieldNavigator, FieldPropertyPanel, type FieldType, type FillPdfOptions, type FormField, type PdfBuilder, PdfViewer, type RenderedPage, SIGNER_ROLE_COLORS, SignatureCanvas, SignerRoleSelector, SignerView, type SignerViewProps, type Template, type TextSubtype, type TransformFn, type TransformMap, US_LEGAL, US_LETTER, applyCalibration, createField, createPdfBuilder, downloadPdf, generateFilledPdf, generateId, getCssFontFamily, getFieldValues, getInputType, getSignerColor, isRedactField, isSignatureField, isTextLikeField, parseDate, postPdfToCallback, preserveFieldValues, renderPdfPages, resolveAllFormulas, resolveFormula, sortFieldsByPosition, uniqueLabel };
+export { DesignerView, type DesignerViewProps, FieldNavigator, FieldPropertyPanel, FieldType, FormField, PdfViewer, type RenderedPage, SignatureCanvas, SignerRoleSelector, SignerView, type SignerViewProps, Template, TransformMap, renderPdfPages };

package/dist/index.d.ts

@@ -1,76 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { PDFDocument } from 'pdf-lib';
-
-declare function generateId(): string;
-type FieldType = 'text' | 'dropdown' | 'signature' | 'signed-date' | 'checkbox' | 'initials' | 'blackout' | 'whiteout';
-type TextSubtype = 'freeform' | 'number' | 'date' | 'email' | 'phone';
-interface FormField {
-    id: string;
-    type: FieldType;
-    textSubtype?: TextSubtype;
-    label: string;
-    placeholder: string;
-    required: boolean;
-    assignee: string;
-    page: number;
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    fontSize: number;
-    value: string;
-    inkColor?: string;
-    letterSpacing?: number;
-    lineHeight?: number;
-    align?: 'left' | 'center' | 'right';
-    bold?: boolean;
-    italic?: boolean;
-    underline?: boolean;
-    strikethrough?: boolean;
-    minLength?: number;
-    maxLength?: number;
-    fontFamily?: string;
-    options?: string[];
-    formula?: string;
-    locked?: boolean;
-    autoShrink?: boolean;
-}
-interface Template {
-    fields: FormField[];
-    signerRoles: string[];
-    pdfUrl: string;
-}
-declare const DEFAULT_SIGNER_ROLES: string[];
-declare const SIGNER_ROLE_COLORS: Record<string, string>;
-declare function getSignerColor(role: string): string;
-declare function isRedactField(f: FormField | {
-    type: FieldType;
-}): boolean;
-declare function isSignatureField(f: FormField | {
-    type: FieldType;
-}): boolean;
-declare function isTextLikeField(f: FormField | {
-    type: FieldType;
-}): boolean;
-declare function getInputType(subtype?: TextSubtype): string;
-declare function getCssFontFamily(fontFamily?: string): string | undefined;
-declare function sortFieldsByPosition(fields: FormField[]): FormField[];
-declare function preserveFieldValues(oldFields: FormField[], newFields: FormField[]): FormField[];
-declare function getFieldValues(fields: FormField[]): Record<string, string>;
-declare const FONT_FAMILIES: readonly [{
-    readonly value: "Helvetica";
-    readonly label: "Helvetica";
-}, {
-    readonly value: "Courier";
-    readonly label: "Courier New";
-}, {
-    readonly value: "TimesRoman";
-    readonly label: "Times New Roman";
-}];
-declare const FIELD_DEFAULTS: Record<FieldType, Partial<FormField>>;
-/** Given a desired label and a list of existing labels, return a unique label by appending a number if needed. */
-declare function uniqueLabel(desired: string, existingLabels: string[]): string;
-declare function createField(type: FieldType, assignee: string, page: number, x: number, y: number, existingFields?: FormField[]): FormField;
+import { T as Template, a as TransformMap, F as FormField, b as FieldType } from './pdfFiller-Btf-SnEB.js';
+export { A as A4, B as BUILTIN_TRANSFORMS, C as Calibration, c as CreatePdfBuilderOptions, D as DEFAULT_CALIBRATION, d as DEFAULT_SIGNER_ROLES, e as FIELD_DEFAULTS, f as FONT_FAMILIES, g as FillPdfOptions, P as PdfBuilder, h as PdfMetadata, S as SIGNER_ROLE_COLORS, i as TextSubtype, j as TransformFn, U as US_LEGAL, k as US_LETTER, l as applyCalibration, m as createField, n as createPdfBuilder, o as downloadPdf, p as generateFilledPdf, q as generateId, r as getCssFontFamily, s as getFieldValues, t as getInputType, u as getSignerColor, v as isRedactField, w as isSignatureField, x as isTextLikeField, y as parseDate, z as postPdfToCallback, E as preserveFieldValues, G as resolveAllFormulas, H as resolveFormula, I as sortFieldsByPosition, J as uniqueLabel } from './pdfFiller-Btf-SnEB.js';
+import 'pdf-lib';
 
 interface DesignerViewProps {
     /** API key for authentication */
@@ -94,42 +25,6 @@ interface DesignerViewProps {
 }
 declare function DesignerView({ apiKey, initialPdfUrl, initialTemplate, onSave, onChange, hideHeader, headerPortalRef, }?: DesignerViewProps): react_jsx_runtime.JSX.Element;
 
-type TransformFn = (value: string) => string;
-type TransformMap = Record<string, TransformFn>;
-/**
- * Parse a date string robustly into a local Date (midnight, local TZ) so that
- * getMonth/getDate/getFullYear are calendar-correct. Handles:
- *  - ISO date-only "YYYY-MM-DD" → parsed as LOCAL (avoids the classic UTC
- *    off-by-one where "2024-03-15" becomes the 14th in western timezones).
- *  - Excel serial numbers (a bare integer, e.g. "45000") → converted.
- *  - Anything else → native `new Date` (handles "M/D/YYYY", ISO datetimes, …).
- * Returns null when unparseable.
- */
-declare function parseDate(value: string): Date | null;
-/** Built-in transforms that ship with exeq. */
-declare const BUILTIN_TRANSFORMS: TransformMap;
-/**
- * Resolve a single formula string against a set of fields and transforms.
- * Formula format: "{{Source Field Label | transform}}" or "{{Source Field Label}}" (no transform = raw value).
- * Multiple expressions can appear in one formula: "{{First}} {{Last}}" → "Jane Smith"
- *
- * Source resolution order for "{{Name}}":
- *   1. a placed field whose label (case-insensitive) or id matches Name
- *   2. `values[Name]` — imported/contextual data not tied to a placed field
- *   3. the built-in `today` / `now` source (current date)
- *
- * @param values Extra named values (e.g. imported CSV/form data) made available
- *   to formula sources even when there is no placed field for them.
- */
-declare function resolveFormula(formula: string, fields: FormField[], customTransforms?: TransformMap, values?: Record<string, string>): string;
-/**
- * Resolve all formula fields in a fields array.
- * Returns a new array with computed values filled in.
- *
- * @param values Extra named values available to formula sources (see resolveFormula).
- */
-declare function resolveAllFormulas(fields: FormField[], customTransforms?: TransformMap, values?: Record<string, string>): FormField[];
-
 interface SignerViewProps {
     /** API key for authentication */
     apiKey?: string;
@@ -240,124 +135,4 @@ interface SignerRoleSelectorProps {
 }
 declare function SignerRoleSelector({ roles, activeRole, onSetActiveRole, onAddRole, onRemoveRole, }: SignerRoleSelectorProps): react_jsx_runtime.JSX.Element;
 
-/** US Letter in PDF points (72pt = 1 in). */
-declare const US_LETTER: [number, number];
-/** US Legal in PDF points. */
-declare const US_LEGAL: [number, number];
-/** A4 in PDF points. */
-declare const A4: [number, number];
-/**
- * Linear calibration applied to every field's percentage position and size.
- * Use to align rendered output with a physical pre-printed form when the
- * template's source PDF and the real paper don't exactly agree on crop or
- * scale.
- *
- * Math (for an output page of size [pW, pH] pt):
- *   xPctOff = (xOffset / pW) * 100
- *   yPctOff = (yOffset / pH) * 100
- *   x' = x_pct * xScale + xPctOff
- *   y' = y_pct * yScale + yPctOff
- *   width'  = width_pct  * xScale
- *   height' = height_pct * yScale
- *
- * Defaults (scale=1, offsets=0) are a no-op.
- */
-interface Calibration {
-    /** Horizontal offset in PDF points; positive = right. */
-    xOffset: number;
-    /** Vertical offset in PDF points; positive = down (screen coords). */
-    yOffset: number;
-    /** Horizontal multiplier applied to x and width. */
-    xScale: number;
-    /** Vertical multiplier applied to y and height. */
-    yScale: number;
-}
-declare const DEFAULT_CALIBRATION: Calibration;
-/**
- * Returns a copy of `fields` with calibration applied to x / y / width /
- * height. The math is page-size-aware so an `xOffset` of 5pt actually
- * shifts the rendered output 5pt to the right.
- *
- * @param pageSize Output page size in pt used to convert pt offsets to
- *   percent offsets. Defaults to US Letter.
- */
-declare function applyCalibration(fields: FormField[], calibration: Calibration, pageSize?: [number, number]): FormField[];
-interface FillPdfOptions {
-    /** Source PDF used as the background.
-     *  - `string` (URL): fetched, embedded once per URL across the document.
-     *  - `ArrayBuffer`: embedded uniquely each call.
-     *  - `null`: render onto blank pages (overlay-only output). */
-    pdfSource: string | ArrayBuffer | null;
-    /** Fields to render on top of the background. */
-    fields: FormField[];
-    /** Override the output page size in PDF points.
-     *  - With a `pdfSource`, source pages are drawn stretched to fit.
-     *  - With `pdfSource: null`, blank pages of this size are created.
-     *  - When omitted with a source, output uses the source's page sizes.
-     *  - When omitted with `pdfSource: null`, defaults to US Letter. */
-    pageSize?: [number, number];
-    /** When `pdfSource` is null, how many blank pages to render. Default `1`.
-     * Fields with out-of-range `page` indices are skipped. */
-    pageCount?: number;
-    /** Run `resolveAllFormulas` on fields before rendering. */
-    resolveFormulas?: boolean;
-    /** Custom transforms merged with `BUILTIN_TRANSFORMS` during formula
-     * resolution. Only meaningful when `resolveFormulas` is true. */
-    customTransforms?: TransformMap;
-    /** Extra named values made available to formula sources (e.g. imported CSV/
-     * form data) even when there is no placed field for them. Only meaningful
-     * when `resolveFormulas` is true. */
-    formulaValues?: Record<string, string>;
-    /** Linear calibration applied to field positions before rendering. */
-    calibration?: Calibration;
-}
-/**
- * Generates one filled PDF.
- *
- *   const bytes = await generateFilledPdf({
- *     pdfSource: '/forms/template.pdf',
- *     fields: template.fields,
- *     pageSize: US_LETTER,
- *     resolveFormulas: true,
- *   });
- *
- * For multi-record output that shares a background, use `createPdfBuilder`
- * — it dedupes the embedded source across all pages.
- */
-declare function generateFilledPdf(opts: FillPdfOptions): Promise<Uint8Array>;
-interface PdfBuilder {
-    /** Underlying pdf-lib document — exposed for advanced post-processing
-     * (audit-trail pages, custom metadata, etc.). */
-    readonly doc: PDFDocument;
-    /** Append one record's pages to the output. */
-    addRecord(opts: FillPdfOptions): Promise<void>;
-    /** Finalize and return the merged PDF bytes. */
-    save(): Promise<Uint8Array>;
-}
-interface CreatePdfBuilderOptions {
-    /** Default `pageSize` for any `addRecord` call that doesn't set its own. */
-    pageSize?: [number, number];
-}
-/**
- * Creates a builder that merges multiple filled records into one PDF.
- *
- * Resources (source PDFs indexed by URL, embedded fonts, signature PNGs) are
- * embedded once across the whole document and reused — critical for
- * mail-merge style batches where dozens of records share the same background.
- *
- *   const builder = await createPdfBuilder({ pageSize: US_LETTER });
- *   for (const record of records) {
- *     await builder.addRecord({
- *       pdfSource: '/forms/template.pdf',
- *       fields: record.fields,
- *       resolveFormulas: true,
- *     });
- *   }
- *   const bytes = await builder.save();
- *   downloadPdf(bytes, 'merged.pdf');
- */
-declare function createPdfBuilder(defaults?: CreatePdfBuilderOptions): Promise<PdfBuilder>;
-declare function downloadPdf(bytes: Uint8Array, filename: string): void;
-declare function postPdfToCallback(bytes: Uint8Array, callbackUrl: string, filename: string): Promise<void>;
-
-export { A4, BUILTIN_TRANSFORMS, type Calibration, type CreatePdfBuilderOptions, DEFAULT_CALIBRATION, DEFAULT_SIGNER_ROLES, DesignerView, type DesignerViewProps, FIELD_DEFAULTS, FONT_FAMILIES, FieldNavigator, FieldPropertyPanel, type FieldType, type FillPdfOptions, type FormField, type PdfBuilder, PdfViewer, type RenderedPage, SIGNER_ROLE_COLORS, SignatureCanvas, SignerRoleSelector, SignerView, type SignerViewProps, type Template, type TextSubtype, type TransformFn, type TransformMap, US_LEGAL, US_LETTER, applyCalibration, createField, createPdfBuilder, downloadPdf, generateFilledPdf, generateId, getCssFontFamily, getFieldValues, getInputType, getSignerColor, isRedactField, isSignatureField, isTextLikeField, parseDate, postPdfToCallback, preserveFieldValues, renderPdfPages, resolveAllFormulas, resolveFormula, sortFieldsByPosition, uniqueLabel };
+export { DesignerView, type DesignerViewProps, FieldNavigator, FieldPropertyPanel, FieldType, FormField, PdfViewer, type RenderedPage, SignatureCanvas, SignerRoleSelector, SignerView, type SignerViewProps, Template, TransformMap, renderPdfPages };

package/dist/index.js

@@ -2253,6 +2253,20 @@ var BUILTIN_TRANSFORMS = {
     return parts[parts.length - 1] || "";
   },
   initials: (v) => v.split(/\s+/).map((w) => w[0] || "").join("").toUpperCase(),
+  // Name parts. Handles "Last, First [Middle]" (comma form) and "First [Middle]
+  // Last" (no comma). firstName → the given name(s); lastName → the surname.
+  firstName: (v) => {
+    const c = v.indexOf(",");
+    if (c >= 0) return v.slice(c + 1).trim();
+    const parts = v.trim().split(/\s+/).filter(Boolean);
+    return parts.length > 1 ? parts.slice(0, -1).join(" ") : parts[0] || "";
+  },
+  lastName: (v) => {
+    const c = v.indexOf(",");
+    if (c >= 0) return v.slice(0, c).trim();
+    const parts = v.trim().split(/\s+/).filter(Boolean);
+    return parts.length > 1 ? parts[parts.length - 1] : parts[0] || "";
+  },
   // Numeric / substring
   last4: (v) => v.slice(-4),
   last2: (v) => v.slice(-2),
@@ -2477,11 +2491,24 @@ async function renderFieldsOnPages(pages, fields, getFont, getSignature) {
     }
   }
 }
-async function generateFilledPdf(opts) {
-  const builder = await createPdfBuilder({ pageSize: opts.pageSize });
+async function generateFilledPdf(opts, builderOptions) {
+  const builder = await createPdfBuilder({
+    pageSize: opts.pageSize,
+    metadata: builderOptions?.metadata
+  });
   await builder.addRecord(opts);
   return builder.save();
 }
+function applyMetadata(doc, m) {
+  if (!m) return;
+  if (m.title !== void 0) doc.setTitle(m.title);
+  if (m.author !== void 0) doc.setAuthor(m.author);
+  if (m.subject !== void 0) doc.setSubject(m.subject);
+  if (m.creator !== void 0) doc.setCreator(m.creator);
+  if (m.producer !== void 0) doc.setProducer(m.producer);
+  if (m.creationDate !== void 0) doc.setCreationDate(m.creationDate);
+  if (m.modificationDate !== void 0) doc.setModificationDate(m.modificationDate);
+}
 async function createPdfBuilder(defaults = {}) {
   const doc = await import_pdf_lib.PDFDocument.create();
   const fontCache = /* @__PURE__ */ new Map();
@@ -2566,6 +2593,7 @@ async function createPdfBuilder(defaults = {}) {
       await renderFieldsOnPages(newPages, fields, getFont, getSignature);
     },
     async save() {
+      applyMetadata(doc, defaults.metadata);
       return doc.save();
     }
   };
@@ -2989,8 +3017,13 @@ ${row.join(",")}`, "csv");
     if (isRedactField(field)) {
       return null;
     }
+    const textStyle = {
+      letterSpacing: field.letterSpacing ? `${field.letterSpacing}pt` : void 0,
+      lineHeight: field.lineHeight ? `${field.lineHeight}` : void 0,
+      ...getCssTextStyle(field)
+    };
     if (field.formula) {
-      return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(FitText, { maxPt: field.fontSize, shrink: !!field.autoShrink, className: "field-overlay-value formula", style: getCssTextStyle(field), children: field.value || "" });
+      return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(FitText, { maxPt: field.fontSize, shrink: !!field.autoShrink, className: "field-overlay-value formula", style: textStyle, children: field.value || "" });
     }
     const editable = field.assignee === signer;
     if (!editable) {
@@ -3000,7 +3033,7 @@ ${row.join(",")}`, "csv");
       if (field.type === "checkbox") {
         return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("div", { className: "field-checkbox-display readonly", children: field.value === "true" ? "\u2713" : "" });
       }
-      return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(FitText, { maxPt: field.fontSize, shrink: !!field.autoShrink, className: "field-overlay-placeholder readonly", style: getCssTextStyle(field), children: field.value || field.placeholder });
+      return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(FitText, { maxPt: field.fontSize, shrink: !!field.autoShrink, className: "field-overlay-placeholder readonly", style: textStyle, children: field.value || field.placeholder });
     }
     if (isSignatureField(field)) {
       if (field.value) {
@@ -3022,13 +3055,8 @@ ${row.join(",")}`, "csv");
       );
     }
     if (field.type === "signed-date") {
-      return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(FitText, { maxPt: field.fontSize, shrink: !!field.autoShrink, className: "field-overlay-value", style: getCssTextStyle(field), children: field.value || (/* @__PURE__ */ new Date()).toLocaleDateString() });
+      return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(FitText, { maxPt: field.fontSize, shrink: !!field.autoShrink, className: "field-overlay-value", style: textStyle, children: field.value || (/* @__PURE__ */ new Date()).toLocaleDateString() });
     }
-    const fontStyle = {
-      letterSpacing: field.letterSpacing ? `${field.letterSpacing}pt` : void 0,
-      lineHeight: field.lineHeight ? `${field.lineHeight}` : void 0,
-      ...getCssTextStyle(field)
-    };
     if (field.type === "dropdown" || field.options && field.options.length > 0) {
       return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
         "select",
@@ -3038,7 +3066,7 @@ ${row.join(",")}`, "csv");
           onChange: (e) => handleFieldUpdate(field.id, e.target.value),
           onFocus: () => setSelectedFieldId(field.id),
           onClick: (e) => e.stopPropagation(),
-          style: { fontSize: `${field.fontSize}pt`, ...fontStyle },
+          style: { fontSize: `${field.fontSize}pt`, ...textStyle },
           children: [
             /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("option", { value: "", children: field.placeholder || "Select..." }),
             (field.options || []).map((opt) => /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("option", { value: opt, children: opt }, opt))
@@ -3059,7 +3087,7 @@ ${row.join(",")}`, "csv");
         onChange: (e) => handleFieldUpdate(field.id, e.target.value),
         onFocus: () => setSelectedFieldId(field.id),
         onClick: (e) => e.stopPropagation(),
-        style: fontStyle
+        style: textStyle
       }
     );
   }, [signer, handleFieldUpdate, setSelectedFieldId]);