7.5 KiB
Optional share-image fonts
Body settings, poster design and share images use the same directory of 23 named fonts, including all five fonts in Qiaomu’s designer starter pack. They load remote, version-pinned resources on demand; no additional font binaries are included in Web, desktop, Android or iOS packages. The picker, loader and license notices add a small amount of application code.
| Choice | Pinned package and stylesheet |
|---|---|
| Smiley Sans | @chinese-fonts/dyh@3.0.0/dist/SmileySans-Oblique/result.css |
| LXGW WenKai | @chinese-fonts/lxgwwenkai@3.0.0/dist/LXGWWenKai-Regular/result.css |
| Zhuque Fangsong | @chinese-fonts/zqfs@3.0.0/dist/ZhuqueFangsong-Regular/result.css |
| Noto Sans SC Heavy | @fontsource/noto-sans-sc@5.3.1/900.css |
| PuHuiTi Regular · Recommended | @fontpkg/alibaba-pu-hui-ti-3-0@3.1.2/AlibabaPuHuiTi-3-55-Regular.ttf |
| PuHuiTi Heavy · Recommended | @fontpkg/alibaba-pu-hui-ti-3-0@3.1.2/AlibabaPuHuiTi-3-105-Heavy.ttf |
| YouShe Title · Recommended | @fontpkg/you-she-biao-ti-hei@1.0.0/优设标题黑.ttf |
| Alimama ShuHei · Recommended | @fontpkg/alimama-shu-hei-ti@1.0.5/AlimamaShuHeiTi-Bold.ttf |
Smiley Sans is also a member of the five-font recommended pack. The four additional recommended files are downloaded unchanged, with pinned byte lengths and SHA-256 digests. SHA-256 is checked when Web Crypto is available; byte length and container checks apply in all contexts. They are approximately 8.53 MB, 2.54 MB, 1.41 MB and 1.36 MB respectively. They are not converted or subsetted. Each original file is downloaded when its font is selected or its preview row becomes visible, not by installing the application. Opening and scrolling the picker can therefore download several complete original fonts.
packages/shared/src/font-catalog.ts defines the catalog used by share images, body typography and poster design. note-image-remote-fonts.ts keeps the original share-image exports compatible. Subsets are provided by the Chinese Webfont Project and Fontsource. Each request first tries jsDelivr, then unpkg. For CSS-backed fonts, only descriptors for WOFF2 files in the pinned package directory are accepted; external styles are never inserted into the page.
For CSS-backed fonts, the selected font's manifest is fetched on demand. The renderer matches its Unicode ranges against the card's text and downloads only matching subsets, not the entire family. Note text is matched locally and is never sent in font requests. Manifests and font bytes are cached in the separate, disposable IndexedDB database edgeever-share-font-cache. Downloads are deduplicated, failed requests can be retried, and unavailable storage does not prevent online rendering. The application waits for font loading before rendering the image.
Offline reuse requires both the manifest and the relevant character subsets to remain cached. A new character may require another download. Browser storage eviction, restricted WebViews, or clearing site data can remove this ability; HTTP caching and in-session deduplication still apply where available. Selecting a catalog font in body settings changes editor typography; the existing card-theme fonts remain available.
The original four optional fonts use SIL OFL 1.1. The four newly added starter-pack fonts retain their original vendor terms and metadata, rather than being described as OFL. Copyright notices and the license are retained in packages/shared/src/note-image-remote-font-notices.ts and included with generated font CSS for OFL fonts. Original-file fonts instead include source attribution in the generated CSS. Font outlines and font-file names are not modified. The CSS family aliases isolate share-image fonts from editor fonts.
Checks for this change include shared unit tests, Web and mobile type checks, the Web build, the iOS editor type check/build, and Chrome image exports before and after reloading with font CDNs blocked. Android USB-device and iOS-device acceptance must still be performed separately; a desktop browser check does not establish native-platform acceptance.
The Web picker renders each visible name in its corresponding font, including the selected value. Hidden rows do not start preview downloads. Name previews reuse the same face and persistent resource caches as image export, without generating another embedded base64 stylesheet or fetching paper textures. Failed previews keep a readable system-font label and do not prevent selection.
Shared body and poster typography
font-loader.ts owns optional-font downloading, integrity checks, registration and export CSS. All three entry points keep using the existing edgeever-share-font-cache database and URL keys, so previously cached fonts remain usable. The Web FontLabel component previews only visible rows; each picker reads the same 23 catalog entries, in the same order and with the same names.
Body preferences keep their existing storage keys and legacy choices. Selecting a catalog face applies its shared family with a system or existing local fallback. A debounced observer loads new character subsets as note text changes or another note mounts. Publishing accepts the catalog IDs through the existing body-font setting; no database schema or migration is changed.
Posters preserve existing Chinese family names in saved source. These names resolve to catalog IDs at loading time. Template builds load their selected pairing and any explicit faces/fixed text before final layout; object creation and PNG export await the text's fonts. Reopening a serialized poster follows the same path. All 23 poster families now resolve through the common loader. Legacy body choices remain readable and are shown when already selected; new selections use the common directory. Interface typography retains its existing choices.
No font binaries are added to client packages. The shared catalog, loader and preview UI add application code. Android and iOS device acceptance remains separate from Web and editor-bundle checks.
Existing poster assets
The additional 15 fonts are Noto Serif SC, Anton, Douyin Sans, Ma Shan Zheng, Jiangcheng Rounded, ZCOOL QingKe HuangYou, Glow Sans, ZCOOL KuaiLe, Noto Sans SC, Noto Serif SC Heavy, Inter, DM Serif Display, Bebas Neue, Space Grotesk and JetBrains Mono. They reuse the exact existing poster files from repository commit 0da78f6ce8a4643b2dfb7afe9f7a5101472c4ffb; byte lengths and SHA-256 digests are catalog metadata. Web and desktop first reuse their existing /poster-fonts/ resources, then try the pinned jsDelivr GitHub URL and raw GitHub mirror. File-based native WebViews use the remote sources. All paths share the same persistent cache keys, integrity checks, loading status and retry behavior.
These existing files are downloaded unchanged, including the already subsetted WOFF2 resources. Their retained copyright and license texts are included in exported CSS via poster-font-notices.ts. Latin fonts display Chinese through normal fallback; loading a Latin font does not add Chinese glyphs. No new font binaries are added or copied into client packages. Only catalog, license and application code changes are included.
Android reads the shared catalog directly. The iOS choice projection is generated from it by bun scripts/sync-font-catalog.mjs; use --check to verify it is current. This keeps persisted share-image choices aligned with the editor renderer. Native device acceptance remains separate from browser verification.