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,436 @@
1
+ = Stitcher Guide
2
+
3
+ == General
4
+
5
+ The Stitcher combines glyphs from multiple source fonts into one or
6
+ more new fonts. Sources can be UFO directories, loaded TTF/OTF files,
7
+ or any object responding to the `Ufo::Font` interface.
8
+
9
+ The design rule: **the user controls the collection structure
10
+ explicitly**. Every `include_*` method requires an `into:` keyword
11
+ naming the target subfont, and `write_to` requires a `subfont:` name.
12
+ There are no defaults and no after-the-fact splitting.
13
+
14
+ == API
15
+
16
+ [cols="2,3", options="header"]
17
+ |===
18
+ | Method | Purpose
19
+
20
+ | `Stitcher.new(deduplicate: true)` | Create a stitcher; dedup is on by default
21
+
22
+ | `add_source(label, font)` | Register a source font under a Symbol label
23
+
24
+ | `add_source(label, font, remap:)` | Register a source with a
25
+ `{src_codepoint => target_codepoint}` remap. Useful for donor
26
+ fonts whose glyphs live at non-canonical codepoints (PUA, ASCII-
27
+ mapped pre-Unicode fonts). Source codepoints not in the remap
28
+ are hidden — the donor's other coverage (often ASCII/PUA noise)
29
+ does not leak into the output.
30
+
31
+ | `include_range(range, from:, into:)` | Add codepoint range from `from` into `into`
32
+
33
+ | `include_codepoints(cps, from:, into:)` | Add an explicit Array of codepoints
34
+
35
+ | `include_codepoints_map(cp_map, into:)` | Add `{codepoint => donor}` for many codepoints and donors in one call
36
+
37
+ | `include_gid(donor_gid, from:, into:)` | Add a specific GID from the source
38
+
39
+ | `include_notdef(from:, into:)` | Convenience for `include_gid(0, ...)`
40
+
41
+ | `set_info(hash)` | Override font info (family name, etc.)
42
+
43
+ | `subfont_names` | List declared subfont names (insertion order)
44
+
45
+ | `write_to(path, format:, subfont:)` | Compile one subfont to a single file
46
+
47
+ | `write_collection(path, format:)` | Compile all declared subfonts into a TTC/OTC; returns a `CollectionResult`
48
+ |===
49
+
50
+ `format:` is one of `:ttf`, `:otf`, `:otf2`. For collections, `:ttf`
51
+ produces a `.ttc` and `:otf`/`:otf2` produce an `.otc`.
52
+
53
+ == Single-font example
54
+
55
+ [source,ruby]
56
+ ----
57
+ stitcher = Fontisan::Stitcher.new
58
+ stitcher.add_source(:latin, Fontisan::FontLoader.load("NotoSans.ttf"))
59
+ stitcher.add_source(:cjk, Fontisan::FontLoader.load("FSung-m.ttf"))
60
+
61
+ stitcher.include_notdef(from: :latin, into: :main)
62
+ stitcher.include_range(0x41..0x5A, from: :latin, into: :main) # A-Z
63
+ stitcher.include_range(0x4E00..0x9FFF, from: :cjk, into: :main) # CJK
64
+
65
+ stitcher.write_to("stitched.ttf", format: :ttf, subfont: :main)
66
+ ----
67
+
68
+ == Collection example (TTC/OTC)
69
+
70
+ When the total glyph count would exceed 65,535 (the OpenType
71
+ `maxp.numGlyphs` cap), split the work across named subfonts and write
72
+ a collection:
73
+
74
+ [source,ruby]
75
+ ----
76
+ stitcher = Fontisan::Stitcher.new
77
+ stitcher.add_source(:noto_sans, Fontisan::FontLoader.load("NotoSans.ttf"))
78
+ stitcher.add_source(:noto_cjk, Fontisan::FontLoader.load("NotoSansCJK.ttf"))
79
+
80
+ stitcher.include_range(0x41..0x5A, from: :noto_sans, into: :latin)
81
+ stitcher.include_range(0x4E00..0x9FFF, from: :noto_cjk, into: :cjk)
82
+
83
+ stitcher.write_collection("out.otc", format: :otf2)
84
+ ----
85
+
86
+ Each subfont is compiled independently, then packed by
87
+ `Collection::Builder` with table deduplication enabled — shared tables
88
+ (head, name, OS/2, ...) are stored once and referenced from each
89
+ subfont's offset table.
90
+
91
+ == Donor remap (non-canonical codepoints)
92
+
93
+ Some donor fonts ship glyphs at codepoints that don't match the
94
+ canonical Unicode assignment — a keyboard-mapped font whose letters
95
+ live at ASCII slots, or a PUA-allocated pre-Unicode font. Pass a
96
+ `remap:` hash to `add_source` to expose those glyphs at their
97
+ canonical targets without mutating the donor's cmap:
98
+
99
+ [source,ruby]
100
+ ----
101
+ donor = Fontisan::FontLoader.load("TolongSikiMappedToASCII.ttf")
102
+
103
+ stitcher = Fontisan::Stitcher.new
104
+ stitcher.add_source(:tolong_siki, donor, remap: {
105
+ 0x41 => 0x11DB0, # ASCII A → Tolong Siki KA
106
+ 0x42 => 0x11DB1, # ASCII B → Tolong Siki NGA
107
+ # ...
108
+ })
109
+ stitcher.include_codepoints((0x11DB0..0x11DC0).to_a,
110
+ from: :tolong_siki, into: :tolong)
111
+ ----
112
+
113
+ With a remap set, the source answers `gid_for_codepoint(target)`
114
+ by translating through the inverse remap to the donor's source
115
+ codepoint. Source codepoints not in the remap are hidden — only
116
+ remapped coverage is exposed.
117
+
118
+ The donor's cmap is never mutated. `remap:` is a translation layer
119
+ at the source's API boundary; multiple sources on the same
120
+ Stitcher can have different remaps (or none at all).
121
+
122
+ `write_collection` returns a `Stitcher::CollectionResult` Struct with
123
+ the output `path`, total `bytes`, and one `Stitcher::SubfontStats`
124
+ per declared subfont (`name`, `glyph_count`, `codepoint_count`). Stats
125
+ are read from the compiled on-disk face so they reflect what was
126
+ actually written — including glyphs the compiler adds (e.g. `.notdef`).
127
+
128
+ [source,ruby]
129
+ ----
130
+ result = stitcher.write_collection("out.otc", format: :otf2)
131
+ result.path # => "out.otc"
132
+ result.bytes # => File.size("out.otc")
133
+ result.face_count # => result.subfonts.size
134
+ result.subfonts.first.glyph_count # maxp.num_glyphs of face 0
135
+ result.subfonts.first.codepoint_count # cmap size of face 0
136
+ ----
137
+
138
+ == Donor maps (many codepoints, many donors, one call)
139
+
140
+ `include_codepoints_map(cp_map, into:)` takes a `{codepoint => donor}`
141
+ map and forwards each donor group to `include_codepoints` after sorting
142
+ the codepoints (reproducible GID assignment). Useful when the cp →
143
+ donor routing comes from an external plan (Unicode block table,
144
+ partitioner output, coverage analysis).
145
+
146
+ [source,ruby]
147
+ ----
148
+ cp_map = {
149
+ 0x41 => :latin,
150
+ 0x42 => :latin,
151
+ 0x4E00 => :cjk,
152
+ 0x4E01 => :cjk,
153
+ }
154
+ stitcher.include_codepoints_map(cp_map, into: :main)
155
+ # equivalent to:
156
+ # stitcher.include_codepoints([0x41, 0x42], from: :latin, into: :main)
157
+ # stitcher.include_codepoints([0x4E00, 0x4E01], from: :cjk, into: :main)
158
+ ----
159
+
160
+ == Codepoint partitioning (PartitionStrategy)
161
+
162
+ When the codepoint set is too large for one subfont (or when you want
163
+ to split by Unicode plane / block / script for organizational reasons),
164
+ `Stitcher::PartitionStrategy` provides ready-to-use partitioner classes
165
+ that produce a `Blueprint` (an ordered list of `Partition`s). Each
166
+ partition names a target subfont and carries its codepoints and
167
+ donor map.
168
+
169
+ The framework is open for new partitioners — adding one is a new file
170
+ under `lib/fontisan/stitcher/partition_strategy/` plus an autoload
171
+ entry. No edits to existing partitioners required (OCP).
172
+
173
+ === ByPlane
174
+
175
+ Groups codepoints by Unicode plane (`cp >> 16`). Each plane that fits
176
+ under the cap becomes one partition named `:plane_<n>` (e.g.
177
+ `:plane_0` for BMP, `:plane_2` for SIP). When a plane overflows the
178
+ cap, ByPlane sub-splits along the large CJK-extension block
179
+ boundaries (`CJK_Ext_B` through `CJK_Ext_F`), naming partitions
180
+ `:plane_<n>_a`, `:plane_<n>_b`, etc.
181
+
182
+ [source,ruby]
183
+ ----
184
+ require "fontisan/stitcher/partition_strategy"
185
+
186
+ cp_map = build_coverage_map # { codepoint => donor_label, ... }
187
+ blueprint = Fontisan::Stitcher::PartitionStrategy::ByPlane.new
188
+ .call(cp_map, cap: 65_484)
189
+
190
+ blueprint.names # => [:plane_0, :plane_2, ...]
191
+ blueprint.partitions # => [#<Partition name=:plane_0 cps=[...] ...>, ...]
192
+
193
+ # Push every partition's bindings into the Stitcher in one go:
194
+ declared = blueprint.apply_to(stitcher)
195
+ # declared == blueprint.names
196
+ ----
197
+
198
+ If a single CJK extension block alone exceeds `cap` (e.g. `CJK_Ext_B`
199
+ has ~6,592 codepoints and the cap is set to 5,000), ByPlane raises
200
+ `Fontisan::PartitionCapExceededError` — its codepoints are contiguous
201
+ and ByPlane has no finer-grained boundary to sub-split on. The caller
202
+ must either raise the cap, drop codepoints, or switch to a format
203
+ with a higher glyph limit.
204
+
205
+ The Unicode plane metadata used by ByPlane lives in
206
+ `Fontisan::Unicode::Plane` (`Plane.of(cp)`, `Plane.label(n)`).
207
+
208
+ The sub-plane block boundaries used for sub-splitting live on ByPlane
209
+ itself:
210
+
211
+ * `ByPlane::ATOMIC_BLOCKS` — five SIP CJK extension blocks that cannot
212
+ be sub-split; raise if one alone exceeds `cap`.
213
+ * `ByPlane::CARVE_OUT_BLOCKS` — BMP-resident blocks (CJK Unified
214
+ Ideographs, Hangul Syllables) that get their own partition bucket
215
+ when BMP overflows `cap`; chunkable, never raised.
216
+ * `ByPlane::RECOGNIZED_BLOCKS` — union of the two; the lookup table
217
+ the bucketing pass walks.
218
+
219
+ === Partition / Blueprint
220
+
221
+ A `Partition` is a `Struct.new(:name, :cps, :donor_map, keyword_init: true)`.
222
+ `Partition#apply_to(stitcher)` pushes its bindings via
223
+ `include_codepoints_map`.
224
+
225
+ A `Blueprint` is a `Struct.new(:partitions, keyword_init: true)`;
226
+ `Blueprint#apply_to(stitcher)` calls `apply_to` on each partition in
227
+ order and returns the list of declared subfont names.
228
+
229
+ === ByBlock — partition by Unicode Blocks.txt
230
+
231
+ `PartitionStrategy::ByBlock` partitions codepoints by their Unicode
232
+ block. Each non-empty block becomes one partition. The full Unicode
233
+ 16.0 block list (~340 entries covering BMP, SMP, SIP, TIP, SSP) is
234
+ inlined as `ByBlock::BLOCKS` so the partitioner is self-contained
235
+ (no external data file). Codepoints in unassigned planes fall into
236
+ `:block_other`.
237
+
238
+ [source,ruby]
239
+ ----
240
+ bp = Fontisan::Stitcher::PartitionStrategy::ByBlock.new
241
+ blueprint = bp.call(cp_map)
242
+ blueprint.names # => [:block_basic_latin, :block_cjk_unified_ideographs, ...]
243
+ ----
244
+
245
+ Every block is treated as atomic — if a single block alone exceeds
246
+ `cap`, ByBlock raises `PartitionCapExceededError` (callers must
247
+ either use ByPlane with carve-outs or implement a custom
248
+ partitioner).
249
+
250
+ === ByScript — partition by Unicode script property
251
+
252
+ `PartitionStrategy::ByScript` partitions codepoints by Unicode
253
+ script (Latin, Greek, Cyrillic, Han, Hangul, etc.). Derived from
254
+ `ByBlock::BLOCKS` via a `SCRIPT_OF_BLOCK` map — keeps the data DRY.
255
+
256
+ Scripts that overflow `cap` are chunked with alphabetic suffixes
257
+ matching ByPlane's sub-split convention (e.g. `:script_han`,
258
+ `:script_han_a`, `:script_han_b`). Common and Inherited scripts
259
+ get their own buckets — useful for separating shared punctuation
260
+ and combining marks.
261
+
262
+ [source,ruby]
263
+ ----
264
+ sp = Fontisan::Stitcher::PartitionStrategy::ByScript.new
265
+ blueprint = sp.call(cp_map)
266
+ blueprint.names # => [:script_common, :script_latin, :script_han, ...]
267
+ ----
268
+
269
+ === Choosing a strategy
270
+
271
+ |===
272
+ | Strategy | When to use
273
+
274
+ | `ByPlane`
275
+ | CJK-heavy fonts that need to respect the 65,535-glyph cap per
276
+ plane. Sub-splits only the SIP CJK extensions and the BMP
277
+ carve-out blocks.
278
+
279
+ | `ByBlock`
280
+ | Fonts that span many small Unicode blocks where each block
281
+ should land in its own subfont (e.g. for selective subsetting
282
+ per block). Each block is atomic.
283
+
284
+ | `ByScript`
285
+ | Web font delivery where each subfont should cover one script
286
+ (Latin-only file, Greek-only file, etc.). Chunks large scripts
287
+ (Han) when they overflow the cap.
288
+ |===
289
+
290
+ All three autoload from `lib/fontisan/stitcher/partition_strategy/`.
291
+ Adding a new strategy = new file + one autoload entry (OCP).
292
+
293
+ == Per-subfont metadata (Ufo::Info.for_subfont)
294
+
295
+ `Fontisan::Ufo::Info.for_subfont(family:, subfont:, version:, ...)`
296
+ builds the standard name-table fields for one subfont of a collection.
297
+ The family name embeds the subfont name (e.g. `"MyFont CJK"`), and
298
+ the PostScript name uses the hyphenated form (e.g. `"MyFont-CJK"`).
299
+ `version` is parsed into `version_major` / `version_minor` per the
300
+ UFO major.minor shape (semver patch is dropped).
301
+
302
+ [source,ruby]
303
+ ----
304
+ info = Fontisan::Ufo::Info.for_subfont(
305
+ family: "essenfont",
306
+ subfont: :SIP,
307
+ version: "0.1",
308
+ )
309
+ info.family_name # => "essenfont SIP"
310
+ info.postscript_font_name # => "essenfont-SIP"
311
+ info.postscript_full_name # => "essenfont SIP"
312
+ info.version_major # => 0
313
+ info.version_minor # => 1
314
+ ----
315
+
316
+ Optional kwargs: `subfamily:` (default `"Regular"`), `copyright:`,
317
+ `trademark:`. `trademark` lands in `extras["openTypeNameTrademark"]`
318
+ because it is not in `Ufo::Info::STANDARD_FIELDS` yet — round-trip
319
+ still works through the extras channel.
320
+
321
+ == Glyph deduplication
322
+
323
+ By default the Stitcher deduplicates glyphs across all sources using
324
+ SHA-256 outline signatures (`Stitcher::GlyphSignature`). Two donor
325
+ glyphs with identical width + contours + components are merged into a
326
+ single target glyph; subsequent references are aliased by adding the
327
+ extra codepoint to the merged glyph's unicode set.
328
+
329
+ To disable deduplication (e.g., for forensic comparison):
330
+
331
+ [source,ruby]
332
+ ----
333
+ stitcher = Fontisan::Stitcher.new(deduplicate: false)
334
+ ----
335
+
336
+ == 65,535 glyph cap
337
+
338
+ OpenType `maxp.numGlyphs` is uint16 — no format (TTF, CFF1, or CFF2)
339
+ can hold more than 65,535 glyphs in a single font. The Stitcher
340
+ enforces this:
341
+
342
+ * `Stitcher::GlyphLimit.check!(count, format:)` raises
343
+ `GlyphLimitExceededError` when a single subfont would exceed the cap.
344
+ * The only path to >65,535 glyphs is a TTC/OTC collection — each
345
+ subfont is its own 65,535-space.
346
+
347
+ == CBDT/CBLC passthrough (color emoji)
348
+
349
+ Sources that contain CBDT/CBLC tables (e.g. NotoColorEmoji) can be
350
+ used as Stitcher sources. The bitmap data is propagated byte-for-byte
351
+ into the output:
352
+
353
+ [source,ruby]
354
+ ----
355
+ stitcher = Fontisan::Stitcher.new
356
+ stitcher.add_source(:text, Fontisan::FontLoader.load("NotoSans.ttf"))
357
+ stitcher.add_source(:emoji, Fontisan::FontLoader.load("NotoColorEmoji.ttf"))
358
+
359
+ stitcher.include_notdef(from: :text, into: :main)
360
+ stitcher.include_range(0x41..0x5A, from: :text, into: :main)
361
+ stitcher.include_range(0x1F600..0x1F64F, from: :emoji, into: :main)
362
+
363
+ stitcher.write_to("out.ttf", format: :ttf, subfont: :main)
364
+ # → out.ttf has glyf + CBDT + CBLC, emoji renders correctly
365
+ ----
366
+
367
+ === Outline-first cmap priority
368
+
369
+ When a codepoint is covered by BOTH an outline donor and the CBDT
370
+ donor, the cmap maps it to the outline glyph — never to the CBDT
371
+ placeholder. The Cmap compiler follows first-wins semantics, and
372
+ `GlyphCopier` runs before `CbdtPropagator` so the outline GID is
373
+ registered first. This was the fix for the Emoticons cmap-loss bug
374
+ where shared codepoints silently dropped out of the cmap.
375
+
376
+ === Placeholder name deconfliction
377
+
378
+ CBDT placeholders are named after the source's glyph IDs
379
+ (`"gid1"`, `"gid2"`, …), which is the SAME naming scheme
380
+ `Source#extract_truetype_glyph` uses for outline glyphs from TTF
381
+ donors. Without protection, a placeholder at `"gid110"` would
382
+ silently overwrite an outline glyph at `"gid110"` from a different
383
+ donor via `Layer#add` — the original cmap-loss vector for the
384
+ Essenfont CJK Ext G regression.
385
+
386
+ The Stitcher resolves this with two pieces:
387
+
388
+ * `Ufo::Layer#add` RAISES `Ufo::GlyphExistsError` on name conflict.
389
+ Silent overwrites are no longer possible. Callers that want to
390
+ replace an existing glyph use the explicit `Ufo::Layer#put`.
391
+ * `Stitcher::UniqueGlyphName.in(target, base)` allocates a
392
+ non-colliding name (`"gid110"`, then `"gid110.1"`, `"gid110.2"`,
393
+ …). `GlyphCopier` and `CbdtPropagator` both call it before every
394
+ `Layer#add`, so each glyph lands at its own GID slot without
395
+ touching the others.
396
+
397
+ === Limitations
398
+
399
+ * Only ONE CBDT source per Stitcher. Multiple CBDT sources raise
400
+ `Fontisan::MultipleCbdtSourcesError`.
401
+ * **GID stability for overlapping codepoint ranges.** The raw-bytes
402
+ CBDT/CBLC propagation (`CbdtPropagator#propagate_tables_into`)
403
+ copies the source's CBLC verbatim. CBLC indexes glyphs by SOURCE
404
+ GID. After placeholder renaming (`"gid110"` → `"gid110.1"`), the
405
+ compiled GID no longer matches the source GID, so CBLC's source-
406
+ GID-indexed bitmaps can dangle. This is masked in the typical
407
+ Essenfont case (CBDT donor NotoColorEmoji and outline donors
408
+ cover disjoint codepoint ranges) but would produce wrong bitmaps
409
+ for any stitch where CBDT and outline sources share codepoint
410
+ ranges. A proper fix requires a CBLC rebuild pass that walks the
411
+ compiled cmap to remap source GIDs to compiled GIDs — tracked as
412
+ follow-up.
413
+ * **Collection-mode single-face coverage.** Each face is compiled
414
+ independently; `CbdtPropagator` currently requires at least one
415
+ outline codepoint per face. Collection-mode coverage of the
416
+ outline-first cmap-priority invariant is tracked as follow-up.
417
+
418
+ == CLI
419
+
420
+ [source,bash]
421
+ ----
422
+ fontisan stitch \
423
+ --source latin=NotoSans.ttf \
424
+ --source cjk=FSung-m.ttf \
425
+ --include-range latin=0x41-0x5A \
426
+ --include-range cjk=0x4E00-0x9FFF \
427
+ --notdef-from latin \
428
+ --output stitched.ttf
429
+ ----
430
+
431
+ == See also
432
+
433
+ * link:UFO_COMPILATION.adoc[UFO Compilation Guide] — TTF/OTF/CFF2 compilers
434
+ - link:COLLECTION_VALIDATION.adoc[Collection Validation Guide]
435
+ - link:SVG_TO_GLYF.adoc[SVG to Glyph Guide] — turn chart SVGs into
436
+ Stitcher sources
@@ -0,0 +1,118 @@
1
+ = SVG to Glyph Guide
2
+
3
+ == General
4
+
5
+ `Fontisan::SvgToGlyf` converts SVG path data — as produced by ucode's
6
+ code-chart extraction — into `Ufo::Glyph` objects that feed directly
7
+ into the UFO → TTF/OTF compile pipeline.
8
+
9
+ SvgToGlyf emits cubic Bezier contours (matching UFO/PostScript
10
+ conventions). The cubic-to-quadratic conversion and winding-order
11
+ correction happen later, in `Ufo::Compile::Filters::CubicToQuadratic`
12
+ and `ReverseContourDirection`, when the glyph is compiled to TTF.
13
+
14
+ == API
15
+
16
+ [cols="2,3", options="header"]
17
+ |===
18
+ | Method | Purpose
19
+
20
+ | `SvgToGlyf.convert(path_data, upm:, codepoint:, name:, viewbox:, transform:)`
21
+ | Convert a single SVG path `d` string into a `Ufo::Glyph`
22
+
23
+ | `SvgToGlyf.from_svg_file(file_path, upm:, codepoint:)`
24
+ | Convert one `.svg` file into a `Ufo::Glyph`
25
+
26
+ | `SvgToGlyf.from_directory(dir, upm:)`
27
+ | Convert a directory of `.svg` files into a `Ufo::Font` (one glyph
28
+ per file)
29
+ |===
30
+
31
+ The default `upm` is 1000.
32
+
33
+ == Single path
34
+
35
+ [source,ruby]
36
+ ----
37
+ glyph = Fontisan::SvgToGlyf.convert(
38
+ "M 0 0 L 500 0 L 500 700 L 0 700 Z",
39
+ upm: 1000,
40
+ codepoint: 0x10940,
41
+ )
42
+ # → #<Fontisan::Ufo::Glyph name="uni10940" ...>
43
+ ----
44
+
45
+ == Single file
46
+
47
+ [source,ruby]
48
+ ----
49
+ glyph = Fontisan::SvgToGlyf.from_svg_file("U+10940.svg", upm: 1000)
50
+ ----
51
+
52
+ If the codepoint is not supplied, it is derived from the filename when
53
+ it matches `U+XXXX.svg` or `hexcode.svg`.
54
+
55
+ == Directory → Font
56
+
57
+ For batch conversion of a code-chart directory (one SVG per
58
+ codepoint):
59
+
60
+ [source,ruby]
61
+ ----
62
+ font = Fontisan::SvgToGlyf.from_directory(
63
+ "/tmp/chart-svg/Khitan",
64
+ upm: 1000,
65
+ )
66
+ Fontisan::Ufo::Compile::TtfCompiler.new(font)
67
+ .compile(output_path: "Khitan.ttf")
68
+ ----
69
+
70
+ Or feed it directly to the Stitcher:
71
+
72
+ [source,ruby]
73
+ ----
74
+ stitcher = Fontisan::Stitcher.new
75
+ stitcher.add_source(:khitan, font)
76
+ stitcher.include_range(0x18B00..0x18CFF, from: :khitan, into: :main)
77
+ stitcher.write_to("Khitan.ttf", format: :ttf, subfont: :main)
78
+ ----
79
+
80
+ == SVG subset supported
81
+
82
+ SvgToGlyf handles the subset of SVG that real chart extractions use:
83
+
84
+ * Path commands: `M`, `L`, `H`, `V`, `C`, `S`, `Q`, `T`, `A`, `Z`
85
+ (absolute and lowercase relative variants)
86
+ * `<svg>` `viewBox` and `width`/`height` for coordinate scaling
87
+ * `<g transform="...">` group transforms (matrix, translate, scale,
88
+ rotate)
89
+ * `<path d="...">` elements
90
+
91
+ Unsupported SVG features (filters, masks, embedded raster images) are
92
+ ignored. SvgToGlyf is a vector-only converter — for raster emoji, use
93
+ the CBDT/CBLC passthrough path (see link:STITCHER_GUIDE.adoc[Stitcher Guide]).
94
+
95
+ == Coordinate system
96
+
97
+ SVG uses a y-down coordinate system; UFO uses y-up. SvgToGlyf flips
98
+ the y-axis using the SVG `viewBox` height so glyphs render right-way-up
99
+ in font rendering contexts. When no `viewBox` is present, the
100
+ `<svg>` `width`/`height` attributes are used as a fallback.
101
+
102
+ == Namespace layout
103
+
104
+ [source]
105
+ ----
106
+ Fontisan::SvgToGlyf
107
+ ├── Path # SVG path parser → contour builder
108
+ ├── Geometry # AffineTransform, vector math
109
+ ├── Document # <svg> document parsing, viewBox handling
110
+ └── Assembler # top-level glue: builds Ufo::Glyph / Ufo::Font
111
+ ----
112
+
113
+ == See also
114
+
115
+ * link:UFO_COMPILATION.adoc[UFO Compilation Guide] — compile converted
116
+ glyphs to binary fonts
117
+ * link:STITCHER_GUIDE.adoc[Stitcher Guide] — combine converted fonts
118
+ with other donors