@servlyadmin/runtime-core 0.1.42 → 0.1.44

package/dist/{chunk-L5RPU26D.js → chunk-TXHGJYYM.js}

@@ -152,18 +152,45 @@ function injectTailwind(config = {}) {
     const existingScript = document.querySelector('script[src*="tailwindcss.com"]');
     console.log("[Servly Tailwind] Existing script check:", { existingScript: !!existingScript, windowTailwind: !!window.tailwind });
     if (existingScript || window.tailwind) {
-      console.log("[Servly Tailwind] Tailwind already exists");
+      console.log("[Servly Tailwind] Tailwind script already exists, waiting for window.tailwind...");
       tailwindInjected = true;
       markTailwindAsLoaded();
-      if (shouldPreventFOUC) {
-        removeFOUCPrevention();
-      }
-      if (tailwindReadyResolve) {
-        tailwindReadyResolve();
-        tailwindReadyResolve = null;
+      if (window.tailwind) {
+        console.log("[Servly Tailwind] window.tailwind already available");
+        if (shouldPreventFOUC) {
+          removeFOUCPrevention();
+        }
+        if (tailwindReadyResolve) {
+          tailwindReadyResolve();
+          tailwindReadyResolve = null;
+        }
+        config.onReady?.();
+        resolve();
+        return;
       }
-      config.onReady?.();
-      resolve();
+      let pollCount2 = 0;
+      const maxPolls2 = 100;
+      const pollForTailwind2 = () => {
+        pollCount2++;
+        if (window.tailwind) {
+          console.log("[Servly Tailwind] window.tailwind now available after", pollCount2 * 100, "ms");
+          if (shouldPreventFOUC) {
+            removeFOUCPrevention();
+          }
+          if (tailwindReadyResolve) {
+            tailwindReadyResolve();
+            tailwindReadyResolve = null;
+          }
+          config.onReady?.();
+          resolve();
+        } else if (pollCount2 < maxPolls2) {
+          setTimeout(pollForTailwind2, 100);
+        } else {
+          console.warn("[Servly Tailwind] window.tailwind never became available");
+          resolve();
+        }
+      };
+      setTimeout(pollForTailwind2, 100);
       return;
     }
     const scriptUrl = usePlayCdn ? `${cdnUrl}?plugins=forms,typography,aspect-ratio` : cdnUrl;
@@ -171,7 +198,6 @@ function injectTailwind(config = {}) {
     const script = document.createElement("script");
     script.src = scriptUrl;
     script.async = true;
-    script.crossOrigin = "anonymous";
     script.onload = () => {
       console.log("[Servly Tailwind] Script loaded successfully!");
       tailwindInjected = true;
@@ -209,6 +235,33 @@ function injectTailwind(config = {}) {
     console.log("[Servly Tailwind] Appending script to head");
     document.head.appendChild(script);
     console.log("[Servly Tailwind] Script appended, head now has:", document.head.querySelectorAll("script").length, "scripts");
+    let pollCount = 0;
+    const maxPolls = 100;
+    const pollForTailwind = () => {
+      pollCount++;
+      if (window.tailwind) {
+        console.log("[Servly Tailwind] Tailwind detected via polling after", pollCount * 100, "ms");
+        if (!tailwindInjected) {
+          tailwindInjected = true;
+          tailwindScript = script;
+          markTailwindAsLoaded();
+          if (shouldPreventFOUC) {
+            removeFOUCPrevention();
+          }
+          if (tailwindReadyResolve) {
+            tailwindReadyResolve();
+            tailwindReadyResolve = null;
+          }
+          onReady?.();
+          resolve();
+        }
+      } else if (pollCount < maxPolls) {
+        setTimeout(pollForTailwind, 100);
+      } else {
+        console.warn("[Servly Tailwind] Tailwind not detected after polling, giving up");
+      }
+    };
+    setTimeout(pollForTailwind, 100);
   });
 }
 function removeTailwind() {

package/dist/index.cjs

@@ -180,18 +180,45 @@ function injectTailwind(config = {}) {
     const existingScript = document.querySelector('script[src*="tailwindcss.com"]');
     console.log("[Servly Tailwind] Existing script check:", { existingScript: !!existingScript, windowTailwind: !!window.tailwind });
     if (existingScript || window.tailwind) {
-      console.log("[Servly Tailwind] Tailwind already exists");
+      console.log("[Servly Tailwind] Tailwind script already exists, waiting for window.tailwind...");
       tailwindInjected = true;
       markTailwindAsLoaded();
-      if (shouldPreventFOUC) {
-        removeFOUCPrevention();
-      }
-      if (tailwindReadyResolve) {
-        tailwindReadyResolve();
-        tailwindReadyResolve = null;
+      if (window.tailwind) {
+        console.log("[Servly Tailwind] window.tailwind already available");
+        if (shouldPreventFOUC) {
+          removeFOUCPrevention();
+        }
+        if (tailwindReadyResolve) {
+          tailwindReadyResolve();
+          tailwindReadyResolve = null;
+        }
+        config.onReady?.();
+        resolve();
+        return;
       }
-      config.onReady?.();
-      resolve();
+      let pollCount2 = 0;
+      const maxPolls2 = 100;
+      const pollForTailwind2 = () => {
+        pollCount2++;
+        if (window.tailwind) {
+          console.log("[Servly Tailwind] window.tailwind now available after", pollCount2 * 100, "ms");
+          if (shouldPreventFOUC) {
+            removeFOUCPrevention();
+          }
+          if (tailwindReadyResolve) {
+            tailwindReadyResolve();
+            tailwindReadyResolve = null;
+          }
+          config.onReady?.();
+          resolve();
+        } else if (pollCount2 < maxPolls2) {
+          setTimeout(pollForTailwind2, 100);
+        } else {
+          console.warn("[Servly Tailwind] window.tailwind never became available");
+          resolve();
+        }
+      };
+      setTimeout(pollForTailwind2, 100);
       return;
     }
     const scriptUrl = usePlayCdn ? `${cdnUrl}?plugins=forms,typography,aspect-ratio` : cdnUrl;
@@ -199,7 +226,6 @@ function injectTailwind(config = {}) {
     const script = document.createElement("script");
     script.src = scriptUrl;
     script.async = true;
-    script.crossOrigin = "anonymous";
     script.onload = () => {
       console.log("[Servly Tailwind] Script loaded successfully!");
       tailwindInjected = true;
@@ -237,6 +263,33 @@ function injectTailwind(config = {}) {
     console.log("[Servly Tailwind] Appending script to head");
     document.head.appendChild(script);
     console.log("[Servly Tailwind] Script appended, head now has:", document.head.querySelectorAll("script").length, "scripts");
+    let pollCount = 0;
+    const maxPolls = 100;
+    const pollForTailwind = () => {
+      pollCount++;
+      if (window.tailwind) {
+        console.log("[Servly Tailwind] Tailwind detected via polling after", pollCount * 100, "ms");
+        if (!tailwindInjected) {
+          tailwindInjected = true;
+          tailwindScript = script;
+          markTailwindAsLoaded();
+          if (shouldPreventFOUC) {
+            removeFOUCPrevention();
+          }
+          if (tailwindReadyResolve) {
+            tailwindReadyResolve();
+            tailwindReadyResolve = null;
+          }
+          onReady?.();
+          resolve();
+        }
+      } else if (pollCount < maxPolls) {
+        setTimeout(pollForTailwind, 100);
+      } else {
+        console.warn("[Servly Tailwind] Tailwind not detected after polling, giving up");
+      }
+    };
+    setTimeout(pollForTailwind, 100);
   });
 }
 function removeTailwind() {
@@ -631,6 +684,7 @@ __export(index_exports, {
   StateManager: () => StateManager,
   addClass: () => addClass,
   addCustomStyles: () => addCustomStyles,
+  addFontPreconnect: () => addFontPreconnect,
   analytics: () => analytics,
   applyStyles: () => applyStyles,
   batchFetchComponents: () => batchFetchComponents,
@@ -656,6 +710,7 @@ __export(index_exports, {
   deepMerge: () => deepMerge,
   deleteValueByPath: () => deleteValueByPath,
   detectCircularDependencies: () => detectCircularDependencies,
+  ensureFonts: () => ensureFonts,
   extractBindingKeys: () => extractBindingKeys,
   extractDependencies: () => extractDependencies,
   extractDependenciesFromCode: () => extractDependenciesFromCode,
@@ -669,12 +724,14 @@ __export(index_exports, {
   getAnalytics: () => getAnalytics,
   getCacheKey: () => getCacheKey,
   getCleanupOverrides: () => getCleanupOverrides,
+  getDefaultFonts: () => getDefaultFonts,
   getDependencyTree: () => getDependencyTree,
   getEventSystem: () => getEventSystem,
   getFromCache: () => getFromCache,
   getIconData: () => getIconData,
   getIconDataSync: () => getIconDataSync,
   getIconifyCollection: () => getIconifyCollection,
+  getLoadedFonts: () => getLoadedFonts,
   getLocalStorage: () => getLocalStorage,
   getLongTaskObserver: () => getLongTaskObserver,
   getMemoryCacheSize: () => getMemoryCacheSize,
@@ -695,17 +752,22 @@ __export(index_exports, {
   hasDependencyOverrides: () => hasDependencyOverrides,
   hasOverrides: () => hasOverrides,
   hasTemplateSyntax: () => hasTemplateSyntax,
+  initFonts: () => initFonts,
   initServlyTailwind: () => initServlyTailwind,
   injectTailwind: () => injectTailwind,
   injectTailwindStyles: () => injectTailwindStyles,
   invalidateCache: () => invalidateCache,
   isComponentAvailable: () => isComponentAvailable,
+  isFontLoaded: () => isFontLoaded,
   isIconCdnEnabled: () => isIconCdnEnabled,
   isIconRegistered: () => isIconRegistered,
   isIconSetSupported: () => isIconSetSupported,
   isTailwindLoaded: () => isTailwindLoaded,
   isTailwindReady: () => isTailwindReady,
   isValidSpecifier: () => isValidSpecifier,
+  loadDefaultFonts: () => loadDefaultFonts,
+  loadFont: () => loadFont,
+  loadFonts: () => loadFonts,
   markElementReady: () => markElementReady,
   navigateTo: () => navigateTo,
   parseVersion: () => parseVersion,
@@ -3375,6 +3437,113 @@ function getIconifyCollection(set) {
 
 // src/renderer.ts
 init_tailwind();
+
+// src/fonts.ts
+var DEFAULT_FONTS = [
+  "Roboto",
+  "Open Sans",
+  "Lato",
+  "Montserrat",
+  "Poppins",
+  "Inter",
+  "Playfair Display",
+  "Raleway",
+  "Ubuntu",
+  "Nunito",
+  "Merriweather",
+  "Work Sans",
+  "Quicksand",
+  "Mulish",
+  "Manrope",
+  "DM Sans",
+  "Space Grotesk",
+  "Plus Jakarta Sans",
+  "Outfit",
+  "Sora"
+];
+var loadedFonts = /* @__PURE__ */ new Set();
+var fontsInitialized = false;
+var preconnectAdded = false;
+function addFontPreconnect() {
+  if (typeof document === "undefined" || preconnectAdded) return;
+  preconnectAdded = true;
+  if (!document.querySelector('link[href="https://fonts.googleapis.com"]')) {
+    const pc1 = document.createElement("link");
+    pc1.rel = "preconnect";
+    pc1.href = "https://fonts.googleapis.com";
+    document.head.appendChild(pc1);
+  }
+  if (!document.querySelector('link[href="https://fonts.gstatic.com"]')) {
+    const pc2 = document.createElement("link");
+    pc2.rel = "preconnect";
+    pc2.href = "https://fonts.gstatic.com";
+    pc2.crossOrigin = "anonymous";
+    document.head.appendChild(pc2);
+  }
+}
+function loadFont(family, weights = ["400", "500", "600", "700"]) {
+  if (typeof document === "undefined") return;
+  const linkId = `google-font-${family.replace(/[\s+]/g, "-").toLowerCase()}`;
+  if (document.getElementById(linkId) || loadedFonts.has(family)) {
+    return;
+  }
+  addFontPreconnect();
+  const weightsStr = weights.join(";");
+  const encodedFontName = encodeURIComponent(family).replace(/%20/g, "+");
+  const fontUrl = `https://fonts.googleapis.com/css2?family=${encodedFontName}:wght@${weightsStr}&display=swap`;
+  const link = document.createElement("link");
+  link.id = linkId;
+  link.rel = "stylesheet";
+  link.href = fontUrl;
+  document.head.appendChild(link);
+  loadedFonts.add(family);
+}
+function loadFonts(fonts, weights = ["400", "500", "600", "700"]) {
+  for (const font of fonts) {
+    loadFont(font, weights);
+  }
+}
+function loadDefaultFonts() {
+  if (fontsInitialized) return;
+  fontsInitialized = true;
+  console.log("[Servly Fonts] Loading default fonts...");
+  loadFonts(DEFAULT_FONTS);
+  console.log("[Servly Fonts] Default fonts loaded");
+}
+function isFontLoaded(family) {
+  if (typeof document === "undefined") return false;
+  const linkId = `google-font-${family.replace(/[\s+]/g, "-").toLowerCase()}`;
+  return !!document.getElementById(linkId) || loadedFonts.has(family);
+}
+function getDefaultFonts() {
+  return [...DEFAULT_FONTS];
+}
+function getLoadedFonts() {
+  return Array.from(loadedFonts);
+}
+function initFonts(config = {}) {
+  const {
+    additionalFonts = [],
+    weights = ["400", "500", "600", "700"],
+    loadDefaults = true
+  } = config;
+  addFontPreconnect();
+  if (loadDefaults) {
+    loadDefaultFonts();
+  }
+  if (additionalFonts.length > 0) {
+    loadFonts(additionalFonts, weights);
+  }
+}
+var autoInitialized = false;
+function ensureFonts() {
+  if (autoInitialized || typeof document === "undefined") return;
+  autoInitialized = true;
+  addFontPreconnect();
+  loadDefaultFonts();
+}
+
+// src/renderer.ts
 var tailwindAutoInjected = false;
 function ensureTailwind() {
   if (tailwindAutoInjected || typeof document === "undefined") return;
@@ -3382,6 +3551,7 @@ function ensureTailwind() {
   injectTailwind({ usePlayCdn: true }).catch((err) => {
     console.warn("Failed to auto-inject Tailwind CSS:", err);
   });
+  ensureFonts();
 }
 var COMPONENT_TO_TAG = {
   container: "div",
@@ -5437,6 +5607,7 @@ init_tailwind();
   StateManager,
   addClass,
   addCustomStyles,
+  addFontPreconnect,
   analytics,
   applyStyles,
   batchFetchComponents,
@@ -5462,6 +5633,7 @@ init_tailwind();
   deepMerge,
   deleteValueByPath,
   detectCircularDependencies,
+  ensureFonts,
   extractBindingKeys,
   extractDependencies,
   extractDependenciesFromCode,
@@ -5475,12 +5647,14 @@ init_tailwind();
   getAnalytics,
   getCacheKey,
   getCleanupOverrides,
+  getDefaultFonts,
   getDependencyTree,
   getEventSystem,
   getFromCache,
   getIconData,
   getIconDataSync,
   getIconifyCollection,
+  getLoadedFonts,
   getLocalStorage,
   getLongTaskObserver,
   getMemoryCacheSize,
@@ -5501,17 +5675,22 @@ init_tailwind();
   hasDependencyOverrides,
   hasOverrides,
   hasTemplateSyntax,
+  initFonts,
   initServlyTailwind,
   injectTailwind,
   injectTailwindStyles,
   invalidateCache,
   isComponentAvailable,
+  isFontLoaded,
   isIconCdnEnabled,
   isIconRegistered,
   isIconSetSupported,
   isTailwindLoaded,
   isTailwindReady,
   isValidSpecifier,
+  loadDefaultFonts,
+  loadFont,
+  loadFonts,
   markElementReady,
   navigateTo,
   parseVersion,

package/dist/index.d.cts

@@ -1822,6 +1822,55 @@ declare const DEFAULT_SERVLY_TAILWIND_CONFIG: {
 declare function initServlyTailwind(customConfig?: Record<string, any>): Promise<void>;
 declare const injectTailwindStyles: typeof initServlyTailwind;
 
+/**
+ * Google Fonts Utilities for Runtime Core
+ * Provides automatic font loading for Servly components
+ */
+/**
+ * Add preconnect links for Google Fonts (improves load performance)
+ */
+declare function addFontPreconnect(): void;
+/**
+ * Load a specific Google Font
+ */
+declare function loadFont(family: string, weights?: string[]): void;
+/**
+ * Load multiple fonts at once
+ */
+declare function loadFonts(fonts: string[], weights?: string[]): void;
+/**
+ * Load default popular fonts
+ */
+declare function loadDefaultFonts(): void;
+/**
+ * Check if a font is loaded
+ */
+declare function isFontLoaded(family: string): boolean;
+/**
+ * Get list of default fonts
+ */
+declare function getDefaultFonts(): string[];
+/**
+ * Get list of currently loaded fonts
+ */
+declare function getLoadedFonts(): string[];
+interface FontConfig {
+    /** Additional fonts to load beyond defaults */
+    additionalFonts?: string[];
+    /** Font weights to load */
+    weights?: string[];
+    /** Whether to load default fonts */
+    loadDefaults?: boolean;
+}
+/**
+ * Initialize fonts with configuration
+ */
+declare function initFonts(config?: FontConfig): void;
+/**
+ * Ensure fonts are loaded (called automatically by renderer)
+ */
+declare function ensureFonts(): void;
+
 /**
  * Overrides System for Runtime Core
  * Handles element overrides with dependency tracking
@@ -2019,4 +2068,4 @@ declare function getSupportedIconSets(): string[];
  */
 declare function getIconifyCollection(set: string): string | undefined;
 
-export { AnalyticsCollector, type AnalyticsConfig, type AnalyticsEvent, type AnalyticsEventType, type Assertion$1 as Assertion, type AssertionResult$1 as AssertionResult, type BatchEventsRequest, type BatchEventsResponse, type BindingContext, type BundleStrategy, type BundledComponent, type CacheConfig, type CacheEntry, type CacheStrategy, type ClientInfo, type ComponentBundle, type ComponentData, type ComponentRegistry, DEFAULT_CACHE_CONFIG, DEFAULT_REGISTRY_URL, DEFAULT_RETRY_CONFIG, DEFAULT_SERVLY_TAILWIND_CONFIG, type DependencyEntry, type DependencyManifest, type DependencyType, EVENT_HANDLERS, type ElementConfig, type ErrorMetadata, type ErrorType, type EventContext, type EventHandlerConfig, EventSystem, type EventSystemConfig, type FetchMetadata, type FetchOptions, type FetchResult, type IconConfig, type IconData, type IconRenderer, type LayoutElement, LongTaskObserver, MemorySampler, type NavigationOptions, type Override, type OverrideState, OverrideSystem, type OverrideSystemConfig, type ParsedVersion, type PluginExecutor, type PropDefinition, type RenderMetadata, type RenderOptions, type RenderResult, type RetryConfig, type ServlyEventHandler, type ServlyPluginAction, type SessionInfo, SessionManager, type StateChangeEvent, StateManager, type StateManagerConfig, type TailwindConfig, type AssertionResult as TestAssertionResult, type TestCase$1 as TestCase, type TestCase as TestCaseInput, type TestCaseResult, type TestResult, type TestSummary as TestRunSummary, type TestSummary$1 as TestSummary, type ViewData, addClass, addCustomStyles, analytics, applyStyles, batchFetchComponents, buildClassName, buildElementStyles, buildRegistryFromBundle, bumpVersion, camelToKebab, clearAllCaches, clearIconCache, clearLocalStorageCache, clearMemoryCache, clearStyles, collectAllDependencies, collectAllViewDependencies, compareVersions, configureAnalytics, createIconSVG, createPlaceholderIcon, createRegistry, createServlyRenderer, createViewsMap, deepMerge, deleteValueByPath, detectCircularDependencies, extractBindingKeys, extractDependencies, extractDependenciesFromCode, extractOverrideDependencies, extractReferencedViewIds, fetchComponent, fetchComponentWithDependencies, formatStyleValue, formatVersion, generateTestCases, getAnalytics, getCacheKey, getCleanupOverrides, getDependencyTree, getEventSystem, getFromCache, getIconData, getIconDataSync, getIconifyCollection, getLocalStorage, getLongTaskObserver, getMemoryCacheSize, getMemorySampler, getMountOverrides, getOverrideSystem, getRegisteredIconKeys, getRegistryUrl, getSessionManager, getSessionStorage, getSupportedIconSets, getTailwind, getUrlInfo, getValueByPath, goBack, goForward, hasClass, hasDependencyOverrides, hasOverrides, hasTemplateSyntax, initServlyTailwind, injectTailwind, injectTailwindStyles, invalidateCache, isComponentAvailable, isIconCdnEnabled, isIconRegistered, isIconSetSupported, isTailwindLoaded, isTailwindReady, isValidSpecifier, markElementReady, navigateTo, parseVersion, prefetchComponents, preloadIcons, preloadTailwind, preventFOUC, processStyles, refreshTailwind, registerIcon, registerIcons, removeClass, removeCustomStyles, removeFOUCPrevention, removeLocalStorage, removeSessionStorage, removeTailwind, render, renderDynamicList, renderIcon, renderInShadow, renderNode, resetAnalytics, resetEventSystem, resetLongTaskObserver, resetMemorySampler, resetOverrideSystem, resetSessionManager, resolveBindingPath, resolveTemplate, resolveTemplateValue, resolveTemplatesDeep, resolveVersion, runAllTests, runTestCase, satisfiesVersion, scheduleRefresh, setIconCdnEnabled, setInCache, setLocalStorage, setRegistryUrl, setSessionStorage, setValueByPath, toDomEventName, toReactEventName, toggleClass, updateStyles, updateTailwindConfig, validateAssertion, validateProps, waitForTailwind };
+export { AnalyticsCollector, type AnalyticsConfig, type AnalyticsEvent, type AnalyticsEventType, type Assertion$1 as Assertion, type AssertionResult$1 as AssertionResult, type BatchEventsRequest, type BatchEventsResponse, type BindingContext, type BundleStrategy, type BundledComponent, type CacheConfig, type CacheEntry, type CacheStrategy, type ClientInfo, type ComponentBundle, type ComponentData, type ComponentRegistry, DEFAULT_CACHE_CONFIG, DEFAULT_REGISTRY_URL, DEFAULT_RETRY_CONFIG, DEFAULT_SERVLY_TAILWIND_CONFIG, type DependencyEntry, type DependencyManifest, type DependencyType, EVENT_HANDLERS, type ElementConfig, type ErrorMetadata, type ErrorType, type EventContext, type EventHandlerConfig, EventSystem, type EventSystemConfig, type FetchMetadata, type FetchOptions, type FetchResult, type FontConfig, type IconConfig, type IconData, type IconRenderer, type LayoutElement, LongTaskObserver, MemorySampler, type NavigationOptions, type Override, type OverrideState, OverrideSystem, type OverrideSystemConfig, type ParsedVersion, type PluginExecutor, type PropDefinition, type RenderMetadata, type RenderOptions, type RenderResult, type RetryConfig, type ServlyEventHandler, type ServlyPluginAction, type SessionInfo, SessionManager, type StateChangeEvent, StateManager, type StateManagerConfig, type TailwindConfig, type AssertionResult as TestAssertionResult, type TestCase$1 as TestCase, type TestCase as TestCaseInput, type TestCaseResult, type TestResult, type TestSummary as TestRunSummary, type TestSummary$1 as TestSummary, type ViewData, addClass, addCustomStyles, addFontPreconnect, analytics, applyStyles, batchFetchComponents, buildClassName, buildElementStyles, buildRegistryFromBundle, bumpVersion, camelToKebab, clearAllCaches, clearIconCache, clearLocalStorageCache, clearMemoryCache, clearStyles, collectAllDependencies, collectAllViewDependencies, compareVersions, configureAnalytics, createIconSVG, createPlaceholderIcon, createRegistry, createServlyRenderer, createViewsMap, deepMerge, deleteValueByPath, detectCircularDependencies, ensureFonts, extractBindingKeys, extractDependencies, extractDependenciesFromCode, extractOverrideDependencies, extractReferencedViewIds, fetchComponent, fetchComponentWithDependencies, formatStyleValue, formatVersion, generateTestCases, getAnalytics, getCacheKey, getCleanupOverrides, getDefaultFonts, getDependencyTree, getEventSystem, getFromCache, getIconData, getIconDataSync, getIconifyCollection, getLoadedFonts, getLocalStorage, getLongTaskObserver, getMemoryCacheSize, getMemorySampler, getMountOverrides, getOverrideSystem, getRegisteredIconKeys, getRegistryUrl, getSessionManager, getSessionStorage, getSupportedIconSets, getTailwind, getUrlInfo, getValueByPath, goBack, goForward, hasClass, hasDependencyOverrides, hasOverrides, hasTemplateSyntax, initFonts, initServlyTailwind, injectTailwind, injectTailwindStyles, invalidateCache, isComponentAvailable, isFontLoaded, isIconCdnEnabled, isIconRegistered, isIconSetSupported, isTailwindLoaded, isTailwindReady, isValidSpecifier, loadDefaultFonts, loadFont, loadFonts, markElementReady, navigateTo, parseVersion, prefetchComponents, preloadIcons, preloadTailwind, preventFOUC, processStyles, refreshTailwind, registerIcon, registerIcons, removeClass, removeCustomStyles, removeFOUCPrevention, removeLocalStorage, removeSessionStorage, removeTailwind, render, renderDynamicList, renderIcon, renderInShadow, renderNode, resetAnalytics, resetEventSystem, resetLongTaskObserver, resetMemorySampler, resetOverrideSystem, resetSessionManager, resolveBindingPath, resolveTemplate, resolveTemplateValue, resolveTemplatesDeep, resolveVersion, runAllTests, runTestCase, satisfiesVersion, scheduleRefresh, setIconCdnEnabled, setInCache, setLocalStorage, setRegistryUrl, setSessionStorage, setValueByPath, toDomEventName, toReactEventName, toggleClass, updateStyles, updateTailwindConfig, validateAssertion, validateProps, waitForTailwind };

package/dist/index.d.ts

@@ -1822,6 +1822,55 @@ declare const DEFAULT_SERVLY_TAILWIND_CONFIG: {
 declare function initServlyTailwind(customConfig?: Record<string, any>): Promise<void>;
 declare const injectTailwindStyles: typeof initServlyTailwind;
 
+/**
+ * Google Fonts Utilities for Runtime Core
+ * Provides automatic font loading for Servly components
+ */
+/**
+ * Add preconnect links for Google Fonts (improves load performance)
+ */
+declare function addFontPreconnect(): void;
+/**
+ * Load a specific Google Font
+ */
+declare function loadFont(family: string, weights?: string[]): void;
+/**
+ * Load multiple fonts at once
+ */
+declare function loadFonts(fonts: string[], weights?: string[]): void;
+/**
+ * Load default popular fonts
+ */
+declare function loadDefaultFonts(): void;
+/**
+ * Check if a font is loaded
+ */
+declare function isFontLoaded(family: string): boolean;
+/**
+ * Get list of default fonts
+ */
+declare function getDefaultFonts(): string[];
+/**
+ * Get list of currently loaded fonts
+ */
+declare function getLoadedFonts(): string[];
+interface FontConfig {
+    /** Additional fonts to load beyond defaults */
+    additionalFonts?: string[];
+    /** Font weights to load */
+    weights?: string[];
+    /** Whether to load default fonts */
+    loadDefaults?: boolean;
+}
+/**
+ * Initialize fonts with configuration
+ */
+declare function initFonts(config?: FontConfig): void;
+/**
+ * Ensure fonts are loaded (called automatically by renderer)
+ */
+declare function ensureFonts(): void;
+
 /**
  * Overrides System for Runtime Core
  * Handles element overrides with dependency tracking
@@ -2019,4 +2068,4 @@ declare function getSupportedIconSets(): string[];
  */
 declare function getIconifyCollection(set: string): string | undefined;
 
-export { AnalyticsCollector, type AnalyticsConfig, type AnalyticsEvent, type AnalyticsEventType, type Assertion$1 as Assertion, type AssertionResult$1 as AssertionResult, type BatchEventsRequest, type BatchEventsResponse, type BindingContext, type BundleStrategy, type BundledComponent, type CacheConfig, type CacheEntry, type CacheStrategy, type ClientInfo, type ComponentBundle, type ComponentData, type ComponentRegistry, DEFAULT_CACHE_CONFIG, DEFAULT_REGISTRY_URL, DEFAULT_RETRY_CONFIG, DEFAULT_SERVLY_TAILWIND_CONFIG, type DependencyEntry, type DependencyManifest, type DependencyType, EVENT_HANDLERS, type ElementConfig, type ErrorMetadata, type ErrorType, type EventContext, type EventHandlerConfig, EventSystem, type EventSystemConfig, type FetchMetadata, type FetchOptions, type FetchResult, type IconConfig, type IconData, type IconRenderer, type LayoutElement, LongTaskObserver, MemorySampler, type NavigationOptions, type Override, type OverrideState, OverrideSystem, type OverrideSystemConfig, type ParsedVersion, type PluginExecutor, type PropDefinition, type RenderMetadata, type RenderOptions, type RenderResult, type RetryConfig, type ServlyEventHandler, type ServlyPluginAction, type SessionInfo, SessionManager, type StateChangeEvent, StateManager, type StateManagerConfig, type TailwindConfig, type AssertionResult as TestAssertionResult, type TestCase$1 as TestCase, type TestCase as TestCaseInput, type TestCaseResult, type TestResult, type TestSummary as TestRunSummary, type TestSummary$1 as TestSummary, type ViewData, addClass, addCustomStyles, analytics, applyStyles, batchFetchComponents, buildClassName, buildElementStyles, buildRegistryFromBundle, bumpVersion, camelToKebab, clearAllCaches, clearIconCache, clearLocalStorageCache, clearMemoryCache, clearStyles, collectAllDependencies, collectAllViewDependencies, compareVersions, configureAnalytics, createIconSVG, createPlaceholderIcon, createRegistry, createServlyRenderer, createViewsMap, deepMerge, deleteValueByPath, detectCircularDependencies, extractBindingKeys, extractDependencies, extractDependenciesFromCode, extractOverrideDependencies, extractReferencedViewIds, fetchComponent, fetchComponentWithDependencies, formatStyleValue, formatVersion, generateTestCases, getAnalytics, getCacheKey, getCleanupOverrides, getDependencyTree, getEventSystem, getFromCache, getIconData, getIconDataSync, getIconifyCollection, getLocalStorage, getLongTaskObserver, getMemoryCacheSize, getMemorySampler, getMountOverrides, getOverrideSystem, getRegisteredIconKeys, getRegistryUrl, getSessionManager, getSessionStorage, getSupportedIconSets, getTailwind, getUrlInfo, getValueByPath, goBack, goForward, hasClass, hasDependencyOverrides, hasOverrides, hasTemplateSyntax, initServlyTailwind, injectTailwind, injectTailwindStyles, invalidateCache, isComponentAvailable, isIconCdnEnabled, isIconRegistered, isIconSetSupported, isTailwindLoaded, isTailwindReady, isValidSpecifier, markElementReady, navigateTo, parseVersion, prefetchComponents, preloadIcons, preloadTailwind, preventFOUC, processStyles, refreshTailwind, registerIcon, registerIcons, removeClass, removeCustomStyles, removeFOUCPrevention, removeLocalStorage, removeSessionStorage, removeTailwind, render, renderDynamicList, renderIcon, renderInShadow, renderNode, resetAnalytics, resetEventSystem, resetLongTaskObserver, resetMemorySampler, resetOverrideSystem, resetSessionManager, resolveBindingPath, resolveTemplate, resolveTemplateValue, resolveTemplatesDeep, resolveVersion, runAllTests, runTestCase, satisfiesVersion, scheduleRefresh, setIconCdnEnabled, setInCache, setLocalStorage, setRegistryUrl, setSessionStorage, setValueByPath, toDomEventName, toReactEventName, toggleClass, updateStyles, updateTailwindConfig, validateAssertion, validateProps, waitForTailwind };
+export { AnalyticsCollector, type AnalyticsConfig, type AnalyticsEvent, type AnalyticsEventType, type Assertion$1 as Assertion, type AssertionResult$1 as AssertionResult, type BatchEventsRequest, type BatchEventsResponse, type BindingContext, type BundleStrategy, type BundledComponent, type CacheConfig, type CacheEntry, type CacheStrategy, type ClientInfo, type ComponentBundle, type ComponentData, type ComponentRegistry, DEFAULT_CACHE_CONFIG, DEFAULT_REGISTRY_URL, DEFAULT_RETRY_CONFIG, DEFAULT_SERVLY_TAILWIND_CONFIG, type DependencyEntry, type DependencyManifest, type DependencyType, EVENT_HANDLERS, type ElementConfig, type ErrorMetadata, type ErrorType, type EventContext, type EventHandlerConfig, EventSystem, type EventSystemConfig, type FetchMetadata, type FetchOptions, type FetchResult, type FontConfig, type IconConfig, type IconData, type IconRenderer, type LayoutElement, LongTaskObserver, MemorySampler, type NavigationOptions, type Override, type OverrideState, OverrideSystem, type OverrideSystemConfig, type ParsedVersion, type PluginExecutor, type PropDefinition, type RenderMetadata, type RenderOptions, type RenderResult, type RetryConfig, type ServlyEventHandler, type ServlyPluginAction, type SessionInfo, SessionManager, type StateChangeEvent, StateManager, type StateManagerConfig, type TailwindConfig, type AssertionResult as TestAssertionResult, type TestCase$1 as TestCase, type TestCase as TestCaseInput, type TestCaseResult, type TestResult, type TestSummary as TestRunSummary, type TestSummary$1 as TestSummary, type ViewData, addClass, addCustomStyles, addFontPreconnect, analytics, applyStyles, batchFetchComponents, buildClassName, buildElementStyles, buildRegistryFromBundle, bumpVersion, camelToKebab, clearAllCaches, clearIconCache, clearLocalStorageCache, clearMemoryCache, clearStyles, collectAllDependencies, collectAllViewDependencies, compareVersions, configureAnalytics, createIconSVG, createPlaceholderIcon, createRegistry, createServlyRenderer, createViewsMap, deepMerge, deleteValueByPath, detectCircularDependencies, ensureFonts, extractBindingKeys, extractDependencies, extractDependenciesFromCode, extractOverrideDependencies, extractReferencedViewIds, fetchComponent, fetchComponentWithDependencies, formatStyleValue, formatVersion, generateTestCases, getAnalytics, getCacheKey, getCleanupOverrides, getDefaultFonts, getDependencyTree, getEventSystem, getFromCache, getIconData, getIconDataSync, getIconifyCollection, getLoadedFonts, getLocalStorage, getLongTaskObserver, getMemoryCacheSize, getMemorySampler, getMountOverrides, getOverrideSystem, getRegisteredIconKeys, getRegistryUrl, getSessionManager, getSessionStorage, getSupportedIconSets, getTailwind, getUrlInfo, getValueByPath, goBack, goForward, hasClass, hasDependencyOverrides, hasOverrides, hasTemplateSyntax, initFonts, initServlyTailwind, injectTailwind, injectTailwindStyles, invalidateCache, isComponentAvailable, isFontLoaded, isIconCdnEnabled, isIconRegistered, isIconSetSupported, isTailwindLoaded, isTailwindReady, isValidSpecifier, loadDefaultFonts, loadFont, loadFonts, markElementReady, navigateTo, parseVersion, prefetchComponents, preloadIcons, preloadTailwind, preventFOUC, processStyles, refreshTailwind, registerIcon, registerIcons, removeClass, removeCustomStyles, removeFOUCPrevention, removeLocalStorage, removeSessionStorage, removeTailwind, render, renderDynamicList, renderIcon, renderInShadow, renderNode, resetAnalytics, resetEventSystem, resetLongTaskObserver, resetMemorySampler, resetOverrideSystem, resetSessionManager, resolveBindingPath, resolveTemplate, resolveTemplateValue, resolveTemplatesDeep, resolveVersion, runAllTests, runTestCase, satisfiesVersion, scheduleRefresh, setIconCdnEnabled, setInCache, setLocalStorage, setRegistryUrl, setSessionStorage, setValueByPath, toDomEventName, toReactEventName, toggleClass, updateStyles, updateTailwindConfig, validateAssertion, validateProps, waitForTailwind };

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   scheduleRefresh,
   updateTailwindConfig,
   waitForTailwind
-} from "./chunk-L5RPU26D.js";
+} from "./chunk-TXHGJYYM.js";
 import {
   buildRegistryFromBundle,
   collectAllDependencies,
@@ -2640,6 +2640,111 @@ function getIconifyCollection(set) {
   return ICONIFY_COLLECTIONS[set];
 }
 
+// src/fonts.ts
+var DEFAULT_FONTS = [
+  "Roboto",
+  "Open Sans",
+  "Lato",
+  "Montserrat",
+  "Poppins",
+  "Inter",
+  "Playfair Display",
+  "Raleway",
+  "Ubuntu",
+  "Nunito",
+  "Merriweather",
+  "Work Sans",
+  "Quicksand",
+  "Mulish",
+  "Manrope",
+  "DM Sans",
+  "Space Grotesk",
+  "Plus Jakarta Sans",
+  "Outfit",
+  "Sora"
+];
+var loadedFonts = /* @__PURE__ */ new Set();
+var fontsInitialized = false;
+var preconnectAdded = false;
+function addFontPreconnect() {
+  if (typeof document === "undefined" || preconnectAdded) return;
+  preconnectAdded = true;
+  if (!document.querySelector('link[href="https://fonts.googleapis.com"]')) {
+    const pc1 = document.createElement("link");
+    pc1.rel = "preconnect";
+    pc1.href = "https://fonts.googleapis.com";
+    document.head.appendChild(pc1);
+  }
+  if (!document.querySelector('link[href="https://fonts.gstatic.com"]')) {
+    const pc2 = document.createElement("link");
+    pc2.rel = "preconnect";
+    pc2.href = "https://fonts.gstatic.com";
+    pc2.crossOrigin = "anonymous";
+    document.head.appendChild(pc2);
+  }
+}
+function loadFont(family, weights = ["400", "500", "600", "700"]) {
+  if (typeof document === "undefined") return;
+  const linkId = `google-font-${family.replace(/[\s+]/g, "-").toLowerCase()}`;
+  if (document.getElementById(linkId) || loadedFonts.has(family)) {
+    return;
+  }
+  addFontPreconnect();
+  const weightsStr = weights.join(";");
+  const encodedFontName = encodeURIComponent(family).replace(/%20/g, "+");
+  const fontUrl = `https://fonts.googleapis.com/css2?family=${encodedFontName}:wght@${weightsStr}&display=swap`;
+  const link = document.createElement("link");
+  link.id = linkId;
+  link.rel = "stylesheet";
+  link.href = fontUrl;
+  document.head.appendChild(link);
+  loadedFonts.add(family);
+}
+function loadFonts(fonts, weights = ["400", "500", "600", "700"]) {
+  for (const font of fonts) {
+    loadFont(font, weights);
+  }
+}
+function loadDefaultFonts() {
+  if (fontsInitialized) return;
+  fontsInitialized = true;
+  console.log("[Servly Fonts] Loading default fonts...");
+  loadFonts(DEFAULT_FONTS);
+  console.log("[Servly Fonts] Default fonts loaded");
+}
+function isFontLoaded(family) {
+  if (typeof document === "undefined") return false;
+  const linkId = `google-font-${family.replace(/[\s+]/g, "-").toLowerCase()}`;
+  return !!document.getElementById(linkId) || loadedFonts.has(family);
+}
+function getDefaultFonts() {
+  return [...DEFAULT_FONTS];
+}
+function getLoadedFonts() {
+  return Array.from(loadedFonts);
+}
+function initFonts(config = {}) {
+  const {
+    additionalFonts = [],
+    weights = ["400", "500", "600", "700"],
+    loadDefaults = true
+  } = config;
+  addFontPreconnect();
+  if (loadDefaults) {
+    loadDefaultFonts();
+  }
+  if (additionalFonts.length > 0) {
+    loadFonts(additionalFonts, weights);
+  }
+}
+var autoInitialized = false;
+function ensureFonts() {
+  if (autoInitialized || typeof document === "undefined") return;
+  autoInitialized = true;
+  addFontPreconnect();
+  loadDefaultFonts();
+}
+
 // src/renderer.ts
 var tailwindAutoInjected = false;
 function ensureTailwind() {
@@ -2648,6 +2753,7 @@ function ensureTailwind() {
   injectTailwind({ usePlayCdn: true }).catch((err) => {
     console.warn("Failed to auto-inject Tailwind CSS:", err);
   });
+  ensureFonts();
 }
 var COMPONENT_TO_TAG = {
   container: "div",
@@ -3613,7 +3719,7 @@ async function createServlyRenderer(options) {
     container = containerOption;
   }
   if (shouldInjectTailwind) {
-    const { initServlyTailwind: initServlyTailwind2 } = await import("./tailwind-MU3YZM2C.js");
+    const { initServlyTailwind: initServlyTailwind2 } = await import("./tailwind-GU53TXCZ.js");
     await initServlyTailwind2(tailwindConfig);
   }
   const activeRenders = [];
@@ -4697,6 +4803,7 @@ export {
   StateManager,
   addClass,
   addCustomStyles,
+  addFontPreconnect,
   analytics,
   applyStyles,
   batchFetchComponents,
@@ -4722,6 +4829,7 @@ export {
   deepMerge,
   deleteValueByPath,
   detectCircularDependencies,
+  ensureFonts,
   extractBindingKeys,
   extractDependencies,
   extractDependenciesFromCode,
@@ -4735,12 +4843,14 @@ export {
   getAnalytics,
   getCacheKey,
   getCleanupOverrides,
+  getDefaultFonts,
   getDependencyTree,
   getEventSystem,
   getFromCache,
   getIconData,
   getIconDataSync,
   getIconifyCollection,
+  getLoadedFonts,
   getLocalStorage,
   getLongTaskObserver,
   getMemoryCacheSize,
@@ -4761,17 +4871,22 @@ export {
   hasDependencyOverrides,
   hasOverrides,
   hasTemplateSyntax,
+  initFonts,
   initServlyTailwind,
   injectTailwind,
   injectTailwindStyles,
   invalidateCache,
   isComponentAvailable,
+  isFontLoaded,
   isIconCdnEnabled,
   isIconRegistered,
   isIconSetSupported,
   isTailwindLoaded,
   isTailwindReady,
   isValidSpecifier,
+  loadDefaultFonts,
+  loadFont,
+  loadFonts,
   markElementReady,
   navigateTo,
   parseVersion,

package/dist/{tailwind-MU3YZM2C.js → tailwind-GU53TXCZ.js}

@@ -18,7 +18,7 @@ import {
   tailwind_default,
   updateTailwindConfig,
   waitForTailwind
-} from "./chunk-L5RPU26D.js";
+} from "./chunk-TXHGJYYM.js";
 export {
   DEFAULT_SERVLY_TAILWIND_CONFIG,
   addCustomStyles,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@servlyadmin/runtime-core",
-  "version": "0.1.42",
+  "version": "0.1.44",
   "description": "Framework-agnostic core renderer for Servly components",
   "type": "module",
   "main": "./dist/index.cjs",