postext-pdf 1.70.5 → 1.71.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/README.md +1 -1
  2. package/dist/__tests__/formFonts.test.d.ts +2 -0
  3. package/dist/__tests__/formFonts.test.d.ts.map +1 -0
  4. package/dist/__tests__/formFonts.test.js +210 -0
  5. package/dist/__tests__/formFonts.test.js.map +1 -0
  6. package/dist/__tests__/forms.test.d.ts +2 -0
  7. package/dist/__tests__/forms.test.d.ts.map +1 -0
  8. package/dist/__tests__/forms.test.js +289 -0
  9. package/dist/__tests__/forms.test.js.map +1 -0
  10. package/dist/__tests__/strikethrough.test.d.ts +2 -0
  11. package/dist/__tests__/strikethrough.test.d.ts.map +1 -0
  12. package/dist/__tests__/strikethrough.test.js +106 -0
  13. package/dist/__tests__/strikethrough.test.js.map +1 -0
  14. package/dist/fontCache.d.ts +10 -0
  15. package/dist/fontCache.d.ts.map +1 -1
  16. package/dist/fontCache.js +25 -0
  17. package/dist/fontCache.js.map +1 -1
  18. package/dist/index.d.ts +1 -1
  19. package/dist/index.d.ts.map +1 -1
  20. package/dist/index.js.map +1 -1
  21. package/dist/pdf-backend/blocks/blockRender.d.ts +4 -0
  22. package/dist/pdf-backend/blocks/blockRender.d.ts.map +1 -1
  23. package/dist/pdf-backend/blocks/blockRender.js.map +1 -1
  24. package/dist/pdf-backend/blocks/chip.d.ts +4 -1
  25. package/dist/pdf-backend/blocks/chip.d.ts.map +1 -1
  26. package/dist/pdf-backend/blocks/chip.js +38 -1
  27. package/dist/pdf-backend/blocks/chip.js.map +1 -1
  28. package/dist/pdf-backend/formFonts.d.ts +39 -0
  29. package/dist/pdf-backend/formFonts.d.ts.map +1 -0
  30. package/dist/pdf-backend/formFonts.js +159 -0
  31. package/dist/pdf-backend/formFonts.js.map +1 -0
  32. package/dist/pdf-backend/forms.d.ts +49 -0
  33. package/dist/pdf-backend/forms.d.ts.map +1 -0
  34. package/dist/pdf-backend/forms.js +260 -0
  35. package/dist/pdf-backend/forms.js.map +1 -0
  36. package/dist/pdf-backend/index.d.ts +10 -1
  37. package/dist/pdf-backend/index.d.ts.map +1 -1
  38. package/dist/pdf-backend/index.js +16 -1
  39. package/dist/pdf-backend/index.js.map +1 -1
  40. package/dist/pdf-backend/primitives.d.ts +6 -0
  41. package/dist/pdf-backend/primitives.d.ts.map +1 -1
  42. package/dist/pdf-backend/primitives.js.map +1 -1
  43. package/dist/pdf-backend/renderToPdf/paintPage.d.ts.map +1 -1
  44. package/dist/pdf-backend/renderToPdf/paintPage.js +2 -0
  45. package/dist/pdf-backend/renderToPdf/paintPage.js.map +1 -1
  46. package/dist/pdf-backend/renderToPdf/warnings.d.ts +7 -1
  47. package/dist/pdf-backend/renderToPdf/warnings.d.ts.map +1 -1
  48. package/dist/pdf-backend/renderToPdf/warnings.js.map +1 -1
  49. package/package.json +3 -3
@@ -0,0 +1,159 @@
1
+ /**
2
+ * The faces form fields show and take their values in (#1445). A field's
3
+ * face is embedded whole: someone filling the form in types characters the
4
+ * file was not written with, and a subset would have no glyph for them.
5
+ * Each face is embedded once, whatever the number of fields set in it, and
6
+ * named in the AcroForm's default resources (`/DR`) for the fields' default
7
+ * appearance (`/DA`). Helvetica stands in when a face cannot be embedded
8
+ * whole (a licence that forbids it, a file given in slices, a format
9
+ * pdf-lib cannot write whole), with a warning.
10
+ */
11
+ import { PDFDict, PDFName, StandardFonts } from 'pdf-lib';
12
+ import { parseFontString } from '../fontString.js';
13
+ import { isCffOpenType, coverAllGlyphWidths } from '../fontCache/glyphTables.js';
14
+ import { declareCffProgram } from '../fontCache/cffProgram.js';
15
+ import { decompressWoff2 } from '../woff2.js';
16
+ /** The OS/2 `fsType` bits that forbid embedding the outlines: a restricted
17
+ * licence (bit 1), or bitmaps only (bit 9). */
18
+ const NOT_EMBEDDABLE = 0x0002 | 0x0200;
19
+ /** Big-endian reads of a font file. */
20
+ const u16 = (b, at) => (b[at] << 8) | b[at + 1];
21
+ const u32 = (b, at) => ((b[at] << 24) >>> 0) + (b[at + 1] << 16) + (b[at + 2] << 8) + b[at + 3];
22
+ const tag = (b, at) => String.fromCharCode(b[at], b[at + 1], b[at + 2], b[at + 3]);
23
+ /** The file's OS/2 `fsType`, 0 (installable) when it has no OS/2 table. */
24
+ export function embeddingFlags(bytes) {
25
+ if (bytes.length < 12)
26
+ return 0;
27
+ const tables = u16(bytes, 4);
28
+ for (let i = 0; i < tables; i++) {
29
+ const at = 12 + i * 16;
30
+ if (at + 16 > bytes.length)
31
+ break;
32
+ if (tag(bytes, at) !== 'OS/2')
33
+ continue;
34
+ const offset = u32(bytes, at + 8);
35
+ return offset + 10 <= bytes.length ? u16(bytes, offset + 8) : 0;
36
+ }
37
+ return 0;
38
+ }
39
+ /** A file pdf-lib writes whole as it is: TrueType or CFF OpenType. A WOFF2
40
+ * file is decompressed first; anything else (WOFF, a collection) is not. */
41
+ async function sfntOf(bytes) {
42
+ const magic = bytes.length >= 4 ? tag(bytes, 0) : '';
43
+ if (magic === 'wOF2')
44
+ return decompressWoff2(bytes);
45
+ if (magic === '\0\x01\0\0' || magic === 'true' || magic === 'OTTO')
46
+ return bytes;
47
+ if (magic === 'wOFF')
48
+ return 'a WOFF file (give TrueType, OpenType or WOFF2)';
49
+ if (magic === 'ttcf')
50
+ return 'a font collection';
51
+ return 'not a font file pdf-lib can embed';
52
+ }
53
+ /** A ToUnicode map over every character the face's cmap reaches, so text
54
+ * typed into a field reads back (pdf-lib maps only the glyphs it drew). */
55
+ function coverWholeCmap(font) {
56
+ const embedder = font.embedder;
57
+ if (!embedder)
58
+ return;
59
+ const access = embedder.glyphCache.access.bind(embedder.glyphCache);
60
+ embedder.glyphCache.access = () => {
61
+ const glyphs = [...access()];
62
+ const known = new Set(glyphs.map((g) => g.id));
63
+ for (const cp of embedder.font.characterSet) {
64
+ const id = embedder.font.glyphForCodePoint(cp).id;
65
+ if (id === 0 || known.has(id))
66
+ continue;
67
+ known.add(id);
68
+ glyphs.push({ id, codePoints: [cp] });
69
+ }
70
+ return glyphs;
71
+ };
72
+ }
73
+ export class FormFonts {
74
+ pdfDoc;
75
+ fontCache;
76
+ option;
77
+ warn;
78
+ /** One embed per face (font key), shared by every field set in it. */
79
+ faces = new Map();
80
+ helvetica;
81
+ constructor(pdfDoc, fontCache, option, warn) {
82
+ this.pdfDoc = pdfDoc;
83
+ this.fontCache = fontCache;
84
+ this.option = option;
85
+ this.warn = warn;
86
+ }
87
+ /** The face for a field whose chip is set in `chipFont` (a font string). */
88
+ fontFor(chipFont) {
89
+ const option = this.option ?? 'chip';
90
+ if (option === 'helvetica')
91
+ return this.fallback();
92
+ const fontString = option === 'chip'
93
+ ? chipFont
94
+ : `${option.style === 'italic' ? 'italic ' : ''}${option.weight ?? 400} 16px "${option.family}"`;
95
+ const parsed = fontString ? parseFontString(fontString) : null;
96
+ if (!parsed || !this.fontCache)
97
+ return this.fallback();
98
+ const key = `${parsed.family}|${parsed.weight}|${parsed.style}`;
99
+ let face = this.faces.get(key);
100
+ if (!face) {
101
+ face = this.embedWhole(fontString, `${parsed.family} ${parsed.weight}${parsed.style === 'italic' ? ' italic' : ''}`);
102
+ this.faces.set(key, face);
103
+ }
104
+ return face;
105
+ }
106
+ /** Name every face fields use in the AcroForm's `/DR`, where a viewer
107
+ * finds the face a field's `/DA` names. */
108
+ async register() {
109
+ const fonts = new Set(await Promise.all([...this.faces.values(), ...(this.helvetica ? [this.helvetica] : [])]));
110
+ if (fonts.size === 0)
111
+ return;
112
+ const context = this.pdfDoc.context;
113
+ const acro = this.pdfDoc.catalog.lookup(PDFName.of('AcroForm'), PDFDict);
114
+ let dr = acro.lookupMaybe(PDFName.of('DR'), PDFDict);
115
+ if (!dr) {
116
+ dr = context.obj({});
117
+ acro.set(PDFName.of('DR'), dr);
118
+ }
119
+ let named = dr.lookupMaybe(PDFName.of('Font'), PDFDict);
120
+ if (!named) {
121
+ named = context.obj({});
122
+ dr.set(PDFName.of('Font'), named);
123
+ }
124
+ for (const font of fonts)
125
+ named.set(PDFName.of(font.name), font.ref);
126
+ }
127
+ fallback() {
128
+ this.helvetica ??= this.pdfDoc.embedFont(StandardFonts.Helvetica);
129
+ return this.helvetica;
130
+ }
131
+ async embedWhole(fontString, label) {
132
+ const insteadOf = (why) => {
133
+ this.warn(`form fields are shown in Helvetica instead of ${label}: ${why}`);
134
+ return this.fallback();
135
+ };
136
+ const file = await this.fontCache.wholeFileOf(fontString);
137
+ if (!file)
138
+ return insteadOf('the font provider gives no file for it');
139
+ if (file === 'sliced')
140
+ return insteadOf('the font provider gives it in several files, and a field needs one whole face');
141
+ const bytes = await sfntOf(file.bytes);
142
+ if (typeof bytes === 'string')
143
+ return insteadOf(bytes);
144
+ if (embeddingFlags(bytes) & NOT_EMBEDDABLE)
145
+ return insteadOf('its licence (OS/2 fsType) does not allow embedding it');
146
+ try {
147
+ const font = await this.pdfDoc.embedFont(bytes, { subset: false });
148
+ if (isCffOpenType(bytes))
149
+ declareCffProgram(font, bytes);
150
+ coverAllGlyphWidths(font);
151
+ coverWholeCmap(font);
152
+ return font;
153
+ }
154
+ catch (err) {
155
+ return insteadOf(err instanceof Error ? err.message : String(err));
156
+ }
157
+ }
158
+ }
159
+ //# sourceMappingURL=formFonts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"formFonts.js","sourceRoot":"","sources":["../../src/pdf-backend/formFonts.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,49 @@
1
+ /**
2
+ * Fillable form fields (AcroForm, #1445). A chip that carries a `field`
3
+ * paints its box as any chip; its words are not painted but become the
4
+ * field's value, and the field's widget is put on the box. Fields are
5
+ * collected while the pages paint and written once every page exists, so a
6
+ * name used on several pages is one field with several widgets.
7
+ *
8
+ * Formats and calculations use Acrobat's standard scripts
9
+ * (`AFNumber_Format`, `AFNumber_Keystroke`, `AFSimple_Calculate`), which
10
+ * Acrobat, Foxit, pdf.js and most viewers run; a calculation with numbers
11
+ * or nested calculations is a short script of its own that reads the
12
+ * fields the same way (`AFMakeNumber`, anything else counts 0). The
13
+ * calculation order (`/CO`) follows the dependencies. A check box with an
14
+ * `on` value names its on state so, and a calculation reads that value
15
+ * when it is ticked. A print standard (PDF/X) allows no
16
+ * interactive fields: there the value is painted as text instead.
17
+ *
18
+ * A field shows its value in the face of its chip, embedded whole
19
+ * (`formFonts.ts`), unless the options name another or Helvetica.
20
+ */
21
+ import { type PDFDocument, type PDFPage } from 'pdf-lib';
22
+ import { type FormFieldSpec as FieldSpec, type FormNumberOptions, type FormNumberStyle } from 'postext';
23
+ import type { FormFonts, PdfFormFont } from './formFonts.js';
24
+ /** How form fields write numbers (Acrobat's separator style and the
25
+ * currency: `FormNumberOptions` of postext, which the canvas preview takes
26
+ * too) and the face they show values in. */
27
+ export interface PdfFormOptions extends FormNumberOptions {
28
+ /** The face of the fields: `'chip'` (the default) the face each field's
29
+ * chip is set in, or a face of the document's fonts by family, weight
30
+ * and style; embedded whole, once per face, so any character typed in
31
+ * has its glyph. `'helvetica'` embeds nothing. A face that cannot be
32
+ * embedded whole falls back to Helvetica with a `formField` warning. */
33
+ font?: PdfFormFont;
34
+ }
35
+ export declare class FormFieldRegistry {
36
+ private placements;
37
+ /** Warnings for the host (duplicate kinds, unknown fields in a
38
+ * calculation, a cycle). */
39
+ readonly warnings: string[];
40
+ /** Put the widget of `field` on `page` at `rect` (points, page space),
41
+ * its value shown at `sizePt`, in the face of `fontString` (the chip's)
42
+ * unless the options say otherwise. */
43
+ add(page: PDFPage, rect: [number, number, number, number], field: FieldSpec, value: string, sizePt: number, fontString?: string): void;
44
+ get size(): number;
45
+ /** Write the AcroForm, its numbers in `style`, its values in the faces
46
+ * `fonts` gives. */
47
+ finalize(pdfDoc: PDFDocument, style: FormNumberStyle, fonts: FormFonts): Promise<void>;
48
+ }
49
+ //# sourceMappingURL=forms.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"forms.d.ts","sourceRoot":"","sources":["../../src/pdf-backend/forms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAsE,KAAK,WAAW,EAAE,KAAK,OAAO,EAAiD,MAAM,SAAS,CAAC;AAC5K,OAAO,EAAiE,KAAK,aAAa,IAAI,SAAS,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AACvK,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;6CAE6C;AAC7C,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACvD;;;;6EAIyE;IACzE,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAaD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAmB;IACrC;iCAC6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAM;IAEjC;;4CAEwC;IACxC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAItI,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;yBACqB;IACf,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAkI7F"}
@@ -0,0 +1,260 @@
1
+ /**
2
+ * Fillable form fields (AcroForm, #1445). A chip that carries a `field`
3
+ * paints its box as any chip; its words are not painted but become the
4
+ * field's value, and the field's widget is put on the box. Fields are
5
+ * collected while the pages paint and written once every page exists, so a
6
+ * name used on several pages is one field with several widgets.
7
+ *
8
+ * Formats and calculations use Acrobat's standard scripts
9
+ * (`AFNumber_Format`, `AFNumber_Keystroke`, `AFSimple_Calculate`), which
10
+ * Acrobat, Foxit, pdf.js and most viewers run; a calculation with numbers
11
+ * or nested calculations is a short script of its own that reads the
12
+ * fields the same way (`AFMakeNumber`, anything else counts 0). The
13
+ * calculation order (`/CO`) follows the dependencies. A check box with an
14
+ * `on` value names its on state so, and a calculation reads that value
15
+ * when it is ticked. A print standard (PDF/X) allows no
16
+ * interactive fields: there the value is painted as text instead.
17
+ *
18
+ * A field shows its value in the face of its chip, embedded whole
19
+ * (`formFonts.ts`), unless the options name another or Helvetica.
20
+ */
21
+ import { PDFName, PDFString, PDFArray, PDFDict, PDFHexString, TextAlignment } from 'pdf-lib';
22
+ import { formatFieldNumber } from 'postext';
23
+ export class FormFieldRegistry {
24
+ placements = [];
25
+ /** Warnings for the host (duplicate kinds, unknown fields in a
26
+ * calculation, a cycle). */
27
+ warnings = [];
28
+ /** Put the widget of `field` on `page` at `rect` (points, page space),
29
+ * its value shown at `sizePt`, in the face of `fontString` (the chip's)
30
+ * unless the options say otherwise. */
31
+ add(page, rect, field, value, sizePt, fontString) {
32
+ this.placements.push({ page, rect, value, field, sizePt, ...(fontString ? { fontString } : {}) });
33
+ }
34
+ get size() {
35
+ return this.placements.length;
36
+ }
37
+ /** Write the AcroForm, its numbers in `style`, its values in the faces
38
+ * `fonts` gives. */
39
+ async finalize(pdfDoc, style, fonts) {
40
+ if (this.placements.length === 0)
41
+ return;
42
+ const form = pdfDoc.getForm();
43
+ // The style is the caller's, not the document's, but it is written into
44
+ // the format scripts: a separator style is one of Acrobat's 0–4, the
45
+ // currency's side a boolean.
46
+ const sep = Math.min(4, Math.max(0, Math.trunc(Number(style.separatorStyle)) || 0));
47
+ const before = style.currencyBefore === true;
48
+ const { currency } = style;
49
+ const byName = new Map();
50
+ for (const p of this.placements) {
51
+ const known = byName.get(p.field.name);
52
+ if (known && known.spec.kind !== p.field.kind) {
53
+ this.warnings.push(`form field "${p.field.name}" is used as ${known.spec.kind} and as ${p.field.kind}; the first wins`);
54
+ continue;
55
+ }
56
+ // A field has one face, its first chip's: every widget shows it. A
57
+ // check box shows no text.
58
+ const font = known ? known.font : p.field.kind === 'checkbox' ? undefined : await fonts.fontFor(p.fontString);
59
+ try {
60
+ const [x1, y1, x2, y2] = p.rect;
61
+ const box = { x: Math.min(x1, x2), y: Math.min(y1, y2), width: Math.abs(x2 - x1), height: Math.abs(y2 - y1),
62
+ borderWidth: 0, borderColor: undefined, backgroundColor: undefined, ...(font ? { font } : {}) };
63
+ const size = Math.max(4, p.sizePt);
64
+ if (p.field.kind === 'checkbox') {
65
+ const cb = known?.field ?? form.createCheckBox(p.field.name);
66
+ cb.addToPage(p.page, { ...box, textColor: undefined });
67
+ if (!known)
68
+ byName.set(p.field.name, { spec: p.field, field: cb, value: p.value, font });
69
+ continue;
70
+ }
71
+ if (p.field.kind === 'choice') {
72
+ const dd = known?.field ?? form.createDropdown(p.field.name);
73
+ if (!known) {
74
+ dd.setOptions(p.field.options ?? []);
75
+ if (p.value && (p.field.options ?? []).includes(p.value))
76
+ dd.select(p.value);
77
+ }
78
+ dd.addToPage(p.page, box);
79
+ dd.setFontSize(size);
80
+ if (!known)
81
+ byName.set(p.field.name, { spec: p.field, field: dd, value: p.value, font });
82
+ continue;
83
+ }
84
+ const tf = known?.field ?? form.createTextField(p.field.name);
85
+ if (!known) {
86
+ if (p.field.multiline)
87
+ tf.enableMultiline();
88
+ tf.setAlignment(p.field.kind === 'number' ? TextAlignment.Right : TextAlignment.Left);
89
+ }
90
+ tf.addToPage(p.page, box);
91
+ tf.setFontSize(size);
92
+ if (!known)
93
+ byName.set(p.field.name, { spec: p.field, field: tf, value: p.value, font });
94
+ }
95
+ catch (err) {
96
+ // A name the PDF cannot hold (`a..b`, or `order` beside `order.qty`)
97
+ // loses its field, not the whole document.
98
+ this.warnings.push(`form field "${p.field.name}" cannot be written: ${err instanceof Error ? err.message : String(err)}`);
99
+ }
100
+ }
101
+ // Every widget's appearance, in its field's face (so pdf-lib draws none
102
+ // in its default face on save): a value as the viewer's format script
103
+ // shows it, while the field keeps the plain number its scripts read.
104
+ for (const { spec, field, value, font } of byName.values()) {
105
+ if (!font)
106
+ continue;
107
+ if (spec.kind === 'choice') {
108
+ field.updateAppearances(font);
109
+ continue;
110
+ }
111
+ const tf = field;
112
+ const shown = value ? formatFieldNumber(value, spec.format, style) ?? value : '';
113
+ if (shown)
114
+ tf.setText(shown);
115
+ tf.updateAppearances(font);
116
+ if (shown !== value)
117
+ tf.acroField.setValue(PDFHexString.fromText(value));
118
+ }
119
+ for (const { spec, field } of byName.values()) {
120
+ if (spec.kind === 'checkbox' && spec.on) {
121
+ if (spec.on === 'Off')
122
+ this.warnings.push(`form field "${spec.name}" cannot name its on state "Off", the off state's name; it keeps "Yes"`);
123
+ else
124
+ nameOnState(field, spec.on);
125
+ }
126
+ if (spec.readonly)
127
+ field.enableReadOnly();
128
+ if (spec.required)
129
+ field.enableRequired();
130
+ const dict = field.acroField.dict;
131
+ if (spec.tooltip)
132
+ dict.set(PDFName.of('TU'), PDFHexString.fromText(spec.tooltip));
133
+ const actions = {};
134
+ const fmt = numberFormat(spec, sep, currency, before);
135
+ if (fmt) {
136
+ actions.F = `AFNumber_Format(${fmt});`;
137
+ actions.K = `AFNumber_Keystroke(${fmt});`;
138
+ }
139
+ if (spec.calc) {
140
+ const missing = spec.calc.fields.filter((n) => !byName.has(n));
141
+ if (missing.length)
142
+ this.warnings.push(`form field "${spec.name}" calculates from unknown field(s): ${missing.join(', ')}`);
143
+ for (const n of spec.calc.fields) {
144
+ const read = byName.get(n)?.spec;
145
+ if (read?.kind === 'checkbox' && !isNumber(onValue(read))) {
146
+ this.warnings.push(`form field "${spec.name}" reads check box "${n}", whose value "${onValue(read)}" is no number, so it always counts 0 (give the box on="1")`);
147
+ }
148
+ }
149
+ actions.C = calcScript(spec.calc, (n) => byName.has(n));
150
+ }
151
+ if (Object.keys(actions).length > 0) {
152
+ const aa = pdfDoc.context.obj({});
153
+ for (const [k, js] of Object.entries(actions)) {
154
+ // A literal string: backslashes and parentheses escaped (PDF 7.3.4.2).
155
+ aa.set(PDFName.of(k), pdfDoc.context.obj({ S: 'JavaScript', JS: PDFString.of(js.replace(/[\\()]/g, '\\$&')) }));
156
+ }
157
+ dict.set(PDFName.of('AA'), aa);
158
+ }
159
+ }
160
+ // Calculation order: every calculated field after the ones it reads.
161
+ const calculated = [...byName.values()].filter((f) => f.spec.calc);
162
+ const order = [];
163
+ const state = new Map();
164
+ const visit = (name) => {
165
+ const f = byName.get(name);
166
+ if (!f?.spec.calc || state.get(name) === 'done')
167
+ return;
168
+ if (state.get(name) === 'busy') {
169
+ this.warnings.push(`form fields calculate in a cycle through "${name}"`);
170
+ return;
171
+ }
172
+ state.set(name, 'busy');
173
+ for (const dep of f.spec.calc.fields)
174
+ visit(dep);
175
+ state.set(name, 'done');
176
+ order.push(name);
177
+ };
178
+ for (const f of calculated)
179
+ visit(f.spec.name);
180
+ await fonts.register();
181
+ const acro = pdfDoc.catalog.lookup(PDFName.of('AcroForm'), PDFDict);
182
+ if (order.length > 0) {
183
+ const co = PDFArray.withContext(pdfDoc.context);
184
+ for (const n of order)
185
+ co.push(byName.get(n).field.acroField.ref);
186
+ acro.set(PDFName.of('CO'), co);
187
+ }
188
+ // Viewers draw values in their own format (the scripts above).
189
+ acro.set(PDFName.of('NeedAppearances'), pdfDoc.context.obj(true));
190
+ }
191
+ }
192
+ /** A JavaScript string literal in ASCII, other characters escaped
193
+ * (`€`): the script is a PDFDocEncoding string, which some viewers
194
+ * read without a euro sign. */
195
+ const jsString = (s) => JSON.stringify(s).replace(/[^\x20-\x7e]/g, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
196
+ /** The value a ticked check box gives its scripts: the name of its on
197
+ * state. */
198
+ const onValue = (spec) => (spec.on && spec.on !== 'Off' ? spec.on : 'Yes');
199
+ /** Whether `AFMakeNumber` reads `value` as a number. */
200
+ const isNumber = (value) => value.trim() !== '' && Number.isFinite(Number(value.trim().replace(',', '.')));
201
+ /** Name the on state of every widget of `box` `on` (pdf-lib names it
202
+ * `Yes`): the normal and the down appearance, and the state and value
203
+ * when ticked. A viewer gives the name to scripts as the box's value. */
204
+ function nameOnState(box, on) {
205
+ const yes = PDFName.of('Yes');
206
+ const to = PDFName.of(on);
207
+ for (const widget of box.acroField.getWidgets()) {
208
+ const ap = widget.dict.lookupMaybe(PDFName.of('AP'), PDFDict);
209
+ for (const key of ['N', 'D']) {
210
+ const states = ap?.lookupMaybe(PDFName.of(key), PDFDict);
211
+ const appearance = states?.get(yes);
212
+ if (!states || !appearance)
213
+ continue;
214
+ states.delete(yes);
215
+ states.set(to, appearance);
216
+ }
217
+ if (widget.dict.get(PDFName.of('AS')) === yes)
218
+ widget.dict.set(PDFName.of('AS'), to);
219
+ }
220
+ if (box.acroField.dict.get(PDFName.of('V')) === yes)
221
+ box.acroField.dict.set(PDFName.of('V'), to);
222
+ }
223
+ const SIMPLE_OPS = { sum: 'SUM', product: 'PRD', min: 'MIN', max: 'MAX', avg: 'AVG' };
224
+ /**
225
+ * The Calculate script of `calc`. Over fields alone it is Acrobat's
226
+ * `AFSimple_Calculate`, which viewers with only the standard scripts run
227
+ * too. With numbers or nested calculations it is an expression that reads
228
+ * each field as `AFSimple_Calculate` does (`AFMakeNumber` of its value,
229
+ * anything that is no number 0; a field `known` does not hold is 0) and
230
+ * rounds to six decimals as pdf.js does.
231
+ */
232
+ function calcScript(calc, known) {
233
+ if (calc.args.every((a) => typeof a === 'string')) {
234
+ return `AFSimple_Calculate("${SIMPLE_OPS[calc.op]}", new Array (${calc.args.map((n) => jsString(n)).join(', ')}));`;
235
+ }
236
+ const expr = (c) => {
237
+ const terms = c.args.map((a) => typeof a === 'number' ? String(a)
238
+ : typeof a === 'string' ? known(a) ? `(AFMakeNumber(this.getField(${jsString(a)}).value) || 0)` : '0'
239
+ : expr(a));
240
+ switch (c.op) {
241
+ case 'sum': return `(${terms.join(' + ')})`;
242
+ case 'product': return `(${terms.join(' * ')})`;
243
+ case 'min': return `Math.min(${terms.join(', ')})`;
244
+ case 'max': return `Math.max(${terms.join(', ')})`;
245
+ case 'avg': return `((${terms.join(' + ')}) / ${terms.length})`;
246
+ }
247
+ };
248
+ return `event.value = Math.round(1e6 * ${expr(calc)}) / 1e6;`;
249
+ }
250
+ /** The arguments of `AFNumber_Format` for a field, or undefined. */
251
+ function numberFormat(spec, sep, currency, before) {
252
+ switch (spec.format) {
253
+ case 'currency': return `2, ${sep}, 0, 0, ${jsString(before ? `${currency} ` : ` ${currency}`)}, ${before}`;
254
+ case 'decimal': return `2, ${sep}, 0, 0, "", true`;
255
+ case 'integer': return `0, ${sep}, 0, 0, "", true`;
256
+ case 'percent': return undefined;
257
+ default: return undefined;
258
+ }
259
+ }
260
+ //# sourceMappingURL=forms.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"forms.js","sourceRoot":"","sources":["../../src/pdf-backend/forms.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,6 @@
1
+ import { type PdfFormOptions } from './forms.js';
2
+ export type { PdfFormOptions } from './forms.js';
3
+ export type { PdfFormFont } from './formFonts.js';
1
4
  import './text/shapedText.js';
2
5
  import './text/verticalText.js';
3
6
  import { PDFDocument } from 'pdf-lib';
@@ -6,11 +9,17 @@ import { type PdfColorSpace, type PrintConfig, type VDTDocument } from 'postext'
6
9
  import { type PdfFontProvider, type PdfFontAnswer, type PdfFontFile, type PdfFontFileDeclaration, type PdfFontRequest } from '../fontCache.js';
7
10
  import type { HarfBuzzWasmSource } from '../harfbuzz.js';
8
11
  import { type PdfWarning } from './renderToPdf/warnings.js';
9
- export type { PdfPrintWarning, PdfComplexShapingWarning, PdfFontFallbackWarning, PdfMissingGlyphWarning, PdfVariableFontWarning, PdfCffEmbeddedWholeWarning, PdfWarning, PdfFontWarning } from './renderToPdf/warnings.js';
12
+ export type { PdfFormFieldWarning, PdfPrintWarning, PdfComplexShapingWarning, PdfFontFallbackWarning, PdfMissingGlyphWarning, PdfVariableFontWarning, PdfCffEmbeddedWholeWarning, PdfWarning, PdfFontWarning } from './renderToPdf/warnings.js';
10
13
  /** Options of `renderToPdf`: fonts, image bytes, colour, accessibility, print
11
14
  * production and progress. */
12
15
  export interface RenderToPdfOptions {
13
16
  fontProvider: PdfFontProvider;
17
+ /** How form fields (chips with a `field`, #1445) write numbers: the
18
+ * currency symbol and its side, and the separators (from the document
19
+ * language when unset), and the face fields show values in (`font`,
20
+ * the chip's by default, embedded whole). The canvas takes the same
21
+ * option (`RenderPageOptions.forms`), so its preview matches. */
22
+ forms?: PdfFormOptions;
14
23
  pageNegative?: boolean;
15
24
  /** Emit a PDF outline tree (bookmarks) so readers can jump between
16
25
  * headings. When omitted, the first document's
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pdf-backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAA6B,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,aAAa,EAAgD,MAAM,iCAAiC,CAAC;AAE/I,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAgK,MAAM,SAAS,CAAC;AAI/O,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,sBAAsB,EAAE,KAAK,cAAc,EAA4B,MAAM,iBAAiB,CAAC;AAEzK,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAWzD,OAAO,EAAE,KAAK,UAAU,EAA8D,MAAM,2BAA2B,CAAC;AAExH,YAAY,EAAE,eAAe,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3N;+BAC+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,eAAe,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;sDAEkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;iBAKa;IACb,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B;;;;;;;;;qCASiC;IACjC,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC;;;wDAGoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;8DAE0D;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;sEACkE;IAClE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD;8EAC0E;IAC1E,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B;;;;;;;;;;;;;+CAa2C;IAC3C,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C;;;;;;;uDAOmD;IACnD,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC;;;;;iBAKa;IACb,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;8DAE0D;IAC1D,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B;mEAC+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;kDAM8C;IAC9C,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;CAC/B;AAWD,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;IACpC,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,sBAAsB,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAkB7E;;;;;;GAMG;AACH;yEACyE;AACzE,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAGxD;AAQD;WACW;AACX,wBAAsB,WAAW,CAC/B,KAAK,EAAE,WAAW,GAAG,WAAW,EAAE,EAClC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,UAAU,CAAC,CA2KrB"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pdf-backend/index.ts"],"names":[],"mappings":"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"}
@@ -1,9 +1,11 @@
1
+ import { FormFieldRegistry } from './forms.js';
2
+ import { FormFonts } from './formFonts.js';
1
3
  import './text/shapedText.js';
2
4
  import './text/verticalText.js';
3
5
  import { PDFDocument, ReadingDirection, PDFName } from 'pdf-lib';
4
6
  import { preloadResourceImages } from './blocks/renderResourceBlock.js';
5
7
  import fontkit from '@pdf-lib/fontkit';
6
- import { shapingLanguageOf, resolvePrintConfig, outputProfileInfo, parseIccProfile, loadOutputProfile, authoredCmykColors } from 'postext';
8
+ import { shapingLanguageOf, documentLanguageOf, formNumberStyle, resolvePrintConfig, outputProfileInfo, parseIccProfile, loadOutputProfile, authoredCmykColors } from 'postext';
7
9
  import { createPrintColorMode } from '../print/colorMode.js';
8
10
  import { runPagePrintPass } from '../print/printPass.js';
9
11
  import { writePdfX } from '../print/pdfx.js';
@@ -156,6 +158,12 @@ export async function renderToPdf(input, options) {
156
158
  // Contents links carry book-absolute page indices; the registry maps them
157
159
  // onto the PDF's pages from the first document's offset.
158
160
  const linkRegistry = new LinkRegistry(first.pageIndexOffset ?? 0);
161
+ // Form fields (#1445): interactive in a screen PDF; a print standard
162
+ // allows none, there the values are painted as text.
163
+ const forms = pdfx ? undefined : new FormFieldRegistry();
164
+ // How their numbers are written, in the document's language as the
165
+ // canvas preview writes them.
166
+ const fieldNumbers = formNumberStyle(options.forms, documentLanguageOf(first.config));
159
167
  let rendered = 0;
160
168
  // Placeholders are reported once per image for the whole file.
161
169
  const onWarning = options.onWarning;
@@ -166,6 +174,8 @@ export async function renderToPdf(input, options) {
166
174
  const resourceCtx = {
167
175
  images: resourceImages,
168
176
  linkRegistry,
177
+ ...(forms ? { forms } : {}),
178
+ fieldNumbers,
169
179
  structure: tree ? new StructureFlow(tree) : undefined,
170
180
  };
171
181
  linkRegistry.documentIndex = documentIndex;
@@ -191,6 +201,11 @@ export async function renderToPdf(input, options) {
191
201
  // the bleed box are not allowed.
192
202
  if (!pdfx)
193
203
  linkRegistry.finalize(pdfDoc, tree);
204
+ if (forms) {
205
+ await forms.finalize(pdfDoc, fieldNumbers, new FormFonts(pdfDoc, fontCache, options.forms?.font, (message) => forms.warnings.push(message)));
206
+ for (const message of forms.warnings)
207
+ warn({ kind: 'formField', message: `postext-pdf: ${message}` });
208
+ }
194
209
  if (settings.outlines) {
195
210
  addOutlines(pdfDoc, docs);
196
211
  }