@elizaos/agent 2.0.0-alpha.520 → 2.0.0-alpha.521

package/packages/app-core/src/test-support/test-helpers.js

@@ -1,417 +0,0 @@
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
-import { EventEmitter } from "node:events";
-import { existsSync } from "node:fs";
-import { createRequire } from "node:module";
-import path from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
-/**
- * Test helper utilities shared across unit tests.
- */
-const OPTIONAL_IMPORT_ERROR_MARKERS = [
-    "Cannot find module",
-    "Cannot find package",
-    "ERR_MODULE_NOT_FOUND",
-    "MODULE_NOT_FOUND",
-    "Dynamic require of",
-    "native addon module",
-    "Failed to resolve entry",
-    "tfjs_binding",
-    "NAPI_MODULE_NOT_FOUND",
-    "spec not found",
-];
-/** Snapshot and restore the configured environment variables around a test. */
-export function createEnvSandbox(keys) {
-    const backup = {};
-    function clear() {
-        for (const key of keys) {
-            backup[key] = process.env[key];
-            delete process.env[key];
-        }
-    }
-    function restore() {
-        for (const key of keys) {
-            if (backup[key] === undefined) {
-                delete process.env[key];
-            }
-            else {
-                process.env[key] = backup[key];
-            }
-        }
-    }
-    return { clear, restore };
-}
-/** Loose plugin-shape predicate used in dynamic test imports across suites. */
-export function looksLikePlugin(value) {
-    return (value != null &&
-        typeof value === "object" &&
-        typeof value.name === "string");
-}
-/** Extract a plugin-like object from a dynamic module export shape. */
-export function extractPlugin(mod) {
-    if (looksLikePlugin(mod.default))
-        return mod.default;
-    if (looksLikePlugin(mod.plugin))
-        return mod.plugin;
-    if (looksLikePlugin(mod))
-        return mod;
-    for (const key of Object.keys(mod)) {
-        if (key === "default" || key === "plugin")
-            continue;
-        if (looksLikePlugin(mod[key]))
-            return mod[key];
-    }
-    return null;
-}
-/** Check whether a package name can be resolved for dynamic import. */
-export function isPackageImportResolvable(packageName) {
-    const require = createRequire(import.meta.url);
-    try {
-        require.resolve(packageName);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/** Check whether a dependency specifier should be treated as a workspace-local version. */
-export function isWorkspaceDependency(version) {
-    return (typeof version === "string" &&
-        (version.startsWith(".") || version.startsWith("workspace:")));
-}
-const DISCORD_PLUGIN_PACKAGE_NAME = "@elizaos/plugin-discord";
-const DISCORD_PLUGIN_LOCAL_ENTRY_CANDIDATES = [
-    "../plugins/plugin-discord/typescript/dist/index",
-    "../plugins/plugin-discord/dist/index",
-];
-/**
- * Resolve the Discord plugin import specifier.
- * Prefers package resolution, then falls back to local plugin checkout paths.
- */
-export function resolveDiscordPluginImportSpecifier() {
-    if (isPackageImportResolvable(DISCORD_PLUGIN_PACKAGE_NAME)) {
-        return DISCORD_PLUGIN_PACKAGE_NAME;
-    }
-    const helperDir = path.dirname(fileURLToPath(import.meta.url));
-    const packageRoot = path.resolve(helperDir, "..", "..");
-    for (const relativeEntryPath of DISCORD_PLUGIN_LOCAL_ENTRY_CANDIDATES) {
-        const absoluteEntryPath = path.resolve(packageRoot, relativeEntryPath);
-        if (existsSync(absoluteEntryPath)) {
-            return pathToFileURL(absoluteEntryPath).href;
-        }
-    }
-    return null;
-}
-const TELEGRAM_PLUGIN_PACKAGE_NAME = "@elizaos/plugin-telegram";
-const TELEGRAM_PLUGIN_LOCAL_ENTRY_CANDIDATES = [
-    "../plugins/plugin-telegram/typescript/dist/index",
-    "../plugins/plugin-telegram/dist/index",
-];
-/**
- * Resolve the Telegram plugin import specifier.
- * Prefers package resolution, then falls back to node_modules ESM entry
- * (the telegram plugin is ESM-only so CJS require.resolve fails), then
- * falls back to local plugin checkout paths.
- */
-export function resolveTelegramPluginImportSpecifier() {
-    if (isPackageImportResolvable(TELEGRAM_PLUGIN_PACKAGE_NAME)) {
-        return TELEGRAM_PLUGIN_PACKAGE_NAME;
-    }
-    const helperDir = path.dirname(fileURLToPath(import.meta.url));
-    const packageRoot = path.resolve(helperDir, "..", "..");
-    // ESM-only: try direct node_modules entry
-    const nodeModulesEntry = path.resolve(packageRoot, "node_modules", "@elizaos", "plugin-telegram", "dist", "index.js");
-    if (existsSync(nodeModulesEntry)) {
-        return pathToFileURL(nodeModulesEntry).href;
-    }
-    for (const relativeEntryPath of TELEGRAM_PLUGIN_LOCAL_ENTRY_CANDIDATES) {
-        const absoluteEntryPath = path.resolve(packageRoot, relativeEntryPath);
-        if (existsSync(absoluteEntryPath)) {
-            return pathToFileURL(absoluteEntryPath).href;
-        }
-    }
-    return null;
-}
-const LENS_PLUGIN_PACKAGE_NAME = "@elizaos/plugin-lens";
-const LENS_PLUGIN_FALLBACK_PACKAGE = "@elizaos-plugins/client-lens";
-const LENS_PLUGIN_LOCAL_ENTRY_CANDIDATES = [
-    "../plugins/plugin-lens/typescript/dist/index",
-    "../plugins/plugin-lens/dist/index",
-    "../../client-lens/dist/index",
-    "../../client-lens/src/index",
-];
-/**
- * Resolve the Lens plugin import specifier.
- * Prefers package resolution, then falls back to local plugin checkout paths.
- * Uses both CJS require.resolve and a direct node_modules check for ESM-only packages.
- */
-export function resolveLensPluginImportSpecifier() {
-    if (isPackageImportResolvable(LENS_PLUGIN_PACKAGE_NAME)) {
-        return LENS_PLUGIN_PACKAGE_NAME;
-    }
-    if (isPackageImportResolvable(LENS_PLUGIN_FALLBACK_PACKAGE)) {
-        return LENS_PLUGIN_FALLBACK_PACKAGE;
-    }
-    const helperDir = path.dirname(fileURLToPath(import.meta.url));
-    const packageRoot = path.resolve(helperDir, "..", "..");
-    const nodeModulesSourceEntry = path.resolve(packageRoot, "node_modules", "@elizaos-plugins", "client-lens", "src", "index.ts");
-    if (existsSync(nodeModulesSourceEntry)) {
-        return pathToFileURL(nodeModulesSourceEntry).href;
-    }
-    const nodeModulesDistEntry = path.resolve(packageRoot, "node_modules", "@elizaos-plugins", "client-lens", "dist", "index.js");
-    if (existsSync(nodeModulesDistEntry)) {
-        return pathToFileURL(nodeModulesDistEntry).href;
-    }
-    for (const relativeEntryPath of LENS_PLUGIN_LOCAL_ENTRY_CANDIDATES) {
-        const absoluteEntryPath = path.resolve(packageRoot, relativeEntryPath);
-        if (existsSync(absoluteEntryPath)) {
-            return pathToFileURL(absoluteEntryPath).href;
-        }
-    }
-    return null;
-}
-const FARCASTER_PLUGIN_PACKAGE_NAME = "@elizaos/plugin-farcaster";
-const FARCASTER_PLUGIN_LOCAL_ENTRY_CANDIDATES = [
-    "../plugins/plugin-farcaster/typescript/dist/index",
-    "../plugins/plugin-farcaster/dist/index",
-];
-/**
- * Resolve the Farcaster plugin import specifier.
- * Prefers package resolution, then falls back to local plugin checkout paths.
- */
-export function resolveFarcasterPluginImportSpecifier() {
-    if (isPackageImportResolvable(FARCASTER_PLUGIN_PACKAGE_NAME)) {
-        return FARCASTER_PLUGIN_PACKAGE_NAME;
-    }
-    const helperDir = path.dirname(fileURLToPath(import.meta.url));
-    const packageRoot = path.resolve(helperDir, "..", "..");
-    for (const relativeEntryPath of FARCASTER_PLUGIN_LOCAL_ENTRY_CANDIDATES) {
-        const absoluteEntryPath = path.resolve(packageRoot, relativeEntryPath);
-        if (existsSync(absoluteEntryPath)) {
-            return pathToFileURL(absoluteEntryPath).href;
-        }
-    }
-    return null;
-}
-const NOSTR_PLUGIN_PACKAGE_NAME = "@elizaos/plugin-nostr";
-const NOSTR_PLUGIN_LOCAL_ENTRY_CANDIDATES = [
-    "../plugins/plugin-nostr/typescript/dist/index",
-    "../plugins/plugin-nostr/dist/index",
-];
-/**
- * Resolve the Nostr plugin import specifier.
- * Prefers package resolution, then falls back to local plugin checkout paths.
- */
-export function resolveNostrPluginImportSpecifier() {
-    if (isPackageImportResolvable(NOSTR_PLUGIN_PACKAGE_NAME)) {
-        return NOSTR_PLUGIN_PACKAGE_NAME;
-    }
-    const helperDir = path.dirname(fileURLToPath(import.meta.url));
-    const packageRoot = path.resolve(helperDir, "..", "..");
-    for (const relativeEntryPath of NOSTR_PLUGIN_LOCAL_ENTRY_CANDIDATES) {
-        const absoluteEntryPath = path.resolve(packageRoot, relativeEntryPath);
-        if (existsSync(absoluteEntryPath)) {
-            return pathToFileURL(absoluteEntryPath).href;
-        }
-    }
-    return null;
-}
-const MATRIX_PLUGIN_PACKAGE_NAME = "@elizaos/plugin-matrix";
-const MATRIX_PLUGIN_LOCAL_ENTRY_CANDIDATES = [
-    "../plugins/plugin-matrix/typescript/dist/index",
-    "../plugins/plugin-matrix/dist/index",
-];
-/**
- * Resolve the Matrix plugin import specifier.
- * Prefers package resolution, then falls back to local plugin checkout paths.
- */
-export function resolveMatrixPluginImportSpecifier() {
-    if (isPackageImportResolvable(MATRIX_PLUGIN_PACKAGE_NAME)) {
-        return MATRIX_PLUGIN_PACKAGE_NAME;
-    }
-    const helperDir = path.dirname(fileURLToPath(import.meta.url));
-    const packageRoot = path.resolve(helperDir, "..", "..");
-    for (const relativeEntryPath of MATRIX_PLUGIN_LOCAL_ENTRY_CANDIDATES) {
-        const absoluteEntryPath = path.resolve(packageRoot, relativeEntryPath);
-        if (existsSync(absoluteEntryPath)) {
-            return pathToFileURL(absoluteEntryPath).href;
-        }
-    }
-    return null;
-}
-const FEISHU_PLUGIN_PACKAGE_NAME = "@elizaos/plugin-feishu";
-const FEISHU_PLUGIN_LOCAL_ENTRY_CANDIDATES = [
-    "../plugins/plugin-feishu/typescript/dist/index",
-    "../plugins/plugin-feishu/dist/index",
-];
-/**
- * Resolve the Feishu plugin import specifier.
- * Prefers package resolution, then falls back to local plugin checkout paths.
- */
-export function resolveFeishuPluginImportSpecifier() {
-    if (isPackageImportResolvable(FEISHU_PLUGIN_PACKAGE_NAME)) {
-        return FEISHU_PLUGIN_PACKAGE_NAME;
-    }
-    const helperDir = path.dirname(fileURLToPath(import.meta.url));
-    const packageRoot = path.resolve(helperDir, "..", "..");
-    const nodeModulesDistEntry = path.resolve(packageRoot, "node_modules", "@elizaos", "plugin-feishu", "dist", "index.js");
-    if (existsSync(nodeModulesDistEntry)) {
-        return pathToFileURL(nodeModulesDistEntry).href;
-    }
-    for (const relativeEntryPath of FEISHU_PLUGIN_LOCAL_ENTRY_CANDIDATES) {
-        const absoluteEntryPath = path.resolve(packageRoot, relativeEntryPath);
-        if (existsSync(absoluteEntryPath)) {
-            return pathToFileURL(absoluteEntryPath).href;
-        }
-    }
-    return null;
-}
-const WECHAT_PLUGIN_PACKAGE_NAME = "@elizaos/plugin-wechat";
-const WECHAT_PLUGIN_LEGACY_PACKAGE_NAME = "@miladyai/plugin-wechat";
-const WECHAT_PLUGIN_LOCAL_ENTRY_CANDIDATES = [
-    "src/index.ts",
-    "dist/index.js",
-];
-export function resolveWechatPluginImportSpecifier() {
-    if (isPackageImportResolvable(WECHAT_PLUGIN_PACKAGE_NAME)) {
-        return WECHAT_PLUGIN_PACKAGE_NAME;
-    }
-    if (isPackageImportResolvable(WECHAT_PLUGIN_LEGACY_PACKAGE_NAME)) {
-        return WECHAT_PLUGIN_LEGACY_PACKAGE_NAME;
-    }
-    const helperDir = path.dirname(fileURLToPath(import.meta.url));
-    const packageRoot = path.resolve(helperDir, "..", "..");
-    // Check node_modules for either the canonical or legacy package name.
-    for (const packageName of [
-        WECHAT_PLUGIN_PACKAGE_NAME,
-        WECHAT_PLUGIN_LEGACY_PACKAGE_NAME,
-    ]) {
-        const packageSegments = packageName.split("/");
-        for (const relativeEntryPath of WECHAT_PLUGIN_LOCAL_ENTRY_CANDIDATES) {
-            const nodeModulesEntry = path.resolve(packageRoot, "node_modules", ...packageSegments, relativeEntryPath);
-            if (existsSync(nodeModulesEntry)) {
-                return pathToFileURL(nodeModulesEntry).href;
-            }
-        }
-    }
-    for (const relativeEntryPath of WECHAT_PLUGIN_LOCAL_ENTRY_CANDIDATES) {
-        const nodeModulesEntry = path.resolve(packageRoot, "node_modules", "@elizaos", "plugin-wechat", relativeEntryPath);
-        if (existsSync(nodeModulesEntry)) {
-            return pathToFileURL(nodeModulesEntry).href;
-        }
-    }
-    return null;
-}
-/** Build a mock update check result with deterministic defaults. */
-export function buildMockUpdateCheckResult(overrides = {}) {
-    return {
-        updateAvailable: false,
-        currentVersion: "2.0.0",
-        latestVersion: "2.0.0",
-        channel: "stable",
-        distTag: "latest",
-        cached: false,
-        error: null,
-        ...overrides,
-    };
-}
-/** Small utility to wait for asynchronous side-effects in tests. */
-export function waitMs(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-/** Create a lightweight mocked HTTP response used by handler tests. */
-export function createMockHttpResponse() {
-    let statusCode = 200;
-    let legacyStatus = 0;
-    let payload = "";
-    const res = {
-        set statusCode(value) {
-            statusCode = value;
-            legacyStatus = value;
-        },
-        get statusCode() {
-            return statusCode;
-        },
-        _status: legacyStatus,
-        _body: payload,
-        setHeader: () => undefined,
-        writeHead: (value) => {
-            statusCode = value;
-            legacyStatus = value;
-        },
-        end: (chunk) => {
-            payload = chunk ? chunk.toString() : "";
-            res._body = payload;
-            legacyStatus = statusCode;
-            res._status = legacyStatus;
-        },
-    };
-    return {
-        res,
-        getStatus: () => statusCode,
-        getJson: () => (payload ? JSON.parse(payload) : null),
-    };
-}
-export function createMockHeadersRequest(headers = {}, options = {}) {
-    return createMockIncomingMessage({
-        ...options,
-        headers,
-    });
-}
-export function createMockIncomingMessage({ method = "GET", url = "/", headers = { host: "localhost:2138" }, body, bodyChunks, json = false, }) {
-    const req = new EventEmitter();
-    req.method = method;
-    req.url = url;
-    req.headers = headers;
-    req.destroy = ((_) => req);
-    const chunks = [];
-    if (bodyChunks !== undefined) {
-        for (const chunk of bodyChunks) {
-            chunks.push(typeof chunk === "string" ? Buffer.from(chunk, "utf-8") : chunk);
-        }
-    }
-    else if (body !== undefined) {
-        const encoded = typeof body === "string"
-            ? Buffer.from(body, "utf-8")
-            : body instanceof Buffer
-                ? body
-                : json
-                    ? Buffer.from(JSON.stringify(body), "utf-8")
-                    : Buffer.from(String(body), "utf-8");
-        chunks.push(encoded);
-    }
-    for (const chunk of chunks) {
-        queueMicrotask(() => req.emit("data", chunk));
-    }
-    queueMicrotask(() => req.emit("end"));
-    return req;
-}
-export function createMockJsonRequest(body, options = {}) {
-    return createMockIncomingMessage({
-        ...options,
-        body,
-        json: true,
-    });
-}
-/** Return true when optional plugin imports are intentionally unavailable in this env. */
-export function isOptionalImportError(error, extraMarkers = []) {
-    const message = error instanceof Error ? error.message : String(error);
-    return OPTIONAL_IMPORT_ERROR_MARKERS.concat(extraMarkers).some((marker) => message.includes(marker));
-}
-/** Safely import optional plugin modules while allowing hard failures to bubble. */
-export async function tryOptionalDynamicImport(moduleName, markers) {
-    try {
-        return (await import(__rewriteRelativeImportExtension(moduleName)));
-    }
-    catch (error) {
-        if (isOptionalImportError(error, markers))
-            return null;
-        throw error;
-    }
-}

package/packages/app-core/src/themes/apply-theme.d.ts

@@ -1,24 +0,0 @@
-/**
- * Theme application engine.
- *
- * Applies a ThemeDefinition to the document root by setting CSS custom
- * properties. Works with the existing Tailwind @theme inline mapping
- * in styles.css — changing CSS vars automatically updates Tailwind tokens.
- */
-import { type ThemeDefinition } from "@elizaos/shared";
-/**
- * Apply a theme's color set for the given mode to the document root.
- * Returns a cleanup function that removes all applied properties.
- */
-export declare function applyThemeToDocument(theme: ThemeDefinition, mode: "light" | "dark"): () => void;
-/**
- * Remove all theme-applied CSS custom properties from the document root,
- * restoring base.css defaults.
- */
-export declare function clearThemeOverrides(): void;
-/**
- * Resolve a theme ID to a ThemeDefinition from the built-in set,
- * or return undefined if not found.
- */
-export declare function resolveBuiltinTheme(themeId: string): ThemeDefinition | undefined;
-//# sourceMappingURL=apply-theme.d.ts.map

package/packages/app-core/src/themes/apply-theme.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"apply-theme.d.ts","sourceRoot":"","sources":["../../../../../../app-core/src/themes/apply-theme.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,iBAAiB,CAAC;AAEzB;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,MAAM,IAAI,CA4CZ;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAiB1C;AA6DD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GACd,eAAe,GAAG,SAAS,CAE7B"}

package/packages/app-core/src/themes/apply-theme.js

@@ -1,130 +0,0 @@
-/**
- * Theme application engine.
- *
- * Applies a ThemeDefinition to the document root by setting CSS custom
- * properties. Works with the existing Tailwind @theme inline mapping
- * in styles.css — changing CSS vars automatically updates Tailwind tokens.
- */
-import { BUILTIN_THEMES, THEME_CSS_VAR_MAP, THEME_FONT_CSS_VARS, THEME_FONT_LINK_ID, } from "@elizaos/shared";
-/**
- * Apply a theme's color set for the given mode to the document root.
- * Returns a cleanup function that removes all applied properties.
- */
-export function applyThemeToDocument(theme, mode) {
-    if (typeof document === "undefined")
-        return () => { };
-    const root = document.documentElement;
-    const colorSet = mode === "dark" ? theme.dark : theme.light;
-    const applied = [];
-    // Apply color tokens
-    for (const [key, cssVar] of Object.entries(THEME_CSS_VAR_MAP)) {
-        const value = colorSet[key];
-        if (value != null) {
-            root.style.setProperty(cssVar, value);
-            applied.push(cssVar);
-        }
-    }
-    // Keep --txt in sync with --text (it's an alias consumed by Tailwind)
-    if (colorSet.text != null) {
-        root.style.setProperty("--txt", colorSet.text);
-        applied.push("--txt");
-    }
-    // Keep --primary/--primary-foreground in sync if not explicitly set
-    // (most themes share accent = primary)
-    if (colorSet.accent != null && colorSet.primary == null) {
-        root.style.setProperty("--primary", colorSet.accent);
-        applied.push("--primary");
-    }
-    if (colorSet.accentForeground != null && colorSet.primaryForeground == null) {
-        root.style.setProperty("--primary-foreground", colorSet.accentForeground);
-        applied.push("--primary-foreground");
-    }
-    // Apply fonts
-    if (theme.fonts) {
-        applyThemeFonts(theme.fonts, applied);
-    }
-    return () => {
-        for (const cssVar of applied) {
-            root.style.removeProperty(cssVar);
-        }
-        removeFontLink();
-    };
-}
-/**
- * Remove all theme-applied CSS custom properties from the document root,
- * restoring base.css defaults.
- */
-export function clearThemeOverrides() {
-    if (typeof document === "undefined")
-        return;
-    const root = document.documentElement;
-    for (const cssVar of Object.values(THEME_CSS_VAR_MAP)) {
-        root.style.removeProperty(cssVar);
-    }
-    // Aliases
-    root.style.removeProperty("--txt");
-    // Font vars
-    for (const cssVar of Object.values(THEME_FONT_CSS_VARS)) {
-        root.style.removeProperty(cssVar);
-    }
-    removeFontLink();
-}
-// ── Font helpers ───────────────────────────────────────────────────
-function applyThemeFonts(fonts, applied) {
-    if (typeof document === "undefined")
-        return;
-    const root = document.documentElement;
-    if (fonts.body) {
-        root.style.setProperty(THEME_FONT_CSS_VARS.body, fonts.body);
-        applied.push(THEME_FONT_CSS_VARS.body);
-    }
-    if (fonts.display) {
-        root.style.setProperty(THEME_FONT_CSS_VARS.display, fonts.display);
-        applied.push(THEME_FONT_CSS_VARS.display);
-    }
-    if (fonts.chat) {
-        root.style.setProperty(THEME_FONT_CSS_VARS.chat, fonts.chat);
-        applied.push(THEME_FONT_CSS_VARS.chat);
-    }
-    if (fonts.mono) {
-        root.style.setProperty(THEME_FONT_CSS_VARS.mono, fonts.mono);
-        applied.push(THEME_FONT_CSS_VARS.mono);
-    }
-    // Inject external font stylesheet
-    if (fonts.fontImportUrl) {
-        injectFontLink(fonts.fontImportUrl);
-    }
-    else {
-        removeFontLink();
-    }
-}
-function injectFontLink(url) {
-    if (typeof document === "undefined")
-        return;
-    const existing = document.getElementById(THEME_FONT_LINK_ID);
-    if (existing instanceof HTMLLinkElement && existing.href === url) {
-        return; // already loaded
-    }
-    // Remove stale link first
-    existing?.remove();
-    const link = document.createElement("link");
-    link.id = THEME_FONT_LINK_ID;
-    link.rel = "stylesheet";
-    link.href = url;
-    // Ensure content renders with fallback fonts while loading
-    link.media = "all";
-    document.head.appendChild(link);
-}
-function removeFontLink() {
-    if (typeof document === "undefined")
-        return;
-    document.getElementById(THEME_FONT_LINK_ID)?.remove();
-}
-// ── Theme resolution helper ────────────────────────────────────────
-/**
- * Resolve a theme ID to a ThemeDefinition from the built-in set,
- * or return undefined if not found.
- */
-export function resolveBuiltinTheme(themeId) {
-    return BUILTIN_THEMES.find((t) => t.id === themeId);
-}