fontisan 0.4.12 → 0.4.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e97f99deb241e5abd1bbdaeb27849efb3a4597bf2139fc8a1fa815fcccbfdfcb
-  data.tar.gz: ced71eac0e00e479581c5460e33672aa80ded30cd40cb590b5a09621c5441290
+  metadata.gz: 47e074b8c2bbdcfa377c95733f56fdd978dfa4d824dbae3e29f3bd75935dddd6
+  data.tar.gz: a1a348db0bd6dde039c0a43f62ac3ab43792cc7414e995a72c47798663a1cd59
 SHA512:
-  metadata.gz: cc72fc9f58560fddf2440ecead8a54060a06a6da38ac3de2212d893cb3dbb2dea88649c82c30ff8fb10d25389058a63770d4309e414856f031ab3d88659f4150
-  data.tar.gz: bac0c91aa712516256d2ae7fb7ccee7dd31fe1549ace5bb533ea9d2b27b7087da4b0b200412794b3677b44c43bae79c87cbcaa849db3f6d993d00dac91a1e3a3
+  metadata.gz: e8917cc8c995f0ca2cbdc9e94ad5d5d629ab95d8809b7eb728d360f0743a2b26e5cfd059254497c5a1df10ddb3b53258ee703c441a106d4febd42b26ea3b6e08
+  data.tar.gz: d35a8138d7cdbc5389b619ed757863cc0d61e1d8d025655d0fb6736a21815f04d24802f24236fdffdc8d430192db79798f77f7b9343193e0c16035d2be8fc5eb

data/README.adoc

@@ -120,7 +120,7 @@ Font format support::
 * TTF, OTF (CFF1), OTF2 (CFF2), TTC, OTC font formats (production ready)
 * CFF2 with variable-font blend/vsindex operators, FDSelect, subroutines
 * Adobe Type 1 fonts (PFB/PFA) with bidirectional conversion (see link:docs/TYPE1_FONTS.adoc[Type 1 Fonts Guide])
-* WOFF/WOFF2 format support with reading, writing, and conversion (see link:docs/WOFF_WOFF2_FORMATS.adoc[WOFF/WOFF2 Guide])
+* WOFF/WOFF2 format support with reading, writing, and conversion — fully compliant with W3C WOFF 1.0 (https://www.w3.org/TR/WOFF/[Recommendation 13 December 2012]) and WOFF 2.0 (https://www.w3.org/TR/WOFF2/[Recommendation 08 August 2024]) specifications. See link:docs/WOFF_WOFF2_FORMATS.adoc[WOFF/WOFF2 Guide].
 * Apple legacy font support: 'true' signature TrueType fonts and dfont format (see link:docs/APPLE_LEGACY_FONTS.adoc[Apple Legacy Fonts Guide])
 * SVG font generation and SVG-to-glyph conversion (complete)
 

data/docs/WOFF_WOFF2_FORMATS.adoc

@@ -8,6 +8,79 @@ including reading, writing, and conversion between these and other font formats.
 WOFF is a wrapper around SFNT fonts (TTF/OTF) using zlib compression, while WOFF2
 uses Brotli compression for better compression ratios and table transformations.
 
+== W3C specification compliance
+
+Fontisan's WOFF and WOFF2 implementations are fully compliant with the
+W3C Recommendations:
+
+* **WOFF 1.0** (W3C Recommendation, 13 December 2012):
+  https://www.w3.org/TR/WOFF/[spec] — reading and writing
+* **WOFF 2.0** (W3C Recommendation, 08 August 2024):
+  https://www.w3.org/TR/WOFF2/[spec] — reading and writing
+
+=== WOFF 2.0 (spec section references below)
+
+Compliance covers every normative requirement of the WOFF2 spec:
+
+* *Section 3.2 (WOFF2 Header)*: 48-byte header with correct signature
+  (`wOF2`), flavor, file length, reserved=0, totalSfntSize,
+  totalCompressedSize, version, and meta/private offset/length fields.
+* *Section 4.1 (Table directory)*: flags byte structure (bits 0-5 tag
+  index, bits 6-7 transform version); optional 4-byte custom tag when
+  index=63; `transformLength` field present IFF table is transformed.
+* *Section 4.2 (Collection directory)*: full support for flavor=`ttcf`
+  font collections — CollectionHeader + CollectionFontEntry per font,
+  with deduplicated tables shared across fonts via directory indices.
+* *Section 5 (Compressed data)*: single Brotli stream of all tables in
+  directory order; `DSIG` table removed per encoder rule; `head.flags`
+  bit 11 set to indicate lossless modifying transform.
+* *Section 5.1 (Transformed glyf table)*: 36-byte header (uint16
+  version + uint16 optionFlags + uint16 numGlyphs + uint16 indexFormat
+  + 7 × uint32 stream sizes); 7 streams in spec order (nContour,
+  nPoints, flags, glyph, composite, bbox with bboxBitmap prefix,
+  instructions); optional overlapSimpleBitmap when optionFlags bit 0
+  is set; bboxBitmap semantics per spec (composite glyphs always have
+  explicit bbox, simple glyphs omit when calculated bbox matches,
+  empty glyphs MUST have all-zero bbox).
+* *Section 5.2 (Triplet coordinate encoding)*: variable-length
+  coordinate codec with all 128 flag index variants (1-4 byte
+  payloads based on coordinate magnitude); bit 7 = off-curve flag.
+* *Section 5.3 (Transformed loca table)*: `transformLength` MUST be 0;
+  loca data omitted from compressed stream (reconstructed by decoder
+  from glyf).
+* *Section 5.4 (Transformed hmtx table)*: optional version 1 transform
+  exploiting `lsb == xMin` redundancy.
+* *Section 5.5 (Table order constraints)*: loca MUST immediately
+  follow glyf in table directory; for collections, loca MUST
+  immediately follow its corresponding glyf with no other tables in
+  between.
+
+Validation: fontisan's WOFF2 output is verified byte-identical to
+fontTools' output for transformed glyf tables, and round-trips
+correctly through the W3C `woff2_decompress` reference tool.
+
+=== WOFF 1.0
+
+* *Section 4 (WOFF Header)*: 44-byte header with correct signature
+  (`wOFF`), flavor, length, numTables, reserved=0, totalSfntSize,
+  version, and meta/private offset/length fields.
+* *Section 5 (Table directory)*: 20-byte entries with tag, offset,
+  compLength, origLength, origChecksum. Tables sorted in input font
+  order per spec ("MUST be stored in the same order as the
+  well-formed input font").
+* *Section 6 (Font data tables)*: tables compressed individually with
+  zlib (compress2-compatible); each table 4-byte aligned and
+  zero-padded to next boundary ("MUST begin on 4-byte boundaries and
+  be zero-padded to the next 4-byte boundary").
+* *Section 7 (Extended metadata)*: optional block of XML data,
+  always zlib-compressed ("it is never stored in uncompressed form").
+* *Section 8 (Private data)*: optional block of arbitrary bytes,
+  always 4-byte aligned.
+
+Validation: fontisan's WOFF 1 output round-trips through fontTools
+without errors; all 4-byte alignment, padding, and compression
+requirements verified by spec-conformance specs.
+
 === Display WOFF/WOFF2 font information
 
 Show metadata specific to WOFF/WOFF2 fonts including version, compression details,