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,1111 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "thor"
4
+
5
+ module Fontisan
6
+ # Command-line interface for Fontisan.
7
+ #
8
+ # This class provides the Thor-based CLI with commands for extracting
9
+ # font information and listing tables. It supports multiple output formats
10
+ # (text, YAML, JSON) and various options for controlling output behavior.
11
+ #
12
+ # @example Run the info command
13
+ # Fontisan::Cli.start(['info', 'font.ttf'])
14
+ class Cli < Thor
15
+ # A Thor::Error (unknown command, missing --output) must fail the process:
16
+ # without this Thor exits 0 and prints a deprecation warning.
17
+ def self.exit_on_failure?
18
+ true
19
+ end
20
+
21
+ class_option :format, type: :string, default: "text",
22
+ desc: "Output format (text, yaml, json)",
23
+ aliases: "-f"
24
+ class_option :font_index, type: :numeric, default: 0,
25
+ desc: "Font index for TTC files",
26
+ aliases: "-i"
27
+ class_option :verbose, type: :boolean, default: false,
28
+ desc: "Enable verbose output",
29
+ aliases: "-v"
30
+ class_option :quiet, type: :boolean, default: false,
31
+ desc: "Suppress non-error output",
32
+ aliases: "-q"
33
+
34
+ desc "ufo", "UFO source operations (build, convert, validate)"
35
+ subcommand "ufo", Fontisan::Ufo::Cli
36
+
37
+ desc "stitch", "Stitch glyphs from multiple source fonts into one output"
38
+ subcommand "stitch", StitcherCli
39
+
40
+ desc "audit FONT_FILE", "Produce a structured audit report (identity, style, coverage, layout)"
41
+ option :output, type: :string,
42
+ desc: "Output file path. For collections, use a directory path."
43
+ option :no_codepoints, type: :boolean, default: false,
44
+ desc: "Omit the codepoint list from the report"
45
+ option :font_index, type: :numeric, default: nil,
46
+ desc: "Audit only the given face of a collection"
47
+ option :validate, type: :string, default: nil,
48
+ desc: "Run validation checks. Use 'true' for all, or a " \
49
+ "profile name: default, structural, ots, layout, " \
50
+ "variable, hinting, web, spec, per_table"
51
+ option :list_profiles, type: :boolean, default: false,
52
+ desc: "List available validation profiles and exit"
53
+ option :fail_on_error, type: :boolean, default: true,
54
+ desc: "Exit with code 1 if validation finds errors " \
55
+ "(only applies with --validate)"
56
+ # Produce a structured font audit report (YAML or JSON).
57
+ def audit(font_file = nil)
58
+ return list_audit_profiles if options[:list_profiles]
59
+
60
+ raise Thor::Error, "FONT_FILE is required" if font_file.nil?
61
+
62
+ cmd_options = options.dup
63
+ cmd_options[:include_codepoints] = !options[:no_codepoints]
64
+ cmd_options[:validate] = parse_validate_option(options[:validate])
65
+ command = Commands::AuditCommand.new(font_file, cmd_options)
66
+ result = command.run
67
+ write_audit_result(result, options[:output])
68
+ exit_on_validation_errors(result) if options[:validate] && options[:fail_on_error]
69
+ rescue Errno::ENOENT
70
+ warn "File not found: #{font_file}" unless options[:quiet]
71
+ exit 1
72
+ end
73
+
74
+ desc "info PATH", "Display font information"
75
+ option :brief, type: :boolean, default: false,
76
+ desc: "Brief mode - only essential info (5x faster, uses metadata loading)",
77
+ aliases: "-b"
78
+ # Extract and display comprehensive font metadata.
79
+ #
80
+ # @param path [String] Path to the font file or collection
81
+ def info(path)
82
+ command = Commands::InfoCommand.new(path, options)
83
+ info = command.run
84
+ output_result(info) unless options[:quiet]
85
+ rescue Errno::ENOENT
86
+ if options[:verbose]
87
+ raise
88
+ else
89
+ warn "File not found: #{path}" unless options[:quiet]
90
+ exit 1
91
+ end
92
+ end
93
+
94
+ desc "ls FILE", "List contents (fonts in collection or font summary)"
95
+ # List contents of font files with auto-detection.
96
+ #
97
+ # For collections (TTC/OTC): Lists all fonts in the collection
98
+ # For individual fonts (TTF/OTF): Shows quick font summary
99
+ #
100
+ # @param file [String] Path to the font or collection file
101
+ #
102
+ # @example List fonts in collection
103
+ # fontisan ls fonts.ttc
104
+ #
105
+ # @example Show font summary
106
+ # fontisan ls font.ttf
107
+ def ls(file)
108
+ command = Commands::LsCommand.new(file, options)
109
+ result = command.run
110
+ output_result(result)
111
+ rescue Errno::ENOENT, Error => e
112
+ handle_error(e)
113
+ end
114
+
115
+ desc "tables FONT_FILE", "List OpenType tables"
116
+ # List all OpenType tables in the font file.
117
+ #
118
+ # @param font_file [String] Path to the font file
119
+ def tables(font_file)
120
+ command = Commands::TablesCommand.new(font_file, options)
121
+ result = command.run
122
+ output_result(result)
123
+ rescue Errno::ENOENT, Error => e
124
+ handle_error(e)
125
+ end
126
+
127
+ desc "glyphs FONT_FILE", "List glyph names"
128
+ # List glyph names from the font file.
129
+ #
130
+ # @param font_file [String] Path to the font file
131
+ def glyphs(font_file)
132
+ command = Commands::GlyphsCommand.new(font_file, options)
133
+ result = command.run
134
+ output_result(result)
135
+ rescue Errno::ENOENT, Error => e
136
+ handle_error(e)
137
+ end
138
+
139
+ desc "unicode FONT_FILE", "List Unicode to glyph mappings"
140
+ # List Unicode to glyph index mappings from the font file.
141
+ #
142
+ # @param font_file [String] Path to the font file
143
+ def unicode(font_file)
144
+ command = Commands::UnicodeCommand.new(font_file, options)
145
+ result = command.run
146
+ output_result(result)
147
+ rescue Errno::ENOENT, Error => e
148
+ handle_error(e)
149
+ end
150
+
151
+ desc "variable FONT_FILE", "Display variable font information"
152
+ # Display variable font variation axes and instances.
153
+ #
154
+ # @param font_file [String] Path to the font file
155
+ def variable(font_file)
156
+ command = Commands::VariableCommand.new(font_file, options)
157
+ result = command.run
158
+ output_result(result)
159
+ rescue Errno::ENOENT, Error => e
160
+ handle_error(e)
161
+ end
162
+
163
+ desc "optical-size FONT_FILE", "Display optical size information"
164
+ # Display optical size information from the font file.
165
+ #
166
+ # @param font_file [String] Path to the font file
167
+ def optical_size(font_file)
168
+ command = Commands::OpticalSizeCommand.new(font_file, options)
169
+ result = command.run
170
+ output_result(result)
171
+ rescue Errno::ENOENT, Error => e
172
+ handle_error(e)
173
+ end
174
+
175
+ desc "scripts FONT_FILE", "List supported scripts from GSUB/GPOS tables"
176
+ # List all scripts supported by the font from GSUB and GPOS tables.
177
+ #
178
+ # @param font_file [String] Path to the font file
179
+ def scripts(font_file)
180
+ command = Commands::ScriptsCommand.new(font_file, options)
181
+ result = command.run
182
+ output_result(result)
183
+ rescue Errno::ENOENT, Error => e
184
+ handle_error(e)
185
+ end
186
+
187
+ desc "features FONT_FILE", "List GSUB/GPOS features"
188
+ option :script, type: :string,
189
+ desc: "Script tag to query (e.g., latn, cyrl, arab). If not specified, shows features for all scripts",
190
+ aliases: "-s"
191
+ # List OpenType features available for scripts.
192
+ # If no script is specified, shows features for all scripts.
193
+ #
194
+ # @param font_file [String] Path to the font file
195
+ def features(font_file)
196
+ command = Commands::FeaturesCommand.new(font_file, options)
197
+ result = command.run
198
+ output_result(result)
199
+ rescue Errno::ENOENT, Error => e
200
+ handle_error(e)
201
+ end
202
+
203
+ desc "subset FONT_FILE", "Subset a font to specific glyphs"
204
+ option :text, type: :string,
205
+ desc: "Text to subset (e.g., 'Hello World')",
206
+ aliases: "-t"
207
+ option :glyphs, type: :string,
208
+ desc: "Comma-separated glyph IDs (e.g., '0,1,65,66,67')",
209
+ aliases: "-g"
210
+ option :unicode, type: :string,
211
+ desc: "Comma-separated Unicode codepoints (e.g., 'U+0041,U+0042' or '0x41,0x42')",
212
+ aliases: "-u"
213
+ option :output, type: :string, required: true,
214
+ desc: "Output file path",
215
+ aliases: "-o"
216
+ option :profile, type: :string, default: "pdf",
217
+ desc: "Subsetting profile (pdf, web, minimal)",
218
+ aliases: "-p"
219
+ option :retain_gids, type: :boolean, default: false,
220
+ desc: "Retain original glyph IDs (leave gaps)"
221
+ option :drop_hints, type: :boolean, default: false,
222
+ desc: "Drop hinting instructions"
223
+ option :drop_names, type: :boolean, default: false,
224
+ desc: "Drop glyph names from post table"
225
+ option :unicode_ranges, type: :boolean, default: true,
226
+ desc: "Prune OS/2 Unicode ranges"
227
+ # Subset a font to specific glyphs.
228
+ #
229
+ # You must specify one of --text, --glyphs, or --unicode to define
230
+ # which glyphs to include in the subset.
231
+ #
232
+ # @param font_file [String] Path to the font file
233
+ def subset(font_file)
234
+ command = Commands::SubsetCommand.new(font_file, options)
235
+ result = command.run_routed
236
+
237
+ unless options[:quiet]
238
+ puts "Subset font created:"
239
+ puts " Input: #{result[:input]}"
240
+ puts " Output: #{result[:output]}"
241
+ puts " Original glyphs: #{result[:original_glyphs]}"
242
+ puts " Subset glyphs: #{result[:subset_glyphs]}"
243
+ puts " Profile: #{result[:profile]}"
244
+ puts " Size: #{format_size(result[:size])}"
245
+ end
246
+ rescue Errno::ENOENT, Error => e
247
+ handle_error(e)
248
+ end
249
+
250
+ desc "convert FONT_FILE", "Convert font to different format"
251
+ option :to, type: :array, required: true,
252
+ desc: "Target format(s): ttf, otf, type1, t1, ttc, otc, dfont, svg, " \
253
+ "woff (zlib — works on all browsers incl. legacy), " \
254
+ "woff2 (Brotli — ~30% smaller, modern browsers only). " \
255
+ "Pass multiple times (--to woff --to woff2) or comma-separated " \
256
+ "(--to woff,woff2) for multi-format output.",
257
+ aliases: "-t"
258
+ option :output, type: :string,
259
+ desc: "Output file path (required unless --show-options)",
260
+ aliases: "-o"
261
+ option :coordinates, type: :string,
262
+ desc: "Instance coordinates (e.g., wght=700,wdth=100)",
263
+ aliases: "-c"
264
+ option :instance_index, type: :numeric,
265
+ desc: "Named instance index",
266
+ aliases: "-n"
267
+ option :preserve_variation, type: :boolean,
268
+ desc: "Force variation preservation (auto-detected by default)"
269
+ option :no_validate, type: :boolean, default: false,
270
+ desc: "Skip output validation"
271
+ option :preserve_hints, type: :boolean, default: false,
272
+ desc: "Preserve rendering hints during conversion (TTF→OTF preservations may be limited)"
273
+ option :target_format, type: :string, default: "preserve",
274
+ desc: "Target outline format for collections: preserve (default), ttf, or otf"
275
+ option :wght, type: :numeric,
276
+ desc: "Weight axis value (alternative to --coordinates)"
277
+ option :wdth, type: :numeric,
278
+ desc: "Width axis value (alternative to --coordinates)"
279
+ option :slnt, type: :numeric,
280
+ desc: "Slant axis value (alternative to --coordinates)"
281
+ option :ital, type: :numeric,
282
+ desc: "Italic axis value (alternative to --coordinates)"
283
+ option :opsz, type: :numeric,
284
+ desc: "Optical size axis value (alternative to --coordinates)"
285
+ # Conversion options
286
+ option :preset, type: :string,
287
+ desc: "Use named preset (type1_to_modern, modern_to_type1, web_optimized, archive_to_modern)"
288
+ option :show_options, type: :boolean, default: false,
289
+ desc: "Show recommended options for the conversion and exit"
290
+ option :decompose, type: :boolean,
291
+ desc: "Decompose composite glyphs (opening option)"
292
+ option :convert_curves, type: :boolean,
293
+ desc: "Convert curves during conversion (opening option)"
294
+ option :scale_to_1000, type: :boolean,
295
+ desc: "Scale to 1000 units per em (opening option)"
296
+ option :autohint, type: :boolean,
297
+ desc: "Auto-hint the font (opening option)"
298
+ option :generate_unicode, type: :boolean,
299
+ desc: "Generate Unicode mappings (Type 1 opening option)"
300
+ option :hinting_mode, type: :string,
301
+ desc: "Hinting mode: preserve, auto, none, or full"
302
+ option :optimize_cff, type: :boolean,
303
+ desc: "Enable CFF subroutine optimization"
304
+ option :optimize_tables, type: :boolean,
305
+ desc: "Enable table optimization"
306
+ option :decompose_on_output, type: :boolean,
307
+ desc: "Decompose on output (generating option)"
308
+ # Compression knobs — declared by each strategy (single source of truth:
309
+ # Converters::* strategies). Cross-format misuse is caught at convert time
310
+ # by FormatConverter.validate_options_for_target! with a clear ArgumentError.
311
+ option :zlib_level, type: :numeric,
312
+ desc: "WOFF only: zlib compression level (0–9, default 6)"
313
+ option :uncompressed, type: :boolean,
314
+ desc: "WOFF only: store tables uncompressed (legal per WOFF 1.0 §5.1)"
315
+ option :compression_threshold, type: :numeric,
316
+ desc: "WOFF only: skip compression for tables smaller than N bytes (default 100)"
317
+ option :brotli_quality, type: :numeric,
318
+ desc: "WOFF2 only: Brotli quality (0–11, default 11)"
319
+ option :transform_tables, type: :boolean,
320
+ desc: "WOFF2 only: apply glyf/loca and hmtx transformations"
321
+ # Convert a font to a different format using the universal transformation pipeline.
322
+ #
323
+ # Supported conversions:
324
+ # - TTF ↔ OTF: Outline format conversion
325
+ # - Type 1 ↔ TTF/OTF: Adobe Type 1 font conversion
326
+ # - WOFF/WOFF2: Web font packaging
327
+ # - Variable fonts: Automatic variation preservation or instance generation
328
+ # - Collections (TTC/OTC/dfont): Preserve mixed TTF+OTF by default, or standardize with --target-format
329
+ #
330
+ # Web fonts — WOFF vs WOFF2:
331
+ # WOFF uses zlib compression and works on every browser that supports
332
+ # web fonts at all (IE9+, all evergreen browsers). WOFF2 uses Brotli and
333
+ # is ~30% smaller but requires modern browsers (Chrome 36+, Firefox 39+,
334
+ # Safari 12+, Edge 14+). Old browsers cannot decode Brotli, so for legacy
335
+ # support serve WOFF. Tune knobs with --zlib-level / --brotli-quality /
336
+ # --uncompressed (WOFF only) / --transform-tables (WOFF2 only).
337
+ #
338
+ # Collection Format Support:
339
+ # TTC, OTC, and dfont all support mixed TrueType and OpenType fonts. By default, original font formats
340
+ # are preserved during collection conversion (--target-format preserve). Use --target-format ttf to
341
+ # convert all fonts to TrueType, or --target-format otf to convert all to OpenType/CFF.
342
+ #
343
+ # Variable Font Operations:
344
+ # The pipeline automatically detects whether variation data can be preserved based on
345
+ # source and target formats. For same outline family (TTF→WOFF or OTF→WOFF2), variation
346
+ # is preserved automatically. For cross-family conversions (TTF↔OTF), an instance is
347
+ # generated unless --preserve-variation is explicitly set.
348
+ #
349
+ # Instance Generation:
350
+ # Use --coordinates to specify exact axis values (e.g., wght=700,wdth=100) or
351
+ # --instance-index to use a named instance. Individual axis options (--wght, --wdth)
352
+ # are also supported for convenience.
353
+ #
354
+ # @param font_file [String] Path to the font file
355
+ #
356
+ # @example Convert TTF to OTF
357
+ # fontisan convert font.ttf --to otf --output font.otf
358
+ #
359
+ # @example Convert Type 1 to OTF
360
+ # fontisan convert font.pfb --to otf --output font.otf
361
+ #
362
+ # @example Convert OTF to Type 1
363
+ # fontisan convert font.otf --to type1 --output font.pfb
364
+ #
365
+ # @example Convert TTC to OTC (preserves mixed formats by default)
366
+ # fontisan convert family.ttc --to otc --output family.otc
367
+ #
368
+ # @example Convert TTC to OTC with all fonts as TrueType
369
+ # fontisan convert family.ttc --to otc --output family.otc --target-format ttf
370
+ #
371
+ # @example Convert TTC to OTC with all fonts as OpenType/CFF
372
+ # fontisan convert family.ttc --to otc --output family.otc --target-format otf
373
+ #
374
+ # @example Generate bold instance at specific coordinates
375
+ # fontisan convert variable.ttf --to ttf --output bold.ttf --coordinates "wght=700,wdth=100"
376
+ #
377
+ # @example Generate bold instance using individual axis options
378
+ # fontisan convert variable.ttf --to ttf --output bold.ttf --wght 700
379
+ #
380
+ # @example Use named instance
381
+ # fontisan convert variable.ttf --to woff2 --output bold.woff2 --instance-index 0
382
+ #
383
+ # @example Force variation preservation (if compatible)
384
+ # fontisan convert variable.ttf --to woff2 --output variable.woff2 --preserve-variation
385
+ #
386
+ # @example Convert without validation
387
+ # fontisan convert font.ttf --to otf --output font.otf --no-validate
388
+ #
389
+ # @example Use named preset
390
+ # fontisan convert font.pfb --to otf --output font.otf --preset type1_to_modern
391
+ #
392
+ # @example Show recommended options for conversion
393
+ # fontisan convert font.ttf --to otf --show-options
394
+ #
395
+ # @example Convert with custom options
396
+ # fontisan convert font.ttf --to otf --output font.otf --autohint --hinting-mode auto
397
+ def convert(font_file)
398
+ # Detect source format from file
399
+ source_format = detect_source_format(font_file)
400
+
401
+ # Handle --show-options
402
+ if options[:show_options]
403
+ show_recommended_options(source_format,
404
+ options[:to].is_a?(Array) ? options[:to].first : options[:to])
405
+ return
406
+ end
407
+
408
+ # Validate output is provided when not using --show-options
409
+ unless options[:output]
410
+ raise Thor::Error, "Output path is required. Use --output option."
411
+ end
412
+
413
+ # Build ConversionOptions
414
+ conv_options = build_conversion_options(source_format,
415
+ Array(options[:to]).first,
416
+ options)
417
+
418
+ # Build instance coordinates from axis options
419
+ instance_coords = build_instance_coordinates(options)
420
+
421
+ # Merge coordinates and ConversionOptions into convert_options
422
+ convert_options = options.to_h.dup
423
+ if instance_coords.any?
424
+ convert_options[:instance_coordinates] = instance_coords
425
+ end
426
+
427
+ # Add ConversionOptions if built
428
+ convert_options[:options] = conv_options if conv_options
429
+
430
+ command = Commands::ConvertCommand.new(font_file, convert_options)
431
+ command.run_routed
432
+ rescue Errno::ENOENT, Error => e
433
+ handle_error(e)
434
+ end
435
+
436
+ desc "instance FONT_FILE",
437
+ "Generate static font instance from variable font"
438
+ option :output, type: :string,
439
+ desc: "Output file path",
440
+ aliases: "-o"
441
+ option :wght, type: :numeric,
442
+ desc: "Weight axis value"
443
+ option :wdth, type: :numeric,
444
+ desc: "Width axis value"
445
+ option :slnt, type: :numeric,
446
+ desc: "Slant axis value"
447
+ option :ital, type: :numeric,
448
+ desc: "Italic axis value"
449
+ option :opsz, type: :numeric,
450
+ desc: "Optical size axis value"
451
+ option :named_instance, type: :string,
452
+ desc: "Use named instance by fvar index (e.g., 0, 1; see --list-instances)",
453
+ aliases: "-n"
454
+ option :list_instances, type: :boolean, default: false,
455
+ desc: "List available named instances",
456
+ aliases: "-l"
457
+ option :to, type: :string,
458
+ desc: "Convert to format (ttf, otf, woff, woff2, svg)",
459
+ aliases: "-t"
460
+ # Generate static font instance from variable font.
461
+ #
462
+ # You can specify axis coordinates using --wght, --wdth, etc., or use
463
+ # a predefined named instance with --named-instance. Use --list-instances
464
+ # to see available named instances.
465
+ #
466
+ # @param font_file [String] Path to the variable font file
467
+ #
468
+ # @example Generate bold instance
469
+ # fontisan instance variable.ttf --wght=700 --output=bold.ttf
470
+ #
471
+ # @example Use named instance
472
+ # fontisan instance variable.ttf --named-instance=0 --output=bold.ttf
473
+ #
474
+ # @example Instance with format conversion
475
+ # fontisan instance variable.ttf --wght=700 --to=woff2 --output=bold.woff2
476
+ #
477
+ # @example List available instances
478
+ # fontisan instance variable.ttf --list-instances
479
+ def instance(font_file)
480
+ command = Commands::InstanceCommand.new
481
+ command.execute(font_file, options)
482
+ rescue Errno::ENOENT, Error => e
483
+ handle_error(e)
484
+ end
485
+
486
+ desc "dump-table FONT_FILE TABLE_TAG", "Dump raw table data to stdout"
487
+ # Dump raw binary table data to stdout.
488
+ #
489
+ # @param font_file [String] Path to the font file
490
+ # @param table_tag [String] Four-character table tag (e.g., 'name', 'head')
491
+ def dump_table(font_file, table_tag)
492
+ command = Commands::DumpTableCommand.new(font_file, table_tag, options)
493
+ raw_data = command.run
494
+
495
+ # Write binary data directly to stdout
496
+ $stdout.binmode
497
+ $stdout.write(raw_data)
498
+ rescue Errno::ENOENT, Error => e
499
+ handle_error(e)
500
+ end
501
+
502
+ desc "validate [FONT_FILE]", "Validate font file"
503
+ long_desc <<-DESC
504
+ Validate font file against quality checks and standards.
505
+
506
+ Supports individual fonts (TTF/OTF) and font collections (TTC/OTC/dfont).
507
+ For collections, validates each font and provides a summary report.
508
+
509
+ Profiles (-p/--profile):
510
+ indexability - Fast indexing validation (metadata only, 8 checks)
511
+ usability - Installation compatibility
512
+ production - Comprehensive quality (default)
513
+ web - Web font readiness
514
+ spec_compliance - OpenType spec compliance
515
+ default - Production profile (alias)
516
+
517
+ Collection validation with profiles:
518
+ When validating TTC/OTC/dfont collections, the selected profile
519
+ determines which tables are loaded and which checks are performed
520
+ for each font in the collection. Use 'indexability' for quick
521
+ validation or 'production' for comprehensive quality checks.
522
+
523
+ Return values (with -R/--return-value-results):
524
+ 0 No results
525
+ 1 Execution errors
526
+ 2 Fatal errors found
527
+ 3 Major errors found
528
+ 4 Minor errors found
529
+ 5 Spec violations found
530
+ DESC
531
+
532
+ option :exclude, aliases: "-e", type: :array, desc: "Tests to exclude"
533
+ option :list, aliases: "-l", type: :boolean, desc: "List available profiles"
534
+ option :output, aliases: "-o", type: :string, desc: "Output file"
535
+ option :full_report, aliases: "-r", type: :boolean, desc: "Full report"
536
+ option :return_value_results, aliases: "-R", type: :boolean,
537
+ desc: "Use return value for results"
538
+ option :summary_report, aliases: "-S", type: :boolean,
539
+ desc: "Summary report"
540
+ option :profile, aliases: "-p", type: :string, default: "default",
541
+ desc: "Validation profile"
542
+ option :table_report, aliases: "-T", type: :boolean, desc: "Tabular report"
543
+ option :verbose, aliases: "-v", type: :boolean, desc: "Verbose output"
544
+ option :suppress_warnings, aliases: "-W", type: :boolean,
545
+ desc: "Suppress warnings"
546
+
547
+ def validate(*font_files)
548
+ if options[:list]
549
+ list_available_tests
550
+ return
551
+ end
552
+
553
+ # Validate argument count
554
+ if font_files.empty?
555
+ raise(Thor::Error, "FONT_FILE is required unless using --list")
556
+ elsif font_files.size > 1
557
+ raise(Thor::Error,
558
+ "Too many arguments. validate accepts only one font file.\n" \
559
+ "To validate multiple files, run validate separately for each.\n" \
560
+ "To validate all fonts in a collection, use: fontisan validate collection.ttc")
561
+ end
562
+
563
+ font_file = font_files.first
564
+
565
+ cmd = Commands::ValidateCommand.new(
566
+ input: font_file,
567
+ profile: options[:profile],
568
+ exclude: options[:exclude] || [],
569
+ output: options[:output],
570
+ format: options[:format].to_sym,
571
+ full_report: options[:full_report],
572
+ summary_report: options[:summary_report],
573
+ table_report: options[:table_report],
574
+ verbose: options[:verbose],
575
+ suppress_warnings: options[:suppress_warnings],
576
+ return_value_results: options[:return_value_results],
577
+ )
578
+
579
+ exit cmd.run
580
+ rescue Thor::Error => e
581
+ unless options[:quiet]
582
+ warn "ERROR: #{e.message}"
583
+ warn
584
+ help("validate")
585
+ end
586
+ exit 1
587
+ rescue StandardError => e
588
+ error "Validation failed: #{e.message}"
589
+ exit 1
590
+ end
591
+
592
+ desc "export FONT_FILE", "Export font to TTX/YAML/JSON format"
593
+ option :output, type: :string,
594
+ desc: "Output file path (default: stdout)",
595
+ aliases: "-o"
596
+ option :format, type: :string, default: "yaml",
597
+ desc: "Export format (yaml, json, ttx)",
598
+ aliases: "-f"
599
+ option :tables, type: :array,
600
+ desc: "Specific tables to export",
601
+ aliases: "-t"
602
+ option :binary_format, type: :string, default: "hex",
603
+ desc: "Binary encoding (hex, base64)",
604
+ aliases: "-b"
605
+
606
+ def export(font_file)
607
+ command = Commands::ExportCommand.new(
608
+ input: font_file,
609
+ output: options[:output],
610
+ format: options[:format].to_sym,
611
+ tables: options[:tables],
612
+ binary_format: options[:binary_format].to_sym,
613
+ )
614
+ exit command.run
615
+ end
616
+
617
+ desc "validate-collection PATH",
618
+ "Validate a TTC/OTC/dfont (face count, glyph cap, cmap union)"
619
+ option :expected_faces, type: :numeric,
620
+ desc: "Required face count"
621
+ option :max_glyphs, type: :numeric, default: Fontisan::Commands::ValidateCollectionCommand::DEFAULT_MAX_GLYPHS,
622
+ desc: "Per-face glyph cap"
623
+ option :expected_cmap_union, type: :numeric,
624
+ desc: "Minimum cmap union size across all faces"
625
+ def validate_collection(path)
626
+ cmd = Commands::ValidateCollectionCommand.new(
627
+ input: path,
628
+ expected_faces: options[:expected_faces],
629
+ max_glyphs: options[:max_glyphs],
630
+ expected_cmap_union: options[:expected_cmap_union],
631
+ )
632
+ exit cmd.run
633
+ rescue ArgumentError => e
634
+ warn "ERROR: #{e.message}"
635
+ exit 1
636
+ end
637
+
638
+ desc "version", "Display version information"
639
+ # Display the Fontisan version.
640
+ def version
641
+ puts "Fontisan version #{Fontisan::VERSION}"
642
+ end
643
+
644
+ desc "unpack FONT_FILE", "Unpack fonts from TTC/OTC collection"
645
+ option :output_dir, type: :string, required: true,
646
+ desc: "Output directory for extracted fonts",
647
+ aliases: "-d"
648
+ option :font_index, type: :numeric,
649
+ desc: "Extract specific font by index (default: extract all)",
650
+ aliases: "-i"
651
+ option :format, type: :string,
652
+ desc: "Output format (ttf, otf, woff, woff2)",
653
+ aliases: "-f"
654
+ option :prefix, type: :string,
655
+ desc: "Filename prefix for extracted fonts",
656
+ aliases: "-p"
657
+ # Extract individual fonts from a TTC (TrueType Collection) or OTC (OpenType Collection) file.
658
+ #
659
+ # This command unpacks fonts from collection files, optionally converting them
660
+ # to different formats during extraction.
661
+ #
662
+ # @param font_file [String] Path to the TTC/OTC collection file
663
+ #
664
+ # @example Extract all fonts to directory
665
+ # fontisan unpack family.ttc --output-dir extracted/
666
+ #
667
+ # @example Extract specific font by index
668
+ # fontisan unpack family.ttc --output-dir extracted/ --font-index 0
669
+ #
670
+ # @example Extract with format conversion
671
+ # fontisan unpack family.ttc --output-dir extracted/ --format woff2
672
+ #
673
+ # @example Extract with custom prefix
674
+ # fontisan unpack family.ttc --output-dir extracted/ --prefix "NotoSans"
675
+ def unpack(font_file)
676
+ command = Commands::UnpackCommand.new(font_file, options)
677
+ result = command.run_routed
678
+
679
+ unless options[:quiet]
680
+ puts "Collection unpacked successfully:"
681
+ puts " Input: #{result[:collection]}"
682
+ puts " Output directory: #{result[:output_dir]}"
683
+ puts " Fonts extracted: #{result[:fonts_extracted]}/#{result[:num_fonts]}"
684
+ result[:extracted_files].each do |file|
685
+ size = File.size(file)
686
+ puts " - #{File.basename(file)} (#{format_size(size)})"
687
+ end
688
+ end
689
+ rescue Errno::ENOENT, Error => e
690
+ handle_error(e)
691
+ end
692
+
693
+ desc "pack FONT_FILES...", "Pack multiple fonts into TTC/OTC collection"
694
+ option :output, type: :string, required: true,
695
+ desc: "Output collection file path",
696
+ aliases: "-o"
697
+ option :format, type: :string, default: "ttc",
698
+ desc: "Collection format (ttc, otc, dfont)",
699
+ aliases: "-f"
700
+ option :optimize, type: :boolean, default: true,
701
+ desc: "Enable table sharing optimization",
702
+ aliases: "--optimize"
703
+ option :analyze, type: :boolean, default: false,
704
+ desc: "Show analysis report before building",
705
+ aliases: "--analyze"
706
+ # Create a TTC (TrueType Collection), OTC (OpenType Collection), or dfont (Apple Data Fork Font) from multiple font files.
707
+ #
708
+ # This command combines multiple fonts into a single collection file with
709
+ # shared table deduplication to save space. It supports TTC, OTC, and dfont formats.
710
+ #
711
+ # @param font_files [Array<String>] Paths to input font files (minimum 2 required)
712
+ #
713
+ # @example Pack fonts into TTC
714
+ # fontisan pack font1.ttf font2.ttf font3.ttf --output family.ttc
715
+ #
716
+ # @example Pack into OTC with analysis
717
+ # fontisan pack Regular.otf Bold.otf Italic.otf --output family.otc --analyze
718
+ #
719
+ # @example Pack into dfont (Apple suitcase)
720
+ # fontisan pack font1.ttf font2.otf --output family.dfont --format dfont
721
+ #
722
+ # @example Pack without optimization
723
+ # fontisan pack font1.ttf font2.ttf --output collection.ttc --no-optimize
724
+ def pack(*font_files)
725
+ command = Commands::PackCommand.new(font_files, options)
726
+ result = command.run
727
+
728
+ unless options[:quiet]
729
+ puts "Collection created successfully:"
730
+ puts " Output: #{result[:output_path] || result[:output]}"
731
+ puts " Format: #{result[:format].upcase}"
732
+ puts " Fonts: #{result[:num_fonts]}"
733
+ puts " Size: #{format_size(result[:output_size] || result[:total_size])}"
734
+ if result[:space_savings]&.positive?
735
+ puts " Space saved: #{format_size(result[:space_savings])}"
736
+ puts " Sharing: #{result[:statistics][:sharing_percentage]}%"
737
+ end
738
+ end
739
+ rescue Errno::ENOENT, Error => e
740
+ handle_error(e)
741
+ end
742
+
743
+ private
744
+
745
+ # Build instance coordinates from CLI axis options
746
+ #
747
+ # @param options [Hash] CLI options
748
+ # @return [Hash] Coordinates hash
749
+ def build_instance_coordinates(options)
750
+ coords = {}
751
+ coords["wght"] = options[:wght].to_f if options[:wght]
752
+ coords["wdth"] = options[:wdth].to_f if options[:wdth]
753
+ coords["slnt"] = options[:slnt].to_f if options[:slnt]
754
+ coords["ital"] = options[:ital].to_f if options[:ital]
755
+ coords["opsz"] = options[:opsz].to_f if options[:opsz]
756
+ coords
757
+ end
758
+
759
+ # Output the result in the requested format.
760
+ #
761
+ # @param result [Object] The result object to output
762
+ def output_result(result)
763
+ output = case options[:format]
764
+ when "yaml"
765
+ result.to_yaml
766
+ when "json"
767
+ result.to_json
768
+ else
769
+ format_as_text(result)
770
+ end
771
+
772
+ puts output unless options[:quiet]
773
+ end
774
+
775
+ # Write the audit result to stdout or a file. For a single report,
776
+ # the output path (if given) is the file path. For a collection,
777
+ # the output path is a directory; each face is written as
778
+ # `{font_index:02d}-{postscript_name}.yaml`.
779
+ def write_audit_result(result, output_path)
780
+ if result.is_a?(Array)
781
+ write_audit_collection(result, output_path)
782
+ else
783
+ write_audit_single(result, output_path)
784
+ end
785
+ end
786
+
787
+ def write_audit_single(report, output_path)
788
+ content = serialize_audit(report)
789
+ if output_path
790
+ FileUtils.mkpath(File.dirname(output_path)) unless File.dirname(output_path) == "."
791
+ File.write(output_path, content)
792
+ else
793
+ puts content unless options[:quiet]
794
+ end
795
+ end
796
+
797
+ def write_audit_collection(reports, output_path)
798
+ if output_path
799
+ FileUtils.mkpath(output_path)
800
+ reports.each do |report|
801
+ name = audit_face_filename(report)
802
+ File.write(File.join(output_path, name), serialize_audit(report))
803
+ end
804
+ say("Wrote #{reports.size} reports to #{output_path}") unless options[:quiet]
805
+ else
806
+ puts serialize_audit(reports) unless options[:quiet]
807
+ end
808
+ end
809
+
810
+ def serialize_audit(report)
811
+ case options[:format]
812
+ when "json" then report.to_json
813
+ when "text", nil then format_audit_as_text(report)
814
+ else report.to_yaml
815
+ end
816
+ end
817
+
818
+ # Format an AuditReport as human-readable text for terminal use.
819
+ # Groups fields into sections: provenance, identity, style,
820
+ # coverage, layout, validation summary.
821
+ def format_audit_as_text(report)
822
+ lines = []
823
+ lines << "=== Font Audit Report ==="
824
+ lines.concat(format_audit_provenance(report))
825
+ lines.concat(format_audit_identity(report))
826
+ lines.concat(format_audit_style(report))
827
+ lines.concat(format_audit_coverage(report))
828
+ lines.concat(format_audit_layout(report))
829
+ lines.concat(format_audit_validation(report))
830
+ lines.join("\n")
831
+ end
832
+
833
+ def format_audit_provenance(report)
834
+ lines = []
835
+ lines << " Source: #{report.source_file}"
836
+ lines << " Format: #{report.source_format}"
837
+ lines << " SHA256: #{report.source_sha256[0, 16]}..." if report.source_sha256
838
+ lines << " Fontisan: #{report.fontisan_version}" if report.fontisan_version
839
+ lines << ""
840
+ end
841
+
842
+ def format_audit_identity(report)
843
+ lines = ["Identity:"]
844
+ lines << " Family: #{report.family_name}"
845
+ lines << " Subfamily: #{report.subfamily_name}"
846
+ lines << " Full: #{report.full_name}"
847
+ lines << " PostScript: #{report.postscript_name}"
848
+ lines << " Version: #{report.version}"
849
+ lines << ""
850
+ end
851
+
852
+ def format_audit_style(report)
853
+ lines = ["Style:"]
854
+ lines << " Weight: #{report.weight_class}"
855
+ lines << " Width: #{report.width_class}"
856
+ lines << " Italic: #{report.italic}"
857
+ lines << " Bold: #{report.bold}"
858
+ lines << " Variable: #{report.is_variable}"
859
+ report.axes&.each do |axis|
860
+ lines << " #{axis.tag}: #{axis.min_value}–#{axis.max_value} " \
861
+ "(default #{axis.default_value})"
862
+ end
863
+ lines << ""
864
+ end
865
+
866
+ def format_audit_coverage(report)
867
+ lines = ["Coverage:"]
868
+ lines << " Glyphs: #{report.total_glyphs}"
869
+ lines << " Codepoints: #{report.total_codepoints}"
870
+ lines << " cmap subtables: #{report.cmap_subtables&.join(', ')}" if report.cmap_subtables&.any?
871
+ lines << ""
872
+ end
873
+
874
+ def format_audit_layout(report)
875
+ scripts = report.opentype_scripts
876
+ features = report.features
877
+ return [] unless scripts&.any? || features&.any?
878
+
879
+ lines = ["Layout:"]
880
+ lines << " Scripts: #{scripts&.join(', ')}" if scripts&.any?
881
+ lines << " Features: #{features&.join(', ')}" if features&.any?
882
+ lines << ""
883
+ end
884
+
885
+ def format_audit_validation(report)
886
+ summary = report.validation_summary
887
+ return [] unless summary
888
+
889
+ lines = ["Validation:"]
890
+ lines << " Errors: #{summary.error_count}"
891
+ lines << " Warnings: #{summary.warning_count}"
892
+ lines << " Info: #{summary.info_count}"
893
+ result = summary.passed ? "PASSED" : "FAILED"
894
+ lines << " Result: #{result}"
895
+ lines << ""
896
+ report.validation_issues&.each do |issue|
897
+ lines << " [#{issue.severity.upcase}] #{issue.category}: #{issue.message}"
898
+ end
899
+ lines
900
+ end
901
+
902
+ def audit_face_filename(report)
903
+ safe_name = report.postscript_name&.gsub(%r{[^A-Za-z0-9._-]}, "_") || "font"
904
+ suffix = options[:format] == "json" ? "json" : "yaml"
905
+ idx = report.font_index || 0
906
+ format("%<idx>02d-%<name>s.%<suffix>s", idx: idx, name: safe_name, suffix: suffix)
907
+ end
908
+
909
+ # The --validate option is either nil (no validation), "true" (run all
910
+ # checks), or a profile name (e.g. "ots", "structural").
911
+ def parse_validate_option(raw)
912
+ return nil if raw.nil? || raw.empty?
913
+ return true if raw == "true"
914
+
915
+ raw.to_sym
916
+ end
917
+
918
+ # Print available validation profiles with their check counts.
919
+ def list_audit_profiles
920
+ puts "Available validation profiles for --validate:"
921
+ puts ""
922
+ Audit::CheckRegistry::PROFILES.each do |name, codes|
923
+ puts " #{name.to_s.ljust(15)} #{codes.size} checks"
924
+ end
925
+ puts ""
926
+ puts "Usage: fontisan audit font.ttf --validate <profile>"
927
+ puts " fontisan audit font.ttf --validate true (all checks)"
928
+ end
929
+
930
+ # Exit with code 1 if the audit found error-level issues.
931
+ # For collections, aggregates across all faces.
932
+ def exit_on_validation_errors(result)
933
+ issues = if result.is_a?(Array)
934
+ result.flat_map(&:validation_issues)
935
+ else
936
+ result.validation_issues || []
937
+ end
938
+ has_errors = issues.any? { |i| %w[error fatal].include?(i.severity) }
939
+ return unless has_errors
940
+
941
+ error_count = issues.count { |i| %w[error fatal].include?(i.severity) }
942
+ warn "Audit found #{error_count} error(s) — exiting with code 1"
943
+ exit 1
944
+ end
945
+
946
+ def serialize_report(report, format)
947
+ format == :json ? report.to_json : report.to_yaml
948
+ end
949
+
950
+ # Format result as human-readable text.
951
+ #
952
+ # @param result [Object] The result object to format
953
+ # @return [String] Formatted text output
954
+ def format_as_text(result)
955
+ formatter = Formatters::TextFormatter.new
956
+ formatter.format(result)
957
+ end
958
+
959
+ # Format file size in human-readable form
960
+ #
961
+ # @param size [Integer] Size in bytes
962
+ # @return [String] Formatted size
963
+ def format_size(size)
964
+ if size < 1024
965
+ "#{size} bytes"
966
+ elsif size < 1024 * 1024
967
+ "#{(size / 1024.0).round(2)} KB"
968
+ else
969
+ "#{(size / (1024.0 * 1024)).round(2)} MB"
970
+ end
971
+ end
972
+
973
+ # Handle errors based on verbosity settings.
974
+ #
975
+ # @param error [Error, Errno::ENOENT] The error to handle
976
+ def handle_error(error)
977
+ raise error if options[:verbose]
978
+
979
+ # Convert Errno::ENOENT to user-friendly message
980
+ if error.is_a?(Errno::ENOENT)
981
+ end
982
+ message = error.message
983
+
984
+ warn message unless options[:quiet]
985
+ exit 1
986
+ end
987
+
988
+ # List available validation tests/profiles
989
+ #
990
+ # @return [void]
991
+ def list_available_tests
992
+ profiles = Validators::ProfileLoader.all_profiles
993
+ puts "Available validation profiles:"
994
+ profiles.each do |profile_name, config|
995
+ puts " #{profile_name.to_s.ljust(20)} - #{config[:description]}"
996
+ end
997
+ end
998
+
999
+ # Detect source format from file extension
1000
+ #
1001
+ # @param font_file [String] Path to the font file
1002
+ # @return [Symbol] Detected format symbol
1003
+ def detect_source_format(font_file)
1004
+ ext = File.extname(font_file).downcase
1005
+ case ext
1006
+ when ".ttf"
1007
+ :ttf
1008
+ when ".otf"
1009
+ :otf
1010
+ when ".pfb", ".pfa"
1011
+ :type1
1012
+ when ".ttc"
1013
+ :ttc
1014
+ when ".otc"
1015
+ :otc
1016
+ when ".dfont"
1017
+ :dfont
1018
+ when ".woff"
1019
+ :woff
1020
+ when ".woff2"
1021
+ :woff2
1022
+ when ".svg"
1023
+ :svg
1024
+ else
1025
+ # Default to TTF for unknown extensions
1026
+ :ttf
1027
+ end
1028
+ end
1029
+
1030
+ # Show recommended options for a conversion
1031
+ #
1032
+ # @param source_format [Symbol] Source format
1033
+ # @param target_format_str [String] Target format string
1034
+ # @return [void]
1035
+ def show_recommended_options(source_format, target_format_str)
1036
+ target_format = Fontisan::ConversionOptions.normalize_format(target_format_str)
1037
+
1038
+ puts "\nRecommended options for #{source_format.to_s.upcase} → #{target_format.to_s.upcase} conversion:"
1039
+ puts "=" * 70
1040
+
1041
+ # Show recommended options
1042
+ recommended = Fontisan::ConversionOptions.recommended(from: source_format,
1043
+ to: target_format)
1044
+ puts "\nOpening options:"
1045
+ if recommended.opening.any?
1046
+ recommended.opening.each do |key, value|
1047
+ puts " --#{key.to_s.gsub('_', '-')}: #{value}"
1048
+ end
1049
+ else
1050
+ puts " (none)"
1051
+ end
1052
+
1053
+ puts "\nGenerating options:"
1054
+ if recommended.generating.any?
1055
+ recommended.generating.each do |key, value|
1056
+ puts " --#{key.to_s.gsub('_', '-')}: #{value}"
1057
+ end
1058
+ else
1059
+ puts " (none)"
1060
+ end
1061
+
1062
+ puts "\nAvailable presets:"
1063
+ Fontisan::ConversionOptions.available_presets.each do |preset|
1064
+ puts " #{preset}"
1065
+ end
1066
+
1067
+ puts "\nTo use preset:"
1068
+ puts " fontisan convert #{source_format} --to #{target_format} --preset <name> --output output.ext"
1069
+ puts "\n"
1070
+ end
1071
+
1072
+ # Build ConversionOptions from CLI options
1073
+ #
1074
+ # @param source_format [Symbol] Source format
1075
+ # @param target_format_str [String] Target format string
1076
+ # @param opts [Hash] CLI options
1077
+ # @return [ConversionOptions, nil] Built ConversionOptions or nil
1078
+ def build_conversion_options(source_format, target_format_str, opts)
1079
+ target_format = Fontisan::ConversionOptions.normalize_format(target_format_str)
1080
+
1081
+ # Use preset if specified
1082
+ if opts[:preset]
1083
+ return Fontisan::ConversionOptions.from_preset(opts[:preset])
1084
+ end
1085
+
1086
+ # Build opening options from CLI flags
1087
+ opening = {}
1088
+ opening[:decompose_composites] = true if opts[:decompose]
1089
+ opening[:convert_curves] = true if opts[:convert_curves]
1090
+ opening[:scale_to_1000] = true if opts[:scale_to_1000]
1091
+ opening[:autohint] = true if opts[:autohint]
1092
+ opening[:generate_unicode] = true if opts[:generate_unicode]
1093
+
1094
+ # Build generating options from CLI flags
1095
+ generating = {}
1096
+ generating[:hinting_mode] = opts[:hinting_mode] if opts[:hinting_mode]
1097
+ generating[:decompose_on_output] = true if opts[:decompose_on_output]
1098
+ generating[:optimize_tables] = true if opts[:optimize_tables]
1099
+
1100
+ # Only create ConversionOptions if any options were set
1101
+ return nil if opening.empty? && generating.empty?
1102
+
1103
+ Fontisan::ConversionOptions.new(
1104
+ from: source_format,
1105
+ to: target_format,
1106
+ opening: opening,
1107
+ generating: generating,
1108
+ )
1109
+ end
1110
+ end
1111
+ end