@volter/twin-googlefonts 1.0.2 → 1.0.3

package/src/semantics/shared.ts

@@ -7,8 +7,61 @@ export const assetKey = (value: string): string => {
   if (url.hostname !== 'fonts.gstatic.com' || url.username || url.password || !['http:', 'https:'].includes(url.protocol)) throw new Error('Invalid font URL');
   url.searchParams.sort(); return url.pathname + url.search;
 };
+// THE BROWSER CLASS. Google answers a stylesheet to any browser, choosing the representation by the browser its
+// User-Agent names: WOFF 2.0 only to a browser that supports it, unicode-range subsets only to one that supports them.
+// source: https://developers.googleblog.com/2015/02/smaller-fonts-with-woff-20-and-unicode.html "serve WOFF 2.0 only to supporting browsers (what we do at Google Fonts)"
+// source: https://developers.googleblog.com/2015/02/smaller-fonts-with-woff-20-and-unicode.html "you should serve unicode-range property only to browsers that support it fully"
+// source: https://developers.google.com/fonts/docs/getting_started "the browser will select from the subsets supported by the font to get what it needs to render the text"
+// google-webfonts-helper picks one agent per format, which is the sample the pack retains for each of those classes.
+// source: https://raw.githubusercontent.com/majodev/google-webfonts-helper/ff245dc87cfcbaeacd4120cf1b4a7443b59db42f/server/config.ts "must serve complete woff2 file for one variant (no unicode range support yet!)"
+// Where the documentation stops: Google publishes no rule from an agent to its representation. The classes below are
+// the answers Google gave on 2026-11-13 to the agents vendor/SOURCE.md lists (GET /css2?family=Inter:wght@500, each
+// answer's SHA-256 compared): agents in one class were answered the same bytes. Google also builds the files per
+// platform (macOS, mobile, and every other desktop were answered different faces), so a class names its platform where
+// Google's answer did. A legacy agent whose answer the probes did not find shared with others (an old Safari, iOS 5 to
+// 10, an old Chrome or Firefox on macOS or Android) is a class of its own exact engine version: it reads only a
+// representation published for that version, never another browser's.
+type Platform = 'desktop' | 'mac' | 'mobile';
+const major = (userAgent: string, pattern: RegExp): number => Number(pattern.exec(userAgent)?.[1] ?? Number.NaN);
+export const browserClass = (userAgent: string): string => {
+  const ua = userAgent;
+  const platform: Platform = /\b(?:Android|iPhone|iPad|iPod)\b/.test(ua) ? 'mobile' : /\bMacintosh\b/.test(ua) ? 'mac' : 'desktop';
+  // an agent that is no browser (none, node, undici, curl) is answered truetype, as an unknown browser on a desktop is
+  if (!ua.startsWith('Mozilla/')) return 'truetype';
+  const legacy = (engine: string, version: string): string => `legacy ${engine} ${version} ${platform}`;
+  const msie = major(ua, /\bMSIE (\d+)/);
+  if (msie <= 8) return 'eot';
+  if (msie >= 9 || /\bTrident\/7\./.test(ua)) return 'woff desktop';
+  // every browser on iOS is Safari's engine, whatever it calls itself (CriOS, FxiOS)
+  const ios = /\bOS (\d+)_(\d+)(?:_\d+)? like Mac OS X\b/.exec(ua);
+  if (ios) {
+    const [v, minor] = [Number(ios[1]), Number(ios[2])];
+    if (v <= 4) return 'svg';
+    return v >= 11 || (v === 10 && minor >= 3) ? 'woff2+range mobile' : legacy('ios', `${v}_${minor}`);
+  }
+  const chrome = /\b(?:HeadlessChrome|Chrome|Chromium|CriOS)\/((\d+)[\d.]*)/.exec(ua);
+  if (chrome) {
+    const v = Number(chrome[2]);
+    if (v >= 43) return `woff2+range ${platform}`;
+    if (platform !== 'desktop') return legacy('chrome', chrome[1]!);
+    return v >= 40 ? 'woff+range desktop' : 'woff desktop';
+  }
+  const firefox = /\bFirefox\/((\d+)[\d.]*)/.exec(ua);
+  if (firefox) {
+    const v = Number(firefox[2]);
+    // on macOS Google answers Firefox 44 to 59 the mobile faces, and Firefox 60 and later WOFF with unicode-range
+    if (platform === 'mac') return v >= 60 ? 'woff+range mac' : v >= 44 ? 'woff2+range mobile' : legacy('firefox', firefox[1]!);
+    if (v >= 44) return `woff2+range ${platform}`;
+    if (platform !== 'desktop') return legacy('firefox', firefox[1]!);
+    return v >= 39 ? 'woff2 desktop' : 'woff desktop';
+  }
+  // Safari on macOS names its version; Android's own browser names one too, and is answered truetype
+  const safari = /\bVersion\/((\d+)[\d.]*)(?: Mobile)?(?:\/\S+)? Safari\//.exec(ua);
+  if (safari && platform === 'mac') return Number(safari[2]) >= 10 ? 'woff+range mac' : legacy('safari', safari[1]!);
+  return platform === 'mobile' ? 'truetype mobile' : 'truetype';
+};
 export const cssKey = (ctx: HandlerContext, family: string, subset: string, userAgent: string): string =>
-  ctx.crypto.digest('sha256', JSON.stringify([family, subset, userAgent]));
+  ctx.crypto.digest('sha256', JSON.stringify([family, subset, browserClass(userAgent)]));
 // A CSS2 request is its ordered query pairs; family may repeat, text and display may not.
 export const css2Query = (query: URLSearchParams): Array<[string, string]> | undefined => {
   const pairs = [...query.entries()];
@@ -18,7 +71,7 @@ export const css2Query = (query: URLSearchParams): Array<[string, string]> | und
   return pairs;
 };
 export const css2Key = (ctx: HandlerContext, pairs: Array<[string, string]>, userAgent: string): string =>
-  ctx.crypto.digest('sha256', JSON.stringify(['css2', pairs, userAgent]));
+  ctx.crypto.digest('sha256', JSON.stringify(['css2', pairs, browserClass(userAgent)]));
 export const googleError = (status: number, message: string, kind = status === 403 ? 'PERMISSION_DENIED' : 'INVALID_ARGUMENT'): Response =>
   Response.json({ error: { code: status, message, status: kind } }, { status });
 export const htmlError = (status: number, message: string): Response =>

package/vendor/DMMono-OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The DM Mono Project Authors (https://www.github.com/googlefonts/dm-mono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/vendor/SOURCE.md

@@ -34,6 +34,27 @@ per unicode-range subset. SHA-256: the CSS 9b6ad588c451f646d506bc6badb76ecc38469
 the faces, in the CSS's order, fccca918…21b5, aebf2ab4…4bd6, a2e2c783…c271, 46dd4cdc…22bf, 8db00ff4…1931,
 a28eb6d3…aaa2, c9407645…c3e4. Inter's font software is under the SIL Open Font License 1.1 (Inter-OFL.txt).
 
+The Chromium data (vendor/inter-dm-mono-chromium.json) is Google's CSS2 answer for the two stylesheets
+Twenty's front-end index.html links, `family=Inter:wght@400;500;600&display=swap` and
+`family=DM+Mono:wght@400;500;600&display=swap`, retained on 2026-11-13 with the User-Agent of Playwright's
+Chromium 153.0.8010.12 headless shell on Linux and on macOS, and the woff2 faces they name. SHA-256 of the
+four stylesheets: Inter on Linux 414e9dbfc53a116f58f01160269a679e84bc1733d98a39d29ff1362b2b764166, DM Mono on
+Linux dc9977cb7b69cc1c1f28d712c1a7744da2a120b6c9be05e38788db1a07fc978a, Inter on macOS
+dac87631d9b2228a3d47cea91e82a8d4f91b6be79f8d6ab8e0189d41f9becfe3, DM Mono on macOS
+a93b88b1a1e247952a5d420495bbeb0c2498c7fde2d0b0787fe3e2643947d450. The macOS Inter answer names the seven faces
+of vendor/inter-variable.json (the same URLs and bytes, kept once). The fifteen new faces, in the file's order:
+Inter ca157063…5ebd, 71d5ee93…0075, 6e9e020a…2190, 1be3448e…b6f6, 5c66f9e0…3ff2, 34b9c504…c956, 3100e775…4c62;
+DM Mono a52e19eb…7175, e1896b13…3e1e, 8711f938…22f5, 9964608a…9951, 7f8712cb…14d9, fd7521f3…7b6d, e284f2a1…6f6c,
+0e263db5…9f36. Inter's font software is under the SIL Open Font License 1.1 (Inter-OFL.txt); DM Mono's is
+under the SIL Open Font License 1.1 (DMMono-OFL.txt, https://raw.githubusercontent.com/google/fonts/main/ofl/dmmono/OFL.txt,
+retained 2026-11-13, SHA-256 2bada5ea45c3c63b7f1ea1f88ce9672c9e4f0c42b2c3b7378949084fe55a3066).
+
+The browser classes (vendor/browser-classes.json) are Google's CSS2 answer to
+`family=Inter:wght@500` for each of 58 User-Agents, retained on 2026-11-13 with each answer's SHA-256, formats
+and face count. Google documents that it serves WOFF 2.0 and unicode-range only to browsers that support them
+but no rule from an agent to its answer; the agents answered identical bytes are one class of
+src/semantics/shared.ts browserClass, and every class there was answered one set of bytes.
+
 Antic's font software is under the SIL Open Font License 1.1 (OFL.txt).
 Google documentation and its example data are CC BY 4.0, with attribution here:
 https://developers.google.com/fonts/docs/developer_api