fontisan 0.4.49-java

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 (793) 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/Cargo.lock +550 -0
  11. data/Cargo.toml +12 -0
  12. data/Gemfile +40 -0
  13. data/LICENSE +28 -0
  14. data/README.adoc +2811 -0
  15. data/Rakefile +156 -0
  16. data/TODO.bug-fixes/01-cff-expert-charsets.md +27 -0
  17. data/TODO.bug-fixes/02-cff2-subroutine-stubs.md +32 -0
  18. data/TODO.bug-fixes/03-variation-subsetter-placeholders.md +42 -0
  19. data/TODO.bug-fixes/04-ufo-image-compile-roundtrip.md +28 -0
  20. data/TODO.bug-fixes/05-stale-cff-comment.md +18 -0
  21. data/TODO.bug-fixes/06-instance-woff2-output.md +24 -0
  22. data/TODO.bug-fixes/07-encapsulation-violations.md +38 -0
  23. data/TODO.bug-fixes/08-respond-to-violations.md +25 -0
  24. data/TODO.bug-fixes/09-type1-cff-seac-expansion.md +22 -0
  25. data/TODO.bug-fixes/10-ttf-type1-composite-glyphs.md +23 -0
  26. data/TODO.bug-fixes/11-remaining-respond-to.md +25 -0
  27. data/TODO.bug-fixes/12-type1-generators-duck-typing.md +80 -0
  28. data/TODO.bug-fixes/13-hint-extractor-duck-typing.md +30 -0
  29. data/TODO.bug-fixes/14-font-interface-type-checks.md +82 -0
  30. data/TODO.bug-fixes/15-glyph-type-checks-and-simple-glyph-points-bug.md +49 -0
  31. data/TODO.bug-fixes/16-variation-table-checks.md +31 -0
  32. data/TODO.bug-fixes/17-ufo-and-stitcher-cleanup.md +32 -0
  33. data/TODO.bug-fixes/18-generic-value-and-io-checks.md +56 -0
  34. data/TODO.bug-fixes/19-serialization-migration.md +52 -0
  35. data/TODO.bug-fixes/20-variation-validator-type-checks.md +29 -0
  36. data/TODO.bug-fixes/21-xml-builder-send.md +24 -0
  37. data/TODO.bug-fixes/22-type1-converter-font-info.md +25 -0
  38. data/TODO.bug-fixes/23-boundary-type-checks.md +31 -0
  39. data/TODO.bug-fixes/24-validator-dynamic-field-key.md +25 -0
  40. data/TODO.bug-fixes/25-serialization-migration.md +49 -0
  41. data/TODO.bug-fixes/26-variation-preserver-spec-migration.md +25 -0
  42. data/TODO.bug-fixes/27-table-class-registry.md +50 -0
  43. data/TODO.bug-fixes/28-spec-doubles-cleanup.md +40 -0
  44. data/TODO.bug-fixes/29-strategy-registries.md +30 -0
  45. data/TODO.bug-fixes/30-eliminate-send-in-specs.md +36 -0
  46. data/TODO.bug-fixes/README.md +52 -0
  47. data/TODO.improvements/01-cbdt-cblc-gid-stable-propagation.md +73 -0
  48. data/TODO.improvements/02-collection-outline-priority.md +48 -0
  49. data/TODO.improvements/03-fontisan-audit-command.md +219 -0
  50. data/TODO.improvements/04-ufo-composite-glyph-encoding.md +46 -0
  51. data/TODO.improvements/05-otf-compiler-real-cff.md +63 -0
  52. data/TODO.improvements/06-cff2-blend-vsindex-operators.md +51 -0
  53. data/TODO.improvements/07-cpal-v1-header-fields.md +71 -0
  54. data/TODO.improvements/08-cff-standard-string-table.md +52 -0
  55. data/TODO.improvements/09-type1-seac-expansion.md +57 -0
  56. data/TODO.improvements/10-ufo-image-set-feature-writers.md +71 -0
  57. data/TODO.improvements/11-kern-groups-plist.md +49 -0
  58. data/TODO.improvements/12-cbdt-fixture-bindata-conversion.md +68 -0
  59. data/TODO.improvements/13-split-octokit-fetcher.md +45 -0
  60. data/TODO.improvements/14-rubocop-baseline-chip.md +62 -0
  61. data/TODO.improvements/15-cff-cff2-subsetter-strategy.md +78 -0
  62. data/TODO.improvements/README.md +58 -0
  63. data/benchmark/baseline.json +5 -0
  64. data/benchmark/ci_gate.rb +217 -0
  65. data/benchmark/compile_benchmark.rb +78 -0
  66. data/benchmark/corpus/harness.rb +175 -0
  67. data/benchmark/corpus/ops.rb +150 -0
  68. data/benchmark/corpus/run.rb +182 -0
  69. data/benchmark/corpus/scan_child.rb +8 -0
  70. data/benchmark/corpus/tiers.rb +176 -0
  71. data/benchmark/tier_baseline.json +12 -0
  72. data/benchmark/variation_quick_bench.rb +47 -0
  73. data/build_mingw32_stub.rb +15 -0
  74. data/docs/.gitignore +17 -0
  75. data/docs/.vitepress/config.ts +373 -0
  76. data/docs/.vitepress/theme/components/ApiMethod.vue +127 -0
  77. data/docs/.vitepress/theme/components/Badge.vue +51 -0
  78. data/docs/.vitepress/theme/components/FeatureComparison.vue +87 -0
  79. data/docs/.vitepress/theme/components/HeroCodeBlock.vue +98 -0
  80. data/docs/.vitepress/theme/components/WithinHero.vue +30 -0
  81. data/docs/.vitepress/theme/index.ts +22 -0
  82. data/docs/.vitepress/theme/style.css +628 -0
  83. data/docs/AFDKO_MIGRATION.adoc +175 -0
  84. data/docs/APPLE_LEGACY_FONTS.adoc +173 -0
  85. data/docs/CFF2_SUPPORT.adoc +184 -0
  86. data/docs/COLLECTION_VALIDATION.adoc +204 -0
  87. data/docs/COLOR_FONTS.adoc +127 -0
  88. data/docs/CONVERSION_GUIDE.adoc +656 -0
  89. data/docs/EXTRACT_TTC_MIGRATION.md +549 -0
  90. data/docs/FEATURE_PARITY.adoc +263 -0
  91. data/docs/FONT_HINTING.adoc +570 -0
  92. data/docs/STITCHER_GUIDE.adoc +436 -0
  93. data/docs/SVG_TO_GLYF.adoc +118 -0
  94. data/docs/TTX.adoc +176 -0
  95. data/docs/TYPE1_FONTS.adoc +445 -0
  96. data/docs/UFO_COMPILATION.adoc +397 -0
  97. data/docs/VALIDATION.adoc +254 -0
  98. data/docs/VARIABLE_FONT_OPERATIONS.adoc +599 -0
  99. data/docs/WOFF_WOFF2_FORMATS.adoc +220 -0
  100. data/docs/api/conversion-options.md +164 -0
  101. data/docs/api/converters/curve-converter.md +34 -0
  102. data/docs/api/converters/hint-converter.md +34 -0
  103. data/docs/api/converters/outline-converter.md +27 -0
  104. data/docs/api/font-loader.md +117 -0
  105. data/docs/api/font-writer.md +103 -0
  106. data/docs/api/index.md +79 -0
  107. data/docs/api/layer.md +89 -0
  108. data/docs/api/models/glyph-accessor.md +43 -0
  109. data/docs/api/models/glyph.md +40 -0
  110. data/docs/api/models/table-analyzer.md +35 -0
  111. data/docs/api/sfnt-font.md +53 -0
  112. data/docs/api/type1-font.md +43 -0
  113. data/docs/api/validators/font-validator.md +31 -0
  114. data/docs/api/validators/helper.md +36 -0
  115. data/docs/api/validators/profile.md +39 -0
  116. data/docs/cli/convert.md +148 -0
  117. data/docs/cli/dump-table.md +110 -0
  118. data/docs/cli/export.md +176 -0
  119. data/docs/cli/features.md +124 -0
  120. data/docs/cli/glyphs.md +90 -0
  121. data/docs/cli/index.md +232 -0
  122. data/docs/cli/info.md +254 -0
  123. data/docs/cli/instance.md +122 -0
  124. data/docs/cli/ls.md +95 -0
  125. data/docs/cli/optical-size.md +94 -0
  126. data/docs/cli/pack.md +125 -0
  127. data/docs/cli/scripts.md +105 -0
  128. data/docs/cli/subset.md +58 -0
  129. data/docs/cli/tables.md +84 -0
  130. data/docs/cli/unicode.md +101 -0
  131. data/docs/cli/validate-collection.md +95 -0
  132. data/docs/cli/validate.md +56 -0
  133. data/docs/cli/variable.md +126 -0
  134. data/docs/cli/version.md +46 -0
  135. data/docs/guide/cli/convert.md +108 -0
  136. data/docs/guide/cli/export.md +138 -0
  137. data/docs/guide/cli/index.md +99 -0
  138. data/docs/guide/cli/info.md +144 -0
  139. data/docs/guide/cli/pack.md +155 -0
  140. data/docs/guide/cli/subset.md +149 -0
  141. data/docs/guide/cli/validate.md +139 -0
  142. data/docs/guide/color-fonts/bitmaps.md +194 -0
  143. data/docs/guide/color-fonts/colr-cpal.md +175 -0
  144. data/docs/guide/color-fonts/index.md +140 -0
  145. data/docs/guide/color-fonts/svg.md +154 -0
  146. data/docs/guide/color.md +51 -0
  147. data/docs/guide/comparisons/font-validator.md +222 -0
  148. data/docs/guide/comparisons/fonttools.md +200 -0
  149. data/docs/guide/comparisons/index.md +83 -0
  150. data/docs/guide/comparisons/lcdf-typetools.md +205 -0
  151. data/docs/guide/contributing.md +279 -0
  152. data/docs/guide/conversion/collections.md +251 -0
  153. data/docs/guide/conversion/curves.md +246 -0
  154. data/docs/guide/conversion/index.md +157 -0
  155. data/docs/guide/conversion/options.md +280 -0
  156. data/docs/guide/conversion/ttf-otf.md +184 -0
  157. data/docs/guide/conversion/type1.md +208 -0
  158. data/docs/guide/conversion/web.md +299 -0
  159. data/docs/guide/conversion.md +40 -0
  160. data/docs/guide/engines.md +117 -0
  161. data/docs/guide/formats/collections.md +147 -0
  162. data/docs/guide/formats/dfont.md +99 -0
  163. data/docs/guide/formats/index.md +65 -0
  164. data/docs/guide/formats/otf.md +103 -0
  165. data/docs/guide/formats/svg.md +97 -0
  166. data/docs/guide/formats/ttf.md +105 -0
  167. data/docs/guide/formats/type1.md +118 -0
  168. data/docs/guide/formats/woff.md +139 -0
  169. data/docs/guide/hinting/autohint.md +141 -0
  170. data/docs/guide/hinting/conversion.md +161 -0
  171. data/docs/guide/hinting/index.md +86 -0
  172. data/docs/guide/hinting/postscript.md +149 -0
  173. data/docs/guide/hinting/truetype.md +135 -0
  174. data/docs/guide/hinting.md +44 -0
  175. data/docs/guide/index.md +152 -0
  176. data/docs/guide/installation.md +116 -0
  177. data/docs/guide/migrations/extract-ttc.md +549 -0
  178. data/docs/guide/migrations/font-validator.md +260 -0
  179. data/docs/guide/migrations/fonttools.md +208 -0
  180. data/docs/guide/migrations/index.md +64 -0
  181. data/docs/guide/migrations/otfinfo.md +197 -0
  182. data/docs/guide/quick-start.md +204 -0
  183. data/docs/guide/type1.md +58 -0
  184. data/docs/guide/universal-outline.md +151 -0
  185. data/docs/guide/validation/custom.md +195 -0
  186. data/docs/guide/validation/helpers.md +188 -0
  187. data/docs/guide/validation/index.md +132 -0
  188. data/docs/guide/validation/profiles.md +156 -0
  189. data/docs/guide/validation.md +47 -0
  190. data/docs/guide/variable-fonts/advanced.md +231 -0
  191. data/docs/guide/variable-fonts/axes.md +209 -0
  192. data/docs/guide/variable-fonts/conversion.md +197 -0
  193. data/docs/guide/variable-fonts/index.md +84 -0
  194. data/docs/guide/variable-fonts/instances.md +187 -0
  195. data/docs/guide/variable-fonts/named-instances.md +194 -0
  196. data/docs/guide/variable-fonts/static.md +168 -0
  197. data/docs/guide/variable.md +58 -0
  198. data/docs/guide/woff.md +61 -0
  199. data/docs/index.md +136 -0
  200. data/docs/lychee.toml +41 -0
  201. data/docs/package-lock.json +2560 -0
  202. data/docs/package.json +15 -0
  203. data/docs/public/apple-touch-icon.png +0 -0
  204. data/docs/public/favicon-96x96.png +0 -0
  205. data/docs/public/favicon.ico +0 -0
  206. data/docs/public/favicon.svg +1 -0
  207. data/docs/public/logo-full.svg +1 -0
  208. data/docs/public/logo.svg +1 -0
  209. data/docs/public/robots.txt +4 -0
  210. data/docs/public/site.webmanifest +21 -0
  211. data/docs/public/web-app-manifest-192x192.png +0 -0
  212. data/docs/public/web-app-manifest-512x512.png +0 -0
  213. data/docs/reference-facade.md +130 -0
  214. data/docs/scripts/post-build.mjs +81 -0
  215. data/exe/fontisan +7 -0
  216. data/lib/fontisan/audit/check.rb +47 -0
  217. data/lib/fontisan/audit/check_registry.rb +77 -0
  218. data/lib/fontisan/audit/checks/cff_table_check.rb +87 -0
  219. data/lib/fontisan/audit/checks/cmap_check.rb +256 -0
  220. data/lib/fontisan/audit/checks/collection_integrity_check.rb +102 -0
  221. data/lib/fontisan/audit/checks/format_round_trip_check.rb +150 -0
  222. data/lib/fontisan/audit/checks/glyf_table_check.rb +115 -0
  223. data/lib/fontisan/audit/checks/glyph_name_check.rb +107 -0
  224. data/lib/fontisan/audit/checks/head_check.rb +96 -0
  225. data/lib/fontisan/audit/checks/hhea_check.rb +68 -0
  226. data/lib/fontisan/audit/checks/hinting_check.rb +163 -0
  227. data/lib/fontisan/audit/checks/kern_check.rb +47 -0
  228. data/lib/fontisan/audit/checks/layout_table_check.rb +70 -0
  229. data/lib/fontisan/audit/checks/maxp_check.rb +85 -0
  230. data/lib/fontisan/audit/checks/name_table_check.rb +78 -0
  231. data/lib/fontisan/audit/checks/naming_consistency_check.rb +102 -0
  232. data/lib/fontisan/audit/checks/opentype_conformance_check.rb +108 -0
  233. data/lib/fontisan/audit/checks/os2_check.rb +117 -0
  234. data/lib/fontisan/audit/checks/ots_compatibility_check.rb +191 -0
  235. data/lib/fontisan/audit/checks/post_check.rb +75 -0
  236. data/lib/fontisan/audit/checks/table_directory_check.rb +157 -0
  237. data/lib/fontisan/audit/checks/variable_font_check.rb +151 -0
  238. data/lib/fontisan/audit/checks/woff2_validation_check.rb +140 -0
  239. data/lib/fontisan/audit/checks.rb +42 -0
  240. data/lib/fontisan/audit.rb +20 -0
  241. data/lib/fontisan/base_collection.rb +312 -0
  242. data/lib/fontisan/binary/base_record.rb +82 -0
  243. data/lib/fontisan/binary/structures.rb +82 -0
  244. data/lib/fontisan/binary.rb +11 -0
  245. data/lib/fontisan/byte_ops.rb +314 -0
  246. data/lib/fontisan/cli.rb +1111 -0
  247. data/lib/fontisan/collection/builder.rb +336 -0
  248. data/lib/fontisan/collection/dfont_builder.rb +305 -0
  249. data/lib/fontisan/collection/offset_calculator.rb +229 -0
  250. data/lib/fontisan/collection/reader/stats.rb +23 -0
  251. data/lib/fontisan/collection/reader.rb +90 -0
  252. data/lib/fontisan/collection/shared_logic.rb +52 -0
  253. data/lib/fontisan/collection/table_analyzer.rb +289 -0
  254. data/lib/fontisan/collection/table_deduplicator.rb +317 -0
  255. data/lib/fontisan/collection/writer.rb +289 -0
  256. data/lib/fontisan/collection.rb +16 -0
  257. data/lib/fontisan/commands/audit_command.rb +288 -0
  258. data/lib/fontisan/commands/base_command.rb +88 -0
  259. data/lib/fontisan/commands/convert_command.rb +506 -0
  260. data/lib/fontisan/commands/dump_table_command.rb +68 -0
  261. data/lib/fontisan/commands/export_command.rb +157 -0
  262. data/lib/fontisan/commands/features_command.rb +90 -0
  263. data/lib/fontisan/commands/glyphs_command.rb +50 -0
  264. data/lib/fontisan/commands/info_command.rb +447 -0
  265. data/lib/fontisan/commands/instance_command.rb +357 -0
  266. data/lib/fontisan/commands/ls_command.rb +107 -0
  267. data/lib/fontisan/commands/multi_format_output.rb +64 -0
  268. data/lib/fontisan/commands/optical_size_command.rb +38 -0
  269. data/lib/fontisan/commands/pack_command.rb +344 -0
  270. data/lib/fontisan/commands/scripts_command.rb +56 -0
  271. data/lib/fontisan/commands/subset_command.rb +285 -0
  272. data/lib/fontisan/commands/tables_command.rb +52 -0
  273. data/lib/fontisan/commands/unicode_command.rb +73 -0
  274. data/lib/fontisan/commands/unpack_command.rb +387 -0
  275. data/lib/fontisan/commands/validate_collection_command.rb +127 -0
  276. data/lib/fontisan/commands/validate_command.rb +305 -0
  277. data/lib/fontisan/commands/variable_command.rb +87 -0
  278. data/lib/fontisan/commands.rb +30 -0
  279. data/lib/fontisan/config/collection_settings.yml +56 -0
  280. data/lib/fontisan/config/conversion_matrix.yml +626 -0
  281. data/lib/fontisan/config/export_settings.yml +66 -0
  282. data/lib/fontisan/config/features.yml +143 -0
  283. data/lib/fontisan/config/scripts.yml +42 -0
  284. data/lib/fontisan/config/subset_profiles.yml +106 -0
  285. data/lib/fontisan/config/svg_settings.yml +60 -0
  286. data/lib/fontisan/config/variable_settings.yml +99 -0
  287. data/lib/fontisan/config/woff2_settings.yml +77 -0
  288. data/lib/fontisan/constants.rb +219 -0
  289. data/lib/fontisan/conversion_options.rb +389 -0
  290. data/lib/fontisan/converters/cff_table_builder.rb +195 -0
  291. data/lib/fontisan/converters/collection_converter.rb +520 -0
  292. data/lib/fontisan/converters/conversion_strategy.rb +211 -0
  293. data/lib/fontisan/converters/format_converter.rb +536 -0
  294. data/lib/fontisan/converters/glyf_table_builder.rb +61 -0
  295. data/lib/fontisan/converters/outline_converter.rb +720 -0
  296. data/lib/fontisan/converters/outline_extraction.rb +88 -0
  297. data/lib/fontisan/converters/outline_optimizer.rb +84 -0
  298. data/lib/fontisan/converters/svg_generator.rb +236 -0
  299. data/lib/fontisan/converters/table_copier.rb +107 -0
  300. data/lib/fontisan/converters/type1_converter.rb +1201 -0
  301. data/lib/fontisan/converters/woff2_encoder.rb +520 -0
  302. data/lib/fontisan/converters/woff_writer.rb +358 -0
  303. data/lib/fontisan/converters.rb +21 -0
  304. data/lib/fontisan/dfont_collection.rb +288 -0
  305. data/lib/fontisan/engine.rb +393 -0
  306. data/lib/fontisan/error.rb +281 -0
  307. data/lib/fontisan/export/exporter.rb +255 -0
  308. data/lib/fontisan/export/table_serializer.rb +140 -0
  309. data/lib/fontisan/export/transformers/font_to_ttx.rb +163 -0
  310. data/lib/fontisan/export/transformers/head_transformer.rb +94 -0
  311. data/lib/fontisan/export/transformers/hhea_transformer.rb +57 -0
  312. data/lib/fontisan/export/transformers/maxp_transformer.rb +61 -0
  313. data/lib/fontisan/export/transformers/name_transformer.rb +61 -0
  314. data/lib/fontisan/export/transformers/os2_transformer.rb +119 -0
  315. data/lib/fontisan/export/transformers/post_transformer.rb +49 -0
  316. data/lib/fontisan/export/transformers.rb +17 -0
  317. data/lib/fontisan/export/ttx_generator.rb +526 -0
  318. data/lib/fontisan/export/ttx_parser.rb +300 -0
  319. data/lib/fontisan/export.rb +13 -0
  320. data/lib/fontisan/ffi/client.rb +123 -0
  321. data/lib/fontisan/ffi/darwin-arm64/libfontisan_cdylib.dylib +0 -0
  322. data/lib/fontisan/ffi/darwin-x86_64/libfontisan_cdylib.dylib +0 -0
  323. data/lib/fontisan/ffi/linux-x86_64/libfontisan_cdylib.so +0 -0
  324. data/lib/fontisan/ffi/windows-x86_64/fontisan_cdylib.dll +0 -0
  325. data/lib/fontisan/ffi.rb +387 -0
  326. data/lib/fontisan/ffi_platform.rb +24 -0
  327. data/lib/fontisan/font_loader.rb +315 -0
  328. data/lib/fontisan/font_writer.rb +309 -0
  329. data/lib/fontisan/formatters/text_formatter.rb +517 -0
  330. data/lib/fontisan/formatters.rb +9 -0
  331. data/lib/fontisan/glyph_accessor.rb +525 -0
  332. data/lib/fontisan/hints/hint_converter.rb +309 -0
  333. data/lib/fontisan/hints/hint_validator.rb +287 -0
  334. data/lib/fontisan/hints/postscript_hint_applier.rb +255 -0
  335. data/lib/fontisan/hints/postscript_hint_extractor.rb +347 -0
  336. data/lib/fontisan/hints/truetype_hint_applier.rb +117 -0
  337. data/lib/fontisan/hints/truetype_hint_extractor.rb +283 -0
  338. data/lib/fontisan/hints/truetype_instruction_analyzer.rb +268 -0
  339. data/lib/fontisan/hints/truetype_instruction_generator.rb +266 -0
  340. data/lib/fontisan/hints.rb +19 -0
  341. data/lib/fontisan/loading_modes.rb +113 -0
  342. data/lib/fontisan/metrics_calculator.rb +275 -0
  343. data/lib/fontisan/models/all_scripts_features_info.rb +20 -0
  344. data/lib/fontisan/models/audit_report.rb +196 -0
  345. data/lib/fontisan/models/bitmap_glyph.rb +123 -0
  346. data/lib/fontisan/models/bitmap_strike.rb +94 -0
  347. data/lib/fontisan/models/collection_brief_info.rb +36 -0
  348. data/lib/fontisan/models/collection_font_summary.rb +52 -0
  349. data/lib/fontisan/models/collection_info.rb +79 -0
  350. data/lib/fontisan/models/collection_list_info.rb +36 -0
  351. data/lib/fontisan/models/collection_validation_report.rb +102 -0
  352. data/lib/fontisan/models/color_glyph.rb +56 -0
  353. data/lib/fontisan/models/color_layer.rb +53 -0
  354. data/lib/fontisan/models/color_palette.rb +60 -0
  355. data/lib/fontisan/models/features_info.rb +42 -0
  356. data/lib/fontisan/models/font_export.rb +158 -0
  357. data/lib/fontisan/models/font_info.rb +98 -0
  358. data/lib/fontisan/models/font_report.rb +23 -0
  359. data/lib/fontisan/models/font_summary.rb +48 -0
  360. data/lib/fontisan/models/glyph_info.rb +26 -0
  361. data/lib/fontisan/models/glyph_outline.rb +343 -0
  362. data/lib/fontisan/models/hint.rb +404 -0
  363. data/lib/fontisan/models/optical_size_info.rb +33 -0
  364. data/lib/fontisan/models/outline.rb +667 -0
  365. data/lib/fontisan/models/scripts_info.rb +39 -0
  366. data/lib/fontisan/models/svg_glyph.rb +89 -0
  367. data/lib/fontisan/models/table_info.rb +55 -0
  368. data/lib/fontisan/models/table_sharing_info.rb +40 -0
  369. data/lib/fontisan/models/ttx/glyph_order.rb +31 -0
  370. data/lib/fontisan/models/ttx/tables/binary_table.rb +67 -0
  371. data/lib/fontisan/models/ttx/tables/head_table.rb +74 -0
  372. data/lib/fontisan/models/ttx/tables/hhea_table.rb +74 -0
  373. data/lib/fontisan/models/ttx/tables/maxp_table.rb +55 -0
  374. data/lib/fontisan/models/ttx/tables/name_table.rb +45 -0
  375. data/lib/fontisan/models/ttx/tables/os2_table.rb +157 -0
  376. data/lib/fontisan/models/ttx/tables/post_table.rb +50 -0
  377. data/lib/fontisan/models/ttx/tables.rb +21 -0
  378. data/lib/fontisan/models/ttx/ttfont.rb +41 -0
  379. data/lib/fontisan/models/ttx.rb +14 -0
  380. data/lib/fontisan/models/unicode_mappings.rb +42 -0
  381. data/lib/fontisan/models/validation_report.rb +435 -0
  382. data/lib/fontisan/models/variable_font_info.rb +82 -0
  383. data/lib/fontisan/models.rb +49 -0
  384. data/lib/fontisan/native.rb +235 -0
  385. data/lib/fontisan/open_type_collection.rb +49 -0
  386. data/lib/fontisan/open_type_font.rb +161 -0
  387. data/lib/fontisan/open_type_font_extensions.rb +54 -0
  388. data/lib/fontisan/optimizers/charstring_rewriter.rb +172 -0
  389. data/lib/fontisan/optimizers/pattern_analyzer.rb +310 -0
  390. data/lib/fontisan/optimizers/stack_tracker.rb +246 -0
  391. data/lib/fontisan/optimizers/subroutine_builder.rb +135 -0
  392. data/lib/fontisan/optimizers/subroutine_generator.rb +207 -0
  393. data/lib/fontisan/optimizers/subroutine_optimizer.rb +114 -0
  394. data/lib/fontisan/optimizers.rb +14 -0
  395. data/lib/fontisan/outline_extractor.rb +417 -0
  396. data/lib/fontisan/output_guard.rb +40 -0
  397. data/lib/fontisan/parsers/dfont_parser.rb +191 -0
  398. data/lib/fontisan/parsers/tag.rb +77 -0
  399. data/lib/fontisan/parsers.rb +10 -0
  400. data/lib/fontisan/pipeline/format_detector.rb +176 -0
  401. data/lib/fontisan/pipeline/output_writer.rb +161 -0
  402. data/lib/fontisan/pipeline/strategies/base_strategy.rb +75 -0
  403. data/lib/fontisan/pipeline/strategies/instance_strategy.rb +89 -0
  404. data/lib/fontisan/pipeline/strategies/named_strategy.rb +114 -0
  405. data/lib/fontisan/pipeline/strategies/preserve_strategy.rb +54 -0
  406. data/lib/fontisan/pipeline/strategies.rb +16 -0
  407. data/lib/fontisan/pipeline/transformation_pipeline.rb +407 -0
  408. data/lib/fontisan/pipeline/variation_resolver.rb +158 -0
  409. data/lib/fontisan/pipeline.rb +14 -0
  410. data/lib/fontisan/reference/table_digests.rb +251 -0
  411. data/lib/fontisan/reference.rb +663 -0
  412. data/lib/fontisan/scan.rb +372 -0
  413. data/lib/fontisan/sfnt_builder.rb +66 -0
  414. data/lib/fontisan/sfnt_directory.rb +41 -0
  415. data/lib/fontisan/sfnt_font.rb +749 -0
  416. data/lib/fontisan/sfnt_source.rb +28 -0
  417. data/lib/fontisan/sfnt_table.rb +260 -0
  418. data/lib/fontisan/stitcher/cbdt_propagator.rb +212 -0
  419. data/lib/fontisan/stitcher/collection_result.rb +19 -0
  420. data/lib/fontisan/stitcher/deduplicator.rb +47 -0
  421. data/lib/fontisan/stitcher/format_metadata.rb +51 -0
  422. data/lib/fontisan/stitcher/glyph_cloner.rb +41 -0
  423. data/lib/fontisan/stitcher/glyph_copier.rb +110 -0
  424. data/lib/fontisan/stitcher/glyph_limit.rb +53 -0
  425. data/lib/fontisan/stitcher/glyph_signature.rb +51 -0
  426. data/lib/fontisan/stitcher/partition_strategy/base.rb +52 -0
  427. data/lib/fontisan/stitcher/partition_strategy/blueprint.rb +24 -0
  428. data/lib/fontisan/stitcher/partition_strategy/by_block.rb +430 -0
  429. data/lib/fontisan/stitcher/partition_strategy/by_plane.rb +161 -0
  430. data/lib/fontisan/stitcher/partition_strategy/by_script.rb +309 -0
  431. data/lib/fontisan/stitcher/partition_strategy/partition.rb +24 -0
  432. data/lib/fontisan/stitcher/partition_strategy.rb +24 -0
  433. data/lib/fontisan/stitcher/selector/codepoints.rb +29 -0
  434. data/lib/fontisan/stitcher/selector/gid.rb +25 -0
  435. data/lib/fontisan/stitcher/selector/range.rb +30 -0
  436. data/lib/fontisan/stitcher/selector.rb +26 -0
  437. data/lib/fontisan/stitcher/source.rb +459 -0
  438. data/lib/fontisan/stitcher/unique_glyph_name.rb +46 -0
  439. data/lib/fontisan/stitcher.rb +185 -0
  440. data/lib/fontisan/stitcher_cli.rb +69 -0
  441. data/lib/fontisan/subset/builder.rb +263 -0
  442. data/lib/fontisan/subset/glyph_mapping.rb +222 -0
  443. data/lib/fontisan/subset/options.rb +142 -0
  444. data/lib/fontisan/subset/profile.rb +152 -0
  445. data/lib/fontisan/subset/shared_state.rb +42 -0
  446. data/lib/fontisan/subset/subset_context.rb +20 -0
  447. data/lib/fontisan/subset/table_strategy/cbdt.rb +30 -0
  448. data/lib/fontisan/subset/table_strategy/cblc.rb +27 -0
  449. data/lib/fontisan/subset/table_strategy/cff.rb +92 -0
  450. data/lib/fontisan/subset/table_strategy/cff2.rb +391 -0
  451. data/lib/fontisan/subset/table_strategy/cmap.rb +146 -0
  452. data/lib/fontisan/subset/table_strategy/color_bitmap_placement.rb +20 -0
  453. data/lib/fontisan/subset/table_strategy/color_bitmap_strike_plan.rb +45 -0
  454. data/lib/fontisan/subset/table_strategy/color_bitmap_subset_plan.rb +62 -0
  455. data/lib/fontisan/subset/table_strategy/color_bitmap_subsetter.rb +182 -0
  456. data/lib/fontisan/subset/table_strategy/color_bitmap_subtable_plan.rb +59 -0
  457. data/lib/fontisan/subset/table_strategy/glyf.rb +29 -0
  458. data/lib/fontisan/subset/table_strategy/glyf_loca_builder.rb +146 -0
  459. data/lib/fontisan/subset/table_strategy/head.rb +43 -0
  460. data/lib/fontisan/subset/table_strategy/hhea.rb +67 -0
  461. data/lib/fontisan/subset/table_strategy/hmtx.rb +52 -0
  462. data/lib/fontisan/subset/table_strategy/loca.rb +41 -0
  463. data/lib/fontisan/subset/table_strategy/maxp.rb +23 -0
  464. data/lib/fontisan/subset/table_strategy/name.rb +19 -0
  465. data/lib/fontisan/subset/table_strategy/os2.rb +21 -0
  466. data/lib/fontisan/subset/table_strategy/pass_through.rb +20 -0
  467. data/lib/fontisan/subset/table_strategy/post.rb +37 -0
  468. data/lib/fontisan/subset/table_strategy.rb +79 -0
  469. data/lib/fontisan/subset/table_subsetter.rb +110 -0
  470. data/lib/fontisan/subset.rb +16 -0
  471. data/lib/fontisan/svg/font_face_generator.rb +274 -0
  472. data/lib/fontisan/svg/font_generator.rb +256 -0
  473. data/lib/fontisan/svg/glyph_generator.rb +201 -0
  474. data/lib/fontisan/svg/standalone_glyph.rb +132 -0
  475. data/lib/fontisan/svg/view_box_calculator.rb +137 -0
  476. data/lib/fontisan/svg.rb +13 -0
  477. data/lib/fontisan/svg_to_glyf/assembler.rb +174 -0
  478. data/lib/fontisan/svg_to_glyf/document.rb +102 -0
  479. data/lib/fontisan/svg_to_glyf/geometry/affine_transform.rb +112 -0
  480. data/lib/fontisan/svg_to_glyf/geometry/normalizer.rb +62 -0
  481. data/lib/fontisan/svg_to_glyf/geometry/transform_parser.rb +98 -0
  482. data/lib/fontisan/svg_to_glyf/geometry.rb +15 -0
  483. data/lib/fontisan/svg_to_glyf/path/command.rb +18 -0
  484. data/lib/fontisan/svg_to_glyf/path/contour_builder.rb +140 -0
  485. data/lib/fontisan/svg_to_glyf/path/parser.rb +98 -0
  486. data/lib/fontisan/svg_to_glyf/path/state.rb +79 -0
  487. data/lib/fontisan/svg_to_glyf/path.rb +14 -0
  488. data/lib/fontisan/svg_to_glyf.rb +62 -0
  489. data/lib/fontisan/tables/cbdt.rb +113 -0
  490. data/lib/fontisan/tables/cblc.rb +172 -0
  491. data/lib/fontisan/tables/cblc_big_glyph_metrics.rb +28 -0
  492. data/lib/fontisan/tables/cblc_bitmap_size.rb +67 -0
  493. data/lib/fontisan/tables/cblc_glyph_bitmap_location.rb +28 -0
  494. data/lib/fontisan/tables/cblc_index_subtable.rb +104 -0
  495. data/lib/fontisan/tables/cblc_index_subtable_array_entry.rb +20 -0
  496. data/lib/fontisan/tables/cblc_index_subtable_format_parser.rb +150 -0
  497. data/lib/fontisan/tables/cblc_index_subtable_header.rb +18 -0
  498. data/lib/fontisan/tables/cblc_sbit_line_metrics.rb +28 -0
  499. data/lib/fontisan/tables/cff/cff2_charstring_builder.rb +225 -0
  500. data/lib/fontisan/tables/cff/cff_glyph.rb +176 -0
  501. data/lib/fontisan/tables/cff/charset.rb +276 -0
  502. data/lib/fontisan/tables/cff/charstring.rb +978 -0
  503. data/lib/fontisan/tables/cff/charstring_builder.rb +356 -0
  504. data/lib/fontisan/tables/cff/charstring_parser.rb +249 -0
  505. data/lib/fontisan/tables/cff/charstring_rebuilder.rb +168 -0
  506. data/lib/fontisan/tables/cff/charstrings_index.rb +159 -0
  507. data/lib/fontisan/tables/cff/dict.rb +353 -0
  508. data/lib/fontisan/tables/cff/dict_builder.rb +260 -0
  509. data/lib/fontisan/tables/cff/encoding.rb +273 -0
  510. data/lib/fontisan/tables/cff/expert_charsets.rb +85 -0
  511. data/lib/fontisan/tables/cff/header.rb +100 -0
  512. data/lib/fontisan/tables/cff/hint_operation_injector.rb +207 -0
  513. data/lib/fontisan/tables/cff/index.rb +241 -0
  514. data/lib/fontisan/tables/cff/index_builder.rb +170 -0
  515. data/lib/fontisan/tables/cff/offset_recalculator.rb +70 -0
  516. data/lib/fontisan/tables/cff/private_dict.rb +282 -0
  517. data/lib/fontisan/tables/cff/private_dict_writer.rb +129 -0
  518. data/lib/fontisan/tables/cff/standard_strings_data.rb +83 -0
  519. data/lib/fontisan/tables/cff/table_builder.rb +215 -0
  520. data/lib/fontisan/tables/cff/top_dict.rb +234 -0
  521. data/lib/fontisan/tables/cff.rb +497 -0
  522. data/lib/fontisan/tables/cff2/blend_operator.rb +240 -0
  523. data/lib/fontisan/tables/cff2/charstring_parser.rb +624 -0
  524. data/lib/fontisan/tables/cff2/dict_encoder.rb +94 -0
  525. data/lib/fontisan/tables/cff2/fd_select.rb +142 -0
  526. data/lib/fontisan/tables/cff2/header.rb +34 -0
  527. data/lib/fontisan/tables/cff2/index.rb +155 -0
  528. data/lib/fontisan/tables/cff2/index_builder.rb +80 -0
  529. data/lib/fontisan/tables/cff2/operand_stack.rb +232 -0
  530. data/lib/fontisan/tables/cff2/private_dict_blend_handler.rb +247 -0
  531. data/lib/fontisan/tables/cff2/region_matcher.rb +200 -0
  532. data/lib/fontisan/tables/cff2/table_builder.rb +567 -0
  533. data/lib/fontisan/tables/cff2/table_reader.rb +418 -0
  534. data/lib/fontisan/tables/cff2/variation_data_extractor.rb +212 -0
  535. data/lib/fontisan/tables/cff2.rb +353 -0
  536. data/lib/fontisan/tables/cmap.rb +399 -0
  537. data/lib/fontisan/tables/cmap_table.rb +228 -0
  538. data/lib/fontisan/tables/colr.rb +290 -0
  539. data/lib/fontisan/tables/cpal.rb +381 -0
  540. data/lib/fontisan/tables/cvar.rb +204 -0
  541. data/lib/fontisan/tables/fvar.rb +159 -0
  542. data/lib/fontisan/tables/glyf/compound_glyph.rb +482 -0
  543. data/lib/fontisan/tables/glyf/compound_glyph_resolver.rb +135 -0
  544. data/lib/fontisan/tables/glyf/curve_converter.rb +349 -0
  545. data/lib/fontisan/tables/glyf/glyph_builder.rb +468 -0
  546. data/lib/fontisan/tables/glyf/simple_glyph.rb +391 -0
  547. data/lib/fontisan/tables/glyf.rb +347 -0
  548. data/lib/fontisan/tables/glyf_table.rb +252 -0
  549. data/lib/fontisan/tables/gpos/glyph_filter.rb +87 -0
  550. data/lib/fontisan/tables/gpos/kerning_pairs.rb +215 -0
  551. data/lib/fontisan/tables/gpos/pair_position.rb +274 -0
  552. data/lib/fontisan/tables/gpos.rb +139 -0
  553. data/lib/fontisan/tables/gsub.rb +116 -0
  554. data/lib/fontisan/tables/gvar.rb +232 -0
  555. data/lib/fontisan/tables/head.rb +208 -0
  556. data/lib/fontisan/tables/head_table.rb +108 -0
  557. data/lib/fontisan/tables/hhea.rb +199 -0
  558. data/lib/fontisan/tables/hhea_table.rb +252 -0
  559. data/lib/fontisan/tables/hmtx.rb +281 -0
  560. data/lib/fontisan/tables/hmtx_table.rb +188 -0
  561. data/lib/fontisan/tables/hvar.rb +192 -0
  562. data/lib/fontisan/tables/layout_common.rb +245 -0
  563. data/lib/fontisan/tables/loca.rb +323 -0
  564. data/lib/fontisan/tables/loca_table.rb +209 -0
  565. data/lib/fontisan/tables/maxp.rb +253 -0
  566. data/lib/fontisan/tables/maxp_table.rb +255 -0
  567. data/lib/fontisan/tables/mvar.rb +185 -0
  568. data/lib/fontisan/tables/name.rb +340 -0
  569. data/lib/fontisan/tables/name_table.rb +173 -0
  570. data/lib/fontisan/tables/os2.rb +291 -0
  571. data/lib/fontisan/tables/os2_table.rb +326 -0
  572. data/lib/fontisan/tables/post.rb +206 -0
  573. data/lib/fontisan/tables/post_table.rb +180 -0
  574. data/lib/fontisan/tables/registry.rb +71 -0
  575. data/lib/fontisan/tables/sbix.rb +379 -0
  576. data/lib/fontisan/tables/svg.rb +300 -0
  577. data/lib/fontisan/tables/variation_common.rb +345 -0
  578. data/lib/fontisan/tables/vvar.rb +234 -0
  579. data/lib/fontisan/tables.rb +69 -0
  580. data/lib/fontisan/true_type_collection.rb +160 -0
  581. data/lib/fontisan/true_type_font.rb +80 -0
  582. data/lib/fontisan/true_type_font_extensions.rb +54 -0
  583. data/lib/fontisan/type1/afm_generator.rb +379 -0
  584. data/lib/fontisan/type1/afm_parser.rb +299 -0
  585. data/lib/fontisan/type1/agl.rb +456 -0
  586. data/lib/fontisan/type1/cff_to_type1_converter.rb +307 -0
  587. data/lib/fontisan/type1/charstring_converter.rb +238 -0
  588. data/lib/fontisan/type1/charstrings.rb +441 -0
  589. data/lib/fontisan/type1/conversion_options.rb +242 -0
  590. data/lib/fontisan/type1/decryptor.rb +183 -0
  591. data/lib/fontisan/type1/encodings.rb +695 -0
  592. data/lib/fontisan/type1/font_dictionary.rb +576 -0
  593. data/lib/fontisan/type1/generator.rb +217 -0
  594. data/lib/fontisan/type1/inf_generator.rb +307 -0
  595. data/lib/fontisan/type1/pfa_generator.rb +376 -0
  596. data/lib/fontisan/type1/pfa_parser.rb +159 -0
  597. data/lib/fontisan/type1/pfb_generator.rb +321 -0
  598. data/lib/fontisan/type1/pfb_parser.rb +166 -0
  599. data/lib/fontisan/type1/pfm_generator.rb +589 -0
  600. data/lib/fontisan/type1/pfm_parser.rb +433 -0
  601. data/lib/fontisan/type1/private_dict.rb +363 -0
  602. data/lib/fontisan/type1/seac_expander.rb +517 -0
  603. data/lib/fontisan/type1/ttf_to_type1_converter.rb +389 -0
  604. data/lib/fontisan/type1/upm_scaler.rb +118 -0
  605. data/lib/fontisan/type1.rb +48 -0
  606. data/lib/fontisan/type1_font.rb +347 -0
  607. data/lib/fontisan/ufo/anchor.rb +17 -0
  608. data/lib/fontisan/ufo/bounds.rb +91 -0
  609. data/lib/fontisan/ufo/cli.rb +105 -0
  610. data/lib/fontisan/ufo/compile/avar.rb +46 -0
  611. data/lib/fontisan/ufo/compile/base_compiler.rb +162 -0
  612. data/lib/fontisan/ufo/compile/cbdt_cblc.rb +104 -0
  613. data/lib/fontisan/ufo/compile/cff.rb +229 -0
  614. data/lib/fontisan/ufo/compile/cff2.rb +323 -0
  615. data/lib/fontisan/ufo/compile/cff2_subroutines.rb +39 -0
  616. data/lib/fontisan/ufo/compile/cmap.rb +143 -0
  617. data/lib/fontisan/ufo/compile/colr.rb +80 -0
  618. data/lib/fontisan/ufo/compile/cpal.rb +62 -0
  619. data/lib/fontisan/ufo/compile/feature_compiler.rb +161 -0
  620. data/lib/fontisan/ufo/compile/feature_writers/base.rb +56 -0
  621. data/lib/fontisan/ufo/compile/feature_writers/curs.rb +72 -0
  622. data/lib/fontisan/ufo/compile/feature_writers/gdef.rb +92 -0
  623. data/lib/fontisan/ufo/compile/feature_writers/kern.rb +50 -0
  624. data/lib/fontisan/ufo/compile/feature_writers/kern2.rb +57 -0
  625. data/lib/fontisan/ufo/compile/feature_writers/mark.rb +45 -0
  626. data/lib/fontisan/ufo/compile/feature_writers/mark_family_base.rb +124 -0
  627. data/lib/fontisan/ufo/compile/feature_writers/mkmk.rb +53 -0
  628. data/lib/fontisan/ufo/compile/feature_writers.rb +38 -0
  629. data/lib/fontisan/ufo/compile/filters/cubic_to_quadratic.rb +176 -0
  630. data/lib/fontisan/ufo/compile/filters/decompose_components.rb +33 -0
  631. data/lib/fontisan/ufo/compile/filters/flatten_components.rb +22 -0
  632. data/lib/fontisan/ufo/compile/filters/propagate_anchors.rb +102 -0
  633. data/lib/fontisan/ufo/compile/filters/remove_overlaps.rb +95 -0
  634. data/lib/fontisan/ufo/compile/filters/reverse_contour_direction.rb +27 -0
  635. data/lib/fontisan/ufo/compile/filters/sort_contours.rb +69 -0
  636. data/lib/fontisan/ufo/compile/filters/transformations.rb +113 -0
  637. data/lib/fontisan/ufo/compile/filters.rb +69 -0
  638. data/lib/fontisan/ufo/compile/fvar.rb +113 -0
  639. data/lib/fontisan/ufo/compile/glyf_loca.rb +206 -0
  640. data/lib/fontisan/ufo/compile/gpos.rb +248 -0
  641. data/lib/fontisan/ufo/compile/gsub.rb +267 -0
  642. data/lib/fontisan/ufo/compile/gvar.rb +225 -0
  643. data/lib/fontisan/ufo/compile/head.rb +97 -0
  644. data/lib/fontisan/ufo/compile/hhea.rb +57 -0
  645. data/lib/fontisan/ufo/compile/hmtx.rb +38 -0
  646. data/lib/fontisan/ufo/compile/hvar.rb +42 -0
  647. data/lib/fontisan/ufo/compile/item_variation_store.rb +100 -0
  648. data/lib/fontisan/ufo/compile/math.rb +143 -0
  649. data/lib/fontisan/ufo/compile/maxp.rb +57 -0
  650. data/lib/fontisan/ufo/compile/meta.rb +51 -0
  651. data/lib/fontisan/ufo/compile/mvar.rb +59 -0
  652. data/lib/fontisan/ufo/compile/name.rb +81 -0
  653. data/lib/fontisan/ufo/compile/os2.rb +81 -0
  654. data/lib/fontisan/ufo/compile/otf2_compiler.rb +40 -0
  655. data/lib/fontisan/ufo/compile/otf_compiler.rb +34 -0
  656. data/lib/fontisan/ufo/compile/post.rb +32 -0
  657. data/lib/fontisan/ufo/compile/sbix.rb +100 -0
  658. data/lib/fontisan/ufo/compile/stat.rb +106 -0
  659. data/lib/fontisan/ufo/compile/svg_table.rb +60 -0
  660. data/lib/fontisan/ufo/compile/ttf_compiler.rb +75 -0
  661. data/lib/fontisan/ufo/compile/variable_otf.rb +84 -0
  662. data/lib/fontisan/ufo/compile/variable_ttf.rb +161 -0
  663. data/lib/fontisan/ufo/compile.rb +72 -0
  664. data/lib/fontisan/ufo/component.rb +18 -0
  665. data/lib/fontisan/ufo/contour.rb +34 -0
  666. data/lib/fontisan/ufo/convert/from_bin_data.rb +366 -0
  667. data/lib/fontisan/ufo/convert/to_dfont.rb +45 -0
  668. data/lib/fontisan/ufo/convert/to_otc.rb +40 -0
  669. data/lib/fontisan/ufo/convert/to_otf.rb +18 -0
  670. data/lib/fontisan/ufo/convert/to_otf2.rb +20 -0
  671. data/lib/fontisan/ufo/convert/to_postscript.rb +64 -0
  672. data/lib/fontisan/ufo/convert/to_ttc.rb +35 -0
  673. data/lib/fontisan/ufo/convert/to_ttf.rb +21 -0
  674. data/lib/fontisan/ufo/convert/to_woff.rb +61 -0
  675. data/lib/fontisan/ufo/convert/to_woff2.rb +50 -0
  676. data/lib/fontisan/ufo/convert.rb +84 -0
  677. data/lib/fontisan/ufo/data_set.rb +21 -0
  678. data/lib/fontisan/ufo/features.rb +17 -0
  679. data/lib/fontisan/ufo/font.rb +63 -0
  680. data/lib/fontisan/ufo/glyph.rb +445 -0
  681. data/lib/fontisan/ufo/glyph_exists_error.rb +23 -0
  682. data/lib/fontisan/ufo/groups.rb +45 -0
  683. data/lib/fontisan/ufo/guideline.rb +19 -0
  684. data/lib/fontisan/ufo/image.rb +29 -0
  685. data/lib/fontisan/ufo/image_set.rb +99 -0
  686. data/lib/fontisan/ufo/info.rb +133 -0
  687. data/lib/fontisan/ufo/kerning.rb +32 -0
  688. data/lib/fontisan/ufo/layer.rb +78 -0
  689. data/lib/fontisan/ufo/layer_set.rb +37 -0
  690. data/lib/fontisan/ufo/lib.rb +24 -0
  691. data/lib/fontisan/ufo/plist.rb +123 -0
  692. data/lib/fontisan/ufo/point.rb +32 -0
  693. data/lib/fontisan/ufo/reader.rb +163 -0
  694. data/lib/fontisan/ufo/transformation.rb +50 -0
  695. data/lib/fontisan/ufo/writer.rb +123 -0
  696. data/lib/fontisan/ufo.rb +47 -0
  697. data/lib/fontisan/unicode/plane.rb +44 -0
  698. data/lib/fontisan/unicode.rb +17 -0
  699. data/lib/fontisan/utilities/brotli_wrapper.rb +177 -0
  700. data/lib/fontisan/utilities/checksum_calculator.rb +104 -0
  701. data/lib/fontisan/utilities/padding.rb +61 -0
  702. data/lib/fontisan/utilities.rb +11 -0
  703. data/lib/fontisan/utils/thread_pool.rb +134 -0
  704. data/lib/fontisan/utils.rb +10 -0
  705. data/lib/fontisan/validation/collection_validator.rb +265 -0
  706. data/lib/fontisan/validation.rb +9 -0
  707. data/lib/fontisan/validators/basic_validator.rb +73 -0
  708. data/lib/fontisan/validators/font_book_validator.rb +107 -0
  709. data/lib/fontisan/validators/opentype_validator.rb +118 -0
  710. data/lib/fontisan/validators/profile_loader.rb +134 -0
  711. data/lib/fontisan/validators/validator.rb +494 -0
  712. data/lib/fontisan/validators/web_font_validator.rb +95 -0
  713. data/lib/fontisan/validators.rb +14 -0
  714. data/lib/fontisan/variable/axis_normalizer.rb +215 -0
  715. data/lib/fontisan/variable/delta_applicator.rb +302 -0
  716. data/lib/fontisan/variable/glyph_delta_processor.rb +218 -0
  717. data/lib/fontisan/variable/instancer.rb +172 -0
  718. data/lib/fontisan/variable/metric_delta_processor.rb +282 -0
  719. data/lib/fontisan/variable/region_matcher.rb +208 -0
  720. data/lib/fontisan/variable/static_font_builder.rb +209 -0
  721. data/lib/fontisan/variable/table_updater.rb +219 -0
  722. data/lib/fontisan/variable.rb +16 -0
  723. data/lib/fontisan/variation/blend_applier.rb +197 -0
  724. data/lib/fontisan/variation/cache.rb +299 -0
  725. data/lib/fontisan/variation/cache_key_builder.rb +162 -0
  726. data/lib/fontisan/variation/converter.rb +373 -0
  727. data/lib/fontisan/variation/data_extractor.rb +84 -0
  728. data/lib/fontisan/variation/delta_applier.rb +262 -0
  729. data/lib/fontisan/variation/delta_parser.rb +228 -0
  730. data/lib/fontisan/variation/inspector.rb +275 -0
  731. data/lib/fontisan/variation/instance_font_wrapper.rb +41 -0
  732. data/lib/fontisan/variation/instance_generator.rb +122 -0
  733. data/lib/fontisan/variation/instance_writer.rb +360 -0
  734. data/lib/fontisan/variation/instancing/axis_space.rb +136 -0
  735. data/lib/fontisan/variation/instancing/glyph_outline.rb +204 -0
  736. data/lib/fontisan/variation/instancing/gvar_reader.rb +146 -0
  737. data/lib/fontisan/variation/instancing/item_variation_store.rb +92 -0
  738. data/lib/fontisan/variation/instancing/name_rewriter.rb +90 -0
  739. data/lib/fontisan/variation/instancing/true_type_instancer.rb +326 -0
  740. data/lib/fontisan/variation/instancing.rb +20 -0
  741. data/lib/fontisan/variation/interpolator.rb +231 -0
  742. data/lib/fontisan/variation/metrics_adjuster.rb +309 -0
  743. data/lib/fontisan/variation/optimizer.rb +417 -0
  744. data/lib/fontisan/variation/parallel_generator.rb +147 -0
  745. data/lib/fontisan/variation/region_matcher.rb +221 -0
  746. data/lib/fontisan/variation/subsetter.rb +400 -0
  747. data/lib/fontisan/variation/table_accessor.rb +105 -0
  748. data/lib/fontisan/variation/tuple_variation_header.rb +49 -0
  749. data/lib/fontisan/variation/validator.rb +336 -0
  750. data/lib/fontisan/variation/variable_svg_generator.rb +235 -0
  751. data/lib/fontisan/variation/variation_context.rb +208 -0
  752. data/lib/fontisan/variation/variation_preserver.rb +287 -0
  753. data/lib/fontisan/variation.rb +33 -0
  754. data/lib/fontisan/version.rb +5 -0
  755. data/lib/fontisan/version.rb.orig +9 -0
  756. data/lib/fontisan/woff2/collection_decoder.rb +223 -0
  757. data/lib/fontisan/woff2/collection_encoder.rb +302 -0
  758. data/lib/fontisan/woff2/directory.rb +255 -0
  759. data/lib/fontisan/woff2/encoder_rules.rb +114 -0
  760. data/lib/fontisan/woff2/glyf_canonicalizer.rb +90 -0
  761. data/lib/fontisan/woff2/glyf_loca_reconstruct.rb +401 -0
  762. data/lib/fontisan/woff2/glyf_loca_transform.rb +319 -0
  763. data/lib/fontisan/woff2/header.rb +101 -0
  764. data/lib/fontisan/woff2/hmtx_transformer.rb +140 -0
  765. data/lib/fontisan/woff2/sfnt_checksum.rb +107 -0
  766. data/lib/fontisan/woff2/table_transformer.rb +575 -0
  767. data/lib/fontisan/woff2/triplet_codec.rb +181 -0
  768. data/lib/fontisan/woff2/uint255.rb +101 -0
  769. data/lib/fontisan/woff2.rb +21 -0
  770. data/lib/fontisan/woff2_collection.rb +127 -0
  771. data/lib/fontisan/woff2_font.rb +754 -0
  772. data/lib/fontisan/woff_container.rb +83 -0
  773. data/lib/fontisan/woff_font.rb +554 -0
  774. data/lib/fontisan.rb +299 -0
  775. data/rakelib/bench.rake +9 -0
  776. data/rakelib/cdylib.rake +39 -0
  777. data/rakelib/corpus.rake +272 -0
  778. data/rakelib/corpus_convert.rake +43 -0
  779. data/rakelib/corpus_goldens.rake +22 -0
  780. data/rakelib/corpus_malformed.rake +20 -0
  781. data/rakelib/corpus_scan.rake +24 -0
  782. data/rakelib/java.rake +61 -0
  783. data/rakelib/native.rake +43 -0
  784. data/scripts/build-woff2.sh +57 -0
  785. data/scripts/compare_stack_aware.rb +187 -0
  786. data/scripts/corpus/generate_convert_goldens.rb +478 -0
  787. data/scripts/corpus/generate_goldens.rb +282 -0
  788. data/scripts/corpus/generate_malformed_goldens.rb +254 -0
  789. data/scripts/corpus/generate_scan_goldens.rb +98 -0
  790. data/scripts/measure_optimization.rb +148 -0
  791. data/scripts/tier_fallback.rb +228 -0
  792. data/scripts/tier_smoke.rb +72 -0
  793. metadata +940 -0
@@ -0,0 +1,663 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "digest"
4
+ require "json"
5
+
6
+ module Fontisan
7
+ # The reference facade: one path-based entry point per engine operation.
8
+ #
9
+ # Every golden is generated through this module and every engine tier
10
+ # (Ruby, native, FFI) serves the same operations, so the signatures, return
11
+ # schemas and error surfaces here are the contract. Operations take a file
12
+ # path, never a loaded font object. They wrap existing classes and add no
13
+ # behaviour except three deliberate additions:
14
+ #
15
+ # 1. An optional `timestamp:` (Unix seconds) reaches the places Ruby stamps
16
+ # `head.modified` from the clock (WOFF2 encode, and StaticFontBuilder).
17
+ # nil keeps today's behaviour; operations that do not stamp ignore it.
18
+ # 2. {.subset} copies fontist's `glyph_ids` step (cmap -> uniq -> sort and
19
+ # its "None of the requested characters exist in <name>" error) before
20
+ # calling `Subset::Builder` with the web profile.
21
+ # 3. {.convert} runs `Fontisan.convert` quietly (ConvertCommand prints to
22
+ # stdout otherwise).
23
+ #
24
+ # Read-type results ({.read}, {.audit}, {.audit_dir}, {.scan}) are plain
25
+ # JSON-ready data: Hash with String keys sorted bytewise, Array, String,
26
+ # Integer, true, false, nil. They never contain a Float (Fixed 16.16 values
27
+ # are raw integers) or a clock value. See docs/reference-facade.md or
28
+ # REFERENCE-FACADE.md at the repository root.
29
+ #
30
+ # Errors: operations let the wrapped class's exception propagate unchanged
31
+ # (Errno::ENOENT, Fontisan::InvalidFontError, Fontisan::Error
32
+ # "Conversion failed: ...", ArgumentError for bad options, ...). {.scan}
33
+ # and {.audit_dir} never raise for a bad font; they record the failure in
34
+ # the row.
35
+ module Reference
36
+ FONT_EXTENSIONS = %w[.ttf .otf .ttc .otc .woff .woff2 .dfont .pfa .pfb].freeze
37
+
38
+ # Tables whose parsed header fields are included in {.read}.
39
+ SNAPSHOT_TABLES = {
40
+ "head" => :head, "hhea" => :hhea, "maxp" => :maxp, "OS/2" => :os2
41
+ }.freeze
42
+
43
+ FIXED_ONE = 65_536
44
+
45
+ VARIATION_DIGESTS = {
46
+ "gvar" => :gvar, "HVAR" => :hvar, "VVAR" => :hvar, "MVAR" => :mvar, "STAT" => :stat
47
+ }.freeze
48
+
49
+ POST_FIELDS = %i[version_raw italic_angle_raw underline_position underline_thickness
50
+ is_fixed_pitch min_mem_type42 max_mem_type42 min_mem_type1
51
+ max_mem_type1].freeze
52
+
53
+ # Ruby errors a malformed font can provoke inside the parsers and builders.
54
+ # They are not part of any contract; {.malformed_font} turns them into
55
+ # Fontisan::InvalidFontError. A bare RuntimeError is deliberately absent:
56
+ # the loaders raise "Invalid <Type> file: ..." and the specs and goldens
57
+ # pin that class. EOFError is absent too: the corpus goldens (read, audit,
58
+ # scan of the truncated fonts) pin it as the reference behaviour.
59
+ PARSER_LEAKS = [NoMethodError, IndexError, RangeError, TypeError, ZeroDivisionError].freeze
60
+
61
+ autoload :TableDigests, "fontisan/reference/table_digests"
62
+
63
+ class << self
64
+ # The InvalidFontError text for a leaked parser error, shared with the
65
+ # engine tiers that mirror the Ruby classes the engine reports.
66
+ def malformed_message(klass, message)
67
+ "Malformed font data (#{klass}): #{message}"
68
+ end
69
+
70
+ # Read the structure of every face in a font file.
71
+ #
72
+ # @param path [String]
73
+ # @param mode [Symbol] :metadata or :full (FontLoader loading mode)
74
+ # @param lazy [Boolean] FontLoader lazy flag
75
+ # @return [Array<Hash>] one Hash per face (see docs for the schema)
76
+ def read(path, mode: :metadata, lazy: true)
77
+ path = path_arg(path)
78
+ malformed_font do
79
+ sha = Digest::SHA256.file(path).hexdigest
80
+ format = FontLoader.detect_format(path)&.to_s
81
+ count = face_count(path)
82
+ faces = Array.new(count) do |index|
83
+ font = FontLoader.load(path, font_index: index, mode: mode, lazy: lazy)
84
+ begin
85
+ read_face(font, index, sha, format, mode, lazy)
86
+ ensure
87
+ font.close if font.respond_to?(:close)
88
+ end
89
+ end
90
+ normalize(faces)
91
+ end
92
+ end
93
+
94
+ # Per-glyph outline hashes of one face (full mode).
95
+ #
96
+ # glyf fonts: SHA-256 of the glyph's byte range in `glyf`, located by
97
+ # the parsed `loca`. CFF/CFF2 fonts: SHA-256 of the glyph's
98
+ # CharString bytes from the CharStrings INDEX. Empty glyphs hash the
99
+ # empty string.
100
+ #
101
+ # @return [Hash] `{"kind"=>"glyf"|"cff"|nil, "hashes"=>[hex, ...]}`
102
+ def outline_hashes(path, index: 0)
103
+ path = path_arg(path)
104
+ malformed_font do
105
+ font = FontLoader.load(path, font_index: index, mode: :full,
106
+ lazy: true)
107
+ begin
108
+ normalize(outline_data(font))
109
+ ensure
110
+ font.close if font.respond_to?(:close)
111
+ end
112
+ end
113
+ end
114
+
115
+ # Structured audit of every face, without clock or version fields.
116
+ #
117
+ # @param path [String]
118
+ # @param validate [Boolean, Symbol] false (no checks), true (default
119
+ # profile) or a profile name
120
+ # @return [Array<Hash>] one canonical report per face
121
+ def audit(path, validate: false)
122
+ path = path_arg(path)
123
+ result = malformed_font do
124
+ Commands::AuditCommand.new(
125
+ path, validate: validate || false, include_codepoints: false
126
+ ).run
127
+ end
128
+ normalize(Array(result).map { |report| audit_hash(report) })
129
+ end
130
+
131
+ # Audit every font file below a directory.
132
+ #
133
+ # @param dir [String]
134
+ # @param validate [Boolean, Symbol] as for {.audit}
135
+ # @return [Array<Hash>] one entry per file, sorted by relative path:
136
+ # `{"path"=>rel, "faces"=>[...]}` or `{"path"=>rel, "error"=>{...}}`
137
+ def audit_dir(dir, validate: false)
138
+ dir = path_arg(dir)
139
+ files = font_files(dir)
140
+ entries = files.map do |file|
141
+ rel = relative_row_path(dir, file)
142
+ begin
143
+ { path: rel, faces: audit(file, validate: validate) }
144
+ rescue StandardError => e
145
+ { path: rel, error: { class: e.class.name, message: e.message } }
146
+ end
147
+ end
148
+ normalize(entries)
149
+ end
150
+
151
+ # The path of an audit_dir row relative to +dir+, with "/" separators. An
152
+ # engine tier on Windows reports "D:/a/dir\\file.ttf" (the directory as
153
+ # given, then a native separator), so both sides are normalised before the
154
+ # prefix is removed; elsewhere a backslash is an ordinary file name byte.
155
+ #
156
+ # @param dir [String]
157
+ # @param path [String] the row's path, below +dir+
158
+ # @param alt_separator [String, nil] the platform's second separator
159
+ # @return [String]
160
+ def relative_row_path(dir, path, alt_separator: File::ALT_SEPARATOR)
161
+ if alt_separator
162
+ dir = dir.tr(alt_separator, "/")
163
+ path = path.tr(alt_separator, "/")
164
+ end
165
+ dir = dir.delete_suffix("/") while dir.end_with?("/")
166
+ prefix = "#{dir}/"
167
+ return path unless path.start_with?(prefix)
168
+
169
+ # A glob over "dir//" yields "dir//a.ttf": drop every separator.
170
+ path.delete_prefix(prefix).sub(%r{\A/+}, "")
171
+ end
172
+
173
+ # One row per font face for every path (see {Fontisan::Scan}).
174
+ #
175
+ # @param paths [Array<String>]
176
+ # @return [Array<Hash>] rows in input order; never raises for a bad font
177
+ def scan(paths)
178
+ paths = Array(paths).map { |p| path_arg(p, must_exist: false) }
179
+ normalize(Scan.call(paths))
180
+ end
181
+
182
+ # Convert a font file to another format.
183
+ #
184
+ # @param path [String]
185
+ # @param to [Symbol, String] target format (:ttf, :otf, :woff, :woff2,
186
+ # :ttc, ...); a single format
187
+ # @param output [String] output path
188
+ # @param timestamp [Integer, Time, nil] fixed head.modified for WOFF2
189
+ # output; ignored for other targets
190
+ # @return [Hash] the ConvertCommand result (success, input_path,
191
+ # output_path, source_format, target_format, input_size, output_size,
192
+ # variation_strategy | num_fonts)
193
+ # @raise [Fontisan::Error] "Conversion failed: ..."
194
+ def convert(path, output:, timestamp: nil, **options)
195
+ path = path_arg(path)
196
+ target = options.fetch(:to)
197
+ opts = { quiet: true, **options.except(:to) }
198
+ opts[:timestamp] = unix_seconds(timestamp) if stamps?(target, timestamp)
199
+ # The command itself, not Fontisan.convert: that one dispatches to the
200
+ # native tier and would loop back through the gate.
201
+ Commands::ConvertCommand.new(path, { to: target, output: output, **opts }).run
202
+ end
203
+
204
+ # Extract one member of a collection as a standalone font.
205
+ #
206
+ # @return [String] path of the extracted file (as UnpackCommand reports)
207
+ def extract(path, index:, output_dir:)
208
+ path = path_arg(path)
209
+ Commands::UnpackCommand.new(
210
+ path, output_dir: output_dir, font_index: index
211
+ ).run[:extracted_files].first
212
+ end
213
+
214
+ # Static instance of a variable font.
215
+ #
216
+ # @param coords [Hash{String=>Numeric}] axis tag => value
217
+ # @param timestamp [Integer, Time, nil] accepted for uniformity;
218
+ # Instancer does not stamp, so it is ignored
219
+ # @return [String] binary font bytes
220
+ def instance(path, coords:, timestamp: nil)
221
+ _ = timestamp
222
+ path = path_arg(path)
223
+ check_sfnt_directory(path)
224
+ font = malformed_font { FontLoader.load(path, mode: :full, lazy: false) }
225
+ values = coords.to_h { |tag, value| [tag.to_s, Float(value)] }
226
+ malformed_font { Variable::Instancer.new(font).instance(values) }
227
+ end
228
+
229
+ # Glyph ids kept by a subset request (fontist's `glyph_ids`).
230
+ #
231
+ # @param unicodes [Array<Integer>, nil] codepoints
232
+ # @param text [String, nil] characters to keep
233
+ # @return [Array<Integer>] sorted, unique glyph ids
234
+ # @raise [Fontisan::Error] "None of the requested characters exist in
235
+ # <basename>"
236
+ def glyph_ids(path, unicodes: nil, text: nil)
237
+ path = path_arg(path)
238
+ font = malformed_font { FontLoader.load(path, mode: :full, lazy: false) }
239
+ codepoints = Array(unicodes).map(&:to_i) + text.to_s.codepoints
240
+ malformed_font { gids_for(font, codepoints, File.basename(path)) }
241
+ end
242
+
243
+ # Subset a font to the glyphs of the given characters.
244
+ #
245
+ # @param profile [String] subset profile (default "web")
246
+ # @param timestamp [Integer, Time, nil] ignored: Subset::Builder keeps
247
+ # the source head.modified
248
+ # @return [String] binary font bytes
249
+ def subset(path, unicodes: nil, text: nil, profile: "web", timestamp: nil)
250
+ _ = timestamp
251
+ path = path_arg(path)
252
+ font = malformed_font { FontLoader.load(path, mode: :full, lazy: false) }
253
+ codepoints = Array(unicodes).map(&:to_i) + text.to_s.codepoints
254
+ options = Subset::Options.new(profile: profile)
255
+ malformed_font do
256
+ gids = gids_for(font, codepoints, File.basename(path))
257
+ Subset::Builder.new(font, gids, options).build
258
+ end
259
+ end
260
+
261
+ # Canonical JSON text of a read-type result: sorted keys, two-space
262
+ # indent, trailing newline.
263
+ def canonical_json(data)
264
+ "#{JSON.pretty_generate(normalize(data))}\n"
265
+ end
266
+
267
+ # Recursively convert to JSON-ready data with sorted String keys.
268
+ # Floats are rejected: Fixed values must be stored as raw integers.
269
+ def normalize(value)
270
+ case value
271
+ when Hash
272
+ value.map { |k, v| [k.to_s, normalize(v)] }.sort_by(&:first).to_h
273
+ when Array then value.map { |v| normalize(v) }
274
+ when Symbol then value.to_s
275
+ when BinData::Base then normalize(value.snapshot)
276
+ when Float
277
+ raise ArgumentError, "Float #{value} in canonical output"
278
+ else value
279
+ end
280
+ end
281
+
282
+ private
283
+
284
+ # Run a parse or build step of a font that may be malformed. A Ruby
285
+ # internal error (see PARSER_LEAKS) becomes Fontisan::InvalidFontError, the
286
+ # class every tier raises for bad font data; the original is the cause.
287
+ def malformed_font
288
+ yield
289
+ rescue *PARSER_LEAKS => e
290
+ raise InvalidFontError, malformed_message(e.class, e.message)
291
+ end
292
+
293
+ # A plain sfnt whose table directory runs past the end of the file fails
294
+ # as convert does (the engine tiers' own check, fontist/fontisan#159),
295
+ # not with whatever the loader or the instancer would trip over.
296
+ def check_sfnt_directory(path)
297
+ return unless File.file?(path) && %i[ttf otf].include?(FontLoader.detect_format(path))
298
+
299
+ SfntDirectory.check!(File.binread(path))
300
+ rescue SfntDirectory::Malformed => e
301
+ raise Error, "Conversion failed: #{e.message}"
302
+ end
303
+
304
+ def path_arg(path, must_exist: true)
305
+ unless path.is_a?(String) || path.respond_to?(:to_path)
306
+ raise TypeError,
307
+ "Reference operations take a file path, got #{path.class}"
308
+ end
309
+
310
+ path = File.path(path)
311
+ raise Errno::ENOENT, path if must_exist && !File.exist?(path)
312
+
313
+ path
314
+ end
315
+
316
+ def face_count(path)
317
+ FontLoader.collection?(path) ? FontLoader.load_collection(path).num_fonts : 1
318
+ end
319
+
320
+ def font_files(dir)
321
+ Dir.glob(File.join(dir, "**", "*"))
322
+ .select { |f| File.file?(f) && FONT_EXTENSIONS.include?(File.extname(f).downcase) }
323
+ .sort
324
+ end
325
+
326
+ def stamps?(target, timestamp)
327
+ !timestamp.nil? && target.to_s == "woff2"
328
+ end
329
+
330
+ def unix_seconds(timestamp)
331
+ timestamp.respond_to?(:to_time) ? timestamp.to_time.to_i : Integer(timestamp)
332
+ end
333
+
334
+ def gids_for(font, codepoints, name)
335
+ cmap = font.table("cmap") or
336
+ raise Fontisan::MissingTableError,
337
+ "Required table 'cmap' not found in font"
338
+ mappings = cmap.unicode_mappings
339
+ gids = codepoints.uniq.filter_map { |cp| mappings[cp] }.uniq.sort
340
+ return gids if gids.any?
341
+
342
+ raise Fontisan::Error, "None of the requested characters exist in #{name}"
343
+ end
344
+
345
+ # ---- audit ---------------------------------------------------------
346
+
347
+ def audit_hash(report)
348
+ data = JSON.parse(report.to_json)
349
+ data.delete("generated_at")
350
+ data.delete("fontisan_version")
351
+ data["font_revision_raw"] = fixed_raw(data.delete("font_revision"))
352
+ data["axes"] = Array(data["axes"]).map { |axis| axis_raw(axis) }
353
+ mask_addresses(data)
354
+ end
355
+
356
+ # Messages of checks that crash embed `#<Class:0x000...>`; the address
357
+ # differs per run, so it is dropped: `#<Class>`.
358
+ def mask_addresses(value)
359
+ case value
360
+ when String then value.gsub(/#<([\w:]+):0x\h+>/, '#<\\1>')
361
+ when Array then value.map { |v| mask_addresses(v) }
362
+ when Hash then value.transform_values { |v| mask_addresses(v) }
363
+ else value
364
+ end
365
+ end
366
+
367
+ def axis_raw(axis)
368
+ %w[min_value default_value max_value].each_with_object(axis) do |key, h|
369
+ h["#{key}_raw"] = fixed_raw(h.delete(key))
370
+ end
371
+ end
372
+
373
+ def fixed_raw(value)
374
+ value.nil? ? nil : (value * FIXED_ONE).round
375
+ end
376
+
377
+ # ---- read ----------------------------------------------------------
378
+
379
+ def read_face(font, index, sha, format, mode, lazy)
380
+ {
381
+ index: index,
382
+ format: format,
383
+ mode: mode.to_s,
384
+ lazy: lazy ? true : false,
385
+ file_sha256: sha,
386
+ tables: table_digests(font),
387
+ names: name_records(font),
388
+ header_fields: header_fields(font),
389
+ cmap: cmap_digest(font),
390
+ fvar: fvar_data(font),
391
+ outlines: outline_summary(font),
392
+ hmtx_metrics: hmtx_metrics(font),
393
+ post: post_data(font),
394
+ layout: layout_data(font),
395
+ variation: variation_data(font),
396
+ }
397
+ end
398
+
399
+ # Digest of the per-glyph horizontal metrics as Tables::Hmtx#metric_for
400
+ # decodes them (advance and lsb of every glyph). Raw-byte digests
401
+ # (`tables`) cannot see a decoder bug and no convert golden reads hmtx,
402
+ # so this is the only golden that does. (Parsed glyf coordinates are
403
+ # covered by the convert goldens, which rebuild outlines in ttf -> otf.)
404
+ # nil when hmtx is absent or gated out by the loading mode; `{error:
405
+ # class}` when parsing fails.
406
+ def hmtx_metrics(font)
407
+ return nil unless available_table(font, "hmtx") && available_table(font, "hhea") && available_table(font, "maxp")
408
+
409
+ hmtx = font.table("hmtx")
410
+ hhea = font.table("hhea")
411
+ num_glyphs = font.table("maxp").num_glyphs
412
+ hmtx.parse_with_context(hhea.number_of_h_metrics, num_glyphs) unless hmtx.parsed?
413
+ packed = Array.new(num_glyphs) do |gid|
414
+ metric = hmtx.metric_for(gid)
415
+ [metric[:advance_width], metric[:lsb]].pack("Nl>")
416
+ end
417
+ { count: num_glyphs, sha256: Digest::SHA256.hexdigest(packed.join) }
418
+ rescue StandardError => e
419
+ { error: e.class.name }
420
+ end
421
+
422
+ # post header fields plus a count and digest of the glyph names (names
423
+ # joined with "\n"); a failure to read the names is recorded, not raised.
424
+ def post_data(font)
425
+ table = available_table(font, "post")
426
+ return nil unless table
427
+
428
+ data = POST_FIELDS.to_h { |f| [f, table.public_send(f).to_i] }
429
+ begin
430
+ names = table.glyph_names
431
+ data[:glyph_name_count] = names.size
432
+ data[:glyph_names_sha256] = Digest::SHA256.hexdigest(names.join("\n"))
433
+ rescue StandardError => e
434
+ data[:glyph_names_error] = e.class.name
435
+ end
436
+ data
437
+ end
438
+
439
+ # GSUB/GPOS script tags and, per script, feature tags, as the table
440
+ # classes report them (they swallow parse errors and answer []).
441
+ def layout_data(font)
442
+ %w[GSUB GPOS].to_h do |tag|
443
+ table = available_table(font, tag)
444
+ next [tag, nil] unless table
445
+
446
+ scripts = table.scripts
447
+ by_script = table.script_features
448
+ [tag, {
449
+ scripts: scripts,
450
+ features: scripts.to_h { |s| [s, by_script.fetch(s, [])] },
451
+ }]
452
+ end
453
+ end
454
+
455
+ # Parsed digests of the variation tables, from the raw table bytes
456
+ # (see {TableDigests}). A table that cannot be read records the error.
457
+ def variation_data(font)
458
+ VARIATION_DIGESTS.to_h do |tag, digest|
459
+ [tag, digest_table(font, tag, digest)]
460
+ end
461
+ end
462
+
463
+ def digest_table(font, tag, digest)
464
+ return nil unless font.has_table?(tag)
465
+
466
+ font.table(tag)
467
+ raw = raw_table(font, tag)
468
+ raw ? TableDigests.public_send(digest, raw) : nil
469
+ rescue ArgumentError
470
+ nil
471
+ rescue StandardError => e
472
+ { error: e.class.name }
473
+ end
474
+
475
+ # Digest of every table the loading mode makes available. A table that
476
+ # the mode gates out has a nil digest; a table that fails to load or
477
+ # parse records the error class (Ruby fails lazily, on first access).
478
+ def table_digests(font)
479
+ font.table_names.map do |tag|
480
+ entry = { tag: tag, length: nil, sha256: nil, error: nil }
481
+ begin
482
+ font.table(tag)
483
+ raw = raw_table(font, tag)
484
+ if raw
485
+ entry[:length] = raw.bytesize
486
+ entry[:sha256] = Digest::SHA256.hexdigest(raw)
487
+ end
488
+ rescue ArgumentError
489
+ entry[:error] = nil # gated by the loading mode
490
+ rescue StandardError => e
491
+ entry[:error] = e.class.name
492
+ end
493
+ entry
494
+ end
495
+ end
496
+
497
+ def raw_table(font, tag)
498
+ if font.method(:table_data).arity.zero?
499
+ font.table_data[tag]
500
+ else
501
+ font.table_data(tag)
502
+ end
503
+ end
504
+
505
+ def name_records(font)
506
+ table = available_table(font, "name")
507
+ return [] unless table
508
+
509
+ table.name_records.map do |record|
510
+ {
511
+ platform_id: record.platform_id.to_i,
512
+ encoding_id: record.encoding_id.to_i,
513
+ language_id: record.language_id.to_i,
514
+ name_id: record.name_id.to_i,
515
+ string: decode_name(table, record),
516
+ }
517
+ end
518
+ end
519
+
520
+ # Same decoding rules as fontist's decode_name_record_manually.
521
+ def decode_name(table, record)
522
+ storage = table.string_storage.to_s.b
523
+ length = record.string_length
524
+ return nil if record.string_offset + length > storage.bytesize || length.zero?
525
+
526
+ data = storage.byteslice(record.string_offset, length)
527
+ case record.platform_id.to_i
528
+ when 0, 3
529
+ data.dup.force_encoding("UTF-16BE")
530
+ .encode("UTF-8", invalid: :replace, undef: :replace)
531
+ when 1
532
+ data.dup.force_encoding("ASCII-8BIT")
533
+ .encode("UTF-8", invalid: :replace, undef: :replace)
534
+ else
535
+ data.dup.force_encoding("UTF-8").scrub
536
+ end
537
+ end
538
+
539
+ def header_fields(font)
540
+ SNAPSHOT_TABLES.keys.each_with_object({}) do |tag, out|
541
+ table = available_table(font, tag)
542
+ out[tag] = table ? snapshot(table) : nil
543
+ end
544
+ end
545
+
546
+ def snapshot(table)
547
+ table.snapshot.transform_values { |v| snapshot_value(v) }
548
+ end
549
+
550
+ # Strings that are printable ASCII (tags, vendor ids) stay text; any
551
+ # other String is "0x" + hex.
552
+ def snapshot_value(value)
553
+ case value
554
+ when String
555
+ value.b.match?(/\A[\x20-\x7e]*\z/n) ? value : "0x#{value.b.unpack1('H*')}"
556
+ when Array then value.map { |v| snapshot_value(v) }
557
+ when Hash then value.transform_values { |v| snapshot_value(v) }
558
+ else value
559
+ end
560
+ end
561
+
562
+ # Count and digest of the sorted codepoints: SHA-256 over each
563
+ # codepoint as a big-endian uint32, ascending.
564
+ def cmap_digest(font)
565
+ table = available_table(font, "cmap")
566
+ return nil unless table
567
+
568
+ codepoints = (table.unicode_mappings || {}).keys.sort
569
+ {
570
+ count: codepoints.size,
571
+ sha256: Digest::SHA256.hexdigest(codepoints.pack("N*")),
572
+ subtable_formats: table.subtable_formats,
573
+ }
574
+ end
575
+
576
+ def fvar_data(font)
577
+ table = available_table(font, "fvar")
578
+ return nil unless table
579
+
580
+ {
581
+ axes: table.axes.map { |axis| snapshot(axis) },
582
+ instances: table.instances.compact.map { |inst| instance_data(inst) },
583
+ }
584
+ end
585
+
586
+ def instance_data(inst)
587
+ {
588
+ name_id: inst[:name_id],
589
+ flags: inst[:flags],
590
+ postscript_name_id: inst[:postscript_name_id],
591
+ coordinates_raw: Array(inst[:coordinates]).map { |c| (c * FIXED_ONE).round },
592
+ }
593
+ end
594
+
595
+ def outline_summary(font)
596
+ data = outline_data(font)
597
+ return { kind: nil, count: 0, digest: nil } if data[:kind].nil?
598
+
599
+ hashes = data[:hashes]
600
+ {
601
+ kind: data[:kind],
602
+ count: hashes.size,
603
+ digest: Digest::SHA256.hexdigest(hashes.map { |h| [h].pack("H*") }.join),
604
+ }
605
+ rescue StandardError => e
606
+ { kind: nil, count: 0, digest: nil, error: e.class.name }
607
+ end
608
+
609
+ def outline_data(font)
610
+ if available_table(font, "glyf") && available_table(font, "loca")
611
+ { kind: "glyf", hashes: glyf_hashes(font) }
612
+ elsif (cff = cff_table(font))
613
+ { kind: "cff", hashes: cff_hashes(cff) }
614
+ elsif font.has_table?("CFF2") && (raw = raw_table(font, "CFF2"))
615
+ { kind: "cff2", hashes: TableDigests.cff2_charstrings(raw).map { |c| Digest::SHA256.hexdigest(c) } }
616
+ else
617
+ { kind: nil, hashes: [] }
618
+ end
619
+ end
620
+
621
+ def glyf_hashes(font)
622
+ glyf = raw_table(font, "glyf")
623
+ loca = font.table("loca")
624
+ head = font.table("head")
625
+ maxp = font.table("maxp")
626
+ loca.parse_with_context(head.index_to_loc_format, maxp.num_glyphs) unless loca.parsed?
627
+ Array.new(maxp.num_glyphs) do |gid|
628
+ bytes = glyf.byteslice(loca.offset_for(gid), loca.size_of(gid)) || ""
629
+ Digest::SHA256.hexdigest(bytes)
630
+ end
631
+ end
632
+
633
+ # WoffFont#table returns nil for "CFF " (measured), so parse the raw
634
+ # table when the font class gives no parsed one.
635
+ def cff_table(font)
636
+ parsed = available_table(font, "CFF ")
637
+ return parsed if parsed
638
+
639
+ raw = font.has_table?("CFF ") && raw_table(font, "CFF ")
640
+ raw ? Tables::Cff.read(raw) : nil
641
+ end
642
+
643
+ def cff_hashes(cff)
644
+ index = cff.charstrings_index
645
+ return [] unless index
646
+
647
+ Array.new(index.count) { |gid| Digest::SHA256.hexdigest(index[gid]) }
648
+ end
649
+
650
+ # The parsed table, or nil when the font lacks it or the loading mode
651
+ # gates it out.
652
+ def available_table(font, tag)
653
+ return nil unless font.has_table?(tag)
654
+
655
+ font.table(tag)
656
+ rescue ArgumentError
657
+ nil
658
+ end
659
+ end
660
+ end
661
+ end
662
+
663
+ Fontisan::Engine.install(Fontisan::Reference)