@iloveagents/foundry-web-ui 0.31.0 → 0.32.0

package/dist/components/theme-runtime-provider.js

@@ -181,10 +181,43 @@ export function ThemeScope({ children, className, style, }) {
 }
 export function ThemeDocumentMetadata() {
     const runtime = useThemeRuntime();
+    const { faviconUrl, darkFaviconUrl, iconUrl, darkIconUrl, touchIconUrl } = runtime.branding;
+    const favicon = runtime.mode === "dark"
+        ? darkFaviconUrl || faviconUrl || darkIconUrl || iconUrl
+        : faviconUrl || darkFaviconUrl || iconUrl || darkIconUrl;
     useEffect(() => {
         if (typeof document === "undefined")
             return;
         document.title = runtime.branding.appTitle || runtime.branding.appName || "Foundry UI";
     }, [runtime.branding.appName, runtime.branding.appTitle]);
+    useEffect(() => {
+        if (typeof document === "undefined")
+            return;
+        const managed = [];
+        const addIcon = (rel, href) => {
+            if (!href)
+                return;
+            let resolved;
+            try {
+                resolved = new URL(href, document.baseURI);
+            }
+            catch {
+                return;
+            }
+            if (resolved.protocol !== "http:" &&
+                resolved.protocol !== "https:" &&
+                !(resolved.protocol === "data:" && /^data:image\//i.test(href)))
+                return;
+            const link = document.createElement("link");
+            link.rel = rel;
+            link.href = href;
+            link.dataset.themeIcon = "true";
+            document.head.appendChild(link);
+            managed.push(link);
+        };
+        addIcon("icon", favicon);
+        addIcon("apple-touch-icon", touchIconUrl);
+        return () => managed.forEach((link) => link.remove());
+    }, [favicon, touchIconUrl]);
     return null;
 }

package/dist/lib/theme-runtime.d.ts

@@ -118,6 +118,11 @@ export interface ThemeBranding {
      */
     iconUrl?: string;
     darkIconUrl?: string;
+    /** Browser tab icon; falls back to the compact brand icon when unset. */
+    faviconUrl?: string;
+    darkFaviconUrl?: string;
+    /** Square PNG recommended for mobile home-screen bookmarks. */
+    touchIconUrl?: string;
     /**
      * Rendered height of the mark, as a CSS length (`"2rem"`, `"32px"`).
      * Defaults to the 20px lockup height when unset.

package/dist/lib/theme-runtime.js

@@ -92,6 +92,9 @@ const BRANDING_KEYS = [
     "darkLogoUrl",
     "iconUrl",
     "darkIconUrl",
+    "faviconUrl",
+    "darkFaviconUrl",
+    "touchIconUrl",
     "logoHeight",
 ];
 const SURFACE_IMPACT = Object.fromEntries(COLOR_KEYS.map((key, index) => [key, index]));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iloveagents/foundry-web-ui",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "license": "MIT",
   "description": "React agent UI core for Foundry UI — chat, composer, AG-UI adapter for assistant-ui, tool cards, panels, sidebar, theme runtime, and UI stores.",
   "keywords": [
@@ -80,8 +80,8 @@
     "recharts": "^3.10.1",
     "remark-gfm": "^4.0.0",
     "tailwind-merge": "^3.5.0",
-    "@iloveagents/foundry-agent": "^0.31.0",
-    "@iloveagents/foundry-web-primitives": "^0.31.0"
+    "@iloveagents/foundry-agent": "^0.32.0",
+    "@iloveagents/foundry-web-primitives": "^0.32.0"
   },
   "devDependencies": {
     "@ag-ui/client": "^0.0.52",