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,478 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "digest"
4
+ require "fileutils"
5
+ require "json"
6
+ require "open3"
7
+ require "tmpdir"
8
+ require "zlib"
9
+ require "fontisan"
10
+ require_relative "../../corpus/derive/sfnt"
11
+
12
+ # Convert goldens (fontist/fontisan#156, card 0c).
13
+ #
14
+ # One golden file per corpus font: corpus/goldens/convert/<font-id>.json. Each
15
+ # holds one result per applicable case, generated through Fontisan::Reference:
16
+ #
17
+ # format:<to> Reference.convert (single fonts: ttf otf woff woff2;
18
+ # collections: ttc otc woff2), every target but the source
19
+ # extract:<i> Reference.extract, every collection member
20
+ # instance:<i> Reference.instance, every named instance of an fvar font
21
+ # subset:text-latin / subset:unicodes-sample Reference.subset, profile "web"
22
+ #
23
+ # A result records the comparison class (index rule): "exact" (sha256 of the
24
+ # raw output bytes) except WOFF/WOFF2 encode, "decoded-exact" (the output
25
+ # sha256 plus the per-table sha256 after decoding), and the OTS verdict.
26
+ # Nothing is stored but hashes. Errors are goldens too (class + masked message).
27
+ module ConvertGoldens
28
+ ROOT = File.expand_path("../..", __dir__)
29
+ GOLDEN_DIR = File.join(ROOT, "corpus", "goldens", "convert")
30
+ MANIFEST = File.join(ROOT, "corpus", "manifest.json")
31
+ TRIAGE = File.join(ROOT, "corpus", "TRIAGE_CONVERT.md")
32
+ # The one fixed head.modified for WOFF2 encode (2025-01-01T00:00:00Z).
33
+ TIMESTAMP = 1_735_689_600
34
+ SINGLE_TARGETS = %w[ttf otf woff woff2].freeze
35
+ COLLECTION_TARGETS = %w[ttc otc woff2].freeze
36
+ SUBSET_TEXT = "Hamburgefonstiv 0123"
37
+ SUBSET_SAMPLE = 8
38
+ MAGICS = {
39
+ "\x00\x01\x00\x00".b => "ttf", "true" => "ttf", "OTTO" => "otf",
40
+ "wOFF" => "woff", "wOF2" => "woff2", "ttcf" => "ttc"
41
+ }.freeze
42
+ # Not convert subjects: malformed inputs are card 0e's, dfont/Type 1 are
43
+ # routing-only rows.
44
+ EXCLUDED_ID = /\Amalformed-/
45
+ OUTPUT_EXT = { "ttf" => "ttf", "otf" => "otf", "woff" => "woff", "woff2" => "woff2",
46
+ "ttc" => "ttc", "otc" => "otc" }.freeze
47
+
48
+ class ToolMissing < StandardError; end
49
+
50
+ module_function
51
+
52
+ def manifest_entries(tiers)
53
+ JSON.parse(File.read(MANIFEST)).fetch("fonts").select { |f| tiers.include?(f["tier"]) }
54
+ end
55
+
56
+ def font_path(entry)
57
+ if entry["type"] == "derived"
58
+ File.join(ROOT, "corpus", "derived", entry.fetch("file"))
59
+ else
60
+ File.join(ROOT, "corpus", "fonts", entry.fetch("id"), entry.fetch("file"))
61
+ end
62
+ end
63
+
64
+ def sniff(path)
65
+ MAGICS[File.binread(path, 4)]
66
+ end
67
+
68
+ # Fonts that are convert subjects, with their detected input format.
69
+ def subjects(tiers)
70
+ manifest_entries(tiers).filter_map do |entry|
71
+ next if entry["id"].match?(EXCLUDED_ID)
72
+
73
+ path = font_path(entry)
74
+ next unless File.exist?(path)
75
+
76
+ format = sniff(path)
77
+ format ? [entry, path, format] : nil
78
+ end
79
+ end
80
+
81
+ # --- case enumeration ---------------------------------------------------
82
+
83
+ def read_faces(path)
84
+ Fontisan::Reference.read(path, mode: :full, lazy: false)
85
+ end
86
+
87
+ def instance_coords(face)
88
+ fvar = face["fvar"] or return []
89
+ tags = fvar["axes"].map { |a| a["axis_tag"] }
90
+ fvar["instances"].map do |inst|
91
+ tags.zip(inst["coordinates_raw"]).to_h { |tag, raw| [tag, raw.to_f / Fontisan::Reference::FIXED_ONE] }
92
+ end
93
+ end
94
+
95
+ # => { "format:ttf" => {op: :format, to: "ttf"}, ... } in a fixed order
96
+ def cases_for(path, format)
97
+ faces = read_faces(path)
98
+ cases = {}
99
+ if format == "ttc" || faces.size > 1 || collection?(path)
100
+ COLLECTION_TARGETS.each { |to| cases["format:#{to}"] = { op: :format, to: to } }
101
+ faces.each_index { |i| cases["extract:#{i}"] = { op: :extract, index: i } }
102
+ return cases
103
+ end
104
+ SINGLE_TARGETS.each { |to| cases["format:#{to}"] = { op: :format, to: to } unless to == format }
105
+ instance_coords(faces.first).each_with_index do |coords, i|
106
+ cases["instance:#{i}"] = { op: :instance, coords: coords }
107
+ end
108
+ cases["subset:text-latin"] = { op: :subset, text: SUBSET_TEXT }
109
+ cases["subset:unicodes-sample"] = { op: :subset, sample: true }
110
+ cases
111
+ end
112
+
113
+ def collection?(path)
114
+ File.binread(path, 4) == "ttcf" || (File.binread(path, 4) == "wOF2" && woff2_flavor(path) == "ttcf")
115
+ end
116
+
117
+ def woff2_flavor(path)
118
+ File.binread(path, 8).byteslice(4, 4)
119
+ end
120
+
121
+ def sample_codepoints(path)
122
+ cps = cmap_codepoints(path)
123
+ return cps if cps.size <= SUBSET_SAMPLE
124
+
125
+ step = (cps.size - 1).fdiv(SUBSET_SAMPLE - 1)
126
+ Array.new(SUBSET_SAMPLE) { |i| cps[(i * step).round] }.uniq
127
+ end
128
+
129
+ # Codepoints of a face's cmap. A WOFF2 input on a platform without the `brotli`
130
+ # gem (the java gem on JRuby) is decoded by the pinned woff2_decompress first,
131
+ # so the sample does not depend on the tier under test.
132
+ def cmap_codepoints(path)
133
+ return load_codepoints(path) unless File.binread(path, 4) == "wOF2" && !Fontisan::Utilities::BrotliWrapper.available?
134
+
135
+ Dir.mktmpdir("sample-cps") do |tmp|
136
+ input = File.join(tmp, "in.woff2")
137
+ FileUtils.cp(path, input)
138
+ _out, err, status = Open3.capture3(woff2_decompress, input)
139
+ decoded = File.join(tmp, "in.ttf")
140
+ raise "woff2_decompress failed: #{err.strip}" unless status.success? && File.exist?(decoded)
141
+
142
+ load_codepoints(decoded)
143
+ end
144
+ end
145
+
146
+ def load_codepoints(path)
147
+ Fontisan::FontLoader.load(path, mode: :full, lazy: false).table("cmap").unicode_mappings.keys.sort
148
+ end
149
+
150
+ # --- tools ----------------------------------------------------------------
151
+
152
+ def ots_command
153
+ @ots_command ||= (ENV["OTS_PYTHON"] || "python3").then { |py| [py, "-m", "ots"] }
154
+ end
155
+
156
+ def woff2_decompress
157
+ @woff2_decompress ||= ENV["WOFF2_DECOMPRESS"] ||
158
+ Open3.capture2(File.join(ROOT, "scripts", "build-woff2.sh"), err: File::NULL).first.lines.last.to_s.strip
159
+ end
160
+
161
+ def check_tools!
162
+ out, status = Open3.capture2e(*ots_command, "--version")
163
+ ok = status.success? || out.include?("Usage") || out.include?("Unrecognized")
164
+ raise ToolMissing, "OTS not runnable via `#{ots_command.join(' ')}` (set OTS_PYTHON): #{out.strip}" unless ok
165
+ raise ToolMissing, "woff2_decompress not available" unless File.executable?(woff2_decompress.to_s)
166
+ end
167
+
168
+ # --- decoding -------------------------------------------------------------
169
+
170
+ def table_digests_of_sfnt(bytes)
171
+ if bytes.byteslice(0, 4) == "ttcf"
172
+ CorpusSfnt.parse_ttc(bytes).map { |_v, tables| digest_tables(tables.to_h) }
173
+ else
174
+ [digest_tables(CorpusSfnt.parse(bytes).last.to_h)]
175
+ end
176
+ end
177
+
178
+ def digest_tables(tables)
179
+ tables.sort.to_h { |tag, data| [tag, Digest::SHA256.hexdigest(data)] }
180
+ end
181
+
182
+ def decode_woff(bytes)
183
+ num = bytes.byteslice(12, 2).unpack1("n")
184
+ tables = {}
185
+ num.times do |i|
186
+ tag, offset, comp, orig = bytes.byteslice(44 + (i * 20), 20).unpack("a4NNN")
187
+ data = bytes.byteslice(offset, comp)
188
+ tables[tag] = comp < orig ? Zlib::Inflate.inflate(data) : data
189
+ end
190
+ [digest_tables(tables)]
191
+ end
192
+
193
+ def decode_woff2(bytes, tmp)
194
+ input = File.join(tmp, "decode.woff2")
195
+ File.binwrite(input, bytes)
196
+ _out, err, status = Open3.capture3(woff2_decompress, input)
197
+ out = File.join(tmp, "decode.ttf")
198
+ raise "woff2_decompress failed: #{err.strip}" unless status.success? && File.exist?(out)
199
+
200
+ decoded = File.binread(out)
201
+ FileUtils.rm_f([input, out])
202
+ table_digests_of_sfnt(decoded)
203
+ end
204
+
205
+ def decoded_digests(format, bytes, tmp)
206
+ case format
207
+ when "woff" then decode_woff(bytes)
208
+ when "woff2" then decode_woff2(bytes, tmp)
209
+ end
210
+ end
211
+
212
+ # --- OTS ------------------------------------------------------------------
213
+
214
+ def ots_run(path, index = nil)
215
+ dest = File.join(File.dirname(path), "ots-dest.bin")
216
+ args = [*ots_command, path]
217
+ args.push(dest, index.to_s) if index
218
+ out, status = Open3.capture2e(*args)
219
+ FileUtils.rm_f(dest)
220
+ status.success? ? nil : out.lines.grep(/ERROR|Failed/).first(2).map(&:strip).join(" | ")
221
+ end
222
+
223
+ # Collections are sanitised member by member; WOFF2 collections are first
224
+ # decoded by the pinned woff2_decompress.
225
+ def ots_verdict(path, format, tmp)
226
+ target = path
227
+ if format == "woff2" && woff2_flavor(path) == "ttcf"
228
+ target = File.join(tmp, "ots-decoded.ttf")
229
+ FileUtils.cp(path, File.join(tmp, "ots-decoded.woff2"))
230
+ _o, _e, st = Open3.capture3(woff2_decompress, File.join(tmp, "ots-decoded.woff2"))
231
+ return { "verdict" => "fail", "detail" => "woff2_decompress failed" } unless st.success?
232
+ end
233
+ failures = member_count(target).times.filter_map do |i|
234
+ msg = ots_run(target, member_count(target) > 1 ? i : nil)
235
+ "member #{i}: #{msg}" if msg
236
+ end
237
+ { "verdict" => failures.empty? ? "pass" : "fail" }.tap { |v| v["detail"] = failures.join(" ; ") unless failures.empty? }
238
+ end
239
+
240
+ # Index rule: a golden whose output fails OTS is a known_reference_bug; the
241
+ # tag is the first OTS error with numbers masked.
242
+ def ots_bug_tag(detail)
243
+ first = detail.to_s[/ERROR: ([^|;]+)/, 1] || detail.to_s
244
+ first.strip.gsub(/\b\d+\b/, "N")
245
+ end
246
+
247
+ def member_count(path)
248
+ return 1 unless File.binread(path, 4) == "ttcf"
249
+
250
+ File.binread(path, 12).unpack1("@8N")
251
+ end
252
+
253
+ # --- running a case -------------------------------------------------------
254
+
255
+ def mask(message, tmp)
256
+ message.to_s.gsub(tmp, "<tmp>").gsub(ROOT, "<root>").gsub(/0x\h+/, "0x?")
257
+ .gsub(%r{(?:/[\w.\-\[\],]+)+/}, "<dir>/").gsub(/\b\d+\b/, "N").lines.first.to_s.strip
258
+ end
259
+
260
+ def run_case(path, format, spec, tmp)
261
+ result = { "params" => params_of(spec) }
262
+ result["class"] = spec[:op] == :format && %w[woff woff2].include?(spec[:to]) ? "decoded-exact" : "exact"
263
+ out_path, out_format = produce(path, spec, tmp)
264
+ bytes = File.binread(out_path)
265
+ result["outcome"] = "ok"
266
+ result["output"] = { "format" => out_format, "sha256" => Digest::SHA256.hexdigest(bytes), "size" => bytes.bytesize }
267
+ result["output"]["basename"] = File.basename(out_path) if spec[:op] == :extract
268
+ decoded = decoded_digests(out_format, bytes, tmp)
269
+ result["decoded_tables"] = decoded if decoded
270
+ result["ots"] = ots_verdict(out_path, out_format, tmp)
271
+ result["known_reference_bug"] = ots_bug_tag(result["ots"]["detail"]) if result["ots"]["verdict"] == "fail"
272
+ result
273
+ rescue ToolMissing
274
+ raise
275
+ rescue StandardError => e
276
+ result.merge("outcome" => "error", "error" => { "class" => e.class.name, "message" => mask(e.message, tmp) })
277
+ ensure
278
+ FileUtils.rm_rf(Dir.glob(File.join(tmp, "*")))
279
+ end
280
+
281
+ def params_of(spec)
282
+ params = spec.except(:op, :coords).transform_keys(&:to_s).merge("op" => spec[:op].to_s)
283
+ params["coords_raw"] = spec[:coords].transform_values { |v| (v * Fontisan::Reference::FIXED_ONE).round } if spec[:coords]
284
+ params.sort.to_h
285
+ end
286
+
287
+ def produce(path, spec, tmp)
288
+ case spec[:op]
289
+ when :format
290
+ out = File.join(tmp, "out.#{OUTPUT_EXT.fetch(spec[:to])}")
291
+ Fontisan::Reference.convert(path, to: spec[:to], output: out, timestamp: TIMESTAMP)
292
+ [out, sniff(out) || "unknown"]
293
+ when :extract
294
+ out = Fontisan::Reference.extract(path, index: spec[:index], output_dir: tmp)
295
+ [out, sniff(out) || "unknown"]
296
+ when :instance
297
+ write_bytes(tmp, Fontisan::Reference.instance(path, coords: spec[:coords], timestamp: TIMESTAMP))
298
+ when :subset
299
+ write_bytes(tmp, Fontisan::Reference.subset(path, **subset_args(path, spec), profile: "web", timestamp: TIMESTAMP))
300
+ end
301
+ end
302
+
303
+ def write_bytes(tmp, bytes)
304
+ out = File.join(tmp, "out.bin")
305
+ File.binwrite(out, bytes)
306
+ [out, sniff(out) || "unknown"]
307
+ end
308
+
309
+ def subset_args(path, spec)
310
+ spec[:text] ? { text: spec[:text] } : { unicodes: sample_codepoints(path) }
311
+ end
312
+
313
+ # --- golden assembly ------------------------------------------------------
314
+
315
+ def golden_for(entry, path, format)
316
+ specs = cases_for(path, format)
317
+ results = {}
318
+ Dir.mktmpdir("convert-golden") do |tmp|
319
+ specs.each do |key, spec|
320
+ results[key] = run_case(path, format, spec, tmp)
321
+ results[key]["params"]["unicodes"] = sample_codepoints(path) if spec[:sample]
322
+ results[key]["params"].delete("sample")
323
+ end
324
+ end
325
+ { "font" => entry["id"], "source_sha256" => Digest::SHA256.file(path).hexdigest,
326
+ "source_format" => format, "timestamp" => TIMESTAMP, "cases" => results }
327
+ end
328
+
329
+ # Returns { "<font-id>.json" => canonical json text }.
330
+ def generate(tiers, only: nil)
331
+ check_tools!
332
+ subjects(tiers).each_with_object({}) do |(entry, path, format), files|
333
+ next if only && !Array(only).include?(entry["id"])
334
+
335
+ files["#{entry['id']}.json"] = Fontisan::Reference.canonical_json(golden_for(entry, path, format))
336
+ end
337
+ end
338
+
339
+ def expected_keys(tiers)
340
+ subjects(tiers).to_h { |entry, path, format| [entry["id"], cases_for(path, format).keys] }
341
+ end
342
+
343
+ REASONS = {
344
+ /Variations: Required fvar/ => "static output drops fvar/gvar but GDEF/GPOS keep ItemVariationStore references (measured: instance and VF->static convert outputs)",
345
+ /post: Bad number of glyphs/ => "subset leaves the post table at the source glyph count (not subsetted)",
346
+ /CFF : Failed to parse Name INDEX/ => "TTF->OTF conversion writes a CFF table with an invalid Name INDEX",
347
+ /Layout: bad glyph/ => "subset leaves GSUB/GPOS referencing glyph ids beyond the subset glyph count",
348
+ /overlapping tables/ => "TTC writer emits overlapping table records for shared tables",
349
+ /zero-length table|missing required table|invalid table offset|Unsupported majorVersion/ =>
350
+ "input is a deliberate quirk font (corpus/derive/quirks.rb); Ruby passes the quirk through and OTS rejects it",
351
+ /cmap: bad glyph id offset/ => "extracted member keeps a cmap invalid for OTS (TestTTCv2)",
352
+ /glyf: Count too high/ => "WOFF encode of a WOFF2-decoded TTF writes a glyf table OTS rejects",
353
+ }.freeze
354
+
355
+ def reason_for(tag)
356
+ REASONS.each { |re, why| return why if tag.match?(re) }
357
+ "unclassified"
358
+ end
359
+
360
+ # corpus/TRIAGE_CONVERT.md: every OTS exception, grouped by failure tag.
361
+ def triage_text(dir = GOLDEN_DIR)
362
+ groups = Hash.new { |h, k| h[k] = [] }
363
+ Dir.glob(File.join(dir, "*.json")).each do |file|
364
+ g = JSON.parse(File.read(file))
365
+ g["cases"].each { |k, v| groups[v["known_reference_bug"]] << "#{g['font']}/#{k}" if v.dig("ots", "verdict") == "fail" }
366
+ end
367
+ lines = ["# Convert goldens: OTS exceptions (card 0c)", "",
368
+ "Generated by `rake corpus:convert:regenerate`; do not edit by hand. Each entry is a",
369
+ "`known_reference_bug`: the golden keeps Ruby's output, Rust reproduces it, and the output",
370
+ "fails OTS (`python -m ots`). Fixing the Ruby behaviour regenerates the golden and removes the entry.", ""]
371
+ groups.sort_by { |tag, _| tag }.each do |tag, ids|
372
+ lines << "## #{tag} (#{ids.size})" << "" << "Reason: #{reason_for(tag)}." << ""
373
+ ids.sort.each { |id| lines << "- OTS exception: `#{id}`" }
374
+ lines << ""
375
+ end
376
+ lines.concat(known_notes)
377
+ lines.concat(error_section(dir))
378
+ "#{lines.join("\n")}\n"
379
+ end
380
+
381
+ def known_notes
382
+ ["# Known reference bugs outside OTS", "",
383
+ "- `Tables::Cff::CharString` hintmask/cntrmask: `@io&.read` is nil for the top-level mask bytes, so they are",
384
+ " not skipped and CID-keyed CFF glyphs become empty (visible in noto-sans-jp-subset-regular-otf otf->ttf",
385
+ " and its subsets). known_reference_bug: goldens keep Ruby's output; Rust reproduces it.", ""]
386
+ end
387
+
388
+ # Cases where Ruby raises: recorded as error goldens (Rust must raise the
389
+ # same class and message). Listed so a wrong-looking error is not mistaken
390
+ # for a harness fault.
391
+ def error_section(dir)
392
+ errors = Hash.new { |h, k| h[k] = [] }
393
+ Dir.glob(File.join(dir, "*.json")).each do |file|
394
+ g = JSON.parse(File.read(file))
395
+ g["cases"].each do |k, v|
396
+ errors["#{v['error']['class']}: #{v['error']['message']}"] << "#{g['font']}/#{k}" if v["outcome"] == "error"
397
+ end
398
+ end
399
+ out = ["# Reference errors (error goldens)", "",
400
+ "Ruby raises on these inputs today; the golden keeps class and masked message.", ""]
401
+ errors.sort.each do |msg, ids|
402
+ out << "## #{msg} (#{ids.size})" << ""
403
+ ids.sort.each { |id| out << "- Reference error: `#{id}`" }
404
+ out << ""
405
+ end
406
+ out
407
+ end
408
+
409
+ def write(files, dir = GOLDEN_DIR)
410
+ FileUtils.mkdir_p(dir)
411
+ files.each { |name, text| File.write(File.join(dir, name), text) }
412
+ File.write(TRIAGE, triage_text(dir)) if dir == GOLDEN_DIR
413
+ end
414
+
415
+ # => array of human-readable problems (empty = golden matches)
416
+ def verify(tiers, only: nil, dir: GOLDEN_DIR)
417
+ generated = generate(tiers, only: only)
418
+ problems = []
419
+ generated.each do |name, text|
420
+ file = File.join(dir, name)
421
+ if !File.exist?(file) then problems << "#{name}: golden missing"
422
+ elsif !same_golden?(File.read(file), text) then problems << "#{name}: #{diff_cases(File.read(file), text)}"
423
+ end
424
+ end
425
+ unless only
426
+ stale = Dir.children(dir).grep(/\.json\z/) - generated.keys
427
+ problems.concat(stale.map { |n| "#{n}: golden has no corpus font" })
428
+ end
429
+ problems
430
+ end
431
+
432
+ # Goldens are Ruby's output. A non-Ruby tier (FONTISAN_ENGINE=native|ffi|auto)
433
+ # compresses with its own zlib/brotli, so for the "decoded-exact" class (woff,
434
+ # woff2) its compressed size and sha256 may differ; the decoded tables must
435
+ # not. Every other case is compared exactly, on every tier.
436
+ def same_golden?(golden_text, new_text)
437
+ return golden_text == new_text unless compressed_bytes_may_differ?
438
+
439
+ relaxed(JSON.parse(golden_text)) == relaxed(JSON.parse(new_text))
440
+ end
441
+
442
+ def compressed_bytes_may_differ?
443
+ !%w[ruby].include?(ENV.fetch("FONTISAN_ENGINE", "auto").strip.downcase)
444
+ end
445
+
446
+ def relaxed(golden)
447
+ golden["cases"].each_value do |c|
448
+ c["output"]&.delete_if { |k, _| %w[sha256 size].include?(k) } if c["class"] == "decoded-exact" && c["outcome"] == "ok"
449
+ end
450
+ golden
451
+ end
452
+
453
+ def diff_cases(old_text, new_text)
454
+ old = JSON.parse(old_text)["cases"]
455
+ new = JSON.parse(new_text)["cases"]
456
+ keys = (old.keys | new.keys).reject { |k| old[k] == new[k] }
457
+ keys.empty? ? "header differs" : "differs in #{keys.join(', ')}"
458
+ end
459
+
460
+ # OTS failures that the golden records, as "<font-id>/<case-key>".
461
+ def ots_failures(dir = GOLDEN_DIR)
462
+ Dir.glob(File.join(dir, "*.json")).flat_map do |file|
463
+ g = JSON.parse(File.read(file))
464
+ g["cases"].select { |_k, v| v.dig("ots", "verdict") == "fail" }.keys.map { |k| "#{g['font']}/#{k}" }
465
+ end.sort
466
+ end
467
+
468
+ def listed_exceptions
469
+ return [] unless File.exist?(TRIAGE)
470
+
471
+ File.read(TRIAGE).scan(%r{^- OTS exception: `([^`]+)`}).flatten.sort
472
+ end
473
+ end
474
+
475
+ if $PROGRAM_NAME == __FILE__
476
+ tiers = ENV.fetch("TIERS", "ci").split(",")
477
+ ConvertGoldens.write(ConvertGoldens.generate(tiers))
478
+ end