@xingwangzhe/stalux 1.30.1 → 1.30.3

package/README.md

@@ -105,6 +105,8 @@ bun run dev
 
 Stalux ships with LXGW WenKai and a variable code font (Google Sans Code). During the build, the Rust/N-API package `@xingwangzhe/cjk-font-split-native` creates one content-addressed WOFF2 subset from each page's visible or expandable CJK text. The browser downloads only the page subset; repeated character sets share the same file. CJK text inside code and MathML is covered too.
 
+Arabic digits `0-9` are always reserved in every subset (`RESERVED_GLYPHS`), even on pages without any visible number. Digits produced at runtime by client scripts — clocks, counters, dates, injected values — never appear in the built HTML, so reserving them keeps numbers from falling back to a system font. Callers can append more characters through the optional `extraChars` argument of `writePageFontSubset`.
+
 The subset CSS uses an exact per-character `unicode-range` and `font-display: swap`, so visible text and the downloaded glyphs stay aligned. The variable code font continues to use Astro's local Fonts API.
 
 The persistent BLAKE3 cache key includes font bytes, face index, normalized character set, and algorithm version. Cache files live under `node_modules/.astro/` and are reused across pages and incremental builds. Font inputs are read locally; builds do not fetch fonts from the network.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@xingwangzhe/stalux",
-    "version": "1.30.1",
+    "version": "1.30.3",
     "description": "A powerful, modern Astro blog theme — use as template or install as plugin",
     "keywords": [
         "astro",

package/src/internal/font-slices.ts

@@ -34,6 +34,17 @@ const CODE_FONT_ITALIC_INPUT = "src/assets/fonts/GoogleSansCode-Italic.woff2";
 
 const PAGE_SLICE_OUT_DIR = "node_modules/.astro/stalux-page-fonts";
 
+/**
+ * Characters always reserved in every page subset, regardless of page content.
+ *
+ * Digits are extracted from rendered text nodes, so any number produced at
+ * runtime (clock, counters, dates, values injected by client scripts) or
+ * carried only in attributes would fall outside the subset and render as
+ * fallback glyphs — a visible "font splitting" bug. Reserving 0-9 costs
+ * ~10 glyphs per page and makes digit rendering unconditional.
+ */
+export const RESERVED_GLYPHS = "0123456789";
+
 // ---------------------------------------------------------------------------
 // Types
 // ---------------------------------------------------------------------------
@@ -242,6 +253,7 @@ export function writePageFontSubset(
     cacheDir: string,
     publicUrlPrefix = "/_astro/fonts/",
     linkedStylesheetText = "",
+    extraChars = "",
 ): PageFontSubset | undefined {
     const document = parse(html);
     const body = findBody(document);
@@ -254,7 +266,8 @@ export function writePageFontSubset(
         linkedStylesheetText,
     ];
     collectBodyText(body, bodyText);
-    const chars = [...new Set([...bodyText.join("")].filter((char) => !/\p{C}/u.test(char)))].sort(
+    const glyphSource = `${RESERVED_GLYPHS}${extraChars}${bodyText.join("")}`;
+    const chars = [...new Set([...glyphSource].filter((char) => !/\p{C}/u.test(char)))].sort(
         (a, b) => (a.codePointAt(0) as number) - (b.codePointAt(0) as number),
     );
     if (chars.length === 0) return undefined;