@loworbitstudio/visor-theme-engine 0.8.1 → 0.9.0

package/dist/adapters/index.d.ts

@@ -1,4 +1,4 @@
-import { c as GeneratedPrimitives, i as SemanticTokens, R as ResolvedThemeConfig } from '../types-CV0nmvMz.js';
+import { c as GeneratedPrimitives, i as SemanticTokens, R as ResolvedThemeConfig } from '../types-0hotGz1u.js';
 
 /**
  * Adapter types for the Visor theme engine.

package/dist/adapters/index.js

@@ -13,7 +13,7 @@ import {
   parseColor,
   resolveThemeFonts,
   sectionComment
-} from "../chunk-OJVNL7KN.js";
+} from "../chunk-BEFH5BTX.js";
 
 // src/adapters/layers.ts
 var LAYER_ORDER = "@layer visor-primitives, visor-semantic, visor-adaptive, visor-bridge;";
@@ -75,7 +75,7 @@ function nextjsAdapter(input, options) {
       seenVisorFamilies.add(font.family);
       const aliased = aliasedFamilies.get(font.family);
       for (const weight of font.weights) {
-        const url = buildVisorFontUrl(font.org ?? "", font.family, weight);
+        const url = buildVisorFontUrl(font.org ?? "", font.family, weight, font.cdnBase);
         lines.push(`@font-face {`);
         lines.push(`  font-family: "${aliased}";`);
         lines.push(`  src: url("${url}") format("woff2");`);
@@ -463,7 +463,7 @@ function docsAdapter(input, options) {
         emittedFamilies.add(font.family);
         const aliased = aliasedFamilies.get(font.family);
         for (const weight of font.weights) {
-          const url = buildVisorFontUrl(font.org ?? "", font.family, weight);
+          const url = buildVisorFontUrl(font.org ?? "", font.family, weight, font.cdnBase);
           fontLines.push("@font-face {");
           fontLines.push(`  font-family: "${aliased}";`);
           fontLines.push(`  src: url("${url}") format("woff2");`);

package/dist/{chunk-OJVNL7KN.js → chunk-BEFH5BTX.js}

@@ -179,11 +179,13 @@ var WEIGHT_NAMES = {
   800: "ExtraBold",
   900: "Black"
 };
-function buildVisorFontUrl(org, family, weight) {
+function buildVisorFontUrl(org, family, weight, cdnBase) {
+  const base = cdnBase ?? VISOR_FONTS_CDN;
   const slug = buildFamilySlug(family);
   const prefix = buildFamilyPrefix(family);
   const weightName = lookupFontWeightAlias(family, weight) ?? WEIGHT_NAMES[weight] ?? `W${weight}`;
-  return `${VISOR_FONTS_CDN}/${org}/${slug}/${prefix}-${weightName}.woff2`;
+  const orgSegment = org ? `/${org}` : "";
+  return `${base}${orgSegment}/${slug}/${prefix}-${weightName}.woff2`;
 }
 function buildFontshareCssUrl(family, weights, italic, display) {
   const slug = buildFamilySlug(family);
@@ -210,7 +212,8 @@ function resolveFont(family, options = {}) {
       display,
       category: options.category ?? "sans-serif",
       guidance: null,
-      org: options.org ?? null
+      org: options.org ?? null,
+      cdnBase: options.cdnBase ?? null
     };
   }
   if (explicitSource === "fontshare") {
@@ -224,7 +227,8 @@ function resolveFont(family, options = {}) {
       display,
       category: options.category ?? "sans-serif",
       guidance: null,
-      org: null
+      org: null,
+      cdnBase: null
     };
   }
   if (explicitSource === "local") {
@@ -240,7 +244,8 @@ function resolveFont(family, options = {}) {
   1. Add the font files (.woff2) to your project's public/fonts/ directory
   2. Create @font-face declarations in your theme CSS
   3. Reference the font family in your theme's --font-display or --font-body token`,
-      org: null
+      org: null,
+      cdnBase: null
     };
   }
   const catalogEntry = lookupGoogleFont(family);
@@ -267,7 +272,8 @@ function resolveFont(family, options = {}) {
       display,
       category: catalogEntry.category,
       guidance: null,
-      org: null
+      org: null,
+      cdnBase: null
     };
   }
   return {
@@ -282,7 +288,8 @@ function resolveFont(family, options = {}) {
   1. Add the font files (.woff2) to your project's public/fonts/ directory
   2. Create @font-face declarations in your theme CSS
   3. Reference the font family in your theme's --font-display or --font-body token`,
-    org: null
+    org: null,
+    cdnBase: null
   };
 }
 
@@ -307,19 +314,29 @@ function generatePreloadLinks(resolutions, customFontPaths) {
       }
     }
   }
-  const hasVisorFonts = resolutions.some((r) => r.source === "visor-fonts");
-  if (hasVisorFonts) {
-    links.push(
-      `<link rel="preconnect" href="${VISOR_FONTS_CDN}" crossorigin>`
-    );
-    for (const resolution of resolutions) {
-      if (resolution.source === "visor-fonts" && resolution.org) {
-        for (const weight of resolution.weights) {
-          const url = buildVisorFontUrl(resolution.org, resolution.family, weight);
-          links.push(
-            `<link rel="preload" as="font" type="font/woff2" href="${url}" crossorigin>`
-          );
-        }
+  const visorFontResolutions = resolutions.filter(
+    (r) => r.source === "visor-fonts"
+  );
+  if (visorFontResolutions.length > 0) {
+    const cdnBases = /* @__PURE__ */ new Set();
+    for (const resolution of visorFontResolutions) {
+      cdnBases.add(resolution.cdnBase ?? VISOR_FONTS_CDN);
+    }
+    for (const base of cdnBases) {
+      links.push(`<link rel="preconnect" href="${base}" crossorigin>`);
+    }
+    for (const resolution of visorFontResolutions) {
+      if (resolution.org === null && resolution.cdnBase === null) continue;
+      for (const weight of resolution.weights) {
+        const url = buildVisorFontUrl(
+          resolution.org ?? "",
+          resolution.family,
+          weight,
+          resolution.cdnBase
+        );
+        links.push(
+          `<link rel="preload" as="font" type="font/woff2" href="${url}" crossorigin>`
+        );
       }
     }
   }
@@ -402,7 +419,7 @@ function generateFontCSS(heading, displayFont, body, mono, typography) {
       if (seenVisorFonts.has(font.family)) continue;
       seenVisorFonts.add(font.family);
       for (const weight of font.weights) {
-        const url = buildVisorFontUrl(font.org ?? "", font.family, weight);
+        const url = buildVisorFontUrl(font.org ?? "", font.family, weight, font.cdnBase);
         lines.push(`@font-face {`);
         lines.push(`  font-family: "${font.family}";`);
         lines.push(`  src: url("${url}") format("woff2");`);
@@ -542,6 +559,8 @@ function getSizeAdjust(category) {
 function resolveThemeFonts(typography, options) {
   const display = options?.display ?? "swap";
   const warnings = [];
+  const cdnOverrides = typography["cdn-overrides"];
+  const visorFontsCdnBase = cdnOverrides?.["visor-fonts"];
   let headingResolution = null;
   if (typography.heading?.family) {
     const weights = typography.heading.weights ? [...typography.heading.weights] : typography.heading.weight ? [typography.heading.weight] : [];
@@ -549,7 +568,8 @@ function resolveThemeFonts(typography, options) {
       weights: weights.length > 0 ? weights : void 0,
       display,
       source: typography.heading.source,
-      org: typography.heading.org
+      org: typography.heading.org,
+      cdnBase: visorFontsCdnBase
     });
     if (headingResolution.guidance) {
       warnings.push(headingResolution.guidance);
@@ -574,7 +594,8 @@ function resolveThemeFonts(typography, options) {
         weights: mergedWeights,
         display,
         source: typography.heading.source,
-        org: typography.heading.org
+        org: typography.heading.org,
+        cdnBase: visorFontsCdnBase
       });
       bodyResolution = headingResolution;
     } else {
@@ -582,7 +603,8 @@ function resolveThemeFonts(typography, options) {
         weights: bodyWeights.length > 0 ? bodyWeights : void 0,
         display,
         source: typography.body.source,
-        org: typography.body.org
+        org: typography.body.org,
+        cdnBase: visorFontsCdnBase
       });
       if (bodyResolution.guidance) {
         warnings.push(bodyResolution.guidance);
@@ -603,7 +625,8 @@ function resolveThemeFonts(typography, options) {
           weights: mergedWeights,
           display,
           source: typography.heading.source,
-          org: typography.heading.org
+          org: typography.heading.org,
+          cdnBase: visorFontsCdnBase
         });
         displayResolution = headingResolution;
       }
@@ -615,7 +638,8 @@ function resolveThemeFonts(typography, options) {
         weights: mergedWeights,
         display,
         source: typography.body.source,
-        org: typography.body.org
+        org: typography.body.org,
+        cdnBase: visorFontsCdnBase
       });
       displayResolution = bodyResolution;
     } else {
@@ -623,7 +647,8 @@ function resolveThemeFonts(typography, options) {
         weights: displayWeights.length > 0 ? displayWeights : void 0,
         display,
         source: typography.display.source,
-        org: typography.display.org
+        org: typography.display.org,
+        cdnBase: visorFontsCdnBase
       });
       if (displayResolution.guidance) {
         warnings.push(displayResolution.guidance);
@@ -655,6 +680,7 @@ function resolveThemeFonts(typography, options) {
       display,
       source: monoSource,
       org: monoOrg,
+      cdnBase: visorFontsCdnBase,
       category: "monospace"
     });
     if (monoResolution.guidance) {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FontResolveOptions, a as FontResolution, V as VisorTypography, b as FontDisplayStrategy, T as ThemeFontResult, G as GoogleFontEntry, R as ResolvedThemeConfig, c as GeneratedPrimitives, d as ThemeOutput, e as ThemeData, f as VisorThemeConfig, g as FullShadeScale, C as ColorRole, S as SelectiveShadeScale, h as RGB, P as ParsedColor, O as OKLCH, i as SemanticTokens, j as ShadeStep } from './types-CV0nmvMz.js';
-export { k as ColorFormat, l as FontSource, m as RGBA, n as SemanticTokenValue } from './types-CV0nmvMz.js';
+import { F as FontResolveOptions, a as FontResolution, V as VisorTypography, b as FontDisplayStrategy, T as ThemeFontResult, G as GoogleFontEntry, R as ResolvedThemeConfig, c as GeneratedPrimitives, d as ThemeOutput, e as ThemeData, f as VisorThemeConfig, g as FullShadeScale, C as ColorRole, S as SelectiveShadeScale, h as RGB, P as ParsedColor, O as OKLCH, i as SemanticTokens, j as ShadeStep } from './types-0hotGz1u.js';
+export { k as ColorFormat, l as FontSource, m as RGBA, n as SemanticTokenValue } from './types-0hotGz1u.js';
 
 /**
  * Font resolver — maps font family names to loadable font resources.
@@ -16,7 +16,17 @@ export { k as ColorFormat, l as FontSource, m as RGBA, n as SemanticTokenValue }
  * Filename: original uploaded name (e.g., PPModelPlastic-Regular).
  */
 declare const VISOR_FONTS_CDN = "https://fonts.visor.design";
-declare function buildVisorFontUrl(org: string, family: string, weight: number): string;
+/**
+ * Build a visor-fonts URL.
+ *
+ * Default pattern: `https://fonts.visor.design/{org}/{slug}/{prefix}-{weight}.woff2`
+ *
+ * When `cdnBase` is provided, that base replaces `VISOR_FONTS_CDN`. When
+ * `org` is empty (theme-level CDN override already encodes the namespace,
+ * e.g. `https://fonts.knowmentum.ai`), the org segment is dropped:
+ * `{cdnBase}/{slug}/{prefix}-{weight}.woff2`.
+ */
+declare function buildVisorFontUrl(org: string, family: string, weight: number, cdnBase?: string | null): string;
 /**
  * Resolve a font family name to a FontResolution.
  *
@@ -422,6 +432,18 @@ var properties = {
 					}
 				}
 			},
+			"cdn-overrides": {
+				type: "object",
+				description: "Per-source CDN base URL overrides. When set, the override CDN replaces the default for every slot whose source matches the key. The per-slot org may be empty when the override CDN already encodes the project namespace (e.g., https://fonts.knowmentum.ai).",
+				additionalProperties: false,
+				properties: {
+					"visor-fonts": {
+						type: "string",
+						minLength: 1,
+						description: "CDN base URL that replaces fonts.visor.design for source: visor-fonts slots (e.g., https://fonts.knowmentum.ai)."
+					}
+				}
+			},
 			slots: {
 				type: "object",
 				description: "Per-slot overrides for the generated Flutter Material TextTheme. Any subset of the 16 slots may be specified; omitted slots fall through to the Material 3 2024 defaults shipped in visor_core.",

package/dist/index.js

@@ -34,7 +34,7 @@ import {
   rgbToHex,
   rgbToOklch,
   serializeColor
-} from "./chunk-OJVNL7KN.js";
+} from "./chunk-BEFH5BTX.js";
 
 // src/fonts/validate-coverage.ts
 var FONT_VAR_RE = /--font-(heading|display|body|sans|mono)\s*:\s*([^;]+);/g;
@@ -381,6 +381,18 @@ var visor_theme_schema_default = {
             wide: { type: "string" }
           }
         },
+        "cdn-overrides": {
+          type: "object",
+          description: "Per-source CDN base URL overrides. When set, the override CDN replaces the default for every slot whose source matches the key. The per-slot org may be empty when the override CDN already encodes the project namespace (e.g., https://fonts.knowmentum.ai).",
+          additionalProperties: false,
+          properties: {
+            "visor-fonts": {
+              type: "string",
+              minLength: 1,
+              description: "CDN base URL that replaces fonts.visor.design for source: visor-fonts slots (e.g., https://fonts.knowmentum.ai)."
+            }
+          }
+        },
         slots: {
           type: "object",
           description: "Per-slot overrides for the generated Flutter Material TextTheme. Any subset of the 16 slots may be specified; omitted slots fall through to the Material 3 2024 defaults shipped in visor_core.",
@@ -580,8 +592,10 @@ var KNOWN_TYPOGRAPHY_KEYS = /* @__PURE__ */ new Set([
   "mono",
   "letter-spacing",
   "scale",
-  "slots"
+  "slots",
+  "cdn-overrides"
 ]);
+var KNOWN_CDN_OVERRIDE_KEYS = /* @__PURE__ */ new Set(["visor-fonts"]);
 var KNOWN_TYPOGRAPHY_FONT_KEYS = /* @__PURE__ */ new Set(["family", "weight", "weights", "source", "org"]);
 var KNOWN_TYPOGRAPHY_MONO_KEYS = /* @__PURE__ */ new Set(["family", "weight", "weights", "source", "org"]);
 var KNOWN_LETTER_SPACING_KEYS = /* @__PURE__ */ new Set(["tight", "normal", "wide"]);
@@ -648,6 +662,13 @@ function checkUnknownKeys(obj, errors) {
         }
       }
     }
+    if (typeof typo["cdn-overrides"] === "object" && typo["cdn-overrides"] !== null) {
+      for (const key of Object.keys(typo["cdn-overrides"])) {
+        if (!KNOWN_CDN_OVERRIDE_KEYS.has(key)) {
+          errors.push(`Unknown key 'typography.cdn-overrides.${key}'. Valid keys: ${[...KNOWN_CDN_OVERRIDE_KEYS].join(", ")}`);
+        }
+      }
+    }
     if (typeof typo["letter-spacing"] === "object" && typo["letter-spacing"] !== null) {
       for (const key of Object.keys(typo["letter-spacing"])) {
         if (!KNOWN_LETTER_SPACING_KEYS.has(key)) {
@@ -798,10 +819,19 @@ function validateConfig(config) {
   }
   if (typeof obj.typography === "object" && obj.typography !== null) {
     const typo = obj.typography;
+    const cdnOverrides = typo["cdn-overrides"];
+    const visorFontsOverride = cdnOverrides?.["visor-fonts"];
+    if (visorFontsOverride !== void 0 && typeof visorFontsOverride !== "string") {
+      errors.push(`'typography.cdn-overrides.visor-fonts' must be a string URL`);
+    }
+    if (typeof visorFontsOverride === "string" && visorFontsOverride.length === 0) {
+      errors.push(`'typography.cdn-overrides.visor-fonts' must not be empty`);
+    }
+    const orgOptional = typeof visorFontsOverride === "string" && visorFontsOverride.length > 0;
     for (const slot of ["heading", "display", "body"]) {
       const font = typo[slot];
-      if (font && font.source === "visor-fonts" && !font.org) {
-        errors.push(`'typography.${slot}.org' is required when source is 'visor-fonts'`);
+      if (font && font.source === "visor-fonts" && !orgOptional && !font.org) {
+        errors.push(`'typography.${slot}.org' is required when source is 'visor-fonts' (unless typography.cdn-overrides.visor-fonts is set)`);
       }
       if (font && font.weights !== void 0) {
         if (!Array.isArray(font.weights) || !font.weights.every((w) => typeof w === "number" && w > 0)) {
@@ -962,6 +992,9 @@ function resolveConfig(config) {
         ...config.typography?.mono?.source && { source: config.typography.mono.source },
         ...config.typography?.mono?.org && { org: config.typography.mono.org }
       },
+      ...config.typography?.["cdn-overrides"] && {
+        "cdn-overrides": config.typography["cdn-overrides"]
+      },
       slots: config.typography?.slots ?? {}
     },
     spacing: {

package/dist/{types-CV0nmvMz.d.ts → types-0hotGz1u.d.ts}

@@ -25,6 +25,8 @@ interface FontResolution {
     guidance: string | null;
     /** Organization namespace (only for visor-fonts source) */
     org: string | null;
+    /** CDN base URL override (only for visor-fonts source; null = default fonts.visor.design) */
+    cdnBase: string | null;
 }
 /** Options for resolving a single font */
 interface FontResolveOptions {
@@ -38,8 +40,10 @@ interface FontResolveOptions {
     category?: string;
     /** Font source override — skips Google Fonts lookup when set */
     source?: FontSource;
-    /** Organization namespace for visor-fonts CDN (required when source is "visor-fonts") */
+    /** Organization namespace for visor-fonts CDN (required when source is "visor-fonts" unless a cdnBase override is provided) */
     org?: string;
+    /** CDN base URL override for visor-fonts (e.g., "https://fonts.knowmentum.ai"); defaults to VISOR_FONTS_CDN */
+    cdnBase?: string;
 }
 /** Typography section from a .visor.yaml file */
 interface VisorTypography {
@@ -80,6 +84,15 @@ interface VisorTypography {
         normal?: string;
         wide?: string;
     };
+    /**
+     * Per-source CDN base URL overrides. When a slot's `source` matches a key,
+     * URL resolution uses the override base instead of the default CDN.
+     * Currently only `visor-fonts` is supported; Google/Fontshare have no
+     * analogous need.
+     */
+    "cdn-overrides"?: {
+        "visor-fonts"?: string;
+    };
 }
 /** Result of resolving all fonts for a theme */
 interface ThemeFontResult {
@@ -209,6 +222,16 @@ interface VisorThemeConfig {
             normal?: string;
             wide?: string;
         };
+        /**
+         * Per-source CDN base URL overrides for font URL resolution. Only
+         * `visor-fonts` is currently supported. When set, the override CDN
+         * replaces `fonts.visor.design` for every slot whose `source: visor-fonts`.
+         * The per-slot `org` may be empty when the override CDN already encodes
+         * the project namespace (e.g., `fonts.knowmentum.ai`).
+         */
+        "cdn-overrides"?: {
+            "visor-fonts"?: string;
+        };
         /**
          * Per-slot overrides for the generated Flutter `TextTheme`. Any subset
          * of the 16 Material slots may be specified; omitted slots fall
@@ -314,6 +337,14 @@ interface ResolvedThemeConfig {
             source?: FontSource;
             org?: string;
         };
+        /**
+         * Per-source CDN base URL overrides (e.g., `visor-fonts:
+         * https://fonts.knowmentum.ai`). Passed through from raw config so
+         * adapters can route font URLs to per-theme buckets.
+         */
+        "cdn-overrides"?: {
+            "visor-fonts"?: string;
+        };
         /**
          * Per-slot Material `TextTheme` overrides, passed through from the
          * raw config. Empty object when none supplied. Flutter adapter

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loworbitstudio/visor-theme-engine",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "Theme engine for the Visor design system — shade generation, token mapping, font resolution, and import/export for .visor.yaml themes.",
   "type": "module",
   "main": "./dist/index.js",

package/src/visor-theme.schema.json

@@ -185,6 +185,18 @@
             "wide": { "type": "string" }
           }
         },
+        "cdn-overrides": {
+          "type": "object",
+          "description": "Per-source CDN base URL overrides. When set, the override CDN replaces the default for every slot whose source matches the key. The per-slot org may be empty when the override CDN already encodes the project namespace (e.g., https://fonts.knowmentum.ai).",
+          "additionalProperties": false,
+          "properties": {
+            "visor-fonts": {
+              "type": "string",
+              "minLength": 1,
+              "description": "CDN base URL that replaces fonts.visor.design for source: visor-fonts slots (e.g., https://fonts.knowmentum.ai)."
+            }
+          }
+        },
         "slots": {
           "type": "object",
           "description": "Per-slot overrides for the generated Flutter Material TextTheme. Any subset of the 16 slots may be specified; omitted slots fall through to the Material 3 2024 defaults shipped in visor_core.",