# QA notes

Pivot Sans 1.200 was audited on 2026-07-29 with fontTools 4.63.0,
HarfBuzz 14.2.1 through uharfbuzz 0.55.0, OpenType Sanitizer 9.2.0,
FontBakery 1.1.0, glyphsets 1.1.3, shaperglot 1.2.1, Playwright 1.61.0,
and Chromium 149.0.7827.55.

## Clean release gates

- Project pytest suite: **244 passed**.
- OpenType Sanitizer: **38 of 38** distributed TTF/WOFF2 files passed.
- FontBakery OpenType:
  - variable pair: 86 PASS / 0 WARN / 0 FAIL;
  - ten standard statics: 297 PASS / 0 WARN / 0 FAIL;
  - four custom pins: 110 PASS / 0 WARN / 0 FAIL; and
  - each decompressed locale-slice pair: 86 PASS / 0 WARN / 0 FAIL.
- FontBakery Universal:
  - variable pair: 189 PASS / 6 inherited WARN / 0 FAIL;
  - ten standard statics: 733 PASS / 32 inherited WARN / 0 FAIL; and
  - four custom pins: 285 PASS / 12 inherited WARN / 0 FAIL.
- Two complete measurement/build/subset/compression/render passes produced
  byte-for-byte identical `dist/` trees.
- Headless Chromium:
  - six of six isolated style/locale `unicode-range` cases fetched only an
    allowed slice;
  - ten upright/italic named-weight money comparisons aligned;
  - all font responses returned HTTP 200;
  - twelve upright/italic named and arbitrary-weight `ss02` comparisons
    retained identical advances while producing distinct glyph rendering;
  - the 550 italic, `tnum`, `ss01`, and default-off `ss02` controls composed
    correctly; and
  - the full specimen produced no console or network errors.
- The deterministic QA image and browser specimen were visually inspected.

## Behavioral and purity coverage

The release suite checks:

- the shared digit/currency grid at every integer weight from 300 to 700;
- default-off `ss02` shaping for nine semantic lowercase-l sources, including
  Marshallese localization, at every integer weight in both styles;
- native-derived foot geometry, equal source metrics, GDEF classification,
  pair positioning on both sides, and decomposed-mark attachment for every
  `ss02` alternate;
- flattened native component recipes for accented alternates, with no nested
  composite in any desktop font or retained locale slice;
- the upstream heavy-dollar `rvrn` transition under `tnum`;
- all new symbol mappings, components, portable component flags, metrics,
  and shaping;
- every official static font and both custom pin weights;
- semantic purity of every upstream outline, metric, variation delta, and
  layout record, with source behavior cloned only onto new `ss02` glyphs;
- exact locale-whitelist coverage, disjoint slice cmaps, retained features,
  metadata, and size budgets;
- TTF/WOFF2 parity, deterministic timestamps, source/release checksums,
  authorship, naming, and Windows clipping bounds.

## Retained upstream warnings

The variable fonts produce the same six warning classes as the authoritative
Inclusive Sans 2.004 inputs:

- two `alt_caron` decomposed-outline warnings;
- two `mandatory_avar_table` warnings. The inherited single `wght` axis is
  deliberately linear, so an identity `avar` would not change behavior; and
- two `math_signs_width` warnings. Pivot Sans’s four new relation composites
  all share the equal-sign advance; the reported outliers are retained
  upstream operators such as less/greater, minus, divide, and multiply.

The standard static set produces 32 inherited warnings:

- ten `alt_caron` warnings;
- ten `contour_count` warnings related to upstream static/`rvrn`
  specialization;
- ten `math_signs_width` warnings; and
- two `overlapping_path_segments` warnings in the upstream Light designs.

The custom pins produce the corresponding four `alt_caron`, four
`contour_count`, and four `math_signs_width` warnings. Dormant `rvrn` helper
glyphs were pruned after instancing, removing four avoidable
`unreachable_glyphs` warnings without changing Unicode coverage or shaping.

The Universal `nested_components` and `stylisticset_description` checks pass
for all 16 desktop TTFs. Pivot Sans expands existing composite source recipes
to their native simple components before appending the `ss02` foot, and
provides a named FeatureParams record for the stylistic set.

These warnings concern retained Inclusive Sans design/source decisions. Pivot
Sans does not rewrite unchanged upstream outlines merely to silence heuristic
checks.

## Intentional locale-slice behavior

The extension WOFF2 files are `unicode-range` shards, not standalone text
fonts. Space, no-break space, shared ASCII, punctuation, combining marks, and
some cross-slice case support live in `latin-core`. Running FontBakery
Universal on an extension shard alone therefore reports expected
missing-whitespace or case-counterpart failures. Duplicating those codepoints
would overlap the ranges and cause browsers to fetch extensions on ordinary
Latin pages.

The appropriate per-slice gates are clean: exact cmap intersection, disjoint
coverage, feature shaping, HVAR behavior, OTS, and FontBakery OpenType after
WOFF2 decompression. The browser audit independently proves selective loading.

During this audit, pyftsubset was found to retain the full font’s
`hhea.advanceWidthMax` in slices whose widest glyph had been removed. The
build now recalculates all horizontal-header extrema after each subset; this
remediation is regression-tested.

## Improvements over the upstream/static baseline

The official Inclusive Sans 2.004 static set produced 10 FontBakery failures
because `usWinAscent=1150` did not cover the family yMax of 1159, plus four
stale bounding-box warnings. Pivot Sans corrects both issues without changing
any upstream outline point, existing cmap assignment, or existing
kerning/mark-positioning record. New 1.200 layout records apply only to the
new `ss02` alternates.
