fontisan 0.4.49-arm-linux

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 (792) hide show
  1. checksums.yaml +7 -0
  2. data/.rspec +3 -0
  3. data/.rubocop.yml +141 -0
  4. data/.rubocop_todo.yml +433 -0
  5. data/BENCHMARKS.md +56 -0
  6. data/BUG-stitcher-drops-isolated-cps.md +58 -0
  7. data/BUG-stitcher-drops-plane1-codepoints.md +310 -0
  8. data/BUG-stitcher-gid-cap-65535.md +110 -0
  9. data/CHANGELOG.md +293 -0
  10. data/Gemfile +40 -0
  11. data/LICENSE +28 -0
  12. data/README.adoc +2811 -0
  13. data/Rakefile +156 -0
  14. data/TODO.bug-fixes/01-cff-expert-charsets.md +27 -0
  15. data/TODO.bug-fixes/02-cff2-subroutine-stubs.md +32 -0
  16. data/TODO.bug-fixes/03-variation-subsetter-placeholders.md +42 -0
  17. data/TODO.bug-fixes/04-ufo-image-compile-roundtrip.md +28 -0
  18. data/TODO.bug-fixes/05-stale-cff-comment.md +18 -0
  19. data/TODO.bug-fixes/06-instance-woff2-output.md +24 -0
  20. data/TODO.bug-fixes/07-encapsulation-violations.md +38 -0
  21. data/TODO.bug-fixes/08-respond-to-violations.md +25 -0
  22. data/TODO.bug-fixes/09-type1-cff-seac-expansion.md +22 -0
  23. data/TODO.bug-fixes/10-ttf-type1-composite-glyphs.md +23 -0
  24. data/TODO.bug-fixes/11-remaining-respond-to.md +25 -0
  25. data/TODO.bug-fixes/12-type1-generators-duck-typing.md +80 -0
  26. data/TODO.bug-fixes/13-hint-extractor-duck-typing.md +30 -0
  27. data/TODO.bug-fixes/14-font-interface-type-checks.md +82 -0
  28. data/TODO.bug-fixes/15-glyph-type-checks-and-simple-glyph-points-bug.md +49 -0
  29. data/TODO.bug-fixes/16-variation-table-checks.md +31 -0
  30. data/TODO.bug-fixes/17-ufo-and-stitcher-cleanup.md +32 -0
  31. data/TODO.bug-fixes/18-generic-value-and-io-checks.md +56 -0
  32. data/TODO.bug-fixes/19-serialization-migration.md +52 -0
  33. data/TODO.bug-fixes/20-variation-validator-type-checks.md +29 -0
  34. data/TODO.bug-fixes/21-xml-builder-send.md +24 -0
  35. data/TODO.bug-fixes/22-type1-converter-font-info.md +25 -0
  36. data/TODO.bug-fixes/23-boundary-type-checks.md +31 -0
  37. data/TODO.bug-fixes/24-validator-dynamic-field-key.md +25 -0
  38. data/TODO.bug-fixes/25-serialization-migration.md +49 -0
  39. data/TODO.bug-fixes/26-variation-preserver-spec-migration.md +25 -0
  40. data/TODO.bug-fixes/27-table-class-registry.md +50 -0
  41. data/TODO.bug-fixes/28-spec-doubles-cleanup.md +40 -0
  42. data/TODO.bug-fixes/29-strategy-registries.md +30 -0
  43. data/TODO.bug-fixes/30-eliminate-send-in-specs.md +36 -0
  44. data/TODO.bug-fixes/README.md +52 -0
  45. data/TODO.improvements/01-cbdt-cblc-gid-stable-propagation.md +73 -0
  46. data/TODO.improvements/02-collection-outline-priority.md +48 -0
  47. data/TODO.improvements/03-fontisan-audit-command.md +219 -0
  48. data/TODO.improvements/04-ufo-composite-glyph-encoding.md +46 -0
  49. data/TODO.improvements/05-otf-compiler-real-cff.md +63 -0
  50. data/TODO.improvements/06-cff2-blend-vsindex-operators.md +51 -0
  51. data/TODO.improvements/07-cpal-v1-header-fields.md +71 -0
  52. data/TODO.improvements/08-cff-standard-string-table.md +52 -0
  53. data/TODO.improvements/09-type1-seac-expansion.md +57 -0
  54. data/TODO.improvements/10-ufo-image-set-feature-writers.md +71 -0
  55. data/TODO.improvements/11-kern-groups-plist.md +49 -0
  56. data/TODO.improvements/12-cbdt-fixture-bindata-conversion.md +68 -0
  57. data/TODO.improvements/13-split-octokit-fetcher.md +45 -0
  58. data/TODO.improvements/14-rubocop-baseline-chip.md +62 -0
  59. data/TODO.improvements/15-cff-cff2-subsetter-strategy.md +78 -0
  60. data/TODO.improvements/README.md +58 -0
  61. data/benchmark/baseline.json +5 -0
  62. data/benchmark/ci_gate.rb +217 -0
  63. data/benchmark/compile_benchmark.rb +78 -0
  64. data/benchmark/corpus/harness.rb +175 -0
  65. data/benchmark/corpus/ops.rb +150 -0
  66. data/benchmark/corpus/run.rb +182 -0
  67. data/benchmark/corpus/scan_child.rb +8 -0
  68. data/benchmark/corpus/tiers.rb +176 -0
  69. data/benchmark/tier_baseline.json +12 -0
  70. data/benchmark/variation_quick_bench.rb +47 -0
  71. data/build_mingw32_stub.rb +15 -0
  72. data/docs/.gitignore +17 -0
  73. data/docs/.vitepress/config.ts +373 -0
  74. data/docs/.vitepress/theme/components/ApiMethod.vue +127 -0
  75. data/docs/.vitepress/theme/components/Badge.vue +51 -0
  76. data/docs/.vitepress/theme/components/FeatureComparison.vue +87 -0
  77. data/docs/.vitepress/theme/components/HeroCodeBlock.vue +98 -0
  78. data/docs/.vitepress/theme/components/WithinHero.vue +30 -0
  79. data/docs/.vitepress/theme/index.ts +22 -0
  80. data/docs/.vitepress/theme/style.css +628 -0
  81. data/docs/AFDKO_MIGRATION.adoc +175 -0
  82. data/docs/APPLE_LEGACY_FONTS.adoc +173 -0
  83. data/docs/CFF2_SUPPORT.adoc +184 -0
  84. data/docs/COLLECTION_VALIDATION.adoc +204 -0
  85. data/docs/COLOR_FONTS.adoc +127 -0
  86. data/docs/CONVERSION_GUIDE.adoc +656 -0
  87. data/docs/EXTRACT_TTC_MIGRATION.md +549 -0
  88. data/docs/FEATURE_PARITY.adoc +263 -0
  89. data/docs/FONT_HINTING.adoc +570 -0
  90. data/docs/STITCHER_GUIDE.adoc +436 -0
  91. data/docs/SVG_TO_GLYF.adoc +118 -0
  92. data/docs/TTX.adoc +176 -0
  93. data/docs/TYPE1_FONTS.adoc +445 -0
  94. data/docs/UFO_COMPILATION.adoc +397 -0
  95. data/docs/VALIDATION.adoc +254 -0
  96. data/docs/VARIABLE_FONT_OPERATIONS.adoc +599 -0
  97. data/docs/WOFF_WOFF2_FORMATS.adoc +220 -0
  98. data/docs/api/conversion-options.md +164 -0
  99. data/docs/api/converters/curve-converter.md +34 -0
  100. data/docs/api/converters/hint-converter.md +34 -0
  101. data/docs/api/converters/outline-converter.md +27 -0
  102. data/docs/api/font-loader.md +117 -0
  103. data/docs/api/font-writer.md +103 -0
  104. data/docs/api/index.md +79 -0
  105. data/docs/api/layer.md +89 -0
  106. data/docs/api/models/glyph-accessor.md +43 -0
  107. data/docs/api/models/glyph.md +40 -0
  108. data/docs/api/models/table-analyzer.md +35 -0
  109. data/docs/api/sfnt-font.md +53 -0
  110. data/docs/api/type1-font.md +43 -0
  111. data/docs/api/validators/font-validator.md +31 -0
  112. data/docs/api/validators/helper.md +36 -0
  113. data/docs/api/validators/profile.md +39 -0
  114. data/docs/cli/convert.md +148 -0
  115. data/docs/cli/dump-table.md +110 -0
  116. data/docs/cli/export.md +176 -0
  117. data/docs/cli/features.md +124 -0
  118. data/docs/cli/glyphs.md +90 -0
  119. data/docs/cli/index.md +232 -0
  120. data/docs/cli/info.md +254 -0
  121. data/docs/cli/instance.md +122 -0
  122. data/docs/cli/ls.md +95 -0
  123. data/docs/cli/optical-size.md +94 -0
  124. data/docs/cli/pack.md +125 -0
  125. data/docs/cli/scripts.md +105 -0
  126. data/docs/cli/subset.md +58 -0
  127. data/docs/cli/tables.md +84 -0
  128. data/docs/cli/unicode.md +101 -0
  129. data/docs/cli/validate-collection.md +95 -0
  130. data/docs/cli/validate.md +56 -0
  131. data/docs/cli/variable.md +126 -0
  132. data/docs/cli/version.md +46 -0
  133. data/docs/guide/cli/convert.md +108 -0
  134. data/docs/guide/cli/export.md +138 -0
  135. data/docs/guide/cli/index.md +99 -0
  136. data/docs/guide/cli/info.md +144 -0
  137. data/docs/guide/cli/pack.md +155 -0
  138. data/docs/guide/cli/subset.md +149 -0
  139. data/docs/guide/cli/validate.md +139 -0
  140. data/docs/guide/color-fonts/bitmaps.md +194 -0
  141. data/docs/guide/color-fonts/colr-cpal.md +175 -0
  142. data/docs/guide/color-fonts/index.md +140 -0
  143. data/docs/guide/color-fonts/svg.md +154 -0
  144. data/docs/guide/color.md +51 -0
  145. data/docs/guide/comparisons/font-validator.md +222 -0
  146. data/docs/guide/comparisons/fonttools.md +200 -0
  147. data/docs/guide/comparisons/index.md +83 -0
  148. data/docs/guide/comparisons/lcdf-typetools.md +205 -0
  149. data/docs/guide/contributing.md +279 -0
  150. data/docs/guide/conversion/collections.md +251 -0
  151. data/docs/guide/conversion/curves.md +246 -0
  152. data/docs/guide/conversion/index.md +157 -0
  153. data/docs/guide/conversion/options.md +280 -0
  154. data/docs/guide/conversion/ttf-otf.md +184 -0
  155. data/docs/guide/conversion/type1.md +208 -0
  156. data/docs/guide/conversion/web.md +299 -0
  157. data/docs/guide/conversion.md +40 -0
  158. data/docs/guide/engines.md +117 -0
  159. data/docs/guide/formats/collections.md +147 -0
  160. data/docs/guide/formats/dfont.md +99 -0
  161. data/docs/guide/formats/index.md +65 -0
  162. data/docs/guide/formats/otf.md +103 -0
  163. data/docs/guide/formats/svg.md +97 -0
  164. data/docs/guide/formats/ttf.md +105 -0
  165. data/docs/guide/formats/type1.md +118 -0
  166. data/docs/guide/formats/woff.md +139 -0
  167. data/docs/guide/hinting/autohint.md +141 -0
  168. data/docs/guide/hinting/conversion.md +161 -0
  169. data/docs/guide/hinting/index.md +86 -0
  170. data/docs/guide/hinting/postscript.md +149 -0
  171. data/docs/guide/hinting/truetype.md +135 -0
  172. data/docs/guide/hinting.md +44 -0
  173. data/docs/guide/index.md +152 -0
  174. data/docs/guide/installation.md +116 -0
  175. data/docs/guide/migrations/extract-ttc.md +549 -0
  176. data/docs/guide/migrations/font-validator.md +260 -0
  177. data/docs/guide/migrations/fonttools.md +208 -0
  178. data/docs/guide/migrations/index.md +64 -0
  179. data/docs/guide/migrations/otfinfo.md +197 -0
  180. data/docs/guide/quick-start.md +204 -0
  181. data/docs/guide/type1.md +58 -0
  182. data/docs/guide/universal-outline.md +151 -0
  183. data/docs/guide/validation/custom.md +195 -0
  184. data/docs/guide/validation/helpers.md +188 -0
  185. data/docs/guide/validation/index.md +132 -0
  186. data/docs/guide/validation/profiles.md +156 -0
  187. data/docs/guide/validation.md +47 -0
  188. data/docs/guide/variable-fonts/advanced.md +231 -0
  189. data/docs/guide/variable-fonts/axes.md +209 -0
  190. data/docs/guide/variable-fonts/conversion.md +197 -0
  191. data/docs/guide/variable-fonts/index.md +84 -0
  192. data/docs/guide/variable-fonts/instances.md +187 -0
  193. data/docs/guide/variable-fonts/named-instances.md +194 -0
  194. data/docs/guide/variable-fonts/static.md +168 -0
  195. data/docs/guide/variable.md +58 -0
  196. data/docs/guide/woff.md +61 -0
  197. data/docs/index.md +136 -0
  198. data/docs/lychee.toml +41 -0
  199. data/docs/package-lock.json +2560 -0
  200. data/docs/package.json +15 -0
  201. data/docs/public/apple-touch-icon.png +0 -0
  202. data/docs/public/favicon-96x96.png +0 -0
  203. data/docs/public/favicon.ico +0 -0
  204. data/docs/public/favicon.svg +1 -0
  205. data/docs/public/logo-full.svg +1 -0
  206. data/docs/public/logo.svg +1 -0
  207. data/docs/public/robots.txt +4 -0
  208. data/docs/public/site.webmanifest +21 -0
  209. data/docs/public/web-app-manifest-192x192.png +0 -0
  210. data/docs/public/web-app-manifest-512x512.png +0 -0
  211. data/docs/reference-facade.md +130 -0
  212. data/docs/scripts/post-build.mjs +81 -0
  213. data/exe/fontisan +7 -0
  214. data/lib/fontisan/audit/check.rb +47 -0
  215. data/lib/fontisan/audit/check_registry.rb +77 -0
  216. data/lib/fontisan/audit/checks/cff_table_check.rb +87 -0
  217. data/lib/fontisan/audit/checks/cmap_check.rb +256 -0
  218. data/lib/fontisan/audit/checks/collection_integrity_check.rb +102 -0
  219. data/lib/fontisan/audit/checks/format_round_trip_check.rb +150 -0
  220. data/lib/fontisan/audit/checks/glyf_table_check.rb +115 -0
  221. data/lib/fontisan/audit/checks/glyph_name_check.rb +107 -0
  222. data/lib/fontisan/audit/checks/head_check.rb +96 -0
  223. data/lib/fontisan/audit/checks/hhea_check.rb +68 -0
  224. data/lib/fontisan/audit/checks/hinting_check.rb +163 -0
  225. data/lib/fontisan/audit/checks/kern_check.rb +47 -0
  226. data/lib/fontisan/audit/checks/layout_table_check.rb +70 -0
  227. data/lib/fontisan/audit/checks/maxp_check.rb +85 -0
  228. data/lib/fontisan/audit/checks/name_table_check.rb +78 -0
  229. data/lib/fontisan/audit/checks/naming_consistency_check.rb +102 -0
  230. data/lib/fontisan/audit/checks/opentype_conformance_check.rb +108 -0
  231. data/lib/fontisan/audit/checks/os2_check.rb +117 -0
  232. data/lib/fontisan/audit/checks/ots_compatibility_check.rb +191 -0
  233. data/lib/fontisan/audit/checks/post_check.rb +75 -0
  234. data/lib/fontisan/audit/checks/table_directory_check.rb +157 -0
  235. data/lib/fontisan/audit/checks/variable_font_check.rb +151 -0
  236. data/lib/fontisan/audit/checks/woff2_validation_check.rb +140 -0
  237. data/lib/fontisan/audit/checks.rb +42 -0
  238. data/lib/fontisan/audit.rb +20 -0
  239. data/lib/fontisan/base_collection.rb +312 -0
  240. data/lib/fontisan/binary/base_record.rb +82 -0
  241. data/lib/fontisan/binary/structures.rb +82 -0
  242. data/lib/fontisan/binary.rb +11 -0
  243. data/lib/fontisan/byte_ops.rb +314 -0
  244. data/lib/fontisan/cli.rb +1111 -0
  245. data/lib/fontisan/collection/builder.rb +336 -0
  246. data/lib/fontisan/collection/dfont_builder.rb +305 -0
  247. data/lib/fontisan/collection/offset_calculator.rb +229 -0
  248. data/lib/fontisan/collection/reader/stats.rb +23 -0
  249. data/lib/fontisan/collection/reader.rb +90 -0
  250. data/lib/fontisan/collection/shared_logic.rb +52 -0
  251. data/lib/fontisan/collection/table_analyzer.rb +289 -0
  252. data/lib/fontisan/collection/table_deduplicator.rb +317 -0
  253. data/lib/fontisan/collection/writer.rb +289 -0
  254. data/lib/fontisan/collection.rb +16 -0
  255. data/lib/fontisan/commands/audit_command.rb +288 -0
  256. data/lib/fontisan/commands/base_command.rb +88 -0
  257. data/lib/fontisan/commands/convert_command.rb +506 -0
  258. data/lib/fontisan/commands/dump_table_command.rb +68 -0
  259. data/lib/fontisan/commands/export_command.rb +157 -0
  260. data/lib/fontisan/commands/features_command.rb +90 -0
  261. data/lib/fontisan/commands/glyphs_command.rb +50 -0
  262. data/lib/fontisan/commands/info_command.rb +447 -0
  263. data/lib/fontisan/commands/instance_command.rb +357 -0
  264. data/lib/fontisan/commands/ls_command.rb +107 -0
  265. data/lib/fontisan/commands/multi_format_output.rb +64 -0
  266. data/lib/fontisan/commands/optical_size_command.rb +38 -0
  267. data/lib/fontisan/commands/pack_command.rb +344 -0
  268. data/lib/fontisan/commands/scripts_command.rb +56 -0
  269. data/lib/fontisan/commands/subset_command.rb +285 -0
  270. data/lib/fontisan/commands/tables_command.rb +52 -0
  271. data/lib/fontisan/commands/unicode_command.rb +73 -0
  272. data/lib/fontisan/commands/unpack_command.rb +387 -0
  273. data/lib/fontisan/commands/validate_collection_command.rb +127 -0
  274. data/lib/fontisan/commands/validate_command.rb +305 -0
  275. data/lib/fontisan/commands/variable_command.rb +87 -0
  276. data/lib/fontisan/commands.rb +30 -0
  277. data/lib/fontisan/config/collection_settings.yml +56 -0
  278. data/lib/fontisan/config/conversion_matrix.yml +626 -0
  279. data/lib/fontisan/config/export_settings.yml +66 -0
  280. data/lib/fontisan/config/features.yml +143 -0
  281. data/lib/fontisan/config/scripts.yml +42 -0
  282. data/lib/fontisan/config/subset_profiles.yml +106 -0
  283. data/lib/fontisan/config/svg_settings.yml +60 -0
  284. data/lib/fontisan/config/variable_settings.yml +99 -0
  285. data/lib/fontisan/config/woff2_settings.yml +77 -0
  286. data/lib/fontisan/constants.rb +219 -0
  287. data/lib/fontisan/conversion_options.rb +389 -0
  288. data/lib/fontisan/converters/cff_table_builder.rb +195 -0
  289. data/lib/fontisan/converters/collection_converter.rb +520 -0
  290. data/lib/fontisan/converters/conversion_strategy.rb +211 -0
  291. data/lib/fontisan/converters/format_converter.rb +536 -0
  292. data/lib/fontisan/converters/glyf_table_builder.rb +61 -0
  293. data/lib/fontisan/converters/outline_converter.rb +720 -0
  294. data/lib/fontisan/converters/outline_extraction.rb +88 -0
  295. data/lib/fontisan/converters/outline_optimizer.rb +84 -0
  296. data/lib/fontisan/converters/svg_generator.rb +236 -0
  297. data/lib/fontisan/converters/table_copier.rb +107 -0
  298. data/lib/fontisan/converters/type1_converter.rb +1201 -0
  299. data/lib/fontisan/converters/woff2_encoder.rb +520 -0
  300. data/lib/fontisan/converters/woff_writer.rb +358 -0
  301. data/lib/fontisan/converters.rb +21 -0
  302. data/lib/fontisan/dfont_collection.rb +288 -0
  303. data/lib/fontisan/engine.rb +393 -0
  304. data/lib/fontisan/error.rb +281 -0
  305. data/lib/fontisan/export/exporter.rb +255 -0
  306. data/lib/fontisan/export/table_serializer.rb +140 -0
  307. data/lib/fontisan/export/transformers/font_to_ttx.rb +163 -0
  308. data/lib/fontisan/export/transformers/head_transformer.rb +94 -0
  309. data/lib/fontisan/export/transformers/hhea_transformer.rb +57 -0
  310. data/lib/fontisan/export/transformers/maxp_transformer.rb +61 -0
  311. data/lib/fontisan/export/transformers/name_transformer.rb +61 -0
  312. data/lib/fontisan/export/transformers/os2_transformer.rb +119 -0
  313. data/lib/fontisan/export/transformers/post_transformer.rb +49 -0
  314. data/lib/fontisan/export/transformers.rb +17 -0
  315. data/lib/fontisan/export/ttx_generator.rb +526 -0
  316. data/lib/fontisan/export/ttx_parser.rb +300 -0
  317. data/lib/fontisan/export.rb +13 -0
  318. data/lib/fontisan/ffi/client.rb +123 -0
  319. data/lib/fontisan/ffi/libfontisan_cdylib.so +0 -0
  320. data/lib/fontisan/ffi.rb +387 -0
  321. data/lib/fontisan/ffi_platform.rb +24 -0
  322. data/lib/fontisan/font_loader.rb +315 -0
  323. data/lib/fontisan/font_writer.rb +309 -0
  324. data/lib/fontisan/formatters/text_formatter.rb +517 -0
  325. data/lib/fontisan/formatters.rb +9 -0
  326. data/lib/fontisan/glyph_accessor.rb +525 -0
  327. data/lib/fontisan/hints/hint_converter.rb +309 -0
  328. data/lib/fontisan/hints/hint_validator.rb +287 -0
  329. data/lib/fontisan/hints/postscript_hint_applier.rb +255 -0
  330. data/lib/fontisan/hints/postscript_hint_extractor.rb +347 -0
  331. data/lib/fontisan/hints/truetype_hint_applier.rb +117 -0
  332. data/lib/fontisan/hints/truetype_hint_extractor.rb +283 -0
  333. data/lib/fontisan/hints/truetype_instruction_analyzer.rb +268 -0
  334. data/lib/fontisan/hints/truetype_instruction_generator.rb +266 -0
  335. data/lib/fontisan/hints.rb +19 -0
  336. data/lib/fontisan/loading_modes.rb +113 -0
  337. data/lib/fontisan/metrics_calculator.rb +275 -0
  338. data/lib/fontisan/models/all_scripts_features_info.rb +20 -0
  339. data/lib/fontisan/models/audit_report.rb +196 -0
  340. data/lib/fontisan/models/bitmap_glyph.rb +123 -0
  341. data/lib/fontisan/models/bitmap_strike.rb +94 -0
  342. data/lib/fontisan/models/collection_brief_info.rb +36 -0
  343. data/lib/fontisan/models/collection_font_summary.rb +52 -0
  344. data/lib/fontisan/models/collection_info.rb +79 -0
  345. data/lib/fontisan/models/collection_list_info.rb +36 -0
  346. data/lib/fontisan/models/collection_validation_report.rb +102 -0
  347. data/lib/fontisan/models/color_glyph.rb +56 -0
  348. data/lib/fontisan/models/color_layer.rb +53 -0
  349. data/lib/fontisan/models/color_palette.rb +60 -0
  350. data/lib/fontisan/models/features_info.rb +42 -0
  351. data/lib/fontisan/models/font_export.rb +158 -0
  352. data/lib/fontisan/models/font_info.rb +98 -0
  353. data/lib/fontisan/models/font_report.rb +23 -0
  354. data/lib/fontisan/models/font_summary.rb +48 -0
  355. data/lib/fontisan/models/glyph_info.rb +26 -0
  356. data/lib/fontisan/models/glyph_outline.rb +343 -0
  357. data/lib/fontisan/models/hint.rb +404 -0
  358. data/lib/fontisan/models/optical_size_info.rb +33 -0
  359. data/lib/fontisan/models/outline.rb +667 -0
  360. data/lib/fontisan/models/scripts_info.rb +39 -0
  361. data/lib/fontisan/models/svg_glyph.rb +89 -0
  362. data/lib/fontisan/models/table_info.rb +55 -0
  363. data/lib/fontisan/models/table_sharing_info.rb +40 -0
  364. data/lib/fontisan/models/ttx/glyph_order.rb +31 -0
  365. data/lib/fontisan/models/ttx/tables/binary_table.rb +67 -0
  366. data/lib/fontisan/models/ttx/tables/head_table.rb +74 -0
  367. data/lib/fontisan/models/ttx/tables/hhea_table.rb +74 -0
  368. data/lib/fontisan/models/ttx/tables/maxp_table.rb +55 -0
  369. data/lib/fontisan/models/ttx/tables/name_table.rb +45 -0
  370. data/lib/fontisan/models/ttx/tables/os2_table.rb +157 -0
  371. data/lib/fontisan/models/ttx/tables/post_table.rb +50 -0
  372. data/lib/fontisan/models/ttx/tables.rb +21 -0
  373. data/lib/fontisan/models/ttx/ttfont.rb +41 -0
  374. data/lib/fontisan/models/ttx.rb +14 -0
  375. data/lib/fontisan/models/unicode_mappings.rb +42 -0
  376. data/lib/fontisan/models/validation_report.rb +435 -0
  377. data/lib/fontisan/models/variable_font_info.rb +82 -0
  378. data/lib/fontisan/models.rb +49 -0
  379. data/lib/fontisan/native/3.2/fontisan_native.so +0 -0
  380. data/lib/fontisan/native/3.3/fontisan_native.so +0 -0
  381. data/lib/fontisan/native/3.4/fontisan_native.so +0 -0
  382. data/lib/fontisan/native/4.0/fontisan_native.so +0 -0
  383. data/lib/fontisan/native.rb +235 -0
  384. data/lib/fontisan/open_type_collection.rb +49 -0
  385. data/lib/fontisan/open_type_font.rb +161 -0
  386. data/lib/fontisan/open_type_font_extensions.rb +54 -0
  387. data/lib/fontisan/optimizers/charstring_rewriter.rb +172 -0
  388. data/lib/fontisan/optimizers/pattern_analyzer.rb +310 -0
  389. data/lib/fontisan/optimizers/stack_tracker.rb +246 -0
  390. data/lib/fontisan/optimizers/subroutine_builder.rb +135 -0
  391. data/lib/fontisan/optimizers/subroutine_generator.rb +207 -0
  392. data/lib/fontisan/optimizers/subroutine_optimizer.rb +114 -0
  393. data/lib/fontisan/optimizers.rb +14 -0
  394. data/lib/fontisan/outline_extractor.rb +417 -0
  395. data/lib/fontisan/output_guard.rb +40 -0
  396. data/lib/fontisan/parsers/dfont_parser.rb +191 -0
  397. data/lib/fontisan/parsers/tag.rb +77 -0
  398. data/lib/fontisan/parsers.rb +10 -0
  399. data/lib/fontisan/pipeline/format_detector.rb +176 -0
  400. data/lib/fontisan/pipeline/output_writer.rb +161 -0
  401. data/lib/fontisan/pipeline/strategies/base_strategy.rb +75 -0
  402. data/lib/fontisan/pipeline/strategies/instance_strategy.rb +89 -0
  403. data/lib/fontisan/pipeline/strategies/named_strategy.rb +114 -0
  404. data/lib/fontisan/pipeline/strategies/preserve_strategy.rb +54 -0
  405. data/lib/fontisan/pipeline/strategies.rb +16 -0
  406. data/lib/fontisan/pipeline/transformation_pipeline.rb +407 -0
  407. data/lib/fontisan/pipeline/variation_resolver.rb +158 -0
  408. data/lib/fontisan/pipeline.rb +14 -0
  409. data/lib/fontisan/reference/table_digests.rb +251 -0
  410. data/lib/fontisan/reference.rb +663 -0
  411. data/lib/fontisan/scan.rb +372 -0
  412. data/lib/fontisan/sfnt_builder.rb +66 -0
  413. data/lib/fontisan/sfnt_directory.rb +41 -0
  414. data/lib/fontisan/sfnt_font.rb +749 -0
  415. data/lib/fontisan/sfnt_source.rb +28 -0
  416. data/lib/fontisan/sfnt_table.rb +260 -0
  417. data/lib/fontisan/stitcher/cbdt_propagator.rb +212 -0
  418. data/lib/fontisan/stitcher/collection_result.rb +19 -0
  419. data/lib/fontisan/stitcher/deduplicator.rb +47 -0
  420. data/lib/fontisan/stitcher/format_metadata.rb +51 -0
  421. data/lib/fontisan/stitcher/glyph_cloner.rb +41 -0
  422. data/lib/fontisan/stitcher/glyph_copier.rb +110 -0
  423. data/lib/fontisan/stitcher/glyph_limit.rb +53 -0
  424. data/lib/fontisan/stitcher/glyph_signature.rb +51 -0
  425. data/lib/fontisan/stitcher/partition_strategy/base.rb +52 -0
  426. data/lib/fontisan/stitcher/partition_strategy/blueprint.rb +24 -0
  427. data/lib/fontisan/stitcher/partition_strategy/by_block.rb +430 -0
  428. data/lib/fontisan/stitcher/partition_strategy/by_plane.rb +161 -0
  429. data/lib/fontisan/stitcher/partition_strategy/by_script.rb +309 -0
  430. data/lib/fontisan/stitcher/partition_strategy/partition.rb +24 -0
  431. data/lib/fontisan/stitcher/partition_strategy.rb +24 -0
  432. data/lib/fontisan/stitcher/selector/codepoints.rb +29 -0
  433. data/lib/fontisan/stitcher/selector/gid.rb +25 -0
  434. data/lib/fontisan/stitcher/selector/range.rb +30 -0
  435. data/lib/fontisan/stitcher/selector.rb +26 -0
  436. data/lib/fontisan/stitcher/source.rb +459 -0
  437. data/lib/fontisan/stitcher/unique_glyph_name.rb +46 -0
  438. data/lib/fontisan/stitcher.rb +185 -0
  439. data/lib/fontisan/stitcher_cli.rb +69 -0
  440. data/lib/fontisan/subset/builder.rb +263 -0
  441. data/lib/fontisan/subset/glyph_mapping.rb +222 -0
  442. data/lib/fontisan/subset/options.rb +142 -0
  443. data/lib/fontisan/subset/profile.rb +152 -0
  444. data/lib/fontisan/subset/shared_state.rb +42 -0
  445. data/lib/fontisan/subset/subset_context.rb +20 -0
  446. data/lib/fontisan/subset/table_strategy/cbdt.rb +30 -0
  447. data/lib/fontisan/subset/table_strategy/cblc.rb +27 -0
  448. data/lib/fontisan/subset/table_strategy/cff.rb +92 -0
  449. data/lib/fontisan/subset/table_strategy/cff2.rb +391 -0
  450. data/lib/fontisan/subset/table_strategy/cmap.rb +146 -0
  451. data/lib/fontisan/subset/table_strategy/color_bitmap_placement.rb +20 -0
  452. data/lib/fontisan/subset/table_strategy/color_bitmap_strike_plan.rb +45 -0
  453. data/lib/fontisan/subset/table_strategy/color_bitmap_subset_plan.rb +62 -0
  454. data/lib/fontisan/subset/table_strategy/color_bitmap_subsetter.rb +182 -0
  455. data/lib/fontisan/subset/table_strategy/color_bitmap_subtable_plan.rb +59 -0
  456. data/lib/fontisan/subset/table_strategy/glyf.rb +29 -0
  457. data/lib/fontisan/subset/table_strategy/glyf_loca_builder.rb +146 -0
  458. data/lib/fontisan/subset/table_strategy/head.rb +43 -0
  459. data/lib/fontisan/subset/table_strategy/hhea.rb +67 -0
  460. data/lib/fontisan/subset/table_strategy/hmtx.rb +52 -0
  461. data/lib/fontisan/subset/table_strategy/loca.rb +41 -0
  462. data/lib/fontisan/subset/table_strategy/maxp.rb +23 -0
  463. data/lib/fontisan/subset/table_strategy/name.rb +19 -0
  464. data/lib/fontisan/subset/table_strategy/os2.rb +21 -0
  465. data/lib/fontisan/subset/table_strategy/pass_through.rb +20 -0
  466. data/lib/fontisan/subset/table_strategy/post.rb +37 -0
  467. data/lib/fontisan/subset/table_strategy.rb +79 -0
  468. data/lib/fontisan/subset/table_subsetter.rb +110 -0
  469. data/lib/fontisan/subset.rb +16 -0
  470. data/lib/fontisan/svg/font_face_generator.rb +274 -0
  471. data/lib/fontisan/svg/font_generator.rb +256 -0
  472. data/lib/fontisan/svg/glyph_generator.rb +201 -0
  473. data/lib/fontisan/svg/standalone_glyph.rb +132 -0
  474. data/lib/fontisan/svg/view_box_calculator.rb +137 -0
  475. data/lib/fontisan/svg.rb +13 -0
  476. data/lib/fontisan/svg_to_glyf/assembler.rb +174 -0
  477. data/lib/fontisan/svg_to_glyf/document.rb +102 -0
  478. data/lib/fontisan/svg_to_glyf/geometry/affine_transform.rb +112 -0
  479. data/lib/fontisan/svg_to_glyf/geometry/normalizer.rb +62 -0
  480. data/lib/fontisan/svg_to_glyf/geometry/transform_parser.rb +98 -0
  481. data/lib/fontisan/svg_to_glyf/geometry.rb +15 -0
  482. data/lib/fontisan/svg_to_glyf/path/command.rb +18 -0
  483. data/lib/fontisan/svg_to_glyf/path/contour_builder.rb +140 -0
  484. data/lib/fontisan/svg_to_glyf/path/parser.rb +98 -0
  485. data/lib/fontisan/svg_to_glyf/path/state.rb +79 -0
  486. data/lib/fontisan/svg_to_glyf/path.rb +14 -0
  487. data/lib/fontisan/svg_to_glyf.rb +62 -0
  488. data/lib/fontisan/tables/cbdt.rb +113 -0
  489. data/lib/fontisan/tables/cblc.rb +172 -0
  490. data/lib/fontisan/tables/cblc_big_glyph_metrics.rb +28 -0
  491. data/lib/fontisan/tables/cblc_bitmap_size.rb +67 -0
  492. data/lib/fontisan/tables/cblc_glyph_bitmap_location.rb +28 -0
  493. data/lib/fontisan/tables/cblc_index_subtable.rb +104 -0
  494. data/lib/fontisan/tables/cblc_index_subtable_array_entry.rb +20 -0
  495. data/lib/fontisan/tables/cblc_index_subtable_format_parser.rb +150 -0
  496. data/lib/fontisan/tables/cblc_index_subtable_header.rb +18 -0
  497. data/lib/fontisan/tables/cblc_sbit_line_metrics.rb +28 -0
  498. data/lib/fontisan/tables/cff/cff2_charstring_builder.rb +225 -0
  499. data/lib/fontisan/tables/cff/cff_glyph.rb +176 -0
  500. data/lib/fontisan/tables/cff/charset.rb +276 -0
  501. data/lib/fontisan/tables/cff/charstring.rb +978 -0
  502. data/lib/fontisan/tables/cff/charstring_builder.rb +356 -0
  503. data/lib/fontisan/tables/cff/charstring_parser.rb +249 -0
  504. data/lib/fontisan/tables/cff/charstring_rebuilder.rb +168 -0
  505. data/lib/fontisan/tables/cff/charstrings_index.rb +159 -0
  506. data/lib/fontisan/tables/cff/dict.rb +353 -0
  507. data/lib/fontisan/tables/cff/dict_builder.rb +260 -0
  508. data/lib/fontisan/tables/cff/encoding.rb +273 -0
  509. data/lib/fontisan/tables/cff/expert_charsets.rb +85 -0
  510. data/lib/fontisan/tables/cff/header.rb +100 -0
  511. data/lib/fontisan/tables/cff/hint_operation_injector.rb +207 -0
  512. data/lib/fontisan/tables/cff/index.rb +241 -0
  513. data/lib/fontisan/tables/cff/index_builder.rb +170 -0
  514. data/lib/fontisan/tables/cff/offset_recalculator.rb +70 -0
  515. data/lib/fontisan/tables/cff/private_dict.rb +282 -0
  516. data/lib/fontisan/tables/cff/private_dict_writer.rb +129 -0
  517. data/lib/fontisan/tables/cff/standard_strings_data.rb +83 -0
  518. data/lib/fontisan/tables/cff/table_builder.rb +215 -0
  519. data/lib/fontisan/tables/cff/top_dict.rb +234 -0
  520. data/lib/fontisan/tables/cff.rb +497 -0
  521. data/lib/fontisan/tables/cff2/blend_operator.rb +240 -0
  522. data/lib/fontisan/tables/cff2/charstring_parser.rb +624 -0
  523. data/lib/fontisan/tables/cff2/dict_encoder.rb +94 -0
  524. data/lib/fontisan/tables/cff2/fd_select.rb +142 -0
  525. data/lib/fontisan/tables/cff2/header.rb +34 -0
  526. data/lib/fontisan/tables/cff2/index.rb +155 -0
  527. data/lib/fontisan/tables/cff2/index_builder.rb +80 -0
  528. data/lib/fontisan/tables/cff2/operand_stack.rb +232 -0
  529. data/lib/fontisan/tables/cff2/private_dict_blend_handler.rb +247 -0
  530. data/lib/fontisan/tables/cff2/region_matcher.rb +200 -0
  531. data/lib/fontisan/tables/cff2/table_builder.rb +567 -0
  532. data/lib/fontisan/tables/cff2/table_reader.rb +418 -0
  533. data/lib/fontisan/tables/cff2/variation_data_extractor.rb +212 -0
  534. data/lib/fontisan/tables/cff2.rb +353 -0
  535. data/lib/fontisan/tables/cmap.rb +399 -0
  536. data/lib/fontisan/tables/cmap_table.rb +228 -0
  537. data/lib/fontisan/tables/colr.rb +290 -0
  538. data/lib/fontisan/tables/cpal.rb +381 -0
  539. data/lib/fontisan/tables/cvar.rb +204 -0
  540. data/lib/fontisan/tables/fvar.rb +159 -0
  541. data/lib/fontisan/tables/glyf/compound_glyph.rb +482 -0
  542. data/lib/fontisan/tables/glyf/compound_glyph_resolver.rb +135 -0
  543. data/lib/fontisan/tables/glyf/curve_converter.rb +349 -0
  544. data/lib/fontisan/tables/glyf/glyph_builder.rb +468 -0
  545. data/lib/fontisan/tables/glyf/simple_glyph.rb +391 -0
  546. data/lib/fontisan/tables/glyf.rb +347 -0
  547. data/lib/fontisan/tables/glyf_table.rb +252 -0
  548. data/lib/fontisan/tables/gpos/glyph_filter.rb +87 -0
  549. data/lib/fontisan/tables/gpos/kerning_pairs.rb +215 -0
  550. data/lib/fontisan/tables/gpos/pair_position.rb +274 -0
  551. data/lib/fontisan/tables/gpos.rb +139 -0
  552. data/lib/fontisan/tables/gsub.rb +116 -0
  553. data/lib/fontisan/tables/gvar.rb +232 -0
  554. data/lib/fontisan/tables/head.rb +208 -0
  555. data/lib/fontisan/tables/head_table.rb +108 -0
  556. data/lib/fontisan/tables/hhea.rb +199 -0
  557. data/lib/fontisan/tables/hhea_table.rb +252 -0
  558. data/lib/fontisan/tables/hmtx.rb +281 -0
  559. data/lib/fontisan/tables/hmtx_table.rb +188 -0
  560. data/lib/fontisan/tables/hvar.rb +192 -0
  561. data/lib/fontisan/tables/layout_common.rb +245 -0
  562. data/lib/fontisan/tables/loca.rb +323 -0
  563. data/lib/fontisan/tables/loca_table.rb +209 -0
  564. data/lib/fontisan/tables/maxp.rb +253 -0
  565. data/lib/fontisan/tables/maxp_table.rb +255 -0
  566. data/lib/fontisan/tables/mvar.rb +185 -0
  567. data/lib/fontisan/tables/name.rb +340 -0
  568. data/lib/fontisan/tables/name_table.rb +173 -0
  569. data/lib/fontisan/tables/os2.rb +291 -0
  570. data/lib/fontisan/tables/os2_table.rb +326 -0
  571. data/lib/fontisan/tables/post.rb +206 -0
  572. data/lib/fontisan/tables/post_table.rb +180 -0
  573. data/lib/fontisan/tables/registry.rb +71 -0
  574. data/lib/fontisan/tables/sbix.rb +379 -0
  575. data/lib/fontisan/tables/svg.rb +300 -0
  576. data/lib/fontisan/tables/variation_common.rb +345 -0
  577. data/lib/fontisan/tables/vvar.rb +234 -0
  578. data/lib/fontisan/tables.rb +69 -0
  579. data/lib/fontisan/true_type_collection.rb +160 -0
  580. data/lib/fontisan/true_type_font.rb +80 -0
  581. data/lib/fontisan/true_type_font_extensions.rb +54 -0
  582. data/lib/fontisan/type1/afm_generator.rb +379 -0
  583. data/lib/fontisan/type1/afm_parser.rb +299 -0
  584. data/lib/fontisan/type1/agl.rb +456 -0
  585. data/lib/fontisan/type1/cff_to_type1_converter.rb +307 -0
  586. data/lib/fontisan/type1/charstring_converter.rb +238 -0
  587. data/lib/fontisan/type1/charstrings.rb +441 -0
  588. data/lib/fontisan/type1/conversion_options.rb +242 -0
  589. data/lib/fontisan/type1/decryptor.rb +183 -0
  590. data/lib/fontisan/type1/encodings.rb +695 -0
  591. data/lib/fontisan/type1/font_dictionary.rb +576 -0
  592. data/lib/fontisan/type1/generator.rb +217 -0
  593. data/lib/fontisan/type1/inf_generator.rb +307 -0
  594. data/lib/fontisan/type1/pfa_generator.rb +376 -0
  595. data/lib/fontisan/type1/pfa_parser.rb +159 -0
  596. data/lib/fontisan/type1/pfb_generator.rb +321 -0
  597. data/lib/fontisan/type1/pfb_parser.rb +166 -0
  598. data/lib/fontisan/type1/pfm_generator.rb +589 -0
  599. data/lib/fontisan/type1/pfm_parser.rb +433 -0
  600. data/lib/fontisan/type1/private_dict.rb +363 -0
  601. data/lib/fontisan/type1/seac_expander.rb +517 -0
  602. data/lib/fontisan/type1/ttf_to_type1_converter.rb +389 -0
  603. data/lib/fontisan/type1/upm_scaler.rb +118 -0
  604. data/lib/fontisan/type1.rb +48 -0
  605. data/lib/fontisan/type1_font.rb +347 -0
  606. data/lib/fontisan/ufo/anchor.rb +17 -0
  607. data/lib/fontisan/ufo/bounds.rb +91 -0
  608. data/lib/fontisan/ufo/cli.rb +105 -0
  609. data/lib/fontisan/ufo/compile/avar.rb +46 -0
  610. data/lib/fontisan/ufo/compile/base_compiler.rb +162 -0
  611. data/lib/fontisan/ufo/compile/cbdt_cblc.rb +104 -0
  612. data/lib/fontisan/ufo/compile/cff.rb +229 -0
  613. data/lib/fontisan/ufo/compile/cff2.rb +323 -0
  614. data/lib/fontisan/ufo/compile/cff2_subroutines.rb +39 -0
  615. data/lib/fontisan/ufo/compile/cmap.rb +143 -0
  616. data/lib/fontisan/ufo/compile/colr.rb +80 -0
  617. data/lib/fontisan/ufo/compile/cpal.rb +62 -0
  618. data/lib/fontisan/ufo/compile/feature_compiler.rb +161 -0
  619. data/lib/fontisan/ufo/compile/feature_writers/base.rb +56 -0
  620. data/lib/fontisan/ufo/compile/feature_writers/curs.rb +72 -0
  621. data/lib/fontisan/ufo/compile/feature_writers/gdef.rb +92 -0
  622. data/lib/fontisan/ufo/compile/feature_writers/kern.rb +50 -0
  623. data/lib/fontisan/ufo/compile/feature_writers/kern2.rb +57 -0
  624. data/lib/fontisan/ufo/compile/feature_writers/mark.rb +45 -0
  625. data/lib/fontisan/ufo/compile/feature_writers/mark_family_base.rb +124 -0
  626. data/lib/fontisan/ufo/compile/feature_writers/mkmk.rb +53 -0
  627. data/lib/fontisan/ufo/compile/feature_writers.rb +38 -0
  628. data/lib/fontisan/ufo/compile/filters/cubic_to_quadratic.rb +176 -0
  629. data/lib/fontisan/ufo/compile/filters/decompose_components.rb +33 -0
  630. data/lib/fontisan/ufo/compile/filters/flatten_components.rb +22 -0
  631. data/lib/fontisan/ufo/compile/filters/propagate_anchors.rb +102 -0
  632. data/lib/fontisan/ufo/compile/filters/remove_overlaps.rb +95 -0
  633. data/lib/fontisan/ufo/compile/filters/reverse_contour_direction.rb +27 -0
  634. data/lib/fontisan/ufo/compile/filters/sort_contours.rb +69 -0
  635. data/lib/fontisan/ufo/compile/filters/transformations.rb +113 -0
  636. data/lib/fontisan/ufo/compile/filters.rb +69 -0
  637. data/lib/fontisan/ufo/compile/fvar.rb +113 -0
  638. data/lib/fontisan/ufo/compile/glyf_loca.rb +206 -0
  639. data/lib/fontisan/ufo/compile/gpos.rb +248 -0
  640. data/lib/fontisan/ufo/compile/gsub.rb +267 -0
  641. data/lib/fontisan/ufo/compile/gvar.rb +225 -0
  642. data/lib/fontisan/ufo/compile/head.rb +97 -0
  643. data/lib/fontisan/ufo/compile/hhea.rb +57 -0
  644. data/lib/fontisan/ufo/compile/hmtx.rb +38 -0
  645. data/lib/fontisan/ufo/compile/hvar.rb +42 -0
  646. data/lib/fontisan/ufo/compile/item_variation_store.rb +100 -0
  647. data/lib/fontisan/ufo/compile/math.rb +143 -0
  648. data/lib/fontisan/ufo/compile/maxp.rb +57 -0
  649. data/lib/fontisan/ufo/compile/meta.rb +51 -0
  650. data/lib/fontisan/ufo/compile/mvar.rb +59 -0
  651. data/lib/fontisan/ufo/compile/name.rb +81 -0
  652. data/lib/fontisan/ufo/compile/os2.rb +81 -0
  653. data/lib/fontisan/ufo/compile/otf2_compiler.rb +40 -0
  654. data/lib/fontisan/ufo/compile/otf_compiler.rb +34 -0
  655. data/lib/fontisan/ufo/compile/post.rb +32 -0
  656. data/lib/fontisan/ufo/compile/sbix.rb +100 -0
  657. data/lib/fontisan/ufo/compile/stat.rb +106 -0
  658. data/lib/fontisan/ufo/compile/svg_table.rb +60 -0
  659. data/lib/fontisan/ufo/compile/ttf_compiler.rb +75 -0
  660. data/lib/fontisan/ufo/compile/variable_otf.rb +84 -0
  661. data/lib/fontisan/ufo/compile/variable_ttf.rb +161 -0
  662. data/lib/fontisan/ufo/compile.rb +72 -0
  663. data/lib/fontisan/ufo/component.rb +18 -0
  664. data/lib/fontisan/ufo/contour.rb +34 -0
  665. data/lib/fontisan/ufo/convert/from_bin_data.rb +366 -0
  666. data/lib/fontisan/ufo/convert/to_dfont.rb +45 -0
  667. data/lib/fontisan/ufo/convert/to_otc.rb +40 -0
  668. data/lib/fontisan/ufo/convert/to_otf.rb +18 -0
  669. data/lib/fontisan/ufo/convert/to_otf2.rb +20 -0
  670. data/lib/fontisan/ufo/convert/to_postscript.rb +64 -0
  671. data/lib/fontisan/ufo/convert/to_ttc.rb +35 -0
  672. data/lib/fontisan/ufo/convert/to_ttf.rb +21 -0
  673. data/lib/fontisan/ufo/convert/to_woff.rb +61 -0
  674. data/lib/fontisan/ufo/convert/to_woff2.rb +50 -0
  675. data/lib/fontisan/ufo/convert.rb +84 -0
  676. data/lib/fontisan/ufo/data_set.rb +21 -0
  677. data/lib/fontisan/ufo/features.rb +17 -0
  678. data/lib/fontisan/ufo/font.rb +63 -0
  679. data/lib/fontisan/ufo/glyph.rb +445 -0
  680. data/lib/fontisan/ufo/glyph_exists_error.rb +23 -0
  681. data/lib/fontisan/ufo/groups.rb +45 -0
  682. data/lib/fontisan/ufo/guideline.rb +19 -0
  683. data/lib/fontisan/ufo/image.rb +29 -0
  684. data/lib/fontisan/ufo/image_set.rb +99 -0
  685. data/lib/fontisan/ufo/info.rb +133 -0
  686. data/lib/fontisan/ufo/kerning.rb +32 -0
  687. data/lib/fontisan/ufo/layer.rb +78 -0
  688. data/lib/fontisan/ufo/layer_set.rb +37 -0
  689. data/lib/fontisan/ufo/lib.rb +24 -0
  690. data/lib/fontisan/ufo/plist.rb +123 -0
  691. data/lib/fontisan/ufo/point.rb +32 -0
  692. data/lib/fontisan/ufo/reader.rb +163 -0
  693. data/lib/fontisan/ufo/transformation.rb +50 -0
  694. data/lib/fontisan/ufo/writer.rb +123 -0
  695. data/lib/fontisan/ufo.rb +47 -0
  696. data/lib/fontisan/unicode/plane.rb +44 -0
  697. data/lib/fontisan/unicode.rb +17 -0
  698. data/lib/fontisan/utilities/brotli_wrapper.rb +177 -0
  699. data/lib/fontisan/utilities/checksum_calculator.rb +104 -0
  700. data/lib/fontisan/utilities/padding.rb +61 -0
  701. data/lib/fontisan/utilities.rb +11 -0
  702. data/lib/fontisan/utils/thread_pool.rb +134 -0
  703. data/lib/fontisan/utils.rb +10 -0
  704. data/lib/fontisan/validation/collection_validator.rb +265 -0
  705. data/lib/fontisan/validation.rb +9 -0
  706. data/lib/fontisan/validators/basic_validator.rb +73 -0
  707. data/lib/fontisan/validators/font_book_validator.rb +107 -0
  708. data/lib/fontisan/validators/opentype_validator.rb +118 -0
  709. data/lib/fontisan/validators/profile_loader.rb +134 -0
  710. data/lib/fontisan/validators/validator.rb +494 -0
  711. data/lib/fontisan/validators/web_font_validator.rb +95 -0
  712. data/lib/fontisan/validators.rb +14 -0
  713. data/lib/fontisan/variable/axis_normalizer.rb +215 -0
  714. data/lib/fontisan/variable/delta_applicator.rb +302 -0
  715. data/lib/fontisan/variable/glyph_delta_processor.rb +218 -0
  716. data/lib/fontisan/variable/instancer.rb +172 -0
  717. data/lib/fontisan/variable/metric_delta_processor.rb +282 -0
  718. data/lib/fontisan/variable/region_matcher.rb +208 -0
  719. data/lib/fontisan/variable/static_font_builder.rb +209 -0
  720. data/lib/fontisan/variable/table_updater.rb +219 -0
  721. data/lib/fontisan/variable.rb +16 -0
  722. data/lib/fontisan/variation/blend_applier.rb +197 -0
  723. data/lib/fontisan/variation/cache.rb +299 -0
  724. data/lib/fontisan/variation/cache_key_builder.rb +162 -0
  725. data/lib/fontisan/variation/converter.rb +373 -0
  726. data/lib/fontisan/variation/data_extractor.rb +84 -0
  727. data/lib/fontisan/variation/delta_applier.rb +262 -0
  728. data/lib/fontisan/variation/delta_parser.rb +228 -0
  729. data/lib/fontisan/variation/inspector.rb +275 -0
  730. data/lib/fontisan/variation/instance_font_wrapper.rb +41 -0
  731. data/lib/fontisan/variation/instance_generator.rb +122 -0
  732. data/lib/fontisan/variation/instance_writer.rb +360 -0
  733. data/lib/fontisan/variation/instancing/axis_space.rb +136 -0
  734. data/lib/fontisan/variation/instancing/glyph_outline.rb +204 -0
  735. data/lib/fontisan/variation/instancing/gvar_reader.rb +146 -0
  736. data/lib/fontisan/variation/instancing/item_variation_store.rb +92 -0
  737. data/lib/fontisan/variation/instancing/name_rewriter.rb +90 -0
  738. data/lib/fontisan/variation/instancing/true_type_instancer.rb +326 -0
  739. data/lib/fontisan/variation/instancing.rb +20 -0
  740. data/lib/fontisan/variation/interpolator.rb +231 -0
  741. data/lib/fontisan/variation/metrics_adjuster.rb +309 -0
  742. data/lib/fontisan/variation/optimizer.rb +417 -0
  743. data/lib/fontisan/variation/parallel_generator.rb +147 -0
  744. data/lib/fontisan/variation/region_matcher.rb +221 -0
  745. data/lib/fontisan/variation/subsetter.rb +400 -0
  746. data/lib/fontisan/variation/table_accessor.rb +105 -0
  747. data/lib/fontisan/variation/tuple_variation_header.rb +49 -0
  748. data/lib/fontisan/variation/validator.rb +336 -0
  749. data/lib/fontisan/variation/variable_svg_generator.rb +235 -0
  750. data/lib/fontisan/variation/variation_context.rb +208 -0
  751. data/lib/fontisan/variation/variation_preserver.rb +287 -0
  752. data/lib/fontisan/variation.rb +33 -0
  753. data/lib/fontisan/version.rb +5 -0
  754. data/lib/fontisan/version.rb.orig +9 -0
  755. data/lib/fontisan/woff2/collection_decoder.rb +223 -0
  756. data/lib/fontisan/woff2/collection_encoder.rb +302 -0
  757. data/lib/fontisan/woff2/directory.rb +255 -0
  758. data/lib/fontisan/woff2/encoder_rules.rb +114 -0
  759. data/lib/fontisan/woff2/glyf_canonicalizer.rb +90 -0
  760. data/lib/fontisan/woff2/glyf_loca_reconstruct.rb +401 -0
  761. data/lib/fontisan/woff2/glyf_loca_transform.rb +319 -0
  762. data/lib/fontisan/woff2/header.rb +101 -0
  763. data/lib/fontisan/woff2/hmtx_transformer.rb +140 -0
  764. data/lib/fontisan/woff2/sfnt_checksum.rb +107 -0
  765. data/lib/fontisan/woff2/table_transformer.rb +575 -0
  766. data/lib/fontisan/woff2/triplet_codec.rb +181 -0
  767. data/lib/fontisan/woff2/uint255.rb +101 -0
  768. data/lib/fontisan/woff2.rb +21 -0
  769. data/lib/fontisan/woff2_collection.rb +127 -0
  770. data/lib/fontisan/woff2_font.rb +754 -0
  771. data/lib/fontisan/woff_container.rb +83 -0
  772. data/lib/fontisan/woff_font.rb +554 -0
  773. data/lib/fontisan.rb +299 -0
  774. data/rakelib/bench.rake +9 -0
  775. data/rakelib/cdylib.rake +39 -0
  776. data/rakelib/corpus.rake +272 -0
  777. data/rakelib/corpus_convert.rake +43 -0
  778. data/rakelib/corpus_goldens.rake +22 -0
  779. data/rakelib/corpus_malformed.rake +20 -0
  780. data/rakelib/corpus_scan.rake +24 -0
  781. data/rakelib/java.rake +61 -0
  782. data/rakelib/native.rake +43 -0
  783. data/scripts/build-woff2.sh +57 -0
  784. data/scripts/compare_stack_aware.rb +187 -0
  785. data/scripts/corpus/generate_convert_goldens.rb +478 -0
  786. data/scripts/corpus/generate_goldens.rb +282 -0
  787. data/scripts/corpus/generate_malformed_goldens.rb +254 -0
  788. data/scripts/corpus/generate_scan_goldens.rb +98 -0
  789. data/scripts/measure_optimization.rb +148 -0
  790. data/scripts/tier_fallback.rb +228 -0
  791. data/scripts/tier_smoke.rb +72 -0
  792. metadata +945 -0
@@ -0,0 +1,315 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "stringio"
4
+
5
+ module Fontisan
6
+ # FontLoader provides unified font loading with content-based format detection.
7
+ #
8
+ # This class is the primary entry point for loading fonts in Fontisan.
9
+ # It inspects each file's magic bytes to determine the on-disk format and
10
+ # returns the appropriate domain object (TrueTypeFont, OpenTypeFont,
11
+ # Type1Font, TrueTypeCollection, or OpenTypeCollection).
12
+ #
13
+ # Detection is purely content-based — the file extension is ignored. This
14
+ # matters because vendors occasionally ship files with a misleading
15
+ # extension (e.g. Apple ships a single OpenType-CFF font as `.ttc` in
16
+ # macOS's private FontServices framework).
17
+ #
18
+ # @example Load any font type
19
+ # font = FontLoader.load("font.ttf") # => TrueTypeFont
20
+ # font = FontLoader.load("font.otf") # => OpenTypeFont
21
+ # font = FontLoader.load("font.pfb") # => Type1Font
22
+ # font = FontLoader.load("font.pfa") # => Type1Font
23
+ # font = FontLoader.load("fonts.ttc") # => TrueTypeFont (first in collection)
24
+ # font = FontLoader.load("fonts.ttc", font_index: 2) # => TrueTypeFont (third in collection)
25
+ #
26
+ # @example Loading modes
27
+ # font = FontLoader.load("font.ttf", mode: :metadata) # Load only metadata tables
28
+ # font = FontLoader.load("font.ttf", mode: :full) # Load all tables
29
+ #
30
+ # @example Lazy loading control
31
+ # font = FontLoader.load("font.ttf", lazy: true) # Tables loaded on-demand
32
+ # font = FontLoader.load("font.ttf", lazy: false) # All tables loaded upfront
33
+ class FontLoader
34
+ # The one text every tier raises for a file that is no font at all.
35
+ UNKNOWN_FORMAT_MESSAGE =
36
+ "Unknown font format. Expected TTF, OTF, TTC, OTC, WOFF, WOFF2, PFB, or PFA file."
37
+
38
+ # Number of bytes read from the start of a file to identify its format.
39
+ # 100 bytes is enough to comfortably contain the Adobe Type 1 PFA header
40
+ # plus its leading whitespace, and far more than the 4 bytes needed for
41
+ # any SFNT-style or dfont magic.
42
+ PFA_PROBE_LENGTH = 100
43
+ private_constant :PFA_PROBE_LENGTH
44
+
45
+ # Map of collection format symbols to the class that loads them. Single
46
+ # source of truth for "what counts as a collection"; both {.collection?}
47
+ # and {.load_collection} dispatch off this table.
48
+ COLLECTION_CLASSES = {
49
+ ttc: TrueTypeCollection,
50
+ otc: OpenTypeCollection,
51
+ dfont: DfontCollection,
52
+ woff2_collection: Woff2Collection,
53
+ }.freeze
54
+ private_constant :COLLECTION_CLASSES
55
+
56
+ # Load a font from file with content-based format detection.
57
+ #
58
+ # The file's bytes determine its format; the extension is ignored. See
59
+ # {.detect_format} for the full list of recognised formats and how they
60
+ # are detected.
61
+ #
62
+ # @param path [String] Path to the font file
63
+ # @param font_index [Integer] Index of font in collection (0-based, default: 0)
64
+ # @param mode [Symbol] Loading mode (:metadata or :full, default: from ENV or :full)
65
+ # @param lazy [Boolean] If true, load tables on demand (default: false for eager loading)
66
+ # @return [TrueTypeFont, OpenTypeFont, Type1Font, WoffFont, Woff2Font] The loaded font object
67
+ # @raise [Errno::ENOENT] if file does not exist
68
+ # @raise [UnsupportedFormatError] for unsupported formats
69
+ # @raise [InvalidFontError] for corrupted or unknown formats
70
+ def self.load(path, font_index: 0, mode: nil, lazy: nil)
71
+ resolved_mode = mode || env_mode || LoadingModes::FULL
72
+ resolved_lazy = if lazy.nil?
73
+ env_lazy.nil? ? false : env_lazy
74
+ else
75
+ lazy
76
+ end
77
+ LoadingModes.validate_mode!(resolved_mode)
78
+
79
+ format = detect(path)
80
+ case format
81
+ when :ttf then TrueTypeFont.from_file(path, mode: resolved_mode,
82
+ lazy: resolved_lazy)
83
+ when :otf then OpenTypeFont.from_file(path, mode: resolved_mode,
84
+ lazy: resolved_lazy)
85
+ when :woff then WoffFont.from_file(path, mode: resolved_mode,
86
+ lazy: resolved_lazy)
87
+ when :woff2 then Woff2Font.from_file(path, mode: resolved_mode,
88
+ lazy: resolved_lazy)
89
+ when :ttc, :otc then load_from_collection(path, format, font_index,
90
+ mode: resolved_mode)
91
+ when :woff2_collection then load_from_collection(path, format, font_index,
92
+ mode: resolved_mode)
93
+ when :dfont then load_dfont(path, font_index: font_index,
94
+ mode: resolved_mode)
95
+ when :pfa, :pfb then Type1Font.from_file(path, mode: resolved_mode)
96
+ else
97
+ raise InvalidFontError,
98
+ UNKNOWN_FORMAT_MESSAGE
99
+ end
100
+ end
101
+
102
+ # Check if a file is a collection (TTC, OTC, or dfont).
103
+ #
104
+ # Returns `false` for a ttcf-headed file whose inner fonts can't be
105
+ # classified (truncated header, offsets past EOF, unrecognised inner
106
+ # SFNT versions). Such a file is structurally invalid as a collection
107
+ # and would fail to load, so reporting it as "not a collection" matches
108
+ # what callers can actually do with it.
109
+ #
110
+ # @param path [String] Path to the font file
111
+ # @return [Boolean] true if file is a loadable collection
112
+ # @raise [Errno::ENOENT] if file does not exist
113
+ #
114
+ # @example Check if file is collection
115
+ # FontLoader.collection?("fonts.ttc") # => true
116
+ # FontLoader.collection?("font.ttf") # => false
117
+ def self.collection?(path) = COLLECTION_CLASSES.key?(detect(path))
118
+
119
+ # Identify a font file by inspecting its magic bytes (content-based detection).
120
+ #
121
+ # Returns the actual on-disk format regardless of the file extension. This
122
+ # is the authoritative way to determine how a file should be parsed,
123
+ # because vendors occasionally ship files with a misleading extension
124
+ # (for example, Apple ships a single OpenType-CFF font as `.ttc` in
125
+ # macOS's private FontServices framework).
126
+ #
127
+ # Collections are distinguished by scanning the inner fonts: if any inner
128
+ # font is OpenType (CFF), the file is reported as `:otc`; otherwise (all
129
+ # inner fonts are TrueType) it is reported as `:ttc`. A ttcf-headed file
130
+ # whose inner fonts can't be classified (truncated header, offsets past
131
+ # EOF, unrecognised inner SFNT versions) returns `nil`. dfont detection
132
+ # uses the canonical resource-data-offset (256) magic only; non-canonical
133
+ # but structurally valid dfonts are accepted by {.load_collection} as a
134
+ # fallback but not reported here.
135
+ #
136
+ # @param path [String] Path to the font file
137
+ # @return [Symbol, nil] One of `:ttf`, `:otf`, `:ttc`, `:otc`, `:woff`,
138
+ # `:woff2`, `:dfont`, `:pfa`, `:pfb`, or `nil` when the format is not
139
+ # recognised.
140
+ # @raise [Errno::ENOENT] if the file does not exist
141
+ #
142
+ # @example Detect a real collection
143
+ # FontLoader.detect_format("fonts.ttc") # => :ttc
144
+ #
145
+ # @example Detect a single OTF mislabeled as .ttc
146
+ # FontLoader.detect_format("SauberScript.ttc") # => :otf
147
+ def self.detect_format(path) = detect(path)
148
+
149
+ # Load a collection object without extracting fonts
150
+ #
151
+ # Returns the collection object (TrueTypeCollection, OpenTypeCollection,
152
+ # or DfontCollection) without extracting individual fonts. Useful for
153
+ # inspecting collection metadata and structure.
154
+ #
155
+ # The TTC vs. OTC distinction is resolved by {.detect_format}, which
156
+ # scans the inner fonts; see that method for details.
157
+ #
158
+ # @param path [String] Path to the collection file
159
+ # @return [TrueTypeCollection, OpenTypeCollection, DfontCollection]
160
+ # @raise [Errno::ENOENT] if file does not exist
161
+ # @raise [InvalidFontError] if file is not a collection or type cannot be determined
162
+ #
163
+ # @example Load collection for inspection
164
+ # collection = FontLoader.load_collection("fonts.ttc")
165
+ # puts "Collection has #{collection.num_fonts} fonts"
166
+ def self.load_collection(path)
167
+ format = detect(path)
168
+ return COLLECTION_CLASSES.fetch(format).from_file(path) if COLLECTION_CLASSES.key?(format)
169
+
170
+ # Lenient fallback: a dfont whose resource-data offset isn't the
171
+ # canonical 256 fails the strict magic test in {.detect} but may still
172
+ # be structurally valid; try the structural check before giving up.
173
+ File.open(path, "rb") do |io|
174
+ return DfontCollection.from_file(path) if Parsers::DfontParser.dfont?(io)
175
+ end
176
+ raise InvalidFontError,
177
+ "File is not a collection (TTC/OTC/dfont). Use FontLoader.load instead."
178
+ end
179
+
180
+ # Content-based detection. Reads 4 bytes first (covers every SFNT-style
181
+ # and canonical dfont magic), then tops up to {PFA_PROBE_LENGTH} for
182
+ # Type 1 only on an SFNT miss.
183
+ def self.detect(path)
184
+ raise Errno::ENOENT, "File not found: #{path}" unless File.exist?(path)
185
+
186
+ File.open(path, "rb") do |io|
187
+ head4 = io.read(4)
188
+ return nil if head4.nil? || head4.empty?
189
+
190
+ sfnt = case head4
191
+ when Constants::TTC_TAG then scan_collection(io)
192
+ when Constants::SFNT_OTTO_MAGIC then :otf
193
+ when Constants::SFNT_TRUETYPE_MAGIC, Constants::SFNT_TRUE_MAGIC then :ttf
194
+ when Constants::WOFF_MAGIC then :woff
195
+ when Constants::WOFF2_MAGIC then scan_woff2(io)
196
+ when Constants::DFONT_RESOURCE_HEADER
197
+ io.rewind
198
+ Parsers::DfontParser.dfont?(io) ? :dfont : nil
199
+ end
200
+ return sfnt if sfnt
201
+
202
+ rest = head4.bytesize < PFA_PROBE_LENGTH ? io.read(PFA_PROBE_LENGTH - head4.bytesize) : nil
203
+ type1_format_from_header(rest ? head4 + rest : head4)
204
+ end
205
+ end
206
+
207
+ # Identify the Type 1 sub-format (`:pfa` or `:pfb`) from a probe of the
208
+ # file's leading bytes. Returns nil if the bytes don't match Type 1.
209
+ def self.type1_format_from_header(header)
210
+ if header.bytesize >= 2
211
+ marker = (header.getbyte(0) << 8) | header.getbyte(1)
212
+ if [Constants::PFB_ASCII_CHUNK, Constants::PFB_BINARY_CHUNK].include?(marker)
213
+ return :pfb
214
+ end
215
+ end
216
+
217
+ # PFA is plain text — the Adobe Type 1 header must appear at the very
218
+ # start (allowing only leading ASCII whitespace), not anywhere in the
219
+ # probe. Using start_with? avoids matching a non-Type-1 PostScript file
220
+ # that happens to mention the signature in a comment.
221
+ stripped = header.lstrip
222
+ if stripped.start_with?(Constants::PFA_SIGNATURE_ADOBE_1_0, Constants::PFA_SIGNATURE_ADOBE_3_0)
223
+ return :pfa
224
+ end
225
+
226
+ nil
227
+ end
228
+
229
+ # Walk a ttcf-headed file via BaseCollection. Returns `:ttc`, `:otc`, or
230
+ # nil for any truncation, unreadable offset, or unrecognised inner magic.
231
+ def self.scan_collection(io)
232
+ io.rewind
233
+ header = BaseCollection.read(io)
234
+ has_otf = false
235
+ header.font_offsets.each do |offset|
236
+ io.seek(offset)
237
+ case Constants.sfnt_format_for(io.read(4))
238
+ when :otf then has_otf = true
239
+ when :ttf then next
240
+ else return nil
241
+ end
242
+ end
243
+ has_otf ? :otc : :ttc
244
+ rescue BinData::ValidityError, IOError
245
+ nil
246
+ end
247
+
248
+ # Distinguish a WOFF2 collection (flavor='ttcf') from a single-font
249
+ # WOFF2. The 8-byte probe covers the WOFF2 signature + flavor field;
250
+ # spec section 3.2 requires flavor='ttcf' (0x74746366) for collections.
251
+ def self.scan_woff2(io)
252
+ io.rewind
253
+ io.read(4) # signature (already matched)
254
+ flavor = io.read(4)&.unpack1("N")
255
+ flavor == Woff2::CollectionDecoder::TTC_FLAVOR ? :woff2_collection : :woff2
256
+ rescue IOError
257
+ :woff2
258
+ end
259
+
260
+ # Mode override from FONTISAN_MODE env var, or nil.
261
+ def self.env_mode
262
+ env_value = ENV["FONTISAN_MODE"]
263
+ return nil unless env_value
264
+
265
+ mode = env_value.to_sym
266
+ LoadingModes.valid_mode?(mode) ? mode : nil
267
+ end
268
+
269
+ # Lazy override from FONTISAN_LAZY env var, or nil.
270
+ def self.env_lazy
271
+ env_value = ENV["FONTISAN_LAZY"]
272
+ return nil unless env_value
273
+
274
+ env_value.downcase == "true"
275
+ end
276
+
277
+ # Load a single font from a TTC/OTC collection. `format` is the detected
278
+ # symbol routed from `.load`'s case statement, so no second magic read.
279
+ def self.load_from_collection(path, format, font_index, mode:)
280
+ collection = COLLECTION_CLASSES.fetch(format).from_file(path)
281
+ if font_index >= collection.num_fonts
282
+ raise InvalidFontError,
283
+ "Font index #{font_index} out of range (collection has #{collection.num_fonts} fonts)"
284
+ end
285
+
286
+ File.open(path, "rb") { |io| collection.font(font_index, io, mode: mode) }
287
+ end
288
+
289
+ # Extract an SFNT from a dfont resource fork into memory and load it via
290
+ # `SfntFont.from_collection` so the loading-mode handling matches the
291
+ # TTC/OTC path. Lazy loading is a no-op for in-memory StringIO so the
292
+ # public `lazy:` flag is not threaded through this path.
293
+ def self.load_dfont(path, font_index:, mode:)
294
+ File.open(path, "rb") do |io|
295
+ sfnt_io = StringIO.new(Parsers::DfontParser.extract_sfnt(io,
296
+ index: font_index))
297
+ klass = case Constants.sfnt_format_for(sfnt_io.read(4))
298
+ when :ttf then TrueTypeFont
299
+ when :otf then OpenTypeFont
300
+ else raise InvalidFontError, "Invalid SFNT in dfont resource"
301
+ end
302
+ klass.from_collection(sfnt_io, 0, mode: mode)
303
+ end
304
+ end
305
+
306
+ private_class_method :detect,
307
+ :type1_format_from_header,
308
+ :scan_collection,
309
+ :scan_woff2,
310
+ :env_mode,
311
+ :env_lazy,
312
+ :load_from_collection,
313
+ :load_dfont
314
+ end
315
+ end
@@ -0,0 +1,309 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "fileutils"
4
+
5
+ module Fontisan
6
+ # FontWriter handles writing font binaries from table data
7
+ #
8
+ # This class assembles a complete font binary from individual table data,
9
+ # including:
10
+ # - Writing the sfnt header (offset table)
11
+ # - Building the table directory
12
+ # - Writing table data with proper 4-byte alignment
13
+ # - Calculating all checksums
14
+ # - Updating the head table's checksumAdjustment field
15
+ #
16
+ # @example Write font from tables
17
+ # tables = {
18
+ # 'head' => head_data,
19
+ # 'hhea' => hhea_data,
20
+ # 'maxp' => maxp_data,
21
+ # 'hmtx' => hmtx_data,
22
+ # 'cmap' => cmap_data
23
+ # }
24
+ # binary = FontWriter.write_font(tables)
25
+ # File.binwrite('subset.ttf', binary)
26
+ #
27
+ # @example Write to file directly
28
+ # FontWriter.write_to_file(tables, 'subset.ttf')
29
+ #
30
+ # Reference: OpenType spec section on font file structure
31
+ class FontWriter
32
+ # OpenType/TrueType table ordering (recommended order)
33
+ TRUETYPE_TABLE_ORDER = %w[
34
+ head hhea maxp OS/2 hmtx LTSH VDMX hdmx cmap fpgm prep cvt
35
+ loca glyf kern name post gasp PCLT DSIG
36
+ ].freeze
37
+
38
+ # OpenType/CFF table ordering (recommended order)
39
+ OPENTYPE_TABLE_ORDER = %w[
40
+ head hhea maxp OS/2 name cmap post CFF CFF2
41
+ ].freeze
42
+
43
+ # Write complete font binary from table data
44
+ #
45
+ # @param tables_hash [Hash<String, String>] Map of table tag to binary data
46
+ # @param sfnt_version [Integer, nil] Font sfnt version (0x00010000 for TrueType,
47
+ # 0x4F54544F for OpenType/CFF). If nil, auto-detects based on tables.
48
+ # @return [String] Complete font binary
49
+ #
50
+ # @example
51
+ # binary = FontWriter.write_font(tables_hash)
52
+ # binary = FontWriter.write_font(tables_hash, sfnt_version: 0x4F54544F)
53
+ def self.write_font(tables_hash, sfnt_version: nil)
54
+ # Auto-detect sfnt version if not provided
55
+ sfnt_version ||= detect_sfnt_version(tables_hash)
56
+ new(tables_hash, sfnt_version: sfnt_version).write
57
+ end
58
+
59
+ # Detect sfnt version based on table presence
60
+ #
61
+ # @param tables_hash [Hash<String, String>] Map of table tag to binary data
62
+ # @return [Integer] Detected sfnt version
63
+ def self.detect_sfnt_version(tables_hash)
64
+ if tables_hash.key?("CFF ") || tables_hash.key?("CFF2")
65
+ 0x4F54544F # 'OTTO' for OpenType/CFF
66
+ else
67
+ 0x00010000 # 1.0 for TrueType
68
+ end
69
+ end
70
+
71
+ # Write font binary to file
72
+ #
73
+ # @param tables_hash [Hash<String, String>] Map of table tag to binary data
74
+ # @param path [String] Output file path
75
+ # @param sfnt_version [Integer, nil] Font sfnt version. If nil, auto-detects.
76
+ # @return [Integer] Number of bytes written
77
+ #
78
+ # @example
79
+ # FontWriter.write_to_file(tables_hash, 'output.ttf')
80
+ def self.write_to_file(tables_hash, path, sfnt_version: nil)
81
+ binary = write_font(tables_hash, sfnt_version: sfnt_version)
82
+
83
+ # Create parent directories if they don't exist
84
+ dir = File.dirname(path)
85
+ FileUtils.mkdir_p(dir) unless Dir.exist?(dir)
86
+
87
+ File.binwrite(path, binary)
88
+ end
89
+
90
+ # Initialize writer with table data
91
+ #
92
+ # @param tables_hash [Hash<String, String>] Map of table tag to binary data
93
+ # @param sfnt_version [Integer] Font sfnt version
94
+ def initialize(tables_hash, sfnt_version: 0x00010000)
95
+ @tables = tables_hash
96
+ @sfnt_version = sfnt_version
97
+ end
98
+
99
+ # Write the complete font binary
100
+ #
101
+ # @return [String] Complete font binary
102
+ def write
103
+ # Order tables according to format
104
+ ordered_tags = order_tables
105
+
106
+ # Calculate table offsets
107
+ table_entries = calculate_table_entries(ordered_tags)
108
+
109
+ # Build font binary
110
+ font_data = String.new(encoding: Encoding::BINARY)
111
+
112
+ # Write offset table (sfnt header)
113
+ font_data << write_offset_table(table_entries.size)
114
+
115
+ # rubocop:disable Style/CombinableLoops
116
+ # Write table directory (ALL entries first)
117
+ table_entries.each do |entry|
118
+ font_data << write_table_entry(entry)
119
+ end
120
+
121
+ # Write table data (ALL data after directory)
122
+ table_entries.each do |entry|
123
+ font_data << entry[:data]
124
+ font_data << entry[:padding]
125
+ end
126
+ # rubocop:enable Style/CombinableLoops
127
+
128
+ # Calculate and update head table checksum adjustment
129
+ update_checksum_adjustment!(font_data, table_entries)
130
+
131
+ font_data
132
+ end
133
+
134
+ private
135
+
136
+ # Order tables according to recommended order
137
+ #
138
+ # @return [Array<String>] Ordered table tags
139
+ def order_tables
140
+ # Determine if this is OpenType/CFF or TrueType
141
+ is_cff = @tables.key?("CFF ") || @tables.key?("CFF2")
142
+ order = is_cff ? OPENTYPE_TABLE_ORDER : TRUETYPE_TABLE_ORDER
143
+
144
+ # Start with tables in recommended order that exist
145
+ ordered = order.select { |tag| @tables.key?(tag) }
146
+
147
+ # Add any remaining tables not in the recommended order
148
+ remaining = @tables.keys - ordered
149
+ ordered + remaining.sort
150
+ end
151
+
152
+ # Calculate table directory entries with offsets
153
+ #
154
+ # @param tags [Array<String>] Ordered table tags
155
+ # @return [Array<Hash>] Table entries with offsets, checksums, data
156
+ def calculate_table_entries(tags)
157
+ # Calculate offset for first table
158
+ # Offset table (12 bytes) + table directory (16 bytes per table)
159
+ offset = 12 + (tags.size * 16)
160
+
161
+ entries = []
162
+
163
+ tags.each do |tag|
164
+ data = @tables[tag]
165
+ checksum = calculate_table_checksum(directory_checksum_source(tag, data))
166
+
167
+ # Calculate padding to 4-byte boundary
168
+ padding_length = Utilities::Padding.boundary(data.bytesize)
169
+ padding = "\0" * padding_length
170
+
171
+ entries << {
172
+ tag: tag,
173
+ checksum: checksum,
174
+ offset: offset,
175
+ length: data.bytesize,
176
+ data: data,
177
+ padding: padding,
178
+ }
179
+
180
+ # Update offset for next table
181
+ offset += data.bytesize + padding_length
182
+ end
183
+
184
+ entries
185
+ end
186
+
187
+ # Write offset table (sfnt header)
188
+ #
189
+ # @param num_tables [Integer] Number of tables
190
+ # @return [String] Offset table binary data
191
+ def write_offset_table(num_tables)
192
+ # Calculate search range, entry selector, and range shift
193
+ # searchRange = (maximum power of 2 <= num_tables) * 16
194
+ # entrySelector = log2(maximum power of 2 <= num_tables)
195
+ # rangeShift = num_tables * 16 - searchRange
196
+
197
+ max_power = 0
198
+ n = num_tables
199
+ while n > 1
200
+ n >>= 1
201
+ max_power += 1
202
+ end
203
+
204
+ search_range = (1 << max_power) * 16
205
+ entry_selector = max_power
206
+ range_shift = (num_tables * 16) - search_range
207
+
208
+ [
209
+ @sfnt_version, # uint32 - sfnt version
210
+ num_tables, # uint16 - number of tables
211
+ search_range, # uint16 - search range
212
+ entry_selector, # uint16 - entry selector
213
+ range_shift, # uint16 - range shift
214
+ ].pack("N n n n n")
215
+ end
216
+
217
+ # Write a table directory entry
218
+ #
219
+ # @param entry [Hash] Table entry with tag, checksum, offset, length
220
+ # @return [String] Table directory entry binary data
221
+ def write_table_entry(entry)
222
+ [
223
+ entry[:tag], # char[4] - table tag
224
+ entry[:checksum], # uint32 - checksum
225
+ entry[:offset], # uint32 - offset
226
+ entry[:length], # uint32 - length
227
+ ].pack("a4 N N N")
228
+ end
229
+
230
+ # The bytes a table's directory checksum is computed over. The OpenType
231
+ # spec computes the head checksum with checkSumAdjustment (offset 8) as
232
+ # zero; using the source font's value made write -> reload -> write
233
+ # produce different bytes.
234
+ def directory_checksum_source(tag, data)
235
+ return data unless tag == "head" && data.bytesize >= 12
236
+
237
+ zeroed = data.b
238
+ zeroed[8, 4] = "\x00\x00\x00\x00".b
239
+ zeroed
240
+ end
241
+
242
+ # Calculate checksum for a table
243
+ #
244
+ # The checksum is calculated by summing all uint32 values in the table.
245
+ # The table is padded with zeros to a multiple of 4 bytes if necessary.
246
+ #
247
+ # @param data [String] Table binary data
248
+ # @return [Integer] Table checksum
249
+ def calculate_table_checksum(data)
250
+ padded_data = Utilities::Padding.pad(data)
251
+
252
+ # Sum all uint32 values
253
+ sum = 0
254
+ (0...padded_data.bytesize).step(4) do |i|
255
+ value = padded_data[i, 4].unpack1("N")
256
+ sum = (sum + value) & 0xFFFFFFFF
257
+ end
258
+
259
+ sum
260
+ end
261
+
262
+ # Update head table checksum adjustment
263
+ #
264
+ # The checksumAdjustment field in the head table (at offset 8) must be
265
+ # set such that the sum of all uint32 values in the entire font equals
266
+ # the magic number 0xB1B0AFBA.
267
+ #
268
+ # @param font_data [String] Complete font binary (modified in place)
269
+ # @param table_entries [Array<Hash>] Table entries
270
+ # @return [void]
271
+ def update_checksum_adjustment!(font_data, table_entries)
272
+ # Find head table entry
273
+ head_entry = table_entries.find { |e| e[:tag] == "head" }
274
+ return unless head_entry
275
+
276
+ # Zero out checksumAdjustment field (offset 8 in head table) before calculating
277
+ # This ensures we calculate the correct checksum regardless of source font's value
278
+ head_offset = head_entry[:offset]
279
+ checksum_offset = head_offset + 8
280
+ font_data[checksum_offset, 4] = "\x00\x00\x00\x00"
281
+
282
+ # Calculate font checksum (with head checksumAdjustment zeroed)
283
+ font_checksum = calculate_font_checksum(font_data)
284
+
285
+ # Calculate adjustment
286
+ adjustment = (Constants::CHECKSUM_ADJUSTMENT_MAGIC - font_checksum) & 0xFFFFFFFF
287
+
288
+ # Write adjustment as uint32 big-endian
289
+ font_data[checksum_offset, 4] = [adjustment].pack("N")
290
+ end
291
+
292
+ # Calculate checksum of entire font file
293
+ #
294
+ # @param data [String] Complete font binary
295
+ # @return [Integer] Font checksum
296
+ def calculate_font_checksum(data)
297
+ padded_data = Utilities::Padding.pad(data)
298
+
299
+ # Sum all uint32 values
300
+ sum = 0
301
+ (0...padded_data.bytesize).step(4) do |i|
302
+ value = padded_data[i, 4].unpack1("N")
303
+ sum = (sum + value) & 0xFFFFFFFF
304
+ end
305
+
306
+ sum
307
+ end
308
+ end
309
+ end