@wippy-fe/types-global-proxy 0.0.41 → 0.0.43

package/index.d.ts

@@ -410,9 +410,61 @@ interface AppAuthConfig {
     token: string;
     expiresAt: string;
 }
+/** One @font-face source file for a `faces`-sourced font. */
+interface FontFaceDef {
+    /** Font file URL (woff2 preferred). */
+    url: string;
+    /** Format hint for the src descriptor, e.g. 'woff2'. */
+    format?: string;
+    /** font-weight descriptor — single ('600') or variable range ('100 900'). */
+    weight?: string;
+    /** font-style descriptor, e.g. 'italic'. */
+    style?: string;
+    unicodeRange?: string;
+}
+/**
+ * Declarative font loading + per-font metric control. Compiled host-side by
+ * `buildFontCss()` and folded into the distributed customCSS, so child iframes
+ * of any version apply it with no client-side support. @font-face is
+ * document-scoped: shadow-root content (web components) inherits usable
+ * families from its document automatically.
+ */
+interface FontConfig {
+    /** Family name, as later used by font-family / the role vars. */
+    family: string;
+    /**
+     * 'google' — load via the Google Fonts css2 API, keeping only `weights`;
+     * 'faces'  — declare @font-face rules from `faces` (required for the
+     *            metric-override descriptors below).
+     */
+    source: 'google' | 'faces';
+    /** For 'google': the weights to KEEP (all others are dropped from the request). */
+    weights?: number[];
+    /** For 'google': also request italics for the kept weights. */
+    italics?: boolean;
+    /** font-display for the css2 request / generated faces. Default 'swap'. */
+    display?: 'auto' | 'block' | 'swap' | 'fallback' | 'optional';
+    /** For 'faces': the font files to declare. */
+    faces?: FontFaceDef[];
+    /** 'faces' only — horizontal footprint: scales every glyph, e.g. '95%'. */
+    sizeAdjust?: string;
+    /** 'faces' only — vertical position of text within the line box, e.g. '90%'. */
+    ascentOverride?: string;
+    /** 'faces' only. */
+    descentOverride?: string;
+    /** 'faces' only. */
+    lineGapOverride?: string;
+    /**
+     * Assign the family to font roles: sets --p-font-<role>-family (and, for
+     * 'body', an applying rule — body text has no default token consumer).
+     */
+    roles?: Array<'heading' | 'body' | 'mono'>;
+}
 interface ThemingScope {
     cssVariables?: CssVariablesMap;
     customCSS?: string;
+    /** Declarative font loading; compiled into customCSS at distribution time. */
+    fonts?: FontConfig[];
     /** @deprecated Use `iconSets` instead */
     icons?: Record<string, IconDef>;
     /** Named icon collections. Each key is an Iconify prefix. */
@@ -424,6 +476,8 @@ interface HostThemingScope extends ThemingScope {
 interface ChildrenThemingScope {
     cssVariables?: CssVariablesMap;
     customCSS?: string;
+    /** Declarative font loading; compiled into customCSS at distribution time. */
+    fonts?: FontConfig[];
 }
 interface AppCustomization {
     customCSS?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wippy-fe/types-global-proxy",
-  "version": "0.0.41",
+  "version": "0.0.43",
   "description": "Global type declarations for Wippy iframe proxy (window.getWippyApi, $W, etc.)",
   "license": "UNLICENSED",
   "types": "index.d.ts",