@jasy/pdf 1.0.0-alpha.1 → 1.0.0-alpha.10

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 (275) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +35 -21
  3. package/dist/api/args.d.ts +1 -1
  4. package/dist/api/args.js +2 -5
  5. package/dist/api/color.d.ts +4 -4
  6. package/dist/api/color.js +11 -17
  7. package/dist/api/content.d.ts +20 -13
  8. package/dist/api/content.js +44 -29
  9. package/dist/api/descriptor.d.ts +2 -2
  10. package/dist/api/descriptor.js +121 -31
  11. package/dist/api/dimension.d.ts +76 -0
  12. package/dist/api/dimension.js +43 -0
  13. package/dist/api/font-url.d.ts +28 -0
  14. package/dist/api/font-url.js +134 -0
  15. package/dist/api/forms.d.ts +347 -0
  16. package/dist/api/forms.js +189 -0
  17. package/dist/api/gradient.d.ts +53 -0
  18. package/dist/api/gradient.js +97 -0
  19. package/dist/api/index.d.ts +13 -8
  20. package/dist/api/index.js +13 -24
  21. package/dist/api/insets.d.ts +19 -12
  22. package/dist/api/insets.js +19 -12
  23. package/dist/api/layout.d.ts +149 -25
  24. package/dist/api/layout.js +182 -51
  25. package/dist/api/page-builder.d.ts +40 -0
  26. package/dist/api/page-builder.js +44 -0
  27. package/dist/api/structure.d.ts +100 -13
  28. package/dist/api/structure.js +179 -88
  29. package/dist/api/table.d.ts +5 -5
  30. package/dist/api/table.js +38 -26
  31. package/dist/api/text.d.ts +90 -4
  32. package/dist/api/text.js +116 -31
  33. package/dist/assets/font-data.d.ts +2 -0
  34. package/dist/assets/font-data.js +21 -0
  35. package/dist/assets/font-data.ts +37 -0
  36. package/dist/common/color.js +1 -5
  37. package/dist/constants/page-sizes.js +3 -6
  38. package/dist/constants/pdf-parts.js +1 -4
  39. package/dist/crypto/legacy-handler.d.ts +43 -0
  40. package/dist/crypto/legacy-handler.js +145 -0
  41. package/dist/crypto/security-handler.d.ts +62 -0
  42. package/dist/crypto/security-handler.js +155 -0
  43. package/dist/crypto/webcrypto.d.ts +11 -0
  44. package/dist/crypto/webcrypto.js +62 -0
  45. package/dist/edit/acroform-reader.d.ts +70 -0
  46. package/dist/edit/acroform-reader.js +126 -0
  47. package/dist/edit/appearance.d.ts +47 -0
  48. package/dist/edit/appearance.js +171 -0
  49. package/dist/edit/document.d.ts +145 -0
  50. package/dist/edit/document.js +642 -0
  51. package/dist/edit/fill.d.ts +65 -0
  52. package/dist/edit/fill.js +424 -0
  53. package/dist/edit/flatten.d.ts +54 -0
  54. package/dist/edit/flatten.js +462 -0
  55. package/dist/edit/index.d.ts +20 -0
  56. package/dist/edit/index.js +18 -0
  57. package/dist/edit/lexer.d.ts +30 -0
  58. package/dist/edit/lexer.js +285 -0
  59. package/dist/edit/objects.d.ts +68 -0
  60. package/dist/edit/objects.js +83 -0
  61. package/dist/edit/writer.d.ts +60 -0
  62. package/dist/edit/writer.js +283 -0
  63. package/dist/elements/container-element.d.ts +50 -5
  64. package/dist/elements/container-element.js +100 -39
  65. package/dist/elements/forms/checkbox-element.d.ts +51 -0
  66. package/dist/elements/forms/checkbox-element.js +48 -0
  67. package/dist/elements/forms/choice-element.d.ts +53 -0
  68. package/dist/elements/forms/choice-element.js +59 -0
  69. package/dist/elements/forms/push-button-element.d.ts +56 -0
  70. package/dist/elements/forms/push-button-element.js +49 -0
  71. package/dist/elements/forms/radio-element.d.ts +52 -0
  72. package/dist/elements/forms/radio-element.js +49 -0
  73. package/dist/elements/forms/signature-element.d.ts +54 -0
  74. package/dist/elements/forms/signature-element.js +47 -0
  75. package/dist/elements/forms/text-field-element.d.ts +61 -0
  76. package/dist/elements/forms/text-field-element.js +54 -0
  77. package/dist/elements/image-element.d.ts +58 -6
  78. package/dist/elements/image-element.js +145 -111
  79. package/dist/elements/index.d.ts +26 -10
  80. package/dist/elements/index.js +26 -28
  81. package/dist/elements/layout/anchor-element.d.ts +23 -0
  82. package/dist/elements/layout/anchor-element.js +27 -0
  83. package/dist/elements/layout/bookmark-element.d.ts +27 -0
  84. package/dist/elements/layout/bookmark-element.js +30 -0
  85. package/dist/elements/layout/default-text-style-element.d.ts +30 -0
  86. package/dist/elements/layout/default-text-style-element.js +47 -0
  87. package/dist/elements/layout/deferred-element.d.ts +3 -3
  88. package/dist/elements/layout/deferred-element.js +4 -8
  89. package/dist/elements/layout/expanded-element.d.ts +6 -4
  90. package/dist/elements/layout/expanded-element.js +22 -17
  91. package/dist/elements/layout/keep-together-element.d.ts +42 -0
  92. package/dist/elements/layout/keep-together-element.js +85 -0
  93. package/dist/elements/layout/link-element.d.ts +33 -0
  94. package/dist/elements/layout/link-element.js +39 -0
  95. package/dist/elements/layout/padding-element.d.ts +10 -5
  96. package/dist/elements/layout/padding-element.js +25 -16
  97. package/dist/elements/layout/page-break-element.d.ts +17 -0
  98. package/dist/elements/layout/page-break-element.js +24 -0
  99. package/dist/elements/layout/page-builder-element.d.ts +32 -0
  100. package/dist/elements/layout/page-builder-element.js +45 -0
  101. package/dist/elements/layout/positioned-element.d.ts +47 -0
  102. package/dist/elements/layout/positioned-element.js +73 -0
  103. package/dist/elements/layout/repeating-header-element.d.ts +3 -3
  104. package/dist/elements/layout/repeating-header-element.js +8 -12
  105. package/dist/elements/layout/rotated-box-element.d.ts +35 -0
  106. package/dist/elements/layout/rotated-box-element.js +54 -0
  107. package/dist/elements/layout/rotated-element.d.ts +32 -0
  108. package/dist/elements/layout/rotated-element.js +41 -0
  109. package/dist/elements/layout/sized-container-element.d.ts +2 -2
  110. package/dist/elements/layout/sized-container-element.js +6 -11
  111. package/dist/elements/layout/struct-group.d.ts +28 -0
  112. package/dist/elements/layout/struct-group.js +42 -0
  113. package/dist/elements/line-element.d.ts +3 -3
  114. package/dist/elements/line-element.js +5 -10
  115. package/dist/elements/page-element.d.ts +26 -6
  116. package/dist/elements/page-element.js +72 -27
  117. package/dist/elements/pdf-document-element.d.ts +10 -4
  118. package/dist/elements/pdf-document-element.js +11 -10
  119. package/dist/elements/pdf-element.d.ts +150 -4
  120. package/dist/elements/pdf-element.js +138 -20
  121. package/dist/elements/rectangle-element.d.ts +52 -11
  122. package/dist/elements/rectangle-element.js +129 -36
  123. package/dist/elements/row-element.d.ts +45 -4
  124. package/dist/elements/row-element.js +66 -18
  125. package/dist/elements/text-element.d.ts +132 -11
  126. package/dist/elements/text-element.js +206 -56
  127. package/dist/forms/acroform.d.ts +63 -0
  128. package/dist/forms/acroform.js +427 -0
  129. package/dist/forms/appearance.d.ts +58 -0
  130. package/dist/forms/appearance.js +204 -0
  131. package/dist/forms/field.d.ts +164 -0
  132. package/dist/forms/field.js +1 -0
  133. package/dist/forms/pdf.d.ts +19 -0
  134. package/dist/forms/pdf.js +28 -0
  135. package/dist/index.d.ts +3 -3
  136. package/dist/index.js +3 -19
  137. package/dist/ir/display-list.d.ts +197 -8
  138. package/dist/ir/display-list.js +8 -2
  139. package/dist/layout/alignment.d.ts +10 -0
  140. package/dist/layout/alignment.js +6 -0
  141. package/dist/layout/box-constraints.d.ts +61 -0
  142. package/dist/layout/box-constraints.js +88 -6
  143. package/dist/layout/collect-images.d.ts +9 -0
  144. package/dist/layout/collect-images.js +34 -0
  145. package/dist/layout/fragmentation.d.ts +20 -1
  146. package/dist/layout/fragmentation.js +74 -18
  147. package/dist/layout/insets.d.ts +28 -0
  148. package/dist/layout/insets.js +20 -0
  149. package/dist/platform/browser-fs.d.ts +2 -0
  150. package/dist/platform/browser-fs.js +9 -0
  151. package/dist/platform/browser-image.d.ts +5 -0
  152. package/dist/platform/browser-image.js +13 -0
  153. package/dist/platform/node-fs.d.ts +2 -0
  154. package/dist/platform/node-fs.js +10 -0
  155. package/dist/platform/node-image.d.ts +5 -0
  156. package/dist/platform/node-image.js +9 -0
  157. package/dist/renderer/anchor-renderer.d.ts +6 -0
  158. package/dist/renderer/anchor-renderer.js +11 -0
  159. package/dist/renderer/bookmark-renderer.d.ts +6 -0
  160. package/dist/renderer/bookmark-renderer.js +11 -0
  161. package/dist/renderer/container-renderer.d.ts +3 -3
  162. package/dist/renderer/container-renderer.js +11 -28
  163. package/dist/renderer/default-text-style-renderer.d.ts +6 -0
  164. package/dist/renderer/default-text-style-renderer.js +10 -0
  165. package/dist/renderer/deferred-renderer.d.ts +3 -3
  166. package/dist/renderer/deferred-renderer.js +8 -23
  167. package/dist/renderer/emoji-image.d.ts +9 -0
  168. package/dist/renderer/emoji-image.js +68 -0
  169. package/dist/renderer/expanded-renderer.d.ts +3 -3
  170. package/dist/renderer/expanded-renderer.js +6 -21
  171. package/dist/renderer/form-field-renderer.d.ts +20 -0
  172. package/dist/renderer/form-field-renderer.js +12 -0
  173. package/dist/renderer/image-renderer.d.ts +4 -4
  174. package/dist/renderer/image-renderer.js +86 -75
  175. package/dist/renderer/index.d.ts +10 -10
  176. package/dist/renderer/index.js +10 -26
  177. package/dist/renderer/keep-together-renderer.d.ts +10 -0
  178. package/dist/renderer/keep-together-renderer.js +12 -0
  179. package/dist/renderer/line-renderer.d.ts +3 -3
  180. package/dist/renderer/line-renderer.js +13 -28
  181. package/dist/renderer/link-renderer.d.ts +6 -0
  182. package/dist/renderer/link-renderer.js +11 -0
  183. package/dist/renderer/padding-renderer.d.ts +3 -3
  184. package/dist/renderer/padding-renderer.js +6 -21
  185. package/dist/renderer/page-break-renderer.d.ts +14 -0
  186. package/dist/renderer/page-break-renderer.js +15 -0
  187. package/dist/renderer/page-builder-renderer.d.ts +6 -0
  188. package/dist/renderer/page-builder-renderer.js +11 -0
  189. package/dist/renderer/page-renderer.d.ts +2 -2
  190. package/dist/renderer/page-renderer.js +115 -77
  191. package/dist/renderer/pdf-backend.d.ts +31 -4
  192. package/dist/renderer/pdf-backend.js +287 -49
  193. package/dist/renderer/pdf-config.js +4 -7
  194. package/dist/renderer/pdf-document-class.d.ts +5 -5
  195. package/dist/renderer/pdf-document-class.js +27 -41
  196. package/dist/renderer/pdf-document-renderer.d.ts +19 -10
  197. package/dist/renderer/pdf-document-renderer.js +135 -91
  198. package/dist/renderer/pdf-renderer.d.ts +2 -2
  199. package/dist/renderer/pdf-renderer.js +165 -90
  200. package/dist/renderer/positioned-renderer.d.ts +6 -0
  201. package/dist/renderer/positioned-renderer.js +10 -0
  202. package/dist/renderer/rectangle-renderer.d.ts +3 -3
  203. package/dist/renderer/rectangle-renderer.js +49 -44
  204. package/dist/renderer/repeating-header-renderer.d.ts +3 -3
  205. package/dist/renderer/repeating-header-renderer.js +10 -26
  206. package/dist/renderer/rotated-renderer.d.ts +7 -0
  207. package/dist/renderer/rotated-renderer.js +29 -0
  208. package/dist/renderer/row-renderer.d.ts +3 -3
  209. package/dist/renderer/row-renderer.js +11 -28
  210. package/dist/renderer/struct-group-renderer.d.ts +10 -0
  211. package/dist/renderer/struct-group-renderer.js +24 -0
  212. package/dist/renderer/text-renderer.d.ts +9 -5
  213. package/dist/renderer/text-renderer.js +437 -89
  214. package/dist/text/advance.d.ts +34 -0
  215. package/dist/text/advance.js +45 -0
  216. package/dist/text/arabic.d.ts +20 -0
  217. package/dist/text/arabic.js +101 -0
  218. package/dist/text/bidi.d.ts +33 -0
  219. package/dist/text/bidi.js +94 -0
  220. package/dist/text/emoji-codepoints.d.ts +1 -0
  221. package/dist/text/emoji-codepoints.js +29 -0
  222. package/dist/text/font-fallback.d.ts +25 -0
  223. package/dist/text/font-fallback.js +38 -0
  224. package/dist/text/line-breaker.d.ts +50 -12
  225. package/dist/text/line-breaker.js +158 -37
  226. package/dist/text/line-metrics.d.ts +49 -0
  227. package/dist/text/line-metrics.js +57 -0
  228. package/dist/text/orphans-widows.d.ts +27 -0
  229. package/dist/text/orphans-widows.js +53 -0
  230. package/dist/text/shape.d.ts +29 -0
  231. package/dist/text/shape.js +67 -0
  232. package/dist/text/text-decoration.d.ts +50 -0
  233. package/dist/text/text-decoration.js +62 -0
  234. package/dist/text/text-style.d.ts +60 -0
  235. package/dist/text/text-style.js +79 -0
  236. package/dist/utils/afm-parser.d.ts +34 -0
  237. package/dist/utils/afm-parser.js +76 -17
  238. package/dist/utils/bytes.d.ts +24 -0
  239. package/dist/utils/bytes.js +76 -0
  240. package/dist/utils/dest-registry.d.ts +22 -0
  241. package/dist/utils/dest-registry.js +32 -0
  242. package/dist/utils/flex-layout.d.ts +36 -9
  243. package/dist/utils/flex-layout.js +207 -30
  244. package/dist/utils/font-metrics.d.ts +20 -1
  245. package/dist/utils/font-metrics.js +1 -2
  246. package/dist/utils/font-path.js +3 -6
  247. package/dist/utils/gsub.d.ts +36 -0
  248. package/dist/utils/gsub.js +178 -0
  249. package/dist/utils/image-helper.d.ts +6 -5
  250. package/dist/utils/image-helper.js +101 -111
  251. package/dist/utils/inflate.d.ts +16 -0
  252. package/dist/utils/inflate.js +52 -0
  253. package/dist/utils/md5.d.ts +4 -0
  254. package/dist/utils/md5.js +79 -0
  255. package/dist/utils/outline.d.ts +21 -0
  256. package/dist/utils/outline.js +79 -0
  257. package/dist/utils/pdf-object-manager.d.ts +110 -8
  258. package/dist/utils/pdf-object-manager.js +583 -141
  259. package/dist/utils/renderer-registry.d.ts +13 -1
  260. package/dist/utils/renderer-registry.js +23 -6
  261. package/dist/utils/struct-tree.d.ts +44 -0
  262. package/dist/utils/struct-tree.js +129 -0
  263. package/dist/utils/ttf-parser.d.ts +134 -2
  264. package/dist/utils/ttf-parser.js +873 -50
  265. package/dist/utils/ttf-subsetter.d.ts +1 -1
  266. package/dist/utils/ttf-subsetter.js +40 -42
  267. package/dist/utils/ua-xmp.d.ts +9 -0
  268. package/dist/utils/ua-xmp.js +32 -0
  269. package/dist/utils/utf8-to-windows1252-encoder.d.ts +6 -0
  270. package/dist/utils/utf8-to-windows1252-encoder.js +11 -4
  271. package/dist/utils/woff.d.ts +10 -0
  272. package/dist/utils/woff.js +116 -0
  273. package/dist/validators/element-validator.d.ts +2 -2
  274. package/dist/validators/element-validator.js +31 -26
  275. package/package.json +22 -2
@@ -1,23 +1,6 @@
1
- "use strict";
2
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
- return new (P || (P = Promise))(function (resolve, reject) {
5
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
- step((generator = generator.apply(thisArg, _arguments || [])).next());
9
- });
10
- };
11
- Object.defineProperty(exports, "__esModule", { value: true });
12
- exports.getImageDimensions = getImageDimensions;
13
- exports.decodePngToRgbFlate = decodePngToRgbFlate;
14
- exports.convertImageToGrayscaleBuffer = convertImageToGrayscaleBuffer;
15
- exports.applyContainFit = applyContainFit;
16
- exports.applyCoverFit = applyCoverFit;
17
- exports.applyFillFit = applyFillFit;
18
- exports.applyFitNone = applyFitNone;
19
- const jimp_1 = require("jimp");
20
- const zlib_1 = require("zlib");
1
+ import { zlibSync } from "fflate";
2
+ import { latin1FromBytes } from "./bytes.js";
3
+ import { pngToRgba } from "../platform/node-image.js";
21
4
  // Implement the method to handle 24-bit integers
22
5
  DataView.prototype.getUint24 = function (byteOffset, littleEndian = false) {
23
6
  const b1 = this.getUint8(byteOffset);
@@ -25,61 +8,59 @@ DataView.prototype.getUint24 = function (byteOffset, littleEndian = false) {
25
8
  const b3 = this.getUint8(byteOffset + 2);
26
9
  return littleEndian ? (b3 << 16) | (b2 << 8) | b1 : (b1 << 16) | (b2 << 8) | b3;
27
10
  };
28
- function getImageDimensions(buffer) {
29
- return __awaiter(this, void 0, void 0, function* () {
30
- const dataView = new DataView(buffer.buffer);
31
- // Check for JPEG (0xFFD8 is the start of JPEG file)
32
- if (dataView.getUint16(0) === 0xffd8) {
33
- let offset = 2;
34
- while (offset < buffer.byteLength) {
35
- const marker = dataView.getUint16(offset, false);
36
- offset += 2;
37
- if (marker === 0xffc0 || marker === 0xffc2) {
38
- // SOF0 or SOF2
39
- return {
40
- height: dataView.getUint16(offset + 3, false),
41
- width: dataView.getUint16(offset + 5, false),
42
- };
43
- }
44
- else {
45
- offset += dataView.getUint16(offset, false);
46
- }
11
+ export async function getImageDimensions(buffer) {
12
+ const dataView = new DataView(buffer.buffer);
13
+ // Check for JPEG (0xFFD8 is the start of JPEG file)
14
+ if (dataView.getUint16(0) === 0xffd8) {
15
+ let offset = 2;
16
+ while (offset < buffer.byteLength) {
17
+ const marker = dataView.getUint16(offset, false);
18
+ offset += 2;
19
+ if (marker === 0xffc0 || marker === 0xffc2) {
20
+ // SOF0 or SOF2
21
+ return {
22
+ height: dataView.getUint16(offset + 3, false),
23
+ width: dataView.getUint16(offset + 5, false),
24
+ };
25
+ }
26
+ else {
27
+ offset += dataView.getUint16(offset, false);
47
28
  }
48
29
  }
49
- // Check for PNG (0x89504E47 is the PNG signature)
50
- if (dataView.getUint32(0) === 0x89504e47) {
30
+ }
31
+ // Check for PNG (0x89504E47 is the PNG signature)
32
+ if (dataView.getUint32(0) === 0x89504e47) {
33
+ return {
34
+ width: dataView.getUint32(16, false),
35
+ height: dataView.getUint32(20, false),
36
+ };
37
+ }
38
+ // Check for BMP (0x424D is the BMP signature)
39
+ if (dataView.getUint16(0) === 0x424d) {
40
+ return {
41
+ width: dataView.getUint32(18, true),
42
+ height: dataView.getUint32(22, true),
43
+ };
44
+ }
45
+ // Check for WebP (0x52494646 is the WebP signature 'RIFF')
46
+ if (dataView.getUint32(0) === 0x52494646 && dataView.getUint32(8) === 0x57454250) {
47
+ // 'WEBP'
48
+ if (dataView.getUint32(12) === 0x56503820) {
49
+ // 'VP8 '
51
50
  return {
52
- width: dataView.getUint32(16, false),
53
- height: dataView.getUint32(20, false),
51
+ width: dataView.getUint16(26, true),
52
+ height: dataView.getUint16(28, true),
54
53
  };
55
54
  }
56
- // Check for BMP (0x424D is the BMP signature)
57
- if (dataView.getUint16(0) === 0x424d) {
55
+ else if (dataView.getUint32(12) === 0x56503858) {
56
+ // 'VP8X'
58
57
  return {
59
- width: dataView.getUint32(18, true),
60
- height: dataView.getUint32(22, true),
58
+ width: dataView.getUint24(24, true) + 1,
59
+ height: dataView.getUint24(27, true) + 1,
61
60
  };
62
61
  }
63
- // Check for WebP (0x52494646 is the WebP signature 'RIFF')
64
- if (dataView.getUint32(0) === 0x52494646 && dataView.getUint32(8) === 0x57454250) {
65
- // 'WEBP'
66
- if (dataView.getUint32(12) === 0x56503820) {
67
- // 'VP8 '
68
- return {
69
- width: dataView.getUint16(26, true),
70
- height: dataView.getUint16(28, true),
71
- };
72
- }
73
- else if (dataView.getUint32(12) === 0x56503858) {
74
- // 'VP8X'
75
- return {
76
- width: dataView.getUint24(24, true) + 1,
77
- height: dataView.getUint24(27, true) + 1,
78
- };
79
- }
80
- }
81
- throw new Error("Unsupported image format");
82
- });
62
+ }
63
+ throw new Error("Unsupported image format");
83
64
  }
84
65
  /**
85
66
  * Converts the given image to grayscale and returns its binary data.
@@ -89,50 +70,59 @@ function getImageDimensions(buffer) {
89
70
  /**
90
71
  * Decodes a PNG into raw DeviceRGB samples, Flate-compressed, ready to embed as a PDF
91
72
  * image XObject. A PNG file is NOT a valid `/FlateDecode` stream (it's a signature plus
92
- * chunks of filtered, zlib-compressed scanlines), so it must be decoded first. PDF has
93
- * no alpha channel for DeviceRGB, so transparent pixels are composited over white.
73
+ * chunks of filtered, zlib-compressed scanlines), so it must be decoded first. DeviceRGB has
74
+ * no alpha itself, so any transparency rides alongside as a DeviceGray `/SMask` (the return's `smask`).
94
75
  */
95
- function decodePngToRgbFlate(pngBuffer) {
96
- return __awaiter(this, void 0, void 0, function* () {
97
- const image = yield jimp_1.Jimp.fromBuffer(pngBuffer);
98
- const { width, height, data: rgba } = image.bitmap;
99
- const rgb = Buffer.allocUnsafe(width * height * 3);
100
- for (let i = 0, j = 0; i < rgba.length; i += 4, j += 3) {
101
- const alpha = rgba[i + 3] / 255;
102
- rgb[j] = Math.round(rgba[i] * alpha + 255 * (1 - alpha));
103
- rgb[j + 1] = Math.round(rgba[i + 1] * alpha + 255 * (1 - alpha));
104
- rgb[j + 2] = Math.round(rgba[i + 2] * alpha + 255 * (1 - alpha));
105
- }
106
- // Compress so the existing `/Filter /FlateDecode` XObject path embeds it correctly.
107
- return { data: (0, zlib_1.deflateSync)(rgb).toString("binary"), width, height };
108
- });
76
+ export async function decodePngToRgbFlate(pngBuffer) {
77
+ // The decode (PNG bytes → RGBA) is platform-specific: jimp on Node, an OffscreenCanvas in the browser
78
+ // (`platform/{node,browser}-image.ts`, swapped by the package `browser` field). The split below is shared.
79
+ const { width, height, rgba } = await pngToRgba(pngBuffer);
80
+ // Raw DeviceRGB samples + (only when the PNG actually has transparency) a DeviceGray alpha channel that
81
+ // rides as the XObject's /SMask. An opaque PNG yields the same raw RGB as before and no SMask, so it stays
82
+ // byte-identical; a transparent one now composites correctly over whatever sits behind it.
83
+ const rgb = new Uint8Array(width * height * 3);
84
+ const alpha = new Uint8Array(width * height);
85
+ let hasAlpha = false;
86
+ for (let i = 0, j = 0, k = 0; i < rgba.length; i += 4, j += 3, k++) {
87
+ rgb[j] = rgba[i];
88
+ rgb[j + 1] = rgba[i + 1];
89
+ rgb[j + 2] = rgba[i + 2];
90
+ alpha[k] = rgba[i + 3];
91
+ if (rgba[i + 3] !== 255)
92
+ hasAlpha = true;
93
+ }
94
+ return {
95
+ data: latin1FromBytes(zlibSync(rgb)),
96
+ smask: hasAlpha ? latin1FromBytes(zlibSync(alpha)) : undefined,
97
+ width,
98
+ height,
99
+ };
109
100
  }
110
- function convertImageToGrayscaleBuffer(imagePath) {
111
- return __awaiter(this, void 0, void 0, function* () {
112
- // We get the image from the buffer
113
- const image = yield jimp_1.Jimp.read(imagePath);
114
- // Get MIME type. If emtpy throw error
115
- const mime = image.mime;
116
- if (!mime)
117
- throw new Error("Cannot read MIME type");
118
- // We need to check the MIME type (the exact union `getBuffer` accepts).
119
- let mimeType;
120
- switch (mime) {
121
- case jimp_1.JimpMime.png:
122
- case jimp_1.JimpMime.jpeg:
123
- case jimp_1.JimpMime.bmp:
124
- mimeType = mime;
125
- break;
126
- default:
127
- throw new Error("Unsupported MIME type");
128
- }
129
- image.greyscale();
130
- // Convert the image back to buffer with current MIME type
131
- const grayscaleBuffer = yield image.getBuffer(mimeType);
132
- return grayscaleBuffer;
133
- });
101
+ export async function convertImageToGrayscaleBuffer(imagePath) {
102
+ // We get the image from the buffer (jimp lazily loaded - see decodePngToRgbFlate).
103
+ const { Jimp, JimpMime } = await import("jimp");
104
+ const image = await Jimp.read(imagePath);
105
+ // Get MIME type. If emtpy throw error
106
+ const mime = image.mime;
107
+ if (!mime)
108
+ throw new Error("Cannot read MIME type");
109
+ // We need to check the MIME type (the exact union `getBuffer` accepts).
110
+ let mimeType;
111
+ switch (mime) {
112
+ case JimpMime.png:
113
+ case JimpMime.jpeg:
114
+ case JimpMime.bmp:
115
+ mimeType = mime;
116
+ break;
117
+ default:
118
+ throw new Error("Unsupported MIME type");
119
+ }
120
+ image.greyscale();
121
+ // Convert the image back to buffer with current MIME type
122
+ const grayscaleBuffer = await image.getBuffer(mimeType);
123
+ return grayscaleBuffer;
134
124
  }
135
- function applyContainFit(imageWidth, imageHeight, containerWidth, containerHeight) {
125
+ export function applyContainFit(imageWidth, imageHeight, containerWidth, containerHeight) {
136
126
  const imageAspectRatio = imageWidth / imageHeight;
137
127
  const containerAspectRatio = containerWidth / containerHeight;
138
128
  let width, height, offsetX, offsetY;
@@ -159,7 +149,7 @@ function applyContainFit(imageWidth, imageHeight, containerWidth, containerHeigh
159
149
  offsetY,
160
150
  };
161
151
  }
162
- function applyCoverFit(imageWidth, imageHeight, containerWidth, containerHeight) {
152
+ export function applyCoverFit(imageWidth, imageHeight, containerWidth, containerHeight) {
163
153
  const imageAspectRatio = imageWidth / imageHeight;
164
154
  const containerAspectRatio = containerWidth / containerHeight;
165
155
  let width, height, offsetX, offsetY;
@@ -186,7 +176,7 @@ function applyCoverFit(imageWidth, imageHeight, containerWidth, containerHeight)
186
176
  offsetY,
187
177
  };
188
178
  }
189
- function applyFillFit(containerWidth, containerHeight) {
179
+ export function applyFillFit(containerWidth, containerHeight) {
190
180
  return {
191
181
  width: containerWidth,
192
182
  height: containerHeight,
@@ -194,7 +184,7 @@ function applyFillFit(containerWidth, containerHeight) {
194
184
  offsetY: 0,
195
185
  };
196
186
  }
197
- function applyFitNone(imageWidth, imageHeight, containerWidth, containerHeight) {
187
+ export function applyFitNone(imageWidth, imageHeight, containerWidth, containerHeight) {
198
188
  const offsetX = (containerWidth - imageWidth) / 2; // Center horizontally
199
189
  const offsetY = (containerHeight - imageHeight) / 2; // Center vertically
200
190
  return {
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Inflating with a ceiling, so a hostile or mistaken input cannot exhaust memory.
3
+ *
4
+ * Used by BOTH sides: the reader inflating a PDF stream, and the font path unpacking a WOFF table.
5
+ * It lives in `utils/` for exactly that reason - the generate path must not import from `edit/`.
6
+ *
7
+ * fflate's `unzlibSync(data, { out })` is NOT usable for this: it truncates silently instead of failing.
8
+ * Hence the streamed form - input in slices, so the total can be checked while it grows.
9
+ */
10
+ /** Thrown when a stream expands past the ceiling; distinct from a stream that simply will not decode. */
11
+ export declare class PdfStreamTooLargeError extends Error {
12
+ readonly limit: number;
13
+ constructor(limit: number, message: string);
14
+ }
15
+ export declare const DEFAULT_MAX_STREAM_SIZE: number;
16
+ export declare function inflateBounded(data: Uint8Array, limit: number): Uint8Array;
@@ -0,0 +1,52 @@
1
+ import { Unzlib, unzlibSync } from "fflate";
2
+ /**
3
+ * Inflating with a ceiling, so a hostile or mistaken input cannot exhaust memory.
4
+ *
5
+ * Used by BOTH sides: the reader inflating a PDF stream, and the font path unpacking a WOFF table.
6
+ * It lives in `utils/` for exactly that reason - the generate path must not import from `edit/`.
7
+ *
8
+ * fflate's `unzlibSync(data, { out })` is NOT usable for this: it truncates silently instead of failing.
9
+ * Hence the streamed form - input in slices, so the total can be checked while it grows.
10
+ */
11
+ /** Thrown when a stream expands past the ceiling; distinct from a stream that simply will not decode. */
12
+ export class PdfStreamTooLargeError extends Error {
13
+ constructor(limit, message) {
14
+ super(`@jasy/pdf: ${message}`);
15
+ this.limit = limit;
16
+ }
17
+ }
18
+ export const DEFAULT_MAX_STREAM_SIZE = 64 * 1024 * 1024;
19
+ /** Only the granularity of the check: fflate buffers internally, so the abort lands one block past. */
20
+ const INPUT_SLICE = 16 * 1024;
21
+ /** DEFLATE's maximum expansion (a 258-byte match in its shortest encoding). A format property. */
22
+ const MAX_DEFLATE_RATIO = 1032;
23
+ export function inflateBounded(data, limit) {
24
+ // Too small to reach the ceiling even at maximum compression, so checking as it grows is pointless.
25
+ // Nearly every stream in a real PDF lands here, which is why the guard costs nothing.
26
+ if (data.length <= limit / MAX_DEFLATE_RATIO)
27
+ return unzlibSync(data);
28
+ const parts = [];
29
+ let total = 0;
30
+ const inflater = new Unzlib();
31
+ inflater.ondata = (chunk) => {
32
+ total += chunk.length;
33
+ if (total > limit) {
34
+ throw new PdfStreamTooLargeError(limit, `a stream in this PDF expands past the ${limit} byte limit for a single stream; if the file is ` +
35
+ `genuinely that large, raise it with { maxStreamSize }`);
36
+ }
37
+ parts.push(chunk);
38
+ };
39
+ for (let at = 0; at < data.length; at += INPUT_SLICE) {
40
+ const end = Math.min(at + INPUT_SLICE, data.length);
41
+ inflater.push(data.subarray(at, end), end >= data.length);
42
+ }
43
+ if (parts.length === 1)
44
+ return parts[0];
45
+ const out = new Uint8Array(total);
46
+ let at = 0;
47
+ for (const part of parts) {
48
+ out.set(part, at);
49
+ at += part.length;
50
+ }
51
+ return out;
52
+ }
@@ -0,0 +1,4 @@
1
+ /** The raw 16-byte MD5 digest of `input`. */
2
+ export declare function md5(input: Uint8Array): Uint8Array;
3
+ /** Lowercase hex of the MD5 digest (matches `digest("hex")`). */
4
+ export declare function md5Hex(input: Uint8Array): string;
@@ -0,0 +1,79 @@
1
+ // MD5 (RFC 1321), vendored + isomorphic - so the font subset tag and the documentId /ID hash work in the
2
+ // browser too: Node `crypto` is absent there, and Web Crypto has no MD5 and is async. Verified byte-for-byte
3
+ // identical to Node's `createHash("md5")`. Operates on bytes; callers UTF-8-encode strings (TextEncoder),
4
+ // matching `hash.update(string)`'s default encoding.
5
+ // Per-round left-rotate amounts.
6
+ const S = [
7
+ 7, 12, 17, 22, 7, 12, 17, 22, 7, 12, 17, 22, 7, 12, 17, 22, 5, 9, 14, 20, 5, 9, 14, 20, 5, 9, 14,
8
+ 20, 5, 9, 14, 20, 4, 11, 16, 23, 4, 11, 16, 23, 4, 11, 16, 23, 4, 11, 16, 23, 6, 10, 15, 21, 6,
9
+ 10, 15, 21, 6, 10, 15, 21, 6, 10, 15, 21,
10
+ ];
11
+ // Per-round constants K[i] = floor(abs(sin(i+1)) * 2^32).
12
+ const K = new Int32Array(64);
13
+ for (let i = 0; i < 64; i++)
14
+ K[i] = Math.floor(Math.abs(Math.sin(i + 1)) * 2 ** 32) | 0;
15
+ /** The raw 16-byte MD5 digest of `input`. */
16
+ export function md5(input) {
17
+ const len = input.length;
18
+ // Pad to a multiple of 64: message + 0x80 + zeros + 64-bit little-endian bit length.
19
+ const total = (((len + 8) >> 6) + 1) << 6;
20
+ const b = new Uint8Array(total);
21
+ b.set(input);
22
+ b[len] = 0x80;
23
+ const bits = len * 8;
24
+ b[total - 8] = bits & 0xff;
25
+ b[total - 7] = (bits >>> 8) & 0xff;
26
+ b[total - 6] = (bits >>> 16) & 0xff;
27
+ b[total - 5] = (bits >>> 24) & 0xff;
28
+ // High 32 bits of the length stay 0 (inputs are well under 512 MB).
29
+ let a0 = 0x67452301, b0 = 0xefcdab89, c0 = 0x98badcfe, d0 = 0x10325476;
30
+ const M = new Int32Array(16);
31
+ for (let off = 0; off < total; off += 64) {
32
+ for (let i = 0; i < 16; i++) {
33
+ const j = off + i * 4;
34
+ M[i] = b[j] | (b[j + 1] << 8) | (b[j + 2] << 16) | (b[j + 3] << 24);
35
+ }
36
+ let A = a0, B = b0, C = c0, D = d0;
37
+ for (let i = 0; i < 64; i++) {
38
+ let f, g;
39
+ if (i < 16) {
40
+ f = (B & C) | (~B & D);
41
+ g = i;
42
+ }
43
+ else if (i < 32) {
44
+ f = (D & B) | (~D & C);
45
+ g = (5 * i + 1) % 16;
46
+ }
47
+ else if (i < 48) {
48
+ f = B ^ C ^ D;
49
+ g = (3 * i + 5) % 16;
50
+ }
51
+ else {
52
+ f = C ^ (B | ~D);
53
+ g = (7 * i) % 16;
54
+ }
55
+ f = (f + A + K[i] + M[g]) | 0;
56
+ A = D;
57
+ D = C;
58
+ C = B;
59
+ B = (B + ((f << S[i]) | (f >>> (32 - S[i])) | 0)) | 0;
60
+ }
61
+ a0 = (a0 + A) | 0;
62
+ b0 = (b0 + B) | 0;
63
+ c0 = (c0 + C) | 0;
64
+ d0 = (d0 + D) | 0;
65
+ }
66
+ const out = new Uint8Array(16);
67
+ const w = [a0, b0, c0, d0];
68
+ for (let i = 0; i < 4; i++) {
69
+ out[i * 4] = w[i] & 0xff;
70
+ out[i * 4 + 1] = (w[i] >>> 8) & 0xff;
71
+ out[i * 4 + 2] = (w[i] >>> 16) & 0xff;
72
+ out[i * 4 + 3] = (w[i] >>> 24) & 0xff;
73
+ }
74
+ return out;
75
+ }
76
+ /** Lowercase hex of the MD5 digest (matches `digest("hex")`). */
77
+ export function md5Hex(input) {
78
+ return [...md5(input)].map((x) => x.toString(16).padStart(2, "0")).join("");
79
+ }
@@ -0,0 +1,21 @@
1
+ import type { PDFObjectManager } from "./pdf-object-manager.js";
2
+ interface Entry {
3
+ title: string;
4
+ level: number;
5
+ pageObjNum: number;
6
+ top: number;
7
+ }
8
+ /**
9
+ * Builds the PDF document outline (`/Outlines`) - the viewer's bookmark panel. Entries are collected
10
+ * flat in reading order with a 1-based `level`; `finalize` nests each entry under the nearest preceding
11
+ * entry of a smaller level (so level 2s hang under the last level 1), emits the outline objects and
12
+ * returns the catalog addition `/Outlines N 0 R`. A no-op returning "" when nothing was added, so a
13
+ * document without bookmarks stays byte-identical.
14
+ */
15
+ export declare class OutlineBuilder {
16
+ private entries;
17
+ add(entry: Entry): void;
18
+ get isEmpty(): boolean;
19
+ finalize(om: PDFObjectManager): string;
20
+ }
21
+ export {};
@@ -0,0 +1,79 @@
1
+ // A PDF literal string escape (same rule as elsewhere): backslash first, then the string delimiters.
2
+ const num = (n) => Number(n.toFixed(2));
3
+ /**
4
+ * Builds the PDF document outline (`/Outlines`) - the viewer's bookmark panel. Entries are collected
5
+ * flat in reading order with a 1-based `level`; `finalize` nests each entry under the nearest preceding
6
+ * entry of a smaller level (so level 2s hang under the last level 1), emits the outline objects and
7
+ * returns the catalog addition `/Outlines N 0 R`. A no-op returning "" when nothing was added, so a
8
+ * document without bookmarks stays byte-identical.
9
+ */
10
+ export class OutlineBuilder {
11
+ constructor() {
12
+ this.entries = [];
13
+ }
14
+ add(entry) {
15
+ this.entries.push(entry);
16
+ }
17
+ get isEmpty() {
18
+ return this.entries.length === 0;
19
+ }
20
+ finalize(om) {
21
+ if (this.entries.length === 0)
22
+ return "";
23
+ // Nest by level: a stack where stack[i] is the last open node at level i+1. An entry at level L
24
+ // becomes a child of stack[L-2] (the enclosing smaller level), or a root when L is 1. Levels that
25
+ // skip a step (1 -> 3) are clamped to one deeper than the current stack so nothing is orphaned.
26
+ const roots = [];
27
+ const stack = [];
28
+ for (const e of this.entries) {
29
+ const level = Math.max(1, Math.min(e.level, stack.length + 1));
30
+ stack.length = level - 1; // pop back to this entry's parent depth
31
+ const node = { ...e, children: [] };
32
+ if (level === 1)
33
+ roots.push(node);
34
+ else
35
+ stack[level - 2].children.push(node);
36
+ stack[level - 1] = node;
37
+ }
38
+ // Reserve an object number for every node up front - parent/child/prev/next all cross-reference.
39
+ const objOf = new Map();
40
+ const walk = (nodes) => {
41
+ for (const n of nodes) {
42
+ objOf.set(n, om.addObject(""));
43
+ walk(n.children);
44
+ }
45
+ };
46
+ walk(roots);
47
+ const rootNum = om.addObject(""); // the /Outlines dictionary itself
48
+ // Count of all descendants of a node (used for the /Count of an open item, which shows them all).
49
+ const descendantCount = (n) => n.children.reduce((sum, c) => sum + 1 + descendantCount(c), 0);
50
+ const totalCount = roots.reduce((sum, r) => sum + 1 + descendantCount(r), 0);
51
+ // Emit each item dict, wired to its parent, siblings (prev/next) and first/last child.
52
+ const emit = (nodes, parentNum) => {
53
+ nodes.forEach((n, i) => {
54
+ const parts = [`/Title ${om.pdfString(n.title)}`, `/Parent ${parentNum} 0 R`];
55
+ if (i > 0)
56
+ parts.push(`/Prev ${objOf.get(nodes[i - 1])} 0 R`);
57
+ if (i < nodes.length - 1)
58
+ parts.push(`/Next ${objOf.get(nodes[i + 1])} 0 R`);
59
+ if (n.children.length > 0) {
60
+ parts.push(`/First ${objOf.get(n.children[0])} 0 R`);
61
+ parts.push(`/Last ${objOf.get(n.children[n.children.length - 1])} 0 R`);
62
+ parts.push(`/Count ${descendantCount(n)}`); // positive = shown open
63
+ }
64
+ // /Dest: jump to this page, scrolling the target's top into view; null left/zoom keep the
65
+ // viewer's current horizontal position and magnification. Guard the top: a non-finite value
66
+ // (e.g. a bookmark under a Spacer in an unbounded column) would emit invalid PDF, so fall back
67
+ // to the page top (0 flips to the page top edge).
68
+ const top = Number.isFinite(n.top) ? num(n.top) : 0;
69
+ parts.push(`/Dest [${n.pageObjNum} 0 R /XYZ null ${top} null]`);
70
+ om.replaceObject(objOf.get(n), `<< ${parts.join(" ")} >>`);
71
+ emit(n.children, objOf.get(n));
72
+ });
73
+ };
74
+ emit(roots, rootNum);
75
+ om.replaceObject(rootNum, `<< /Type /Outlines /First ${objOf.get(roots[0])} 0 R ` +
76
+ `/Last ${objOf.get(roots[roots.length - 1])} 0 R /Count ${totalCount} >>`);
77
+ return `/Outlines ${rootNum} 0 R`;
78
+ }
79
+ }