@volter/twin-googlefonts 0.0.0-stage → 1.0.2

package/src/semantics/shared.ts

@@ -0,0 +1,25 @@
+import type { HandlerContext } from '@volter/world-core';
+export const FONT = 'webfont', CATALOG = '_font_catalog', CSS = '_stylesheet', FILE = '_font_file', KEY = '_api_key';
+export const object = (value: unknown): Record<string, unknown> =>
+  value !== null && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : {};
+export const assetKey = (value: string): string => {
+  const url = new URL(value); url.hash = '';
+  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;
+};
+export const cssKey = (ctx: HandlerContext, family: string, subset: string, userAgent: string): string =>
+  ctx.crypto.digest('sha256', JSON.stringify([family, subset, 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()];
+  const once = (name: string) => pairs.filter(([k]) => k === name).length <= 1;
+  if (!pairs.some(([k, v]) => k === 'family' && v) || pairs.some(([k]) => !['family', 'text', 'display'].includes(k)) ||
+      !once('text') || !once('display')) return undefined;
+  return pairs;
+};
+export const css2Key = (ctx: HandlerContext, pairs: Array<[string, string]>, userAgent: string): string =>
+  ctx.crypto.digest('sha256', JSON.stringify(['css2', pairs, 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 =>
+  new Response('<!doctype html><title>' + status + '</title><p>' + message.replace(/[<>&]/g, c => ({'<':'&lt;','>':'&gt;','&':'&amp;'}[c]!)) + '</p>', { status, headers: { 'content-type': 'text/html; charset=UTF-8' } });

package/src/server.ts

@@ -0,0 +1,8 @@
+// FETCH-FIRST (runtime contract R12b): a fixed file, the kernel's serve seam around the pack's fetch (./fetch.ts).
+import { serveHttp, type PackFetchOptions } from '@volter/world-core';
+import { createGooglefontsFetch } from './fetch.ts';
+
+export async function createGooglefontsTwinServer(options: PackFetchOptions & { port?: number } = {}): Promise<{ port: number; stop: () => void }> {
+  const server = await serveHttp({ port: options.port ?? 0, idleTimeout: 60, fetch: createGooglefontsFetch(options) });
+  return { port: server.port ?? options.port ?? 0, stop: () => server.stop(true) };
+}

package/vendor/Inter-OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
+
+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:
+https://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/OFL.txt

@@ -0,0 +1,94 @@
+Copyright (c) 2011, Santiago Orozco (hi@typemade.mx),
+with Reserved Font Name "Antic"
+
+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

@@ -0,0 +1,40 @@
+# Antic reference data
+
+The selected catalog item is the unchanged Antic object in Google's published
+Developer API example (family Antic, v19, 2022-09-22), not a claim to reproduce
+Google's entire catalog or current popularity. Its enclosing list is a selected
+reference-data World catalog. The five CSS representations and seven font files
+were retained from Google's public font servers on 2026-10-12, using exactly the
+five user agents google-webfonts-helper config.ts selects at ff245dc8. The current
+CSS points at v20 while the older published catalog example points at v19; both
+source identities are preserved. The SVG URL's fragment is client-side and is
+excluded from the stored HTTP asset key. No font was converted or substituted.
+
+Google Fonts has no create-font operation in its Developer API. The default data
+therefore calls the declared publisher door, which stores vendor-shaped items,
+the actual CSS and font bytes in the World's resource/blob store. It does not
+pretend that a vendor API mutation occurred. Operators may publish other actual
+catalog snapshots through the same door. The seven base64 strings are transport
+inputs to that door; persisted font bytes live only in the resource blob store.
+
+The Inter data (vendor/inter.json) is Google's CSS2 answer for Inter at weights
+500, 600 and 700, retained on 2026-10-15 with no User-Agent, "node" and "undici"
+(the same bytes for all three), and the three truetype files it names. Inter's
+font software is under the SIL Open Font License 1.1 (Inter-OFL.txt).
+
+The Noto Sans SC data (vendor/noto-sans-sc-text.json) is Google's CSS2 answer for Rallly's
+request, Noto Sans SC 700 with text= its title's two glyphs, retained on 2026-10-15 with no
+User-Agent, "node" and "undici" (the same bytes for all three), and the truetype subset it names.
+Noto Sans SC's font software is under the SIL Open Font License 1.1.
+
+The Inter variable data (vendor/inter-variable.json) is Google's CSS2 answer for
+`family=Inter:wght@100..900&display=swap`, next/font/google's build-time request, retained on
+2026-11-09 with next/font's User-Agent (Chrome/104 on macOS), and the seven woff2 faces it names, one
+per unicode-range subset. SHA-256: the CSS 9b6ad588c451f646d506bc6badb76ecc384691fba35615f0f7d2e175150d6580;
+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).
+
+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
+https://developers.google.com/fonts/docs/getting_started