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,358 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "zlib"
4
+
5
+ module Fontisan
6
+ module Converters
7
+ # WOFF font writer for creating WOFF files from TTF/OTF fonts
8
+ #
9
+ # [`WoffWriter`](lib/fontisan/converters/woff_writer.rb) converts
10
+ # TrueType/OpenType fonts to WOFF 1.0 format. The WOFF spec mandates zlib
11
+ # compression; this writer exposes the spec-legal knobs only:
12
+ #
13
+ # - `zlib_level` (0–9) — zlib compression level
14
+ # - `uncompressed` (bool) — store tables uncompressed (legal per WOFF 1.0
15
+ # §5.1; `compLength == origLength`). Metadata is still compressed per
16
+ # spec §7 ("it is never stored in uncompressed form").
17
+ # - `compression_threshold` (bytes) — skip compression for tables smaller
18
+ # than N bytes (rarely needed; keeps tiny tables uncompressed)
19
+ # - `metadata_xml` (string) — optional metadata block
20
+ # - `private_data` (string) — optional private data block
21
+ #
22
+ # Cross-format options (e.g., `brotli_quality`) are rejected by
23
+ # ConversionStrategy#validate_options! — see {ConversionStrategy}.
24
+ #
25
+ # @example Convert TTF to WOFF with max zlib
26
+ # writer = WoffWriter.new
27
+ # woff = writer.convert(ttf_font, zlib_level: 9)
28
+ # File.binwrite("out.woff", woff)
29
+ #
30
+ # @example Uncompressed WOFF (legal per spec; useful for tooling pipelines)
31
+ # writer = WoffWriter.new
32
+ # woff = writer.convert(ttf_font, uncompressed: true)
33
+ class WoffWriter
34
+ include ConversionStrategy
35
+
36
+ # WOFF signature constant
37
+ WOFF_SIGNATURE = 0x774F4646 # 'wOFF'
38
+
39
+ # WOFF version 1.0
40
+ WOFF_VERSION_MAJOR = 1
41
+ WOFF_VERSION_MINOR = 0
42
+
43
+ option :zlib_level, type: :integer, range: 0..9, default: 6,
44
+ cli: "--zlib-level=N",
45
+ desc: "zlib compression level (0=fastest, 9=smallest)"
46
+ option :uncompressed, type: :boolean, default: false,
47
+ cli: "--uncompressed",
48
+ desc: "store tables uncompressed (legal per WOFF 1.0 §5.1)"
49
+ option :compression_threshold, type: :integer,
50
+ range: 0..(2**31 - 1),
51
+ default: 100,
52
+ cli: "--compression-threshold=N",
53
+ desc: "skip compression for tables smaller than N bytes"
54
+ option :metadata_xml, type: :string, default: nil,
55
+ cli: "--metadata-xml=XML",
56
+ desc: "optional metadata XML block"
57
+ option :private_data, type: :string, default: nil,
58
+ cli: "--private-data=DATA",
59
+ desc: "optional private data block"
60
+
61
+ # Initialize writer. The writer is stateless per call; all knobs come
62
+ # through the per-convert options hash.
63
+ def initialize; end
64
+
65
+ # Convert font to WOFF format.
66
+ #
67
+ # @param font [TrueTypeFont, OpenTypeFont] Source font
68
+ # @param options [Hash{Symbol => Object}] Per-call options; see declared
69
+ # options above. Unknown keys (framework metadata like
70
+ # `target_format`) are tolerated silently. Cross-format misuse
71
+ # (`brotli_quality` on a WOFF target) is caught upstream by
72
+ # `FormatConverter.validate_options_for_target!`.
73
+ # @return [String] WOFF file data as binary string
74
+ # @raise [ArgumentError] if any declared option fails validation
75
+ # @raise [ArgumentError] if font does not respond to required methods
76
+ def convert(font, options = {})
77
+ self.class.validate_options!(strategy_options(options))
78
+ validate(font, :woff)
79
+
80
+ opts = self.class.default_options.merge(strategy_options(options))
81
+ write_font(
82
+ font,
83
+ zlib_level: opts[:zlib_level],
84
+ uncompressed: opts[:uncompressed],
85
+ compression_threshold: opts[:compression_threshold],
86
+ metadata: opts[:metadata_xml],
87
+ private_data: opts[:private_data],
88
+ )[:woff_binary]
89
+ end
90
+
91
+ # Get supported conversions.
92
+ #
93
+ # @return [Array<Array<Symbol>>] Pairs this strategy handles
94
+ def supported_conversions
95
+ [
96
+ %i[ttf woff],
97
+ %i[otf woff],
98
+ ]
99
+ end
100
+
101
+ # Validate that the given font can be converted to WOFF.
102
+ #
103
+ # @param font [Object] Font to validate
104
+ # @param target_format [Symbol] Must be :woff
105
+ # @return [Boolean]
106
+ # @raise [ArgumentError] if font is nil or missing required methods
107
+ # @raise [Fontisan::Error] if target_format is not :woff
108
+ def validate(font, target_format)
109
+ unless target_format == :woff
110
+ raise Fontisan::Error,
111
+ "WoffWriter only supports conversion to woff, got: #{target_format}"
112
+ end
113
+
114
+ raise ArgumentError, "Font cannot be nil" if font.nil?
115
+
116
+ unless font.is_a?(SfntSource)
117
+ raise ArgumentError, "Font must be an SfntSource instance"
118
+ end
119
+ end
120
+
121
+ # Write font to WOFF binary.
122
+ #
123
+ # Layout per WOFF 1.0 spec:
124
+ # [header (44)] [table directory (20 × N)] [font tables, 4-byte aligned]
125
+ # [optional metadata, 4-byte aligned] [optional private data, 4-byte aligned]
126
+ #
127
+ # Each font table is padded with 0-3 null bytes to a 4-byte boundary
128
+ # (spec §5/§6: "Font data tables in the WOFF file have the same
129
+ # requirement: they MUST begin on 4-byte boundaries and be zero-padded
130
+ # to the next 4-byte boundary"). Padding aligns the next block.
131
+ #
132
+ # @param font [TrueTypeFont, OpenTypeFont] Source font
133
+ # @param zlib_level [Integer] 0–9
134
+ # @param uncompressed [Boolean] skip zlib; store tables as-is
135
+ # @param compression_threshold [Integer] skip compression below N bytes
136
+ # @param metadata [String, nil] optional metadata XML (always compressed
137
+ # per spec §7 — "it is never stored in uncompressed form")
138
+ # @param private_data [String, nil] optional private data
139
+ # @return [Hash{Symbol => String}] `{ woff_binary: <bytes> }`
140
+ def write_font(font, zlib_level:, uncompressed:, compression_threshold:,
141
+ metadata: nil, private_data: nil)
142
+ tables = collect_tables_data(font)
143
+ compressed_tables = compress_tables(
144
+ tables,
145
+ zlib_level: uncompressed ? 0 : zlib_level,
146
+ skip_compression: uncompressed,
147
+ compression_threshold: compression_threshold,
148
+ )
149
+ # Per spec §7, metadata MUST always be zlib-compressed regardless of
150
+ # the per-table `uncompressed` flag.
151
+ compressed_metadata = compress_metadata(metadata, zlib_level:)
152
+ binary = build_woff_file(compressed_tables, font, compressed_metadata,
153
+ private_data)
154
+ { woff_binary: binary }
155
+ end
156
+
157
+ private
158
+
159
+ # Slice options to those declared by this strategy. Tolerates extra
160
+ # keys (e.g., `target_format`) silently so FormatConverter can pass the
161
+ # full options hash through.
162
+ def strategy_options(options)
163
+ names = self.class.supported_options.to_set(&:name)
164
+ options.select { |k, _| names.include?(k.to_sym) }
165
+ end
166
+
167
+ # Collect all table data from font, sorted ascending by tag (WOFF 1.0
168
+ # §5: the table directory MUST be sorted by tag; data follows directory
169
+ # order). Input-font order is not preserved.
170
+ #
171
+ # @param font [TrueTypeFont, OpenTypeFont]
172
+ # @return [Hash<String, String>]
173
+ def collect_tables_data(font)
174
+ font.table_names.sort.each_with_object({}) do |tag, h|
175
+ data = font.table_data[tag]
176
+ h[tag] = data if data
177
+ end
178
+ end
179
+
180
+ # Compress tables with zlib (or skip compression entirely).
181
+ #
182
+ # @param tables_data [Hash<String, String>]
183
+ # @param zlib_level [Integer] 0–9 (ignored if skip_compression)
184
+ # @param skip_compression [Boolean] store all tables uncompressed
185
+ # @param compression_threshold [Integer] tables below this size are kept
186
+ # uncompressed even when skip_compression is false
187
+ # @return [Hash<String, Hash>] per-table compressed info
188
+ def compress_tables(tables_data, zlib_level:, skip_compression:,
189
+ compression_threshold:)
190
+ tables_data.to_h do |tag, data|
191
+ original_size = data.bytesize
192
+ should_compress =
193
+ !skip_compression && original_size >= compression_threshold
194
+
195
+ if should_compress
196
+ compressed = Zlib::Deflate.deflate(data, zlib_level)
197
+ use_compressed = compressed.bytesize < original_size
198
+ else
199
+ use_compressed = false
200
+ end
201
+
202
+ [
203
+ tag,
204
+ {
205
+ original_data: data,
206
+ compressed_data: use_compressed ? compressed : data,
207
+ original_length: original_size,
208
+ compressed_length: use_compressed ? compressed.bytesize : original_size,
209
+ is_compressed: use_compressed,
210
+ },
211
+ ]
212
+ end
213
+ end
214
+
215
+ # Compress metadata with zlib. Per spec §7, metadata MUST always be
216
+ # zlib-compressed — `skip_compression` is intentionally not exposed
217
+ # here. The zlib output is used even when it is larger than the input
218
+ # (e.g. tiny XML payloads where zlib header+checksum overhead exceeds
219
+ # any compression gain); the spec mandates compression, not optimality.
220
+ # Returns nil if no metadata was supplied.
221
+ #
222
+ # @param metadata [String, nil]
223
+ # @param zlib_level [Integer]
224
+ # @return [Hash, nil]
225
+ def compress_metadata(metadata, zlib_level:)
226
+ return nil unless metadata
227
+
228
+ original_length = metadata.bytesize
229
+ compressed = Zlib::Deflate.deflate(metadata, zlib_level)
230
+ {
231
+ original_data: metadata,
232
+ compressed_data: compressed,
233
+ original_length: original_length,
234
+ compressed_length: compressed.bytesize,
235
+ }
236
+ end
237
+
238
+ # Assemble complete WOFF binary.
239
+ #
240
+ # Computes the full layout (offsets + padding) up front so the header
241
+ # fields (metaOffset, privOffset) point to the correct locations, then
242
+ # emits header → directory → tables → optional metadata → optional
243
+ # private data.
244
+ #
245
+ # @param compressed_tables [Hash<String, Hash>] sorted by tag
246
+ # @param font [TrueTypeFont, OpenTypeFont]
247
+ # @param compressed_metadata [Hash, nil]
248
+ # @param private_data [String, nil]
249
+ # @return [String]
250
+ def build_woff_file(compressed_tables, font, compressed_metadata,
251
+ private_data)
252
+ header_size = 44
253
+ num_tables = compressed_tables.length
254
+ data_start = header_size + (num_tables * 20)
255
+
256
+ # Lay out tables in directory (tag) order with 4-byte alignment padding.
257
+ # Each entry: { tag:, info:, offset:, pad_bytes: }
258
+ entries = []
259
+ cursor = data_start
260
+ compressed_tables.each do |tag, info|
261
+ pad = Utilities::Padding.boundary(info[:compressed_length])
262
+ entries << { tag:, info:, offset: cursor, pad_bytes: "\x00" * pad }
263
+ cursor += info[:compressed_length] + pad
264
+ end
265
+ tables_end = cursor
266
+
267
+ metadata_size = compressed_metadata ? compressed_metadata[:compressed_length] : 0
268
+ # metaOffset/privOffset are 0 when their block is absent (spec §4:
269
+ # offsets to optional blocks; convention is 0 for "not present").
270
+ metadata_offset = compressed_metadata ? tables_end : 0
271
+ metadata_end = tables_end + metadata_size
272
+
273
+ private_size = private_data ? private_data.bytesize : 0
274
+ private_offset = private_data ? metadata_end : 0
275
+ total_size = metadata_end + private_size
276
+
277
+ # totalSfntSize: reconstructed SFNT size with per-table 4-byte padding.
278
+ # spec §4: "Total size needed for the uncompressed font data, including
279
+ # the sfnt header, directory, and font tables (including padding)."
280
+ sfnt_header_size = 12
281
+ sfnt_dir_size = num_tables * 16
282
+ sfnt_tables_size = compressed_tables.values.sum do |t|
283
+ Utilities::Padding.aligned_size(t[:original_length])
284
+ end
285
+ total_sfnt_size = sfnt_header_size + sfnt_dir_size + sfnt_tables_size
286
+
287
+ io = StringIO.new
288
+ io.set_encoding(Encoding::BINARY)
289
+ write_woff_header(
290
+ io, font, total_size, total_sfnt_size, num_tables,
291
+ compressed_metadata, metadata_offset, metadata_size,
292
+ private_offset, private_size
293
+ )
294
+ write_table_directory(io, entries)
295
+ write_compressed_table_data(io, entries)
296
+ write_metadata(io, compressed_metadata) if compressed_metadata
297
+ write_private_data(io, private_data) if private_data
298
+
299
+ io.string
300
+ end
301
+
302
+ # Write WOFF header (44 bytes).
303
+ def write_woff_header(io, font, total_size, total_sfnt_size, num_tables,
304
+ compressed_metadata, metadata_offset, metadata_size,
305
+ private_offset, private_size)
306
+ flavor = if font.is_a?(SfntSource) && font.cff?
307
+ Constants::SFNT_VERSION_OTTO
308
+ else
309
+ Constants::SFNT_VERSION_TRUETYPE
310
+ end
311
+
312
+ io.write([WOFF_SIGNATURE].pack("N")) # signature
313
+ io.write([flavor].pack("N")) # flavor
314
+ io.write([total_size].pack("N")) # length
315
+ io.write([num_tables].pack("n")) # numTables
316
+ io.write([0].pack("n")) # reserved
317
+ io.write([total_sfnt_size].pack("N")) # totalSfntSize
318
+ io.write([WOFF_VERSION_MAJOR].pack("n")) # majorVersion
319
+ io.write([WOFF_VERSION_MINOR].pack("n")) # minorVersion
320
+ io.write([metadata_offset].pack("N")) # metaOffset
321
+ io.write([metadata_size].pack("N")) # metaLength
322
+ io.write([compressed_metadata ? compressed_metadata[:original_length] : 0].pack("N")) # metaOrigLength
323
+ io.write([private_offset].pack("N")) # privOffset
324
+ io.write([private_size].pack("N")) # privLength
325
+ end
326
+
327
+ # Write table directory entries (20 bytes each), one per laid-out entry.
328
+ def write_table_directory(io, entries)
329
+ entries.each do |e|
330
+ checksum = Utilities::ChecksumCalculator
331
+ .calculate_table_checksum(e[:info][:original_data])
332
+ io.write(e[:tag]) # tag
333
+ io.write([e[:offset]].pack("N")) # offset
334
+ io.write([e[:info][:compressed_length]].pack("N")) # compLength
335
+ io.write([e[:info][:original_length]].pack("N")) # origLength
336
+ io.write([checksum].pack("N")) # origChecksum
337
+ end
338
+ end
339
+
340
+ # Write each table's compressed data followed by 4-byte alignment
341
+ # padding (spec §5/§6: tables MUST be zero-padded to next boundary).
342
+ def write_compressed_table_data(io, entries)
343
+ entries.each do |e|
344
+ io.write(e[:info][:compressed_data])
345
+ io.write(e[:pad_bytes])
346
+ end
347
+ end
348
+
349
+ def write_metadata(io, compressed_metadata)
350
+ io.write(compressed_metadata[:compressed_data])
351
+ end
352
+
353
+ def write_private_data(io, private_data)
354
+ io.write(private_data)
355
+ end
356
+ end
357
+ end
358
+ end
@@ -0,0 +1,21 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Autoload hub for the Fontisan::Converters namespace.
4
+
5
+ module Fontisan
6
+ module Converters
7
+ autoload :CffTableBuilder, "fontisan/converters/cff_table_builder"
8
+ autoload :CollectionConverter, "fontisan/converters/collection_converter"
9
+ autoload :ConversionStrategy, "fontisan/converters/conversion_strategy"
10
+ autoload :FormatConverter, "fontisan/converters/format_converter"
11
+ autoload :GlyfTableBuilder, "fontisan/converters/glyf_table_builder"
12
+ autoload :OutlineConverter, "fontisan/converters/outline_converter"
13
+ autoload :OutlineExtraction, "fontisan/converters/outline_extraction"
14
+ autoload :OutlineOptimizer, "fontisan/converters/outline_optimizer"
15
+ autoload :SvgGenerator, "fontisan/converters/svg_generator"
16
+ autoload :TableCopier, "fontisan/converters/table_copier"
17
+ autoload :Type1Converter, "fontisan/converters/type1_converter"
18
+ autoload :Woff2Encoder, "fontisan/converters/woff2_encoder"
19
+ autoload :WoffWriter, "fontisan/converters/woff_writer"
20
+ end
21
+ end
@@ -0,0 +1,288 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Fontisan
4
+ # DfontCollection represents an Apple dfont suitcase containing multiple fonts
5
+ #
6
+ # dfont (Data Fork Font) is an Apple-specific format that stores Mac font
7
+ # suitcase resources in the data fork. It can contain multiple SFNT fonts
8
+ # (TrueType or OpenType).
9
+ #
10
+ # This class provides a collection interface similar to TrueTypeCollection
11
+ # and OpenTypeCollection for consistency.
12
+ #
13
+ # @example Load dfont collection
14
+ # collection = DfontCollection.from_file("family.dfont")
15
+ # puts "Collection has #{collection.num_fonts} fonts"
16
+ #
17
+ # @example Extract fonts from dfont
18
+ # File.open("family.dfont", "rb") do |io|
19
+ # fonts = collection.extract_fonts(io)
20
+ # fonts.each { |font| puts font.class.name }
21
+ # end
22
+ class DfontCollection
23
+ include Collection::SharedLogic
24
+
25
+ # High-level pipeline format identifier. Owned by the collection class
26
+ # so the conversion pipeline can dispatch without case statements (OCP).
27
+ #
28
+ # @return [Symbol] :dfont
29
+ def format = :dfont
30
+
31
+ # Whether this object represents a font collection rather than a single
32
+ # font. Each font class is the authority on this question.
33
+ #
34
+ # @return [Boolean]
35
+ def collection? = true
36
+
37
+ # Variation profile. dfonts are containers; per-font variation is not
38
+ # exposed at the collection level.
39
+ #
40
+ # @return [Symbol] :static
41
+ def variation_type = :static
42
+
43
+ # Outline representation. dfonts may contain mixed-flavor fonts;
44
+ # per-font outline type requires loading an individual font.
45
+ #
46
+ # @return [Symbol] :unknown
47
+ def outline_type = :unknown
48
+
49
+ # Collections have no single SFNT table directory.
50
+ #
51
+ # @return [Array<String>] empty
52
+ def table_names = []
53
+
54
+ # Path to dfont file
55
+ # @return [String]
56
+ attr_reader :path
57
+
58
+ # Number of fonts in collection
59
+ # @return [Integer]
60
+ attr_reader :num_fonts
61
+ alias font_count num_fonts
62
+
63
+ # Get font offsets (indices for dfont)
64
+ #
65
+ # dfont doesn't use byte offsets like TTC/OTC, so we return indices
66
+ #
67
+ # @return [Array<Integer>] Array of font indices
68
+ def font_offsets
69
+ (0...@num_fonts).to_a
70
+ end
71
+
72
+ # Get the collection format identifier
73
+ #
74
+ # @return [String] "dfont" for dfont collection
75
+ def self.collection_format
76
+ "dfont"
77
+ end
78
+
79
+ # Load dfont collection from file
80
+ #
81
+ # @param path [String] Path to dfont file
82
+ # @return [DfontCollection] Collection object
83
+ # @raise [InvalidFontError] if not valid dfont
84
+ def self.from_file(path)
85
+ File.open(path, "rb") do |io|
86
+ unless Parsers::DfontParser.dfont?(io)
87
+ raise InvalidFontError, "Not a valid dfont file: #{path}"
88
+ end
89
+
90
+ num_fonts = Parsers::DfontParser.sfnt_count(io)
91
+ new(path, num_fonts)
92
+ end
93
+ end
94
+
95
+ # Initialize collection
96
+ #
97
+ # @param path [String] Path to dfont file
98
+ # @param num_fonts [Integer] Number of fonts
99
+ # @api private
100
+ def initialize(path, num_fonts)
101
+ @path = path
102
+ @num_fonts = num_fonts
103
+ end
104
+
105
+ # Check if collection is valid
106
+ #
107
+ # @return [Boolean] true if valid
108
+ def valid?
109
+ File.exist?(@path) && @num_fonts.positive?
110
+ end
111
+
112
+ # Get the collection version as a string
113
+ #
114
+ # dfont files don't have version numbers like TTC/OTC
115
+ #
116
+ # @return [String] Version string (always "N/A" for dfont)
117
+ def version_string
118
+ "N/A"
119
+ end
120
+
121
+ # Extract all fonts from dfont
122
+ #
123
+ # @param io [IO] Open file handle
124
+ # @return [Array<TrueTypeFont, OpenTypeFont>] Array of fonts
125
+ def extract_fonts(io)
126
+ require "stringio"
127
+
128
+ fonts = []
129
+
130
+ @num_fonts.times do |index|
131
+ io.rewind
132
+ sfnt_data = Parsers::DfontParser.extract_sfnt(io, index: index)
133
+
134
+ # Load font from SFNT binary
135
+ sfnt_io = StringIO.new(sfnt_data)
136
+ signature = sfnt_io.read(4)
137
+ sfnt_io.rewind
138
+
139
+ # Create font based on signature
140
+ font = case signature
141
+ when [Constants::SFNT_VERSION_TRUETYPE].pack("N"), "true"
142
+ TrueTypeFont.read(sfnt_io)
143
+ when "OTTO"
144
+ OpenTypeFont.read(sfnt_io)
145
+ else
146
+ raise InvalidFontError,
147
+ "Invalid SFNT signature in dfont at index #{index}: #{signature.inspect}"
148
+ end
149
+
150
+ font.initialize_storage
151
+ font.loading_mode = LoadingModes::FULL
152
+ font.lazy_load_enabled = false
153
+ font.read_table_data(sfnt_io)
154
+
155
+ fonts << font
156
+ end
157
+
158
+ fonts
159
+ end
160
+
161
+ # List fonts in collection (brief info)
162
+ #
163
+ # @param io [IO] Open file handle
164
+ # @return [Models::CollectionListInfo] Collection list info
165
+ def list_fonts(io)
166
+ fonts = extract_fonts(io)
167
+
168
+ summaries = fonts.map.with_index do |font, index|
169
+ name_table = font.table("name")
170
+ family = name_table.english_name(Models::Tables::Name::FAMILY) || "Unknown"
171
+ subfamily = name_table.english_name(Models::Tables::Name::SUBFAMILY) || "Regular"
172
+
173
+ # Detect font format
174
+ format = if font.has_table?("CFF ") || font.has_table?("CFF2")
175
+ "OpenType"
176
+ else
177
+ "TrueType"
178
+ end
179
+
180
+ Models::CollectionFontSummary.new(
181
+ index: index,
182
+ family_name: family,
183
+ subfamily_name: subfamily,
184
+ font_format: format,
185
+ )
186
+ end
187
+
188
+ Models::CollectionListInfo.new(
189
+ num_fonts: @num_fonts,
190
+ fonts: summaries,
191
+ )
192
+ end
193
+
194
+ # Get specific font from collection
195
+ #
196
+ # @param index [Integer] Font index
197
+ # @param io [IO] Open file handle
198
+ # @param mode [Symbol] Loading mode
199
+ # @return [TrueTypeFont, OpenTypeFont] Font object
200
+ # @raise [InvalidFontError] if index out of range
201
+ def font(index, io, mode: LoadingModes::FULL)
202
+ if index >= @num_fonts
203
+ raise InvalidFontError,
204
+ "Font index #{index} out of range (collection has #{@num_fonts} fonts)"
205
+ end
206
+
207
+ io.rewind
208
+ sfnt_data = Parsers::DfontParser.extract_sfnt(io, index: index)
209
+
210
+ # Load font from SFNT binary
211
+ require "stringio"
212
+ sfnt_io = StringIO.new(sfnt_data)
213
+ signature = sfnt_io.read(4)
214
+ sfnt_io.rewind
215
+
216
+ # Create font based on signature
217
+ font = case signature
218
+ when [Constants::SFNT_VERSION_TRUETYPE].pack("N"), "true"
219
+ TrueTypeFont.read(sfnt_io)
220
+ when "OTTO"
221
+ OpenTypeFont.read(sfnt_io)
222
+ else
223
+ raise InvalidFontError,
224
+ "Invalid SFNT signature: #{signature.inspect}"
225
+ end
226
+
227
+ font.initialize_storage
228
+ font.loading_mode = mode
229
+ font.lazy_load_enabled = false
230
+ font.read_table_data(sfnt_io)
231
+
232
+ font
233
+ end
234
+
235
+ # Get comprehensive collection metadata
236
+ #
237
+ # Returns a CollectionInfo model with header information and
238
+ # table sharing statistics for the dfont collection.
239
+ # This is the API method used by the `info` command for collections.
240
+ #
241
+ # @param io [IO] Open file handle to read fonts from
242
+ # @param path [String] Collection file path (for file size)
243
+ # @return [Models::CollectionInfo] Collection metadata
244
+ #
245
+ # @example Get collection info
246
+ # File.open("family.dfont", "rb") do |io|
247
+ # collection = DfontCollection.from_file("family.dfont")
248
+ # info = collection.collection_info(io, "family.dfont")
249
+ # puts "Format: #{info.collection_format}"
250
+ # end
251
+ def collection_info(io, path)
252
+ # Calculate table sharing statistics
253
+ table_sharing = calculate_table_sharing(io)
254
+
255
+ # Get file size
256
+ file_size = path ? File.size(path) : 0
257
+
258
+ Models::CollectionInfo.new(
259
+ collection_path: path,
260
+ collection_format: self.class.collection_format,
261
+ ttc_tag: "dfnt", # dfont doesn't use ttcf tag
262
+ major_version: 0, # dfont doesn't have version
263
+ minor_version: 0,
264
+ num_fonts: @num_fonts,
265
+ font_offsets: font_offsets,
266
+ file_size_bytes: file_size,
267
+ table_sharing: table_sharing,
268
+ )
269
+ end
270
+
271
+ private
272
+
273
+ # Calculate table sharing statistics
274
+ #
275
+ # Analyzes which tables are shared between fonts and calculates
276
+ # space savings from deduplication.
277
+ #
278
+ # @param io [IO] Open file handle
279
+ # @return [Models::TableSharingInfo] Sharing statistics
280
+ def calculate_table_sharing(io)
281
+ # Extract all fonts
282
+ fonts = extract_fonts(io)
283
+
284
+ # Use shared logic for calculation
285
+ calculate_table_sharing_for_fonts(fonts)
286
+ end
287
+ end
288
+ end