@aglyn/shared-ui-theme 1.0.0-beta.230 → 1.0.0-beta.231

package/src/lib/tenant.theme.js

@@ -14,13 +14,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ import { _ as _extends } from "@swc/helpers/_/_extends";
-var // Dot notation, not brackets: Next substitutes `process.env.NAME`
-// TEXTUALLY, and never the bracket form, so a bracket read is `undefined`
-// in any browser or edge bundle and silently falls back to the default
-// below — which on a self-host install would hand the operator Aglyn's
-// hosts (AGL-2037).
-_process_env_NEXT_PUBLIC_PLATFORM_BRAND_HOSTS;
 import { consoleOptions, consoleOptionsDark, consoleThemeDark, consoleThemeLight } from "./console.theme.js";
+import { TENANT_SYSTEM_FONT_STACK, wearsPlatformBrand } from "./platform-brand.js";
 import createResponsiveTheme from "./util/create-responsive-theme.js";
 /**
  * The default palette a tenant site wears when it has authored none of its
@@ -199,12 +194,18 @@ const tenantColorScheme = {
         }
     }
 };
+// A site serves no Roboto Flex, so its default stack names none (AGL-3656).
+const tenantTypography = (base)=>_extends({}, base.typography, {
+        fontFamily: TENANT_SYSTEM_FONT_STACK
+    });
 export const tenantOptions = _extends({}, consoleOptions, {
+    typography: tenantTypography(consoleOptions),
     palette: _extends({
         mode: 'light'
     }, tenantColorScheme.light)
 });
 export const tenantOptionsDark = _extends({}, consoleOptionsDark, {
+    typography: tenantTypography(consoleOptionsDark),
     palette: _extends({
         mode: 'dark'
     }, tenantColorScheme.dark)
@@ -215,30 +216,7 @@ export const tenantThemeLight = createResponsiveTheme({
 export const tenantThemeDark = createResponsiveTheme({
     themeOptions: _extends({}, tenantOptionsDark)
 });
-/**
- * Hosts whose brand IS the operator's own brand, and which therefore keep
- * `consoleOptions` rather than the tenant default.
- *
- * Comma-separated in `NEXT_PUBLIC_PLATFORM_BRAND_HOSTS`, so a self-host
- * operator points it at their own marketing domain and their customers still
- * resolve the neutral tenant palette. The literal is the `??` default and
- * nothing else reads it: the platform's own deployment needs no variable to
- * keep its brand. Setting the variable to an empty string puts every host,
- * including the operator's own, on the tenant default.
- *
- * Matched on the registrable domain, after stripping the `cname--` prefix the
- * tenant middleware puts on a CUSTOM DOMAIN before it becomes the `[host]`
- * route segment: the param this is handed reads `cname--example.com`, never
- * the bare apex. A platform subdomain resolves to a bare label instead
- * (`acme` for `acme.aglyn.app`), which correctly matches nothing — a customer
- * on a platform subdomain is still a tenant.
- */ const CNAME_PREFIX = 'cname--';
-export const PLATFORM_BRAND_HOSTS = new Set(((_process_env_NEXT_PUBLIC_PLATFORM_BRAND_HOSTS = process.env.NEXT_PUBLIC_PLATFORM_BRAND_HOSTS) != null ? _process_env_NEXT_PUBLIC_PLATFORM_BRAND_HOSTS : 'aglyn.com,aglyn.io').split(',').map((host)=>host.trim().toLowerCase()).filter(Boolean));
-export function wearsPlatformBrand(host) {
-    if (!host) return false;
-    const normalized = host.trim().toLowerCase();
-    return PLATFORM_BRAND_HOSTS.has(normalized.startsWith(CNAME_PREFIX) ? normalized.slice(CNAME_PREFIX.length) : normalized);
-}
+export { PLATFORM_BRAND_HOSTS, wearsPlatformBrand } from "./platform-brand.js";
 /**
  * The site key {@link wearsPlatformBrand} is asked about, read off a host
  * document (AGL-3068).

package/src/lib/tenant.theme.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/shared/ui/theme/src/lib/tenant.theme.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport type { PaletteOptions, Theme, ThemeOptions } from '../vendor/mui'\nimport {\n  consoleOptions,\n  consoleOptionsDark,\n  consoleThemeDark,\n  consoleThemeLight,\n} from './console.theme'\nimport createResponsiveTheme from './util/create-responsive-theme'\n\n/**\n * The default palette a tenant site wears when it has authored none of its\n * own.\n *\n * MUI's stock accents, extended with every slot this platform adds on top of\n * a MUI palette — `tertiary`, `surface`, `tint`, `inputOutline` and the three\n * `svg*` records — so a site that never opens the theme editor still resolves\n * every token a component can ask for.\n *\n * Stock rather than the Aglyn brand because the brand palette carries a\n * signed-off sub-AA pairing (white on `#00b0ff`, 2.43:1): a considered\n * decision about OUR brand, and not one to hand a customer who never made it.\n * Every accent here clears the 4.5:1 AA text bar as text and carries its own\n * `contrastText` at AA on the fill, in both schemes.\n *\n * Non-palette options come from `consoleOptions`, so component behaviour,\n * type ramp, spacing and shadows are identical platform-wide — the palette is\n * the only thing a tenant default changes.\n */\n/**\n * The one grey ramp, read from the brand palette rather than copied. A\n * neutral scale is not a brand decision, and a second copy is a second thing\n * to drift.\n */\nconst grey = (consoleOptions.palette as { grey: PaletteOptions['grey'] }).grey\n\nconst tenantColorScheme = {\n  light: {\n    primary: {\n      main: '#1976d2',\n      // The accent-as-text shade (`ACCENT_TEXT_SHADE`): 7.50:1 on the page,\n      // 7.82:1 on paper. Authored for the same reason as the console's — the\n      // slot every link resolves to belongs in the palette, not in a walk.\n      dark: '#125393',\n      contrastText: '#FFFFFF',\n    },\n    secondary: {\n      main: '#9c27b0',\n      dark: '#6d1b7b',\n      contrastText: '#FFFFFF',\n    },\n    // A neutral slate for the third accent, matching the role `tertiary`\n    // plays in the console palette.\n    tertiary: {\n      main: '#4a5568',\n      dark: '#343b49',\n      contrastText: '#FFFFFF',\n    },\n    surface: {\n      main: '#f1f3f5',\n      contrastText: '#000000DE',\n    },\n    tint: {\n      primary: '#e8f1fb',\n      secondary: '#f5e9f7',\n      tertiary: '#eef0f3',\n    },\n    inputOutline: 'rgba(0, 0, 0, 0.23)',\n    background: {\n      default: '#fafafa',\n      paper: '#ffffff',\n    },\n    info: {\n      main: '#0288d1',\n      dark: '#015f92',\n      contrastText: '#000000DE',\n    },\n    error: {\n      main: '#d32f2f',\n      dark: '#942121',\n      contrastText: '#FFFFFF',\n    },\n    success: {\n      main: '#2e7d32',\n      dark: '#205823',\n      contrastText: '#FFFFFF',\n    },\n    warning: {\n      main: '#ed6c02',\n      dark: '#a64c01',\n      contrastText: '#000000DE',\n    },\n    grey,\n    svgBackground: {\n      main: '#FAFAFA',\n      hover: '#FAFAFA',\n      active: '#FAFAFA',\n      focus: '#FAFAFA',\n    },\n    svgFilled: {\n      main: '#9E9E9E',\n      hover: '#1976d2',\n      active: '#1976d2',\n      focus: '#1976d2',\n    },\n    svgStroke: {\n      main: '#FFFFFF',\n      hover: '#FFFFFF',\n      active: '#FFFFFF',\n      focus: '#FFFFFF',\n    },\n  },\n  dark: {\n    primary: {\n      main: '#1976d2',\n      // LIGHTER than `main`, as every accent-as-text shade must be on a dark\n      // ground: 6.70:1 on the page, 5.96:1 on paper. MUI derives `dark` by\n      // darkening in both schemes, which points the wrong way here.\n      dark: '#5e9fe0',\n      contrastText: '#FFFFFF',\n    },\n    secondary: {\n      main: '#9c27b0',\n      dark: '#ba68c8',\n      contrastText: '#FFFFFF',\n    },\n    // Lifted from the light scheme's slate: `#4a5568` is 1.9:1 against this\n    // page and would be a third accent nobody can read.\n    tertiary: {\n      main: '#94a3b8',\n      dark: '#b4bfcd',\n      contrastText: '#000000DE',\n    },\n    surface: {\n      main: '#242c35',\n      contrastText: '#FFFFFF',\n    },\n    // Tile fills, held around 1.5:1 from the page so a tinted tile has a\n    // visible edge without a border.\n    tint: {\n      primary: '#1e3a5c',\n      secondary: '#472653',\n      tertiary: '#2e3742',\n    },\n    inputOutline: 'rgba(255, 255, 255, 0.23)',\n    background: {\n      default: '#121212',\n      paper: '#1e1e1e',\n    },\n    info: {\n      main: '#0288d1',\n      dark: '#4eacdf',\n      contrastText: '#000000DE',\n    },\n    error: {\n      main: '#d32f2f',\n      dark: '#e06d6d',\n      contrastText: '#FFFFFF',\n    },\n    success: {\n      main: '#2e7d32',\n      dark: '#6da470',\n      contrastText: '#FFFFFF',\n    },\n    warning: {\n      main: '#ed6c02',\n      dark: '#f2984e',\n      contrastText: '#000000DE',\n    },\n    grey,\n    svgBackground: {\n      main: '#242c35',\n      hover: '#242c35',\n      active: '#242c35',\n      focus: '#242c35',\n    },\n    svgFilled: {\n      main: '#9E9E9E',\n      hover: '#5e9fe0',\n      active: '#5e9fe0',\n      focus: '#5e9fe0',\n    },\n    svgStroke: {\n      main: '#FFFFFF',\n      hover: '#FFFFFF',\n      active: '#FFFFFF',\n      focus: '#FFFFFF',\n    },\n  },\n}\n\nexport const tenantOptions: ThemeOptions = {\n  ...consoleOptions,\n  palette: {\n    mode: 'light',\n    ...tenantColorScheme.light,\n  },\n}\nexport const tenantOptionsDark: ThemeOptions = {\n  ...consoleOptionsDark,\n  palette: {\n    mode: 'dark',\n    ...tenantColorScheme.dark,\n  },\n}\n\nexport const tenantThemeLight: Theme = createResponsiveTheme({\n  themeOptions: { ...tenantOptions },\n})\nexport const tenantThemeDark: Theme = createResponsiveTheme({\n  themeOptions: { ...tenantOptionsDark },\n})\n\n/**\n * Hosts whose brand IS the operator's own brand, and which therefore keep\n * `consoleOptions` rather than the tenant default.\n *\n * Comma-separated in `NEXT_PUBLIC_PLATFORM_BRAND_HOSTS`, so a self-host\n * operator points it at their own marketing domain and their customers still\n * resolve the neutral tenant palette. The literal is the `??` default and\n * nothing else reads it: the platform's own deployment needs no variable to\n * keep its brand. Setting the variable to an empty string puts every host,\n * including the operator's own, on the tenant default.\n *\n * Matched on the registrable domain, after stripping the `cname--` prefix the\n * tenant middleware puts on a CUSTOM DOMAIN before it becomes the `[host]`\n * route segment: the param this is handed reads `cname--example.com`, never\n * the bare apex. A platform subdomain resolves to a bare label instead\n * (`acme` for `acme.aglyn.app`), which correctly matches nothing — a customer\n * on a platform subdomain is still a tenant.\n */\nconst CNAME_PREFIX = 'cname--'\n\nexport const PLATFORM_BRAND_HOSTS: ReadonlySet<string> = new Set(\n  // Dot notation, not brackets: Next substitutes `process.env.NAME`\n  // TEXTUALLY, and never the bracket form, so a bracket read is `undefined`\n  // in any browser or edge bundle and silently falls back to the default\n  // below — which on a self-host install would hand the operator Aglyn's\n  // hosts (AGL-2037).\n  (process.env.NEXT_PUBLIC_PLATFORM_BRAND_HOSTS ?? 'aglyn.com,aglyn.io')\n    .split(',')\n    .map((host) => host.trim().toLowerCase())\n    .filter(Boolean),\n)\n\nexport function wearsPlatformBrand(host: string | undefined): boolean {\n  if (!host) return false\n  const normalized = host.trim().toLowerCase()\n  return PLATFORM_BRAND_HOSTS.has(\n    normalized.startsWith(CNAME_PREFIX)\n      ? normalized.slice(CNAME_PREFIX.length)\n      : normalized,\n  )\n}\n\n/**\n * The site key {@link wearsPlatformBrand} is asked about, read off a host\n * document (AGL-3068).\n *\n * The tenant is handed its `[host]` route param, which is the attached domain\n * under the middleware's `cname--` sentinel or a bare subdomain label. A\n * console surface has the document instead, where those are two fields: the\n * attached domain is what a platform-brand host is listed under, and the\n * subdomain is what every other site is reachable by. Reading them in that\n * order is what makes the editor ask the same question the published page\n * answers.\n */\nexport function hostBrandKey(\n  host: { cname?: string; subdomain?: string } | null | undefined,\n): string | undefined {\n  return host?.cname || host?.subdomain || undefined\n}\n\n/**\n * The options a site's own theme is layered onto: the platform's brand for\n * the operator's own hosts, the neutral tenant default for everyone else\n * (AGL-3068).\n *\n * One decision, because it used to be four. The tenant made it per host,\n * while the besigner canvas, the theme editor's preview and the \"Default ·\n * #…\" the editor prints beside every unset slot all built on the brand base\n * unconditionally — so a customer site was authored in Aglyn's cyan and\n * published in MUI's blue, and an author correcting contrast was correcting a\n * page that does not exist.\n *\n * An unknown host is NOT a platform host, exactly as `wearsPlatformBrand`\n * already reads it: the operator's hosts are the named exception, so a\n * surface that cannot name the site resolves what a customer site resolves.\n */\nexport function siteBaseOptions(\n  host: string | undefined,\n  scheme: 'light' | 'dark',\n): ThemeOptions {\n  const brand = wearsPlatformBrand(host)\n  if (scheme === 'dark') return brand ? consoleOptionsDark : tenantOptionsDark\n  return brand ? consoleOptions : tenantOptions\n}\n\n/** The built theme a site with no customization of its own renders under. */\nexport function siteFallbackTheme(\n  host: string | undefined,\n  scheme: 'light' | 'dark',\n): Theme {\n  const brand = wearsPlatformBrand(host)\n  if (scheme === 'dark') return brand ? consoleThemeDark : tenantThemeDark\n  return brand ? consoleThemeLight : tenantThemeLight\n}\n"],"names":["process","consoleOptions","consoleOptionsDark","consoleThemeDark","consoleThemeLight","createResponsiveTheme","grey","palette","tenantColorScheme","light","primary","main","dark","contrastText","secondary","tertiary","surface","tint","inputOutline","background","default","paper","info","error","success","warning","svgBackground","hover","active","focus","svgFilled","svgStroke","tenantOptions","mode","tenantOptionsDark","tenantThemeLight","themeOptions","tenantThemeDark","CNAME_PREFIX","PLATFORM_BRAND_HOSTS","Set","env","NEXT_PUBLIC_PLATFORM_BRAND_HOSTS","split","map","host","trim","toLowerCase","filter","Boolean","wearsPlatformBrand","normalized","has","startsWith","slice","length","hostBrandKey","cname","subdomain","undefined","siteBaseOptions","scheme","brand","siteFallbackTheme"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/shared/ui/theme/src/lib/tenant.theme.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport type { PaletteOptions, Theme, ThemeOptions } from '../vendor/mui'\nimport {\n  consoleOptions,\n  consoleOptionsDark,\n  consoleThemeDark,\n  consoleThemeLight,\n} from './console.theme'\nimport { TENANT_SYSTEM_FONT_STACK, wearsPlatformBrand } from './platform-brand'\nimport createResponsiveTheme from './util/create-responsive-theme'\n\n/**\n * The default palette a tenant site wears when it has authored none of its\n * own.\n *\n * MUI's stock accents, extended with every slot this platform adds on top of\n * a MUI palette — `tertiary`, `surface`, `tint`, `inputOutline` and the three\n * `svg*` records — so a site that never opens the theme editor still resolves\n * every token a component can ask for.\n *\n * Stock rather than the Aglyn brand because the brand palette carries a\n * signed-off sub-AA pairing (white on `#00b0ff`, 2.43:1): a considered\n * decision about OUR brand, and not one to hand a customer who never made it.\n * Every accent here clears the 4.5:1 AA text bar as text and carries its own\n * `contrastText` at AA on the fill, in both schemes.\n *\n * Non-palette options come from `consoleOptions`, so component behaviour,\n * type ramp, spacing and shadows are identical platform-wide — the palette is\n * the only thing a tenant default changes.\n */\n/**\n * The one grey ramp, read from the brand palette rather than copied. A\n * neutral scale is not a brand decision, and a second copy is a second thing\n * to drift.\n */\nconst grey = (consoleOptions.palette as { grey: PaletteOptions['grey'] }).grey\n\nconst tenantColorScheme = {\n  light: {\n    primary: {\n      main: '#1976d2',\n      // The accent-as-text shade (`ACCENT_TEXT_SHADE`): 7.50:1 on the page,\n      // 7.82:1 on paper. Authored for the same reason as the console's — the\n      // slot every link resolves to belongs in the palette, not in a walk.\n      dark: '#125393',\n      contrastText: '#FFFFFF',\n    },\n    secondary: {\n      main: '#9c27b0',\n      dark: '#6d1b7b',\n      contrastText: '#FFFFFF',\n    },\n    // A neutral slate for the third accent, matching the role `tertiary`\n    // plays in the console palette.\n    tertiary: {\n      main: '#4a5568',\n      dark: '#343b49',\n      contrastText: '#FFFFFF',\n    },\n    surface: {\n      main: '#f1f3f5',\n      contrastText: '#000000DE',\n    },\n    tint: {\n      primary: '#e8f1fb',\n      secondary: '#f5e9f7',\n      tertiary: '#eef0f3',\n    },\n    inputOutline: 'rgba(0, 0, 0, 0.23)',\n    background: {\n      default: '#fafafa',\n      paper: '#ffffff',\n    },\n    info: {\n      main: '#0288d1',\n      dark: '#015f92',\n      contrastText: '#000000DE',\n    },\n    error: {\n      main: '#d32f2f',\n      dark: '#942121',\n      contrastText: '#FFFFFF',\n    },\n    success: {\n      main: '#2e7d32',\n      dark: '#205823',\n      contrastText: '#FFFFFF',\n    },\n    warning: {\n      main: '#ed6c02',\n      dark: '#a64c01',\n      contrastText: '#000000DE',\n    },\n    grey,\n    svgBackground: {\n      main: '#FAFAFA',\n      hover: '#FAFAFA',\n      active: '#FAFAFA',\n      focus: '#FAFAFA',\n    },\n    svgFilled: {\n      main: '#9E9E9E',\n      hover: '#1976d2',\n      active: '#1976d2',\n      focus: '#1976d2',\n    },\n    svgStroke: {\n      main: '#FFFFFF',\n      hover: '#FFFFFF',\n      active: '#FFFFFF',\n      focus: '#FFFFFF',\n    },\n  },\n  dark: {\n    primary: {\n      main: '#1976d2',\n      // LIGHTER than `main`, as every accent-as-text shade must be on a dark\n      // ground: 6.70:1 on the page, 5.96:1 on paper. MUI derives `dark` by\n      // darkening in both schemes, which points the wrong way here.\n      dark: '#5e9fe0',\n      contrastText: '#FFFFFF',\n    },\n    secondary: {\n      main: '#9c27b0',\n      dark: '#ba68c8',\n      contrastText: '#FFFFFF',\n    },\n    // Lifted from the light scheme's slate: `#4a5568` is 1.9:1 against this\n    // page and would be a third accent nobody can read.\n    tertiary: {\n      main: '#94a3b8',\n      dark: '#b4bfcd',\n      contrastText: '#000000DE',\n    },\n    surface: {\n      main: '#242c35',\n      contrastText: '#FFFFFF',\n    },\n    // Tile fills, held around 1.5:1 from the page so a tinted tile has a\n    // visible edge without a border.\n    tint: {\n      primary: '#1e3a5c',\n      secondary: '#472653',\n      tertiary: '#2e3742',\n    },\n    inputOutline: 'rgba(255, 255, 255, 0.23)',\n    background: {\n      default: '#121212',\n      paper: '#1e1e1e',\n    },\n    info: {\n      main: '#0288d1',\n      dark: '#4eacdf',\n      contrastText: '#000000DE',\n    },\n    error: {\n      main: '#d32f2f',\n      dark: '#e06d6d',\n      contrastText: '#FFFFFF',\n    },\n    success: {\n      main: '#2e7d32',\n      dark: '#6da470',\n      contrastText: '#FFFFFF',\n    },\n    warning: {\n      main: '#ed6c02',\n      dark: '#f2984e',\n      contrastText: '#000000DE',\n    },\n    grey,\n    svgBackground: {\n      main: '#242c35',\n      hover: '#242c35',\n      active: '#242c35',\n      focus: '#242c35',\n    },\n    svgFilled: {\n      main: '#9E9E9E',\n      hover: '#5e9fe0',\n      active: '#5e9fe0',\n      focus: '#5e9fe0',\n    },\n    svgStroke: {\n      main: '#FFFFFF',\n      hover: '#FFFFFF',\n      active: '#FFFFFF',\n      focus: '#FFFFFF',\n    },\n  },\n}\n\n// A site serves no Roboto Flex, so its default stack names none (AGL-3656).\nconst tenantTypography = (base: ThemeOptions): ThemeOptions['typography'] => ({\n  ...(base.typography as object),\n  fontFamily: TENANT_SYSTEM_FONT_STACK,\n})\n\nexport const tenantOptions: ThemeOptions = {\n  ...consoleOptions,\n  typography: tenantTypography(consoleOptions),\n  palette: {\n    mode: 'light',\n    ...tenantColorScheme.light,\n  },\n}\nexport const tenantOptionsDark: ThemeOptions = {\n  ...consoleOptionsDark,\n  typography: tenantTypography(consoleOptionsDark),\n  palette: {\n    mode: 'dark',\n    ...tenantColorScheme.dark,\n  },\n}\n\nexport const tenantThemeLight: Theme = createResponsiveTheme({\n  themeOptions: { ...tenantOptions },\n})\nexport const tenantThemeDark: Theme = createResponsiveTheme({\n  themeOptions: { ...tenantOptionsDark },\n})\n\nexport { PLATFORM_BRAND_HOSTS, wearsPlatformBrand } from './platform-brand'\n\n/**\n * The site key {@link wearsPlatformBrand} is asked about, read off a host\n * document (AGL-3068).\n *\n * The tenant is handed its `[host]` route param, which is the attached domain\n * under the middleware's `cname--` sentinel or a bare subdomain label. A\n * console surface has the document instead, where those are two fields: the\n * attached domain is what a platform-brand host is listed under, and the\n * subdomain is what every other site is reachable by. Reading them in that\n * order is what makes the editor ask the same question the published page\n * answers.\n */\nexport function hostBrandKey(\n  host: { cname?: string; subdomain?: string } | null | undefined,\n): string | undefined {\n  return host?.cname || host?.subdomain || undefined\n}\n\n/**\n * The options a site's own theme is layered onto: the platform's brand for\n * the operator's own hosts, the neutral tenant default for everyone else\n * (AGL-3068).\n *\n * One decision, because it used to be four. The tenant made it per host,\n * while the besigner canvas, the theme editor's preview and the \"Default ·\n * #…\" the editor prints beside every unset slot all built on the brand base\n * unconditionally — so a customer site was authored in Aglyn's cyan and\n * published in MUI's blue, and an author correcting contrast was correcting a\n * page that does not exist.\n *\n * An unknown host is NOT a platform host, exactly as `wearsPlatformBrand`\n * already reads it: the operator's hosts are the named exception, so a\n * surface that cannot name the site resolves what a customer site resolves.\n */\nexport function siteBaseOptions(\n  host: string | undefined,\n  scheme: 'light' | 'dark',\n): ThemeOptions {\n  const brand = wearsPlatformBrand(host)\n  if (scheme === 'dark') return brand ? consoleOptionsDark : tenantOptionsDark\n  return brand ? consoleOptions : tenantOptions\n}\n\n/** The built theme a site with no customization of its own renders under. */\nexport function siteFallbackTheme(\n  host: string | undefined,\n  scheme: 'light' | 'dark',\n): Theme {\n  const brand = wearsPlatformBrand(host)\n  if (scheme === 'dark') return brand ? consoleThemeDark : tenantThemeDark\n  return brand ? consoleThemeLight : tenantThemeLight\n}\n"],"names":["consoleOptions","consoleOptionsDark","consoleThemeDark","consoleThemeLight","TENANT_SYSTEM_FONT_STACK","wearsPlatformBrand","createResponsiveTheme","grey","palette","tenantColorScheme","light","primary","main","dark","contrastText","secondary","tertiary","surface","tint","inputOutline","background","default","paper","info","error","success","warning","svgBackground","hover","active","focus","svgFilled","svgStroke","tenantTypography","base","typography","fontFamily","tenantOptions","mode","tenantOptionsDark","tenantThemeLight","themeOptions","tenantThemeDark","PLATFORM_BRAND_HOSTS","hostBrandKey","host","cname","subdomain","undefined","siteBaseOptions","scheme","brand","siteFallbackTheme"],"mappings":"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"}

package/src/lib/util/font-stack.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { HostThemeFont } from '@aglyn/shared-data-types';
+/** The name a family's metric-matched fallback face is declared under. */
+export declare function metricFallbackFamily(family: string): string;
+/** The families in a CSS `font-family` stack, unquoted. */
+export declare function stackFamilies(stack: string): string[];
+/**
+ * A stack with each loaded family's fallback named right after it, once:
+ * `"Inter", system-ui` → `"Inter", "Inter Fallback", system-ui`. Where no
+ * page declares the fallback (the editor), the name matches nothing.
+ */
+export declare function withMetricFallbacks(stack: string, families: readonly string[]): string;
+/** The families a theme loads as web fonts: Google families and uploads. */
+export declare function themeWebFontFamilies(fonts: readonly HostThemeFont[] | undefined): string[];
+/**
+ * A theme with each web font's fallback named in its stacks, for the page
+ * that declares the fallbacks. `baseStack` and `baseFonts` stand in for a
+ * theme that names no face of its own but whose base loads one (the brand's
+ * on an operator host). Done on the server, so no browser bundle carries it.
+ */
+export declare function withThemeMetricFallbacks<T extends {
+    fonts?: readonly HostThemeFont[];
+    typography?: {
+        fontFamily?: string;
+        variants?: Record<string, {
+            fontFamily?: string;
+        } | undefined>;
+    };
+}>(theme: T | undefined, baseStack?: string, baseFonts?: readonly HostThemeFont[]): T | undefined;

package/src/lib/util/font-stack.js

@@ -0,0 +1,79 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+// The browser half of the font loader (AGL-3656), kept apart from
+// `self-hosted-fonts.ts` because every published page loads it.
+/** The name a family's metric-matched fallback face is declared under. */ export function metricFallbackFamily(family) {
+    return `${family.replace(/['"\\\n\r]/g, '').trim()} Fallback`;
+}
+/** The families in a CSS `font-family` stack, unquoted. */ export function stackFamilies(stack) {
+    return stack.split(',').map((entry)=>entry.trim().replace(/^['"]|['"]$/g, '').trim()).filter(Boolean);
+}
+/**
+ * A stack with each loaded family's fallback named right after it, once:
+ * `"Inter", system-ui` → `"Inter", "Inter Fallback", system-ui`. Where no
+ * page declares the fallback (the editor), the name matches nothing.
+ */ export function withMetricFallbacks(stack, families) {
+    if (!families.length) return stack;
+    const loaded = new Set(families.map((family)=>family.toLowerCase()));
+    const present = new Set(stackFamilies(stack).map((family)=>family.toLowerCase()));
+    const out = [];
+    for (const part of stack.split(',')){
+        out.push(part);
+        const name = part.trim().replace(/^['"]|['"]$/g, '').trim();
+        const fallback = metricFallbackFamily(name);
+        if (loaded.has(name.toLowerCase()) && !present.has(fallback.toLowerCase())) {
+            out.push(` "${fallback}"`);
+        }
+    }
+    return out.join(',');
+}
+/** The families a theme loads as web fonts: Google families and uploads. */ export function themeWebFontFamilies(fonts) {
+    return (fonts != null ? fonts : []).filter((font)=>{
+        var _font_source;
+        return font.family && ((_font_source = font.source) != null ? _font_source : 'google') !== 'system';
+    }).map((font)=>font.family.trim());
+}
+/**
+ * A theme with each web font's fallback named in its stacks, for the page
+ * that declares the fallbacks. `baseStack` and `baseFonts` stand in for a
+ * theme that names no face of its own but whose base loads one (the brand's
+ * on an operator host). Done on the server, so no browser bundle carries it.
+ */ export function withThemeMetricFallbacks(theme, baseStack, baseFonts = []) {
+    var _ref, _ref1;
+    const families = themeWebFontFamilies([
+        ...(_ref = theme == null ? void 0 : theme.fonts) != null ? _ref : [],
+        ...baseFonts
+    ]);
+    if (!families.length) return theme;
+    const typography = theme == null ? void 0 : theme.typography;
+    const stack = (_ref1 = typography == null ? void 0 : typography.fontFamily) != null ? _ref1 : baseFonts.length ? baseStack : undefined;
+    const variants = (typography == null ? void 0 : typography.variants) ? Object.fromEntries(Object.entries(typography.variants).map(([key, variant])=>[
+            key,
+            (variant == null ? void 0 : variant.fontFamily) ? _extends({}, variant, {
+                fontFamily: withMetricFallbacks(variant.fontFamily, families)
+            }) : variant
+        ])) : undefined;
+    return _extends({}, theme, {
+        typography: _extends({}, typography, stack ? {
+            fontFamily: withMetricFallbacks(stack, families)
+        } : {}, variants ? {
+            variants
+        } : {})
+    });
+}
+
+//# sourceMappingURL=font-stack.js.map

package/src/lib/util/font-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/ui/theme/src/lib/util/font-stack.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { HostThemeFont } from '@aglyn/shared-data-types'\n\n// The browser half of the font loader (AGL-3656), kept apart from\n// `self-hosted-fonts.ts` because every published page loads it.\n\n/** The name a family's metric-matched fallback face is declared under. */\nexport function metricFallbackFamily(family: string): string {\n  return `${family.replace(/['\"\\\\\\n\\r]/g, '').trim()} Fallback`\n}\n\n/** The families in a CSS `font-family` stack, unquoted. */\nexport function stackFamilies(stack: string): string[] {\n  return stack\n    .split(',')\n    .map((entry) => entry.trim().replace(/^['\"]|['\"]$/g, '').trim())\n    .filter(Boolean)\n}\n\n/**\n * A stack with each loaded family's fallback named right after it, once:\n * `\"Inter\", system-ui` → `\"Inter\", \"Inter Fallback\", system-ui`. Where no\n * page declares the fallback (the editor), the name matches nothing.\n */\nexport function withMetricFallbacks(stack: string, families: readonly string[]): string {\n  if (!families.length) return stack\n  const loaded = new Set(families.map((family) => family.toLowerCase()))\n  const present = new Set(stackFamilies(stack).map((family) => family.toLowerCase()))\n  const out: string[] = []\n  for (const part of stack.split(',')) {\n    out.push(part)\n    const name = part.trim().replace(/^['\"]|['\"]$/g, '').trim()\n    const fallback = metricFallbackFamily(name)\n    if (loaded.has(name.toLowerCase()) && !present.has(fallback.toLowerCase())) {\n      out.push(` \"${fallback}\"`)\n    }\n  }\n  return out.join(',')\n}\n\n/** The families a theme loads as web fonts: Google families and uploads. */\nexport function themeWebFontFamilies(fonts: readonly HostThemeFont[] | undefined): string[] {\n  return (fonts ?? [])\n    .filter((font) => font.family && (font.source ?? 'google') !== 'system')\n    .map((font) => font.family.trim())\n}\n\n/**\n * A theme with each web font's fallback named in its stacks, for the page\n * that declares the fallbacks. `baseStack` and `baseFonts` stand in for a\n * theme that names no face of its own but whose base loads one (the brand's\n * on an operator host). Done on the server, so no browser bundle carries it.\n */\nexport function withThemeMetricFallbacks<\n  T extends {\n    fonts?: readonly HostThemeFont[]\n    typography?: { fontFamily?: string; variants?: Record<string, { fontFamily?: string } | undefined> }\n  },\n>(theme: T | undefined, baseStack?: string, baseFonts: readonly HostThemeFont[] = []): T | undefined {\n  const families = themeWebFontFamilies([...(theme?.fonts ?? []), ...baseFonts])\n  if (!families.length) return theme\n  const typography = theme?.typography\n  const stack = typography?.fontFamily ?? (baseFonts.length ? baseStack : undefined)\n  const variants = typography?.variants\n    ? Object.fromEntries(\n        Object.entries(typography.variants).map(([key, variant]) => [\n          key,\n          variant?.fontFamily\n            ? { ...variant, fontFamily: withMetricFallbacks(variant.fontFamily, families) }\n            : variant,\n        ]),\n      )\n    : undefined\n  return {\n    ...(theme as T),\n    typography: {\n      ...typography,\n      ...(stack ? { fontFamily: withMetricFallbacks(stack, families) } : {}),\n      ...(variants ? { variants } : {}),\n    },\n  }\n}\n"],"names":["metricFallbackFamily","family","replace","trim","stackFamilies","stack","split","map","entry","filter","Boolean","withMetricFallbacks","families","length","loaded","Set","toLowerCase","present","out","part","push","name","fallback","has","join","themeWebFontFamilies","fonts","font","source","withThemeMetricFallbacks","theme","baseStack","baseFonts","typography","fontFamily","undefined","variants","Object","fromEntries","entries","key","variant"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAID,kEAAkE;AAClE,gEAAgE;AAEhE,wEAAwE,GACxE,OAAO,SAASA,qBAAqBC,MAAc;IACjD,OAAO,GAAGA,OAAOC,OAAO,CAAC,eAAe,IAAIC,IAAI,GAAG,SAAS,CAAC;AAC/D;AAEA,yDAAyD,GACzD,OAAO,SAASC,cAAcC,KAAa;IACzC,OAAOA,MACJC,KAAK,CAAC,KACNC,GAAG,CAAC,CAACC,QAAUA,MAAML,IAAI,GAAGD,OAAO,CAAC,gBAAgB,IAAIC,IAAI,IAC5DM,MAAM,CAACC;AACZ;AAEA;;;;CAIC,GACD,OAAO,SAASC,oBAAoBN,KAAa,EAAEO,QAA2B;IAC5E,IAAI,CAACA,SAASC,MAAM,EAAE,OAAOR;IAC7B,MAAMS,SAAS,IAAIC,IAAIH,SAASL,GAAG,CAAC,CAACN,SAAWA,OAAOe,WAAW;IAClE,MAAMC,UAAU,IAAIF,IAAIX,cAAcC,OAAOE,GAAG,CAAC,CAACN,SAAWA,OAAOe,WAAW;IAC/E,MAAME,MAAgB,EAAE;IACxB,KAAK,MAAMC,QAAQd,MAAMC,KAAK,CAAC,KAAM;QACnCY,IAAIE,IAAI,CAACD;QACT,MAAME,OAAOF,KAAKhB,IAAI,GAAGD,OAAO,CAAC,gBAAgB,IAAIC,IAAI;QACzD,MAAMmB,WAAWtB,qBAAqBqB;QACtC,IAAIP,OAAOS,GAAG,CAACF,KAAKL,WAAW,OAAO,CAACC,QAAQM,GAAG,CAACD,SAASN,WAAW,KAAK;YAC1EE,IAAIE,IAAI,CAAC,CAAC,EAAE,EAAEE,SAAS,CAAC,CAAC;QAC3B;IACF;IACA,OAAOJ,IAAIM,IAAI,CAAC;AAClB;AAEA,0EAA0E,GAC1E,OAAO,SAASC,qBAAqBC,KAA2C;IAC9E,OAAO,CAACA,gBAAAA,QAAS,EAAE,EAChBjB,MAAM,CAAC,CAACkB;YAAyBA;eAAhBA,KAAK1B,MAAM,IAAI,EAAC0B,eAAAA,KAAKC,MAAM,YAAXD,eAAe,cAAc;OAC9DpB,GAAG,CAAC,CAACoB,OAASA,KAAK1B,MAAM,CAACE,IAAI;AACnC;AAEA;;;;;CAKC,GACD,OAAO,SAAS0B,yBAKdC,KAAoB,EAAEC,SAAkB,EAAEC,YAAsC,EAAE;;IAClF,MAAMpB,WAAWa,qBAAqB;mBAAKK,yBAAAA,MAAOJ,KAAK,mBAAI,EAAE;WAAMM;KAAU;IAC7E,IAAI,CAACpB,SAASC,MAAM,EAAE,OAAOiB;IAC7B,MAAMG,aAAaH,yBAAAA,MAAOG,UAAU;IACpC,MAAM5B,iBAAQ4B,8BAAAA,WAAYC,UAAU,oBAAKF,UAAUnB,MAAM,GAAGkB,YAAYI;IACxE,MAAMC,WAAWH,CAAAA,8BAAAA,WAAYG,QAAQ,IACjCC,OAAOC,WAAW,CAChBD,OAAOE,OAAO,CAACN,WAAWG,QAAQ,EAAE7B,GAAG,CAAC,CAAC,CAACiC,KAAKC,QAAQ,GAAK;YAC1DD;YACAC,CAAAA,2BAAAA,QAASP,UAAU,IACf,aAAKO;gBAASP,YAAYvB,oBAAoB8B,QAAQP,UAAU,EAAEtB;iBAClE6B;SACL,KAEHN;IACJ,OAAO,aACDL;QACJG,YAAY,aACPA,YACC5B,QAAQ;YAAE6B,YAAYvB,oBAAoBN,OAAOO;QAAU,IAAI,CAAC,GAChEwB,WAAW;YAAEA;QAAS,IAAI,CAAC;;AAGrC"}

package/src/lib/util/roboto-flex.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/** The family the brand stack names. Quoted, as it appears in the stack. */
+export declare const ROBOTO_FLEX_FAMILY: string;
+/**
+ * A metric-matched local face that stands in while Roboto Flex loads.
+ *
+ * Arial, scaled and re-spaced so a line set in it occupies the space the
+ * same line takes in Roboto Flex: when the web font swaps in, nothing
+ * reflows. It must sit DIRECTLY after {@link ROBOTO_FLEX_FAMILY} in a stack
+ * to do that, ahead of the system faces.
+ */
+export declare const ROBOTO_FLEX_FALLBACK_FAMILY = "\"Roboto Flex Fallback\"";
+/** Where the files are served from on the console's origin. */
+export declare const ROBOTO_FLEX_BASE_PATH = "/_static/fonts/roboto-flex";
+export interface RobotoFlexFace {
+    subset: 'latin' | 'latin-ext';
+    file: string;
+    unicodeRange: string;
+    /** The one face a page preloads. */
+    preload: boolean;
+}
+/** The cut files, one per `unicode-range` subset. */
+export declare const ROBOTO_FLEX_FACES: readonly RobotoFlexFace[];
+/**
+ * The fallback's overrides, measured rather than guessed.
+ *
+ * `size-adjust` is the ratio of the two faces' mean advance width over an
+ * English sample (Roboto Flex wght 400: 0.4384 em, Arial: 0.4418 em). The
+ * vertical overrides are Roboto Flex's own `hhea` metrics (ascender 1900,
+ * descender −500, line gap 0, on 2048 units) divided by that ratio, since
+ * `size-adjust` scales them too.
+ */
+export declare const ROBOTO_FLEX_FALLBACK_METRICS: {
+    readonly local: "Arial";
+    readonly sizeAdjust: "99.23%";
+    readonly ascentOverride: "93.49%";
+    readonly descentOverride: "24.60%";
+    readonly lineGapOverride: "0%";
+};
+/** The URL a face's file is served from below `basePath`. */
+export declare function robotoFlexFontUrl(face: Pick<RobotoFlexFace, 'file'>, basePath?: string): string;
+/** The URLs a page should preload: the Latin file and nothing else. */
+export declare function robotoFlexPreloadUrls(basePath?: string): string[];
+/**
+ * The `@font-face` rules: one per subset, plus the metric-matched fallback.
+ *
+ * `font-display: swap` so text paints at once in the fallback, which the
+ * overrides make the same size, and the brand face replaces it in place.
+ */
+export declare function robotoFlexFontFaceCss(basePath?: string): string;

package/src/lib/util/roboto-flex.js

@@ -0,0 +1,115 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * Roboto Flex, the brand face, served from the app's own origin (AGL-3655).
+ *
+ * The brand stack names `"Roboto Flex"` first, and for a long time nothing
+ * declared it: only a machine with the family installed saw it. These are
+ * the `@font-face` rules that make the name resolve everywhere, built from
+ * one description so the rules, the preload and the files cannot disagree.
+ *
+ * The files are cut from the official OFL variable TTF (google/fonts
+ * `ofl/robotoflex`, v3.200), the same file the native apps bundle:
+ *
+ *  - Only the `wght` axis is kept, at its full 100–1000 range, because the
+ *    weight ramp is the only axis anything here asks for. `opsz`, `wdth`,
+ *    `slnt` and `GRAD` are pinned at their defaults (14 / 100 / 0 / 0) and
+ *    the parametric axes dropped. Keeping `opsz` as well cost 2.5× the
+ *    bytes (84 KB against 33 KB for Latin) for automatic optical sizing on
+ *    headings.
+ *  - Split by `unicode-range` on Google's own subset boundaries, so a page
+ *    in English downloads only the Latin file, and only the Latin file is
+ *    preloaded.
+ *
+ * To recut them from the TTF (fontTools: `pip install fonttools brotli`):
+ *
+ * ```sh
+ * python3 -m fontTools.varLib.instancer RobotoFlex[…].ttf \
+ *   opsz=14 GRAD=0 wdth=100 slnt=0 XOPQ=drop YOPQ=drop XTRA=drop \
+ *   YTUC=drop YTLC=drop YTAS=drop YTDE=drop YTFI=drop -o wght.ttf
+ * python3 -m fontTools.subset wght.ttf --unicodes="<range>" \
+ *   --flavor=woff2 --layout-features='*' --no-hinting --desubroutinize \
+ *   --output-file=roboto-flex-v3200-<subset>.woff2
+ * ```
+ *
+ * Pure: no React, no DOM. A published site that wants the face (AGL-3656)
+ * builds the same rules against its own base URL.
+ *
+ * Deep-import only (`@aglyn/shared-ui-theme/util/roboto-flex`), and kept out
+ * of the barrel: a published page has no use for these rules, and the
+ * barrel is in its module graph.
+ */ import { FontFamily, ROBOTO_FLEX_FALLBACK } from "../constants.js";
+/** The family the brand stack names. Quoted, as it appears in the stack. */ export const ROBOTO_FLEX_FAMILY = FontFamily.ROBOTO_FLEX;
+/**
+ * A metric-matched local face that stands in while Roboto Flex loads.
+ *
+ * Arial, scaled and re-spaced so a line set in it occupies the space the
+ * same line takes in Roboto Flex: when the web font swaps in, nothing
+ * reflows. It must sit DIRECTLY after {@link ROBOTO_FLEX_FAMILY} in a stack
+ * to do that, ahead of the system faces.
+ */ export const ROBOTO_FLEX_FALLBACK_FAMILY = ROBOTO_FLEX_FALLBACK;
+/** Where the files are served from on the console's origin. */ export const ROBOTO_FLEX_BASE_PATH = '/_static/fonts/roboto-flex';
+/** The cut files, one per `unicode-range` subset. */ export const ROBOTO_FLEX_FACES = [
+    {
+        subset: 'latin-ext',
+        file: 'roboto-flex-v3200-latin-ext.woff2',
+        unicodeRange: 'U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, ' + 'U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, ' + 'U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F, U+A720-A7FF',
+        preload: false
+    },
+    {
+        subset: 'latin',
+        file: 'roboto-flex-v3200-latin.woff2',
+        unicodeRange: 'U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, ' + 'U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, ' + 'U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD',
+        preload: true
+    }
+];
+/**
+ * The fallback's overrides, measured rather than guessed.
+ *
+ * `size-adjust` is the ratio of the two faces' mean advance width over an
+ * English sample (Roboto Flex wght 400: 0.4384 em, Arial: 0.4418 em). The
+ * vertical overrides are Roboto Flex's own `hhea` metrics (ascender 1900,
+ * descender −500, line gap 0, on 2048 units) divided by that ratio, since
+ * `size-adjust` scales them too.
+ */ export const ROBOTO_FLEX_FALLBACK_METRICS = {
+    local: 'Arial',
+    sizeAdjust: '99.23%',
+    ascentOverride: '93.49%',
+    descentOverride: '24.60%',
+    lineGapOverride: '0%'
+};
+/** The URL a face's file is served from below `basePath`. */ export function robotoFlexFontUrl(face, basePath = ROBOTO_FLEX_BASE_PATH) {
+    return `${basePath.replace(/\/+$/, '')}/${face.file}`;
+}
+/** The URLs a page should preload: the Latin file and nothing else. */ export function robotoFlexPreloadUrls(basePath = ROBOTO_FLEX_BASE_PATH) {
+    return ROBOTO_FLEX_FACES.filter((face)=>face.preload).map((face)=>robotoFlexFontUrl(face, basePath));
+}
+/**
+ * The `@font-face` rules: one per subset, plus the metric-matched fallback.
+ *
+ * `font-display: swap` so text paints at once in the fallback, which the
+ * overrides make the same size, and the brand face replaces it in place.
+ */ export function robotoFlexFontFaceCss(basePath = ROBOTO_FLEX_BASE_PATH) {
+    const faces = ROBOTO_FLEX_FACES.map((face)=>`@font-face{font-family:${ROBOTO_FLEX_FAMILY};font-style:normal;` + `font-weight:100 1000;font-display:swap;` + `src:url(${robotoFlexFontUrl(face, basePath)}) format('woff2');` + `unicode-range:${face.unicodeRange}}`);
+    const m = ROBOTO_FLEX_FALLBACK_METRICS;
+    const fallback = `@font-face{font-family:${ROBOTO_FLEX_FALLBACK_FAMILY};` + `src:local('${m.local}');size-adjust:${m.sizeAdjust};` + `ascent-override:${m.ascentOverride};descent-override:${m.descentOverride};` + `line-gap-override:${m.lineGapOverride}}`;
+    return [
+        ...faces,
+        fallback
+    ].join('\n');
+}
+
+//# sourceMappingURL=roboto-flex.js.map

package/src/lib/util/roboto-flex.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/ui/theme/src/lib/util/roboto-flex.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Roboto Flex, the brand face, served from the app's own origin (AGL-3655).\n *\n * The brand stack names `\"Roboto Flex\"` first, and for a long time nothing\n * declared it: only a machine with the family installed saw it. These are\n * the `@font-face` rules that make the name resolve everywhere, built from\n * one description so the rules, the preload and the files cannot disagree.\n *\n * The files are cut from the official OFL variable TTF (google/fonts\n * `ofl/robotoflex`, v3.200), the same file the native apps bundle:\n *\n *  - Only the `wght` axis is kept, at its full 100–1000 range, because the\n *    weight ramp is the only axis anything here asks for. `opsz`, `wdth`,\n *    `slnt` and `GRAD` are pinned at their defaults (14 / 100 / 0 / 0) and\n *    the parametric axes dropped. Keeping `opsz` as well cost 2.5× the\n *    bytes (84 KB against 33 KB for Latin) for automatic optical sizing on\n *    headings.\n *  - Split by `unicode-range` on Google's own subset boundaries, so a page\n *    in English downloads only the Latin file, and only the Latin file is\n *    preloaded.\n *\n * To recut them from the TTF (fontTools: `pip install fonttools brotli`):\n *\n * ```sh\n * python3 -m fontTools.varLib.instancer RobotoFlex[…].ttf \\\n *   opsz=14 GRAD=0 wdth=100 slnt=0 XOPQ=drop YOPQ=drop XTRA=drop \\\n *   YTUC=drop YTLC=drop YTAS=drop YTDE=drop YTFI=drop -o wght.ttf\n * python3 -m fontTools.subset wght.ttf --unicodes=\"<range>\" \\\n *   --flavor=woff2 --layout-features='*' --no-hinting --desubroutinize \\\n *   --output-file=roboto-flex-v3200-<subset>.woff2\n * ```\n *\n * Pure: no React, no DOM. A published site that wants the face (AGL-3656)\n * builds the same rules against its own base URL.\n *\n * Deep-import only (`@aglyn/shared-ui-theme/util/roboto-flex`), and kept out\n * of the barrel: a published page has no use for these rules, and the\n * barrel is in its module graph.\n */\n\nimport { FontFamily, ROBOTO_FLEX_FALLBACK } from '../constants'\n\n/** The family the brand stack names. Quoted, as it appears in the stack. */\nexport const ROBOTO_FLEX_FAMILY: string = FontFamily.ROBOTO_FLEX\n\n/**\n * A metric-matched local face that stands in while Roboto Flex loads.\n *\n * Arial, scaled and re-spaced so a line set in it occupies the space the\n * same line takes in Roboto Flex: when the web font swaps in, nothing\n * reflows. It must sit DIRECTLY after {@link ROBOTO_FLEX_FAMILY} in a stack\n * to do that, ahead of the system faces.\n */\nexport const ROBOTO_FLEX_FALLBACK_FAMILY = ROBOTO_FLEX_FALLBACK\n\n/** Where the files are served from on the console's origin. */\nexport const ROBOTO_FLEX_BASE_PATH = '/_static/fonts/roboto-flex'\n\nexport interface RobotoFlexFace {\n  subset: 'latin' | 'latin-ext'\n  file: string\n  unicodeRange: string\n  /** The one face a page preloads. */\n  preload: boolean\n}\n\n/** The cut files, one per `unicode-range` subset. */\nexport const ROBOTO_FLEX_FACES: readonly RobotoFlexFace[] = [\n  {\n    subset: 'latin-ext',\n    file: 'roboto-flex-v3200-latin-ext.woff2',\n    unicodeRange:\n      'U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, ' +\n      'U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, ' +\n      'U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F, U+A720-A7FF',\n    preload: false,\n  },\n  {\n    subset: 'latin',\n    file: 'roboto-flex-v3200-latin.woff2',\n    unicodeRange:\n      'U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, ' +\n      'U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, ' +\n      'U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD',\n    preload: true,\n  },\n]\n\n/**\n * The fallback's overrides, measured rather than guessed.\n *\n * `size-adjust` is the ratio of the two faces' mean advance width over an\n * English sample (Roboto Flex wght 400: 0.4384 em, Arial: 0.4418 em). The\n * vertical overrides are Roboto Flex's own `hhea` metrics (ascender 1900,\n * descender −500, line gap 0, on 2048 units) divided by that ratio, since\n * `size-adjust` scales them too.\n */\nexport const ROBOTO_FLEX_FALLBACK_METRICS = {\n  local: 'Arial',\n  sizeAdjust: '99.23%',\n  ascentOverride: '93.49%',\n  descentOverride: '24.60%',\n  lineGapOverride: '0%',\n} as const\n\n/** The URL a face's file is served from below `basePath`. */\nexport function robotoFlexFontUrl(\n  face: Pick<RobotoFlexFace, 'file'>,\n  basePath: string = ROBOTO_FLEX_BASE_PATH,\n): string {\n  return `${basePath.replace(/\\/+$/, '')}/${face.file}`\n}\n\n/** The URLs a page should preload: the Latin file and nothing else. */\nexport function robotoFlexPreloadUrls(\n  basePath: string = ROBOTO_FLEX_BASE_PATH,\n): string[] {\n  return ROBOTO_FLEX_FACES.filter((face) => face.preload).map((face) =>\n    robotoFlexFontUrl(face, basePath),\n  )\n}\n\n/**\n * The `@font-face` rules: one per subset, plus the metric-matched fallback.\n *\n * `font-display: swap` so text paints at once in the fallback, which the\n * overrides make the same size, and the brand face replaces it in place.\n */\nexport function robotoFlexFontFaceCss(\n  basePath: string = ROBOTO_FLEX_BASE_PATH,\n): string {\n  const faces = ROBOTO_FLEX_FACES.map(\n    (face) =>\n      `@font-face{font-family:${ROBOTO_FLEX_FAMILY};font-style:normal;` +\n      `font-weight:100 1000;font-display:swap;` +\n      `src:url(${robotoFlexFontUrl(face, basePath)}) format('woff2');` +\n      `unicode-range:${face.unicodeRange}}`,\n  )\n  const m = ROBOTO_FLEX_FALLBACK_METRICS\n  const fallback =\n    `@font-face{font-family:${ROBOTO_FLEX_FALLBACK_FAMILY};` +\n    `src:local('${m.local}');size-adjust:${m.sizeAdjust};` +\n    `ascent-override:${m.ascentOverride};descent-override:${m.descentOverride};` +\n    `line-gap-override:${m.lineGapOverride}}`\n  return [...faces, fallback].join('\\n')\n}\n"],"names":["FontFamily","ROBOTO_FLEX_FALLBACK","ROBOTO_FLEX_FAMILY","ROBOTO_FLEX","ROBOTO_FLEX_FALLBACK_FAMILY","ROBOTO_FLEX_BASE_PATH","ROBOTO_FLEX_FACES","subset","file","unicodeRange","preload","ROBOTO_FLEX_FALLBACK_METRICS","local","sizeAdjust","ascentOverride","descentOverride","lineGapOverride","robotoFlexFontUrl","face","basePath","replace","robotoFlexPreloadUrls","filter","map","robotoFlexFontFaceCss","faces","m","fallback","join"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCC,GAED,SAASA,UAAU,EAAEC,oBAAoB,QAAQ,kBAAc;AAE/D,0EAA0E,GAC1E,OAAO,MAAMC,qBAA6BF,WAAWG,WAAW,CAAA;AAEhE;;;;;;;CAOC,GACD,OAAO,MAAMC,8BAA8BH,qBAAoB;AAE/D,6DAA6D,GAC7D,OAAO,MAAMI,wBAAwB,6BAA4B;AAUjE,mDAAmD,GACnD,OAAO,MAAMC,oBAA+C;IAC1D;QACEC,QAAQ;QACRC,MAAM;QACNC,cACE,sEACA,oEACA;QACFC,SAAS;IACX;IACA;QACEH,QAAQ;QACRC,MAAM;QACNC,cACE,oEACA,kEACA;QACFC,SAAS;IACX;CACD,CAAA;AAED;;;;;;;;CAQC,GACD,OAAO,MAAMC,+BAA+B;IAC1CC,OAAO;IACPC,YAAY;IACZC,gBAAgB;IAChBC,iBAAiB;IACjBC,iBAAiB;AACnB,EAAU;AAEV,2DAA2D,GAC3D,OAAO,SAASC,kBACdC,IAAkC,EAClCC,WAAmBd,qBAAqB;IAExC,OAAO,GAAGc,SAASC,OAAO,CAAC,QAAQ,IAAI,CAAC,EAAEF,KAAKV,IAAI,EAAE;AACvD;AAEA,qEAAqE,GACrE,OAAO,SAASa,sBACdF,WAAmBd,qBAAqB;IAExC,OAAOC,kBAAkBgB,MAAM,CAAC,CAACJ,OAASA,KAAKR,OAAO,EAAEa,GAAG,CAAC,CAACL,OAC3DD,kBAAkBC,MAAMC;AAE5B;AAEA;;;;;CAKC,GACD,OAAO,SAASK,sBACdL,WAAmBd,qBAAqB;IAExC,MAAMoB,QAAQnB,kBAAkBiB,GAAG,CACjC,CAACL,OACC,CAAC,uBAAuB,EAAEhB,mBAAmB,mBAAmB,CAAC,GACjE,CAAC,uCAAuC,CAAC,GACzC,CAAC,QAAQ,EAAEe,kBAAkBC,MAAMC,UAAU,kBAAkB,CAAC,GAChE,CAAC,cAAc,EAAED,KAAKT,YAAY,CAAC,CAAC,CAAC;IAEzC,MAAMiB,IAAIf;IACV,MAAMgB,WACJ,CAAC,uBAAuB,EAAEvB,4BAA4B,CAAC,CAAC,GACxD,CAAC,WAAW,EAAEsB,EAAEd,KAAK,CAAC,eAAe,EAAEc,EAAEb,UAAU,CAAC,CAAC,CAAC,GACtD,CAAC,gBAAgB,EAAEa,EAAEZ,cAAc,CAAC,kBAAkB,EAAEY,EAAEX,eAAe,CAAC,CAAC,CAAC,GAC5E,CAAC,kBAAkB,EAAEW,EAAEV,eAAe,CAAC,CAAC,CAAC;IAC3C,OAAO;WAAIS;QAAOE;KAAS,CAACC,IAAI,CAAC;AACnC"}

package/src/lib/util/self-hosted-fonts.d.ts

@@ -14,7 +14,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { HostTheme } from '@aglyn/shared-data-types';
+import type { HostTheme, HostThemeFont, HostThemeFontCategory, HostThemeFontMetrics } from '@aglyn/shared-data-types';
+export { metricFallbackFamily, themeWebFontFamilies, withMetricFallbacks } from './font-stack';
 /**
  * A theme's Google fonts, served from the site's own origin (AGL-3485).
  *
@@ -94,3 +95,112 @@ export declare function selfHostedFontFaceCss(faces: readonly GoogleFontFace[]):
  * from one file, which is then preloaded once.
  */
 export declare function selfHostedFontPreloads(theme: Pick<HostTheme, 'fonts' | 'typography'> | undefined, faces: readonly GoogleFontFace[]): string[];
+/**
+ * One face a page declares, wherever its file lives: a Google face rewritten
+ * onto {@link SELF_HOSTED_FONT_ROUTE}, or a site's own upload on its media
+ * route. Both are on the site's own origin.
+ */
+export interface SiteFontFace {
+    family: string;
+    style: 'normal' | 'italic';
+    /** A weight (`400`) or, for a variable file, a range (`300 900`). */
+    weight: string;
+    /** Site-relative URL of the WOFF2 file. */
+    url: string;
+    /** Google's subset name (`latin`, …); absent for a file with no split. */
+    subset?: string;
+    unicodeRange?: string;
+}
+/** A Google face as a {@link SiteFontFace} on the site's own route. */
+export declare function siteFontFaceFromGoogle(face: GoogleFontFace): SiteFontFace;
+/**
+ * The faces with every set of rules that share one file folded into one rule
+ * over the weights it covers.
+ *
+ * Google answers a request for several weights of a variable family with the
+ * SAME file once per weight, each rule naming one weight. A browser treats
+ * those as separate faces: it matches 500 to nothing between the 400 and 600
+ * rules a theme listed and renders it as 400, though the file holds every
+ * weight in between. One rule declaring the range (`400 700`) is what the
+ * file is.
+ */
+export declare function mergeSharedFiles<T extends {
+    url: string;
+    weight: string;
+    family: string;
+    style: string;
+    unicodeRange?: string;
+}>(faces: readonly T[]): T[];
+/** The rules for a page's faces, every one `font-display: swap`. */
+export declare function siteFontFaceCss(faces: readonly SiteFontFace[]): string;
+/**
+ * Whether a URL is one a rule may name: site-relative, on the font route or
+ * the media route, with nothing that could close the `url()` it is written
+ * into. A face whose URL fails is dropped rather than escaped.
+ */
+export declare function isSiteFontUrl(url: string): boolean;
+/**
+ * The `@font-face` rule for a family's metric-matched fallback: the local face
+ * of its category, scaled so its average character is as wide as the web
+ * font's (`size-adjust`) and given the web font's ascent, descent and line gap
+ * at that scale. Text set in it occupies the box the web font will, so the
+ * swap moves nothing — the CLS a `font-display: swap` page otherwise pays.
+ *
+ * The overrides are divided by the size adjustment because the browser
+ * applies them to the ADJUSTED size: an ascent of 0.97em on a face scaled to
+ * 1.07 has to be written as 0.97/1.07 to land at 0.97em.
+ *
+ * Empty for metrics that are missing or not numbers.
+ */
+export declare function metricFallbackFontFaceCss(family: string, metrics: HostThemeFontMetrics | undefined, category?: HostThemeFontCategory): string;
+/** What one family of a theme needs loaded: the weights, and which as italics. */
+export interface ThemeFontNeed {
+    family: string;
+    /** Upright weights the theme's text styles and named weights draw with. */
+    weights: number[];
+    /** The subset of `weights` text styles alone use, which a delivery choice is measured on. */
+    textWeights: number[];
+    italics: number[];
+}
+/**
+ * The faces each of a theme's web font families is drawn with (AGL-3656).
+ *
+ * A theme lists weights for its font (`fonts[].weights`), but the page draws
+ * with whatever its text styles say: the platform's ramp sets `h1` in 900 and
+ * `h2` in 800, so a theme that loaded Inter at 400, 500 and 700 drew its
+ * headlines in a synthesized or substituted weight. The weights here are the
+ * union of the listed ones, every text style's weight whose family resolves to
+ * this one, and the theme's named weights (`fontWeightLight` … `Black`), which
+ * the weight picker offers content.
+ *
+ * `baseTypography` is the typography the site's theme is layered onto
+ * (`siteBaseOptions(...).typography`): a text style the theme leaves alone
+ * keeps the base's weight and family.
+ *
+ * One italic is loaded per family, at the body text's weight, so emphasis in
+ * running text is a real italic rather than a slanted upright; a theme can
+ * list more under `italics`.
+ */
+export declare function themeFontNeeds(theme: Pick<HostTheme, 'fonts' | 'typography'> | undefined, baseTypography: Record<string, unknown> | undefined, extraFonts?: readonly HostThemeFont[]): ThemeFontNeed[];
+/**
+ * The weights to load from what a family offers: each wanted weight as the
+ * nearest one offered, without repeats. Unknown availability keeps the
+ * wanted weights as they are.
+ */
+export declare function offeredWeights(wanted: readonly number[], offered: readonly number[] | undefined): number[];
+/**
+ * Google's CSS2 URL for some faces of one family: `ital,wght` tuples, sorted
+ * as the API requires. One weight asks for a static instance, which for a
+ * variable family is a file holding that weight alone — Inter's Latin 400 is
+ * 24 KB that way and 48 KB as the variable file.
+ */
+export declare function googleFontSheetUrl(family: string, faces: ReadonlyArray<{
+    weight: number;
+    style: 'normal' | 'italic';
+}>): string | undefined;
+/**
+ * The files the first screen paints with, to preload: the body text's face
+ * and the headline's, Latin and upright, from whatever faces the page
+ * declares. A file covering both is preloaded once.
+ */
+export declare function siteFontPreloads(theme: Pick<HostTheme, 'fonts' | 'typography'> | undefined, faces: readonly SiteFontFace[], baseTypography?: Record<string, unknown>): string[];