pagyra-js 0.0.1

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 (540) hide show
  1. package/.eslintrc.json +30 -0
  2. package/CHANGELOG.md +13 -0
  3. package/README.md +275 -0
  4. package/UA_Styles_Chromium.md +93 -0
  5. package/_ext/woff2_conversion/brotli-decode.d.ts +139 -0
  6. package/_ext/woff2_conversion/brotli-encode.d.ts +129 -0
  7. package/_ext/woff2_conversion/brotli-port.d.ts +12 -0
  8. package/_ext/woff2_conversion/brotli-shared-dictionary.d.ts +25 -0
  9. package/_ext/woff2_conversion/brotli-types.d.ts +15 -0
  10. package/_ext/woff2_conversion/woff2-common.d.ts +37 -0
  11. package/_ext/woff2_conversion/woff2-decode.d.ts +32 -0
  12. package/_ext/woff2_conversion/woff2-encode.d.ts +31 -0
  13. package/_ext/woff2_conversion/woff2-output.d.ts +39 -0
  14. package/_ext/woff2_original_cpp/brotli/brotli.c +1559 -0
  15. package/_ext/woff2_original_cpp/brotli/brotli.md +116 -0
  16. package/_ext/woff2_original_cpp/brotli/decode.h +409 -0
  17. package/_ext/woff2_original_cpp/brotli/encode.h +505 -0
  18. package/_ext/woff2_original_cpp/brotli/port.h +302 -0
  19. package/_ext/woff2_original_cpp/brotli/shared_dictionary.h +100 -0
  20. package/_ext/woff2_original_cpp/brotli/types.h +83 -0
  21. package/_ext/woff2_original_cpp/cmake/FindBrotliDec.cmake +35 -0
  22. package/_ext/woff2_original_cpp/cmake/FindBrotliEnc.cmake +35 -0
  23. package/_ext/woff2_original_cpp/include/woff2/decode.h +36 -0
  24. package/_ext/woff2_original_cpp/include/woff2/encode.h +43 -0
  25. package/_ext/woff2_original_cpp/include/woff2/output.h +86 -0
  26. package/_ext/woff2_original_cpp/src/buffer.h +164 -0
  27. package/_ext/woff2_original_cpp/src/convert_woff2ttf_fuzzer.cc +13 -0
  28. package/_ext/woff2_original_cpp/src/convert_woff2ttf_fuzzer_new_entry.cc +12 -0
  29. package/_ext/woff2_original_cpp/src/file.h +30 -0
  30. package/_ext/woff2_original_cpp/src/font.cc +400 -0
  31. package/_ext/woff2_original_cpp/src/font.h +105 -0
  32. package/_ext/woff2_original_cpp/src/glyph.cc +383 -0
  33. package/_ext/woff2_original_cpp/src/glyph.h +71 -0
  34. package/_ext/woff2_original_cpp/src/normalize.cc +314 -0
  35. package/_ext/woff2_original_cpp/src/normalize.h +39 -0
  36. package/_ext/woff2_original_cpp/src/port.h +66 -0
  37. package/_ext/woff2_original_cpp/src/round.h +27 -0
  38. package/_ext/woff2_original_cpp/src/store_bytes.h +55 -0
  39. package/_ext/woff2_original_cpp/src/table_tags.cc +82 -0
  40. package/_ext/woff2_original_cpp/src/table_tags.h +30 -0
  41. package/_ext/woff2_original_cpp/src/transform.cc +430 -0
  42. package/_ext/woff2_original_cpp/src/transform.h +26 -0
  43. package/_ext/woff2_original_cpp/src/variable_length.cc +129 -0
  44. package/_ext/woff2_original_cpp/src/variable_length.h +30 -0
  45. package/_ext/woff2_original_cpp/src/woff2_common.cc +50 -0
  46. package/_ext/woff2_original_cpp/src/woff2_common.h +64 -0
  47. package/_ext/woff2_original_cpp/src/woff2_compress.cc +43 -0
  48. package/_ext/woff2_original_cpp/src/woff2_dec.cc +1398 -0
  49. package/_ext/woff2_original_cpp/src/woff2_decompress.cc +41 -0
  50. package/_ext/woff2_original_cpp/src/woff2_enc.cc +458 -0
  51. package/_ext/woff2_original_cpp/src/woff2_info.cc +142 -0
  52. package/_ext/woff2_original_cpp/src/woff2_out.cc +63 -0
  53. package/assets/fonts/ttf/arimo/Arimo-Bold.ttf +0 -0
  54. package/assets/fonts/ttf/arimo/Arimo-BoldItalic.ttf +0 -0
  55. package/assets/fonts/ttf/arimo/Arimo-Italic.ttf +0 -0
  56. package/assets/fonts/ttf/arimo/Arimo-Regular.ttf +0 -0
  57. package/assets/fonts/ttf/cinzeldecorative/CinzelDecorative-Black.ttf +0 -0
  58. package/assets/fonts/ttf/cinzeldecorative/CinzelDecorative-Bold.ttf +0 -0
  59. package/assets/fonts/ttf/cinzeldecorative/CinzelDecorative-Regular.ttf +0 -0
  60. package/assets/fonts/ttf/dejavu/DejaVuSans.ttf +0 -0
  61. package/assets/fonts/ttf/firecode/FiraCode-Bold.ttf +0 -0
  62. package/assets/fonts/ttf/firecode/FiraCode-Light.ttf +0 -0
  63. package/assets/fonts/ttf/firecode/FiraCode-Medium.ttf +0 -0
  64. package/assets/fonts/ttf/firecode/FiraCode-Regular.ttf +0 -0
  65. package/assets/fonts/ttf/firecode/FiraCode-SemiBold.ttf +0 -0
  66. package/assets/fonts/ttf/notoemoji/NotoEmoji-Bold.ttf +0 -0
  67. package/assets/fonts/ttf/notoemoji/NotoEmoji-Light.ttf +0 -0
  68. package/assets/fonts/ttf/notoemoji/NotoEmoji-Medium.ttf +0 -0
  69. package/assets/fonts/ttf/notoemoji/NotoEmoji-Regular.ttf +0 -0
  70. package/assets/fonts/ttf/notoemoji/NotoEmoji-SemiBold.ttf +0 -0
  71. package/assets/fonts/ttf/notosans/NotoSans-Regular.ttf +0 -0
  72. package/assets/fonts/ttf/roboto/Roboto-Bold.ttf +0 -0
  73. package/assets/fonts/ttf/roboto/Roboto-BoldItalic.ttf +0 -0
  74. package/assets/fonts/ttf/roboto/Roboto-Italic.ttf +0 -0
  75. package/assets/fonts/ttf/roboto/Roboto-Regular.ttf +0 -0
  76. package/assets/fonts/ttf/stixtwomath/STIXTwoMath-Regular.ttf +0 -0
  77. package/assets/fonts/ttf/tinos/Tinos-Bold.ttf +0 -0
  78. package/assets/fonts/ttf/tinos/Tinos-BoldItalic.ttf +0 -0
  79. package/assets/fonts/ttf/tinos/Tinos-Italic.ttf +0 -0
  80. package/assets/fonts/ttf/tinos/Tinos-Regular.ttf +0 -0
  81. package/assets/fonts/woff/lato/lato-latin-400-italic.woff +0 -0
  82. package/assets/fonts/woff/lato/lato-latin-400-normal.woff +0 -0
  83. package/assets/fonts/woff/lato/lato-latin-700-italic.woff +0 -0
  84. package/assets/fonts/woff/lato/lato-latin-700-normal.woff +0 -0
  85. package/assets/fonts/woff2/caveat/Caveat-Bold.woff2 +0 -0
  86. package/assets/fonts/woff2/caveat/Caveat-Regular.woff2 +0 -0
  87. package/assets/fonts/woff2/lato/lato-latin-400-italic.woff2 +0 -0
  88. package/assets/fonts/woff2/lato/lato-latin-400-normal.woff2 +0 -0
  89. package/assets/fonts/woff2/lato/lato-latin-700-italic.woff2 +0 -0
  90. package/assets/fonts/woff2/lato/lato-latin-700-normal.woff2 +0 -0
  91. package/docs/AGENTS.md +288 -0
  92. package/docs/BACKGROUND-REPEAT-IMPLEMENTATION.md +127 -0
  93. package/docs/BACKGROUND-REPEAT-REFERENCE.md +127 -0
  94. package/docs/BACKGROUND-REPEAT-SPACE-ROUND.md +164 -0
  95. package/docs/css-properties-support.md +256 -0
  96. package/docs/src_modules_table.md +172 -0
  97. package/docs/text-overlap-fix.md +85 -0
  98. package/docs/text-overlap-investigation.md +27 -0
  99. package/eslint.config.js +36 -0
  100. package/glyph_measure.htm +1458 -0
  101. package/package.json +50 -0
  102. package/playground/browser-entry.ts +2 -0
  103. package/playground/exports/background-text-debug.pdf +0 -0
  104. package/playground/public/app.js +875 -0
  105. package/playground/public/assets/1.webp +0 -0
  106. package/playground/public/examples/accents-test.html +24 -0
  107. package/playground/public/examples/advanced-selectors-demo.html +118 -0
  108. package/playground/public/examples/background-advanced-showcase.html +82 -0
  109. package/playground/public/examples/background-clip-text.html +36 -0
  110. package/playground/public/examples/background-origin-showcase.html +137 -0
  111. package/playground/public/examples/background-position-showcase.html +83 -0
  112. package/playground/public/examples/background-repeat-showcase.html +83 -0
  113. package/playground/public/examples/background-repeat-space-round.html +348 -0
  114. package/playground/public/examples/background-size-showcase.html +82 -0
  115. package/playground/public/examples/background-text-debug.html +18 -0
  116. package/playground/public/examples/baseline-test.html +24 -0
  117. package/playground/public/examples/bold-showcase.html +150 -0
  118. package/playground/public/examples/bold-strike-example.html +12 -0
  119. package/playground/public/examples/border-collapse-test.html +23 -0
  120. package/playground/public/examples/centered-shadow-div.html +72 -0
  121. package/playground/public/examples/css-variables.html +50 -0
  122. package/playground/public/examples/debug-accents.html +11 -0
  123. package/playground/public/examples/debug-text-overlap.html +46 -0
  124. package/playground/public/examples/flex-gap-column.html +130 -0
  125. package/playground/public/examples/flex-gap-row.html +137 -0
  126. package/playground/public/examples/flex-padding-test.html +29 -0
  127. package/playground/public/examples/flexbox-text-test.html +193 -0
  128. package/playground/public/examples/fonts-demo.html +126 -0
  129. package/playground/public/examples/footer-example.html +4 -0
  130. package/playground/public/examples/gradient-text.html +54 -0
  131. package/playground/public/examples/grid-gap-demo.html +156 -0
  132. package/playground/public/examples/header-example.html +4 -0
  133. package/playground/public/examples/header-footer-example.html +27 -0
  134. package/playground/public/examples/image-showcase.html +33 -0
  135. package/playground/public/examples/justify-text.html +22 -0
  136. package/playground/public/examples/linear-gradient-example.html +38 -0
  137. package/playground/public/examples/lorem-span.html +14 -0
  138. package/playground/public/examples/margin-block-showcase.html +21 -0
  139. package/playground/public/examples/margin-inline-showcase.html +21 -0
  140. package/playground/public/examples/monthly-summary.html +95 -0
  141. package/playground/public/examples/multi-page-lorem.html +190 -0
  142. package/playground/public/examples/opacity-debug.html +39 -0
  143. package/playground/public/examples/opacity-example.html +70 -0
  144. package/playground/public/examples/png-image-example.html +13 -0
  145. package/playground/public/examples/red-rectangle.html +18 -0
  146. package/playground/public/examples/repro.html +24 -0
  147. package/playground/public/examples/rounded-borders-test.html +24 -0
  148. package/playground/public/examples/simple-list.html +89 -0
  149. package/playground/public/examples/simple-svg.html +37 -0
  150. package/playground/public/examples/simple-table.html +52 -0
  151. package/playground/public/examples/skew-div.html +138 -0
  152. package/playground/public/examples/skew-text.html +21 -0
  153. package/playground/public/examples/starter-report.css +51 -0
  154. package/playground/public/examples/starter-report.html +23 -0
  155. package/playground/public/examples/svg-aspect-ratio-showcase.html +116 -0
  156. package/playground/public/examples/svg-gradients-linear.html +28 -0
  157. package/playground/public/examples/svg-gradients-radial.html +29 -0
  158. package/playground/public/examples/svg-gradients-showcase.html +66 -0
  159. package/playground/public/examples/svg-image-path-test.html +43 -0
  160. package/playground/public/examples/svg-images-clipping.html +27 -0
  161. package/playground/public/examples/svg-path-gallery.html +118 -0
  162. package/playground/public/examples/svg-radial-transform-demo.html +78 -0
  163. package/playground/public/examples/svg-transform-stack.html +103 -0
  164. package/playground/public/examples/svg-transforms-demo.html +127 -0
  165. package/playground/public/examples/table-merge-test.html +34 -0
  166. package/playground/public/examples/text-decoration-showcase.html +138 -0
  167. package/playground/public/examples/text-indent-showcase.html +137 -0
  168. package/playground/public/examples/text-shadow-example.html +29 -0
  169. package/playground/public/examples/very-complex-css.html +293 -0
  170. package/playground/public/examples/webp-example.html +13 -0
  171. package/playground/public/examples/z-index-demo.html +93 -0
  172. package/playground/public/examples.json +240 -0
  173. package/playground/public/images/dice.png +0 -0
  174. package/playground/public/images/duck.jpg +0 -0
  175. package/playground/public/index.html +149 -0
  176. package/playground/public/mode.js +1 -0
  177. package/playground/public/styles.css +382 -0
  178. package/playground/public/tmp-h2-debug.html +33 -0
  179. package/playground/public/tmp-italic-debug.html +32 -0
  180. package/playground/public/vendor/codemirror/codemirror.min.css +1 -0
  181. package/playground/public/vendor/codemirror/codemirror.min.js +1 -0
  182. package/playground/public/vendor/codemirror/css.min.js +1 -0
  183. package/playground/public/vendor/codemirror/darcula.min.css +1 -0
  184. package/playground/public/vendor/codemirror/htmlmixed.min.js +1 -0
  185. package/playground/public/vendor/codemirror/javascript.min.js +1 -0
  186. package/playground/public/vendor/codemirror/xml.min.js +1 -0
  187. package/playground/public/vendor/pagyra-playground-browser.js +165966 -0
  188. package/playground/public/vendor/pagyra-playground-browser.js.map +7 -0
  189. package/playground/server.d.ts +1 -0
  190. package/playground/server.js +68 -0
  191. package/playground/server.ts +128 -0
  192. package/scripts/browser-build.ts +101 -0
  193. package/scripts/build-browser-bundle.ts +52 -0
  194. package/scripts/glyph-comparison/simulate.ts +744 -0
  195. package/scripts/playground-browser-server.ts +57 -0
  196. package/scripts/probe-roboto.ts +6 -0
  197. package/scripts/render-playground-example.ts +121 -0
  198. package/scripts/run-glyph-atlas-tuner-runner.mjs +113 -0
  199. package/scripts/run-glyph-atlas-tuner.ts +141 -0
  200. package/scripts/top-ts-files.ps1 +39 -0
  201. package/scripts/top-ts-files.sh +37 -0
  202. package/scripts/woff2_info.ps1 +132 -0
  203. package/src/browser-entry.ts +14 -0
  204. package/src/compression/adler32.ts +45 -0
  205. package/src/compression/brotli/brotli.ts +463 -0
  206. package/src/compression/brotli/index.ts +15 -0
  207. package/src/compression/brotli/transform.ts +184 -0
  208. package/src/compression/brotli/types.ts +58 -0
  209. package/src/compression/brotli/utils.ts +157 -0
  210. package/src/compression/brotli/vendor/bit_reader.js +124 -0
  211. package/src/compression/brotli/vendor/context.js +250 -0
  212. package/src/compression/brotli/vendor/decode.d.ts +2 -0
  213. package/src/compression/brotli/vendor/decode.js +938 -0
  214. package/src/compression/brotli/vendor/dictionary-data.js +9469 -0
  215. package/src/compression/brotli/vendor/dictionary.js +36 -0
  216. package/src/compression/brotli/vendor/huffman.js +123 -0
  217. package/src/compression/brotli/vendor/package.json +3 -0
  218. package/src/compression/brotli/vendor/prefix.js +60 -0
  219. package/src/compression/brotli/vendor/streams.js +31 -0
  220. package/src/compression/brotli/vendor/transform.js +247 -0
  221. package/src/compression/brotli/vendor-decode.d.ts +4 -0
  222. package/src/compression/brotli/woff2-glyf-transform.ts +623 -0
  223. package/src/compression/decompress.ts +16 -0
  224. package/src/compression/deflate.ts +295 -0
  225. package/src/compression/index.ts +4 -0
  226. package/src/compression/types.ts +26 -0
  227. package/src/compression/utils.ts +107 -0
  228. package/src/core.ts +18 -0
  229. package/src/css/apply-declarations.ts +86 -0
  230. package/src/css/background-types.ts +65 -0
  231. package/src/css/browser-defaults.ts +16 -0
  232. package/src/css/clip-path-types.ts +13 -0
  233. package/src/css/compute-style.ts +494 -0
  234. package/src/css/css-unit-resolver.ts +65 -0
  235. package/src/css/custom-properties.ts +215 -0
  236. package/src/css/enums.ts +127 -0
  237. package/src/css/font-face-parser.ts +233 -0
  238. package/src/css/font-weight.ts +65 -0
  239. package/src/css/inline-style-parser.ts +27 -0
  240. package/src/css/layout-property-resolver.ts +75 -0
  241. package/src/css/length.ts +141 -0
  242. package/src/css/line-height.ts +96 -0
  243. package/src/css/named-colors.ts +150 -0
  244. package/src/css/parsers/background-parser-extended.ts +111 -0
  245. package/src/css/parsers/background-parser.ts +456 -0
  246. package/src/css/parsers/border-block-parser.ts +26 -0
  247. package/src/css/parsers/border-inline-parser.ts +26 -0
  248. package/src/css/parsers/border-parser-extended.ts +256 -0
  249. package/src/css/parsers/border-parser.ts +175 -0
  250. package/src/css/parsers/box-shadow-parser.ts +106 -0
  251. package/src/css/parsers/clip-path-parser.ts +92 -0
  252. package/src/css/parsers/color-parser.ts +14 -0
  253. package/src/css/parsers/dimension-parser.ts +117 -0
  254. package/src/css/parsers/display-flex-parser.ts +59 -0
  255. package/src/css/parsers/flex-parser.ts +144 -0
  256. package/src/css/parsers/font-parser.ts +40 -0
  257. package/src/css/parsers/gradient-parser.ts +366 -0
  258. package/src/css/parsers/grid-parser-extended.ts +55 -0
  259. package/src/css/parsers/grid-parser.ts +218 -0
  260. package/src/css/parsers/length-parser.ts +95 -0
  261. package/src/css/parsers/list-style-parser.ts +39 -0
  262. package/src/css/parsers/margin-block-parser.ts +12 -0
  263. package/src/css/parsers/margin-inline-parser.ts +12 -0
  264. package/src/css/parsers/margin-parser.ts +30 -0
  265. package/src/css/parsers/opacity-parser.ts +32 -0
  266. package/src/css/parsers/overflow-wrap-parser.ts +38 -0
  267. package/src/css/parsers/padding-block-parser.ts +12 -0
  268. package/src/css/parsers/padding-inline-parser.ts +12 -0
  269. package/src/css/parsers/padding-parser.ts +30 -0
  270. package/src/css/parsers/position-parser.ts +75 -0
  271. package/src/css/parsers/register-parsers.ts +302 -0
  272. package/src/css/parsers/registry.ts +18 -0
  273. package/src/css/parsers/text-parser-extended.ts +144 -0
  274. package/src/css/parsers/text-parser.ts +25 -0
  275. package/src/css/parsers/text-shadow-parser.ts +94 -0
  276. package/src/css/properties/box-model.ts +82 -0
  277. package/src/css/properties/flexbox.ts +44 -0
  278. package/src/css/properties/gap.ts +14 -0
  279. package/src/css/properties/grid.ts +94 -0
  280. package/src/css/properties/layout.ts +59 -0
  281. package/src/css/properties/misc.ts +44 -0
  282. package/src/css/properties/typography.ts +71 -0
  283. package/src/css/properties/visual.ts +68 -0
  284. package/src/css/selectors/matcher.ts +219 -0
  285. package/src/css/selectors/parser.ts +163 -0
  286. package/src/css/selectors/simple-key.ts +31 -0
  287. package/src/css/selectors/specificity.ts +41 -0
  288. package/src/css/selectors/types.ts +31 -0
  289. package/src/css/shorthands/border-shorthand.ts +68 -0
  290. package/src/css/shorthands/box-shorthand.ts +33 -0
  291. package/src/css/style-inheritance.ts +50 -0
  292. package/src/css/style.ts +402 -0
  293. package/src/css/ua-defaults/base-defaults.ts +266 -0
  294. package/src/css/ua-defaults/browser-defaults.ts +134 -0
  295. package/src/css/ua-defaults/element-defaults.ts +374 -0
  296. package/src/css/ua-defaults/types.ts +43 -0
  297. package/src/css/unit-conversion.ts +24 -0
  298. package/src/css/utils.ts +108 -0
  299. package/src/css/viewport.ts +17 -0
  300. package/src/debug/audit.ts +20 -0
  301. package/src/debug/ids.ts +13 -0
  302. package/src/debug/log.js +28 -0
  303. package/src/debug/log.ts +52 -0
  304. package/src/debug/tree.ts +57 -0
  305. package/src/dom/node.ts +133 -0
  306. package/src/environment/browser-environment.ts +78 -0
  307. package/src/environment/environment.ts +35 -0
  308. package/src/environment/global.ts +13 -0
  309. package/src/environment/node-environment.browser.ts +28 -0
  310. package/src/environment/node-environment.ts +64 -0
  311. package/src/fonts/detector.ts +28 -0
  312. package/src/fonts/engines/ttf-engine.ts +28 -0
  313. package/src/fonts/engines/woff-engine.ts +38 -0
  314. package/src/fonts/engines/woff2-engine.ts +41 -0
  315. package/src/fonts/extractors/metrics-extractor.ts +362 -0
  316. package/src/fonts/font-registry-resolver.ts +132 -0
  317. package/src/fonts/index.ts +3 -0
  318. package/src/fonts/orchestrator.ts +92 -0
  319. package/src/fonts/parsers/base-parser.ts +23 -0
  320. package/src/fonts/types.ts +85 -0
  321. package/src/fonts/utils/ttf-reconstructor.ts +120 -0
  322. package/src/fonts/woff/decoder.ts +105 -0
  323. package/src/fonts/woff2/buffer.ts +106 -0
  324. package/src/fonts/woff2/decoder.ts +981 -0
  325. package/src/geometry/box.ts +48 -0
  326. package/src/geometry/matrix.ts +59 -0
  327. package/src/html/css/parse-css.ts +85 -0
  328. package/src/html/dom-converter.ts +433 -0
  329. package/src/html/image-converter.ts +200 -0
  330. package/src/html-to-pdf.ts +410 -0
  331. package/src/image/base-decoder.ts +149 -0
  332. package/src/image/image-service.ts +188 -0
  333. package/src/image/jpeg-decoder.ts +73 -0
  334. package/src/image/png-decoder.ts +550 -0
  335. package/src/image/types.ts +20 -0
  336. package/src/image/webp-decoder.ts +242 -0
  337. package/src/image/webp-huffman.ts +218 -0
  338. package/src/image/webp-riff-parser.ts +54 -0
  339. package/src/image/webp-vp8l-decoder.ts +199 -0
  340. package/src/index.ts +35 -0
  341. package/src/layout/context/float-context.ts +62 -0
  342. package/src/layout/context/layout-environment.ts +29 -0
  343. package/src/layout/debug.ts +18 -0
  344. package/src/layout/inline/bounding-box-calculator.ts +132 -0
  345. package/src/layout/inline/font-baseline-calculator.ts +76 -0
  346. package/src/layout/inline/inline-utils.ts +94 -0
  347. package/src/layout/inline/layout.ts +285 -0
  348. package/src/layout/inline/line_breaker.ts +109 -0
  349. package/src/layout/inline/measurement.ts +144 -0
  350. package/src/layout/inline/run-placer.ts +139 -0
  351. package/src/layout/inline/text-alignment.ts +70 -0
  352. package/src/layout/inline/tokenizer.ts +195 -0
  353. package/src/layout/inline/types.ts +76 -0
  354. package/src/layout/pipeline/context-factory.ts +16 -0
  355. package/src/layout/pipeline/default-engine.ts +24 -0
  356. package/src/layout/pipeline/engine.ts +59 -0
  357. package/src/layout/pipeline/layout-tree.ts +13 -0
  358. package/src/layout/pipeline/out-of-flow-manager.ts +73 -0
  359. package/src/layout/pipeline/strategy.ts +12 -0
  360. package/src/layout/pipeline/text-metrics-initializer.ts +13 -0
  361. package/src/layout/strategies/block.ts +236 -0
  362. package/src/layout/strategies/display-none.ts +14 -0
  363. package/src/layout/strategies/fallback.ts +15 -0
  364. package/src/layout/strategies/flex.ts +477 -0
  365. package/src/layout/strategies/fragmentation.ts +17 -0
  366. package/src/layout/strategies/grid.ts +247 -0
  367. package/src/layout/strategies/image.ts +342 -0
  368. package/src/layout/strategies/inline.ts +128 -0
  369. package/src/layout/strategies/table.ts +595 -0
  370. package/src/layout/table/cell_layout.ts +31 -0
  371. package/src/layout/table/diagnostics.ts +19 -0
  372. package/src/layout/text-run.ts +42 -0
  373. package/src/layout/utils/content-measurer.ts +117 -0
  374. package/src/layout/utils/display-utils.ts +24 -0
  375. package/src/layout/utils/floats.ts +98 -0
  376. package/src/layout/utils/gap-calculator.ts +167 -0
  377. package/src/layout/utils/inline-formatter.ts +31 -0
  378. package/src/layout/utils/inline-formatting.ts +9 -0
  379. package/src/layout/utils/margin.ts +140 -0
  380. package/src/layout/utils/node-math.ts +237 -0
  381. package/src/layout/utils/overflow.ts +14 -0
  382. package/src/layout/utils/sizing.ts +12 -0
  383. package/src/layout/utils/text-metrics.ts +361 -0
  384. package/src/logging/debug.ts +58 -0
  385. package/src/pdf/font/base14/widths-courier-bold.ts +159 -0
  386. package/src/pdf/font/base14/widths-courier.ts +159 -0
  387. package/src/pdf/font/base14/widths-helvetica-bold.ts +158 -0
  388. package/src/pdf/font/base14/widths-helvetica.ts +158 -0
  389. package/src/pdf/font/base14/widths-times-bold.ts +158 -0
  390. package/src/pdf/font/base14/widths-times-roman.ts +158 -0
  391. package/src/pdf/font/base14/widths-types.ts +25 -0
  392. package/src/pdf/font/base14-widths.ts +32 -0
  393. package/src/pdf/font/blur.ts +81 -0
  394. package/src/pdf/font/builtin-fonts.browser.ts +262 -0
  395. package/src/pdf/font/builtin-fonts.ts +126 -0
  396. package/src/pdf/font/composite-glyph-parser.ts +242 -0
  397. package/src/pdf/font/embedder.ts +395 -0
  398. package/src/pdf/font/font-config.ts +190 -0
  399. package/src/pdf/font/font-registry.ts +263 -0
  400. package/src/pdf/font/font-subset.ts +258 -0
  401. package/src/pdf/font/glyph-atlas-maxrects.ts +305 -0
  402. package/src/pdf/font/glyph-atlas-tuner.ts +98 -0
  403. package/src/pdf/font/glyph-atlas.ts +226 -0
  404. package/src/pdf/font/glyph-cache.ts +127 -0
  405. package/src/pdf/font/loca-reader.ts +109 -0
  406. package/src/pdf/font/managers/font-resource-manager.ts +73 -0
  407. package/src/pdf/font/managers/subset-resource-manager.ts +164 -0
  408. package/src/pdf/font/rasterizer.ts +270 -0
  409. package/src/pdf/font/resolvers/base-font-mapper.ts +77 -0
  410. package/src/pdf/font/resolvers/family-resolver.ts +33 -0
  411. package/src/pdf/font/resolvers/weight-style-applicator.ts +63 -0
  412. package/src/pdf/font/simple-glyph-parser.ts +289 -0
  413. package/src/pdf/font/to-unicode.ts +109 -0
  414. package/src/pdf/font/transformation-matrix.ts +136 -0
  415. package/src/pdf/font/ttf-cmap.ts +180 -0
  416. package/src/pdf/font/ttf-global-metrics.ts +58 -0
  417. package/src/pdf/font/ttf-glyf.ts +125 -0
  418. package/src/pdf/font/ttf-glyph-metrics.ts +43 -0
  419. package/src/pdf/font/ttf-lite.ts +269 -0
  420. package/src/pdf/font/ttf-table-parser.ts +132 -0
  421. package/src/pdf/font/ttf-table-provider.ts +61 -0
  422. package/src/pdf/font/widths.ts +79 -0
  423. package/src/pdf/font-subset/font-registry.ts +127 -0
  424. package/src/pdf/header-footer-layout.ts +153 -0
  425. package/src/pdf/header-footer-painter.ts +209 -0
  426. package/src/pdf/header-footer-renderer.ts +357 -0
  427. package/src/pdf/header-footer-tokens.ts +55 -0
  428. package/src/pdf/header-footer.ts +25 -0
  429. package/src/pdf/layout-tree-builder.ts +261 -0
  430. package/src/pdf/page-painter.ts +241 -0
  431. package/src/pdf/pagination.ts +155 -0
  432. package/src/pdf/primitives/pdf-builder.ts +378 -0
  433. package/src/pdf/primitives/pdf-bytes.ts +40 -0
  434. package/src/pdf/primitives/pdf-document.ts +108 -0
  435. package/src/pdf/primitives/pdf-reference-manager.ts +47 -0
  436. package/src/pdf/primitives/pdf-resource-registries.ts +255 -0
  437. package/src/pdf/primitives/pdf-serializers.ts +194 -0
  438. package/src/pdf/primitives/pdf-types.ts +73 -0
  439. package/src/pdf/render.ts +210 -0
  440. package/src/pdf/renderer/box-painter.ts +236 -0
  441. package/src/pdf/renderer/page-paint.ts +102 -0
  442. package/src/pdf/renderer/paint-box-shadows.ts +218 -0
  443. package/src/pdf/renderer/radius.ts +58 -0
  444. package/src/pdf/renderers/graphics-state-manager.ts +40 -0
  445. package/src/pdf/renderers/image-renderer.ts +127 -0
  446. package/src/pdf/renderers/radius-utils.ts +80 -0
  447. package/src/pdf/renderers/rectangle-renderer.ts +129 -0
  448. package/src/pdf/renderers/rounded-rect-path.ts +120 -0
  449. package/src/pdf/renderers/shape-renderer.ts +563 -0
  450. package/src/pdf/renderers/shape-utils.ts +194 -0
  451. package/src/pdf/renderers/text-decoration-renderer.ts +313 -0
  452. package/src/pdf/renderers/text-encoder.ts +41 -0
  453. package/src/pdf/renderers/text-font-resolver.ts +75 -0
  454. package/src/pdf/renderers/text-renderer-utils.ts +28 -0
  455. package/src/pdf/renderers/text-renderer.ts +391 -0
  456. package/src/pdf/renderers/text-shadow-renderer.ts +300 -0
  457. package/src/pdf/shading/gradient-service.ts +525 -0
  458. package/src/pdf/shading/index.ts +1 -0
  459. package/src/pdf/stacking/build-stacking-contexts.ts +93 -0
  460. package/src/pdf/stacking/resolve-paint-order.ts +157 -0
  461. package/src/pdf/stacking/types.ts +40 -0
  462. package/src/pdf/svg/aspect-ratio.ts +81 -0
  463. package/src/pdf/svg/coordinate-mapper.ts +81 -0
  464. package/src/pdf/svg/geometry-builder.ts +45 -0
  465. package/src/pdf/svg/render-svg.ts +296 -0
  466. package/src/pdf/svg/shape-renderer.ts +463 -0
  467. package/src/pdf/svg/style-computer.ts +246 -0
  468. package/src/pdf/transform-adapter.ts +26 -0
  469. package/src/pdf/types.ts +377 -0
  470. package/src/pdf/utils/background-layer-resolver.ts +439 -0
  471. package/src/pdf/utils/background-tiles.ts +192 -0
  472. package/src/pdf/utils/border-dashes.ts +109 -0
  473. package/src/pdf/utils/border-radius-utils.ts +86 -0
  474. package/src/pdf/utils/box-dimensions-utils.ts +47 -0
  475. package/src/pdf/utils/clip-path-resolver.ts +50 -0
  476. package/src/pdf/utils/clipping-path-builder.ts +190 -0
  477. package/src/pdf/utils/color-utils.ts +102 -0
  478. package/src/pdf/utils/coordinate-transformer.ts +30 -0
  479. package/src/pdf/utils/drop-shadow-raster.ts +233 -0
  480. package/src/pdf/utils/encoding.ts +98 -0
  481. package/src/pdf/utils/glyph-atlas-registrar.ts +13 -0
  482. package/src/pdf/utils/glyph-run-renderer.ts +129 -0
  483. package/src/pdf/utils/image-command-partitioner.ts +28 -0
  484. package/src/pdf/utils/image-matrix-builder.ts +31 -0
  485. package/src/pdf/utils/image-utils.ts +26 -0
  486. package/src/pdf/utils/list-utils.ts +194 -0
  487. package/src/pdf/utils/node-text-run-factory.ts +202 -0
  488. package/src/pdf/utils/page-resource-registrar.ts +46 -0
  489. package/src/pdf/utils/result-combiner.ts +102 -0
  490. package/src/pdf/utils/shadow-utils.ts +127 -0
  491. package/src/pdf/utils/text-alignment-resolver.ts +76 -0
  492. package/src/pdf/utils/text-decoration-utils.ts +64 -0
  493. package/src/pdf/utils/text-layout-adjuster.ts +185 -0
  494. package/src/pdf/utils/text-utils.ts +193 -0
  495. package/src/pdf/utils/transform-scope-manager.ts +69 -0
  496. package/src/render/offset.ts +170 -0
  497. package/src/shim/empty.ts +2 -0
  498. package/src/shim/fs-empty.ts +5 -0
  499. package/src/shim/url-empty.ts +7 -0
  500. package/src/shim/zlib-empty.ts +9 -0
  501. package/src/style/shorthands/index.ts +19 -0
  502. package/src/style/ua/defaults.ts +69 -0
  503. package/src/svg/index.ts +4 -0
  504. package/src/svg/parser-registry.ts +71 -0
  505. package/src/svg/parser.ts +486 -0
  506. package/src/svg/path-data.ts +515 -0
  507. package/src/svg/types.ts +194 -0
  508. package/src/text/line-breaker.ts +321 -0
  509. package/src/text/text-transform.ts +43 -0
  510. package/src/text/text.ts +33 -0
  511. package/src/transform/css-parser.ts +95 -0
  512. package/src/types/fonts.ts +62 -0
  513. package/src/types/public.ts +19 -0
  514. package/src/units/page-utils.ts +58 -0
  515. package/src/units/units.ts +50 -0
  516. package/src/utils/base64.ts +24 -0
  517. package/test-output.txt +79 -0
  518. package/tests/css/background-parser.spec.ts +14 -0
  519. package/tests/css/clip-path-parser.spec.ts +66 -0
  520. package/tests/environment/path-resolution.spec.ts +104 -0
  521. package/tests/helpers/ai-layout-diagnostics.ts +141 -0
  522. package/tests/helpers/render-utils.ts +52 -0
  523. package/tests/helpers/text-geometry.ts +56 -0
  524. package/tests/layout/custom-properties.test.ts +38 -0
  525. package/tests/layout/gap-calculator.spec.ts +196 -0
  526. package/tests/layout/inline-background-alignment.spec.ts +93 -0
  527. package/tests/layout/inline-fragments.spec.ts +26 -0
  528. package/tests/layout/run-placer-baseline.spec.ts +108 -0
  529. package/tests/pdf/alignments.spec.ts +26 -0
  530. package/tests/pdf/background-clip.spec.ts +57 -0
  531. package/tests/pdf/background-repeat-space-round.spec.ts +35 -0
  532. package/tests/pdf/background-repeat.spec.ts +137 -0
  533. package/tests/pdf/border-radius.spec.ts +151 -0
  534. package/tests/pdf/clip-path.spec.ts +92 -0
  535. package/tests/pdf/radial-gradient.spec.ts +50 -0
  536. package/tests/pdf/svg-stroke-dash.spec.ts +81 -0
  537. package/tests/pdf/text-transform-matrix.spec.ts +43 -0
  538. package/tsconfig.json +17 -0
  539. package/types/fonts.js +10 -0
  540. package/vitest.config.ts +9 -0
@@ -0,0 +1,875 @@
1
+ /* global CodeMirror */
2
+
3
+ const DOM = {
4
+ htmlInput: /** @type {HTMLTextAreaElement} */ (document.getElementById("html-input")),
5
+ cssInput: /** @type {HTMLTextAreaElement} */ (document.getElementById("css-input")),
6
+ headerInput: /** @type {HTMLTextAreaElement} */ (document.getElementById("header-input")),
7
+ footerInput: /** @type {HTMLTextAreaElement} */ (document.getElementById("footer-input")),
8
+ renderButton: /** @type {HTMLButtonElement} */ (document.getElementById("render-btn")),
9
+ exampleSelect: /** @type {HTMLSelectElement} */ (document.getElementById("example-select")),
10
+ status: /** @type {HTMLParagraphElement} */ (document.getElementById("status")),
11
+ pdfViewer: /** @type {HTMLObjectElement} */ (document.getElementById("pdf-viewer")),
12
+ htmlViewer: /** @type {HTMLIFrameElement} */ (document.getElementById("html-viewer")),
13
+ editorTabButtons: /** @type {NodeListOf<HTMLButtonElement>} */ (document.querySelectorAll(".editor-panel .tab-button")),
14
+ previewTabButtons: /** @type {NodeListOf<HTMLButtonElement>} */ (document.querySelectorAll(".preview-panel .tab-button")),
15
+ viewportWidth: /** @type {HTMLInputElement} */ (document.getElementById("viewport-width")),
16
+ viewportHeight: /** @type {HTMLInputElement} */ (document.getElementById("viewport-height")),
17
+ ckeditorToggle: /** @type {HTMLInputElement} */ (document.getElementById("ckeditor-toggle")),
18
+ ckeditorCss: /** @type {HTMLLinkElement} */ (document.getElementById("ckeditor-css")),
19
+ ckeditorScript: /** @type {HTMLScriptElement} */ (document.getElementById("ckeditor-script")),
20
+ logLevel: /** @type {HTMLSelectElement | null} */ (document.getElementById("log-level")),
21
+ debugCategoriesContainer: /** @type {HTMLDivElement | null} */ (document.getElementById("debug-categories-container")),
22
+ logSelectAll: /** @type {HTMLButtonElement | null} */ (document.getElementById("log-select-all")),
23
+ logSelectNone: /** @type {HTMLButtonElement | null} */ (document.getElementById("log-select-none")),
24
+ };
25
+
26
+ const PAGE_DEFAULTS = {
27
+ pxPerPt: 96 / 72,
28
+ widthPt: 595.28,
29
+ heightPt: 841.89,
30
+ marginPt: 36,
31
+ };
32
+
33
+ const PAGE_DIMENSIONS = {
34
+ widthPx: PAGE_DEFAULTS.widthPt * PAGE_DEFAULTS.pxPerPt,
35
+ heightPx: PAGE_DEFAULTS.heightPt * PAGE_DEFAULTS.pxPerPt,
36
+ marginPx: PAGE_DEFAULTS.marginPt * PAGE_DEFAULTS.pxPerPt,
37
+ };
38
+
39
+ const PAGE_MARGINS = {
40
+ top: PAGE_DIMENSIONS.marginPx,
41
+ right: PAGE_DIMENSIONS.marginPx,
42
+ bottom: PAGE_DIMENSIONS.marginPx,
43
+ left: PAGE_DIMENSIONS.marginPx,
44
+ };
45
+
46
+ const CONTENT_DEFAULTS = {
47
+ widthPx: PAGE_DIMENSIONS.widthPx - PAGE_DIMENSIONS.marginPx * 2,
48
+ heightPx: PAGE_DIMENSIONS.heightPx - PAGE_DIMENSIONS.marginPx * 2,
49
+ };
50
+
51
+ const DEFAULT_PAGE_MARGINS_PX = {
52
+ top: PAGE_MARGINS.top,
53
+ right: PAGE_MARGINS.right,
54
+ bottom: PAGE_MARGINS.bottom,
55
+ left: PAGE_MARGINS.left,
56
+ };
57
+ const DEFAULT_PAGE_WIDTH_PX = PAGE_DIMENSIONS.widthPx;
58
+ const DEFAULT_PAGE_HEIGHT_PX = PAGE_DIMENSIONS.heightPx;
59
+ const PLAYGROUND_MODE = (window.__PLAYGROUND_MODE ?? "node").toLowerCase();
60
+ const IS_BROWSER_MODE = PLAYGROUND_MODE === "browser";
61
+
62
+ let browserRenderHtmlToPdf = null;
63
+ let browserLogCategories = [];
64
+ let browserRendererPromise = null;
65
+
66
+ function sanitizeDimension(value, fallback) {
67
+ if (!Number.isFinite(value ?? NaN)) {
68
+ return fallback;
69
+ }
70
+ const sanitized = Number(value);
71
+ return sanitized > 0 ? sanitized : fallback;
72
+ }
73
+
74
+ function maxContentDimension(total, marginsSum) {
75
+ return Math.max(1, total - marginsSum);
76
+ }
77
+
78
+ function resolvePageMarginsPx(pageWidthPx, pageHeightPx) {
79
+ const margins = { ...DEFAULT_PAGE_MARGINS_PX };
80
+ const horizontalSum = margins.left + margins.right;
81
+ const verticalSum = margins.top + margins.bottom;
82
+ const usableWidth = maxContentDimension(pageWidthPx, 0);
83
+ const usableHeight = maxContentDimension(pageHeightPx, 0);
84
+
85
+ if (horizontalSum > usableWidth) {
86
+ const scale = usableWidth / (horizontalSum || 1);
87
+ margins.left *= scale;
88
+ margins.right *= scale;
89
+ }
90
+ if (verticalSum > usableHeight) {
91
+ const scale = usableHeight / (verticalSum || 1);
92
+ margins.top *= scale;
93
+ margins.bottom *= scale;
94
+ }
95
+ return margins;
96
+ }
97
+
98
+ async function ensureBrowserRenderer() {
99
+ if (!IS_BROWSER_MODE) {
100
+ return;
101
+ }
102
+ if (browserRendererPromise) {
103
+ return browserRendererPromise;
104
+ }
105
+ browserRendererPromise = import("./vendor/pagyra-playground-browser.js")
106
+ .then((module) => {
107
+ browserRenderHtmlToPdf = module.renderHtmlToPdfBrowser;
108
+ browserLogCategories = Array.isArray(module.LOG_CATEGORIES) ? module.LOG_CATEGORIES : [];
109
+ })
110
+ .catch((error) => {
111
+ browserRendererPromise = null;
112
+ console.error("[playground] failed to load browser renderer bundle:", error);
113
+ throw error;
114
+ });
115
+ return browserRendererPromise;
116
+ }
117
+
118
+ function computeBrowserResourceBase(documentPath) {
119
+ const origin = window.location.origin;
120
+ const defaultBase = origin.endsWith("/") ? origin : `${origin}/`;
121
+ if (!documentPath) {
122
+ return { resourceBaseDir: defaultBase, assetRootDir: defaultBase };
123
+ }
124
+ try {
125
+ const normalized = documentPath.startsWith("/") ? documentPath : `/${documentPath}`;
126
+ const docUrl = new URL(normalized, origin);
127
+ docUrl.hash = "";
128
+ docUrl.search = "";
129
+ const directory = new URL(".", docUrl);
130
+ return { resourceBaseDir: directory.toString(), assetRootDir: defaultBase };
131
+ } catch (error) {
132
+ console.warn("[playground] failed to compute resource base:", error);
133
+ return { resourceBaseDir: defaultBase, assetRootDir: defaultBase };
134
+ }
135
+ }
136
+
137
+ function buildHeaderFooter(headerHtml, footerHtml) {
138
+ const headerFooter = {};
139
+ if (headerHtml) {
140
+ headerFooter.headerHtml = headerHtml;
141
+ headerFooter.maxHeaderHeightPx = headerFooter.maxHeaderHeightPx ?? 64;
142
+ }
143
+ if (footerHtml) {
144
+ headerFooter.footerHtml = footerHtml;
145
+ headerFooter.maxFooterHeightPx = headerFooter.maxFooterHeightPx ?? 64;
146
+ }
147
+ return Object.keys(headerFooter).length ? headerFooter : undefined;
148
+ }
149
+
150
+ function renderDebugCategoryCheckboxes(categories) {
151
+ if (!DOM.debugCategoriesContainer) return;
152
+ DOM.debugCategoriesContainer.innerHTML = "";
153
+ if (!categories.length) {
154
+ DOM.debugCategoriesContainer.textContent = "No categories available.";
155
+ return;
156
+ }
157
+ for (const cat of categories) {
158
+ const label = document.createElement("label");
159
+ const input = document.createElement("input");
160
+ input.type = "checkbox";
161
+ input.value = cat;
162
+ input.className = "log-cat";
163
+ label.append(input, ` ${cat.charAt(0).toUpperCase() + cat.slice(1)}`);
164
+ DOM.debugCategoriesContainer.append(label);
165
+ }
166
+ }
167
+
168
+ const STATUS_COLORS = {
169
+ neutral: "#94a3b8",
170
+ success: "#38bdf8",
171
+ error: "#f97316",
172
+ };
173
+
174
+ let currentObjectUrl = "";
175
+ /** @type {CodeMirror.EditorFromTextArea | null} */
176
+ let htmlEditor = null;
177
+ /** @type {CodeMirror.EditorFromTextArea | null} */
178
+ let cssEditor = null;
179
+ /** @type {CodeMirror.EditorFromTextArea | null} */
180
+ let headerEditor = null;
181
+ /** @type {CodeMirror.EditorFromTextArea | null} */
182
+ let footerEditor = null;
183
+ /** @type {any} */
184
+ let ckeditorInstance = null;
185
+ /** @type {boolean} */
186
+ let useCKEditor = false;
187
+
188
+ const CODEMIRROR_BASE_OPTIONS = {
189
+ theme: "darcula",
190
+ lineNumbers: true,
191
+ lineWrapping: true,
192
+ tabSize: 2,
193
+ indentUnit: 2,
194
+ indentWithTabs: false,
195
+ };
196
+
197
+ function getHtmlValue() {
198
+ if (useCKEditor && ckeditorInstance) {
199
+ return ckeditorInstance.getData();
200
+ }
201
+ if (htmlEditor) {
202
+ return htmlEditor.getValue();
203
+ }
204
+ return DOM.htmlInput.value;
205
+ }
206
+
207
+ function getCssValue() {
208
+ if (cssEditor) {
209
+ return cssEditor.getValue();
210
+ }
211
+ return DOM.cssInput.value;
212
+ }
213
+
214
+ function getHeaderValue() {
215
+ if (headerEditor) {
216
+ return headerEditor.getValue();
217
+ }
218
+ return DOM.headerInput.value;
219
+ }
220
+
221
+ function getFooterValue() {
222
+ if (footerEditor) {
223
+ return footerEditor.getValue();
224
+ }
225
+ return DOM.footerInput.value;
226
+ }
227
+
228
+ function setHtmlValue(value) {
229
+ if (useCKEditor && ckeditorInstance) {
230
+ ckeditorInstance.setData(value);
231
+ } else if (htmlEditor) {
232
+ htmlEditor.setValue(value);
233
+ htmlEditor.refresh();
234
+ } else {
235
+ DOM.htmlInput.value = value;
236
+ }
237
+ }
238
+
239
+ function setCssValue(value) {
240
+ if (cssEditor) {
241
+ cssEditor.setValue(value);
242
+ cssEditor.refresh();
243
+ } else {
244
+ DOM.cssInput.value = value;
245
+ }
246
+ }
247
+
248
+ function setHeaderValue(value) {
249
+ if (headerEditor) {
250
+ headerEditor.setValue(value);
251
+ headerEditor.refresh();
252
+ } else {
253
+ DOM.headerInput.value = value;
254
+ }
255
+ }
256
+
257
+ function setFooterValue(value) {
258
+ if (footerEditor) {
259
+ footerEditor.setValue(value);
260
+ footerEditor.refresh();
261
+ } else {
262
+ DOM.footerInput.value = value;
263
+ }
264
+ }
265
+
266
+ function initializeEditors() {
267
+ if (typeof CodeMirror === "undefined") {
268
+ console.warn("CodeMirror not loaded. Falling back to plain textareas.");
269
+ return;
270
+ }
271
+
272
+ if (DOM.htmlInput && !htmlEditor) {
273
+ htmlEditor = CodeMirror.fromTextArea(DOM.htmlInput, {
274
+ ...CODEMIRROR_BASE_OPTIONS,
275
+ mode: "htmlmixed",
276
+ });
277
+ htmlEditor.setSize("100%", "100%");
278
+ htmlEditor.on("change", handleInputChange);
279
+ }
280
+
281
+ if (DOM.cssInput && !cssEditor) {
282
+ cssEditor = CodeMirror.fromTextArea(DOM.cssInput, {
283
+ ...CODEMIRROR_BASE_OPTIONS,
284
+ mode: "css",
285
+ });
286
+ cssEditor.setSize("100%", "100%");
287
+ cssEditor.on("change", handleInputChange);
288
+ }
289
+
290
+ if (DOM.headerInput && !headerEditor) {
291
+ headerEditor = CodeMirror.fromTextArea(DOM.headerInput, {
292
+ ...CODEMIRROR_BASE_OPTIONS,
293
+ mode: "htmlmixed",
294
+ });
295
+ headerEditor.setSize("100%", "100%");
296
+ }
297
+
298
+ if (DOM.footerInput && !footerEditor) {
299
+ footerEditor = CodeMirror.fromTextArea(DOM.footerInput, {
300
+ ...CODEMIRROR_BASE_OPTIONS,
301
+ mode: "htmlmixed",
302
+ });
303
+ footerEditor.setSize("100%", "100%");
304
+ }
305
+ }
306
+
307
+ /**
308
+ * @typedef {{ id: string; label: string; htmlUrl: string; cssUrl?: string; headerUrl?: string; footerUrl?: string }} PlaygroundExample
309
+ */
310
+
311
+ /** @type {PlaygroundExample[]} */
312
+ let examples = [];
313
+ /** @type {Map<string, PlaygroundExample>} */
314
+ let exampleLookup = new Map();
315
+ let activeExampleId = "";
316
+
317
+ function setStatus(message, tone = "neutral") {
318
+ if (!DOM.status) {
319
+ return;
320
+ }
321
+ DOM.status.textContent = message;
322
+ DOM.status.style.color = STATUS_COLORS[tone] ?? STATUS_COLORS.neutral;
323
+ }
324
+
325
+ function revokeCurrentObjectUrl() {
326
+ if (!currentObjectUrl) {
327
+ return;
328
+ }
329
+ URL.revokeObjectURL(currentObjectUrl);
330
+ currentObjectUrl = "";
331
+ }
332
+
333
+ function handleRenderSuccess(blobUrl) {
334
+ revokeCurrentObjectUrl();
335
+ currentObjectUrl = blobUrl;
336
+ if (DOM.pdfViewer) {
337
+ DOM.pdfViewer.setAttribute("data", blobUrl);
338
+ }
339
+ setStatus("PDF updated.", "success");
340
+ }
341
+
342
+ function handleRenderFailure(message) {
343
+ revokeCurrentObjectUrl();
344
+ if (DOM.pdfViewer) {
345
+ DOM.pdfViewer.removeAttribute("data");
346
+ }
347
+ setStatus(message, "error");
348
+ }
349
+
350
+ function getViewportDimensions() {
351
+ const width = Number.parseFloat(DOM.viewportWidth.value) || CONTENT_DEFAULTS.widthPx;
352
+ const height = Number.parseFloat(DOM.viewportHeight.value) || CONTENT_DEFAULTS.heightPx;
353
+ return {
354
+ width: Math.max(width, 1),
355
+ height: Math.max(height, 1),
356
+ };
357
+ }
358
+
359
+ function computePageSize(viewport) {
360
+ return {
361
+ width: viewport.width + PAGE_MARGINS.left + PAGE_MARGINS.right,
362
+ height: viewport.height + PAGE_MARGINS.top + PAGE_MARGINS.bottom,
363
+ };
364
+ }
365
+
366
+ function getDebugConfig() {
367
+ const level = DOM.logLevel?.value || "info";
368
+ const checkboxes = document.querySelectorAll(".log-cat");
369
+ const cats = Array.from(checkboxes)
370
+ .filter(cb => /** @type {HTMLInputElement} */(cb).checked)
371
+ .map(cb => /** @type {HTMLInputElement} */(cb).value);
372
+ return { level, cats };
373
+ }
374
+
375
+ async function renderPdf() {
376
+ const html = getHtmlValue();
377
+ const css = getCssValue();
378
+ const headerHtml = getHeaderValue().trim();
379
+ const footerHtml = getFooterValue().trim();
380
+ const viewport = getViewportDimensions();
381
+ const page = computePageSize(viewport);
382
+ const selectedExample = activeExampleId ? exampleLookup.get(activeExampleId) : undefined;
383
+ const documentPath = selectedExample?.htmlUrl;
384
+ const debug = getDebugConfig();
385
+
386
+ const sanitizedPageWidth = sanitizeDimension(page.width, DEFAULT_PAGE_WIDTH_PX);
387
+ const sanitizedPageHeight = sanitizeDimension(page.height, DEFAULT_PAGE_HEIGHT_PX);
388
+ const margins = resolvePageMarginsPx(sanitizedPageWidth, sanitizedPageHeight);
389
+ const maxContentWidth = maxContentDimension(sanitizedPageWidth, margins.left + margins.right);
390
+ const maxContentHeight = maxContentDimension(sanitizedPageHeight, margins.top + margins.bottom);
391
+ const viewportWidth = Math.min(sanitizeDimension(viewport.width, maxContentWidth), maxContentWidth);
392
+ const viewportHeight = Math.min(sanitizeDimension(viewport.height, maxContentHeight), maxContentHeight);
393
+ const headerFooter = buildHeaderFooter(headerHtml, footerHtml);
394
+ const serverPayload = {
395
+ html,
396
+ css,
397
+ headerHtml: headerHtml || undefined,
398
+ footerHtml: footerHtml || undefined,
399
+ viewportWidth,
400
+ viewportHeight,
401
+ pageWidth: sanitizedPageWidth,
402
+ pageHeight: sanitizedPageHeight,
403
+ documentPath,
404
+ debugLevel: debug.level,
405
+ debugCats: debug.cats.length > 0 ? debug.cats : undefined,
406
+ };
407
+ const { resourceBaseDir, assetRootDir } = computeBrowserResourceBase(documentPath);
408
+ const browserOptions = {
409
+ html,
410
+ css,
411
+ viewportWidth,
412
+ viewportHeight,
413
+ pageWidth: sanitizedPageWidth,
414
+ pageHeight: sanitizedPageHeight,
415
+ margins,
416
+ debugLevel: debug.level,
417
+ debugCats: debug.cats.length > 0 ? debug.cats : undefined,
418
+ resourceBaseDir,
419
+ assetRootDir,
420
+ ...(headerFooter ? { headerFooter } : {}),
421
+ };
422
+
423
+ setStatus("Rendering...", "neutral");
424
+ DOM.renderButton.disabled = true;
425
+
426
+ try {
427
+ if (IS_BROWSER_MODE) {
428
+ await ensureBrowserRenderer();
429
+ if (!browserRenderHtmlToPdf) {
430
+ throw new Error("Browser renderer bundle is not ready");
431
+ }
432
+ const pdfBytes = await browserRenderHtmlToPdf(browserOptions);
433
+ const blob = new Blob([pdfBytes], { type: "application/pdf" });
434
+ handleRenderSuccess(URL.createObjectURL(blob));
435
+ return;
436
+ }
437
+
438
+ const response = await fetch("/render", {
439
+ method: "POST",
440
+ headers: {
441
+ "Content-Type": "application/json",
442
+ },
443
+ body: JSON.stringify(serverPayload),
444
+ });
445
+
446
+ if (!response.ok) {
447
+ const payload = await response.json().catch(() => ({ error: "Unexpected error" }));
448
+ throw new Error(payload.error ?? "Failed to render PDF");
449
+ }
450
+
451
+ const buffer = await response.arrayBuffer();
452
+ const blob = new Blob([buffer], { type: "application/pdf" });
453
+ handleRenderSuccess(URL.createObjectURL(blob));
454
+ } catch (error) {
455
+ console.error(error);
456
+ const message = error instanceof Error ? error.message : "Failed to render PDF.";
457
+ handleRenderFailure(message);
458
+ } finally {
459
+ DOM.renderButton.disabled = false;
460
+ }
461
+ }
462
+
463
+ async function fetchAndRenderDebugCategories() {
464
+ if (!DOM.debugCategoriesContainer) return;
465
+
466
+ if (IS_BROWSER_MODE) {
467
+ try {
468
+ await ensureBrowserRenderer();
469
+ renderDebugCategoryCheckboxes(browserLogCategories);
470
+ return;
471
+ } catch (error) {
472
+ console.warn("[playground] falling back to server debug categories:", error);
473
+ }
474
+ }
475
+
476
+ try {
477
+ const response = await fetch("/debug-categories");
478
+ if (!response.ok) throw new Error("Failed to fetch debug categories");
479
+ const categories = await response.json();
480
+ renderDebugCategoryCheckboxes(Array.isArray(categories) ? categories : []);
481
+ } catch (error) {
482
+ console.error("Failed to load debug categories:", error);
483
+ DOM.debugCategoriesContainer.textContent = "Failed to load categories.";
484
+ }
485
+ }
486
+
487
+ function populateExampleSelect(examples) {
488
+ DOM.exampleSelect.innerHTML = "";
489
+ for (const example of examples) {
490
+ const option = document.createElement("option");
491
+ option.value = example.id;
492
+ option.textContent = example.label;
493
+ DOM.exampleSelect.append(option);
494
+ }
495
+ }
496
+
497
+
498
+ function setViewportDefaults() {
499
+ // Use rounded defaults so the playground starts with the intended A4 content
500
+ // width (~698px) and avoids tiny floating point noise in the input field.
501
+ DOM.viewportWidth.value = Math.round(CONTENT_DEFAULTS.widthPx).toString();
502
+ DOM.viewportHeight.value = Math.round(CONTENT_DEFAULTS.heightPx).toString();
503
+ }
504
+
505
+ async function loadExample(example) {
506
+ if (!example) {
507
+ return;
508
+ }
509
+
510
+ try {
511
+ const [htmlResponse, cssResponse, headerResponse, footerResponse] = await Promise.all([
512
+ fetch(example.htmlUrl),
513
+ example.cssUrl ? fetch(example.cssUrl) : Promise.resolve(new Response("")),
514
+ example.headerUrl ? fetch(example.headerUrl) : Promise.resolve(new Response("")),
515
+ example.footerUrl ? fetch(example.footerUrl) : Promise.resolve(new Response("")),
516
+ ]);
517
+
518
+ if (!htmlResponse.ok) {
519
+ throw new Error(`Failed to load ${example.htmlUrl}`);
520
+ }
521
+ if (example.cssUrl && !cssResponse.ok) {
522
+ throw new Error(`Failed to load ${example.cssUrl}`);
523
+ }
524
+ if (example.headerUrl && !headerResponse.ok) {
525
+ throw new Error(`Failed to load ${example.headerUrl}`);
526
+ }
527
+ if (example.footerUrl && !footerResponse.ok) {
528
+ throw new Error(`Failed to load ${example.footerUrl}`);
529
+ }
530
+
531
+ const [html, css, header, footer] = await Promise.all([
532
+ htmlResponse.text(),
533
+ cssResponse.text(),
534
+ headerResponse.text(),
535
+ footerResponse.text(),
536
+ ]);
537
+
538
+ setHtmlValue(html);
539
+ setCssValue(css);
540
+ setHeaderValue(header);
541
+ setFooterValue(footer);
542
+ DOM.exampleSelect.value = example.id;
543
+ activeExampleId = example.id;
544
+
545
+ // Update both previews
546
+ void renderPdf();
547
+ updateHtmlPreview();
548
+ } catch (error) {
549
+ console.error(error);
550
+ const message = error instanceof Error ? error.message : "Failed to load example.";
551
+ setStatus(message, "error");
552
+ }
553
+ }
554
+
555
+ function handleExampleChange() {
556
+ const selectedId = DOM.exampleSelect.value;
557
+ const selectedExample = exampleLookup.get(selectedId);
558
+ if (selectedExample) {
559
+ void loadExample(selectedExample);
560
+ }
561
+ }
562
+
563
+ function switchEditorTab(tabName) {
564
+ // Update editor tab buttons
565
+ DOM.editorTabButtons.forEach(button => {
566
+ const isActive = button.dataset.tab === tabName;
567
+ button.classList.toggle("active", isActive);
568
+ button.setAttribute("aria-selected", isActive.toString());
569
+ });
570
+
571
+ // Update editor tab panes
572
+ const editorTabPanes = document.querySelectorAll(".editor-panel .tab-pane");
573
+ editorTabPanes.forEach(pane => {
574
+ const isActive = pane.id === `editor-${tabName}-tab`;
575
+ pane.classList.toggle("active", isActive);
576
+ pane.setAttribute("aria-hidden", (!isActive).toString());
577
+
578
+ if (isActive) {
579
+ if (pane.id === "editor-html-tab" && htmlEditor) {
580
+ htmlEditor.refresh();
581
+ }
582
+ if (pane.id === "editor-css-tab" && cssEditor) {
583
+ cssEditor.refresh();
584
+ }
585
+ if (pane.id === "editor-header-tab" && headerEditor) {
586
+ headerEditor.refresh();
587
+ }
588
+ if (pane.id === "editor-footer-tab" && footerEditor) {
589
+ footerEditor.refresh();
590
+ }
591
+ }
592
+ });
593
+ }
594
+
595
+ function switchPreviewTab(tabName) {
596
+ // Update preview tab buttons
597
+ DOM.previewTabButtons.forEach(button => {
598
+ const isActive = button.dataset.tab === tabName;
599
+ button.classList.toggle("active", isActive);
600
+ button.setAttribute("aria-selected", isActive.toString());
601
+ });
602
+
603
+ // Update preview tab panes
604
+ const previewTabPanes = document.querySelectorAll(".preview-panel .tab-pane");
605
+ previewTabPanes.forEach(pane => {
606
+ const isActive = pane.id === `preview-${tabName}-tab`;
607
+ pane.classList.toggle("active", isActive);
608
+ pane.setAttribute("aria-hidden", (!isActive).toString());
609
+ });
610
+ }
611
+
612
+ function updateHtmlPreview() {
613
+ if (!DOM.htmlViewer) {
614
+ return;
615
+ }
616
+
617
+ const html = getHtmlValue();
618
+ const css = getCssValue();
619
+ const viewport = getViewportDimensions();
620
+ const page = computePageSize(viewport);
621
+ const marginTop = PAGE_MARGINS.top.toFixed(2);
622
+ const marginRight = PAGE_MARGINS.right.toFixed(2);
623
+ const marginBottom = PAGE_MARGINS.bottom.toFixed(2);
624
+ const marginLeft = PAGE_MARGINS.left.toFixed(2);
625
+
626
+ // Create a complete HTML document with the user's input
627
+ const fullHtml = `
628
+ <!DOCTYPE html>
629
+ <html>
630
+ <head>
631
+ <meta charset="utf-8">
632
+ <title>HTML Preview</title>
633
+ <style>
634
+ /* Reset styles for consistent preview */
635
+ * {
636
+ box-sizing: border-box;
637
+ }
638
+ html {
639
+ margin: 0;
640
+ padding: 32px 0;
641
+ background: #e2e8f0;
642
+ min-height: 100%;
643
+ }
644
+ body {
645
+ margin: 0 auto;
646
+ width: ${page.width.toFixed(2)}px;
647
+ min-height: ${page.height.toFixed(2)}px;
648
+ padding: ${marginTop}px ${marginRight}px ${marginBottom}px ${marginLeft}px;
649
+ background: #fff;
650
+ box-shadow: 0 20px 50px rgba(15, 23, 42, 0.25);
651
+ }
652
+ /* User styles */
653
+ ${css}
654
+ </style>
655
+ </head>
656
+ <body>
657
+ ${html}
658
+ </body>
659
+ </html>
660
+ `;
661
+
662
+ // Write to iframe
663
+ const iframeDoc = DOM.htmlViewer.contentDocument || DOM.htmlViewer.contentWindow.document;
664
+ iframeDoc.open();
665
+ iframeDoc.write(fullHtml);
666
+ iframeDoc.close();
667
+ }
668
+
669
+ function handleTabClick(event) {
670
+ const button = event.target;
671
+ const tabName = button.dataset.tab;
672
+ if (tabName) {
673
+ if (button.closest('.editor-panel')) {
674
+ switchEditorTab(tabName);
675
+ } else if (button.closest('.preview-panel')) {
676
+ switchPreviewTab(tabName);
677
+ }
678
+ }
679
+ }
680
+
681
+ function handleInputChange() {
682
+ // Update HTML preview when inputs change
683
+ updateHtmlPreview();
684
+ }
685
+
686
+ async function enableCKEditor() {
687
+ if (useCKEditor) {
688
+ return;
689
+ }
690
+
691
+ try {
692
+ // Load CKEditor CSS
693
+ DOM.ckeditorCss.media = "all";
694
+
695
+ // Wait for CKEditor script to load if not already loaded
696
+ if (typeof ClassicEditor === "undefined") {
697
+ await new Promise((resolve, reject) => {
698
+ DOM.ckeditorScript.onload = resolve;
699
+ DOM.ckeditorScript.onerror = reject;
700
+ if (DOM.ckeditorScript.src && !DOM.ckeditorScript.loading) {
701
+ // Script already loaded
702
+ resolve();
703
+ }
704
+ });
705
+ }
706
+
707
+ // Get current HTML content
708
+ const currentHtml = getHtmlValue();
709
+
710
+ // Destroy CodeMirror instance if it exists
711
+ if (htmlEditor) {
712
+ htmlEditor.toTextArea();
713
+ htmlEditor = null;
714
+ }
715
+
716
+ // Create CKEditor instance
717
+ ckeditorInstance = await ClassicEditor.create(DOM.htmlInput, {
718
+ toolbar: [
719
+ 'heading', '|',
720
+ 'bold', 'italic', 'link', 'bulletedList', 'numberedList', '|',
721
+ 'indent', 'outdent', '|',
722
+ 'blockQuote', 'insertTable', 'mediaEmbed', 'undo', 'redo'
723
+ ],
724
+ language: 'en'
725
+ });
726
+
727
+ // Set the content
728
+ ckeditorInstance.setData(currentHtml);
729
+
730
+ // Listen for changes
731
+ ckeditorInstance.model.document.on('change:data', () => {
732
+ updateHtmlPreview();
733
+ });
734
+
735
+ useCKEditor = true;
736
+ setStatus("CKEditor enabled.", "success");
737
+ } catch (error) {
738
+ console.error("Failed to enable CKEditor:", error);
739
+ setStatus("Failed to enable CKEditor.", "error");
740
+ }
741
+ }
742
+
743
+ async function disableCKEditor() {
744
+ if (!useCKEditor) {
745
+ return;
746
+ }
747
+
748
+ try {
749
+ // Get current content from CKEditor
750
+ const currentHtml = ckeditorInstance ? ckeditorInstance.getData() : "";
751
+
752
+ // Destroy CKEditor instance
753
+ if (ckeditorInstance) {
754
+ await ckeditorInstance.destroy();
755
+ ckeditorInstance = null;
756
+ }
757
+
758
+ // Hide CKEditor CSS
759
+ DOM.ckeditorCss.media = "none";
760
+
761
+ // Recreate CodeMirror instance
762
+ if (DOM.htmlInput && !htmlEditor) {
763
+ htmlEditor = CodeMirror.fromTextArea(DOM.htmlInput, {
764
+ ...CODEMIRROR_BASE_OPTIONS,
765
+ mode: "htmlmixed",
766
+ });
767
+ htmlEditor.setSize("100%", "100%");
768
+ htmlEditor.on("change", handleInputChange);
769
+ }
770
+
771
+ // Set the content back
772
+ setHtmlValue(currentHtml);
773
+
774
+ useCKEditor = false;
775
+ setStatus("CKEditor disabled.", "success");
776
+ } catch (error) {
777
+ console.error("Failed to disable CKEditor:", error);
778
+ setStatus("Failed to disable CKEditor.", "error");
779
+ }
780
+ }
781
+
782
+ function handleCKEditorToggle() {
783
+ if (DOM.ckeditorToggle.checked) {
784
+ void enableCKEditor();
785
+ } else {
786
+ void disableCKEditor();
787
+ }
788
+ }
789
+
790
+ async function init() {
791
+ if (!DOM.renderButton) {
792
+ return;
793
+ }
794
+
795
+ setViewportDefaults();
796
+ initializeEditors();
797
+
798
+ // Add event listeners
799
+ DOM.renderButton.addEventListener("click", () => {
800
+ void renderPdf();
801
+ });
802
+
803
+ DOM.exampleSelect.addEventListener("change", handleExampleChange);
804
+
805
+ // Tab functionality
806
+ DOM.editorTabButtons.forEach(button => {
807
+ button.addEventListener("click", handleTabClick);
808
+ });
809
+ DOM.previewTabButtons.forEach(button => {
810
+ button.addEventListener("click", handleTabClick);
811
+ });
812
+
813
+ // Update HTML preview when inputs change
814
+ if (DOM.htmlInput) {
815
+ DOM.htmlInput.addEventListener("input", handleInputChange);
816
+ }
817
+ if (DOM.cssInput) {
818
+ DOM.cssInput.addEventListener("input", handleInputChange);
819
+ }
820
+ if (DOM.viewportWidth) {
821
+ DOM.viewportWidth.addEventListener("input", handleInputChange);
822
+ }
823
+ if (DOM.viewportHeight) {
824
+ DOM.viewportHeight.addEventListener("input", handleInputChange);
825
+ }
826
+
827
+ // CKEditor toggle
828
+ if (DOM.ckeditorToggle) {
829
+ DOM.ckeditorToggle.addEventListener("change", handleCKEditorToggle);
830
+ }
831
+
832
+ if (DOM.logSelectAll) {
833
+ DOM.logSelectAll.addEventListener("click", () => {
834
+ const checkboxes = document.querySelectorAll(".log-cat");
835
+ checkboxes.forEach(cb => {
836
+ /** @type {HTMLInputElement} */ (cb).checked = true;
837
+ });
838
+ });
839
+ }
840
+ if (DOM.logSelectNone) {
841
+ DOM.logSelectNone.addEventListener("click", () => {
842
+ const checkboxes = document.querySelectorAll(".log-cat");
843
+ checkboxes.forEach(cb => {
844
+ /** @type {HTMLInputElement} */ (cb).checked = false;
845
+ });
846
+ });
847
+ }
848
+
849
+ await fetchAndRenderDebugCategories();
850
+
851
+ try {
852
+ const response = await fetch("examples.json");
853
+ if (!response.ok) {
854
+ throw new Error("Failed to load examples.json");
855
+ }
856
+ /** @type {PlaygroundExample[]} */
857
+ const loadedExamples = await response.json();
858
+ examples = loadedExamples;
859
+ exampleLookup = new Map(examples.map(e => [e.id, e]));
860
+
861
+ if (examples.length > 0) {
862
+ populateExampleSelect(examples);
863
+ const initialExample = examples[0];
864
+ if (initialExample) {
865
+ await loadExample(initialExample);
866
+ }
867
+ }
868
+ } catch (error) {
869
+ console.error(error);
870
+ const message = error instanceof Error ? error.message : "Failed to initialize app.";
871
+ setStatus(message, "error");
872
+ }
873
+ }
874
+
875
+ init();