padding is the setting that corrects oversized glyphs from full-bleed artwork, but it is effectively undiscoverable.
README.md contains a single occurrence: the bare line "padding": 0, inside a config sample, with no explanation.docs/ contains zero occurrences.- No document mentions the symptom it addresses, so searching for something like "icons too big" finds nothing.
A user whose icons render oversized has no path from the symptom to the setting other than reading src/glyphpact/font_builder.py or the JSON schema.
Also worth stating explicitly in docs: padding is top-level only. Per-icon overrides accept name, matchTextDirection, author, copyright, license, sourceUrl, and partialAlpha, but not padding. That bounds what the setting can fix, since a pack mixing full-bleed and already-padded art cannot be normalized by one global value.
paddingis the setting that corrects oversized glyphs from full-bleed artwork, but it is effectively undiscoverable.README.mdcontains a single occurrence: the bare line"padding": 0,inside a config sample, with no explanation.docs/contains zero occurrences.A user whose icons render oversized has no path from the symptom to the setting other than reading
src/glyphpact/font_builder.pyor the JSON schema.Also worth stating explicitly in docs:
paddingis top-level only. Per-icon overrides acceptname,matchTextDirection,author,copyright,license,sourceUrl, andpartialAlpha, but notpadding. That bounds what the setting can fix, since a pack mixing full-bleed and already-padded art cannot be normalized by one global value.