fontisan 0.4.49-arm-linux
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- data/.rspec +3 -0
- data/.rubocop.yml +141 -0
- data/.rubocop_todo.yml +433 -0
- data/BENCHMARKS.md +56 -0
- data/BUG-stitcher-drops-isolated-cps.md +58 -0
- data/BUG-stitcher-drops-plane1-codepoints.md +310 -0
- data/BUG-stitcher-gid-cap-65535.md +110 -0
- data/CHANGELOG.md +293 -0
- data/Gemfile +40 -0
- data/LICENSE +28 -0
- data/README.adoc +2811 -0
- data/Rakefile +156 -0
- data/TODO.bug-fixes/01-cff-expert-charsets.md +27 -0
- data/TODO.bug-fixes/02-cff2-subroutine-stubs.md +32 -0
- data/TODO.bug-fixes/03-variation-subsetter-placeholders.md +42 -0
- data/TODO.bug-fixes/04-ufo-image-compile-roundtrip.md +28 -0
- data/TODO.bug-fixes/05-stale-cff-comment.md +18 -0
- data/TODO.bug-fixes/06-instance-woff2-output.md +24 -0
- data/TODO.bug-fixes/07-encapsulation-violations.md +38 -0
- data/TODO.bug-fixes/08-respond-to-violations.md +25 -0
- data/TODO.bug-fixes/09-type1-cff-seac-expansion.md +22 -0
- data/TODO.bug-fixes/10-ttf-type1-composite-glyphs.md +23 -0
- data/TODO.bug-fixes/11-remaining-respond-to.md +25 -0
- data/TODO.bug-fixes/12-type1-generators-duck-typing.md +80 -0
- data/TODO.bug-fixes/13-hint-extractor-duck-typing.md +30 -0
- data/TODO.bug-fixes/14-font-interface-type-checks.md +82 -0
- data/TODO.bug-fixes/15-glyph-type-checks-and-simple-glyph-points-bug.md +49 -0
- data/TODO.bug-fixes/16-variation-table-checks.md +31 -0
- data/TODO.bug-fixes/17-ufo-and-stitcher-cleanup.md +32 -0
- data/TODO.bug-fixes/18-generic-value-and-io-checks.md +56 -0
- data/TODO.bug-fixes/19-serialization-migration.md +52 -0
- data/TODO.bug-fixes/20-variation-validator-type-checks.md +29 -0
- data/TODO.bug-fixes/21-xml-builder-send.md +24 -0
- data/TODO.bug-fixes/22-type1-converter-font-info.md +25 -0
- data/TODO.bug-fixes/23-boundary-type-checks.md +31 -0
- data/TODO.bug-fixes/24-validator-dynamic-field-key.md +25 -0
- data/TODO.bug-fixes/25-serialization-migration.md +49 -0
- data/TODO.bug-fixes/26-variation-preserver-spec-migration.md +25 -0
- data/TODO.bug-fixes/27-table-class-registry.md +50 -0
- data/TODO.bug-fixes/28-spec-doubles-cleanup.md +40 -0
- data/TODO.bug-fixes/29-strategy-registries.md +30 -0
- data/TODO.bug-fixes/30-eliminate-send-in-specs.md +36 -0
- data/TODO.bug-fixes/README.md +52 -0
- data/TODO.improvements/01-cbdt-cblc-gid-stable-propagation.md +73 -0
- data/TODO.improvements/02-collection-outline-priority.md +48 -0
- data/TODO.improvements/03-fontisan-audit-command.md +219 -0
- data/TODO.improvements/04-ufo-composite-glyph-encoding.md +46 -0
- data/TODO.improvements/05-otf-compiler-real-cff.md +63 -0
- data/TODO.improvements/06-cff2-blend-vsindex-operators.md +51 -0
- data/TODO.improvements/07-cpal-v1-header-fields.md +71 -0
- data/TODO.improvements/08-cff-standard-string-table.md +52 -0
- data/TODO.improvements/09-type1-seac-expansion.md +57 -0
- data/TODO.improvements/10-ufo-image-set-feature-writers.md +71 -0
- data/TODO.improvements/11-kern-groups-plist.md +49 -0
- data/TODO.improvements/12-cbdt-fixture-bindata-conversion.md +68 -0
- data/TODO.improvements/13-split-octokit-fetcher.md +45 -0
- data/TODO.improvements/14-rubocop-baseline-chip.md +62 -0
- data/TODO.improvements/15-cff-cff2-subsetter-strategy.md +78 -0
- data/TODO.improvements/README.md +58 -0
- data/benchmark/baseline.json +5 -0
- data/benchmark/ci_gate.rb +217 -0
- data/benchmark/compile_benchmark.rb +78 -0
- data/benchmark/corpus/harness.rb +175 -0
- data/benchmark/corpus/ops.rb +150 -0
- data/benchmark/corpus/run.rb +182 -0
- data/benchmark/corpus/scan_child.rb +8 -0
- data/benchmark/corpus/tiers.rb +176 -0
- data/benchmark/tier_baseline.json +12 -0
- data/benchmark/variation_quick_bench.rb +47 -0
- data/build_mingw32_stub.rb +15 -0
- data/docs/.gitignore +17 -0
- data/docs/.vitepress/config.ts +373 -0
- data/docs/.vitepress/theme/components/ApiMethod.vue +127 -0
- data/docs/.vitepress/theme/components/Badge.vue +51 -0
- data/docs/.vitepress/theme/components/FeatureComparison.vue +87 -0
- data/docs/.vitepress/theme/components/HeroCodeBlock.vue +98 -0
- data/docs/.vitepress/theme/components/WithinHero.vue +30 -0
- data/docs/.vitepress/theme/index.ts +22 -0
- data/docs/.vitepress/theme/style.css +628 -0
- data/docs/AFDKO_MIGRATION.adoc +175 -0
- data/docs/APPLE_LEGACY_FONTS.adoc +173 -0
- data/docs/CFF2_SUPPORT.adoc +184 -0
- data/docs/COLLECTION_VALIDATION.adoc +204 -0
- data/docs/COLOR_FONTS.adoc +127 -0
- data/docs/CONVERSION_GUIDE.adoc +656 -0
- data/docs/EXTRACT_TTC_MIGRATION.md +549 -0
- data/docs/FEATURE_PARITY.adoc +263 -0
- data/docs/FONT_HINTING.adoc +570 -0
- data/docs/STITCHER_GUIDE.adoc +436 -0
- data/docs/SVG_TO_GLYF.adoc +118 -0
- data/docs/TTX.adoc +176 -0
- data/docs/TYPE1_FONTS.adoc +445 -0
- data/docs/UFO_COMPILATION.adoc +397 -0
- data/docs/VALIDATION.adoc +254 -0
- data/docs/VARIABLE_FONT_OPERATIONS.adoc +599 -0
- data/docs/WOFF_WOFF2_FORMATS.adoc +220 -0
- data/docs/api/conversion-options.md +164 -0
- data/docs/api/converters/curve-converter.md +34 -0
- data/docs/api/converters/hint-converter.md +34 -0
- data/docs/api/converters/outline-converter.md +27 -0
- data/docs/api/font-loader.md +117 -0
- data/docs/api/font-writer.md +103 -0
- data/docs/api/index.md +79 -0
- data/docs/api/layer.md +89 -0
- data/docs/api/models/glyph-accessor.md +43 -0
- data/docs/api/models/glyph.md +40 -0
- data/docs/api/models/table-analyzer.md +35 -0
- data/docs/api/sfnt-font.md +53 -0
- data/docs/api/type1-font.md +43 -0
- data/docs/api/validators/font-validator.md +31 -0
- data/docs/api/validators/helper.md +36 -0
- data/docs/api/validators/profile.md +39 -0
- data/docs/cli/convert.md +148 -0
- data/docs/cli/dump-table.md +110 -0
- data/docs/cli/export.md +176 -0
- data/docs/cli/features.md +124 -0
- data/docs/cli/glyphs.md +90 -0
- data/docs/cli/index.md +232 -0
- data/docs/cli/info.md +254 -0
- data/docs/cli/instance.md +122 -0
- data/docs/cli/ls.md +95 -0
- data/docs/cli/optical-size.md +94 -0
- data/docs/cli/pack.md +125 -0
- data/docs/cli/scripts.md +105 -0
- data/docs/cli/subset.md +58 -0
- data/docs/cli/tables.md +84 -0
- data/docs/cli/unicode.md +101 -0
- data/docs/cli/validate-collection.md +95 -0
- data/docs/cli/validate.md +56 -0
- data/docs/cli/variable.md +126 -0
- data/docs/cli/version.md +46 -0
- data/docs/guide/cli/convert.md +108 -0
- data/docs/guide/cli/export.md +138 -0
- data/docs/guide/cli/index.md +99 -0
- data/docs/guide/cli/info.md +144 -0
- data/docs/guide/cli/pack.md +155 -0
- data/docs/guide/cli/subset.md +149 -0
- data/docs/guide/cli/validate.md +139 -0
- data/docs/guide/color-fonts/bitmaps.md +194 -0
- data/docs/guide/color-fonts/colr-cpal.md +175 -0
- data/docs/guide/color-fonts/index.md +140 -0
- data/docs/guide/color-fonts/svg.md +154 -0
- data/docs/guide/color.md +51 -0
- data/docs/guide/comparisons/font-validator.md +222 -0
- data/docs/guide/comparisons/fonttools.md +200 -0
- data/docs/guide/comparisons/index.md +83 -0
- data/docs/guide/comparisons/lcdf-typetools.md +205 -0
- data/docs/guide/contributing.md +279 -0
- data/docs/guide/conversion/collections.md +251 -0
- data/docs/guide/conversion/curves.md +246 -0
- data/docs/guide/conversion/index.md +157 -0
- data/docs/guide/conversion/options.md +280 -0
- data/docs/guide/conversion/ttf-otf.md +184 -0
- data/docs/guide/conversion/type1.md +208 -0
- data/docs/guide/conversion/web.md +299 -0
- data/docs/guide/conversion.md +40 -0
- data/docs/guide/engines.md +117 -0
- data/docs/guide/formats/collections.md +147 -0
- data/docs/guide/formats/dfont.md +99 -0
- data/docs/guide/formats/index.md +65 -0
- data/docs/guide/formats/otf.md +103 -0
- data/docs/guide/formats/svg.md +97 -0
- data/docs/guide/formats/ttf.md +105 -0
- data/docs/guide/formats/type1.md +118 -0
- data/docs/guide/formats/woff.md +139 -0
- data/docs/guide/hinting/autohint.md +141 -0
- data/docs/guide/hinting/conversion.md +161 -0
- data/docs/guide/hinting/index.md +86 -0
- data/docs/guide/hinting/postscript.md +149 -0
- data/docs/guide/hinting/truetype.md +135 -0
- data/docs/guide/hinting.md +44 -0
- data/docs/guide/index.md +152 -0
- data/docs/guide/installation.md +116 -0
- data/docs/guide/migrations/extract-ttc.md +549 -0
- data/docs/guide/migrations/font-validator.md +260 -0
- data/docs/guide/migrations/fonttools.md +208 -0
- data/docs/guide/migrations/index.md +64 -0
- data/docs/guide/migrations/otfinfo.md +197 -0
- data/docs/guide/quick-start.md +204 -0
- data/docs/guide/type1.md +58 -0
- data/docs/guide/universal-outline.md +151 -0
- data/docs/guide/validation/custom.md +195 -0
- data/docs/guide/validation/helpers.md +188 -0
- data/docs/guide/validation/index.md +132 -0
- data/docs/guide/validation/profiles.md +156 -0
- data/docs/guide/validation.md +47 -0
- data/docs/guide/variable-fonts/advanced.md +231 -0
- data/docs/guide/variable-fonts/axes.md +209 -0
- data/docs/guide/variable-fonts/conversion.md +197 -0
- data/docs/guide/variable-fonts/index.md +84 -0
- data/docs/guide/variable-fonts/instances.md +187 -0
- data/docs/guide/variable-fonts/named-instances.md +194 -0
- data/docs/guide/variable-fonts/static.md +168 -0
- data/docs/guide/variable.md +58 -0
- data/docs/guide/woff.md +61 -0
- data/docs/index.md +136 -0
- data/docs/lychee.toml +41 -0
- data/docs/package-lock.json +2560 -0
- data/docs/package.json +15 -0
- data/docs/public/apple-touch-icon.png +0 -0
- data/docs/public/favicon-96x96.png +0 -0
- data/docs/public/favicon.ico +0 -0
- data/docs/public/favicon.svg +1 -0
- data/docs/public/logo-full.svg +1 -0
- data/docs/public/logo.svg +1 -0
- data/docs/public/robots.txt +4 -0
- data/docs/public/site.webmanifest +21 -0
- data/docs/public/web-app-manifest-192x192.png +0 -0
- data/docs/public/web-app-manifest-512x512.png +0 -0
- data/docs/reference-facade.md +130 -0
- data/docs/scripts/post-build.mjs +81 -0
- data/exe/fontisan +7 -0
- data/lib/fontisan/audit/check.rb +47 -0
- data/lib/fontisan/audit/check_registry.rb +77 -0
- data/lib/fontisan/audit/checks/cff_table_check.rb +87 -0
- data/lib/fontisan/audit/checks/cmap_check.rb +256 -0
- data/lib/fontisan/audit/checks/collection_integrity_check.rb +102 -0
- data/lib/fontisan/audit/checks/format_round_trip_check.rb +150 -0
- data/lib/fontisan/audit/checks/glyf_table_check.rb +115 -0
- data/lib/fontisan/audit/checks/glyph_name_check.rb +107 -0
- data/lib/fontisan/audit/checks/head_check.rb +96 -0
- data/lib/fontisan/audit/checks/hhea_check.rb +68 -0
- data/lib/fontisan/audit/checks/hinting_check.rb +163 -0
- data/lib/fontisan/audit/checks/kern_check.rb +47 -0
- data/lib/fontisan/audit/checks/layout_table_check.rb +70 -0
- data/lib/fontisan/audit/checks/maxp_check.rb +85 -0
- data/lib/fontisan/audit/checks/name_table_check.rb +78 -0
- data/lib/fontisan/audit/checks/naming_consistency_check.rb +102 -0
- data/lib/fontisan/audit/checks/opentype_conformance_check.rb +108 -0
- data/lib/fontisan/audit/checks/os2_check.rb +117 -0
- data/lib/fontisan/audit/checks/ots_compatibility_check.rb +191 -0
- data/lib/fontisan/audit/checks/post_check.rb +75 -0
- data/lib/fontisan/audit/checks/table_directory_check.rb +157 -0
- data/lib/fontisan/audit/checks/variable_font_check.rb +151 -0
- data/lib/fontisan/audit/checks/woff2_validation_check.rb +140 -0
- data/lib/fontisan/audit/checks.rb +42 -0
- data/lib/fontisan/audit.rb +20 -0
- data/lib/fontisan/base_collection.rb +312 -0
- data/lib/fontisan/binary/base_record.rb +82 -0
- data/lib/fontisan/binary/structures.rb +82 -0
- data/lib/fontisan/binary.rb +11 -0
- data/lib/fontisan/byte_ops.rb +314 -0
- data/lib/fontisan/cli.rb +1111 -0
- data/lib/fontisan/collection/builder.rb +336 -0
- data/lib/fontisan/collection/dfont_builder.rb +305 -0
- data/lib/fontisan/collection/offset_calculator.rb +229 -0
- data/lib/fontisan/collection/reader/stats.rb +23 -0
- data/lib/fontisan/collection/reader.rb +90 -0
- data/lib/fontisan/collection/shared_logic.rb +52 -0
- data/lib/fontisan/collection/table_analyzer.rb +289 -0
- data/lib/fontisan/collection/table_deduplicator.rb +317 -0
- data/lib/fontisan/collection/writer.rb +289 -0
- data/lib/fontisan/collection.rb +16 -0
- data/lib/fontisan/commands/audit_command.rb +288 -0
- data/lib/fontisan/commands/base_command.rb +88 -0
- data/lib/fontisan/commands/convert_command.rb +506 -0
- data/lib/fontisan/commands/dump_table_command.rb +68 -0
- data/lib/fontisan/commands/export_command.rb +157 -0
- data/lib/fontisan/commands/features_command.rb +90 -0
- data/lib/fontisan/commands/glyphs_command.rb +50 -0
- data/lib/fontisan/commands/info_command.rb +447 -0
- data/lib/fontisan/commands/instance_command.rb +357 -0
- data/lib/fontisan/commands/ls_command.rb +107 -0
- data/lib/fontisan/commands/multi_format_output.rb +64 -0
- data/lib/fontisan/commands/optical_size_command.rb +38 -0
- data/lib/fontisan/commands/pack_command.rb +344 -0
- data/lib/fontisan/commands/scripts_command.rb +56 -0
- data/lib/fontisan/commands/subset_command.rb +285 -0
- data/lib/fontisan/commands/tables_command.rb +52 -0
- data/lib/fontisan/commands/unicode_command.rb +73 -0
- data/lib/fontisan/commands/unpack_command.rb +387 -0
- data/lib/fontisan/commands/validate_collection_command.rb +127 -0
- data/lib/fontisan/commands/validate_command.rb +305 -0
- data/lib/fontisan/commands/variable_command.rb +87 -0
- data/lib/fontisan/commands.rb +30 -0
- data/lib/fontisan/config/collection_settings.yml +56 -0
- data/lib/fontisan/config/conversion_matrix.yml +626 -0
- data/lib/fontisan/config/export_settings.yml +66 -0
- data/lib/fontisan/config/features.yml +143 -0
- data/lib/fontisan/config/scripts.yml +42 -0
- data/lib/fontisan/config/subset_profiles.yml +106 -0
- data/lib/fontisan/config/svg_settings.yml +60 -0
- data/lib/fontisan/config/variable_settings.yml +99 -0
- data/lib/fontisan/config/woff2_settings.yml +77 -0
- data/lib/fontisan/constants.rb +219 -0
- data/lib/fontisan/conversion_options.rb +389 -0
- data/lib/fontisan/converters/cff_table_builder.rb +195 -0
- data/lib/fontisan/converters/collection_converter.rb +520 -0
- data/lib/fontisan/converters/conversion_strategy.rb +211 -0
- data/lib/fontisan/converters/format_converter.rb +536 -0
- data/lib/fontisan/converters/glyf_table_builder.rb +61 -0
- data/lib/fontisan/converters/outline_converter.rb +720 -0
- data/lib/fontisan/converters/outline_extraction.rb +88 -0
- data/lib/fontisan/converters/outline_optimizer.rb +84 -0
- data/lib/fontisan/converters/svg_generator.rb +236 -0
- data/lib/fontisan/converters/table_copier.rb +107 -0
- data/lib/fontisan/converters/type1_converter.rb +1201 -0
- data/lib/fontisan/converters/woff2_encoder.rb +520 -0
- data/lib/fontisan/converters/woff_writer.rb +358 -0
- data/lib/fontisan/converters.rb +21 -0
- data/lib/fontisan/dfont_collection.rb +288 -0
- data/lib/fontisan/engine.rb +393 -0
- data/lib/fontisan/error.rb +281 -0
- data/lib/fontisan/export/exporter.rb +255 -0
- data/lib/fontisan/export/table_serializer.rb +140 -0
- data/lib/fontisan/export/transformers/font_to_ttx.rb +163 -0
- data/lib/fontisan/export/transformers/head_transformer.rb +94 -0
- data/lib/fontisan/export/transformers/hhea_transformer.rb +57 -0
- data/lib/fontisan/export/transformers/maxp_transformer.rb +61 -0
- data/lib/fontisan/export/transformers/name_transformer.rb +61 -0
- data/lib/fontisan/export/transformers/os2_transformer.rb +119 -0
- data/lib/fontisan/export/transformers/post_transformer.rb +49 -0
- data/lib/fontisan/export/transformers.rb +17 -0
- data/lib/fontisan/export/ttx_generator.rb +526 -0
- data/lib/fontisan/export/ttx_parser.rb +300 -0
- data/lib/fontisan/export.rb +13 -0
- data/lib/fontisan/ffi/client.rb +123 -0
- data/lib/fontisan/ffi/libfontisan_cdylib.so +0 -0
- data/lib/fontisan/ffi.rb +387 -0
- data/lib/fontisan/ffi_platform.rb +24 -0
- data/lib/fontisan/font_loader.rb +315 -0
- data/lib/fontisan/font_writer.rb +309 -0
- data/lib/fontisan/formatters/text_formatter.rb +517 -0
- data/lib/fontisan/formatters.rb +9 -0
- data/lib/fontisan/glyph_accessor.rb +525 -0
- data/lib/fontisan/hints/hint_converter.rb +309 -0
- data/lib/fontisan/hints/hint_validator.rb +287 -0
- data/lib/fontisan/hints/postscript_hint_applier.rb +255 -0
- data/lib/fontisan/hints/postscript_hint_extractor.rb +347 -0
- data/lib/fontisan/hints/truetype_hint_applier.rb +117 -0
- data/lib/fontisan/hints/truetype_hint_extractor.rb +283 -0
- data/lib/fontisan/hints/truetype_instruction_analyzer.rb +268 -0
- data/lib/fontisan/hints/truetype_instruction_generator.rb +266 -0
- data/lib/fontisan/hints.rb +19 -0
- data/lib/fontisan/loading_modes.rb +113 -0
- data/lib/fontisan/metrics_calculator.rb +275 -0
- data/lib/fontisan/models/all_scripts_features_info.rb +20 -0
- data/lib/fontisan/models/audit_report.rb +196 -0
- data/lib/fontisan/models/bitmap_glyph.rb +123 -0
- data/lib/fontisan/models/bitmap_strike.rb +94 -0
- data/lib/fontisan/models/collection_brief_info.rb +36 -0
- data/lib/fontisan/models/collection_font_summary.rb +52 -0
- data/lib/fontisan/models/collection_info.rb +79 -0
- data/lib/fontisan/models/collection_list_info.rb +36 -0
- data/lib/fontisan/models/collection_validation_report.rb +102 -0
- data/lib/fontisan/models/color_glyph.rb +56 -0
- data/lib/fontisan/models/color_layer.rb +53 -0
- data/lib/fontisan/models/color_palette.rb +60 -0
- data/lib/fontisan/models/features_info.rb +42 -0
- data/lib/fontisan/models/font_export.rb +158 -0
- data/lib/fontisan/models/font_info.rb +98 -0
- data/lib/fontisan/models/font_report.rb +23 -0
- data/lib/fontisan/models/font_summary.rb +48 -0
- data/lib/fontisan/models/glyph_info.rb +26 -0
- data/lib/fontisan/models/glyph_outline.rb +343 -0
- data/lib/fontisan/models/hint.rb +404 -0
- data/lib/fontisan/models/optical_size_info.rb +33 -0
- data/lib/fontisan/models/outline.rb +667 -0
- data/lib/fontisan/models/scripts_info.rb +39 -0
- data/lib/fontisan/models/svg_glyph.rb +89 -0
- data/lib/fontisan/models/table_info.rb +55 -0
- data/lib/fontisan/models/table_sharing_info.rb +40 -0
- data/lib/fontisan/models/ttx/glyph_order.rb +31 -0
- data/lib/fontisan/models/ttx/tables/binary_table.rb +67 -0
- data/lib/fontisan/models/ttx/tables/head_table.rb +74 -0
- data/lib/fontisan/models/ttx/tables/hhea_table.rb +74 -0
- data/lib/fontisan/models/ttx/tables/maxp_table.rb +55 -0
- data/lib/fontisan/models/ttx/tables/name_table.rb +45 -0
- data/lib/fontisan/models/ttx/tables/os2_table.rb +157 -0
- data/lib/fontisan/models/ttx/tables/post_table.rb +50 -0
- data/lib/fontisan/models/ttx/tables.rb +21 -0
- data/lib/fontisan/models/ttx/ttfont.rb +41 -0
- data/lib/fontisan/models/ttx.rb +14 -0
- data/lib/fontisan/models/unicode_mappings.rb +42 -0
- data/lib/fontisan/models/validation_report.rb +435 -0
- data/lib/fontisan/models/variable_font_info.rb +82 -0
- data/lib/fontisan/models.rb +49 -0
- data/lib/fontisan/native/3.2/fontisan_native.so +0 -0
- data/lib/fontisan/native/3.3/fontisan_native.so +0 -0
- data/lib/fontisan/native/3.4/fontisan_native.so +0 -0
- data/lib/fontisan/native/4.0/fontisan_native.so +0 -0
- data/lib/fontisan/native.rb +235 -0
- data/lib/fontisan/open_type_collection.rb +49 -0
- data/lib/fontisan/open_type_font.rb +161 -0
- data/lib/fontisan/open_type_font_extensions.rb +54 -0
- data/lib/fontisan/optimizers/charstring_rewriter.rb +172 -0
- data/lib/fontisan/optimizers/pattern_analyzer.rb +310 -0
- data/lib/fontisan/optimizers/stack_tracker.rb +246 -0
- data/lib/fontisan/optimizers/subroutine_builder.rb +135 -0
- data/lib/fontisan/optimizers/subroutine_generator.rb +207 -0
- data/lib/fontisan/optimizers/subroutine_optimizer.rb +114 -0
- data/lib/fontisan/optimizers.rb +14 -0
- data/lib/fontisan/outline_extractor.rb +417 -0
- data/lib/fontisan/output_guard.rb +40 -0
- data/lib/fontisan/parsers/dfont_parser.rb +191 -0
- data/lib/fontisan/parsers/tag.rb +77 -0
- data/lib/fontisan/parsers.rb +10 -0
- data/lib/fontisan/pipeline/format_detector.rb +176 -0
- data/lib/fontisan/pipeline/output_writer.rb +161 -0
- data/lib/fontisan/pipeline/strategies/base_strategy.rb +75 -0
- data/lib/fontisan/pipeline/strategies/instance_strategy.rb +89 -0
- data/lib/fontisan/pipeline/strategies/named_strategy.rb +114 -0
- data/lib/fontisan/pipeline/strategies/preserve_strategy.rb +54 -0
- data/lib/fontisan/pipeline/strategies.rb +16 -0
- data/lib/fontisan/pipeline/transformation_pipeline.rb +407 -0
- data/lib/fontisan/pipeline/variation_resolver.rb +158 -0
- data/lib/fontisan/pipeline.rb +14 -0
- data/lib/fontisan/reference/table_digests.rb +251 -0
- data/lib/fontisan/reference.rb +663 -0
- data/lib/fontisan/scan.rb +372 -0
- data/lib/fontisan/sfnt_builder.rb +66 -0
- data/lib/fontisan/sfnt_directory.rb +41 -0
- data/lib/fontisan/sfnt_font.rb +749 -0
- data/lib/fontisan/sfnt_source.rb +28 -0
- data/lib/fontisan/sfnt_table.rb +260 -0
- data/lib/fontisan/stitcher/cbdt_propagator.rb +212 -0
- data/lib/fontisan/stitcher/collection_result.rb +19 -0
- data/lib/fontisan/stitcher/deduplicator.rb +47 -0
- data/lib/fontisan/stitcher/format_metadata.rb +51 -0
- data/lib/fontisan/stitcher/glyph_cloner.rb +41 -0
- data/lib/fontisan/stitcher/glyph_copier.rb +110 -0
- data/lib/fontisan/stitcher/glyph_limit.rb +53 -0
- data/lib/fontisan/stitcher/glyph_signature.rb +51 -0
- data/lib/fontisan/stitcher/partition_strategy/base.rb +52 -0
- data/lib/fontisan/stitcher/partition_strategy/blueprint.rb +24 -0
- data/lib/fontisan/stitcher/partition_strategy/by_block.rb +430 -0
- data/lib/fontisan/stitcher/partition_strategy/by_plane.rb +161 -0
- data/lib/fontisan/stitcher/partition_strategy/by_script.rb +309 -0
- data/lib/fontisan/stitcher/partition_strategy/partition.rb +24 -0
- data/lib/fontisan/stitcher/partition_strategy.rb +24 -0
- data/lib/fontisan/stitcher/selector/codepoints.rb +29 -0
- data/lib/fontisan/stitcher/selector/gid.rb +25 -0
- data/lib/fontisan/stitcher/selector/range.rb +30 -0
- data/lib/fontisan/stitcher/selector.rb +26 -0
- data/lib/fontisan/stitcher/source.rb +459 -0
- data/lib/fontisan/stitcher/unique_glyph_name.rb +46 -0
- data/lib/fontisan/stitcher.rb +185 -0
- data/lib/fontisan/stitcher_cli.rb +69 -0
- data/lib/fontisan/subset/builder.rb +263 -0
- data/lib/fontisan/subset/glyph_mapping.rb +222 -0
- data/lib/fontisan/subset/options.rb +142 -0
- data/lib/fontisan/subset/profile.rb +152 -0
- data/lib/fontisan/subset/shared_state.rb +42 -0
- data/lib/fontisan/subset/subset_context.rb +20 -0
- data/lib/fontisan/subset/table_strategy/cbdt.rb +30 -0
- data/lib/fontisan/subset/table_strategy/cblc.rb +27 -0
- data/lib/fontisan/subset/table_strategy/cff.rb +92 -0
- data/lib/fontisan/subset/table_strategy/cff2.rb +391 -0
- data/lib/fontisan/subset/table_strategy/cmap.rb +146 -0
- data/lib/fontisan/subset/table_strategy/color_bitmap_placement.rb +20 -0
- data/lib/fontisan/subset/table_strategy/color_bitmap_strike_plan.rb +45 -0
- data/lib/fontisan/subset/table_strategy/color_bitmap_subset_plan.rb +62 -0
- data/lib/fontisan/subset/table_strategy/color_bitmap_subsetter.rb +182 -0
- data/lib/fontisan/subset/table_strategy/color_bitmap_subtable_plan.rb +59 -0
- data/lib/fontisan/subset/table_strategy/glyf.rb +29 -0
- data/lib/fontisan/subset/table_strategy/glyf_loca_builder.rb +146 -0
- data/lib/fontisan/subset/table_strategy/head.rb +43 -0
- data/lib/fontisan/subset/table_strategy/hhea.rb +67 -0
- data/lib/fontisan/subset/table_strategy/hmtx.rb +52 -0
- data/lib/fontisan/subset/table_strategy/loca.rb +41 -0
- data/lib/fontisan/subset/table_strategy/maxp.rb +23 -0
- data/lib/fontisan/subset/table_strategy/name.rb +19 -0
- data/lib/fontisan/subset/table_strategy/os2.rb +21 -0
- data/lib/fontisan/subset/table_strategy/pass_through.rb +20 -0
- data/lib/fontisan/subset/table_strategy/post.rb +37 -0
- data/lib/fontisan/subset/table_strategy.rb +79 -0
- data/lib/fontisan/subset/table_subsetter.rb +110 -0
- data/lib/fontisan/subset.rb +16 -0
- data/lib/fontisan/svg/font_face_generator.rb +274 -0
- data/lib/fontisan/svg/font_generator.rb +256 -0
- data/lib/fontisan/svg/glyph_generator.rb +201 -0
- data/lib/fontisan/svg/standalone_glyph.rb +132 -0
- data/lib/fontisan/svg/view_box_calculator.rb +137 -0
- data/lib/fontisan/svg.rb +13 -0
- data/lib/fontisan/svg_to_glyf/assembler.rb +174 -0
- data/lib/fontisan/svg_to_glyf/document.rb +102 -0
- data/lib/fontisan/svg_to_glyf/geometry/affine_transform.rb +112 -0
- data/lib/fontisan/svg_to_glyf/geometry/normalizer.rb +62 -0
- data/lib/fontisan/svg_to_glyf/geometry/transform_parser.rb +98 -0
- data/lib/fontisan/svg_to_glyf/geometry.rb +15 -0
- data/lib/fontisan/svg_to_glyf/path/command.rb +18 -0
- data/lib/fontisan/svg_to_glyf/path/contour_builder.rb +140 -0
- data/lib/fontisan/svg_to_glyf/path/parser.rb +98 -0
- data/lib/fontisan/svg_to_glyf/path/state.rb +79 -0
- data/lib/fontisan/svg_to_glyf/path.rb +14 -0
- data/lib/fontisan/svg_to_glyf.rb +62 -0
- data/lib/fontisan/tables/cbdt.rb +113 -0
- data/lib/fontisan/tables/cblc.rb +172 -0
- data/lib/fontisan/tables/cblc_big_glyph_metrics.rb +28 -0
- data/lib/fontisan/tables/cblc_bitmap_size.rb +67 -0
- data/lib/fontisan/tables/cblc_glyph_bitmap_location.rb +28 -0
- data/lib/fontisan/tables/cblc_index_subtable.rb +104 -0
- data/lib/fontisan/tables/cblc_index_subtable_array_entry.rb +20 -0
- data/lib/fontisan/tables/cblc_index_subtable_format_parser.rb +150 -0
- data/lib/fontisan/tables/cblc_index_subtable_header.rb +18 -0
- data/lib/fontisan/tables/cblc_sbit_line_metrics.rb +28 -0
- data/lib/fontisan/tables/cff/cff2_charstring_builder.rb +225 -0
- data/lib/fontisan/tables/cff/cff_glyph.rb +176 -0
- data/lib/fontisan/tables/cff/charset.rb +276 -0
- data/lib/fontisan/tables/cff/charstring.rb +978 -0
- data/lib/fontisan/tables/cff/charstring_builder.rb +356 -0
- data/lib/fontisan/tables/cff/charstring_parser.rb +249 -0
- data/lib/fontisan/tables/cff/charstring_rebuilder.rb +168 -0
- data/lib/fontisan/tables/cff/charstrings_index.rb +159 -0
- data/lib/fontisan/tables/cff/dict.rb +353 -0
- data/lib/fontisan/tables/cff/dict_builder.rb +260 -0
- data/lib/fontisan/tables/cff/encoding.rb +273 -0
- data/lib/fontisan/tables/cff/expert_charsets.rb +85 -0
- data/lib/fontisan/tables/cff/header.rb +100 -0
- data/lib/fontisan/tables/cff/hint_operation_injector.rb +207 -0
- data/lib/fontisan/tables/cff/index.rb +241 -0
- data/lib/fontisan/tables/cff/index_builder.rb +170 -0
- data/lib/fontisan/tables/cff/offset_recalculator.rb +70 -0
- data/lib/fontisan/tables/cff/private_dict.rb +282 -0
- data/lib/fontisan/tables/cff/private_dict_writer.rb +129 -0
- data/lib/fontisan/tables/cff/standard_strings_data.rb +83 -0
- data/lib/fontisan/tables/cff/table_builder.rb +215 -0
- data/lib/fontisan/tables/cff/top_dict.rb +234 -0
- data/lib/fontisan/tables/cff.rb +497 -0
- data/lib/fontisan/tables/cff2/blend_operator.rb +240 -0
- data/lib/fontisan/tables/cff2/charstring_parser.rb +624 -0
- data/lib/fontisan/tables/cff2/dict_encoder.rb +94 -0
- data/lib/fontisan/tables/cff2/fd_select.rb +142 -0
- data/lib/fontisan/tables/cff2/header.rb +34 -0
- data/lib/fontisan/tables/cff2/index.rb +155 -0
- data/lib/fontisan/tables/cff2/index_builder.rb +80 -0
- data/lib/fontisan/tables/cff2/operand_stack.rb +232 -0
- data/lib/fontisan/tables/cff2/private_dict_blend_handler.rb +247 -0
- data/lib/fontisan/tables/cff2/region_matcher.rb +200 -0
- data/lib/fontisan/tables/cff2/table_builder.rb +567 -0
- data/lib/fontisan/tables/cff2/table_reader.rb +418 -0
- data/lib/fontisan/tables/cff2/variation_data_extractor.rb +212 -0
- data/lib/fontisan/tables/cff2.rb +353 -0
- data/lib/fontisan/tables/cmap.rb +399 -0
- data/lib/fontisan/tables/cmap_table.rb +228 -0
- data/lib/fontisan/tables/colr.rb +290 -0
- data/lib/fontisan/tables/cpal.rb +381 -0
- data/lib/fontisan/tables/cvar.rb +204 -0
- data/lib/fontisan/tables/fvar.rb +159 -0
- data/lib/fontisan/tables/glyf/compound_glyph.rb +482 -0
- data/lib/fontisan/tables/glyf/compound_glyph_resolver.rb +135 -0
- data/lib/fontisan/tables/glyf/curve_converter.rb +349 -0
- data/lib/fontisan/tables/glyf/glyph_builder.rb +468 -0
- data/lib/fontisan/tables/glyf/simple_glyph.rb +391 -0
- data/lib/fontisan/tables/glyf.rb +347 -0
- data/lib/fontisan/tables/glyf_table.rb +252 -0
- data/lib/fontisan/tables/gpos/glyph_filter.rb +87 -0
- data/lib/fontisan/tables/gpos/kerning_pairs.rb +215 -0
- data/lib/fontisan/tables/gpos/pair_position.rb +274 -0
- data/lib/fontisan/tables/gpos.rb +139 -0
- data/lib/fontisan/tables/gsub.rb +116 -0
- data/lib/fontisan/tables/gvar.rb +232 -0
- data/lib/fontisan/tables/head.rb +208 -0
- data/lib/fontisan/tables/head_table.rb +108 -0
- data/lib/fontisan/tables/hhea.rb +199 -0
- data/lib/fontisan/tables/hhea_table.rb +252 -0
- data/lib/fontisan/tables/hmtx.rb +281 -0
- data/lib/fontisan/tables/hmtx_table.rb +188 -0
- data/lib/fontisan/tables/hvar.rb +192 -0
- data/lib/fontisan/tables/layout_common.rb +245 -0
- data/lib/fontisan/tables/loca.rb +323 -0
- data/lib/fontisan/tables/loca_table.rb +209 -0
- data/lib/fontisan/tables/maxp.rb +253 -0
- data/lib/fontisan/tables/maxp_table.rb +255 -0
- data/lib/fontisan/tables/mvar.rb +185 -0
- data/lib/fontisan/tables/name.rb +340 -0
- data/lib/fontisan/tables/name_table.rb +173 -0
- data/lib/fontisan/tables/os2.rb +291 -0
- data/lib/fontisan/tables/os2_table.rb +326 -0
- data/lib/fontisan/tables/post.rb +206 -0
- data/lib/fontisan/tables/post_table.rb +180 -0
- data/lib/fontisan/tables/registry.rb +71 -0
- data/lib/fontisan/tables/sbix.rb +379 -0
- data/lib/fontisan/tables/svg.rb +300 -0
- data/lib/fontisan/tables/variation_common.rb +345 -0
- data/lib/fontisan/tables/vvar.rb +234 -0
- data/lib/fontisan/tables.rb +69 -0
- data/lib/fontisan/true_type_collection.rb +160 -0
- data/lib/fontisan/true_type_font.rb +80 -0
- data/lib/fontisan/true_type_font_extensions.rb +54 -0
- data/lib/fontisan/type1/afm_generator.rb +379 -0
- data/lib/fontisan/type1/afm_parser.rb +299 -0
- data/lib/fontisan/type1/agl.rb +456 -0
- data/lib/fontisan/type1/cff_to_type1_converter.rb +307 -0
- data/lib/fontisan/type1/charstring_converter.rb +238 -0
- data/lib/fontisan/type1/charstrings.rb +441 -0
- data/lib/fontisan/type1/conversion_options.rb +242 -0
- data/lib/fontisan/type1/decryptor.rb +183 -0
- data/lib/fontisan/type1/encodings.rb +695 -0
- data/lib/fontisan/type1/font_dictionary.rb +576 -0
- data/lib/fontisan/type1/generator.rb +217 -0
- data/lib/fontisan/type1/inf_generator.rb +307 -0
- data/lib/fontisan/type1/pfa_generator.rb +376 -0
- data/lib/fontisan/type1/pfa_parser.rb +159 -0
- data/lib/fontisan/type1/pfb_generator.rb +321 -0
- data/lib/fontisan/type1/pfb_parser.rb +166 -0
- data/lib/fontisan/type1/pfm_generator.rb +589 -0
- data/lib/fontisan/type1/pfm_parser.rb +433 -0
- data/lib/fontisan/type1/private_dict.rb +363 -0
- data/lib/fontisan/type1/seac_expander.rb +517 -0
- data/lib/fontisan/type1/ttf_to_type1_converter.rb +389 -0
- data/lib/fontisan/type1/upm_scaler.rb +118 -0
- data/lib/fontisan/type1.rb +48 -0
- data/lib/fontisan/type1_font.rb +347 -0
- data/lib/fontisan/ufo/anchor.rb +17 -0
- data/lib/fontisan/ufo/bounds.rb +91 -0
- data/lib/fontisan/ufo/cli.rb +105 -0
- data/lib/fontisan/ufo/compile/avar.rb +46 -0
- data/lib/fontisan/ufo/compile/base_compiler.rb +162 -0
- data/lib/fontisan/ufo/compile/cbdt_cblc.rb +104 -0
- data/lib/fontisan/ufo/compile/cff.rb +229 -0
- data/lib/fontisan/ufo/compile/cff2.rb +323 -0
- data/lib/fontisan/ufo/compile/cff2_subroutines.rb +39 -0
- data/lib/fontisan/ufo/compile/cmap.rb +143 -0
- data/lib/fontisan/ufo/compile/colr.rb +80 -0
- data/lib/fontisan/ufo/compile/cpal.rb +62 -0
- data/lib/fontisan/ufo/compile/feature_compiler.rb +161 -0
- data/lib/fontisan/ufo/compile/feature_writers/base.rb +56 -0
- data/lib/fontisan/ufo/compile/feature_writers/curs.rb +72 -0
- data/lib/fontisan/ufo/compile/feature_writers/gdef.rb +92 -0
- data/lib/fontisan/ufo/compile/feature_writers/kern.rb +50 -0
- data/lib/fontisan/ufo/compile/feature_writers/kern2.rb +57 -0
- data/lib/fontisan/ufo/compile/feature_writers/mark.rb +45 -0
- data/lib/fontisan/ufo/compile/feature_writers/mark_family_base.rb +124 -0
- data/lib/fontisan/ufo/compile/feature_writers/mkmk.rb +53 -0
- data/lib/fontisan/ufo/compile/feature_writers.rb +38 -0
- data/lib/fontisan/ufo/compile/filters/cubic_to_quadratic.rb +176 -0
- data/lib/fontisan/ufo/compile/filters/decompose_components.rb +33 -0
- data/lib/fontisan/ufo/compile/filters/flatten_components.rb +22 -0
- data/lib/fontisan/ufo/compile/filters/propagate_anchors.rb +102 -0
- data/lib/fontisan/ufo/compile/filters/remove_overlaps.rb +95 -0
- data/lib/fontisan/ufo/compile/filters/reverse_contour_direction.rb +27 -0
- data/lib/fontisan/ufo/compile/filters/sort_contours.rb +69 -0
- data/lib/fontisan/ufo/compile/filters/transformations.rb +113 -0
- data/lib/fontisan/ufo/compile/filters.rb +69 -0
- data/lib/fontisan/ufo/compile/fvar.rb +113 -0
- data/lib/fontisan/ufo/compile/glyf_loca.rb +206 -0
- data/lib/fontisan/ufo/compile/gpos.rb +248 -0
- data/lib/fontisan/ufo/compile/gsub.rb +267 -0
- data/lib/fontisan/ufo/compile/gvar.rb +225 -0
- data/lib/fontisan/ufo/compile/head.rb +97 -0
- data/lib/fontisan/ufo/compile/hhea.rb +57 -0
- data/lib/fontisan/ufo/compile/hmtx.rb +38 -0
- data/lib/fontisan/ufo/compile/hvar.rb +42 -0
- data/lib/fontisan/ufo/compile/item_variation_store.rb +100 -0
- data/lib/fontisan/ufo/compile/math.rb +143 -0
- data/lib/fontisan/ufo/compile/maxp.rb +57 -0
- data/lib/fontisan/ufo/compile/meta.rb +51 -0
- data/lib/fontisan/ufo/compile/mvar.rb +59 -0
- data/lib/fontisan/ufo/compile/name.rb +81 -0
- data/lib/fontisan/ufo/compile/os2.rb +81 -0
- data/lib/fontisan/ufo/compile/otf2_compiler.rb +40 -0
- data/lib/fontisan/ufo/compile/otf_compiler.rb +34 -0
- data/lib/fontisan/ufo/compile/post.rb +32 -0
- data/lib/fontisan/ufo/compile/sbix.rb +100 -0
- data/lib/fontisan/ufo/compile/stat.rb +106 -0
- data/lib/fontisan/ufo/compile/svg_table.rb +60 -0
- data/lib/fontisan/ufo/compile/ttf_compiler.rb +75 -0
- data/lib/fontisan/ufo/compile/variable_otf.rb +84 -0
- data/lib/fontisan/ufo/compile/variable_ttf.rb +161 -0
- data/lib/fontisan/ufo/compile.rb +72 -0
- data/lib/fontisan/ufo/component.rb +18 -0
- data/lib/fontisan/ufo/contour.rb +34 -0
- data/lib/fontisan/ufo/convert/from_bin_data.rb +366 -0
- data/lib/fontisan/ufo/convert/to_dfont.rb +45 -0
- data/lib/fontisan/ufo/convert/to_otc.rb +40 -0
- data/lib/fontisan/ufo/convert/to_otf.rb +18 -0
- data/lib/fontisan/ufo/convert/to_otf2.rb +20 -0
- data/lib/fontisan/ufo/convert/to_postscript.rb +64 -0
- data/lib/fontisan/ufo/convert/to_ttc.rb +35 -0
- data/lib/fontisan/ufo/convert/to_ttf.rb +21 -0
- data/lib/fontisan/ufo/convert/to_woff.rb +61 -0
- data/lib/fontisan/ufo/convert/to_woff2.rb +50 -0
- data/lib/fontisan/ufo/convert.rb +84 -0
- data/lib/fontisan/ufo/data_set.rb +21 -0
- data/lib/fontisan/ufo/features.rb +17 -0
- data/lib/fontisan/ufo/font.rb +63 -0
- data/lib/fontisan/ufo/glyph.rb +445 -0
- data/lib/fontisan/ufo/glyph_exists_error.rb +23 -0
- data/lib/fontisan/ufo/groups.rb +45 -0
- data/lib/fontisan/ufo/guideline.rb +19 -0
- data/lib/fontisan/ufo/image.rb +29 -0
- data/lib/fontisan/ufo/image_set.rb +99 -0
- data/lib/fontisan/ufo/info.rb +133 -0
- data/lib/fontisan/ufo/kerning.rb +32 -0
- data/lib/fontisan/ufo/layer.rb +78 -0
- data/lib/fontisan/ufo/layer_set.rb +37 -0
- data/lib/fontisan/ufo/lib.rb +24 -0
- data/lib/fontisan/ufo/plist.rb +123 -0
- data/lib/fontisan/ufo/point.rb +32 -0
- data/lib/fontisan/ufo/reader.rb +163 -0
- data/lib/fontisan/ufo/transformation.rb +50 -0
- data/lib/fontisan/ufo/writer.rb +123 -0
- data/lib/fontisan/ufo.rb +47 -0
- data/lib/fontisan/unicode/plane.rb +44 -0
- data/lib/fontisan/unicode.rb +17 -0
- data/lib/fontisan/utilities/brotli_wrapper.rb +177 -0
- data/lib/fontisan/utilities/checksum_calculator.rb +104 -0
- data/lib/fontisan/utilities/padding.rb +61 -0
- data/lib/fontisan/utilities.rb +11 -0
- data/lib/fontisan/utils/thread_pool.rb +134 -0
- data/lib/fontisan/utils.rb +10 -0
- data/lib/fontisan/validation/collection_validator.rb +265 -0
- data/lib/fontisan/validation.rb +9 -0
- data/lib/fontisan/validators/basic_validator.rb +73 -0
- data/lib/fontisan/validators/font_book_validator.rb +107 -0
- data/lib/fontisan/validators/opentype_validator.rb +118 -0
- data/lib/fontisan/validators/profile_loader.rb +134 -0
- data/lib/fontisan/validators/validator.rb +494 -0
- data/lib/fontisan/validators/web_font_validator.rb +95 -0
- data/lib/fontisan/validators.rb +14 -0
- data/lib/fontisan/variable/axis_normalizer.rb +215 -0
- data/lib/fontisan/variable/delta_applicator.rb +302 -0
- data/lib/fontisan/variable/glyph_delta_processor.rb +218 -0
- data/lib/fontisan/variable/instancer.rb +172 -0
- data/lib/fontisan/variable/metric_delta_processor.rb +282 -0
- data/lib/fontisan/variable/region_matcher.rb +208 -0
- data/lib/fontisan/variable/static_font_builder.rb +209 -0
- data/lib/fontisan/variable/table_updater.rb +219 -0
- data/lib/fontisan/variable.rb +16 -0
- data/lib/fontisan/variation/blend_applier.rb +197 -0
- data/lib/fontisan/variation/cache.rb +299 -0
- data/lib/fontisan/variation/cache_key_builder.rb +162 -0
- data/lib/fontisan/variation/converter.rb +373 -0
- data/lib/fontisan/variation/data_extractor.rb +84 -0
- data/lib/fontisan/variation/delta_applier.rb +262 -0
- data/lib/fontisan/variation/delta_parser.rb +228 -0
- data/lib/fontisan/variation/inspector.rb +275 -0
- data/lib/fontisan/variation/instance_font_wrapper.rb +41 -0
- data/lib/fontisan/variation/instance_generator.rb +122 -0
- data/lib/fontisan/variation/instance_writer.rb +360 -0
- data/lib/fontisan/variation/instancing/axis_space.rb +136 -0
- data/lib/fontisan/variation/instancing/glyph_outline.rb +204 -0
- data/lib/fontisan/variation/instancing/gvar_reader.rb +146 -0
- data/lib/fontisan/variation/instancing/item_variation_store.rb +92 -0
- data/lib/fontisan/variation/instancing/name_rewriter.rb +90 -0
- data/lib/fontisan/variation/instancing/true_type_instancer.rb +326 -0
- data/lib/fontisan/variation/instancing.rb +20 -0
- data/lib/fontisan/variation/interpolator.rb +231 -0
- data/lib/fontisan/variation/metrics_adjuster.rb +309 -0
- data/lib/fontisan/variation/optimizer.rb +417 -0
- data/lib/fontisan/variation/parallel_generator.rb +147 -0
- data/lib/fontisan/variation/region_matcher.rb +221 -0
- data/lib/fontisan/variation/subsetter.rb +400 -0
- data/lib/fontisan/variation/table_accessor.rb +105 -0
- data/lib/fontisan/variation/tuple_variation_header.rb +49 -0
- data/lib/fontisan/variation/validator.rb +336 -0
- data/lib/fontisan/variation/variable_svg_generator.rb +235 -0
- data/lib/fontisan/variation/variation_context.rb +208 -0
- data/lib/fontisan/variation/variation_preserver.rb +287 -0
- data/lib/fontisan/variation.rb +33 -0
- data/lib/fontisan/version.rb +5 -0
- data/lib/fontisan/version.rb.orig +9 -0
- data/lib/fontisan/woff2/collection_decoder.rb +223 -0
- data/lib/fontisan/woff2/collection_encoder.rb +302 -0
- data/lib/fontisan/woff2/directory.rb +255 -0
- data/lib/fontisan/woff2/encoder_rules.rb +114 -0
- data/lib/fontisan/woff2/glyf_canonicalizer.rb +90 -0
- data/lib/fontisan/woff2/glyf_loca_reconstruct.rb +401 -0
- data/lib/fontisan/woff2/glyf_loca_transform.rb +319 -0
- data/lib/fontisan/woff2/header.rb +101 -0
- data/lib/fontisan/woff2/hmtx_transformer.rb +140 -0
- data/lib/fontisan/woff2/sfnt_checksum.rb +107 -0
- data/lib/fontisan/woff2/table_transformer.rb +575 -0
- data/lib/fontisan/woff2/triplet_codec.rb +181 -0
- data/lib/fontisan/woff2/uint255.rb +101 -0
- data/lib/fontisan/woff2.rb +21 -0
- data/lib/fontisan/woff2_collection.rb +127 -0
- data/lib/fontisan/woff2_font.rb +754 -0
- data/lib/fontisan/woff_container.rb +83 -0
- data/lib/fontisan/woff_font.rb +554 -0
- data/lib/fontisan.rb +299 -0
- data/rakelib/bench.rake +9 -0
- data/rakelib/cdylib.rake +39 -0
- data/rakelib/corpus.rake +272 -0
- data/rakelib/corpus_convert.rake +43 -0
- data/rakelib/corpus_goldens.rake +22 -0
- data/rakelib/corpus_malformed.rake +20 -0
- data/rakelib/corpus_scan.rake +24 -0
- data/rakelib/java.rake +61 -0
- data/rakelib/native.rake +43 -0
- data/scripts/build-woff2.sh +57 -0
- data/scripts/compare_stack_aware.rb +187 -0
- data/scripts/corpus/generate_convert_goldens.rb +478 -0
- data/scripts/corpus/generate_goldens.rb +282 -0
- data/scripts/corpus/generate_malformed_goldens.rb +254 -0
- data/scripts/corpus/generate_scan_goldens.rb +98 -0
- data/scripts/measure_optimization.rb +148 -0
- data/scripts/tier_fallback.rb +228 -0
- data/scripts/tier_smoke.rb +72 -0
- metadata +945 -0
data/lib/fontisan/cli.rb
ADDED
|
@@ -0,0 +1,1111 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
require "thor"
|
|
4
|
+
|
|
5
|
+
module Fontisan
|
|
6
|
+
# Command-line interface for Fontisan.
|
|
7
|
+
#
|
|
8
|
+
# This class provides the Thor-based CLI with commands for extracting
|
|
9
|
+
# font information and listing tables. It supports multiple output formats
|
|
10
|
+
# (text, YAML, JSON) and various options for controlling output behavior.
|
|
11
|
+
#
|
|
12
|
+
# @example Run the info command
|
|
13
|
+
# Fontisan::Cli.start(['info', 'font.ttf'])
|
|
14
|
+
class Cli < Thor
|
|
15
|
+
# A Thor::Error (unknown command, missing --output) must fail the process:
|
|
16
|
+
# without this Thor exits 0 and prints a deprecation warning.
|
|
17
|
+
def self.exit_on_failure?
|
|
18
|
+
true
|
|
19
|
+
end
|
|
20
|
+
|
|
21
|
+
class_option :format, type: :string, default: "text",
|
|
22
|
+
desc: "Output format (text, yaml, json)",
|
|
23
|
+
aliases: "-f"
|
|
24
|
+
class_option :font_index, type: :numeric, default: 0,
|
|
25
|
+
desc: "Font index for TTC files",
|
|
26
|
+
aliases: "-i"
|
|
27
|
+
class_option :verbose, type: :boolean, default: false,
|
|
28
|
+
desc: "Enable verbose output",
|
|
29
|
+
aliases: "-v"
|
|
30
|
+
class_option :quiet, type: :boolean, default: false,
|
|
31
|
+
desc: "Suppress non-error output",
|
|
32
|
+
aliases: "-q"
|
|
33
|
+
|
|
34
|
+
desc "ufo", "UFO source operations (build, convert, validate)"
|
|
35
|
+
subcommand "ufo", Fontisan::Ufo::Cli
|
|
36
|
+
|
|
37
|
+
desc "stitch", "Stitch glyphs from multiple source fonts into one output"
|
|
38
|
+
subcommand "stitch", StitcherCli
|
|
39
|
+
|
|
40
|
+
desc "audit FONT_FILE", "Produce a structured audit report (identity, style, coverage, layout)"
|
|
41
|
+
option :output, type: :string,
|
|
42
|
+
desc: "Output file path. For collections, use a directory path."
|
|
43
|
+
option :no_codepoints, type: :boolean, default: false,
|
|
44
|
+
desc: "Omit the codepoint list from the report"
|
|
45
|
+
option :font_index, type: :numeric, default: nil,
|
|
46
|
+
desc: "Audit only the given face of a collection"
|
|
47
|
+
option :validate, type: :string, default: nil,
|
|
48
|
+
desc: "Run validation checks. Use 'true' for all, or a " \
|
|
49
|
+
"profile name: default, structural, ots, layout, " \
|
|
50
|
+
"variable, hinting, web, spec, per_table"
|
|
51
|
+
option :list_profiles, type: :boolean, default: false,
|
|
52
|
+
desc: "List available validation profiles and exit"
|
|
53
|
+
option :fail_on_error, type: :boolean, default: true,
|
|
54
|
+
desc: "Exit with code 1 if validation finds errors " \
|
|
55
|
+
"(only applies with --validate)"
|
|
56
|
+
# Produce a structured font audit report (YAML or JSON).
|
|
57
|
+
def audit(font_file = nil)
|
|
58
|
+
return list_audit_profiles if options[:list_profiles]
|
|
59
|
+
|
|
60
|
+
raise Thor::Error, "FONT_FILE is required" if font_file.nil?
|
|
61
|
+
|
|
62
|
+
cmd_options = options.dup
|
|
63
|
+
cmd_options[:include_codepoints] = !options[:no_codepoints]
|
|
64
|
+
cmd_options[:validate] = parse_validate_option(options[:validate])
|
|
65
|
+
command = Commands::AuditCommand.new(font_file, cmd_options)
|
|
66
|
+
result = command.run
|
|
67
|
+
write_audit_result(result, options[:output])
|
|
68
|
+
exit_on_validation_errors(result) if options[:validate] && options[:fail_on_error]
|
|
69
|
+
rescue Errno::ENOENT
|
|
70
|
+
warn "File not found: #{font_file}" unless options[:quiet]
|
|
71
|
+
exit 1
|
|
72
|
+
end
|
|
73
|
+
|
|
74
|
+
desc "info PATH", "Display font information"
|
|
75
|
+
option :brief, type: :boolean, default: false,
|
|
76
|
+
desc: "Brief mode - only essential info (5x faster, uses metadata loading)",
|
|
77
|
+
aliases: "-b"
|
|
78
|
+
# Extract and display comprehensive font metadata.
|
|
79
|
+
#
|
|
80
|
+
# @param path [String] Path to the font file or collection
|
|
81
|
+
def info(path)
|
|
82
|
+
command = Commands::InfoCommand.new(path, options)
|
|
83
|
+
info = command.run
|
|
84
|
+
output_result(info) unless options[:quiet]
|
|
85
|
+
rescue Errno::ENOENT
|
|
86
|
+
if options[:verbose]
|
|
87
|
+
raise
|
|
88
|
+
else
|
|
89
|
+
warn "File not found: #{path}" unless options[:quiet]
|
|
90
|
+
exit 1
|
|
91
|
+
end
|
|
92
|
+
end
|
|
93
|
+
|
|
94
|
+
desc "ls FILE", "List contents (fonts in collection or font summary)"
|
|
95
|
+
# List contents of font files with auto-detection.
|
|
96
|
+
#
|
|
97
|
+
# For collections (TTC/OTC): Lists all fonts in the collection
|
|
98
|
+
# For individual fonts (TTF/OTF): Shows quick font summary
|
|
99
|
+
#
|
|
100
|
+
# @param file [String] Path to the font or collection file
|
|
101
|
+
#
|
|
102
|
+
# @example List fonts in collection
|
|
103
|
+
# fontisan ls fonts.ttc
|
|
104
|
+
#
|
|
105
|
+
# @example Show font summary
|
|
106
|
+
# fontisan ls font.ttf
|
|
107
|
+
def ls(file)
|
|
108
|
+
command = Commands::LsCommand.new(file, options)
|
|
109
|
+
result = command.run
|
|
110
|
+
output_result(result)
|
|
111
|
+
rescue Errno::ENOENT, Error => e
|
|
112
|
+
handle_error(e)
|
|
113
|
+
end
|
|
114
|
+
|
|
115
|
+
desc "tables FONT_FILE", "List OpenType tables"
|
|
116
|
+
# List all OpenType tables in the font file.
|
|
117
|
+
#
|
|
118
|
+
# @param font_file [String] Path to the font file
|
|
119
|
+
def tables(font_file)
|
|
120
|
+
command = Commands::TablesCommand.new(font_file, options)
|
|
121
|
+
result = command.run
|
|
122
|
+
output_result(result)
|
|
123
|
+
rescue Errno::ENOENT, Error => e
|
|
124
|
+
handle_error(e)
|
|
125
|
+
end
|
|
126
|
+
|
|
127
|
+
desc "glyphs FONT_FILE", "List glyph names"
|
|
128
|
+
# List glyph names from the font file.
|
|
129
|
+
#
|
|
130
|
+
# @param font_file [String] Path to the font file
|
|
131
|
+
def glyphs(font_file)
|
|
132
|
+
command = Commands::GlyphsCommand.new(font_file, options)
|
|
133
|
+
result = command.run
|
|
134
|
+
output_result(result)
|
|
135
|
+
rescue Errno::ENOENT, Error => e
|
|
136
|
+
handle_error(e)
|
|
137
|
+
end
|
|
138
|
+
|
|
139
|
+
desc "unicode FONT_FILE", "List Unicode to glyph mappings"
|
|
140
|
+
# List Unicode to glyph index mappings from the font file.
|
|
141
|
+
#
|
|
142
|
+
# @param font_file [String] Path to the font file
|
|
143
|
+
def unicode(font_file)
|
|
144
|
+
command = Commands::UnicodeCommand.new(font_file, options)
|
|
145
|
+
result = command.run
|
|
146
|
+
output_result(result)
|
|
147
|
+
rescue Errno::ENOENT, Error => e
|
|
148
|
+
handle_error(e)
|
|
149
|
+
end
|
|
150
|
+
|
|
151
|
+
desc "variable FONT_FILE", "Display variable font information"
|
|
152
|
+
# Display variable font variation axes and instances.
|
|
153
|
+
#
|
|
154
|
+
# @param font_file [String] Path to the font file
|
|
155
|
+
def variable(font_file)
|
|
156
|
+
command = Commands::VariableCommand.new(font_file, options)
|
|
157
|
+
result = command.run
|
|
158
|
+
output_result(result)
|
|
159
|
+
rescue Errno::ENOENT, Error => e
|
|
160
|
+
handle_error(e)
|
|
161
|
+
end
|
|
162
|
+
|
|
163
|
+
desc "optical-size FONT_FILE", "Display optical size information"
|
|
164
|
+
# Display optical size information from the font file.
|
|
165
|
+
#
|
|
166
|
+
# @param font_file [String] Path to the font file
|
|
167
|
+
def optical_size(font_file)
|
|
168
|
+
command = Commands::OpticalSizeCommand.new(font_file, options)
|
|
169
|
+
result = command.run
|
|
170
|
+
output_result(result)
|
|
171
|
+
rescue Errno::ENOENT, Error => e
|
|
172
|
+
handle_error(e)
|
|
173
|
+
end
|
|
174
|
+
|
|
175
|
+
desc "scripts FONT_FILE", "List supported scripts from GSUB/GPOS tables"
|
|
176
|
+
# List all scripts supported by the font from GSUB and GPOS tables.
|
|
177
|
+
#
|
|
178
|
+
# @param font_file [String] Path to the font file
|
|
179
|
+
def scripts(font_file)
|
|
180
|
+
command = Commands::ScriptsCommand.new(font_file, options)
|
|
181
|
+
result = command.run
|
|
182
|
+
output_result(result)
|
|
183
|
+
rescue Errno::ENOENT, Error => e
|
|
184
|
+
handle_error(e)
|
|
185
|
+
end
|
|
186
|
+
|
|
187
|
+
desc "features FONT_FILE", "List GSUB/GPOS features"
|
|
188
|
+
option :script, type: :string,
|
|
189
|
+
desc: "Script tag to query (e.g., latn, cyrl, arab). If not specified, shows features for all scripts",
|
|
190
|
+
aliases: "-s"
|
|
191
|
+
# List OpenType features available for scripts.
|
|
192
|
+
# If no script is specified, shows features for all scripts.
|
|
193
|
+
#
|
|
194
|
+
# @param font_file [String] Path to the font file
|
|
195
|
+
def features(font_file)
|
|
196
|
+
command = Commands::FeaturesCommand.new(font_file, options)
|
|
197
|
+
result = command.run
|
|
198
|
+
output_result(result)
|
|
199
|
+
rescue Errno::ENOENT, Error => e
|
|
200
|
+
handle_error(e)
|
|
201
|
+
end
|
|
202
|
+
|
|
203
|
+
desc "subset FONT_FILE", "Subset a font to specific glyphs"
|
|
204
|
+
option :text, type: :string,
|
|
205
|
+
desc: "Text to subset (e.g., 'Hello World')",
|
|
206
|
+
aliases: "-t"
|
|
207
|
+
option :glyphs, type: :string,
|
|
208
|
+
desc: "Comma-separated glyph IDs (e.g., '0,1,65,66,67')",
|
|
209
|
+
aliases: "-g"
|
|
210
|
+
option :unicode, type: :string,
|
|
211
|
+
desc: "Comma-separated Unicode codepoints (e.g., 'U+0041,U+0042' or '0x41,0x42')",
|
|
212
|
+
aliases: "-u"
|
|
213
|
+
option :output, type: :string, required: true,
|
|
214
|
+
desc: "Output file path",
|
|
215
|
+
aliases: "-o"
|
|
216
|
+
option :profile, type: :string, default: "pdf",
|
|
217
|
+
desc: "Subsetting profile (pdf, web, minimal)",
|
|
218
|
+
aliases: "-p"
|
|
219
|
+
option :retain_gids, type: :boolean, default: false,
|
|
220
|
+
desc: "Retain original glyph IDs (leave gaps)"
|
|
221
|
+
option :drop_hints, type: :boolean, default: false,
|
|
222
|
+
desc: "Drop hinting instructions"
|
|
223
|
+
option :drop_names, type: :boolean, default: false,
|
|
224
|
+
desc: "Drop glyph names from post table"
|
|
225
|
+
option :unicode_ranges, type: :boolean, default: true,
|
|
226
|
+
desc: "Prune OS/2 Unicode ranges"
|
|
227
|
+
# Subset a font to specific glyphs.
|
|
228
|
+
#
|
|
229
|
+
# You must specify one of --text, --glyphs, or --unicode to define
|
|
230
|
+
# which glyphs to include in the subset.
|
|
231
|
+
#
|
|
232
|
+
# @param font_file [String] Path to the font file
|
|
233
|
+
def subset(font_file)
|
|
234
|
+
command = Commands::SubsetCommand.new(font_file, options)
|
|
235
|
+
result = command.run_routed
|
|
236
|
+
|
|
237
|
+
unless options[:quiet]
|
|
238
|
+
puts "Subset font created:"
|
|
239
|
+
puts " Input: #{result[:input]}"
|
|
240
|
+
puts " Output: #{result[:output]}"
|
|
241
|
+
puts " Original glyphs: #{result[:original_glyphs]}"
|
|
242
|
+
puts " Subset glyphs: #{result[:subset_glyphs]}"
|
|
243
|
+
puts " Profile: #{result[:profile]}"
|
|
244
|
+
puts " Size: #{format_size(result[:size])}"
|
|
245
|
+
end
|
|
246
|
+
rescue Errno::ENOENT, Error => e
|
|
247
|
+
handle_error(e)
|
|
248
|
+
end
|
|
249
|
+
|
|
250
|
+
desc "convert FONT_FILE", "Convert font to different format"
|
|
251
|
+
option :to, type: :array, required: true,
|
|
252
|
+
desc: "Target format(s): ttf, otf, type1, t1, ttc, otc, dfont, svg, " \
|
|
253
|
+
"woff (zlib — works on all browsers incl. legacy), " \
|
|
254
|
+
"woff2 (Brotli — ~30% smaller, modern browsers only). " \
|
|
255
|
+
"Pass multiple times (--to woff --to woff2) or comma-separated " \
|
|
256
|
+
"(--to woff,woff2) for multi-format output.",
|
|
257
|
+
aliases: "-t"
|
|
258
|
+
option :output, type: :string,
|
|
259
|
+
desc: "Output file path (required unless --show-options)",
|
|
260
|
+
aliases: "-o"
|
|
261
|
+
option :coordinates, type: :string,
|
|
262
|
+
desc: "Instance coordinates (e.g., wght=700,wdth=100)",
|
|
263
|
+
aliases: "-c"
|
|
264
|
+
option :instance_index, type: :numeric,
|
|
265
|
+
desc: "Named instance index",
|
|
266
|
+
aliases: "-n"
|
|
267
|
+
option :preserve_variation, type: :boolean,
|
|
268
|
+
desc: "Force variation preservation (auto-detected by default)"
|
|
269
|
+
option :no_validate, type: :boolean, default: false,
|
|
270
|
+
desc: "Skip output validation"
|
|
271
|
+
option :preserve_hints, type: :boolean, default: false,
|
|
272
|
+
desc: "Preserve rendering hints during conversion (TTF→OTF preservations may be limited)"
|
|
273
|
+
option :target_format, type: :string, default: "preserve",
|
|
274
|
+
desc: "Target outline format for collections: preserve (default), ttf, or otf"
|
|
275
|
+
option :wght, type: :numeric,
|
|
276
|
+
desc: "Weight axis value (alternative to --coordinates)"
|
|
277
|
+
option :wdth, type: :numeric,
|
|
278
|
+
desc: "Width axis value (alternative to --coordinates)"
|
|
279
|
+
option :slnt, type: :numeric,
|
|
280
|
+
desc: "Slant axis value (alternative to --coordinates)"
|
|
281
|
+
option :ital, type: :numeric,
|
|
282
|
+
desc: "Italic axis value (alternative to --coordinates)"
|
|
283
|
+
option :opsz, type: :numeric,
|
|
284
|
+
desc: "Optical size axis value (alternative to --coordinates)"
|
|
285
|
+
# Conversion options
|
|
286
|
+
option :preset, type: :string,
|
|
287
|
+
desc: "Use named preset (type1_to_modern, modern_to_type1, web_optimized, archive_to_modern)"
|
|
288
|
+
option :show_options, type: :boolean, default: false,
|
|
289
|
+
desc: "Show recommended options for the conversion and exit"
|
|
290
|
+
option :decompose, type: :boolean,
|
|
291
|
+
desc: "Decompose composite glyphs (opening option)"
|
|
292
|
+
option :convert_curves, type: :boolean,
|
|
293
|
+
desc: "Convert curves during conversion (opening option)"
|
|
294
|
+
option :scale_to_1000, type: :boolean,
|
|
295
|
+
desc: "Scale to 1000 units per em (opening option)"
|
|
296
|
+
option :autohint, type: :boolean,
|
|
297
|
+
desc: "Auto-hint the font (opening option)"
|
|
298
|
+
option :generate_unicode, type: :boolean,
|
|
299
|
+
desc: "Generate Unicode mappings (Type 1 opening option)"
|
|
300
|
+
option :hinting_mode, type: :string,
|
|
301
|
+
desc: "Hinting mode: preserve, auto, none, or full"
|
|
302
|
+
option :optimize_cff, type: :boolean,
|
|
303
|
+
desc: "Enable CFF subroutine optimization"
|
|
304
|
+
option :optimize_tables, type: :boolean,
|
|
305
|
+
desc: "Enable table optimization"
|
|
306
|
+
option :decompose_on_output, type: :boolean,
|
|
307
|
+
desc: "Decompose on output (generating option)"
|
|
308
|
+
# Compression knobs — declared by each strategy (single source of truth:
|
|
309
|
+
# Converters::* strategies). Cross-format misuse is caught at convert time
|
|
310
|
+
# by FormatConverter.validate_options_for_target! with a clear ArgumentError.
|
|
311
|
+
option :zlib_level, type: :numeric,
|
|
312
|
+
desc: "WOFF only: zlib compression level (0–9, default 6)"
|
|
313
|
+
option :uncompressed, type: :boolean,
|
|
314
|
+
desc: "WOFF only: store tables uncompressed (legal per WOFF 1.0 §5.1)"
|
|
315
|
+
option :compression_threshold, type: :numeric,
|
|
316
|
+
desc: "WOFF only: skip compression for tables smaller than N bytes (default 100)"
|
|
317
|
+
option :brotli_quality, type: :numeric,
|
|
318
|
+
desc: "WOFF2 only: Brotli quality (0–11, default 11)"
|
|
319
|
+
option :transform_tables, type: :boolean,
|
|
320
|
+
desc: "WOFF2 only: apply glyf/loca and hmtx transformations"
|
|
321
|
+
# Convert a font to a different format using the universal transformation pipeline.
|
|
322
|
+
#
|
|
323
|
+
# Supported conversions:
|
|
324
|
+
# - TTF ↔ OTF: Outline format conversion
|
|
325
|
+
# - Type 1 ↔ TTF/OTF: Adobe Type 1 font conversion
|
|
326
|
+
# - WOFF/WOFF2: Web font packaging
|
|
327
|
+
# - Variable fonts: Automatic variation preservation or instance generation
|
|
328
|
+
# - Collections (TTC/OTC/dfont): Preserve mixed TTF+OTF by default, or standardize with --target-format
|
|
329
|
+
#
|
|
330
|
+
# Web fonts — WOFF vs WOFF2:
|
|
331
|
+
# WOFF uses zlib compression and works on every browser that supports
|
|
332
|
+
# web fonts at all (IE9+, all evergreen browsers). WOFF2 uses Brotli and
|
|
333
|
+
# is ~30% smaller but requires modern browsers (Chrome 36+, Firefox 39+,
|
|
334
|
+
# Safari 12+, Edge 14+). Old browsers cannot decode Brotli, so for legacy
|
|
335
|
+
# support serve WOFF. Tune knobs with --zlib-level / --brotli-quality /
|
|
336
|
+
# --uncompressed (WOFF only) / --transform-tables (WOFF2 only).
|
|
337
|
+
#
|
|
338
|
+
# Collection Format Support:
|
|
339
|
+
# TTC, OTC, and dfont all support mixed TrueType and OpenType fonts. By default, original font formats
|
|
340
|
+
# are preserved during collection conversion (--target-format preserve). Use --target-format ttf to
|
|
341
|
+
# convert all fonts to TrueType, or --target-format otf to convert all to OpenType/CFF.
|
|
342
|
+
#
|
|
343
|
+
# Variable Font Operations:
|
|
344
|
+
# The pipeline automatically detects whether variation data can be preserved based on
|
|
345
|
+
# source and target formats. For same outline family (TTF→WOFF or OTF→WOFF2), variation
|
|
346
|
+
# is preserved automatically. For cross-family conversions (TTF↔OTF), an instance is
|
|
347
|
+
# generated unless --preserve-variation is explicitly set.
|
|
348
|
+
#
|
|
349
|
+
# Instance Generation:
|
|
350
|
+
# Use --coordinates to specify exact axis values (e.g., wght=700,wdth=100) or
|
|
351
|
+
# --instance-index to use a named instance. Individual axis options (--wght, --wdth)
|
|
352
|
+
# are also supported for convenience.
|
|
353
|
+
#
|
|
354
|
+
# @param font_file [String] Path to the font file
|
|
355
|
+
#
|
|
356
|
+
# @example Convert TTF to OTF
|
|
357
|
+
# fontisan convert font.ttf --to otf --output font.otf
|
|
358
|
+
#
|
|
359
|
+
# @example Convert Type 1 to OTF
|
|
360
|
+
# fontisan convert font.pfb --to otf --output font.otf
|
|
361
|
+
#
|
|
362
|
+
# @example Convert OTF to Type 1
|
|
363
|
+
# fontisan convert font.otf --to type1 --output font.pfb
|
|
364
|
+
#
|
|
365
|
+
# @example Convert TTC to OTC (preserves mixed formats by default)
|
|
366
|
+
# fontisan convert family.ttc --to otc --output family.otc
|
|
367
|
+
#
|
|
368
|
+
# @example Convert TTC to OTC with all fonts as TrueType
|
|
369
|
+
# fontisan convert family.ttc --to otc --output family.otc --target-format ttf
|
|
370
|
+
#
|
|
371
|
+
# @example Convert TTC to OTC with all fonts as OpenType/CFF
|
|
372
|
+
# fontisan convert family.ttc --to otc --output family.otc --target-format otf
|
|
373
|
+
#
|
|
374
|
+
# @example Generate bold instance at specific coordinates
|
|
375
|
+
# fontisan convert variable.ttf --to ttf --output bold.ttf --coordinates "wght=700,wdth=100"
|
|
376
|
+
#
|
|
377
|
+
# @example Generate bold instance using individual axis options
|
|
378
|
+
# fontisan convert variable.ttf --to ttf --output bold.ttf --wght 700
|
|
379
|
+
#
|
|
380
|
+
# @example Use named instance
|
|
381
|
+
# fontisan convert variable.ttf --to woff2 --output bold.woff2 --instance-index 0
|
|
382
|
+
#
|
|
383
|
+
# @example Force variation preservation (if compatible)
|
|
384
|
+
# fontisan convert variable.ttf --to woff2 --output variable.woff2 --preserve-variation
|
|
385
|
+
#
|
|
386
|
+
# @example Convert without validation
|
|
387
|
+
# fontisan convert font.ttf --to otf --output font.otf --no-validate
|
|
388
|
+
#
|
|
389
|
+
# @example Use named preset
|
|
390
|
+
# fontisan convert font.pfb --to otf --output font.otf --preset type1_to_modern
|
|
391
|
+
#
|
|
392
|
+
# @example Show recommended options for conversion
|
|
393
|
+
# fontisan convert font.ttf --to otf --show-options
|
|
394
|
+
#
|
|
395
|
+
# @example Convert with custom options
|
|
396
|
+
# fontisan convert font.ttf --to otf --output font.otf --autohint --hinting-mode auto
|
|
397
|
+
def convert(font_file)
|
|
398
|
+
# Detect source format from file
|
|
399
|
+
source_format = detect_source_format(font_file)
|
|
400
|
+
|
|
401
|
+
# Handle --show-options
|
|
402
|
+
if options[:show_options]
|
|
403
|
+
show_recommended_options(source_format,
|
|
404
|
+
options[:to].is_a?(Array) ? options[:to].first : options[:to])
|
|
405
|
+
return
|
|
406
|
+
end
|
|
407
|
+
|
|
408
|
+
# Validate output is provided when not using --show-options
|
|
409
|
+
unless options[:output]
|
|
410
|
+
raise Thor::Error, "Output path is required. Use --output option."
|
|
411
|
+
end
|
|
412
|
+
|
|
413
|
+
# Build ConversionOptions
|
|
414
|
+
conv_options = build_conversion_options(source_format,
|
|
415
|
+
Array(options[:to]).first,
|
|
416
|
+
options)
|
|
417
|
+
|
|
418
|
+
# Build instance coordinates from axis options
|
|
419
|
+
instance_coords = build_instance_coordinates(options)
|
|
420
|
+
|
|
421
|
+
# Merge coordinates and ConversionOptions into convert_options
|
|
422
|
+
convert_options = options.to_h.dup
|
|
423
|
+
if instance_coords.any?
|
|
424
|
+
convert_options[:instance_coordinates] = instance_coords
|
|
425
|
+
end
|
|
426
|
+
|
|
427
|
+
# Add ConversionOptions if built
|
|
428
|
+
convert_options[:options] = conv_options if conv_options
|
|
429
|
+
|
|
430
|
+
command = Commands::ConvertCommand.new(font_file, convert_options)
|
|
431
|
+
command.run_routed
|
|
432
|
+
rescue Errno::ENOENT, Error => e
|
|
433
|
+
handle_error(e)
|
|
434
|
+
end
|
|
435
|
+
|
|
436
|
+
desc "instance FONT_FILE",
|
|
437
|
+
"Generate static font instance from variable font"
|
|
438
|
+
option :output, type: :string,
|
|
439
|
+
desc: "Output file path",
|
|
440
|
+
aliases: "-o"
|
|
441
|
+
option :wght, type: :numeric,
|
|
442
|
+
desc: "Weight axis value"
|
|
443
|
+
option :wdth, type: :numeric,
|
|
444
|
+
desc: "Width axis value"
|
|
445
|
+
option :slnt, type: :numeric,
|
|
446
|
+
desc: "Slant axis value"
|
|
447
|
+
option :ital, type: :numeric,
|
|
448
|
+
desc: "Italic axis value"
|
|
449
|
+
option :opsz, type: :numeric,
|
|
450
|
+
desc: "Optical size axis value"
|
|
451
|
+
option :named_instance, type: :string,
|
|
452
|
+
desc: "Use named instance by fvar index (e.g., 0, 1; see --list-instances)",
|
|
453
|
+
aliases: "-n"
|
|
454
|
+
option :list_instances, type: :boolean, default: false,
|
|
455
|
+
desc: "List available named instances",
|
|
456
|
+
aliases: "-l"
|
|
457
|
+
option :to, type: :string,
|
|
458
|
+
desc: "Convert to format (ttf, otf, woff, woff2, svg)",
|
|
459
|
+
aliases: "-t"
|
|
460
|
+
# Generate static font instance from variable font.
|
|
461
|
+
#
|
|
462
|
+
# You can specify axis coordinates using --wght, --wdth, etc., or use
|
|
463
|
+
# a predefined named instance with --named-instance. Use --list-instances
|
|
464
|
+
# to see available named instances.
|
|
465
|
+
#
|
|
466
|
+
# @param font_file [String] Path to the variable font file
|
|
467
|
+
#
|
|
468
|
+
# @example Generate bold instance
|
|
469
|
+
# fontisan instance variable.ttf --wght=700 --output=bold.ttf
|
|
470
|
+
#
|
|
471
|
+
# @example Use named instance
|
|
472
|
+
# fontisan instance variable.ttf --named-instance=0 --output=bold.ttf
|
|
473
|
+
#
|
|
474
|
+
# @example Instance with format conversion
|
|
475
|
+
# fontisan instance variable.ttf --wght=700 --to=woff2 --output=bold.woff2
|
|
476
|
+
#
|
|
477
|
+
# @example List available instances
|
|
478
|
+
# fontisan instance variable.ttf --list-instances
|
|
479
|
+
def instance(font_file)
|
|
480
|
+
command = Commands::InstanceCommand.new
|
|
481
|
+
command.execute(font_file, options)
|
|
482
|
+
rescue Errno::ENOENT, Error => e
|
|
483
|
+
handle_error(e)
|
|
484
|
+
end
|
|
485
|
+
|
|
486
|
+
desc "dump-table FONT_FILE TABLE_TAG", "Dump raw table data to stdout"
|
|
487
|
+
# Dump raw binary table data to stdout.
|
|
488
|
+
#
|
|
489
|
+
# @param font_file [String] Path to the font file
|
|
490
|
+
# @param table_tag [String] Four-character table tag (e.g., 'name', 'head')
|
|
491
|
+
def dump_table(font_file, table_tag)
|
|
492
|
+
command = Commands::DumpTableCommand.new(font_file, table_tag, options)
|
|
493
|
+
raw_data = command.run
|
|
494
|
+
|
|
495
|
+
# Write binary data directly to stdout
|
|
496
|
+
$stdout.binmode
|
|
497
|
+
$stdout.write(raw_data)
|
|
498
|
+
rescue Errno::ENOENT, Error => e
|
|
499
|
+
handle_error(e)
|
|
500
|
+
end
|
|
501
|
+
|
|
502
|
+
desc "validate [FONT_FILE]", "Validate font file"
|
|
503
|
+
long_desc <<-DESC
|
|
504
|
+
Validate font file against quality checks and standards.
|
|
505
|
+
|
|
506
|
+
Supports individual fonts (TTF/OTF) and font collections (TTC/OTC/dfont).
|
|
507
|
+
For collections, validates each font and provides a summary report.
|
|
508
|
+
|
|
509
|
+
Profiles (-p/--profile):
|
|
510
|
+
indexability - Fast indexing validation (metadata only, 8 checks)
|
|
511
|
+
usability - Installation compatibility
|
|
512
|
+
production - Comprehensive quality (default)
|
|
513
|
+
web - Web font readiness
|
|
514
|
+
spec_compliance - OpenType spec compliance
|
|
515
|
+
default - Production profile (alias)
|
|
516
|
+
|
|
517
|
+
Collection validation with profiles:
|
|
518
|
+
When validating TTC/OTC/dfont collections, the selected profile
|
|
519
|
+
determines which tables are loaded and which checks are performed
|
|
520
|
+
for each font in the collection. Use 'indexability' for quick
|
|
521
|
+
validation or 'production' for comprehensive quality checks.
|
|
522
|
+
|
|
523
|
+
Return values (with -R/--return-value-results):
|
|
524
|
+
0 No results
|
|
525
|
+
1 Execution errors
|
|
526
|
+
2 Fatal errors found
|
|
527
|
+
3 Major errors found
|
|
528
|
+
4 Minor errors found
|
|
529
|
+
5 Spec violations found
|
|
530
|
+
DESC
|
|
531
|
+
|
|
532
|
+
option :exclude, aliases: "-e", type: :array, desc: "Tests to exclude"
|
|
533
|
+
option :list, aliases: "-l", type: :boolean, desc: "List available profiles"
|
|
534
|
+
option :output, aliases: "-o", type: :string, desc: "Output file"
|
|
535
|
+
option :full_report, aliases: "-r", type: :boolean, desc: "Full report"
|
|
536
|
+
option :return_value_results, aliases: "-R", type: :boolean,
|
|
537
|
+
desc: "Use return value for results"
|
|
538
|
+
option :summary_report, aliases: "-S", type: :boolean,
|
|
539
|
+
desc: "Summary report"
|
|
540
|
+
option :profile, aliases: "-p", type: :string, default: "default",
|
|
541
|
+
desc: "Validation profile"
|
|
542
|
+
option :table_report, aliases: "-T", type: :boolean, desc: "Tabular report"
|
|
543
|
+
option :verbose, aliases: "-v", type: :boolean, desc: "Verbose output"
|
|
544
|
+
option :suppress_warnings, aliases: "-W", type: :boolean,
|
|
545
|
+
desc: "Suppress warnings"
|
|
546
|
+
|
|
547
|
+
def validate(*font_files)
|
|
548
|
+
if options[:list]
|
|
549
|
+
list_available_tests
|
|
550
|
+
return
|
|
551
|
+
end
|
|
552
|
+
|
|
553
|
+
# Validate argument count
|
|
554
|
+
if font_files.empty?
|
|
555
|
+
raise(Thor::Error, "FONT_FILE is required unless using --list")
|
|
556
|
+
elsif font_files.size > 1
|
|
557
|
+
raise(Thor::Error,
|
|
558
|
+
"Too many arguments. validate accepts only one font file.\n" \
|
|
559
|
+
"To validate multiple files, run validate separately for each.\n" \
|
|
560
|
+
"To validate all fonts in a collection, use: fontisan validate collection.ttc")
|
|
561
|
+
end
|
|
562
|
+
|
|
563
|
+
font_file = font_files.first
|
|
564
|
+
|
|
565
|
+
cmd = Commands::ValidateCommand.new(
|
|
566
|
+
input: font_file,
|
|
567
|
+
profile: options[:profile],
|
|
568
|
+
exclude: options[:exclude] || [],
|
|
569
|
+
output: options[:output],
|
|
570
|
+
format: options[:format].to_sym,
|
|
571
|
+
full_report: options[:full_report],
|
|
572
|
+
summary_report: options[:summary_report],
|
|
573
|
+
table_report: options[:table_report],
|
|
574
|
+
verbose: options[:verbose],
|
|
575
|
+
suppress_warnings: options[:suppress_warnings],
|
|
576
|
+
return_value_results: options[:return_value_results],
|
|
577
|
+
)
|
|
578
|
+
|
|
579
|
+
exit cmd.run
|
|
580
|
+
rescue Thor::Error => e
|
|
581
|
+
unless options[:quiet]
|
|
582
|
+
warn "ERROR: #{e.message}"
|
|
583
|
+
warn
|
|
584
|
+
help("validate")
|
|
585
|
+
end
|
|
586
|
+
exit 1
|
|
587
|
+
rescue StandardError => e
|
|
588
|
+
error "Validation failed: #{e.message}"
|
|
589
|
+
exit 1
|
|
590
|
+
end
|
|
591
|
+
|
|
592
|
+
desc "export FONT_FILE", "Export font to TTX/YAML/JSON format"
|
|
593
|
+
option :output, type: :string,
|
|
594
|
+
desc: "Output file path (default: stdout)",
|
|
595
|
+
aliases: "-o"
|
|
596
|
+
option :format, type: :string, default: "yaml",
|
|
597
|
+
desc: "Export format (yaml, json, ttx)",
|
|
598
|
+
aliases: "-f"
|
|
599
|
+
option :tables, type: :array,
|
|
600
|
+
desc: "Specific tables to export",
|
|
601
|
+
aliases: "-t"
|
|
602
|
+
option :binary_format, type: :string, default: "hex",
|
|
603
|
+
desc: "Binary encoding (hex, base64)",
|
|
604
|
+
aliases: "-b"
|
|
605
|
+
|
|
606
|
+
def export(font_file)
|
|
607
|
+
command = Commands::ExportCommand.new(
|
|
608
|
+
input: font_file,
|
|
609
|
+
output: options[:output],
|
|
610
|
+
format: options[:format].to_sym,
|
|
611
|
+
tables: options[:tables],
|
|
612
|
+
binary_format: options[:binary_format].to_sym,
|
|
613
|
+
)
|
|
614
|
+
exit command.run
|
|
615
|
+
end
|
|
616
|
+
|
|
617
|
+
desc "validate-collection PATH",
|
|
618
|
+
"Validate a TTC/OTC/dfont (face count, glyph cap, cmap union)"
|
|
619
|
+
option :expected_faces, type: :numeric,
|
|
620
|
+
desc: "Required face count"
|
|
621
|
+
option :max_glyphs, type: :numeric, default: Fontisan::Commands::ValidateCollectionCommand::DEFAULT_MAX_GLYPHS,
|
|
622
|
+
desc: "Per-face glyph cap"
|
|
623
|
+
option :expected_cmap_union, type: :numeric,
|
|
624
|
+
desc: "Minimum cmap union size across all faces"
|
|
625
|
+
def validate_collection(path)
|
|
626
|
+
cmd = Commands::ValidateCollectionCommand.new(
|
|
627
|
+
input: path,
|
|
628
|
+
expected_faces: options[:expected_faces],
|
|
629
|
+
max_glyphs: options[:max_glyphs],
|
|
630
|
+
expected_cmap_union: options[:expected_cmap_union],
|
|
631
|
+
)
|
|
632
|
+
exit cmd.run
|
|
633
|
+
rescue ArgumentError => e
|
|
634
|
+
warn "ERROR: #{e.message}"
|
|
635
|
+
exit 1
|
|
636
|
+
end
|
|
637
|
+
|
|
638
|
+
desc "version", "Display version information"
|
|
639
|
+
# Display the Fontisan version.
|
|
640
|
+
def version
|
|
641
|
+
puts "Fontisan version #{Fontisan::VERSION}"
|
|
642
|
+
end
|
|
643
|
+
|
|
644
|
+
desc "unpack FONT_FILE", "Unpack fonts from TTC/OTC collection"
|
|
645
|
+
option :output_dir, type: :string, required: true,
|
|
646
|
+
desc: "Output directory for extracted fonts",
|
|
647
|
+
aliases: "-d"
|
|
648
|
+
option :font_index, type: :numeric,
|
|
649
|
+
desc: "Extract specific font by index (default: extract all)",
|
|
650
|
+
aliases: "-i"
|
|
651
|
+
option :format, type: :string,
|
|
652
|
+
desc: "Output format (ttf, otf, woff, woff2)",
|
|
653
|
+
aliases: "-f"
|
|
654
|
+
option :prefix, type: :string,
|
|
655
|
+
desc: "Filename prefix for extracted fonts",
|
|
656
|
+
aliases: "-p"
|
|
657
|
+
# Extract individual fonts from a TTC (TrueType Collection) or OTC (OpenType Collection) file.
|
|
658
|
+
#
|
|
659
|
+
# This command unpacks fonts from collection files, optionally converting them
|
|
660
|
+
# to different formats during extraction.
|
|
661
|
+
#
|
|
662
|
+
# @param font_file [String] Path to the TTC/OTC collection file
|
|
663
|
+
#
|
|
664
|
+
# @example Extract all fonts to directory
|
|
665
|
+
# fontisan unpack family.ttc --output-dir extracted/
|
|
666
|
+
#
|
|
667
|
+
# @example Extract specific font by index
|
|
668
|
+
# fontisan unpack family.ttc --output-dir extracted/ --font-index 0
|
|
669
|
+
#
|
|
670
|
+
# @example Extract with format conversion
|
|
671
|
+
# fontisan unpack family.ttc --output-dir extracted/ --format woff2
|
|
672
|
+
#
|
|
673
|
+
# @example Extract with custom prefix
|
|
674
|
+
# fontisan unpack family.ttc --output-dir extracted/ --prefix "NotoSans"
|
|
675
|
+
def unpack(font_file)
|
|
676
|
+
command = Commands::UnpackCommand.new(font_file, options)
|
|
677
|
+
result = command.run_routed
|
|
678
|
+
|
|
679
|
+
unless options[:quiet]
|
|
680
|
+
puts "Collection unpacked successfully:"
|
|
681
|
+
puts " Input: #{result[:collection]}"
|
|
682
|
+
puts " Output directory: #{result[:output_dir]}"
|
|
683
|
+
puts " Fonts extracted: #{result[:fonts_extracted]}/#{result[:num_fonts]}"
|
|
684
|
+
result[:extracted_files].each do |file|
|
|
685
|
+
size = File.size(file)
|
|
686
|
+
puts " - #{File.basename(file)} (#{format_size(size)})"
|
|
687
|
+
end
|
|
688
|
+
end
|
|
689
|
+
rescue Errno::ENOENT, Error => e
|
|
690
|
+
handle_error(e)
|
|
691
|
+
end
|
|
692
|
+
|
|
693
|
+
desc "pack FONT_FILES...", "Pack multiple fonts into TTC/OTC collection"
|
|
694
|
+
option :output, type: :string, required: true,
|
|
695
|
+
desc: "Output collection file path",
|
|
696
|
+
aliases: "-o"
|
|
697
|
+
option :format, type: :string, default: "ttc",
|
|
698
|
+
desc: "Collection format (ttc, otc, dfont)",
|
|
699
|
+
aliases: "-f"
|
|
700
|
+
option :optimize, type: :boolean, default: true,
|
|
701
|
+
desc: "Enable table sharing optimization",
|
|
702
|
+
aliases: "--optimize"
|
|
703
|
+
option :analyze, type: :boolean, default: false,
|
|
704
|
+
desc: "Show analysis report before building",
|
|
705
|
+
aliases: "--analyze"
|
|
706
|
+
# Create a TTC (TrueType Collection), OTC (OpenType Collection), or dfont (Apple Data Fork Font) from multiple font files.
|
|
707
|
+
#
|
|
708
|
+
# This command combines multiple fonts into a single collection file with
|
|
709
|
+
# shared table deduplication to save space. It supports TTC, OTC, and dfont formats.
|
|
710
|
+
#
|
|
711
|
+
# @param font_files [Array<String>] Paths to input font files (minimum 2 required)
|
|
712
|
+
#
|
|
713
|
+
# @example Pack fonts into TTC
|
|
714
|
+
# fontisan pack font1.ttf font2.ttf font3.ttf --output family.ttc
|
|
715
|
+
#
|
|
716
|
+
# @example Pack into OTC with analysis
|
|
717
|
+
# fontisan pack Regular.otf Bold.otf Italic.otf --output family.otc --analyze
|
|
718
|
+
#
|
|
719
|
+
# @example Pack into dfont (Apple suitcase)
|
|
720
|
+
# fontisan pack font1.ttf font2.otf --output family.dfont --format dfont
|
|
721
|
+
#
|
|
722
|
+
# @example Pack without optimization
|
|
723
|
+
# fontisan pack font1.ttf font2.ttf --output collection.ttc --no-optimize
|
|
724
|
+
def pack(*font_files)
|
|
725
|
+
command = Commands::PackCommand.new(font_files, options)
|
|
726
|
+
result = command.run
|
|
727
|
+
|
|
728
|
+
unless options[:quiet]
|
|
729
|
+
puts "Collection created successfully:"
|
|
730
|
+
puts " Output: #{result[:output_path] || result[:output]}"
|
|
731
|
+
puts " Format: #{result[:format].upcase}"
|
|
732
|
+
puts " Fonts: #{result[:num_fonts]}"
|
|
733
|
+
puts " Size: #{format_size(result[:output_size] || result[:total_size])}"
|
|
734
|
+
if result[:space_savings]&.positive?
|
|
735
|
+
puts " Space saved: #{format_size(result[:space_savings])}"
|
|
736
|
+
puts " Sharing: #{result[:statistics][:sharing_percentage]}%"
|
|
737
|
+
end
|
|
738
|
+
end
|
|
739
|
+
rescue Errno::ENOENT, Error => e
|
|
740
|
+
handle_error(e)
|
|
741
|
+
end
|
|
742
|
+
|
|
743
|
+
private
|
|
744
|
+
|
|
745
|
+
# Build instance coordinates from CLI axis options
|
|
746
|
+
#
|
|
747
|
+
# @param options [Hash] CLI options
|
|
748
|
+
# @return [Hash] Coordinates hash
|
|
749
|
+
def build_instance_coordinates(options)
|
|
750
|
+
coords = {}
|
|
751
|
+
coords["wght"] = options[:wght].to_f if options[:wght]
|
|
752
|
+
coords["wdth"] = options[:wdth].to_f if options[:wdth]
|
|
753
|
+
coords["slnt"] = options[:slnt].to_f if options[:slnt]
|
|
754
|
+
coords["ital"] = options[:ital].to_f if options[:ital]
|
|
755
|
+
coords["opsz"] = options[:opsz].to_f if options[:opsz]
|
|
756
|
+
coords
|
|
757
|
+
end
|
|
758
|
+
|
|
759
|
+
# Output the result in the requested format.
|
|
760
|
+
#
|
|
761
|
+
# @param result [Object] The result object to output
|
|
762
|
+
def output_result(result)
|
|
763
|
+
output = case options[:format]
|
|
764
|
+
when "yaml"
|
|
765
|
+
result.to_yaml
|
|
766
|
+
when "json"
|
|
767
|
+
result.to_json
|
|
768
|
+
else
|
|
769
|
+
format_as_text(result)
|
|
770
|
+
end
|
|
771
|
+
|
|
772
|
+
puts output unless options[:quiet]
|
|
773
|
+
end
|
|
774
|
+
|
|
775
|
+
# Write the audit result to stdout or a file. For a single report,
|
|
776
|
+
# the output path (if given) is the file path. For a collection,
|
|
777
|
+
# the output path is a directory; each face is written as
|
|
778
|
+
# `{font_index:02d}-{postscript_name}.yaml`.
|
|
779
|
+
def write_audit_result(result, output_path)
|
|
780
|
+
if result.is_a?(Array)
|
|
781
|
+
write_audit_collection(result, output_path)
|
|
782
|
+
else
|
|
783
|
+
write_audit_single(result, output_path)
|
|
784
|
+
end
|
|
785
|
+
end
|
|
786
|
+
|
|
787
|
+
def write_audit_single(report, output_path)
|
|
788
|
+
content = serialize_audit(report)
|
|
789
|
+
if output_path
|
|
790
|
+
FileUtils.mkpath(File.dirname(output_path)) unless File.dirname(output_path) == "."
|
|
791
|
+
File.write(output_path, content)
|
|
792
|
+
else
|
|
793
|
+
puts content unless options[:quiet]
|
|
794
|
+
end
|
|
795
|
+
end
|
|
796
|
+
|
|
797
|
+
def write_audit_collection(reports, output_path)
|
|
798
|
+
if output_path
|
|
799
|
+
FileUtils.mkpath(output_path)
|
|
800
|
+
reports.each do |report|
|
|
801
|
+
name = audit_face_filename(report)
|
|
802
|
+
File.write(File.join(output_path, name), serialize_audit(report))
|
|
803
|
+
end
|
|
804
|
+
say("Wrote #{reports.size} reports to #{output_path}") unless options[:quiet]
|
|
805
|
+
else
|
|
806
|
+
puts serialize_audit(reports) unless options[:quiet]
|
|
807
|
+
end
|
|
808
|
+
end
|
|
809
|
+
|
|
810
|
+
def serialize_audit(report)
|
|
811
|
+
case options[:format]
|
|
812
|
+
when "json" then report.to_json
|
|
813
|
+
when "text", nil then format_audit_as_text(report)
|
|
814
|
+
else report.to_yaml
|
|
815
|
+
end
|
|
816
|
+
end
|
|
817
|
+
|
|
818
|
+
# Format an AuditReport as human-readable text for terminal use.
|
|
819
|
+
# Groups fields into sections: provenance, identity, style,
|
|
820
|
+
# coverage, layout, validation summary.
|
|
821
|
+
def format_audit_as_text(report)
|
|
822
|
+
lines = []
|
|
823
|
+
lines << "=== Font Audit Report ==="
|
|
824
|
+
lines.concat(format_audit_provenance(report))
|
|
825
|
+
lines.concat(format_audit_identity(report))
|
|
826
|
+
lines.concat(format_audit_style(report))
|
|
827
|
+
lines.concat(format_audit_coverage(report))
|
|
828
|
+
lines.concat(format_audit_layout(report))
|
|
829
|
+
lines.concat(format_audit_validation(report))
|
|
830
|
+
lines.join("\n")
|
|
831
|
+
end
|
|
832
|
+
|
|
833
|
+
def format_audit_provenance(report)
|
|
834
|
+
lines = []
|
|
835
|
+
lines << " Source: #{report.source_file}"
|
|
836
|
+
lines << " Format: #{report.source_format}"
|
|
837
|
+
lines << " SHA256: #{report.source_sha256[0, 16]}..." if report.source_sha256
|
|
838
|
+
lines << " Fontisan: #{report.fontisan_version}" if report.fontisan_version
|
|
839
|
+
lines << ""
|
|
840
|
+
end
|
|
841
|
+
|
|
842
|
+
def format_audit_identity(report)
|
|
843
|
+
lines = ["Identity:"]
|
|
844
|
+
lines << " Family: #{report.family_name}"
|
|
845
|
+
lines << " Subfamily: #{report.subfamily_name}"
|
|
846
|
+
lines << " Full: #{report.full_name}"
|
|
847
|
+
lines << " PostScript: #{report.postscript_name}"
|
|
848
|
+
lines << " Version: #{report.version}"
|
|
849
|
+
lines << ""
|
|
850
|
+
end
|
|
851
|
+
|
|
852
|
+
def format_audit_style(report)
|
|
853
|
+
lines = ["Style:"]
|
|
854
|
+
lines << " Weight: #{report.weight_class}"
|
|
855
|
+
lines << " Width: #{report.width_class}"
|
|
856
|
+
lines << " Italic: #{report.italic}"
|
|
857
|
+
lines << " Bold: #{report.bold}"
|
|
858
|
+
lines << " Variable: #{report.is_variable}"
|
|
859
|
+
report.axes&.each do |axis|
|
|
860
|
+
lines << " #{axis.tag}: #{axis.min_value}–#{axis.max_value} " \
|
|
861
|
+
"(default #{axis.default_value})"
|
|
862
|
+
end
|
|
863
|
+
lines << ""
|
|
864
|
+
end
|
|
865
|
+
|
|
866
|
+
def format_audit_coverage(report)
|
|
867
|
+
lines = ["Coverage:"]
|
|
868
|
+
lines << " Glyphs: #{report.total_glyphs}"
|
|
869
|
+
lines << " Codepoints: #{report.total_codepoints}"
|
|
870
|
+
lines << " cmap subtables: #{report.cmap_subtables&.join(', ')}" if report.cmap_subtables&.any?
|
|
871
|
+
lines << ""
|
|
872
|
+
end
|
|
873
|
+
|
|
874
|
+
def format_audit_layout(report)
|
|
875
|
+
scripts = report.opentype_scripts
|
|
876
|
+
features = report.features
|
|
877
|
+
return [] unless scripts&.any? || features&.any?
|
|
878
|
+
|
|
879
|
+
lines = ["Layout:"]
|
|
880
|
+
lines << " Scripts: #{scripts&.join(', ')}" if scripts&.any?
|
|
881
|
+
lines << " Features: #{features&.join(', ')}" if features&.any?
|
|
882
|
+
lines << ""
|
|
883
|
+
end
|
|
884
|
+
|
|
885
|
+
def format_audit_validation(report)
|
|
886
|
+
summary = report.validation_summary
|
|
887
|
+
return [] unless summary
|
|
888
|
+
|
|
889
|
+
lines = ["Validation:"]
|
|
890
|
+
lines << " Errors: #{summary.error_count}"
|
|
891
|
+
lines << " Warnings: #{summary.warning_count}"
|
|
892
|
+
lines << " Info: #{summary.info_count}"
|
|
893
|
+
result = summary.passed ? "PASSED" : "FAILED"
|
|
894
|
+
lines << " Result: #{result}"
|
|
895
|
+
lines << ""
|
|
896
|
+
report.validation_issues&.each do |issue|
|
|
897
|
+
lines << " [#{issue.severity.upcase}] #{issue.category}: #{issue.message}"
|
|
898
|
+
end
|
|
899
|
+
lines
|
|
900
|
+
end
|
|
901
|
+
|
|
902
|
+
def audit_face_filename(report)
|
|
903
|
+
safe_name = report.postscript_name&.gsub(%r{[^A-Za-z0-9._-]}, "_") || "font"
|
|
904
|
+
suffix = options[:format] == "json" ? "json" : "yaml"
|
|
905
|
+
idx = report.font_index || 0
|
|
906
|
+
format("%<idx>02d-%<name>s.%<suffix>s", idx: idx, name: safe_name, suffix: suffix)
|
|
907
|
+
end
|
|
908
|
+
|
|
909
|
+
# The --validate option is either nil (no validation), "true" (run all
|
|
910
|
+
# checks), or a profile name (e.g. "ots", "structural").
|
|
911
|
+
def parse_validate_option(raw)
|
|
912
|
+
return nil if raw.nil? || raw.empty?
|
|
913
|
+
return true if raw == "true"
|
|
914
|
+
|
|
915
|
+
raw.to_sym
|
|
916
|
+
end
|
|
917
|
+
|
|
918
|
+
# Print available validation profiles with their check counts.
|
|
919
|
+
def list_audit_profiles
|
|
920
|
+
puts "Available validation profiles for --validate:"
|
|
921
|
+
puts ""
|
|
922
|
+
Audit::CheckRegistry::PROFILES.each do |name, codes|
|
|
923
|
+
puts " #{name.to_s.ljust(15)} #{codes.size} checks"
|
|
924
|
+
end
|
|
925
|
+
puts ""
|
|
926
|
+
puts "Usage: fontisan audit font.ttf --validate <profile>"
|
|
927
|
+
puts " fontisan audit font.ttf --validate true (all checks)"
|
|
928
|
+
end
|
|
929
|
+
|
|
930
|
+
# Exit with code 1 if the audit found error-level issues.
|
|
931
|
+
# For collections, aggregates across all faces.
|
|
932
|
+
def exit_on_validation_errors(result)
|
|
933
|
+
issues = if result.is_a?(Array)
|
|
934
|
+
result.flat_map(&:validation_issues)
|
|
935
|
+
else
|
|
936
|
+
result.validation_issues || []
|
|
937
|
+
end
|
|
938
|
+
has_errors = issues.any? { |i| %w[error fatal].include?(i.severity) }
|
|
939
|
+
return unless has_errors
|
|
940
|
+
|
|
941
|
+
error_count = issues.count { |i| %w[error fatal].include?(i.severity) }
|
|
942
|
+
warn "Audit found #{error_count} error(s) — exiting with code 1"
|
|
943
|
+
exit 1
|
|
944
|
+
end
|
|
945
|
+
|
|
946
|
+
def serialize_report(report, format)
|
|
947
|
+
format == :json ? report.to_json : report.to_yaml
|
|
948
|
+
end
|
|
949
|
+
|
|
950
|
+
# Format result as human-readable text.
|
|
951
|
+
#
|
|
952
|
+
# @param result [Object] The result object to format
|
|
953
|
+
# @return [String] Formatted text output
|
|
954
|
+
def format_as_text(result)
|
|
955
|
+
formatter = Formatters::TextFormatter.new
|
|
956
|
+
formatter.format(result)
|
|
957
|
+
end
|
|
958
|
+
|
|
959
|
+
# Format file size in human-readable form
|
|
960
|
+
#
|
|
961
|
+
# @param size [Integer] Size in bytes
|
|
962
|
+
# @return [String] Formatted size
|
|
963
|
+
def format_size(size)
|
|
964
|
+
if size < 1024
|
|
965
|
+
"#{size} bytes"
|
|
966
|
+
elsif size < 1024 * 1024
|
|
967
|
+
"#{(size / 1024.0).round(2)} KB"
|
|
968
|
+
else
|
|
969
|
+
"#{(size / (1024.0 * 1024)).round(2)} MB"
|
|
970
|
+
end
|
|
971
|
+
end
|
|
972
|
+
|
|
973
|
+
# Handle errors based on verbosity settings.
|
|
974
|
+
#
|
|
975
|
+
# @param error [Error, Errno::ENOENT] The error to handle
|
|
976
|
+
def handle_error(error)
|
|
977
|
+
raise error if options[:verbose]
|
|
978
|
+
|
|
979
|
+
# Convert Errno::ENOENT to user-friendly message
|
|
980
|
+
if error.is_a?(Errno::ENOENT)
|
|
981
|
+
end
|
|
982
|
+
message = error.message
|
|
983
|
+
|
|
984
|
+
warn message unless options[:quiet]
|
|
985
|
+
exit 1
|
|
986
|
+
end
|
|
987
|
+
|
|
988
|
+
# List available validation tests/profiles
|
|
989
|
+
#
|
|
990
|
+
# @return [void]
|
|
991
|
+
def list_available_tests
|
|
992
|
+
profiles = Validators::ProfileLoader.all_profiles
|
|
993
|
+
puts "Available validation profiles:"
|
|
994
|
+
profiles.each do |profile_name, config|
|
|
995
|
+
puts " #{profile_name.to_s.ljust(20)} - #{config[:description]}"
|
|
996
|
+
end
|
|
997
|
+
end
|
|
998
|
+
|
|
999
|
+
# Detect source format from file extension
|
|
1000
|
+
#
|
|
1001
|
+
# @param font_file [String] Path to the font file
|
|
1002
|
+
# @return [Symbol] Detected format symbol
|
|
1003
|
+
def detect_source_format(font_file)
|
|
1004
|
+
ext = File.extname(font_file).downcase
|
|
1005
|
+
case ext
|
|
1006
|
+
when ".ttf"
|
|
1007
|
+
:ttf
|
|
1008
|
+
when ".otf"
|
|
1009
|
+
:otf
|
|
1010
|
+
when ".pfb", ".pfa"
|
|
1011
|
+
:type1
|
|
1012
|
+
when ".ttc"
|
|
1013
|
+
:ttc
|
|
1014
|
+
when ".otc"
|
|
1015
|
+
:otc
|
|
1016
|
+
when ".dfont"
|
|
1017
|
+
:dfont
|
|
1018
|
+
when ".woff"
|
|
1019
|
+
:woff
|
|
1020
|
+
when ".woff2"
|
|
1021
|
+
:woff2
|
|
1022
|
+
when ".svg"
|
|
1023
|
+
:svg
|
|
1024
|
+
else
|
|
1025
|
+
# Default to TTF for unknown extensions
|
|
1026
|
+
:ttf
|
|
1027
|
+
end
|
|
1028
|
+
end
|
|
1029
|
+
|
|
1030
|
+
# Show recommended options for a conversion
|
|
1031
|
+
#
|
|
1032
|
+
# @param source_format [Symbol] Source format
|
|
1033
|
+
# @param target_format_str [String] Target format string
|
|
1034
|
+
# @return [void]
|
|
1035
|
+
def show_recommended_options(source_format, target_format_str)
|
|
1036
|
+
target_format = Fontisan::ConversionOptions.normalize_format(target_format_str)
|
|
1037
|
+
|
|
1038
|
+
puts "\nRecommended options for #{source_format.to_s.upcase} → #{target_format.to_s.upcase} conversion:"
|
|
1039
|
+
puts "=" * 70
|
|
1040
|
+
|
|
1041
|
+
# Show recommended options
|
|
1042
|
+
recommended = Fontisan::ConversionOptions.recommended(from: source_format,
|
|
1043
|
+
to: target_format)
|
|
1044
|
+
puts "\nOpening options:"
|
|
1045
|
+
if recommended.opening.any?
|
|
1046
|
+
recommended.opening.each do |key, value|
|
|
1047
|
+
puts " --#{key.to_s.gsub('_', '-')}: #{value}"
|
|
1048
|
+
end
|
|
1049
|
+
else
|
|
1050
|
+
puts " (none)"
|
|
1051
|
+
end
|
|
1052
|
+
|
|
1053
|
+
puts "\nGenerating options:"
|
|
1054
|
+
if recommended.generating.any?
|
|
1055
|
+
recommended.generating.each do |key, value|
|
|
1056
|
+
puts " --#{key.to_s.gsub('_', '-')}: #{value}"
|
|
1057
|
+
end
|
|
1058
|
+
else
|
|
1059
|
+
puts " (none)"
|
|
1060
|
+
end
|
|
1061
|
+
|
|
1062
|
+
puts "\nAvailable presets:"
|
|
1063
|
+
Fontisan::ConversionOptions.available_presets.each do |preset|
|
|
1064
|
+
puts " #{preset}"
|
|
1065
|
+
end
|
|
1066
|
+
|
|
1067
|
+
puts "\nTo use preset:"
|
|
1068
|
+
puts " fontisan convert #{source_format} --to #{target_format} --preset <name> --output output.ext"
|
|
1069
|
+
puts "\n"
|
|
1070
|
+
end
|
|
1071
|
+
|
|
1072
|
+
# Build ConversionOptions from CLI options
|
|
1073
|
+
#
|
|
1074
|
+
# @param source_format [Symbol] Source format
|
|
1075
|
+
# @param target_format_str [String] Target format string
|
|
1076
|
+
# @param opts [Hash] CLI options
|
|
1077
|
+
# @return [ConversionOptions, nil] Built ConversionOptions or nil
|
|
1078
|
+
def build_conversion_options(source_format, target_format_str, opts)
|
|
1079
|
+
target_format = Fontisan::ConversionOptions.normalize_format(target_format_str)
|
|
1080
|
+
|
|
1081
|
+
# Use preset if specified
|
|
1082
|
+
if opts[:preset]
|
|
1083
|
+
return Fontisan::ConversionOptions.from_preset(opts[:preset])
|
|
1084
|
+
end
|
|
1085
|
+
|
|
1086
|
+
# Build opening options from CLI flags
|
|
1087
|
+
opening = {}
|
|
1088
|
+
opening[:decompose_composites] = true if opts[:decompose]
|
|
1089
|
+
opening[:convert_curves] = true if opts[:convert_curves]
|
|
1090
|
+
opening[:scale_to_1000] = true if opts[:scale_to_1000]
|
|
1091
|
+
opening[:autohint] = true if opts[:autohint]
|
|
1092
|
+
opening[:generate_unicode] = true if opts[:generate_unicode]
|
|
1093
|
+
|
|
1094
|
+
# Build generating options from CLI flags
|
|
1095
|
+
generating = {}
|
|
1096
|
+
generating[:hinting_mode] = opts[:hinting_mode] if opts[:hinting_mode]
|
|
1097
|
+
generating[:decompose_on_output] = true if opts[:decompose_on_output]
|
|
1098
|
+
generating[:optimize_tables] = true if opts[:optimize_tables]
|
|
1099
|
+
|
|
1100
|
+
# Only create ConversionOptions if any options were set
|
|
1101
|
+
return nil if opening.empty? && generating.empty?
|
|
1102
|
+
|
|
1103
|
+
Fontisan::ConversionOptions.new(
|
|
1104
|
+
from: source_format,
|
|
1105
|
+
to: target_format,
|
|
1106
|
+
opening: opening,
|
|
1107
|
+
generating: generating,
|
|
1108
|
+
)
|
|
1109
|
+
end
|
|
1110
|
+
end
|
|
1111
|
+
end
|