@volter/twin-googlefonts 0.0.0-stage → 1.0.1

package/api/spec/openapi.json

@@ -0,0 +1,647 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "Web Fonts Developer API",
+    "version": "v1 rev 20260903",
+    "description": "Converted by scripts/spec-discovery-to-openapi.ts from retained Discovery bytes (fetched 2026-10-12); flatPath routes, request/response schemas and Discovery metadata retained."
+  },
+  "servers": [
+    {
+      "url": "https://webfonts.googleapis.com"
+    }
+  ],
+  "components": {
+    "schemas": {
+      "WebfontList": {
+        "properties": {
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Webfont"
+            },
+            "description": "The list of fonts currently served by the Google Fonts API."
+          },
+          "kind": {
+            "description": "This kind represents a list of webfont objects in the webfonts service.",
+            "type": "string"
+          }
+        },
+        "type": "object",
+        "x-discovery-id": "WebfontList",
+        "description": "Response containing the list of fonts currently served by the Google Fonts API."
+      },
+      "Tag": {
+        "description": "Metadata for a tag.",
+        "type": "object",
+        "x-discovery-id": "Tag",
+        "properties": {
+          "weight": {
+            "format": "float",
+            "type": "number",
+            "description": "The weight of the tag."
+          },
+          "name": {
+            "description": "The name of the tag.",
+            "type": "string"
+          }
+        }
+      },
+      "Webfont": {
+        "description": "Metadata describing a family of fonts.",
+        "x-discovery-id": "Webfont",
+        "type": "object",
+        "properties": {
+          "colorCapabilities": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "The color format(s) available for this family."
+          },
+          "category": {
+            "type": "string",
+            "description": "The category of the font."
+          },
+          "tags": {
+            "items": {
+              "$ref": "#/components/schemas/Tag"
+            },
+            "type": "array",
+            "description": "The tags that apply to this family."
+          },
+          "files": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "type": "object",
+            "description": "The font files (with all supported scripts) for each one of the available variants, as a key : value map."
+          },
+          "variants": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array",
+            "description": "The available variants for the font."
+          },
+          "lastModified": {
+            "description": "The date (format \"yyyy-MM-dd\") the font was modified for the last time.",
+            "type": "string"
+          },
+          "subsets": {
+            "description": "The scripts supported by the font.",
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "axes": {
+            "description": "Axis for variable fonts.",
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Axis"
+            }
+          },
+          "kind": {
+            "type": "string",
+            "description": "This kind represents a webfont object in the webfonts service."
+          },
+          "menu": {
+            "description": "Font URL for menu subset, a subset of the font that is enough to display the font name",
+            "type": "string"
+          },
+          "version": {
+            "description": "The font version.",
+            "type": "string"
+          },
+          "family": {
+            "type": "string",
+            "description": "The name of the font."
+          }
+        }
+      },
+      "Axis": {
+        "type": "object",
+        "x-discovery-id": "Axis",
+        "properties": {
+          "start": {
+            "format": "float",
+            "type": "number",
+            "description": "minimum value"
+          },
+          "tag": {
+            "description": "tag name.",
+            "type": "string"
+          },
+          "end": {
+            "format": "float",
+            "description": "maximum value",
+            "type": "number"
+          }
+        },
+        "description": "Metadata for a variable font axis."
+      }
+    }
+  },
+  "x-source": {
+    "kind": "discovery",
+    "fetched": "2026-10-12",
+    "converter": "scripts/spec-discovery-to-openapi.ts"
+  },
+  "x-discovery-revision": "20260903",
+  "x-discovery-title": "Web Fonts Developer API",
+  "x-discovery-basePath": "",
+  "x-discovery-parameters": {
+    "quotaUser": {
+      "location": "query",
+      "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+      "type": "string"
+    },
+    "uploadType": {
+      "location": "query",
+      "type": "string",
+      "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\")."
+    },
+    "access_token": {
+      "description": "OAuth access token.",
+      "location": "query",
+      "type": "string"
+    },
+    "callback": {
+      "description": "JSONP",
+      "location": "query",
+      "type": "string"
+    },
+    "key": {
+      "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+      "location": "query",
+      "type": "string"
+    },
+    "prettyPrint": {
+      "description": "Returns response with indentations and line breaks.",
+      "location": "query",
+      "type": "boolean",
+      "default": "true"
+    },
+    "alt": {
+      "description": "Data format for response.",
+      "type": "string",
+      "default": "json",
+      "enum": [
+        "json",
+        "media",
+        "proto"
+      ],
+      "location": "query",
+      "enumDescriptions": [
+        "Responses with Content-Type of application/json",
+        "Media download with context-dependent Content-Type",
+        "Responses with Content-Type of application/x-protobuf"
+      ]
+    },
+    "upload_protocol": {
+      "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+      "type": "string",
+      "location": "query"
+    },
+    "oauth_token": {
+      "type": "string",
+      "description": "OAuth 2.0 token for the current user.",
+      "location": "query"
+    },
+    "fields": {
+      "description": "Selector specifying which fields to include in a partial response.",
+      "type": "string",
+      "location": "query"
+    },
+    "$.xgafv": {
+      "type": "string",
+      "location": "query",
+      "enum": [
+        "1",
+        "2"
+      ],
+      "enumDescriptions": [
+        "v1 error format",
+        "v2 error format"
+      ],
+      "description": "V1 error format."
+    }
+  },
+  "x-discovery-rootUrl": "https://webfonts.googleapis.com/",
+  "x-discovery-batchPath": "batch",
+  "x-discovery-discoveryVersion": "v1",
+  "x-discovery-protocol": "rest",
+  "x-discovery-mtlsRootUrl": "https://webfonts.mtls.googleapis.com/",
+  "x-discovery-servicePath": "",
+  "x-discovery-kind": "discovery#restDescription",
+  "x-discovery-ownerName": "Google",
+  "x-discovery-canonicalName": "Webfonts",
+  "x-discovery-id": "webfonts:v1",
+  "x-discovery-documentationLink": "https://developers.google.com/fonts/docs/developer_api",
+  "x-discovery-baseUrl": "https://webfonts.googleapis.com/",
+  "x-discovery-name": "webfonts",
+  "x-discovery-ownerDomain": "google.com",
+  "x-discovery-description": "The Google Web Fonts Developer API lets you retrieve information about web fonts served by Google.",
+  "x-discovery-icons": {
+    "x16": "http://www.google.com/images/icons/product/search-16.gif",
+    "x32": "http://www.google.com/images/icons/product/search-32.gif"
+  },
+  "x-discovery-version": "v1",
+  "paths": {
+    "/v1/webfonts": {
+      "get": {
+        "operationId": "webfonts.webfonts.list",
+        "description": "Retrieves the list of fonts currently served by the Google Fonts Developer API.",
+        "tags": [
+          "webfonts"
+        ],
+        "parameters": [
+          {
+            "name": "quotaUser",
+            "in": "query",
+            "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+            "schema": {
+              "type": "string"
+            },
+            "x-discovery-parameter": {
+              "location": "query",
+              "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+              "type": "string"
+            }
+          },
+          {
+            "name": "uploadType",
+            "in": "query",
+            "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+            "schema": {
+              "type": "string"
+            },
+            "x-discovery-parameter": {
+              "location": "query",
+              "type": "string",
+              "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\")."
+            }
+          },
+          {
+            "name": "access_token",
+            "in": "query",
+            "description": "OAuth access token.",
+            "schema": {
+              "type": "string"
+            },
+            "x-discovery-parameter": {
+              "description": "OAuth access token.",
+              "location": "query",
+              "type": "string"
+            }
+          },
+          {
+            "name": "callback",
+            "in": "query",
+            "description": "JSONP",
+            "schema": {
+              "type": "string"
+            },
+            "x-discovery-parameter": {
+              "description": "JSONP",
+              "location": "query",
+              "type": "string"
+            }
+          },
+          {
+            "name": "key",
+            "in": "query",
+            "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+            "schema": {
+              "type": "string"
+            },
+            "x-discovery-parameter": {
+              "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+              "location": "query",
+              "type": "string"
+            }
+          },
+          {
+            "name": "prettyPrint",
+            "in": "query",
+            "description": "Returns response with indentations and line breaks.",
+            "schema": {
+              "type": "boolean",
+              "default": "true"
+            },
+            "x-discovery-parameter": {
+              "description": "Returns response with indentations and line breaks.",
+              "location": "query",
+              "type": "boolean",
+              "default": "true"
+            }
+          },
+          {
+            "name": "alt",
+            "in": "query",
+            "description": "Data format for response.",
+            "schema": {
+              "type": "string",
+              "default": "json",
+              "enum": [
+                "json",
+                "media",
+                "proto"
+              ],
+              "x-discovery-enumDescriptions": [
+                "Responses with Content-Type of application/json",
+                "Media download with context-dependent Content-Type",
+                "Responses with Content-Type of application/x-protobuf"
+              ]
+            },
+            "x-discovery-parameter": {
+              "description": "Data format for response.",
+              "type": "string",
+              "default": "json",
+              "enum": [
+                "json",
+                "media",
+                "proto"
+              ],
+              "location": "query",
+              "enumDescriptions": [
+                "Responses with Content-Type of application/json",
+                "Media download with context-dependent Content-Type",
+                "Responses with Content-Type of application/x-protobuf"
+              ]
+            }
+          },
+          {
+            "name": "upload_protocol",
+            "in": "query",
+            "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+            "schema": {
+              "type": "string"
+            },
+            "x-discovery-parameter": {
+              "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+              "type": "string",
+              "location": "query"
+            }
+          },
+          {
+            "name": "oauth_token",
+            "in": "query",
+            "description": "OAuth 2.0 token for the current user.",
+            "schema": {
+              "type": "string"
+            },
+            "x-discovery-parameter": {
+              "type": "string",
+              "description": "OAuth 2.0 token for the current user.",
+              "location": "query"
+            }
+          },
+          {
+            "name": "fields",
+            "in": "query",
+            "description": "Selector specifying which fields to include in a partial response.",
+            "schema": {
+              "type": "string"
+            },
+            "x-discovery-parameter": {
+              "description": "Selector specifying which fields to include in a partial response.",
+              "type": "string",
+              "location": "query"
+            }
+          },
+          {
+            "name": "$.xgafv",
+            "in": "query",
+            "description": "V1 error format.",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "1",
+                "2"
+              ],
+              "x-discovery-enumDescriptions": [
+                "v1 error format",
+                "v2 error format"
+              ]
+            },
+            "x-discovery-parameter": {
+              "type": "string",
+              "location": "query",
+              "enum": [
+                "1",
+                "2"
+              ],
+              "enumDescriptions": [
+                "v1 error format",
+                "v2 error format"
+              ],
+              "description": "V1 error format."
+            }
+          },
+          {
+            "name": "capability",
+            "in": "query",
+            "description": "Controls the font urls in `Webfont.files`, by default, static ttf fonts are sent.",
+            "schema": {
+              "type": "array",
+              "items": {
+                "enum": [
+                  "CAPABILITY_UNSPECIFIED",
+                  "WOFF2",
+                  "VF",
+                  "FAMILY_TAGS"
+                ],
+                "type": "string",
+                "x-discovery-enumDescriptions": [
+                  "Default means static ttf fonts.",
+                  "Use WOFF2(Compressed)instead of ttf.",
+                  "Prefer variable font files instead of static fonts instantiated at standard weights.",
+                  "Include tags that apply to the entire family in the response."
+                ]
+              }
+            },
+            "x-discovery-parameter": {
+              "location": "query",
+              "repeated": true,
+              "enum": [
+                "CAPABILITY_UNSPECIFIED",
+                "WOFF2",
+                "VF",
+                "FAMILY_TAGS"
+              ],
+              "description": "Controls the font urls in `Webfont.files`, by default, static ttf fonts are sent.",
+              "type": "string",
+              "enumDescriptions": [
+                "Default means static ttf fonts.",
+                "Use WOFF2(Compressed)instead of ttf.",
+                "Prefer variable font files instead of static fonts instantiated at standard weights.",
+                "Include tags that apply to the entire family in the response."
+              ]
+            }
+          },
+          {
+            "name": "category",
+            "in": "query",
+            "description": "Filters by Webfont.category, if category is found in Webfont.categories. If not set, returns all families.",
+            "schema": {
+              "type": "string"
+            },
+            "x-discovery-parameter": {
+              "type": "string",
+              "description": "Filters by Webfont.category, if category is found in Webfont.categories. If not set, returns all families.",
+              "location": "query"
+            }
+          },
+          {
+            "name": "subset",
+            "in": "query",
+            "description": "Filters by Webfont.subset, if subset is found in Webfont.subsets. If not set, returns all families.",
+            "schema": {
+              "type": "string"
+            },
+            "x-discovery-parameter": {
+              "description": "Filters by Webfont.subset, if subset is found in Webfont.subsets. If not set, returns all families.",
+              "type": "string",
+              "location": "query"
+            }
+          },
+          {
+            "name": "sort",
+            "in": "query",
+            "description": "Enables sorting of the list.",
+            "schema": {
+              "type": "string",
+              "x-discovery-enumDescriptions": [
+                "No sorting specified, use the default sorting method.",
+                "Sort alphabetically",
+                "Sort by date added",
+                "Sort by popularity",
+                "Sort by number of styles",
+                "Sort by trending"
+              ],
+              "enum": [
+                "SORT_UNDEFINED",
+                "ALPHA",
+                "DATE",
+                "POPULARITY",
+                "STYLE",
+                "TRENDING"
+              ]
+            },
+            "x-discovery-parameter": {
+              "type": "string",
+              "description": "Enables sorting of the list.",
+              "location": "query",
+              "enumDescriptions": [
+                "No sorting specified, use the default sorting method.",
+                "Sort alphabetically",
+                "Sort by date added",
+                "Sort by popularity",
+                "Sort by number of styles",
+                "Sort by trending"
+              ],
+              "enum": [
+                "SORT_UNDEFINED",
+                "ALPHA",
+                "DATE",
+                "POPULARITY",
+                "STYLE",
+                "TRENDING"
+              ]
+            }
+          },
+          {
+            "name": "family",
+            "in": "query",
+            "description": "Filters by Webfont.family, using literal match. If not set, returns all families",
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "x-discovery-parameter": {
+              "description": "Filters by Webfont.family, using literal match. If not set, returns all families",
+              "type": "string",
+              "location": "query",
+              "repeated": true
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/WebfontList"
+                }
+              }
+            }
+          }
+        },
+        "x-discovery-parameterOrder": [],
+        "x-discovery-path": "v1/webfonts",
+        "x-discovery-parameters": {
+          "capability": {
+            "location": "query",
+            "repeated": true,
+            "enum": [
+              "CAPABILITY_UNSPECIFIED",
+              "WOFF2",
+              "VF",
+              "FAMILY_TAGS"
+            ],
+            "description": "Controls the font urls in `Webfont.files`, by default, static ttf fonts are sent.",
+            "type": "string",
+            "enumDescriptions": [
+              "Default means static ttf fonts.",
+              "Use WOFF2(Compressed)instead of ttf.",
+              "Prefer variable font files instead of static fonts instantiated at standard weights.",
+              "Include tags that apply to the entire family in the response."
+            ]
+          },
+          "category": {
+            "type": "string",
+            "description": "Filters by Webfont.category, if category is found in Webfont.categories. If not set, returns all families.",
+            "location": "query"
+          },
+          "subset": {
+            "description": "Filters by Webfont.subset, if subset is found in Webfont.subsets. If not set, returns all families.",
+            "type": "string",
+            "location": "query"
+          },
+          "sort": {
+            "type": "string",
+            "description": "Enables sorting of the list.",
+            "location": "query",
+            "enumDescriptions": [
+              "No sorting specified, use the default sorting method.",
+              "Sort alphabetically",
+              "Sort by date added",
+              "Sort by popularity",
+              "Sort by number of styles",
+              "Sort by trending"
+            ],
+            "enum": [
+              "SORT_UNDEFINED",
+              "ALPHA",
+              "DATE",
+              "POPULARITY",
+              "STYLE",
+              "TRENDING"
+            ]
+          },
+          "family": {
+            "description": "Filters by Webfont.family, using literal match. If not set, returns all families",
+            "type": "string",
+            "location": "query",
+            "repeated": true
+          }
+        },
+        "x-discovery-flatPath": "v1/webfonts"
+      }
+    }
+  }
+}

package/api/spec/sources.json

@@ -0,0 +1,6 @@
+{
+  "https://developers.google.com/fonts/docs/developer_api": {
+    "status": 200,
+    "checked": "2026-10-12"
+  }
+}

package/api/src/fetch.ts

@@ -0,0 +1,16 @@
+// 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 * as doors from './semantics/doors.ts';
+import { apiSemantics } from './semantics/index.ts';
+
+export function createApiLaneFetch(options: PackFetchOptions = {}): DerivedFetch {
+  return createPackFetch({
+    manifest,
+    surface: surface as DerivedSurface,
+    handlers: apiSemantics,
+    doors,
+  }, options);
+}

package/api/src/generated/surface.gen.json

@@ -0,0 +1 @@
+{"generatedBy":"scripts/derive-pack.ts","spec":"openapi.json","format":"openapi","version":"v1 rev 20260903","resources":[{"name":"Webfont","schema":"Webfont","fields":[{"name":"axes","type":"array","nullable":false},{"name":"category","type":"string","nullable":false},{"name":"colorCapabilities","type":"array","nullable":false},{"name":"family","type":"string","nullable":false},{"name":"files","type":"object","nullable":false},{"name":"kind","type":"string","nullable":false},{"name":"lastModified","type":"string","nullable":false},{"name":"menu","type":"string","nullable":false},{"name":"subsets","type":"array","nullable":false},{"name":"tags","type":"array","nullable":false},{"name":"variants","type":"array","nullable":false},{"name":"version","type":"string","nullable":false}],"stateCandidates":[],"expandable":[]}],"operations":[{"id":"webfonts.webfonts.list","method":"get","path":"/v1/webfonts","pathParams":[],"query":[{"name":"$.xgafv","type":"string","required":false},{"name":"access_token","type":"string","required":false},{"name":"alt","type":"string","required":false},{"name":"callback","type":"string","required":false},{"name":"capability","type":"array","required":false},{"name":"category","type":"string","required":false},{"name":"family","type":"array","required":false},{"name":"fields","type":"string","required":false},{"name":"key","type":"string","required":false},{"name":"oauth_token","type":"string","required":false},{"name":"prettyPrint","type":"boolean","required":false},{"name":"quotaUser","type":"string","required":false},{"name":"sort","type":"string","required":false},{"name":"subset","type":"string","required":false},{"name":"upload_protocol","type":"string","required":false},{"name":"uploadType","type":"string","required":false}],"body":[],"bodyEncoding":"none","successStatus":200,"answers":{"resource":"Webfont","list":true,"key":"items"},"class":"list","resource":"Webfont"}]}

package/api/src/generated/ui.gen.json

@@ -0,0 +1 @@
+{"generatedBy":"scripts/derive-pack.ts","resources":{"webfont":{"actions":[],"states":{},"embeds":{}},"_project":{"actions":[],"states":{},"embeds":{}},"_api_key":{"actions":[],"states":{},"embeds":{}}}}