fontisan 0.4.49-aarch64-linux

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (792) hide show
  1. checksums.yaml +7 -0
  2. data/.rspec +3 -0
  3. data/.rubocop.yml +141 -0
  4. data/.rubocop_todo.yml +433 -0
  5. data/BENCHMARKS.md +56 -0
  6. data/BUG-stitcher-drops-isolated-cps.md +58 -0
  7. data/BUG-stitcher-drops-plane1-codepoints.md +310 -0
  8. data/BUG-stitcher-gid-cap-65535.md +110 -0
  9. data/CHANGELOG.md +293 -0
  10. data/Gemfile +40 -0
  11. data/LICENSE +28 -0
  12. data/README.adoc +2811 -0
  13. data/Rakefile +156 -0
  14. data/TODO.bug-fixes/01-cff-expert-charsets.md +27 -0
  15. data/TODO.bug-fixes/02-cff2-subroutine-stubs.md +32 -0
  16. data/TODO.bug-fixes/03-variation-subsetter-placeholders.md +42 -0
  17. data/TODO.bug-fixes/04-ufo-image-compile-roundtrip.md +28 -0
  18. data/TODO.bug-fixes/05-stale-cff-comment.md +18 -0
  19. data/TODO.bug-fixes/06-instance-woff2-output.md +24 -0
  20. data/TODO.bug-fixes/07-encapsulation-violations.md +38 -0
  21. data/TODO.bug-fixes/08-respond-to-violations.md +25 -0
  22. data/TODO.bug-fixes/09-type1-cff-seac-expansion.md +22 -0
  23. data/TODO.bug-fixes/10-ttf-type1-composite-glyphs.md +23 -0
  24. data/TODO.bug-fixes/11-remaining-respond-to.md +25 -0
  25. data/TODO.bug-fixes/12-type1-generators-duck-typing.md +80 -0
  26. data/TODO.bug-fixes/13-hint-extractor-duck-typing.md +30 -0
  27. data/TODO.bug-fixes/14-font-interface-type-checks.md +82 -0
  28. data/TODO.bug-fixes/15-glyph-type-checks-and-simple-glyph-points-bug.md +49 -0
  29. data/TODO.bug-fixes/16-variation-table-checks.md +31 -0
  30. data/TODO.bug-fixes/17-ufo-and-stitcher-cleanup.md +32 -0
  31. data/TODO.bug-fixes/18-generic-value-and-io-checks.md +56 -0
  32. data/TODO.bug-fixes/19-serialization-migration.md +52 -0
  33. data/TODO.bug-fixes/20-variation-validator-type-checks.md +29 -0
  34. data/TODO.bug-fixes/21-xml-builder-send.md +24 -0
  35. data/TODO.bug-fixes/22-type1-converter-font-info.md +25 -0
  36. data/TODO.bug-fixes/23-boundary-type-checks.md +31 -0
  37. data/TODO.bug-fixes/24-validator-dynamic-field-key.md +25 -0
  38. data/TODO.bug-fixes/25-serialization-migration.md +49 -0
  39. data/TODO.bug-fixes/26-variation-preserver-spec-migration.md +25 -0
  40. data/TODO.bug-fixes/27-table-class-registry.md +50 -0
  41. data/TODO.bug-fixes/28-spec-doubles-cleanup.md +40 -0
  42. data/TODO.bug-fixes/29-strategy-registries.md +30 -0
  43. data/TODO.bug-fixes/30-eliminate-send-in-specs.md +36 -0
  44. data/TODO.bug-fixes/README.md +52 -0
  45. data/TODO.improvements/01-cbdt-cblc-gid-stable-propagation.md +73 -0
  46. data/TODO.improvements/02-collection-outline-priority.md +48 -0
  47. data/TODO.improvements/03-fontisan-audit-command.md +219 -0
  48. data/TODO.improvements/04-ufo-composite-glyph-encoding.md +46 -0
  49. data/TODO.improvements/05-otf-compiler-real-cff.md +63 -0
  50. data/TODO.improvements/06-cff2-blend-vsindex-operators.md +51 -0
  51. data/TODO.improvements/07-cpal-v1-header-fields.md +71 -0
  52. data/TODO.improvements/08-cff-standard-string-table.md +52 -0
  53. data/TODO.improvements/09-type1-seac-expansion.md +57 -0
  54. data/TODO.improvements/10-ufo-image-set-feature-writers.md +71 -0
  55. data/TODO.improvements/11-kern-groups-plist.md +49 -0
  56. data/TODO.improvements/12-cbdt-fixture-bindata-conversion.md +68 -0
  57. data/TODO.improvements/13-split-octokit-fetcher.md +45 -0
  58. data/TODO.improvements/14-rubocop-baseline-chip.md +62 -0
  59. data/TODO.improvements/15-cff-cff2-subsetter-strategy.md +78 -0
  60. data/TODO.improvements/README.md +58 -0
  61. data/benchmark/baseline.json +5 -0
  62. data/benchmark/ci_gate.rb +217 -0
  63. data/benchmark/compile_benchmark.rb +78 -0
  64. data/benchmark/corpus/harness.rb +175 -0
  65. data/benchmark/corpus/ops.rb +150 -0
  66. data/benchmark/corpus/run.rb +182 -0
  67. data/benchmark/corpus/scan_child.rb +8 -0
  68. data/benchmark/corpus/tiers.rb +176 -0
  69. data/benchmark/tier_baseline.json +12 -0
  70. data/benchmark/variation_quick_bench.rb +47 -0
  71. data/build_mingw32_stub.rb +15 -0
  72. data/docs/.gitignore +17 -0
  73. data/docs/.vitepress/config.ts +373 -0
  74. data/docs/.vitepress/theme/components/ApiMethod.vue +127 -0
  75. data/docs/.vitepress/theme/components/Badge.vue +51 -0
  76. data/docs/.vitepress/theme/components/FeatureComparison.vue +87 -0
  77. data/docs/.vitepress/theme/components/HeroCodeBlock.vue +98 -0
  78. data/docs/.vitepress/theme/components/WithinHero.vue +30 -0
  79. data/docs/.vitepress/theme/index.ts +22 -0
  80. data/docs/.vitepress/theme/style.css +628 -0
  81. data/docs/AFDKO_MIGRATION.adoc +175 -0
  82. data/docs/APPLE_LEGACY_FONTS.adoc +173 -0
  83. data/docs/CFF2_SUPPORT.adoc +184 -0
  84. data/docs/COLLECTION_VALIDATION.adoc +204 -0
  85. data/docs/COLOR_FONTS.adoc +127 -0
  86. data/docs/CONVERSION_GUIDE.adoc +656 -0
  87. data/docs/EXTRACT_TTC_MIGRATION.md +549 -0
  88. data/docs/FEATURE_PARITY.adoc +263 -0
  89. data/docs/FONT_HINTING.adoc +570 -0
  90. data/docs/STITCHER_GUIDE.adoc +436 -0
  91. data/docs/SVG_TO_GLYF.adoc +118 -0
  92. data/docs/TTX.adoc +176 -0
  93. data/docs/TYPE1_FONTS.adoc +445 -0
  94. data/docs/UFO_COMPILATION.adoc +397 -0
  95. data/docs/VALIDATION.adoc +254 -0
  96. data/docs/VARIABLE_FONT_OPERATIONS.adoc +599 -0
  97. data/docs/WOFF_WOFF2_FORMATS.adoc +220 -0
  98. data/docs/api/conversion-options.md +164 -0
  99. data/docs/api/converters/curve-converter.md +34 -0
  100. data/docs/api/converters/hint-converter.md +34 -0
  101. data/docs/api/converters/outline-converter.md +27 -0
  102. data/docs/api/font-loader.md +117 -0
  103. data/docs/api/font-writer.md +103 -0
  104. data/docs/api/index.md +79 -0
  105. data/docs/api/layer.md +89 -0
  106. data/docs/api/models/glyph-accessor.md +43 -0
  107. data/docs/api/models/glyph.md +40 -0
  108. data/docs/api/models/table-analyzer.md +35 -0
  109. data/docs/api/sfnt-font.md +53 -0
  110. data/docs/api/type1-font.md +43 -0
  111. data/docs/api/validators/font-validator.md +31 -0
  112. data/docs/api/validators/helper.md +36 -0
  113. data/docs/api/validators/profile.md +39 -0
  114. data/docs/cli/convert.md +148 -0
  115. data/docs/cli/dump-table.md +110 -0
  116. data/docs/cli/export.md +176 -0
  117. data/docs/cli/features.md +124 -0
  118. data/docs/cli/glyphs.md +90 -0
  119. data/docs/cli/index.md +232 -0
  120. data/docs/cli/info.md +254 -0
  121. data/docs/cli/instance.md +122 -0
  122. data/docs/cli/ls.md +95 -0
  123. data/docs/cli/optical-size.md +94 -0
  124. data/docs/cli/pack.md +125 -0
  125. data/docs/cli/scripts.md +105 -0
  126. data/docs/cli/subset.md +58 -0
  127. data/docs/cli/tables.md +84 -0
  128. data/docs/cli/unicode.md +101 -0
  129. data/docs/cli/validate-collection.md +95 -0
  130. data/docs/cli/validate.md +56 -0
  131. data/docs/cli/variable.md +126 -0
  132. data/docs/cli/version.md +46 -0
  133. data/docs/guide/cli/convert.md +108 -0
  134. data/docs/guide/cli/export.md +138 -0
  135. data/docs/guide/cli/index.md +99 -0
  136. data/docs/guide/cli/info.md +144 -0
  137. data/docs/guide/cli/pack.md +155 -0
  138. data/docs/guide/cli/subset.md +149 -0
  139. data/docs/guide/cli/validate.md +139 -0
  140. data/docs/guide/color-fonts/bitmaps.md +194 -0
  141. data/docs/guide/color-fonts/colr-cpal.md +175 -0
  142. data/docs/guide/color-fonts/index.md +140 -0
  143. data/docs/guide/color-fonts/svg.md +154 -0
  144. data/docs/guide/color.md +51 -0
  145. data/docs/guide/comparisons/font-validator.md +222 -0
  146. data/docs/guide/comparisons/fonttools.md +200 -0
  147. data/docs/guide/comparisons/index.md +83 -0
  148. data/docs/guide/comparisons/lcdf-typetools.md +205 -0
  149. data/docs/guide/contributing.md +279 -0
  150. data/docs/guide/conversion/collections.md +251 -0
  151. data/docs/guide/conversion/curves.md +246 -0
  152. data/docs/guide/conversion/index.md +157 -0
  153. data/docs/guide/conversion/options.md +280 -0
  154. data/docs/guide/conversion/ttf-otf.md +184 -0
  155. data/docs/guide/conversion/type1.md +208 -0
  156. data/docs/guide/conversion/web.md +299 -0
  157. data/docs/guide/conversion.md +40 -0
  158. data/docs/guide/engines.md +117 -0
  159. data/docs/guide/formats/collections.md +147 -0
  160. data/docs/guide/formats/dfont.md +99 -0
  161. data/docs/guide/formats/index.md +65 -0
  162. data/docs/guide/formats/otf.md +103 -0
  163. data/docs/guide/formats/svg.md +97 -0
  164. data/docs/guide/formats/ttf.md +105 -0
  165. data/docs/guide/formats/type1.md +118 -0
  166. data/docs/guide/formats/woff.md +139 -0
  167. data/docs/guide/hinting/autohint.md +141 -0
  168. data/docs/guide/hinting/conversion.md +161 -0
  169. data/docs/guide/hinting/index.md +86 -0
  170. data/docs/guide/hinting/postscript.md +149 -0
  171. data/docs/guide/hinting/truetype.md +135 -0
  172. data/docs/guide/hinting.md +44 -0
  173. data/docs/guide/index.md +152 -0
  174. data/docs/guide/installation.md +116 -0
  175. data/docs/guide/migrations/extract-ttc.md +549 -0
  176. data/docs/guide/migrations/font-validator.md +260 -0
  177. data/docs/guide/migrations/fonttools.md +208 -0
  178. data/docs/guide/migrations/index.md +64 -0
  179. data/docs/guide/migrations/otfinfo.md +197 -0
  180. data/docs/guide/quick-start.md +204 -0
  181. data/docs/guide/type1.md +58 -0
  182. data/docs/guide/universal-outline.md +151 -0
  183. data/docs/guide/validation/custom.md +195 -0
  184. data/docs/guide/validation/helpers.md +188 -0
  185. data/docs/guide/validation/index.md +132 -0
  186. data/docs/guide/validation/profiles.md +156 -0
  187. data/docs/guide/validation.md +47 -0
  188. data/docs/guide/variable-fonts/advanced.md +231 -0
  189. data/docs/guide/variable-fonts/axes.md +209 -0
  190. data/docs/guide/variable-fonts/conversion.md +197 -0
  191. data/docs/guide/variable-fonts/index.md +84 -0
  192. data/docs/guide/variable-fonts/instances.md +187 -0
  193. data/docs/guide/variable-fonts/named-instances.md +194 -0
  194. data/docs/guide/variable-fonts/static.md +168 -0
  195. data/docs/guide/variable.md +58 -0
  196. data/docs/guide/woff.md +61 -0
  197. data/docs/index.md +136 -0
  198. data/docs/lychee.toml +41 -0
  199. data/docs/package-lock.json +2560 -0
  200. data/docs/package.json +15 -0
  201. data/docs/public/apple-touch-icon.png +0 -0
  202. data/docs/public/favicon-96x96.png +0 -0
  203. data/docs/public/favicon.ico +0 -0
  204. data/docs/public/favicon.svg +1 -0
  205. data/docs/public/logo-full.svg +1 -0
  206. data/docs/public/logo.svg +1 -0
  207. data/docs/public/robots.txt +4 -0
  208. data/docs/public/site.webmanifest +21 -0
  209. data/docs/public/web-app-manifest-192x192.png +0 -0
  210. data/docs/public/web-app-manifest-512x512.png +0 -0
  211. data/docs/reference-facade.md +130 -0
  212. data/docs/scripts/post-build.mjs +81 -0
  213. data/exe/fontisan +7 -0
  214. data/lib/fontisan/audit/check.rb +47 -0
  215. data/lib/fontisan/audit/check_registry.rb +77 -0
  216. data/lib/fontisan/audit/checks/cff_table_check.rb +87 -0
  217. data/lib/fontisan/audit/checks/cmap_check.rb +256 -0
  218. data/lib/fontisan/audit/checks/collection_integrity_check.rb +102 -0
  219. data/lib/fontisan/audit/checks/format_round_trip_check.rb +150 -0
  220. data/lib/fontisan/audit/checks/glyf_table_check.rb +115 -0
  221. data/lib/fontisan/audit/checks/glyph_name_check.rb +107 -0
  222. data/lib/fontisan/audit/checks/head_check.rb +96 -0
  223. data/lib/fontisan/audit/checks/hhea_check.rb +68 -0
  224. data/lib/fontisan/audit/checks/hinting_check.rb +163 -0
  225. data/lib/fontisan/audit/checks/kern_check.rb +47 -0
  226. data/lib/fontisan/audit/checks/layout_table_check.rb +70 -0
  227. data/lib/fontisan/audit/checks/maxp_check.rb +85 -0
  228. data/lib/fontisan/audit/checks/name_table_check.rb +78 -0
  229. data/lib/fontisan/audit/checks/naming_consistency_check.rb +102 -0
  230. data/lib/fontisan/audit/checks/opentype_conformance_check.rb +108 -0
  231. data/lib/fontisan/audit/checks/os2_check.rb +117 -0
  232. data/lib/fontisan/audit/checks/ots_compatibility_check.rb +191 -0
  233. data/lib/fontisan/audit/checks/post_check.rb +75 -0
  234. data/lib/fontisan/audit/checks/table_directory_check.rb +157 -0
  235. data/lib/fontisan/audit/checks/variable_font_check.rb +151 -0
  236. data/lib/fontisan/audit/checks/woff2_validation_check.rb +140 -0
  237. data/lib/fontisan/audit/checks.rb +42 -0
  238. data/lib/fontisan/audit.rb +20 -0
  239. data/lib/fontisan/base_collection.rb +312 -0
  240. data/lib/fontisan/binary/base_record.rb +82 -0
  241. data/lib/fontisan/binary/structures.rb +82 -0
  242. data/lib/fontisan/binary.rb +11 -0
  243. data/lib/fontisan/byte_ops.rb +314 -0
  244. data/lib/fontisan/cli.rb +1111 -0
  245. data/lib/fontisan/collection/builder.rb +336 -0
  246. data/lib/fontisan/collection/dfont_builder.rb +305 -0
  247. data/lib/fontisan/collection/offset_calculator.rb +229 -0
  248. data/lib/fontisan/collection/reader/stats.rb +23 -0
  249. data/lib/fontisan/collection/reader.rb +90 -0
  250. data/lib/fontisan/collection/shared_logic.rb +52 -0
  251. data/lib/fontisan/collection/table_analyzer.rb +289 -0
  252. data/lib/fontisan/collection/table_deduplicator.rb +317 -0
  253. data/lib/fontisan/collection/writer.rb +289 -0
  254. data/lib/fontisan/collection.rb +16 -0
  255. data/lib/fontisan/commands/audit_command.rb +288 -0
  256. data/lib/fontisan/commands/base_command.rb +88 -0
  257. data/lib/fontisan/commands/convert_command.rb +506 -0
  258. data/lib/fontisan/commands/dump_table_command.rb +68 -0
  259. data/lib/fontisan/commands/export_command.rb +157 -0
  260. data/lib/fontisan/commands/features_command.rb +90 -0
  261. data/lib/fontisan/commands/glyphs_command.rb +50 -0
  262. data/lib/fontisan/commands/info_command.rb +447 -0
  263. data/lib/fontisan/commands/instance_command.rb +357 -0
  264. data/lib/fontisan/commands/ls_command.rb +107 -0
  265. data/lib/fontisan/commands/multi_format_output.rb +64 -0
  266. data/lib/fontisan/commands/optical_size_command.rb +38 -0
  267. data/lib/fontisan/commands/pack_command.rb +344 -0
  268. data/lib/fontisan/commands/scripts_command.rb +56 -0
  269. data/lib/fontisan/commands/subset_command.rb +285 -0
  270. data/lib/fontisan/commands/tables_command.rb +52 -0
  271. data/lib/fontisan/commands/unicode_command.rb +73 -0
  272. data/lib/fontisan/commands/unpack_command.rb +387 -0
  273. data/lib/fontisan/commands/validate_collection_command.rb +127 -0
  274. data/lib/fontisan/commands/validate_command.rb +305 -0
  275. data/lib/fontisan/commands/variable_command.rb +87 -0
  276. data/lib/fontisan/commands.rb +30 -0
  277. data/lib/fontisan/config/collection_settings.yml +56 -0
  278. data/lib/fontisan/config/conversion_matrix.yml +626 -0
  279. data/lib/fontisan/config/export_settings.yml +66 -0
  280. data/lib/fontisan/config/features.yml +143 -0
  281. data/lib/fontisan/config/scripts.yml +42 -0
  282. data/lib/fontisan/config/subset_profiles.yml +106 -0
  283. data/lib/fontisan/config/svg_settings.yml +60 -0
  284. data/lib/fontisan/config/variable_settings.yml +99 -0
  285. data/lib/fontisan/config/woff2_settings.yml +77 -0
  286. data/lib/fontisan/constants.rb +219 -0
  287. data/lib/fontisan/conversion_options.rb +389 -0
  288. data/lib/fontisan/converters/cff_table_builder.rb +195 -0
  289. data/lib/fontisan/converters/collection_converter.rb +520 -0
  290. data/lib/fontisan/converters/conversion_strategy.rb +211 -0
  291. data/lib/fontisan/converters/format_converter.rb +536 -0
  292. data/lib/fontisan/converters/glyf_table_builder.rb +61 -0
  293. data/lib/fontisan/converters/outline_converter.rb +720 -0
  294. data/lib/fontisan/converters/outline_extraction.rb +88 -0
  295. data/lib/fontisan/converters/outline_optimizer.rb +84 -0
  296. data/lib/fontisan/converters/svg_generator.rb +236 -0
  297. data/lib/fontisan/converters/table_copier.rb +107 -0
  298. data/lib/fontisan/converters/type1_converter.rb +1201 -0
  299. data/lib/fontisan/converters/woff2_encoder.rb +520 -0
  300. data/lib/fontisan/converters/woff_writer.rb +358 -0
  301. data/lib/fontisan/converters.rb +21 -0
  302. data/lib/fontisan/dfont_collection.rb +288 -0
  303. data/lib/fontisan/engine.rb +393 -0
  304. data/lib/fontisan/error.rb +281 -0
  305. data/lib/fontisan/export/exporter.rb +255 -0
  306. data/lib/fontisan/export/table_serializer.rb +140 -0
  307. data/lib/fontisan/export/transformers/font_to_ttx.rb +163 -0
  308. data/lib/fontisan/export/transformers/head_transformer.rb +94 -0
  309. data/lib/fontisan/export/transformers/hhea_transformer.rb +57 -0
  310. data/lib/fontisan/export/transformers/maxp_transformer.rb +61 -0
  311. data/lib/fontisan/export/transformers/name_transformer.rb +61 -0
  312. data/lib/fontisan/export/transformers/os2_transformer.rb +119 -0
  313. data/lib/fontisan/export/transformers/post_transformer.rb +49 -0
  314. data/lib/fontisan/export/transformers.rb +17 -0
  315. data/lib/fontisan/export/ttx_generator.rb +526 -0
  316. data/lib/fontisan/export/ttx_parser.rb +300 -0
  317. data/lib/fontisan/export.rb +13 -0
  318. data/lib/fontisan/ffi/client.rb +123 -0
  319. data/lib/fontisan/ffi/libfontisan_cdylib.so +0 -0
  320. data/lib/fontisan/ffi.rb +387 -0
  321. data/lib/fontisan/ffi_platform.rb +24 -0
  322. data/lib/fontisan/font_loader.rb +315 -0
  323. data/lib/fontisan/font_writer.rb +309 -0
  324. data/lib/fontisan/formatters/text_formatter.rb +517 -0
  325. data/lib/fontisan/formatters.rb +9 -0
  326. data/lib/fontisan/glyph_accessor.rb +525 -0
  327. data/lib/fontisan/hints/hint_converter.rb +309 -0
  328. data/lib/fontisan/hints/hint_validator.rb +287 -0
  329. data/lib/fontisan/hints/postscript_hint_applier.rb +255 -0
  330. data/lib/fontisan/hints/postscript_hint_extractor.rb +347 -0
  331. data/lib/fontisan/hints/truetype_hint_applier.rb +117 -0
  332. data/lib/fontisan/hints/truetype_hint_extractor.rb +283 -0
  333. data/lib/fontisan/hints/truetype_instruction_analyzer.rb +268 -0
  334. data/lib/fontisan/hints/truetype_instruction_generator.rb +266 -0
  335. data/lib/fontisan/hints.rb +19 -0
  336. data/lib/fontisan/loading_modes.rb +113 -0
  337. data/lib/fontisan/metrics_calculator.rb +275 -0
  338. data/lib/fontisan/models/all_scripts_features_info.rb +20 -0
  339. data/lib/fontisan/models/audit_report.rb +196 -0
  340. data/lib/fontisan/models/bitmap_glyph.rb +123 -0
  341. data/lib/fontisan/models/bitmap_strike.rb +94 -0
  342. data/lib/fontisan/models/collection_brief_info.rb +36 -0
  343. data/lib/fontisan/models/collection_font_summary.rb +52 -0
  344. data/lib/fontisan/models/collection_info.rb +79 -0
  345. data/lib/fontisan/models/collection_list_info.rb +36 -0
  346. data/lib/fontisan/models/collection_validation_report.rb +102 -0
  347. data/lib/fontisan/models/color_glyph.rb +56 -0
  348. data/lib/fontisan/models/color_layer.rb +53 -0
  349. data/lib/fontisan/models/color_palette.rb +60 -0
  350. data/lib/fontisan/models/features_info.rb +42 -0
  351. data/lib/fontisan/models/font_export.rb +158 -0
  352. data/lib/fontisan/models/font_info.rb +98 -0
  353. data/lib/fontisan/models/font_report.rb +23 -0
  354. data/lib/fontisan/models/font_summary.rb +48 -0
  355. data/lib/fontisan/models/glyph_info.rb +26 -0
  356. data/lib/fontisan/models/glyph_outline.rb +343 -0
  357. data/lib/fontisan/models/hint.rb +404 -0
  358. data/lib/fontisan/models/optical_size_info.rb +33 -0
  359. data/lib/fontisan/models/outline.rb +667 -0
  360. data/lib/fontisan/models/scripts_info.rb +39 -0
  361. data/lib/fontisan/models/svg_glyph.rb +89 -0
  362. data/lib/fontisan/models/table_info.rb +55 -0
  363. data/lib/fontisan/models/table_sharing_info.rb +40 -0
  364. data/lib/fontisan/models/ttx/glyph_order.rb +31 -0
  365. data/lib/fontisan/models/ttx/tables/binary_table.rb +67 -0
  366. data/lib/fontisan/models/ttx/tables/head_table.rb +74 -0
  367. data/lib/fontisan/models/ttx/tables/hhea_table.rb +74 -0
  368. data/lib/fontisan/models/ttx/tables/maxp_table.rb +55 -0
  369. data/lib/fontisan/models/ttx/tables/name_table.rb +45 -0
  370. data/lib/fontisan/models/ttx/tables/os2_table.rb +157 -0
  371. data/lib/fontisan/models/ttx/tables/post_table.rb +50 -0
  372. data/lib/fontisan/models/ttx/tables.rb +21 -0
  373. data/lib/fontisan/models/ttx/ttfont.rb +41 -0
  374. data/lib/fontisan/models/ttx.rb +14 -0
  375. data/lib/fontisan/models/unicode_mappings.rb +42 -0
  376. data/lib/fontisan/models/validation_report.rb +435 -0
  377. data/lib/fontisan/models/variable_font_info.rb +82 -0
  378. data/lib/fontisan/models.rb +49 -0
  379. data/lib/fontisan/native/3.2/fontisan_native.so +0 -0
  380. data/lib/fontisan/native/3.3/fontisan_native.so +0 -0
  381. data/lib/fontisan/native/3.4/fontisan_native.so +0 -0
  382. data/lib/fontisan/native/4.0/fontisan_native.so +0 -0
  383. data/lib/fontisan/native.rb +235 -0
  384. data/lib/fontisan/open_type_collection.rb +49 -0
  385. data/lib/fontisan/open_type_font.rb +161 -0
  386. data/lib/fontisan/open_type_font_extensions.rb +54 -0
  387. data/lib/fontisan/optimizers/charstring_rewriter.rb +172 -0
  388. data/lib/fontisan/optimizers/pattern_analyzer.rb +310 -0
  389. data/lib/fontisan/optimizers/stack_tracker.rb +246 -0
  390. data/lib/fontisan/optimizers/subroutine_builder.rb +135 -0
  391. data/lib/fontisan/optimizers/subroutine_generator.rb +207 -0
  392. data/lib/fontisan/optimizers/subroutine_optimizer.rb +114 -0
  393. data/lib/fontisan/optimizers.rb +14 -0
  394. data/lib/fontisan/outline_extractor.rb +417 -0
  395. data/lib/fontisan/output_guard.rb +40 -0
  396. data/lib/fontisan/parsers/dfont_parser.rb +191 -0
  397. data/lib/fontisan/parsers/tag.rb +77 -0
  398. data/lib/fontisan/parsers.rb +10 -0
  399. data/lib/fontisan/pipeline/format_detector.rb +176 -0
  400. data/lib/fontisan/pipeline/output_writer.rb +161 -0
  401. data/lib/fontisan/pipeline/strategies/base_strategy.rb +75 -0
  402. data/lib/fontisan/pipeline/strategies/instance_strategy.rb +89 -0
  403. data/lib/fontisan/pipeline/strategies/named_strategy.rb +114 -0
  404. data/lib/fontisan/pipeline/strategies/preserve_strategy.rb +54 -0
  405. data/lib/fontisan/pipeline/strategies.rb +16 -0
  406. data/lib/fontisan/pipeline/transformation_pipeline.rb +407 -0
  407. data/lib/fontisan/pipeline/variation_resolver.rb +158 -0
  408. data/lib/fontisan/pipeline.rb +14 -0
  409. data/lib/fontisan/reference/table_digests.rb +251 -0
  410. data/lib/fontisan/reference.rb +663 -0
  411. data/lib/fontisan/scan.rb +372 -0
  412. data/lib/fontisan/sfnt_builder.rb +66 -0
  413. data/lib/fontisan/sfnt_directory.rb +41 -0
  414. data/lib/fontisan/sfnt_font.rb +749 -0
  415. data/lib/fontisan/sfnt_source.rb +28 -0
  416. data/lib/fontisan/sfnt_table.rb +260 -0
  417. data/lib/fontisan/stitcher/cbdt_propagator.rb +212 -0
  418. data/lib/fontisan/stitcher/collection_result.rb +19 -0
  419. data/lib/fontisan/stitcher/deduplicator.rb +47 -0
  420. data/lib/fontisan/stitcher/format_metadata.rb +51 -0
  421. data/lib/fontisan/stitcher/glyph_cloner.rb +41 -0
  422. data/lib/fontisan/stitcher/glyph_copier.rb +110 -0
  423. data/lib/fontisan/stitcher/glyph_limit.rb +53 -0
  424. data/lib/fontisan/stitcher/glyph_signature.rb +51 -0
  425. data/lib/fontisan/stitcher/partition_strategy/base.rb +52 -0
  426. data/lib/fontisan/stitcher/partition_strategy/blueprint.rb +24 -0
  427. data/lib/fontisan/stitcher/partition_strategy/by_block.rb +430 -0
  428. data/lib/fontisan/stitcher/partition_strategy/by_plane.rb +161 -0
  429. data/lib/fontisan/stitcher/partition_strategy/by_script.rb +309 -0
  430. data/lib/fontisan/stitcher/partition_strategy/partition.rb +24 -0
  431. data/lib/fontisan/stitcher/partition_strategy.rb +24 -0
  432. data/lib/fontisan/stitcher/selector/codepoints.rb +29 -0
  433. data/lib/fontisan/stitcher/selector/gid.rb +25 -0
  434. data/lib/fontisan/stitcher/selector/range.rb +30 -0
  435. data/lib/fontisan/stitcher/selector.rb +26 -0
  436. data/lib/fontisan/stitcher/source.rb +459 -0
  437. data/lib/fontisan/stitcher/unique_glyph_name.rb +46 -0
  438. data/lib/fontisan/stitcher.rb +185 -0
  439. data/lib/fontisan/stitcher_cli.rb +69 -0
  440. data/lib/fontisan/subset/builder.rb +263 -0
  441. data/lib/fontisan/subset/glyph_mapping.rb +222 -0
  442. data/lib/fontisan/subset/options.rb +142 -0
  443. data/lib/fontisan/subset/profile.rb +152 -0
  444. data/lib/fontisan/subset/shared_state.rb +42 -0
  445. data/lib/fontisan/subset/subset_context.rb +20 -0
  446. data/lib/fontisan/subset/table_strategy/cbdt.rb +30 -0
  447. data/lib/fontisan/subset/table_strategy/cblc.rb +27 -0
  448. data/lib/fontisan/subset/table_strategy/cff.rb +92 -0
  449. data/lib/fontisan/subset/table_strategy/cff2.rb +391 -0
  450. data/lib/fontisan/subset/table_strategy/cmap.rb +146 -0
  451. data/lib/fontisan/subset/table_strategy/color_bitmap_placement.rb +20 -0
  452. data/lib/fontisan/subset/table_strategy/color_bitmap_strike_plan.rb +45 -0
  453. data/lib/fontisan/subset/table_strategy/color_bitmap_subset_plan.rb +62 -0
  454. data/lib/fontisan/subset/table_strategy/color_bitmap_subsetter.rb +182 -0
  455. data/lib/fontisan/subset/table_strategy/color_bitmap_subtable_plan.rb +59 -0
  456. data/lib/fontisan/subset/table_strategy/glyf.rb +29 -0
  457. data/lib/fontisan/subset/table_strategy/glyf_loca_builder.rb +146 -0
  458. data/lib/fontisan/subset/table_strategy/head.rb +43 -0
  459. data/lib/fontisan/subset/table_strategy/hhea.rb +67 -0
  460. data/lib/fontisan/subset/table_strategy/hmtx.rb +52 -0
  461. data/lib/fontisan/subset/table_strategy/loca.rb +41 -0
  462. data/lib/fontisan/subset/table_strategy/maxp.rb +23 -0
  463. data/lib/fontisan/subset/table_strategy/name.rb +19 -0
  464. data/lib/fontisan/subset/table_strategy/os2.rb +21 -0
  465. data/lib/fontisan/subset/table_strategy/pass_through.rb +20 -0
  466. data/lib/fontisan/subset/table_strategy/post.rb +37 -0
  467. data/lib/fontisan/subset/table_strategy.rb +79 -0
  468. data/lib/fontisan/subset/table_subsetter.rb +110 -0
  469. data/lib/fontisan/subset.rb +16 -0
  470. data/lib/fontisan/svg/font_face_generator.rb +274 -0
  471. data/lib/fontisan/svg/font_generator.rb +256 -0
  472. data/lib/fontisan/svg/glyph_generator.rb +201 -0
  473. data/lib/fontisan/svg/standalone_glyph.rb +132 -0
  474. data/lib/fontisan/svg/view_box_calculator.rb +137 -0
  475. data/lib/fontisan/svg.rb +13 -0
  476. data/lib/fontisan/svg_to_glyf/assembler.rb +174 -0
  477. data/lib/fontisan/svg_to_glyf/document.rb +102 -0
  478. data/lib/fontisan/svg_to_glyf/geometry/affine_transform.rb +112 -0
  479. data/lib/fontisan/svg_to_glyf/geometry/normalizer.rb +62 -0
  480. data/lib/fontisan/svg_to_glyf/geometry/transform_parser.rb +98 -0
  481. data/lib/fontisan/svg_to_glyf/geometry.rb +15 -0
  482. data/lib/fontisan/svg_to_glyf/path/command.rb +18 -0
  483. data/lib/fontisan/svg_to_glyf/path/contour_builder.rb +140 -0
  484. data/lib/fontisan/svg_to_glyf/path/parser.rb +98 -0
  485. data/lib/fontisan/svg_to_glyf/path/state.rb +79 -0
  486. data/lib/fontisan/svg_to_glyf/path.rb +14 -0
  487. data/lib/fontisan/svg_to_glyf.rb +62 -0
  488. data/lib/fontisan/tables/cbdt.rb +113 -0
  489. data/lib/fontisan/tables/cblc.rb +172 -0
  490. data/lib/fontisan/tables/cblc_big_glyph_metrics.rb +28 -0
  491. data/lib/fontisan/tables/cblc_bitmap_size.rb +67 -0
  492. data/lib/fontisan/tables/cblc_glyph_bitmap_location.rb +28 -0
  493. data/lib/fontisan/tables/cblc_index_subtable.rb +104 -0
  494. data/lib/fontisan/tables/cblc_index_subtable_array_entry.rb +20 -0
  495. data/lib/fontisan/tables/cblc_index_subtable_format_parser.rb +150 -0
  496. data/lib/fontisan/tables/cblc_index_subtable_header.rb +18 -0
  497. data/lib/fontisan/tables/cblc_sbit_line_metrics.rb +28 -0
  498. data/lib/fontisan/tables/cff/cff2_charstring_builder.rb +225 -0
  499. data/lib/fontisan/tables/cff/cff_glyph.rb +176 -0
  500. data/lib/fontisan/tables/cff/charset.rb +276 -0
  501. data/lib/fontisan/tables/cff/charstring.rb +978 -0
  502. data/lib/fontisan/tables/cff/charstring_builder.rb +356 -0
  503. data/lib/fontisan/tables/cff/charstring_parser.rb +249 -0
  504. data/lib/fontisan/tables/cff/charstring_rebuilder.rb +168 -0
  505. data/lib/fontisan/tables/cff/charstrings_index.rb +159 -0
  506. data/lib/fontisan/tables/cff/dict.rb +353 -0
  507. data/lib/fontisan/tables/cff/dict_builder.rb +260 -0
  508. data/lib/fontisan/tables/cff/encoding.rb +273 -0
  509. data/lib/fontisan/tables/cff/expert_charsets.rb +85 -0
  510. data/lib/fontisan/tables/cff/header.rb +100 -0
  511. data/lib/fontisan/tables/cff/hint_operation_injector.rb +207 -0
  512. data/lib/fontisan/tables/cff/index.rb +241 -0
  513. data/lib/fontisan/tables/cff/index_builder.rb +170 -0
  514. data/lib/fontisan/tables/cff/offset_recalculator.rb +70 -0
  515. data/lib/fontisan/tables/cff/private_dict.rb +282 -0
  516. data/lib/fontisan/tables/cff/private_dict_writer.rb +129 -0
  517. data/lib/fontisan/tables/cff/standard_strings_data.rb +83 -0
  518. data/lib/fontisan/tables/cff/table_builder.rb +215 -0
  519. data/lib/fontisan/tables/cff/top_dict.rb +234 -0
  520. data/lib/fontisan/tables/cff.rb +497 -0
  521. data/lib/fontisan/tables/cff2/blend_operator.rb +240 -0
  522. data/lib/fontisan/tables/cff2/charstring_parser.rb +624 -0
  523. data/lib/fontisan/tables/cff2/dict_encoder.rb +94 -0
  524. data/lib/fontisan/tables/cff2/fd_select.rb +142 -0
  525. data/lib/fontisan/tables/cff2/header.rb +34 -0
  526. data/lib/fontisan/tables/cff2/index.rb +155 -0
  527. data/lib/fontisan/tables/cff2/index_builder.rb +80 -0
  528. data/lib/fontisan/tables/cff2/operand_stack.rb +232 -0
  529. data/lib/fontisan/tables/cff2/private_dict_blend_handler.rb +247 -0
  530. data/lib/fontisan/tables/cff2/region_matcher.rb +200 -0
  531. data/lib/fontisan/tables/cff2/table_builder.rb +567 -0
  532. data/lib/fontisan/tables/cff2/table_reader.rb +418 -0
  533. data/lib/fontisan/tables/cff2/variation_data_extractor.rb +212 -0
  534. data/lib/fontisan/tables/cff2.rb +353 -0
  535. data/lib/fontisan/tables/cmap.rb +399 -0
  536. data/lib/fontisan/tables/cmap_table.rb +228 -0
  537. data/lib/fontisan/tables/colr.rb +290 -0
  538. data/lib/fontisan/tables/cpal.rb +381 -0
  539. data/lib/fontisan/tables/cvar.rb +204 -0
  540. data/lib/fontisan/tables/fvar.rb +159 -0
  541. data/lib/fontisan/tables/glyf/compound_glyph.rb +482 -0
  542. data/lib/fontisan/tables/glyf/compound_glyph_resolver.rb +135 -0
  543. data/lib/fontisan/tables/glyf/curve_converter.rb +349 -0
  544. data/lib/fontisan/tables/glyf/glyph_builder.rb +468 -0
  545. data/lib/fontisan/tables/glyf/simple_glyph.rb +391 -0
  546. data/lib/fontisan/tables/glyf.rb +347 -0
  547. data/lib/fontisan/tables/glyf_table.rb +252 -0
  548. data/lib/fontisan/tables/gpos/glyph_filter.rb +87 -0
  549. data/lib/fontisan/tables/gpos/kerning_pairs.rb +215 -0
  550. data/lib/fontisan/tables/gpos/pair_position.rb +274 -0
  551. data/lib/fontisan/tables/gpos.rb +139 -0
  552. data/lib/fontisan/tables/gsub.rb +116 -0
  553. data/lib/fontisan/tables/gvar.rb +232 -0
  554. data/lib/fontisan/tables/head.rb +208 -0
  555. data/lib/fontisan/tables/head_table.rb +108 -0
  556. data/lib/fontisan/tables/hhea.rb +199 -0
  557. data/lib/fontisan/tables/hhea_table.rb +252 -0
  558. data/lib/fontisan/tables/hmtx.rb +281 -0
  559. data/lib/fontisan/tables/hmtx_table.rb +188 -0
  560. data/lib/fontisan/tables/hvar.rb +192 -0
  561. data/lib/fontisan/tables/layout_common.rb +245 -0
  562. data/lib/fontisan/tables/loca.rb +323 -0
  563. data/lib/fontisan/tables/loca_table.rb +209 -0
  564. data/lib/fontisan/tables/maxp.rb +253 -0
  565. data/lib/fontisan/tables/maxp_table.rb +255 -0
  566. data/lib/fontisan/tables/mvar.rb +185 -0
  567. data/lib/fontisan/tables/name.rb +340 -0
  568. data/lib/fontisan/tables/name_table.rb +173 -0
  569. data/lib/fontisan/tables/os2.rb +291 -0
  570. data/lib/fontisan/tables/os2_table.rb +326 -0
  571. data/lib/fontisan/tables/post.rb +206 -0
  572. data/lib/fontisan/tables/post_table.rb +180 -0
  573. data/lib/fontisan/tables/registry.rb +71 -0
  574. data/lib/fontisan/tables/sbix.rb +379 -0
  575. data/lib/fontisan/tables/svg.rb +300 -0
  576. data/lib/fontisan/tables/variation_common.rb +345 -0
  577. data/lib/fontisan/tables/vvar.rb +234 -0
  578. data/lib/fontisan/tables.rb +69 -0
  579. data/lib/fontisan/true_type_collection.rb +160 -0
  580. data/lib/fontisan/true_type_font.rb +80 -0
  581. data/lib/fontisan/true_type_font_extensions.rb +54 -0
  582. data/lib/fontisan/type1/afm_generator.rb +379 -0
  583. data/lib/fontisan/type1/afm_parser.rb +299 -0
  584. data/lib/fontisan/type1/agl.rb +456 -0
  585. data/lib/fontisan/type1/cff_to_type1_converter.rb +307 -0
  586. data/lib/fontisan/type1/charstring_converter.rb +238 -0
  587. data/lib/fontisan/type1/charstrings.rb +441 -0
  588. data/lib/fontisan/type1/conversion_options.rb +242 -0
  589. data/lib/fontisan/type1/decryptor.rb +183 -0
  590. data/lib/fontisan/type1/encodings.rb +695 -0
  591. data/lib/fontisan/type1/font_dictionary.rb +576 -0
  592. data/lib/fontisan/type1/generator.rb +217 -0
  593. data/lib/fontisan/type1/inf_generator.rb +307 -0
  594. data/lib/fontisan/type1/pfa_generator.rb +376 -0
  595. data/lib/fontisan/type1/pfa_parser.rb +159 -0
  596. data/lib/fontisan/type1/pfb_generator.rb +321 -0
  597. data/lib/fontisan/type1/pfb_parser.rb +166 -0
  598. data/lib/fontisan/type1/pfm_generator.rb +589 -0
  599. data/lib/fontisan/type1/pfm_parser.rb +433 -0
  600. data/lib/fontisan/type1/private_dict.rb +363 -0
  601. data/lib/fontisan/type1/seac_expander.rb +517 -0
  602. data/lib/fontisan/type1/ttf_to_type1_converter.rb +389 -0
  603. data/lib/fontisan/type1/upm_scaler.rb +118 -0
  604. data/lib/fontisan/type1.rb +48 -0
  605. data/lib/fontisan/type1_font.rb +347 -0
  606. data/lib/fontisan/ufo/anchor.rb +17 -0
  607. data/lib/fontisan/ufo/bounds.rb +91 -0
  608. data/lib/fontisan/ufo/cli.rb +105 -0
  609. data/lib/fontisan/ufo/compile/avar.rb +46 -0
  610. data/lib/fontisan/ufo/compile/base_compiler.rb +162 -0
  611. data/lib/fontisan/ufo/compile/cbdt_cblc.rb +104 -0
  612. data/lib/fontisan/ufo/compile/cff.rb +229 -0
  613. data/lib/fontisan/ufo/compile/cff2.rb +323 -0
  614. data/lib/fontisan/ufo/compile/cff2_subroutines.rb +39 -0
  615. data/lib/fontisan/ufo/compile/cmap.rb +143 -0
  616. data/lib/fontisan/ufo/compile/colr.rb +80 -0
  617. data/lib/fontisan/ufo/compile/cpal.rb +62 -0
  618. data/lib/fontisan/ufo/compile/feature_compiler.rb +161 -0
  619. data/lib/fontisan/ufo/compile/feature_writers/base.rb +56 -0
  620. data/lib/fontisan/ufo/compile/feature_writers/curs.rb +72 -0
  621. data/lib/fontisan/ufo/compile/feature_writers/gdef.rb +92 -0
  622. data/lib/fontisan/ufo/compile/feature_writers/kern.rb +50 -0
  623. data/lib/fontisan/ufo/compile/feature_writers/kern2.rb +57 -0
  624. data/lib/fontisan/ufo/compile/feature_writers/mark.rb +45 -0
  625. data/lib/fontisan/ufo/compile/feature_writers/mark_family_base.rb +124 -0
  626. data/lib/fontisan/ufo/compile/feature_writers/mkmk.rb +53 -0
  627. data/lib/fontisan/ufo/compile/feature_writers.rb +38 -0
  628. data/lib/fontisan/ufo/compile/filters/cubic_to_quadratic.rb +176 -0
  629. data/lib/fontisan/ufo/compile/filters/decompose_components.rb +33 -0
  630. data/lib/fontisan/ufo/compile/filters/flatten_components.rb +22 -0
  631. data/lib/fontisan/ufo/compile/filters/propagate_anchors.rb +102 -0
  632. data/lib/fontisan/ufo/compile/filters/remove_overlaps.rb +95 -0
  633. data/lib/fontisan/ufo/compile/filters/reverse_contour_direction.rb +27 -0
  634. data/lib/fontisan/ufo/compile/filters/sort_contours.rb +69 -0
  635. data/lib/fontisan/ufo/compile/filters/transformations.rb +113 -0
  636. data/lib/fontisan/ufo/compile/filters.rb +69 -0
  637. data/lib/fontisan/ufo/compile/fvar.rb +113 -0
  638. data/lib/fontisan/ufo/compile/glyf_loca.rb +206 -0
  639. data/lib/fontisan/ufo/compile/gpos.rb +248 -0
  640. data/lib/fontisan/ufo/compile/gsub.rb +267 -0
  641. data/lib/fontisan/ufo/compile/gvar.rb +225 -0
  642. data/lib/fontisan/ufo/compile/head.rb +97 -0
  643. data/lib/fontisan/ufo/compile/hhea.rb +57 -0
  644. data/lib/fontisan/ufo/compile/hmtx.rb +38 -0
  645. data/lib/fontisan/ufo/compile/hvar.rb +42 -0
  646. data/lib/fontisan/ufo/compile/item_variation_store.rb +100 -0
  647. data/lib/fontisan/ufo/compile/math.rb +143 -0
  648. data/lib/fontisan/ufo/compile/maxp.rb +57 -0
  649. data/lib/fontisan/ufo/compile/meta.rb +51 -0
  650. data/lib/fontisan/ufo/compile/mvar.rb +59 -0
  651. data/lib/fontisan/ufo/compile/name.rb +81 -0
  652. data/lib/fontisan/ufo/compile/os2.rb +81 -0
  653. data/lib/fontisan/ufo/compile/otf2_compiler.rb +40 -0
  654. data/lib/fontisan/ufo/compile/otf_compiler.rb +34 -0
  655. data/lib/fontisan/ufo/compile/post.rb +32 -0
  656. data/lib/fontisan/ufo/compile/sbix.rb +100 -0
  657. data/lib/fontisan/ufo/compile/stat.rb +106 -0
  658. data/lib/fontisan/ufo/compile/svg_table.rb +60 -0
  659. data/lib/fontisan/ufo/compile/ttf_compiler.rb +75 -0
  660. data/lib/fontisan/ufo/compile/variable_otf.rb +84 -0
  661. data/lib/fontisan/ufo/compile/variable_ttf.rb +161 -0
  662. data/lib/fontisan/ufo/compile.rb +72 -0
  663. data/lib/fontisan/ufo/component.rb +18 -0
  664. data/lib/fontisan/ufo/contour.rb +34 -0
  665. data/lib/fontisan/ufo/convert/from_bin_data.rb +366 -0
  666. data/lib/fontisan/ufo/convert/to_dfont.rb +45 -0
  667. data/lib/fontisan/ufo/convert/to_otc.rb +40 -0
  668. data/lib/fontisan/ufo/convert/to_otf.rb +18 -0
  669. data/lib/fontisan/ufo/convert/to_otf2.rb +20 -0
  670. data/lib/fontisan/ufo/convert/to_postscript.rb +64 -0
  671. data/lib/fontisan/ufo/convert/to_ttc.rb +35 -0
  672. data/lib/fontisan/ufo/convert/to_ttf.rb +21 -0
  673. data/lib/fontisan/ufo/convert/to_woff.rb +61 -0
  674. data/lib/fontisan/ufo/convert/to_woff2.rb +50 -0
  675. data/lib/fontisan/ufo/convert.rb +84 -0
  676. data/lib/fontisan/ufo/data_set.rb +21 -0
  677. data/lib/fontisan/ufo/features.rb +17 -0
  678. data/lib/fontisan/ufo/font.rb +63 -0
  679. data/lib/fontisan/ufo/glyph.rb +445 -0
  680. data/lib/fontisan/ufo/glyph_exists_error.rb +23 -0
  681. data/lib/fontisan/ufo/groups.rb +45 -0
  682. data/lib/fontisan/ufo/guideline.rb +19 -0
  683. data/lib/fontisan/ufo/image.rb +29 -0
  684. data/lib/fontisan/ufo/image_set.rb +99 -0
  685. data/lib/fontisan/ufo/info.rb +133 -0
  686. data/lib/fontisan/ufo/kerning.rb +32 -0
  687. data/lib/fontisan/ufo/layer.rb +78 -0
  688. data/lib/fontisan/ufo/layer_set.rb +37 -0
  689. data/lib/fontisan/ufo/lib.rb +24 -0
  690. data/lib/fontisan/ufo/plist.rb +123 -0
  691. data/lib/fontisan/ufo/point.rb +32 -0
  692. data/lib/fontisan/ufo/reader.rb +163 -0
  693. data/lib/fontisan/ufo/transformation.rb +50 -0
  694. data/lib/fontisan/ufo/writer.rb +123 -0
  695. data/lib/fontisan/ufo.rb +47 -0
  696. data/lib/fontisan/unicode/plane.rb +44 -0
  697. data/lib/fontisan/unicode.rb +17 -0
  698. data/lib/fontisan/utilities/brotli_wrapper.rb +177 -0
  699. data/lib/fontisan/utilities/checksum_calculator.rb +104 -0
  700. data/lib/fontisan/utilities/padding.rb +61 -0
  701. data/lib/fontisan/utilities.rb +11 -0
  702. data/lib/fontisan/utils/thread_pool.rb +134 -0
  703. data/lib/fontisan/utils.rb +10 -0
  704. data/lib/fontisan/validation/collection_validator.rb +265 -0
  705. data/lib/fontisan/validation.rb +9 -0
  706. data/lib/fontisan/validators/basic_validator.rb +73 -0
  707. data/lib/fontisan/validators/font_book_validator.rb +107 -0
  708. data/lib/fontisan/validators/opentype_validator.rb +118 -0
  709. data/lib/fontisan/validators/profile_loader.rb +134 -0
  710. data/lib/fontisan/validators/validator.rb +494 -0
  711. data/lib/fontisan/validators/web_font_validator.rb +95 -0
  712. data/lib/fontisan/validators.rb +14 -0
  713. data/lib/fontisan/variable/axis_normalizer.rb +215 -0
  714. data/lib/fontisan/variable/delta_applicator.rb +302 -0
  715. data/lib/fontisan/variable/glyph_delta_processor.rb +218 -0
  716. data/lib/fontisan/variable/instancer.rb +172 -0
  717. data/lib/fontisan/variable/metric_delta_processor.rb +282 -0
  718. data/lib/fontisan/variable/region_matcher.rb +208 -0
  719. data/lib/fontisan/variable/static_font_builder.rb +209 -0
  720. data/lib/fontisan/variable/table_updater.rb +219 -0
  721. data/lib/fontisan/variable.rb +16 -0
  722. data/lib/fontisan/variation/blend_applier.rb +197 -0
  723. data/lib/fontisan/variation/cache.rb +299 -0
  724. data/lib/fontisan/variation/cache_key_builder.rb +162 -0
  725. data/lib/fontisan/variation/converter.rb +373 -0
  726. data/lib/fontisan/variation/data_extractor.rb +84 -0
  727. data/lib/fontisan/variation/delta_applier.rb +262 -0
  728. data/lib/fontisan/variation/delta_parser.rb +228 -0
  729. data/lib/fontisan/variation/inspector.rb +275 -0
  730. data/lib/fontisan/variation/instance_font_wrapper.rb +41 -0
  731. data/lib/fontisan/variation/instance_generator.rb +122 -0
  732. data/lib/fontisan/variation/instance_writer.rb +360 -0
  733. data/lib/fontisan/variation/instancing/axis_space.rb +136 -0
  734. data/lib/fontisan/variation/instancing/glyph_outline.rb +204 -0
  735. data/lib/fontisan/variation/instancing/gvar_reader.rb +146 -0
  736. data/lib/fontisan/variation/instancing/item_variation_store.rb +92 -0
  737. data/lib/fontisan/variation/instancing/name_rewriter.rb +90 -0
  738. data/lib/fontisan/variation/instancing/true_type_instancer.rb +326 -0
  739. data/lib/fontisan/variation/instancing.rb +20 -0
  740. data/lib/fontisan/variation/interpolator.rb +231 -0
  741. data/lib/fontisan/variation/metrics_adjuster.rb +309 -0
  742. data/lib/fontisan/variation/optimizer.rb +417 -0
  743. data/lib/fontisan/variation/parallel_generator.rb +147 -0
  744. data/lib/fontisan/variation/region_matcher.rb +221 -0
  745. data/lib/fontisan/variation/subsetter.rb +400 -0
  746. data/lib/fontisan/variation/table_accessor.rb +105 -0
  747. data/lib/fontisan/variation/tuple_variation_header.rb +49 -0
  748. data/lib/fontisan/variation/validator.rb +336 -0
  749. data/lib/fontisan/variation/variable_svg_generator.rb +235 -0
  750. data/lib/fontisan/variation/variation_context.rb +208 -0
  751. data/lib/fontisan/variation/variation_preserver.rb +287 -0
  752. data/lib/fontisan/variation.rb +33 -0
  753. data/lib/fontisan/version.rb +5 -0
  754. data/lib/fontisan/version.rb.orig +9 -0
  755. data/lib/fontisan/woff2/collection_decoder.rb +223 -0
  756. data/lib/fontisan/woff2/collection_encoder.rb +302 -0
  757. data/lib/fontisan/woff2/directory.rb +255 -0
  758. data/lib/fontisan/woff2/encoder_rules.rb +114 -0
  759. data/lib/fontisan/woff2/glyf_canonicalizer.rb +90 -0
  760. data/lib/fontisan/woff2/glyf_loca_reconstruct.rb +401 -0
  761. data/lib/fontisan/woff2/glyf_loca_transform.rb +319 -0
  762. data/lib/fontisan/woff2/header.rb +101 -0
  763. data/lib/fontisan/woff2/hmtx_transformer.rb +140 -0
  764. data/lib/fontisan/woff2/sfnt_checksum.rb +107 -0
  765. data/lib/fontisan/woff2/table_transformer.rb +575 -0
  766. data/lib/fontisan/woff2/triplet_codec.rb +181 -0
  767. data/lib/fontisan/woff2/uint255.rb +101 -0
  768. data/lib/fontisan/woff2.rb +21 -0
  769. data/lib/fontisan/woff2_collection.rb +127 -0
  770. data/lib/fontisan/woff2_font.rb +754 -0
  771. data/lib/fontisan/woff_container.rb +83 -0
  772. data/lib/fontisan/woff_font.rb +554 -0
  773. data/lib/fontisan.rb +299 -0
  774. data/rakelib/bench.rake +9 -0
  775. data/rakelib/cdylib.rake +39 -0
  776. data/rakelib/corpus.rake +272 -0
  777. data/rakelib/corpus_convert.rake +43 -0
  778. data/rakelib/corpus_goldens.rake +22 -0
  779. data/rakelib/corpus_malformed.rake +20 -0
  780. data/rakelib/corpus_scan.rake +24 -0
  781. data/rakelib/java.rake +61 -0
  782. data/rakelib/native.rake +43 -0
  783. data/scripts/build-woff2.sh +57 -0
  784. data/scripts/compare_stack_aware.rb +187 -0
  785. data/scripts/corpus/generate_convert_goldens.rb +478 -0
  786. data/scripts/corpus/generate_goldens.rb +282 -0
  787. data/scripts/corpus/generate_malformed_goldens.rb +254 -0
  788. data/scripts/corpus/generate_scan_goldens.rb +98 -0
  789. data/scripts/measure_optimization.rb +148 -0
  790. data/scripts/tier_fallback.rb +228 -0
  791. data/scripts/tier_smoke.rb +72 -0
  792. metadata +945 -0
@@ -0,0 +1,749 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "bindata"
4
+
5
+ module Fontisan
6
+ # SFNT Offset Table structure
7
+ #
8
+ # Common structure for both TrueType and OpenType fonts.
9
+ class OffsetTable < BinData::Record
10
+ endian :big
11
+ uint32 :sfnt_version
12
+ uint16 :num_tables
13
+ uint16 :search_range
14
+ uint16 :entry_selector
15
+ uint16 :range_shift
16
+ end
17
+
18
+ # SFNT Table Directory Entry structure
19
+ #
20
+ # Common structure for both TrueType and OpenType fonts.
21
+ class TableDirectory < BinData::Record
22
+ endian :big
23
+ string :tag, length: 4
24
+ uint32 :checksum
25
+ uint32 :offset
26
+ uint32 :table_length
27
+ end
28
+
29
+ # Base class for SFNT font formats (TrueType and OpenType)
30
+ #
31
+ # This class contains all shared SFNT structure and behavior.
32
+ # TrueType and OpenType fonts inherit from this class and add
33
+ # format-specific functionality.
34
+ #
35
+ # @abstract Subclasses must implement format-specific validation
36
+ #
37
+ # @example Reading a font (format detected automatically)
38
+ # font = Fontisan::FontLoader.load("font.ttf") # Returns TrueTypeFont
39
+ # font = Fontisan::FontLoader.load("font.otf") # Returns OpenTypeFont
40
+ #
41
+ # @example Reading and analyzing a font
42
+ # ttf = Fontisan::TrueTypeFont.from_file("font.ttf")
43
+ # puts ttf.header.num_tables # => 14
44
+ # name_table = ttf.table("name")
45
+ # puts name_table.english_name(Tables::Name::FAMILY)
46
+ #
47
+ # @example Loading with metadata mode
48
+ # ttf = Fontisan::TrueTypeFont.from_file("font.ttf", mode: :metadata)
49
+ # puts ttf.loading_mode # => :metadata
50
+ # ttf.table_available?("GSUB") # => false
51
+ #
52
+ # @example Writing a font
53
+ # ttf.to_file("output.ttf")
54
+ class SfntFont < BinData::Record
55
+ include SfntSource
56
+
57
+ endian :big
58
+
59
+ offset_table :header
60
+ array :tables, type: :table_directory, initial_length: lambda {
61
+ header.num_tables
62
+ }
63
+
64
+ # Table data is stored separately since it's at variable offsets.
65
+ # The setter normalizes all keys to UTF-8 so Hash lookups don't
66
+ # silently miss due to encoding mismatch — BinData-derived tag
67
+ # strings are ASCII-8BIT, literals callers pass are usually UTF-8,
68
+ # and String#eql? is encoding-sensitive.
69
+ # Raw table bytes: the Hash of all tables, or one table's bytes when a
70
+ # tag is given (the WOFF classes already accept a tag; StaticFontBuilder
71
+ # calls it that way).
72
+ #
73
+ # @param tag [String, nil]
74
+ # @return [Hash{String=>String}, String, nil]
75
+ def table_data(tag = nil)
76
+ tag.nil? ? @table_data : @table_data&.[](tag)
77
+ end
78
+
79
+ def table_data=(hash)
80
+ @table_data = hash.transform_keys { |tag| normalize_tag(tag) }
81
+ end
82
+
83
+ # Parsed table instances cache
84
+ attr_accessor :parsed_tables
85
+
86
+ # OOP SfntTable instances (tag => SfntTable)
87
+ attr_accessor :sfnt_tables
88
+
89
+ # Table entry lookup cache (tag => TableDirectory)
90
+ attr_accessor :table_entry_cache
91
+
92
+ # Loading mode for this font (:metadata or :full)
93
+ attr_accessor :loading_mode
94
+
95
+ # IO source for lazy loading
96
+ attr_accessor :io_source
97
+
98
+ # Whether lazy loading is enabled
99
+ attr_accessor :lazy_load_enabled
100
+
101
+ # Map table tag to parser class (cached as constant for performance)
102
+ #
103
+ # @return [Hash<String, Class>] Mapping of table tags to parser classes
104
+ TABLE_CLASS_MAP = {
105
+ Constants::HEAD_TAG => Tables::Head,
106
+ Constants::HHEA_TAG => Tables::Hhea,
107
+ Constants::HMTX_TAG => Tables::Hmtx,
108
+ Constants::MAXP_TAG => Tables::Maxp,
109
+ Constants::NAME_TAG => Tables::Name,
110
+ Constants::OS2_TAG => Tables::Os2,
111
+ Constants::POST_TAG => Tables::Post,
112
+ Constants::CMAP_TAG => Tables::Cmap,
113
+ Constants::FVAR_TAG => Tables::Fvar,
114
+ Constants::GSUB_TAG => Tables::Gsub,
115
+ Constants::GPOS_TAG => Tables::Gpos,
116
+ Constants::GLYF_TAG => Tables::Glyf,
117
+ Constants::LOCA_TAG => Tables::Loca,
118
+ "SVG " => Tables::Svg,
119
+ "COLR" => Tables::Colr,
120
+ "CPAL" => Tables::Cpal,
121
+ "CBDT" => Tables::Cbdt,
122
+ "CBLC" => Tables::Cblc,
123
+ "sbix" => Tables::Sbix,
124
+ }.freeze
125
+
126
+ # Map table tag to SfntTable wrapper class (cached as constant for performance)
127
+ #
128
+ # @return [Hash<String, Class>] Mapping of table tags to SfntTable wrapper classes
129
+ SFNT_TABLE_CLASS_MAP = {
130
+ Constants::HEAD_TAG => Tables::HeadTable,
131
+ Constants::NAME_TAG => Tables::NameTable,
132
+ Constants::OS2_TAG => Tables::Os2Table,
133
+ Constants::CMAP_TAG => Tables::CmapTable,
134
+ Constants::GLYF_TAG => Tables::GlyfTable,
135
+ Constants::HHEA_TAG => Tables::HheaTable,
136
+ Constants::MAXP_TAG => Tables::MaxpTable,
137
+ Constants::POST_TAG => Tables::PostTable,
138
+ Constants::HMTX_TAG => Tables::HmtxTable,
139
+ Constants::LOCA_TAG => Tables::LocaTable,
140
+ }.freeze
141
+
142
+ # Padding bytes for table alignment (frozen to avoid reallocation)
143
+ PADDING_BYTES = ("\x00" * 4).freeze
144
+
145
+ # Read SFNT Font from a file
146
+ #
147
+ # @param path [String] Path to the font file
148
+ # @param mode [Symbol] Loading mode (:metadata or :full, default: :full)
149
+ # @param lazy [Boolean] If true, load tables on demand (default: false)
150
+ # @return [SfntFont] A new instance
151
+ # @raise [ArgumentError] if path is nil or empty, or if mode is invalid
152
+ # @raise [Errno::ENOENT] if file does not exist
153
+ # @raise [RuntimeError] if file format is invalid
154
+ def self.from_file(path, mode: LoadingModes::FULL, lazy: false)
155
+ if path.nil? || path.to_s.empty?
156
+ raise ArgumentError, "path cannot be nil or empty"
157
+ end
158
+ raise Errno::ENOENT, "File not found: #{path}" unless File.exist?(path)
159
+
160
+ LoadingModes.validate_mode!(mode)
161
+
162
+ font = new
163
+ font.initialize_storage
164
+ font.loading_mode = mode
165
+ font.lazy_load_enabled = lazy
166
+
167
+ lazy ? load_lazy(path, font) : load_eager(path, font)
168
+ end
169
+
170
+ # Load font with lazy loading (keeps file handle open)
171
+ #
172
+ # @param path [String] Path to the font file
173
+ # @param font [SfntFont] Font instance to populate
174
+ # @return [SfntFont] The populated font instance
175
+ def self.load_lazy(path, font)
176
+ # rubocop:disable Security/Open -- Intentionally kept open for lazy loading
177
+ # Finalizer handles cleanup when object is GC'd
178
+ font.io_source = File.open(path, "rb")
179
+ # rubocop:enable Security/Open
180
+ font.setup_finalizer
181
+ font.io_source.rewind
182
+ font.read(font.io_source)
183
+ font
184
+ rescue BinData::ValidityError, EOFError => e
185
+ font_type = name.split("::").last
186
+ raise "Invalid #{font_type} file: #{e.message}"
187
+ end
188
+
189
+ # Load font with eager loading (reads all data, closes file)
190
+ #
191
+ # @param path [String] Path to the font file
192
+ # @param font [SfntFont] Font instance to populate
193
+ # @return [SfntFont] The populated font instance
194
+ def self.load_eager(path, font)
195
+ File.open(path, "rb") do |io|
196
+ font.read(io)
197
+ font.read_table_data(io)
198
+ end
199
+ font
200
+ rescue BinData::ValidityError, EOFError => e
201
+ font_type = name.split("::").last
202
+ raise "Invalid #{font_type} file: #{e.message}"
203
+ end
204
+ private_class_method :load_lazy, :load_eager
205
+
206
+ # Read SFNT Font from collection at specific offset
207
+ #
208
+ # @param io [IO] Open file handle
209
+ # @param offset [Integer] Byte offset to the font
210
+ # @param mode [Symbol] Loading mode (:metadata or :full, default: :full)
211
+ # @return [SfntFont] A new instance
212
+ def self.from_collection(io, offset, mode: LoadingModes::FULL)
213
+ LoadingModes.validate_mode!(mode)
214
+
215
+ io.seek(offset)
216
+ font = read(io)
217
+ font.initialize_storage
218
+ font.loading_mode = mode
219
+ font.read_table_data(io)
220
+ font
221
+ end
222
+
223
+ # Initialize storage hashes
224
+ #
225
+ # @return [void]
226
+ def initialize_storage
227
+ @table_data = {}
228
+ @parsed_tables = {}
229
+ @sfnt_tables = {}
230
+ @table_entry_cache = {}
231
+ @tag_encoding_cache = {} # Cache for normalized tag encodings
232
+ @table_names = nil # Cache for table names array
233
+ @loading_mode = LoadingModes::FULL
234
+ @lazy_load_enabled = false
235
+ @io_source = nil
236
+ end
237
+
238
+ # Read table data for all tables in the font
239
+ #
240
+ # In metadata mode, only reads metadata tables. In full mode, reads all tables.
241
+ # In lazy load mode, doesn't read data upfront.
242
+ #
243
+ # @param io [IO] IO object to read from
244
+ # @return [void]
245
+ def read_table_data(io)
246
+ @table_data = {}
247
+
248
+ if @lazy_load_enabled
249
+ # Don't read data, just keep IO reference
250
+ @io_source = io
251
+ return
252
+ end
253
+
254
+ if @loading_mode == LoadingModes::METADATA
255
+ # Only read metadata tables for performance
256
+ # Use page-aware batched reading to maximize filesystem prefetching
257
+ read_metadata_tables_batched(io)
258
+ else
259
+ # Read all tables
260
+ tables.each do |entry|
261
+ io.seek(entry.offset)
262
+ # Normalize tag encoding for hash key consistency
263
+ tag_key = normalize_tag(entry.tag)
264
+ @table_data[tag_key] = io.read(entry.table_length)
265
+ end
266
+ end
267
+ end
268
+
269
+ # Read metadata tables using page-aware batching
270
+ #
271
+ # Groups adjacent tables within page boundaries and reads them together
272
+ # to maximize filesystem prefetching and minimize random seeks.
273
+ #
274
+ # @param io [IO] Open file handle
275
+ # @return [void]
276
+ def read_metadata_tables_batched(io)
277
+ # Typical filesystem page size (4KB is common, but 8KB gives better prefetch window)
278
+ page_threshold = 8192
279
+
280
+ # Get metadata tables sorted by offset for sequential access
281
+ metadata_entries = tables.select { |entry| LoadingModes::METADATA_TABLES_SET.include?(entry.tag) }
282
+ # Tables may share an offset (a zero-length table sits where the next one
283
+ # starts) and sort_by is not stable, so tie-break on the directory order.
284
+ metadata_entries = metadata_entries.each_with_index.sort_by { |entry, idx| [entry.offset, idx] }.map(&:first)
285
+
286
+ return if metadata_entries.empty?
287
+
288
+ # Group adjacent tables within page threshold for batched reading
289
+ i = 0
290
+ while i < metadata_entries.size
291
+ batch_start = metadata_entries[i]
292
+ batch_end_pos = batch_start.offset + batch_start.table_length
293
+ batch_entries = [batch_start]
294
+
295
+ # Extend batch while next table is within page threshold
296
+ j = i + 1
297
+ while j < metadata_entries.size
298
+ next_entry = metadata_entries[j]
299
+ gap = next_entry.offset - batch_end_pos
300
+
301
+ # If gap is small (within page threshold), include in batch
302
+ if gap <= page_threshold
303
+ batch_end_pos = [batch_end_pos, next_entry.offset + next_entry.table_length].max
304
+ batch_entries << next_entry
305
+ j += 1
306
+ else
307
+ break
308
+ end
309
+ end
310
+
311
+ # Read batch
312
+ if batch_entries.size == 1
313
+ # Single table, read normally
314
+ io.seek(batch_start.offset)
315
+ tag_key = normalize_tag(batch_start.tag)
316
+ @table_data[tag_key] = io.read(batch_start.table_length)
317
+ else
318
+ # Multiple tables, read contiguous segment
319
+ batch_offset = batch_start.offset
320
+ batch_length = batch_end_pos - batch_start.offset
321
+
322
+ io.seek(batch_offset)
323
+ batch_data = io.read(batch_length)
324
+
325
+ # Extract individual tables from batch
326
+ batch_entries.each do |entry|
327
+ relative_offset = entry.offset - batch_offset
328
+ tag_key = normalize_tag(entry.tag)
329
+ @table_data[tag_key] =
330
+ batch_data[relative_offset, entry.table_length]
331
+ end
332
+ end
333
+
334
+ i = j
335
+ end
336
+ end
337
+
338
+ # Write SFNT Font to a file
339
+ #
340
+ # Writes the complete font structure to disk, including proper checksum
341
+ # calculation and table alignment.
342
+ #
343
+ # @param path [String] Path where the font file will be written
344
+ # @return [Integer] Number of bytes written
345
+ # @raise [IOError] if writing fails
346
+ def to_file(path)
347
+ File.open(path, "w+b") do |io|
348
+ # Write header and tables (directory)
349
+ write_structure(io)
350
+
351
+ # Write table data with updated offsets
352
+ write_table_data_with_offsets(io)
353
+
354
+ # Update checksum adjustment in head table BEFORE closing file
355
+ # This avoids Windows file locking issues when Tempfiles are used
356
+ head = head_table
357
+ update_checksum_adjustment_in_io(io, head.offset) if head
358
+
359
+ io.pos
360
+ end
361
+
362
+ File.size(path)
363
+ end
364
+
365
+ # Validate format correctness
366
+ #
367
+ # @return [Boolean] true if the font format is valid, false otherwise
368
+ def valid?
369
+ return false unless header
370
+ return false unless tables.length == header.num_tables
371
+ return false unless head_table
372
+
373
+ true
374
+ end
375
+
376
+ # Check if font has a specific table (optimized with cache)
377
+ #
378
+ # @param tag [String] The table tag to check for
379
+ # @return [Boolean] true if table exists, false otherwise
380
+ def has_table?(tag)
381
+ !find_table_entry(tag).nil?
382
+ end
383
+
384
+ # Whether this object represents a font collection rather than a single
385
+ # font. Each font class is the authority on this question.
386
+ #
387
+ # @return [Boolean]
388
+ def collection? = false
389
+
390
+ # Variation profile of the font, derived from its table set. Used by the
391
+ # conversion pipeline to choose between preserving variation tables and
392
+ # generating a static instance.
393
+ #
394
+ # @return [Symbol] :static, :gvar (TrueType variable), or :cff2 (CFF2 variable)
395
+ def variation_type
396
+ return :static unless has_table?("fvar")
397
+ return :gvar if has_table?("gvar")
398
+ return :cff2 if has_table?("CFF2")
399
+
400
+ :static
401
+ end
402
+
403
+ # Outline representation used by the font. Derived from the table set.
404
+ #
405
+ # @return [Symbol] :truetype (glyf/gvar) or :cff (CFF/CFF2)
406
+ def outline_type
407
+ return :truetype if has_table?("glyf") || has_table?("gvar")
408
+ return :cff if has_table?("CFF ") || has_table?("CFF2")
409
+
410
+ :unknown
411
+ end
412
+
413
+ # Check if a table is available in the current loading mode
414
+ #
415
+ # @param tag [String] The table tag to check
416
+ # @return [Boolean] true if table is available in current mode
417
+ def table_available?(tag)
418
+ return false unless has_table?(tag)
419
+
420
+ LoadingModes.table_allowed?(@loading_mode, tag)
421
+ end
422
+
423
+ # Find a table entry by tag (cached for performance)
424
+ #
425
+ # @param tag [String] The table tag to find
426
+ # @return [TableDirectory, nil] The table entry or nil
427
+ def find_table_entry(tag)
428
+ return @table_entry_cache[tag] if @table_entry_cache.key?(tag)
429
+
430
+ entry = tables.find { |entry| entry.tag == tag }
431
+ @table_entry_cache[tag] = entry
432
+ entry
433
+ end
434
+
435
+ # Get the head table entry
436
+ #
437
+ # @return [TableDirectory, nil] The head table entry or nil
438
+ def head_table
439
+ find_table_entry(Constants::HEAD_TAG)
440
+ end
441
+
442
+ # Get list of all table tags (cached for performance)
443
+ #
444
+ # Returns plain UTF-8 Ruby Strings, not BinData::String instances —
445
+ # callers can rely on `eql?`/`==`/Hash lookup working against literal
446
+ # strings. BinData::String is encoding-sensitive and breaks Hash key
447
+ # comparison silently.
448
+ #
449
+ # @return [Array<String>] Array of table tag strings (UTF-8)
450
+ def table_names
451
+ @table_names ||= tables.map { |entry| normalize_tag(entry.tag) }
452
+ end
453
+
454
+ # Get OOP SfntTable instance for a table
455
+ #
456
+ # Returns a SfntTable (or subclass) instance that encapsulates the table's
457
+ # metadata, lazy loading, parsing, and validation. This provides a more
458
+ # object-oriented interface than the separate TableDirectory/@table_data/@parsed_tables
459
+ # approach.
460
+ #
461
+ # @param tag [String] The table tag to retrieve
462
+ # @return [SfntTable, nil] SfntTable instance (or subclass like HeadTable), or nil if not found
463
+ #
464
+ # @example Using SfntTable for validation
465
+ # head = font.sfnt_table("head")
466
+ # head.validate! # Performs head-specific validation
467
+ # head.units_per_em # => 2048 (convenience method)
468
+ def sfnt_table(tag)
469
+ # Return cached instance if available (fast path)
470
+ cached = @sfnt_tables[tag]
471
+ return cached if cached
472
+
473
+ # Only check has_table? if not cached (avoids redundant lookup)
474
+ return nil unless has_table?(tag)
475
+
476
+ # Create and cache (find_table_entry is already cached internally)
477
+ @sfnt_tables[tag] = create_sfnt_table(tag)
478
+ end
479
+
480
+ # Get all SfntTable instances
481
+ #
482
+ # @return [Hash<String, SfntTable>] Hash mapping tag => SfntTable instance
483
+ def all_sfnt_tables
484
+ table_names.to_h { |tag| [tag, sfnt_table(tag)] }
485
+ end
486
+
487
+ # Get parsed table instance
488
+ #
489
+ # This method parses the raw table data into a structured table object
490
+ # and caches the result for subsequent calls. Enforces mode restrictions.
491
+ #
492
+ # @param tag [String] The table tag to retrieve
493
+ # @return [Tables::*, nil] Parsed table object or nil if not found
494
+ # @raise [ArgumentError] if table is not available in current loading mode
495
+ def table(tag)
496
+ tag = normalize_tag(tag)
497
+
498
+ # Check mode restrictions
499
+ unless table_available?(tag)
500
+ if has_table?(tag)
501
+ raise ArgumentError,
502
+ "Table '#{tag}' is not available in #{@loading_mode} mode. " \
503
+ "Available tables: #{LoadingModes.tables_for(@loading_mode).inspect}"
504
+ else
505
+ return nil
506
+ end
507
+ end
508
+
509
+ # Return cached if available (fast path)
510
+ return @parsed_tables[tag] if @parsed_tables.key?(tag)
511
+
512
+ # Lazy load table data if enabled
513
+ load_table_data(tag) if @lazy_load_enabled && !@table_data.key?(tag)
514
+
515
+ # Parse and cache
516
+ @parsed_tables[tag] ||= parse_table(tag)
517
+ end
518
+
519
+ # Get units per em from head table
520
+ #
521
+ # @return [Integer, nil] Units per em value
522
+ def units_per_em
523
+ head = table(Constants::HEAD_TAG)
524
+ head&.units_per_em
525
+ end
526
+
527
+ # Convenience methods for accessing common name table fields
528
+ # These are particularly useful in minimal mode
529
+
530
+ # Get font family name
531
+ #
532
+ # @return [String, nil] Family name or nil if not found
533
+ def family_name
534
+ name_table = table(Constants::NAME_TAG)
535
+ name_table&.english_name(Tables::Name::FAMILY)
536
+ end
537
+
538
+ # Get font subfamily name (e.g., Regular, Bold, Italic)
539
+ #
540
+ # @return [String, nil] Subfamily name or nil if not found
541
+ def subfamily_name
542
+ name_table = table(Constants::NAME_TAG)
543
+ name_table&.english_name(Tables::Name::SUBFAMILY)
544
+ end
545
+
546
+ # Get full font name
547
+ #
548
+ # @return [String, nil] Full name or nil if not found
549
+ def full_name
550
+ name_table = table(Constants::NAME_TAG)
551
+ name_table&.english_name(Tables::Name::FULL_NAME)
552
+ end
553
+
554
+ # Get PostScript name
555
+ #
556
+ # @return [String, nil] PostScript name or nil if not found
557
+ def post_script_name
558
+ name_table = table(Constants::NAME_TAG)
559
+ name_table&.english_name(Tables::Name::POSTSCRIPT_NAME)
560
+ end
561
+
562
+ # Get preferred family name
563
+ #
564
+ # @return [String, nil] Preferred family name or nil if not found
565
+ def preferred_family_name
566
+ name_table = table(Constants::NAME_TAG)
567
+ name_table&.english_name(Tables::Name::PREFERRED_FAMILY)
568
+ end
569
+
570
+ # Get preferred subfamily name
571
+ #
572
+ # @return [String, nil] Preferred subfamily name or nil if not found
573
+ def preferred_subfamily_name
574
+ name_table = table(Constants::NAME_TAG)
575
+ name_table&.english_name(Tables::Name::PREFERRED_SUBFAMILY)
576
+ end
577
+
578
+ # Close the IO source (for lazy loading)
579
+ #
580
+ # @return [void]
581
+ def close
582
+ @io_source&.close
583
+ @io_source = nil
584
+ end
585
+
586
+ # Setup finalizer for cleanup
587
+ #
588
+ # @return [void]
589
+ def setup_finalizer
590
+ ObjectSpace.define_finalizer(self, self.class.finalize(@io_source))
591
+ end
592
+
593
+ # Finalizer proc for closing IO
594
+ #
595
+ # @param io [IO] The IO object to close
596
+ # @return [Proc] The finalizer proc
597
+ def self.finalize(io)
598
+ proc { io&.close }
599
+ end
600
+
601
+ # Update checksum adjustment in head table using IO
602
+ #
603
+ # Calculates the checksum of the entire file and writes the
604
+ # adjustment value to the head table's checksumAdjustment field.
605
+ #
606
+ # @param io [IO] IO object to read from and write to
607
+ # @param head_offset [Integer] Offset to the head table
608
+ # @return [void]
609
+ def update_checksum_adjustment_in_io(io, head_offset)
610
+ io.rewind
611
+ checksum = Utilities::ChecksumCalculator.calculate_checksum_from_io(io)
612
+ adjustment = Utilities::ChecksumCalculator.calculate_adjustment(checksum)
613
+ io.seek(head_offset + 8)
614
+ io.write([adjustment].pack("N"))
615
+ end
616
+
617
+ # Update checksum adjustment in head table by file path
618
+ #
619
+ # Opens the file, calculates the checksum, and updates the adjustment.
620
+ #
621
+ # @param path [String] Path to the font file
622
+ # @param head_offset [Integer] Offset to the head table
623
+ # @return [void]
624
+ def update_checksum_adjustment_in_file(path, head_offset)
625
+ File.open(path, "r+b") do |io|
626
+ update_checksum_adjustment_in_io(io, head_offset)
627
+ end
628
+ end
629
+
630
+ private
631
+
632
+ # Normalize tag encoding to UTF-8 (cached for performance)
633
+ #
634
+ # @param tag [String] The tag to normalize
635
+ # @return [String] UTF-8 encoded tag
636
+ def normalize_tag(tag)
637
+ (@tag_encoding_cache ||= {})[tag] ||= tag.dup.force_encoding("UTF-8")
638
+ end
639
+
640
+ # Load a single table's data on demand
641
+ #
642
+ # Uses direct seek-and-read for minimal overhead. This ensures lazy loading
643
+ # performance is comparable to eager loading when accessing all tables.
644
+ #
645
+ # @param tag [String] The table tag to load
646
+ # @return [void]
647
+ def load_table_data(tag)
648
+ return unless @io_source
649
+
650
+ entry = find_table_entry(tag)
651
+ return nil unless entry
652
+
653
+ # Direct seek and read - same as eager loading but on-demand
654
+ @io_source.seek(entry.offset)
655
+ tag_key = normalize_tag(tag)
656
+ @table_data[tag_key] = @io_source.read(entry.table_length)
657
+ end
658
+
659
+ # Parse a table from raw data
660
+ #
661
+ # @param tag [String] The table tag to parse
662
+ # @return [Tables::*, nil] Parsed table object or nil
663
+ def parse_table(tag)
664
+ raw_data = @table_data[tag]
665
+ return nil unless raw_data
666
+
667
+ table_class = table_class_for(tag)
668
+ return nil unless table_class
669
+
670
+ table_class.read(raw_data)
671
+ end
672
+
673
+ # Map table tag to SfntTable wrapper class
674
+ #
675
+ # @param tag [String] The table tag
676
+ # @return [SfntTable, nil] SfntTable instance or nil
677
+ def create_sfnt_table(tag)
678
+ entry = find_table_entry(tag)
679
+ return nil unless entry
680
+
681
+ # Use hash lookup for O(1) dispatch instead of case statement
682
+ table_class = SFNT_TABLE_CLASS_MAP[tag] || SfntTable
683
+ table_class.new(self, entry)
684
+ end
685
+
686
+ # Map table tag to parser class
687
+ #
688
+ # @param tag [String] The table tag
689
+ # @return [Class, nil] Table parser class or nil
690
+ def table_class_for(tag)
691
+ TABLE_CLASS_MAP[tag]
692
+ end
693
+
694
+ # Write the structure (header + table directory) to IO
695
+ #
696
+ # @param io [IO] Open file handle
697
+ # @return [void]
698
+ def write_structure(io)
699
+ # Write header
700
+ header.write(io)
701
+
702
+ # Write table directory with placeholder offsets
703
+ tables.each do |entry|
704
+ io.write(entry.tag)
705
+ io.write([entry.checksum].pack("N"))
706
+ io.write([0].pack("N")) # Placeholder offset
707
+ io.write([entry.table_length].pack("N"))
708
+ end
709
+ end
710
+
711
+ # Write table data and update offsets in directory
712
+ #
713
+ # @param io [IO] Open file handle
714
+ # @return [void]
715
+ def write_table_data_with_offsets(io)
716
+ tables.each_with_index do |entry, index|
717
+ # Record current position
718
+ current_position = io.pos
719
+
720
+ # Write table data
721
+ data = @table_data[entry.tag]
722
+ raise IOError, "Missing table data for tag '#{entry.tag}'" if data.nil?
723
+
724
+ io.write(data)
725
+
726
+ # Add padding to align to 4-byte boundary
727
+ padding = Utilities::Padding.boundary(io.pos)
728
+ io.write(PADDING_BYTES[0, padding]) if padding.positive?
729
+
730
+ # Zero out checksumAdjustment field in head table
731
+ if entry.tag == Constants::HEAD_TAG
732
+ current_pos = io.pos
733
+ io.seek(current_position + 8)
734
+ io.write([0].pack("N"))
735
+ io.seek(current_pos)
736
+ end
737
+
738
+ # Update offset in table directory
739
+ # Table directory starts at byte 12, each entry is 16 bytes
740
+ # Offset field is at byte 8 within each entry
741
+ directory_offset_position = 12 + (index * 16) + 8
742
+ current_pos = io.pos
743
+ io.seek(directory_offset_position)
744
+ io.write([current_position].pack("N")) # Offset is now known
745
+ io.seek(current_pos)
746
+ end
747
+ end
748
+ end
749
+ end