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,73 @@
1
+ # 01 — CBDT/CBLC GID-stable propagation
2
+
3
+ ## Priority
4
+ P0
5
+
6
+ ## Problem
7
+
8
+ `Stitcher::CbdtPropagator#propagate_tables_into` (`lib/fontisan/stitcher/cbdt_propagator.rb:147`) copies CBDT/CBLC bytes raw from the CBDT source into the compiled font. CBLC indexes glyphs by **source GID**. But the Stitcher's compile order is:
9
+
10
+ 1. `inject_notdef` → compiled GID 0
11
+ 2. `copy_outlines` → compiled GIDs 1..N (outline donor glyphs)
12
+ 3. `add_placeholder_glyphs` → compiled GIDs N+1..M (CBDT placeholders, often renamed to `"gid{N}.1"` to avoid name collisions per PR #108)
13
+
14
+ So the CBDT source's GID 110 may end up at compiled GID 4027+ — but the raw-bytes CBLC still says "GID 110 → bitmap for source GID 110". The bitmap data dangles, pointing at whatever outline glyph happens to be at compiled GID 110.
15
+
16
+ This is masked in the cited Essenfont use case because FSung-3 (Ext G outlines) and NotoColorEmoji (emoji bitmaps) cover disjoint codepoint ranges. But for any stitch where CBDT and outline donors cover overlapping codepoint ranges (e.g. assembling a combined Latin+emoji font from a single source that has both glyf and CBDT), the bitmap-to-glyph mapping is wrong.
17
+
18
+ Documented as a known limitation in `docs/STITCHER_GUIDE.adoc` (added in PR #110).
19
+
20
+ ## Goal
21
+
22
+ After compile, `propagate_tables_into` rebuilds the CBLC by:
23
+ 1. Walking the compiled font's cmap to find each compiled GID for every CBDT-covered codepoint.
24
+ 2. Mapping source GID → compiled GID via the Stitcher's `GlyphMapping`.
25
+ 3. Building a new CBLC whose `BitmapSize.startGlyphIndex`/`endGlyphIndex` and IndexSubTableArray entries reference compiled GIDs.
26
+ 4. Building a new CBDT that lays out bitmap blocks in compiled-GID order so each block matches its CBLC offset.
27
+
28
+ The result: any stitch — overlapping codepoint ranges or not — produces a font where CBLC's GID references line up with the compiled GIDs that actually have the right bitmaps.
29
+
30
+ ## Approach
31
+
32
+ Reuse the CBDT/CBLC BinData models from PR #106:
33
+ - `Tables::Cblc`, `Tables::CblcBitmapSize`, `Tables::CblcIndexSubTableArrayEntry`, `Tables::CblcIndexSubTable`
34
+ - `Subset::TableStrategy::ColorBitmapSubsetter` and its plan classes — already do the offset-remap math for the subsetter; same algorithm shape, different mapping source
35
+
36
+ New collaborator: `Stitcher::CbdtReindexer`. Sits between compile and table propagation:
37
+
38
+ ```
39
+ compile TTF
40
+ ↓
41
+ CbdtReindexer.reindex(source_cblc, source_cbdt, glyph_mapping) → new (CBLC, CBDT) bytes
42
+ ↓
43
+ FontWriter.write_to_file(tables.merge("CBLC" => new_cblc, "CBDT" => new_cbdt))
44
+ ```
45
+
46
+ The reindexer is stateless given inputs — testable in isolation.
47
+
48
+ Update `propagate_tables_into` to call the reindexer instead of raw-bytes copy.
49
+
50
+ Update `docs/STITCHER_GUIDE.adoc` to remove the "known limitation" note.
51
+
52
+ ## Out of scope
53
+
54
+ - Handling IndexSubTable format 4 (bit-packed offsets) — already unsupported in the subsetter; same gap.
55
+ - Multi-strike CBLC where each strike has a different glyph range — covered (reindexer iterates strikes).
56
+ - Subsetting the source CBDT before stitching — separate concern (the subsetter already does this for `Subset::Builder`).
57
+
58
+ ## Effort
59
+
60
+ ~1 day.
61
+
62
+ ## Dependencies
63
+
64
+ None. Unblocks TODO 02.
65
+
66
+ ## Acceptance criteria
67
+
68
+ - New spec `spec/fontisan/stitcher/cbdt_reindexer_spec.rb` covers:
69
+ - Disjoint-range stitch: CBLC's compiled GID references line up.
70
+ - Overlapping-range stitch: CBDT placeholder at compiled GID N gets the bitmap originally at source GID M (mapping via GlyphMapping).
71
+ - Multi-strike CBLC: every strike's bitmap data lands at the right compiled GID.
72
+ - Existing `spec/fontisan/stitcher/outline_priority_spec.rb` collection-mode test (currently skipped) is unblocked and passes.
73
+ - The "GID-stability limitation" section in `docs/STITCHER_GUIDE.adoc` is removed.
@@ -0,0 +1,48 @@
1
+ # 02 — Collection-mode outline-priority regression
2
+
3
+ ## Priority
4
+ P0
5
+
6
+ ## Problem
7
+
8
+ `spec/fontisan/stitcher/outline_priority_spec.rb:160` ("write_collection preserves outline-first cmap priority across faces") was unblocked for single-face mode in PR #108 but the **collection variant** is still skipped:
9
+
10
+ ```ruby
11
+ skip "Stitcher currently raises on a CBDT source without at least one outline codepoint in each face — " \
12
+ "collection-mode coverage needs CbdtPropagator hardening tracked separately."
13
+ ```
14
+
15
+ When the Stitcher builds a TTC/OTC, each face compiles independently. The CBDT source is global — its placeholders need to land in EVERY face that covers any of its codepoints. The current `CbdtPropagator#add_placeholder_glyphs` raises if a face has no outline glyph from any other donor (the CBDT source alone can't seed a face).
16
+
17
+ ## Goal
18
+
19
+ The skipped test passes. A CBDT source can be stitched into a collection where some faces cover only CBDT codepoints (no outline donor coverage). Each face gets the CBDT/CBLC tables propagated.
20
+
21
+ ## Approach
22
+
23
+ Two pieces:
24
+
25
+ 1. **`CbdtPropagator#add_placeholder_glyphs`** — relax the "must have an outline codepoint" precondition. Allow a face to be seeded with just CBDT placeholders (plus the `.notdef` that's always required).
26
+
27
+ 2. **`CbdtPropagator#propagate_tables_into`** — for collections, run per-face rather than once. The collection writer already iterates faces; this is a matter of plumbing.
28
+
29
+ This depends on TODO 01 (GID-stable propagation) because the collection case multiplies the GID-mapping complexity — each face has its own compiled GID space.
30
+
31
+ ## Out of scope
32
+
33
+ - Multi-CBDT-source support (the `MultipleCbdtSourcesError` guard remains).
34
+ - Cross-face glyph deduplication (already handled by the existing dedup pass).
35
+
36
+ ## Effort
37
+
38
+ ~2 hours once TODO 01 lands.
39
+
40
+ ## Dependencies
41
+
42
+ - TODO 01 (CBDT/CBLC GID-stable propagation).
43
+
44
+ ## Acceptance criteria
45
+
46
+ - The skipped test at `outline_priority_spec.rb:160` is unskipped and passes.
47
+ - A new test covers the "CBDT-only face" case (a face with no outline donor coverage, only CBDT placeholders).
48
+ - `MultipleCbdtSourcesError` is still raised when two CBDT sources are declared.
@@ -0,0 +1,219 @@
1
+ # 03 — `fontisan audit` command (identity+style+features lens)
2
+
3
+ ## Priority
4
+ P1
5
+
6
+ ## Problem
7
+
8
+ The `fontist-archive-private` pipeline currently reaches into Fontisan internals to extract font identity + metadata:
9
+
10
+ ```ruby
11
+ # Current (wrong) approach — manual cmap + table poking
12
+ font = Fontisan::FontLoader.load(font_path)
13
+ cmap = font.table("cmap")
14
+ codepoints = cmap ? cmap.unicode_mappings.keys : []
15
+ # ...plus ad-hoc reads of name, OS/2, head, fvar, GSUB, GPOS
16
+ ```
17
+
18
+ Fragile and bypasses Fontisan's API. Fontisan has `InfoCommand` (font metadata) and `UnicodeCommand` (codepoint/glyph mappings), but neither produces a complete, self-describing audit record suitable for archival use.
19
+
20
+ ## Goal
21
+
22
+ A `fontisan audit` command that produces a structured **font audit report** (YAML or JSON) covering what ucode's audit does NOT:
23
+
24
+ - **Identity** — name-table strings (family, full, PostScript, version)
25
+ - **Style** — OS/2 weight/width classes, head macStyle, fsSelection italic/bold, panose, fvar axes
26
+ - **Coverage facts** — total codepoints, total glyphs, cmap subtable provenance, optional codepoint list
27
+ - **OpenType layout** — GSUB/GPOS scripts (distinct from Unicode scripts), features list
28
+ - **Provenance** — `generated_at`, `fontisan_version`, `source_sha256`
29
+
30
+ ## MECE split with ucode
31
+
32
+ ucode owns the Unicode-coverage axis (UCD parsing, block/script aggregation, per-codepoint glyph extraction). fontisan owns the font-identity axis.
33
+
34
+ | Concern | Owner |
35
+ |---------|-------|
36
+ | UCD fetching + parsing | ucode |
37
+ | Block/script aggregation from codepoints | ucode |
38
+ | Per-codepoint SVG extraction | ucode |
39
+ | HTML browsers | ucode |
40
+ | Font identity (name table) | **fontisan audit** |
41
+ | Style metadata (OS/2, head, fvar) | **fontisan audit** |
42
+ | OpenType scripts + features | **fontisan audit** |
43
+ | Source provenance (sha256, fontisan_version) | **fontisan audit** |
44
+ | cmap subtable provenance | **fontisan audit** |
45
+
46
+ **The fontisan audit does NOT bundle UCDXML parsing.** Block aggregation is delegated: fontisan audit accepts an optional pre-built ucode index path, OR emits the codepoint list and lets the consumer (fontist-archive) run ucode separately.
47
+
48
+ ## Beyond ucode: fontisan as the pure-Ruby replacement for ALL font validators
49
+
50
+ **Positioning correction (after self-debate):** fontisan's stated mission is *"replaces two tools: otfinfo and extract_ttc"*. The natural extension: `fontisan audit` should replace **every** non-Ruby font validator — `fontbakery`, `ots-sanitize`, MS Font Validator, Apple `ftxvalidator`, `ttfautohint`'s verify mode. Each of these is a non-Ruby dependency that fontisan can eliminate for any Ruby-based font workflow.
51
+
52
+ The first-draft of this TODO deferred to those tools ("fontbakery owns this; wrap it"). That was wrong — fontbakery being mature is exactly the reason fontisan should match it: eliminating Python from font toolchains is the value proposition. fontTools tracks the OT spec; fontisan tracks it the same way. The "always behind Chrome" concern is a maintenance discipline, not a reason not to build it.
53
+
54
+ ### The full audit axis inventory
55
+
56
+ Each axis below is currently owned by a non-Ruby tool. fontisan's audit command should provide a pure-Ruby equivalent.
57
+
58
+ | Axis | Replaces | Why fontisan |
59
+ |------|----------|--------------|
60
+ | Identity + style + features | `otfinfo` (LCDF) | Already replaced; `audit` is the structured-report sibling of `info` |
61
+ | Subset report | (no current tool) | fontisan-unique — leverages subset infrastructure |
62
+ | Cross-format equivalence | `ttx` diff (fontTools) | Less noisy; first-class "is this the same font?" |
63
+ | License/rights extraction | (manual OS/2 reading) | One-liner compliance check |
64
+ | Collection integrity | (no current tool for TTC) | TTC is undertooled; CJK/Apple narrow but real |
65
+ | **OTS-rejection predictor** | **`ots-sanitize` (C++)** | Pure-Ruby; no system dependency; cross-platform |
66
+ | **Variable-font readiness** | **`fontbakery` (Python)** | Pure-Ruby replacement; eliminate Python from font toolchains |
67
+ | **Hinting audit** | **`ftxvalidator` + FontLab** | Pure-Ruby; covers Windows/embedded use cases |
68
+ | **Format-round-trip report** | **`ttx` diff** | Verifies fontisan's own conversions + cross-tool comparison |
69
+ | **WOFF2 spec validation** | (informal) | fontisan has the encoder; expose validation |
70
+ | **Glyph name validation** | (informal) | OT spec regex/length/reserved-name rules |
71
+ | **cmap subtable validation** | (informal) | Format 4 segment mismatches, format 12 group ordering — common bugs |
72
+ | **Table directory validation** | (informal) | Checksum, alignment, offset arithmetic |
73
+ | **OpenType conformance** | **`fontbakery` + MS Font Validator** | Hundreds of OT spec "should"/"must" rules |
74
+
75
+ ### Build order (priority)
76
+
77
+ Phase 1 (baseline + immediate-value workflow reports):
78
+ 1. Identity + style + features (archival format)
79
+ 2. Subset report
80
+ 3. Cross-format equivalence
81
+ 4. License/rights extraction
82
+
83
+ Phase 2 (replace the validators — incremental):
84
+ 5. Table directory validation (checksums, alignment — easy, foundational)
85
+ 6. cmap subtable validation (common real-world bugs)
86
+ 7. OTS-rejection predictor (port `ots-sanitize` rule set)
87
+ 8. Glyph name validation (cheap OT spec rules)
88
+
89
+ Phase 3 (broader scope):
90
+ 9. Variable-font readiness (port fontbakery's GF-VF check subset)
91
+ 10. Hinting audit
92
+ 11. WOFF2 spec validation
93
+ 12. Format-round-trip report
94
+ 13. Collection integrity
95
+ 14. Full OpenType conformance (long-running — tracks OT spec evolution)
96
+
97
+ ### Cross-language integration policy
98
+
99
+ When fontisan reaches parity with fontbakery/ots-sanitize on a given check, it's the consumer's choice: use the pure-Ruby implementation (zero system deps) OR shell out to the established tool (mature, may have checks fontisan hasn't ported yet). fontisan shouldn't *force* the replacement — it should *earn* it by being correct and cross-platform.
100
+
101
+ ## Approach
102
+
103
+ ### Models (`lib/fontisan/models/audit/`)
104
+
105
+ Use `lutaml-model` like all other fontisan models:
106
+
107
+ - `AuditReport` — top-level report, attributes per the schema below
108
+ - `AuditAxis` — variable-font axis descriptor
109
+ - `AuditFeature` — feature tag + scripts list
110
+
111
+ ### Command (`lib/fontisan/commands/audit_command.rb`)
112
+
113
+ `Commands::AuditCommand` orchestrates — does NOT re-parse tables. Delegates to existing commands:
114
+
115
+ - `InfoCommand` — identity + name-table strings
116
+ - `UnicodeCommand` — codepoint list + cmap subtable provenance
117
+ - `ScriptsCommand` — `opentype_scripts`
118
+ - `FeaturesCommand` — `features`
119
+ - `FormatDetector` — `source_format`
120
+
121
+ This makes `AuditCommand` a thin orchestration layer.
122
+
123
+ ### CLI (`lib/fontisan/cli.rb`)
124
+
125
+ ```bash
126
+ # Standalone
127
+ fontisan audit Inter-Regular.ttf # → stdout (YAML)
128
+ fontisan audit Inter-Regular.ttf -o report.yaml # → file
129
+ fontisan audit Inter-Regular.ttf --format json # → stdout (JSON)
130
+
131
+ # Collection
132
+ fontisan audit Inter.ttc -o reports/ # → reports/Inter.ttc/{00..08}-*.yaml
133
+
134
+ # Single face from collection
135
+ fontisan audit Inter.ttc --font-index 6 -o Inter-Bold.yaml
136
+ ```
137
+
138
+ ### Output schema (one face per file)
139
+
140
+ ```yaml
141
+ generated_at: 2026-07-10T12:30:00Z
142
+ fontisan_version: 0.4.24
143
+ source_file: Inter-Regular.ttf
144
+ source_sha256: 3b1a...
145
+ source_format: ttf
146
+
147
+ font_index: null
148
+ num_fonts_in_source: 1
149
+
150
+ # Identity
151
+ family_name: Inter
152
+ subfamily_name: Regular
153
+ full_name: Inter Regular
154
+ postscript_name: Inter-Regular
155
+ version: Version 4.000;git-a52131595
156
+ font_revision: 4.0
157
+
158
+ # Style
159
+ weight_class: 400
160
+ width_class: 5
161
+ italic: false
162
+ bold: false
163
+ panose: "2 0 5 3 0 0 0 0 0 0"
164
+ is_variable: false
165
+ axes: []
166
+
167
+ # Coverage
168
+ total_codepoints: 2857
169
+ total_glyphs: 1486
170
+ cmap_subtables: [4, 12, 14]
171
+ codepoints: [U+0000, U+0020, ...] # omitted with --no-codepoints
172
+
173
+ # OpenType layout
174
+ opentype_scripts: [latn, cyrl]
175
+ features: [kern, liga, calt]
176
+ ```
177
+
178
+ ### Collection layout
179
+
180
+ ```
181
+ reports/
182
+ Inter.ttc/
183
+ 00-Inter-Regular.yaml
184
+ 01-Inter-Italic.yaml
185
+ ...
186
+ 08-Inter-Black.yaml
187
+ ```
188
+
189
+ Filename pattern: `{font_index:02d}-{postscript_name}.yaml`. Index prefix guarantees face-order sort and disambiguates broken fonts where two faces share a PostScript name.
190
+
191
+ ## Out of scope
192
+
193
+ - UCDXML parsing (ucode's domain)
194
+ - Block/script aggregation (consumer runs ucode separately, OR a future `--with-ucode` flag calls ucode as a subprocess)
195
+ - HTML browsers (ucode's domain)
196
+ - Per-codepoint glyph extraction (ucode's 4-tier resolver)
197
+ - Reading formula YAML — this command reports what the FONT FILE declares
198
+ - Generating WOFF specimens (ConvertCommand's domain)
199
+
200
+ ## Effort
201
+
202
+ ~1-2 days.
203
+
204
+ ## Dependencies
205
+
206
+ None directly. Existing commands (`InfoCommand`, `UnicodeCommand`, `ScriptsCommand`, `FeaturesCommand`) provide the data; `AuditCommand` just orchestrates.
207
+
208
+ ## Acceptance criteria
209
+
210
+ - New spec `spec/fontisan/commands/audit_command_spec.rb` covers:
211
+ - Standalone TTF → YAML + JSON output
212
+ - Collection TTC → directory of N face reports
213
+ - `--font-index N` → single-face report
214
+ - `--no-codepoints` omits the codepoint list
215
+ - Source sha256 matches `Digest::SHA256.file(path)`
216
+ - Variable font with fvar → axes array populated
217
+ - New spec `spec/fontisan/models/audit_report_spec.rb` covers the model's serialization.
218
+ - CLI smoke test verifies `fontisan audit path/to/font.ttf` produces valid YAML on stdout.
219
+ - README/docs updated.
@@ -0,0 +1,46 @@
1
+ # 04 — UFO composite glyph encoding
2
+
3
+ ## Priority
4
+ P1
5
+
6
+ ## Problem
7
+
8
+ `Ufo::Compile::GlyfLoca` (`lib/fontisan/ufo/compile/glyf_loca.rb:137`) emits simple glyphs only. UFO sources with composite glyphs (e.g., é defined as a component reference to e + acute) lose their component structure on compile — the compiled glyf either drops them or depends on `flatten_components` filter pre-processing.
9
+
10
+ ## Goal
11
+
12
+ `GlyfLoca` encodes composite glyphs natively per OpenType spec section 5.6. A UFO `<component>` element maps to a glyf component record referencing the target glyph by index, preserving the original transform.
13
+
14
+ ## Approach
15
+
16
+ Add a `CompositeEncoder` collaborator in `lib/fontisan/ufo/compile/glyf_loca/composite_encoder.rb` that takes a UFO `<component>` plus a GID-resolver (component name → compiled GID) and emits the binary component record per OT spec:
17
+
18
+ ```
19
+ uint16 flags
20
+ uint16 glyphIndex
21
+ (uint8|uint8|uint8|uint8 | int8|int8|int8|int8 | uint8) args # depends on flags bits 0/1
22
+ (F2Dot14 × 4 | F2Dot14 × 2 | F2Dot14) transformation # depends on flags bits 7/6/3
23
+ ```
24
+
25
+ `GlyfLoca` invokes the encoder when a UFO glyph has components (no contours, OR contours + components — latter is rare but spec-legal).
26
+
27
+ The existing `flatten_components` filter remains for callers who want pre-flattening (e.g., for fonts that target renderers without component support).
28
+
29
+ ## Out of scope
30
+
31
+ - Variable-font composite variation deltas (`gvar`) — separate concern, TODO 06's blast radius.
32
+ - Cycling component references (A → B → A) — these need pre-validation, tracked separately.
33
+
34
+ ## Effort
35
+
36
+ ~1 day.
37
+
38
+ ## Dependencies
39
+
40
+ None.
41
+
42
+ ## Acceptance criteria
43
+
44
+ - New spec covers encoding of all 8 component arg/transform combinations (flags bit patterns).
45
+ - Round-trip spec: UFO with composite → compile → re-read via `FontLoader` → components match original.
46
+ - The `flatten_components` filter still works as a pre-pass for callers that want flattened output.
@@ -0,0 +1,63 @@
1
+ # 05 — OTF compiler real CFF charstrings
2
+
3
+ ## Priority
4
+ P1
5
+
6
+ ## Problem
7
+
8
+ `Ufo::Compile::OtfCompiler` (`lib/fontisan/ufo/compile/otf_compiler.rb:9`) currently emits a placeholder CFF table — no real charstrings. Any OTF output is incomplete:
9
+
10
+ ```
11
+ # TODO.full/10: this currently emits a placeholder CFF table
12
+ # real charstrings. Full CFF construction lands when TODO 10
13
+ ```
14
+
15
+ The font loads but renders nothing useful. Production OTF output is blocked.
16
+
17
+ ## Goal
18
+
19
+ `OtfCompiler` emits a complete CFF table with:
20
+ - Real Type 2 charstrings for every glyph (converted from UFO contours)
21
+ - Valid Top DICT (font matrix, charset, encoding, CharStrings INDEX offset)
22
+ - Valid Private DICT (default width, nominal width, SubrZERO subroutines if any)
23
+ - Correct name INDEX, charset, FDSelect/FDArray (for CID-keyed fonts)
24
+
25
+ Round-trip: UFO → compile → re-read via `FontLoader` → contours match.
26
+
27
+ ## Approach
28
+
29
+ Reuse the Type 2 charstring conversion logic from `lib/fontisan/type1/charstring_converter.rb` — UFO contours → moveto/lineto/curveto closepath is structurally identical to Type 1 → Type 2 charstring conversion.
30
+
31
+ Add a new `CffBuilder` collaborator under `lib/fontisan/ufo/compile/otf_compiler/cff_builder.rb` that owns:
32
+
33
+ 1. **Top DICT construction** — font matrix, ROS (if CID), charstrings offset.
34
+ 2. **CharString INDEX** — per-glyph Type 2 charstring bytes.
35
+ 3. **Charset** — glyph name → GID map (uses post.names if available; else `gid{N}`).
36
+ 4. **Private DICT** — default width, nominal width, hint-mask operators (no-op when source has no hints).
37
+ 5. **Global / local subroutines** — empty INDEXs initially; TODO 06 wires hint subroutines.
38
+
39
+ The existing `Tables::Cff` BinData record already declares the on-disk structure; the builder produces the values to populate it.
40
+
41
+ ## Out of scope
42
+
43
+ - CFF2 (variable fonts) — TODO 06.
44
+ - Subroutine packing / optimization — `Optimizers::SubroutineOptimizer` already exists for Type 1; CFF equivalent is a separate task.
45
+ - CID-keyed fonts with multi-FD — single FD only initially.
46
+
47
+ ## Effort
48
+
49
+ ~2-3 days.
50
+
51
+ ## Dependencies
52
+
53
+ None (the placeholder CFF was the only thing blocking, and we're replacing it).
54
+
55
+ ## Acceptance criteria
56
+
57
+ - New spec `spec/fontisan/ufo/compile/otf_compiler/cff_builder_spec.rb` covers:
58
+ - Single-glyph font (`.notdef` + one outline) → valid CFF
59
+ - Multi-glyph font with quadratic curves → charstrings use rcurveto correctly
60
+ - Multi-glyph font with TrueType cubic curves → curve conversion to Type 2 cubic
61
+ - Charset ordering matches maxp.numGlyphs
62
+ - Round-trip: UFO → OTF → re-read → contours match (within Type 2 quantization tolerance)
63
+ - `fontisan convert font.ufo --to otf` produces a font that loads in fontTools and Chrome.
@@ -0,0 +1,51 @@
1
+ # 06 — CFF2 blend/vsindex operators
2
+
3
+ ## Priority
4
+ P2
5
+
6
+ ## Problem
7
+
8
+ `Ufo::Compile::VariableOtf` (`lib/fontisan/ufo/compile/variable_otf.rb:12`) emits static CFF2 only:
9
+
10
+ ```
11
+ - CFF2 outlines (static — blend/vsindex operators are TODO 07/18)
12
+ TODO 07 (blend/vsindex) and TODO 18 (blend integration) to be
13
+ ```
14
+
15
+ Variable CFF2 fonts (e.g., variable OTF output from a UFO with `fvar` + `gvar`-equivalent masters) can't round-trip. The compiled font is static — variation deltas are dropped.
16
+
17
+ ## Goal
18
+
19
+ `VariableOtf` emits CFF2 with `blend` and `vsindex` operators per CFF2 spec section 3.A.4. A variable UFO source compiles to a variable OTF that renders correctly at any chosen instance along each axis.
20
+
21
+ ## Approach
22
+
23
+ Two pieces:
24
+
25
+ 1. **CharString encoder** — extend the Type 2 charstring builder (from TODO 05) to emit `blend` after each variation-aware value. The master value is the default; deltas for each region are pushed on the stack then summed via `blend`.
26
+
27
+ 2. **ItemVariationData emission** — translate the UFO master model (`gvar`-equivalent: per-glyph deltas keyed by region) into CFF2's `ItemVariationData` and `ItemVariationStore` structures. Reuse `Ufo::Compile::ItemVariationStore` which already handles this for the variable-TTF path.
28
+
29
+ 3. **Region detection** — pre-pass over `fvar` axes + master locations to compute the set of variation regions. Same algorithm as `Ufo::Compile::Fvar`.
30
+
31
+ ## Out of scope
32
+
33
+ - HVAR/VVAR/MVAR tables for variable OTF — those are outside CFF2 but already partially supported; track separately if needed.
34
+ - Backwards-compat with non-variable CFF fonts — separate concern.
35
+ - Subroutine packing of variation-aware charstrings — TODO follow-up.
36
+
37
+ ## Effort
38
+
39
+ ~3-5 days. CFF2 charstring semantics are intricate.
40
+
41
+ ## Dependencies
42
+
43
+ - TODO 05 (OTF compiler real CFF) — must land first; the CFF2 builder extends the CFF builder.
44
+
45
+ ## Acceptance criteria
46
+
47
+ - New spec covers:
48
+ - Single-axis variable font → CFF2 with correct `blend` operators + `ItemVariationStore`
49
+ - Multi-axis variable font → region table correct, no cross-axis contamination
50
+ - Instance generation via `Variation::InstanceGenerator` produces output identical to direct master compile (within tolerance)
51
+ - Round-trip: UFO with fvar + masters → variable OTF → re-read → `fvar` axes match, instances render correctly.
@@ -0,0 +1,71 @@
1
+ # 07 — CPAL v1 header fields
2
+
3
+ ## Priority
4
+ P2
5
+
6
+ ## Problem
7
+
8
+ `Tables::Cpal` (`lib/fontisan/tables/cpal.rb:106,184`) only parses CPAL v0 fields. CPAL v1 adds:
9
+
10
+ - `numPaletteEntryLabels` (uint16) — count of palette entry labels
11
+ - `numPaletteLabels` (uint16) — count of palette labels
12
+ - `paletteEntryLabelsOffset` (uint32) — offset to label records
13
+ - `paletteLabelsOffset` (uint32) — offset to label records
14
+
15
+ These attach human-readable names (via the `name` table) to color palettes and entries. Fonts with CPAL v1 lose this metadata on parse.
16
+
17
+ ## Goal
18
+
19
+ `Tables::Cpal` parses v1 header fields and exposes:
20
+
21
+ - `palette_labels` — array of name-record IDs, one per palette
22
+ - `palette_entry_labels` — array of name-record IDs, one per palette entry index
23
+
24
+ Round-trip preserves the labels.
25
+
26
+ ## Approach
27
+
28
+ Extend the BinData record in `lib/fontisan/tables/cpal.rb`:
29
+
30
+ ```ruby
31
+ class Cpal < Binary::BaseRecord
32
+ uint16 :version
33
+ uint16 :num_palette_entries
34
+ uint16 :num_palettes
35
+ uint16 :num_color_records
36
+ uint32 :color_records_offset
37
+ array :color_record_indices, type: :uint16, initial_length: :num_palettes
38
+ # v0 ends here
39
+
40
+ # v1 extension — only present when version >= 1
41
+ choice :v1_fields, onlyif: -> { version >= 1 } do
42
+ uint16 :num_palette_entry_labels
43
+ uint16 :num_palette_labels
44
+ uint32 :palette_entry_labels_offset
45
+ uint32 :palette_labels_offset
46
+ end
47
+ end
48
+ ```
49
+
50
+ After BinData parse, lazily walk the label offsets to populate `palette_labels` and `palette_entry_labels` arrays.
51
+
52
+ For emission: if v1 fields are set, include them; else emit v0.
53
+
54
+ ## Out of scope
55
+
56
+ - CPAL v2 changes (none — v1 is the latest defined).
57
+ - Building new palettes from scratch — just parse + emit.
58
+
59
+ ## Effort
60
+
61
+ ~4 hours.
62
+
63
+ ## Dependencies
64
+
65
+ None.
66
+
67
+ ## Acceptance criteria
68
+
69
+ - New spec covers parse of a synthetic CPAL v1 table with both label arrays.
70
+ - Round-trip: v1 table → read → `to_binary_s` → identical bytes.
71
+ - v0 tables still parse and emit unchanged.
@@ -0,0 +1,52 @@
1
+ # 08 — CFF standard string table
2
+
3
+ ## Priority
4
+ P2
5
+
6
+ ## Problem
7
+
8
+ `Tables::Cff` (`lib/fontisan/tables/cff.rb:419`) ships only a partial standard string table (the 391 predefined Type 1 / CFF strings per spec appendix A). Glyph names that should be in the standard set are duplicated in the custom strings index, wasting space and breaking round-trip fidelity with fontTools.
9
+
10
+ ## Goal
11
+
12
+ Complete the 391-string standard table per CFF spec. `Cff` parses glyph names against the standard table; only non-standard names go in the custom strings index.
13
+
14
+ ## Approach
15
+
16
+ Replace the partial list with the canonical 391 strings (spec appendix A, also in fontTools' `fontTools.cffLib.strings`).
17
+
18
+ Add a class method:
19
+
20
+ ```ruby
21
+ class Cff < Binary::BaseRecord
22
+ STANDARD_STRINGS = [...].freeze # 391 entries
23
+
24
+ def self.standard_string?(name)
25
+ STANDARD_STRINGS.include?(name)
26
+ end
27
+
28
+ def self.standard_string_index(name)
29
+ STANDARD_STRINGS.index(name)
30
+ end
31
+ end
32
+ ```
33
+
34
+ Update the CFF builder (TODO 05's `CffBuilder`) to skip custom-string encoding when a name is standard.
35
+
36
+ ## Out of scope
37
+
38
+ - CID-keyed fonts (no name strings) — unaffected.
39
+ - Custom charstring-internal names (operator names) — those are operators, not string IDs.
40
+
41
+ ## Effort
42
+
43
+ ~2 hours.
44
+
45
+ ## Dependencies
46
+
47
+ - TODO 05 (OTF compiler real CFF) benefits; doesn't strictly block.
48
+
49
+ ## Acceptance criteria
50
+
51
+ - Spec covers: every standard name → correct index, every non-standard name → custom index.
52
+ - Round-trip: CFF with mixed standard/non-standard names → read → emit → identical bytes.