@volter/twin-googlefonts 0.0.0-stage → 1.0.1

package/dist/assets/spec/openapi.json

@@ -0,0 +1,162 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "Google Fonts font-file hosts",
+    "version": "2026-10-12"
+  },
+  "servers": [
+    {
+      "url": "https://fonts.gstatic.com"
+    }
+  ],
+  "paths": {
+    "/s/{file}": {
+      "get": {
+        "operationId": "getFontFile",
+        "description": "Download the font-file bytes named by a Google Fonts stylesheet src URL.",
+        "parameters": [
+          {
+            "name": "file",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The font-file bytes at the returned stylesheet URL",
+            "content": {
+              "font/eot": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              },
+              "font/ttf": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              },
+              "font/woff": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              },
+              "font/woff2": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              },
+              "image/svg+xml": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Font file not found",
+            "content": {
+              "text/html": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "files"
+        ]
+      }
+    },
+    "/l/font": {
+      "get": {
+        "operationId": "getLegacyFontFile",
+        "description": "Download the font-file bytes named by a Google Fonts stylesheet src URL for a legacy browser.",
+        "parameters": [
+          {
+            "name": "kit",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "skey",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "v",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The font-file bytes at the returned stylesheet URL",
+            "content": {
+              "font/eot": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              },
+              "font/ttf": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              },
+              "font/woff": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              },
+              "font/woff2": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              },
+              "image/svg+xml": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Font file not found",
+            "content": {
+              "text/html": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "files"
+        ]
+      }
+    }
+  }
+}

package/dist/assets/spec/sources.json

@@ -0,0 +1 @@
+{}

package/dist/assets/src/fetch.d.ts

@@ -0,0 +1,2 @@
+import { type DerivedFetch, type PackFetchOptions } from '@volter/world-core';
+export declare function createAssetsLaneFetch(options?: PackFetchOptions): DerivedFetch;

package/dist/assets/src/fetch.js

@@ -0,0 +1,13 @@
+// GENERATED by scripts/create-pack.ts (--init, --index): a fixed file. The kernel serves the discovery door, the clock,
+// the World's doors, the vendor's screens and the API from the pack's parts (architecture, "The pack contract").
+import { createPackFetch } from '@volter/world-core';
+import surface from './generated/surface.gen.json' with { type: 'json' };
+import { manifest } from "./manifest.js";
+import { assetsSemantics } from "./semantics/index.js";
+export function createAssetsLaneFetch(options = {}) {
+    return createPackFetch({
+        manifest,
+        surface: surface,
+        handlers: assetsSemantics,
+    }, options);
+}

package/dist/assets/src/fetch.ts

@@ -0,0 +1,14 @@
+// GENERATED by scripts/create-pack.ts (--init, --index): a fixed file. The kernel serves the discovery door, the clock,
+// the World's doors, the vendor's screens and the API from the pack's parts (architecture, "The pack contract").
+import { createPackFetch, type DerivedFetch, type DerivedSurface, type PackFetchOptions } from '@volter/world-core';
+import surface from './generated/surface.gen.json' with { type: 'json' };
+import { manifest } from './manifest.ts';
+import { assetsSemantics } from './semantics/index.ts';
+
+export function createAssetsLaneFetch(options: PackFetchOptions = {}): DerivedFetch {
+  return createPackFetch({
+    manifest,
+    surface: surface as DerivedSurface,
+    handlers: assetsSemantics,
+  }, options);
+}

package/dist/assets/src/generated/surface.gen.json

@@ -0,0 +1 @@
+{"generatedBy":"scripts/derive-pack.ts","spec":"openapi.json","format":"openapi","version":"2026-10-12","resources":[],"operations":[{"id":"getLegacyFontFile","method":"get","path":"/l/font","pathParams":[],"query":[{"name":"kit","type":"string","required":true},{"name":"skey","type":"string","required":true},{"name":"v","type":"string","required":true}],"body":[],"bodyEncoding":"none","successStatus":200,"responseMedia":{"200":["image/svg+xml"]},"class":"computed"},{"id":"getFontFile","method":"get","path":"/s/{file}","pathParams":["file"],"query":[],"body":[],"bodyEncoding":"none","successStatus":200,"responseMedia":{"200":["image/svg+xml"]},"class":"computed"}]}

package/dist/assets/src/generated/ui.gen.json

@@ -0,0 +1 @@
+{"generatedBy":"scripts/derive-pack.ts","resources":{}}

package/dist/assets/src/index.d.ts

@@ -0,0 +1,2 @@
+export { createAssetsLaneFetch } from './fetch.js';
+export { manifest } from './manifest.js';

package/dist/assets/src/index.js

@@ -0,0 +1,3 @@
+// The assets lane of the googlefonts pack: the vendor's manifest routes its requests here.
+export { createAssetsLaneFetch } from "./fetch.js";
+export { manifest } from "./manifest.js";

package/dist/assets/src/index.ts

@@ -0,0 +1,3 @@
+// The assets lane of the googlefonts pack: the vendor's manifest routes its requests here.
+export { createAssetsLaneFetch } from './fetch.ts';
+export { manifest } from './manifest.ts';

package/dist/assets/src/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { DerivedManifest } from '@volter/world-core';
+export declare const manifest: DerivedManifest;

package/dist/assets/src/manifest.js

@@ -0,0 +1,17 @@
+export const manifest = {
+    vendor: 'googlefonts', service: 'googlefonts', body: { json: 'always' },
+    ids: { template: '{uuid}' }, time: 'iso',
+    error: { error: { code: '{status}', message: '{message}', status: '{kind}' } },
+    readOnly: { status: 403, kind: 'PERMISSION_DENIED', message: 'Read-only World' },
+    notFound: { status: 404, kind: 'NOT_FOUND', message: 'Not Found' },
+    gap: { status: 404, kind: 'NOT_FOUND', message: 'Not Found' },
+    list: { style: 'envelope', envelope: { items: '{data}' }, limit: { param: 'limit', default: 100, max: 100 } },
+    deleted: {},
+    resources: {},
+    discovery: { twinOf: 'Google Fonts font bytes', stores: 'Published catalog and font representations in the shared googlefonts store' },
+    spanning: ['file'],
+    descriptor: { protocol: '3', transport: 'rest', archetype: 'crud', bin: 'world-googlefonts-assets',
+        resources: [], specSource: 'assets/spec/SOURCE.md', description: 'Google Fonts font bytes',
+        adoption: { sdks: [], envStems: [] }, hosts: [{ host: 'fonts.gstatic.com', pathPattern: '^/(s/|l/font$)' }],
+        endpointEnvNone: 'The application hardcodes this vendor lane host.' },
+};

package/dist/assets/src/manifest.ts

@@ -0,0 +1,19 @@
+// Vendor wire facts; the surface is derived from the retained spec.
+import type { DerivedManifest } from '@volter/world-core';
+export const manifest: DerivedManifest = {
+  vendor: 'googlefonts', service: 'googlefonts', body: { json: 'always' },
+  ids: { template: '{uuid}' }, time: 'iso',
+  error: { error: { code: '{status}', message: '{message}', status: '{kind}' } },
+  readOnly: { status: 403, kind: 'PERMISSION_DENIED', message: 'Read-only World' },
+  notFound: { status: 404, kind: 'NOT_FOUND', message: 'Not Found' },
+  gap: { status: 404, kind: 'NOT_FOUND', message: 'Not Found' },
+  list: { style: 'envelope', envelope: { items: '{data}' }, limit: { param: 'limit', default: 100, max: 100 } },
+  deleted: {},
+  resources: {},
+  discovery: { twinOf: 'Google Fonts font bytes', stores: 'Published catalog and font representations in the shared googlefonts store' },
+  spanning: ['file'],
+  descriptor: { protocol: '3', transport: 'rest', archetype: 'crud', bin: 'world-googlefonts-assets',
+    resources: [], specSource: 'assets/spec/SOURCE.md', description: 'Google Fonts font bytes',
+    adoption: { sdks: [], envStems: [] }, hosts: [{ host: 'fonts.gstatic.com', pathPattern: '^/(s/|l/font$)' }],
+    endpointEnvNone: 'The application hardcodes this vendor lane host.' },
+};

package/dist/assets/src/semantics/index.d.ts

@@ -0,0 +1,2 @@
+import type { Handler } from '@volter/world-core';
+export declare const assetsSemantics: Record<string, Handler>;

package/dist/assets/src/semantics/index.js

@@ -0,0 +1,6 @@
+import * as l from "./l.js";
+import * as s from "./s.js";
+export const assetsSemantics = {
+    getFontFile: s.getFontFile,
+    getLegacyFontFile: l.getLegacyFontFile,
+};

package/dist/assets/src/semantics/index.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/create-pack.ts --index: the handler map, by operationId, from the families' files (each
+// handler named as its operation). Do not edit; add a handler to its family's file and generate again.
+import type { Handler } from '@volter/world-core';
+import * as l from './l.ts';
+import * as s from './s.ts';
+
+export const assetsSemantics: Record<string, Handler> = {
+  getFontFile: s.getFontFile,
+  getLegacyFontFile: l.getLegacyFontFile,
+};

package/dist/assets/src/semantics/l.d.ts

@@ -0,0 +1,2 @@
+import type { HandlerContext } from '@volter/world-core';
+export declare function getLegacyFontFile(ctx: HandlerContext): Promise<Response>;

package/dist/assets/src/semantics/l.js

@@ -0,0 +1,3 @@
+import { downloadFont } from "./shared.js";
+// source: spec:getLegacyFontFile "Download the font-file bytes named by a Google Fonts stylesheet src URL for a legacy browser."
+export async function getLegacyFontFile(ctx) { return downloadFont(ctx); }

package/dist/assets/src/semantics/l.ts

@@ -0,0 +1,4 @@
+import type { HandlerContext } from '@volter/world-core';
+import { downloadFont } from './shared.ts';
+// source: spec:getLegacyFontFile "Download the font-file bytes named by a Google Fonts stylesheet src URL for a legacy browser."
+export async function getLegacyFontFile(ctx: HandlerContext): Promise<Response> { return downloadFont(ctx); }

package/dist/assets/src/semantics/s.d.ts

@@ -0,0 +1,2 @@
+import type { HandlerContext } from '@volter/world-core';
+export declare function getFontFile(ctx: HandlerContext): Promise<Response>;

package/dist/assets/src/semantics/s.js

@@ -0,0 +1,3 @@
+import { downloadFont } from "./shared.js";
+// source: spec:getFontFile "Download the font-file bytes named by a Google Fonts stylesheet src URL."
+export async function getFontFile(ctx) { return downloadFont(ctx); }

package/dist/assets/src/semantics/s.ts

@@ -0,0 +1,4 @@
+import type { HandlerContext } from '@volter/world-core';
+import { downloadFont } from './shared.ts';
+// source: spec:getFontFile "Download the font-file bytes named by a Google Fonts stylesheet src URL."
+export async function getFontFile(ctx: HandlerContext): Promise<Response> { return downloadFont(ctx); }

package/dist/assets/src/semantics/shared.d.ts

@@ -0,0 +1,2 @@
+import type { HandlerContext } from '@volter/world-core';
+export declare function downloadFont(ctx: HandlerContext): Promise<Response>;

package/dist/assets/src/semantics/shared.js

@@ -0,0 +1,13 @@
+import { FILE, assetKey, htmlError } from "../../../src/semantics/shared.js";
+export async function downloadFont(ctx) {
+    const request = new URL(ctx.call.request.url);
+    const vendorUrl = new URL(request.pathname + request.search, 'https://fonts.gstatic.com');
+    const row = ctx.row(FILE, assetKey(vendorUrl.href));
+    if (!row)
+        return htmlError(404, 'Font file not found');
+    const body = await ctx.blobs.get(String(row.blob));
+    if (!body)
+        return htmlError(404, 'Font file not found');
+    return new Response(Uint8Array.from(body).buffer, { headers: { 'content-type': String(row.contentType), 'content-length': String(body.length),
+            'access-control-allow-origin': '*', 'cache-control': 'public, max-age=31536000, immutable' } });
+}

package/dist/assets/src/semantics/shared.ts

@@ -0,0 +1,13 @@
+import type { HandlerContext } from '@volter/world-core';
+import { FILE, assetKey, htmlError } from '../../../src/semantics/shared.ts';
+
+export async function downloadFont(ctx: HandlerContext): Promise<Response> {
+  const request = new URL(ctx.call.request.url);
+  const vendorUrl = new URL(request.pathname + request.search, 'https://fonts.gstatic.com');
+  const row = ctx.row(FILE, assetKey(vendorUrl.href));
+  if (!row) return htmlError(404, 'Font file not found');
+  const body = await ctx.blobs.get(String(row.blob));
+  if (!body) return htmlError(404, 'Font file not found');
+  return new Response(Uint8Array.from(body).buffer, { headers: { 'content-type': String(row.contentType), 'content-length': String(body.length),
+    'access-control-allow-origin': '*', 'cache-control': 'public, max-age=31536000, immutable' } });
+}

package/dist/css/spec/SOURCE.md

@@ -0,0 +1,15 @@
+# Google Fonts CSS API v1 and CSS2
+
+This contract is written from Google's https://developers.google.com/fonts/docs/getting_started,
+https://developers.google.com/fonts/docs/css2 and the retained responses in vendor/inputs.json,
+vendor/inter.json and vendor/noto-sans-sc-text.json. google-webfonts-helper calls
+GET /css?family=<family>:<variant>&subset=<subsets> with the exact configured
+User-Agent and consumes each @font-face's font-family, style, weight and src URL.
+Dub's Open Graph routes call GET /css2?family=Inter:wght@<weight> and Rallly's
+calls GET /css2?family=Noto+Sans+SC:wght@<weight>&text=<text>, both from a server
+without a browser User-Agent, and read the truetype src URL.
+The supplied representations retain actual vendor CSS. Requests without a
+published representation answer a refusal, never an invented font format.
+text/display/effect on /css are outside this client's demand.
+
+SHA-256 `openapi.json`: bf7b9a3b70c3a75712fb784e22bfe07c0008dd55e1aa93b31cba8da26a64fb60

package/dist/css/spec/openapi.json

@@ -0,0 +1,142 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "Google Fonts CSS API",
+    "version": "v1"
+  },
+  "servers": [
+    {
+      "url": "https://fonts.googleapis.com"
+    }
+  ],
+  "paths": {
+    "/css": {
+      "get": {
+        "operationId": "getStylesheet",
+        "description": "The Google Fonts API provides the regular version of the requested fonts by default. To request other styles or weights, append a colon to the name of the font. The subset parameter specifies script subsets. The representation is selected for the requesting browser.",
+        "parameters": [
+          {
+            "name": "family",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "subset",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "User-Agent",
+            "in": "header",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A stylesheet referring to font-file URLs",
+            "content": {
+              "text/css": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad font request",
+            "content": {
+              "text/html": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/css2": {
+      "get": {
+        "operationId": "getStylesheet2",
+        "description": "It all starts with a new base URL: https://fonts.googleapis.com/css2 The syntax for specifying styles within each family has changed to describe variable font ‘design spaces.’ To request multiple families, specify the family= param for each family. Please note that the 'text=' parameter can only be specified once. It applies to all families in the request. As a general note, the updated CSS API is more strict about what requests are accepted than the original CSS API. The representation is selected for the requesting browser.",
+        "parameters": [
+          {
+            "name": "family",
+            "in": "query",
+            "required": true,
+            "style": "form",
+            "explode": true,
+            "description": "<family_name>[:<axis_tag_list>@<axis_tuple_list>]",
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          {
+            "name": "text",
+            "in": "query",
+            "required": false,
+            "description": "The text that will be displayed in the requested typeface",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "display",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "auto",
+                "block",
+                "swap",
+                "fallback",
+                "optional"
+              ]
+            }
+          },
+          {
+            "name": "User-Agent",
+            "in": "header",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A stylesheet referring to font-file URLs",
+            "content": {
+              "text/css": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad font request",
+            "content": {
+              "text/html": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/css/spec/sources.json

@@ -0,0 +1 @@
+{}

package/dist/css/src/fetch.d.ts

@@ -0,0 +1,2 @@
+import { type DerivedFetch, type PackFetchOptions } from '@volter/world-core';
+export declare function createCssLaneFetch(options?: PackFetchOptions): DerivedFetch;

package/dist/css/src/fetch.js

@@ -0,0 +1,13 @@
+// GENERATED by scripts/create-pack.ts (--init, --index): a fixed file. The kernel serves the discovery door, the clock,
+// the World's doors, the vendor's screens and the API from the pack's parts (architecture, "The pack contract").
+import { createPackFetch } from '@volter/world-core';
+import surface from './generated/surface.gen.json' with { type: 'json' };
+import { manifest } from "./manifest.js";
+import { cssSemantics } from "./semantics/index.js";
+export function createCssLaneFetch(options = {}) {
+    return createPackFetch({
+        manifest,
+        surface: surface,
+        handlers: cssSemantics,
+    }, options);
+}

package/dist/css/src/fetch.ts

@@ -0,0 +1,14 @@
+// GENERATED by scripts/create-pack.ts (--init, --index): a fixed file. The kernel serves the discovery door, the clock,
+// the World's doors, the vendor's screens and the API from the pack's parts (architecture, "The pack contract").
+import { createPackFetch, type DerivedFetch, type DerivedSurface, type PackFetchOptions } from '@volter/world-core';
+import surface from './generated/surface.gen.json' with { type: 'json' };
+import { manifest } from './manifest.ts';
+import { cssSemantics } from './semantics/index.ts';
+
+export function createCssLaneFetch(options: PackFetchOptions = {}): DerivedFetch {
+  return createPackFetch({
+    manifest,
+    surface: surface as DerivedSurface,
+    handlers: cssSemantics,
+  }, options);
+}

package/dist/css/src/generated/surface.gen.json

@@ -0,0 +1 @@
+{"generatedBy":"scripts/derive-pack.ts","spec":"openapi.json","format":"openapi","version":"v1","resources":[],"operations":[{"id":"getStylesheet","method":"get","path":"/css","pathParams":[],"query":[{"name":"family","type":"string","required":true},{"name":"subset","type":"string","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"class":"computed"},{"id":"getStylesheet2","method":"get","path":"/css2","pathParams":[],"query":[{"name":"display","type":"string","required":false},{"name":"family","type":"array","required":true},{"name":"text","type":"string","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"class":"computed"}]}

package/dist/css/src/generated/ui.gen.json

@@ -0,0 +1 @@
+{"generatedBy":"scripts/derive-pack.ts","resources":{}}

package/dist/css/src/index.d.ts

@@ -0,0 +1,2 @@
+export { createCssLaneFetch } from './fetch.js';
+export { manifest } from './manifest.js';

package/dist/css/src/index.js

@@ -0,0 +1,3 @@
+// The css lane of the googlefonts pack: the vendor's manifest routes its requests here.
+export { createCssLaneFetch } from "./fetch.js";
+export { manifest } from "./manifest.js";

package/dist/css/src/index.ts

@@ -0,0 +1,3 @@
+// The css lane of the googlefonts pack: the vendor's manifest routes its requests here.
+export { createCssLaneFetch } from './fetch.ts';
+export { manifest } from './manifest.ts';

package/dist/css/src/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { DerivedManifest } from '@volter/world-core';
+export declare const manifest: DerivedManifest;

package/dist/css/src/manifest.js

@@ -0,0 +1,16 @@
+export const manifest = {
+    vendor: 'googlefonts', service: 'googlefonts', body: { json: 'always' },
+    ids: { template: '{uuid}' }, time: 'iso',
+    error: { error: { code: '{status}', message: '{message}', status: '{kind}' } },
+    readOnly: { status: 403, kind: 'PERMISSION_DENIED', message: 'Read-only World' },
+    notFound: { status: 404, kind: 'NOT_FOUND', message: 'Not Found' },
+    gap: { status: 404, kind: 'NOT_FOUND', message: 'Not Found' },
+    list: { style: 'envelope', envelope: { items: '{data}' }, limit: { param: 'limit', default: 100, max: 100 } },
+    deleted: {},
+    resources: {},
+    discovery: { twinOf: 'Google Fonts browser-selected CSS', stores: 'Published catalog and font representations in the shared googlefonts store' },
+    descriptor: { protocol: '3', transport: 'rest', archetype: 'crud', bin: 'world-googlefonts-css',
+        resources: [], specSource: 'css/spec/SOURCE.md', description: 'Google Fonts browser-selected CSS',
+        adoption: { sdks: [], envStems: [] }, hosts: [{ host: 'fonts.googleapis.com', pathPattern: '^/css2?$' }],
+        endpointEnvNone: 'The application hardcodes this vendor lane host.' },
+};

package/dist/css/src/manifest.ts

@@ -0,0 +1,19 @@
+// Vendor wire facts; the surface is derived from the retained spec.
+import type { DerivedManifest } from '@volter/world-core';
+export const manifest: DerivedManifest = {
+  vendor: 'googlefonts', service: 'googlefonts', body: { json: 'always' },
+  ids: { template: '{uuid}' }, time: 'iso',
+  error: { error: { code: '{status}', message: '{message}', status: '{kind}' } },
+  readOnly: { status: 403, kind: 'PERMISSION_DENIED', message: 'Read-only World' },
+  notFound: { status: 404, kind: 'NOT_FOUND', message: 'Not Found' },
+  gap: { status: 404, kind: 'NOT_FOUND', message: 'Not Found' },
+  list: { style: 'envelope', envelope: { items: '{data}' }, limit: { param: 'limit', default: 100, max: 100 } },
+  deleted: {},
+  resources: {},
+  discovery: { twinOf: 'Google Fonts browser-selected CSS', stores: 'Published catalog and font representations in the shared googlefonts store' },
+  
+  descriptor: { protocol: '3', transport: 'rest', archetype: 'crud', bin: 'world-googlefonts-css',
+    resources: [], specSource: 'css/spec/SOURCE.md', description: 'Google Fonts browser-selected CSS',
+    adoption: { sdks: [], envStems: [] }, hosts: [{ host: 'fonts.googleapis.com', pathPattern: '^/css2?$' }],
+    endpointEnvNone: 'The application hardcodes this vendor lane host.' },
+};

package/dist/css/src/semantics/css.d.ts

@@ -0,0 +1,2 @@
+import type { HandlerContext } from '@volter/world-core';
+export declare function getStylesheet(ctx: HandlerContext): Promise<Response>;

package/dist/css/src/semantics/css.js

@@ -0,0 +1,19 @@
+import { CATALOG, CSS, cssKey, htmlError } from "./shared.js";
+// source: spec:getStylesheet "The representation is selected for the requesting browser."
+export async function getStylesheet(ctx) {
+    const query = new URL(ctx.call.request.url).searchParams;
+    const family = query.get('family'), subset = query.get('subset') ?? 'latin';
+    if (!family || [...query.keys()].some(k => !['family', 'subset'].includes(k)))
+        return htmlError(400, 'Bad font request');
+    const generation = ctx.row(CATALOG, 'published')?.fingerprint;
+    const key = cssKey(ctx, family, subset, ctx.call.request.headers.get('user-agent') ?? '');
+    const row = generation === undefined ? undefined : ctx.row(CSS, String(generation) + ':' + key);
+    // Where the documentation stops: no supplied representation is a named
+    // refusal, not an invented conversion or another browser's font format.
+    if (!row)
+        return htmlError(400, 'Font family or browser representation is not published');
+    const body = await ctx.blobs.get(String(row.blob));
+    if (!body)
+        return htmlError(404, 'Font stylesheet not found');
+    return new Response(Uint8Array.from(body).buffer, { headers: { 'content-type': 'text/css; charset=utf-8', 'content-length': String(body.length), 'vary': 'User-Agent' } });
+}