fontisan 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0fe760da43bddcfad046aef63c311613ea3767569245b21a2bda6a6d5f100a5f
-  data.tar.gz: 7571202d9bc900928ee4c3859e4081af6d561f53740587f0f94f7a159dbbbec3
+  metadata.gz: '0979321b74749068da214fbb4880701c1f78905cce2db2aa7a8a2263da669af3'
+  data.tar.gz: 3ccbb49464b62e831475fe601fecc9b7085c6dda5a16ec66d9b9c56c14ff0742
 SHA512:
-  metadata.gz: 66e94f6047f20385c27583a191d5c78ded6589ee8d2004386613062adb2071aba41644736c632be4087e24998ae29a7066fc17e42773a3627832c32f67d3c670
-  data.tar.gz: b9180051a16410731a112602c4ff5d18b679b6c6e521d31f092b5be2c550aceaae8992729c6bc71d7dd919b71b669217866febd26ce014528cd91eb392af1c96
+  metadata.gz: 87538383c69009f3610778a717ae6263accb950e07b8803914358927bfc1e7510c18c664d88267b17dcabbeaab4fa97d4ac72b3294ae492472d0659843dbe540
+  data.tar.gz: 459343281dd3b295141eed4c8091ccc3d9ce6228d49c293eb6a182d26676428eaf4cb571295b8f55ac4101ba88d879c7525b06f5ad1596a83ea544d2f88a8351

data/README.adoc

@@ -2376,6 +2376,106 @@ Fontisan can:
 * Importing and generation PNG block ruler layers
 
 
+== UFO source operations
+
+fontisan reads, writes, and compiles UFO (Unified Font Object) v2/v3
+font sources into binary font formats (TTF, OTF). No AFDKO or Python
+fonttools needed.
+
+=== Build a UFO to binary
+
+[source,bash]
+----
+# TTF (TrueType outlines)
+fontisan ufo build font.ufo --output out.ttf --to ttf
+
+# OTF (CFF outlines)
+fontisan ufo build font.ufo --output out.otf --to otf
+----
+
+The TTF compiler automatically applies:
+- `cubic_to_quadratic` filter (UFO cubic Beziers -> TTF quadratic)
+- `reverse_contour_direction` filter (TTF winding convention)
+
+=== Convert between UFO and binary
+
+[source,bash]
+----
+# UFO -> binary
+fontisan ufo convert font.ufo out.ttf --to ttf
+
+# Binary -> UFO (reverse direction)
+fontisan ufo convert font.ttf font.ufo/
+----
+
+=== Validate a UFO source
+
+[source,bash]
+----
+fontisan ufo validate font.ufo
+----
+
+Checks: glyphs present, family name set, unitsPerEm set, .notdef exists.
+
+=== Ruby API
+
+[source,ruby]
+----
+require "fontisan"
+
+# Read a UFO
+font = Fontisan::Ufo::Font.open("font.ufo")
+puts font.family_name
+puts font.glyphs.size
+
+# Compile to TTF
+Fontisan::Ufo::Compile::TtfCompiler.new(font).compile(output_path: "out.ttf")
+
+# Compile to OTF
+Fontisan::Ufo::Compile::OtfCompiler.new(font).compile(output_path: "out.otf")
+
+# Write back to UFO (round-trip)
+Fontisan::Ufo::Writer.new(font).write("out.ufo")
+
+# Convert a binary font to UFO
+ttf = Fontisan::FontLoader.load("font.ttf")
+ufo = Fontisan::Ufo::Convert::FromBinData.convert(ttf)
+----
+
+== Font stitching
+
+The Stitcher combines glyphs from multiple source fonts into one new
+font. Sources can be UFO directories or loaded TTF/OTF files.
+
+=== Ruby API
+
+[source,ruby]
+----
+stitcher = Fontisan::Stitcher.new
+stitcher.add_source(:latin, Fontisan::FontLoader.load("NotoSans.ttf"))
+stitcher.add_source(:cjk, Fontisan::FontLoader.load("FSung-m.ttf"))
+
+stitcher.include_range(0x41..0x5A, from: :latin)    # A-Z
+stitcher.include_range(0x4E00..0x9FFF, from: :cjk)  # CJK Unified
+stitcher.include_notdef(from: :latin)
+
+stitcher.write_to("stitched.ttf", format: :ttf)
+----
+
+=== CLI
+
+[source,bash]
+----
+fontisan stitch \
+  --source latin=NotoSans.ttf \
+  --source cjk=FSung-m.ttf \
+  --include-range latin=0x41-0x5A \
+  --include-range cjk=0x4E00-0x9FFF \
+  --notdef-from latin \
+  --output stitched.ttf
+----
+
+
 == Testing
 
 === General

data/lib/fontisan/ufo/compile/cff.rb

@@ -53,7 +53,8 @@ module Fontisan
         end
 
         def self.empty_charstring(width)
-          Fontisan::Tables::Cff::CharStringBuilder.build_empty(width: width.zero? ? nil : width)
+          builder = Fontisan::Tables::Cff::CharStringBuilder.new
+          builder.build_empty(width: width.zero? ? nil : width)
         end
 
         # ---------- layout ----------

data/lib/fontisan/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fontisan
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fontisan
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-29 00:00:00.000000000 Z
+date: 2026-06-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64