@lukoweb/apitogo 0.2.22 → 0.2.24

package/src/vite/plugin-theme.ts

@@ -1,458 +1,458 @@
-import { createRequire } from "node:module";
-import path from "node:path";
-import { normalizeTheme, type ThemeRegistration } from "shiki";
-import type { Plugin } from "vite";
-import type { ConfigWithMeta } from "../config/loader.js";
-import { getCurrentConfig } from "../config/loader.js";
-import type {
-  FontConfig,
-  ZudokuConfig,
-} from "../config/validators/ZudokuConfig.js";
-import { defaultHighlightOptions } from "../lib/shiki.js";
-import { objectEntries } from "../lib/util/objectEntries.js";
-import {
-  fetchShadcnRegistryItem,
-  type RegistryItemCss,
-} from "./shadcn-registry.js";
-
-// prettier-ignore
-const THEME_VARIABLES = [
-  "background", "foreground", "card", "cardForeground", "popover", "popoverForeground", "primary",
-  "primaryForeground", "secondary", "secondaryForeground", "muted", "mutedForeground", "accent",
-  "accentForeground", "destructive", "destructiveForeground", "border", "input", "ring", "radius",
-] as const;
-
-const uncamelize = (str: string) =>
-  str.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
-
-export type Theme = Partial<Record<(typeof THEME_VARIABLES)[number], string>>;
-
-const processColorValue = (value: string | undefined): string => {
-  if (!value) return "";
-  const color =
-    !value.startsWith("#") &&
-    !value.includes("(") &&
-    value.split(" ").length >= 3
-      ? // Assume legacy tailwind hsl format
-        `hsl(${value})`
-      : value;
-
-  return color;
-};
-
-const generateCss = (theme: Theme) =>
-  objectEntries(theme)
-    .filter(([key]) => THEME_VARIABLES.includes(key))
-    .map(([key, value]) => `--${uncamelize(key)}: ${processColorValue(value)};`)
-    .join("\n");
-
-const generateRegistryCss = (cssVars: Record<string, string>) =>
-  Object.entries(cssVars)
-    .map(([key, value]) => `  --${key}: ${value};`)
-    .join("\n");
-
-const processCustomCss = (css: string | RegistryItemCss): string => {
-  if (typeof css === "string") {
-    return css;
-  }
-
-  const processStyles = (
-    styles: RegistryItemCss | string,
-    indent = "",
-  ): string[] => {
-    if (typeof styles === "string") {
-      return [`${indent}${styles}`];
-    }
-
-    const rules = [];
-    for (const [key, value] of Object.entries(styles)) {
-      if (typeof value === "string") {
-        rules.push(`${indent}${key}: ${value};`);
-      } else {
-        rules.push(`${indent}${key} {`);
-        rules.push(...processStyles(value, `${indent}  `));
-        rules.push(`${indent}}`);
-      }
-    }
-    return rules;
-  };
-
-  return processStyles(css).join("\n");
-};
-
-const MAIN_REPLACE = "/* @vite-plugin-inject main */";
-const DEFAULT_THEME_REPLACE = "/* @vite-plugin-inject defaultTheme */";
-
-// prettier-ignore
-export const GOOGLE_FONTS = [
-  "Inter", "Roboto", "Open Sans", "Poppins", "Montserrat", "Outfit",
-  "Plus Jakarta Sans", "DM Sans", "IBM Plex Sans", "Geist", "Oxanium",
-  "Architects Daughter", "Merriweather", "Playfair Display", "Lora",
-  "Source Serif Pro", "Libre Baskerville", "Space Grotesk", "JetBrains Mono",
-  "Fira Code", "Source Code Pro", "IBM Plex Mono", "Roboto Mono", "Space Mono", "Geist Mono",
-] as const;
-type GoogleFont = (typeof GOOGLE_FONTS)[number];
-
-const getGoogleFontUrl = (font: string) =>
-  `https://fonts.googleapis.com/css2?family=${font.replaceAll(/\s+/g, "+")}:wght@400;500;600;700&display=swap`;
-
-const processFont = (fontValue: string) => {
-  const families = fontValue
-    .split(",")
-    .map((f) => f.trim().replaceAll(/['"]/g, ""));
-
-  return families
-    .filter((family) => GOOGLE_FONTS.includes(family as GoogleFont))
-    .map((family) => getGoogleFontUrl(family));
-};
-
-const processFontConfig = (fontConfig?: FontConfig) => {
-  if (!fontConfig) return { url: undefined, fontFamily: undefined };
-
-  if (typeof fontConfig === "string") {
-    if (GOOGLE_FONTS.includes(fontConfig as GoogleFont)) {
-      return {
-        url: getGoogleFontUrl(fontConfig),
-        fontFamily: fontConfig,
-      };
-    }
-    return { url: undefined, fontFamily: fontConfig };
-  }
-
-  return {
-    url: fontConfig.url,
-    fontFamily: fontConfig.fontFamily,
-  };
-};
-
-/**
- * The default fonts ship inside the portal (Latin subset, four weights) so a first paint makes no third-party
- * request. Fonts a tenant picks by name still load from Google Fonts: that is their explicit choice.
- */
-const bundledFont = (pkg: string) => {
-  // Absolute paths: the CSS is compiled from the site root, which does not see this package's dependencies.
-  const dir = path.dirname(
-    createRequire(import.meta.url).resolve(`@fontsource/${pkg}/package.json`),
-  );
-  return [400, 500, 600, 700].map((weight) =>
-    path.join(dir, `latin-${weight}.css`).split(path.sep).join("/"),
-  );
-};
-
-const DEFAULT_FONT_SANS = '"IBM Plex Sans", system-ui, sans-serif';
-const DEFAULT_FONT_MONO = '"JetBrains Mono", monospace';
-const DEFAULT_FONT_HEADING = '"Space Grotesk", system-ui, sans-serif';
-
-const processFonts = async (themeConfig: ZudokuConfig["theme"]) => {
-  const imports: string[] = [];
-  const bundled: string[] = [];
-  const families = {
-    sans: DEFAULT_FONT_SANS,
-    serif: undefined as string | undefined,
-    mono: DEFAULT_FONT_MONO,
-    heading: DEFAULT_FONT_HEADING,
-  };
-
-  // Process user fonts
-  const userFonts = {
-    sans: processFontConfig(themeConfig?.fonts?.sans),
-    serif: processFontConfig(themeConfig?.fonts?.serif),
-    mono: processFontConfig(themeConfig?.fonts?.mono),
-  };
-
-  // Add user font imports
-  for (const font of Object.values(userFonts)) {
-    if (font.url) {
-      imports.push(font.url);
-    }
-  }
-
-  // Process registry fonts if available
-  let registryFonts = {
-    sans: undefined as string | undefined,
-    serif: undefined as string | undefined,
-    mono: undefined as string | undefined,
-  };
-
-  if (themeConfig?.registryUrl) {
-    try {
-      const registryItem = await fetchShadcnRegistryItem(
-        themeConfig.registryUrl,
-      );
-      const { cssVars = {} } = registryItem;
-      const { theme: regThemeVars = {}, light: regLightVars = {} } = cssVars;
-
-      registryFonts = {
-        sans: regLightVars["font-sans"] ?? regThemeVars["font-sans"],
-        serif: regLightVars["font-serif"] ?? regThemeVars["font-serif"],
-        mono: regLightVars["font-mono"] ?? regThemeVars["font-mono"],
-      };
-
-      // Add registry font imports
-      for (const font of Object.values(registryFonts)) {
-        if (font) {
-          imports.push(...processFont(font));
-        }
-      }
-    } catch {
-      // Registry fonts failed to load, continue with user fonts and defaults
-    }
-  }
-
-  // Determine final font families with priority: user > registry > defaults
-  families.sans =
-    userFonts.sans.fontFamily || registryFonts.sans || DEFAULT_FONT_SANS;
-  families.serif = userFonts.serif.fontFamily || registryFonts.serif;
-  families.mono =
-    userFonts.mono.fontFamily || registryFonts.mono || DEFAULT_FONT_MONO;
-
-  // Add default font imports if no user or registry fonts
-  if (!userFonts.sans.fontFamily && !registryFonts.sans) {
-    bundled.push(...bundledFont("ibm-plex-sans"));
-  }
-  if (!userFonts.mono.fontFamily && !registryFonts.mono) {
-    bundled.push(...bundledFont("jetbrains-mono"));
-  }
-  bundled.push(...bundledFont("space-grotesk"));
-
-  return { imports, bundled, families };
-};
-
-const MODULE_SOURCE_PACKAGES = [
-  "@lukoweb/apitogo-module-landing",
-  "@lukoweb/apitogo-module-user-panel",
-];
-
-/**
- * Directories of module packages (landing, user panel) that use Tailwind
- * utility classes. They live outside the Tailwind `source("..")` root set in
- * main.css, so they must be added as explicit `@source` scan paths — otherwise
- * their arbitrary-value utilities (e.g. the landing hero grid template and
- * terminal card colors) are missing from the generated CSS.
- */
-const resolveModuleSourceDirs = (config: ConfigWithMeta): string[] => {
-  if (config.__meta.mode === "internal") {
-    return MODULE_SOURCE_PACKAGES.map((pkg) =>
-      path.join(
-        config.__meta.moduleDir,
-        "..",
-        pkg.replace("@lukoweb/apitogo-", ""),
-        "src",
-      ),
-    );
-  }
-
-  const require = createRequire(
-    path.join(config.__meta.rootDir, "package.json"),
-  );
-  const dirs: string[] = [];
-  for (const pkg of MODULE_SOURCE_PACKAGES) {
-    try {
-      dirs.push(path.dirname(require.resolve(pkg)));
-    } catch {
-      // Module package not installed — nothing to scan.
-    }
-  }
-  return dirs;
-};
-
-export const virtualModuleId = "virtual:zudoku-theme.css";
-export const resolvedVirtualModuleId = `\0${virtualModuleId}`;
-
-export const viteThemePlugin = (): Plugin => {
-  return {
-    // It is important to run before the Tailwind plugin
-    enforce: "pre",
-    name: "zudoku-css-theme",
-
-    resolveId(id) {
-      if (id === "virtual:zudoku-theme.css") {
-        return resolvedVirtualModuleId;
-      }
-    },
-    // Handle the virtual module for dynamic theme content
-    async load(id) {
-      if (id !== resolvedVirtualModuleId) return;
-
-      const config = getCurrentConfig();
-
-      const themeConfig = config.theme ?? {};
-      const themeCss: string[] = [];
-
-      // Consolidate all font processing
-      const fonts = await processFonts(themeConfig);
-
-      // Add all font imports at once
-      themeCss.push(
-        ...fonts.bundled.map((specifier) => `@import '${specifier}';`),
-        ...fonts.imports.map((url) => `@import url('${url}');`),
-      );
-
-      // Handle registry theme variables
-      if (themeConfig.registryUrl) {
-        try {
-          const registryItem = await fetchShadcnRegistryItem(
-            themeConfig.registryUrl,
-          );
-
-          // Extract theme variables from registry
-          const { cssVars = {}, css = {} } = registryItem;
-          const { light: regLightVars = {}, dark: regDarkVars = {} } = cssVars;
-
-          // Process custom CSS from registry
-          if (Object.keys(css).length > 0) {
-            themeCss.push(processCustomCss(css));
-          }
-
-          // Merge registry variables with user overrides
-          const applyOverrides = (
-            vars: Record<string, string>,
-            overrides?: Theme,
-          ) => {
-            if (!overrides) return vars;
-
-            const result = { ...vars };
-            for (const [key, value] of objectEntries(overrides)) {
-              if (value && THEME_VARIABLES.includes(key)) {
-                result[uncamelize(key)] = processColorValue(value);
-              }
-            }
-            return result;
-          };
-
-          const lightVars = applyOverrides(regLightVars, themeConfig.light);
-          const darkVars = applyOverrides(regDarkVars, themeConfig.dark);
-
-          // Generate CSS for light and dark themes
-          if (Object.keys(lightVars).length > 0) {
-            themeCss.push(`:root {\n${generateRegistryCss(lightVars)}\n}`);
-          }
-
-          if (Object.keys(darkVars).length > 0) {
-            themeCss.push(`.dark {\n${generateRegistryCss(darkVars)}\n}`);
-          }
-
-          if (lightVars["letter-spacing"] !== "0em") {
-            themeCss.push(
-              "@theme inline {",
-              "  --tracking-tighter: calc(var(--tracking-normal) - 0.05em);",
-              "  --tracking-tight: calc(var(--tracking-normal) - 0.025em);",
-              "  --tracking-normal: var(--tracking-normal);",
-              "  --tracking-wide: calc(var(--tracking-normal) + 0.025em);",
-              "  --tracking-wider: calc(var(--tracking-normal) + 0.05em);",
-              "  --tracking-widest: calc(var(--tracking-normal) + 0.1em);",
-              "}",
-            );
-            themeCss.push(
-              `body {\n  letter-spacing: var(--tracking-normal);\n}`,
-            );
-          }
-        } catch (error) {
-          // biome-ignore lint/suspicious/noConsole: Logging allowed here
-          console.error("Failed to load shadcn registry theme:", error);
-        }
-      }
-
-      if (themeConfig.light) {
-        themeCss.push(`:root {\n${generateCss(themeConfig.light)}\n}`);
-      }
-      if (themeConfig.dark) {
-        themeCss.push(`.dark {\n${generateCss(themeConfig.dark)}\n}`);
-      }
-
-      // Add font family CSS variables
-      const rootVars = [
-        `  --font-sans: ${fonts.families.sans};`,
-        `  --font-mono: ${fonts.families.mono};`,
-        `  --font-heading: ${fonts.families.heading};`,
-      ];
-
-      if (fonts.families.serif) {
-        rootVars.push(`  --font-serif: ${fonts.families.serif};`);
-      }
-
-      // Make shiki theme background colors available as CSS variables
-      const shikiThemes =
-        config.syntaxHighlighting?.themes ?? defaultHighlightOptions.themes;
-
-      const [lightTheme, darkTheme] = (
-        await Promise.all<ThemeRegistration>([
-          import(`@shikijs/themes/${shikiThemes.light}`).then((m) => m.default),
-          import(`@shikijs/themes/${shikiThemes.dark}`).then((m) => m.default),
-        ])
-      ).map(normalizeTheme);
-
-      rootVars.push(
-        `  --shiki-light: ${lightTheme?.fg ?? "#000"};`,
-        `  --shiki-dark: ${darkTheme?.fg ?? "#fff"};`,
-        `  --shiki-light-bg: ${lightTheme?.bg ?? "#fff"};`,
-        `  --shiki-dark-bg: ${darkTheme?.bg ?? "#000"};`,
-      );
-
-      themeCss.push(`:root {\n${rootVars.join("\n")}\n}`);
-
-      return themeCss.join("\n");
-    },
-
-    // Handle static theme content in main.css
-    // This goes through the normal CSS pipeline so Tailwind can process it
-    async transform(src, id) {
-      if (!id.endsWith("/src/app/main.css")) return;
-
-      const config = getCurrentConfig();
-
-      const files = new Set(
-        [
-          config.__meta.rootDir,
-          ...config.__meta.dependencies,
-          ...(config.__pluginDirs ?? []),
-          ...resolveModuleSourceDirs(config),
-        ].map((file) => path.relative(path.dirname(id), file)),
-      );
-
-      const code = [...files].map((file) => `@source "${file}";`);
-
-      // NOTE: Font imports and declarations are handled by virtual:zudoku-theme.css
-      // This @theme block only maps CSS variables to Tailwind utilities
-      code.push("@theme inline {");
-
-      // prettier-ignore
-      const colorVars = [
-        "background", "foreground", "card", "card-foreground", "popover", "popover-foreground", "primary",
-        "primary-foreground", "secondary", "secondary-foreground", "muted", "muted-foreground", "accent",
-        "accent-foreground", "destructive", "destructive-foreground", "border", "input", "ring", "chart-1",
-        "chart-2", "chart-3", "chart-4", "chart-5", "sidebar", "sidebar-foreground", "sidebar-primary",
-        "sidebar-primary-foreground", "sidebar-accent", "sidebar-accent-foreground", "sidebar-border", "sidebar-ring",
-      ];
-
-      code.push(
-        ...colorVars.map((color) => `  --color-${color}: var(--${color});`),
-      );
-
-      code.push(
-        `  --radius-sm: calc(var(--radius) - 4px);`,
-        `  --radius-md: calc(var(--radius) - 2px);`,
-        `  --radius-lg: var(--radius);`,
-        `  --radius-xl: calc(var(--radius) + 4px);`,
-        `  --font-sans: var(--font-sans);`,
-        `  --font-mono: var(--font-mono);`,
-        `  --font-serif: var(--font-serif);`,
-      );
-
-      code.push("}");
-
-      const customCss = config.theme?.customCss;
-      if (customCss) {
-        code.push(processCustomCss(customCss));
-      }
-
-      const defaultThemeImport = config.theme?.noDefaultTheme
-        ? ""
-        : '@import "./defaultTheme.css" layer(theme);';
-
-      return src
-        .replace(DEFAULT_THEME_REPLACE, defaultThemeImport)
-        .replace(MAIN_REPLACE, code.join("\n"));
-    },
-  };
-};
+import { createRequire } from "node:module";
+import path from "node:path";
+import { normalizeTheme, type ThemeRegistration } from "shiki";
+import type { Plugin } from "vite";
+import type { ConfigWithMeta } from "../config/loader.js";
+import { getCurrentConfig } from "../config/loader.js";
+import type {
+  FontConfig,
+  ZudokuConfig,
+} from "../config/validators/ZudokuConfig.js";
+import { defaultHighlightOptions } from "../lib/shiki.js";
+import { objectEntries } from "../lib/util/objectEntries.js";
+import {
+  fetchShadcnRegistryItem,
+  type RegistryItemCss,
+} from "./shadcn-registry.js";
+
+// prettier-ignore
+const THEME_VARIABLES = [
+  "background", "foreground", "card", "cardForeground", "popover", "popoverForeground", "primary",
+  "primaryForeground", "secondary", "secondaryForeground", "muted", "mutedForeground", "accent",
+  "accentForeground", "destructive", "destructiveForeground", "border", "input", "ring", "radius",
+] as const;
+
+const uncamelize = (str: string) =>
+  str.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
+
+export type Theme = Partial<Record<(typeof THEME_VARIABLES)[number], string>>;
+
+const processColorValue = (value: string | undefined): string => {
+  if (!value) return "";
+  const color =
+    !value.startsWith("#") &&
+    !value.includes("(") &&
+    value.split(" ").length >= 3
+      ? // Assume legacy tailwind hsl format
+        `hsl(${value})`
+      : value;
+
+  return color;
+};
+
+const generateCss = (theme: Theme) =>
+  objectEntries(theme)
+    .filter(([key]) => THEME_VARIABLES.includes(key))
+    .map(([key, value]) => `--${uncamelize(key)}: ${processColorValue(value)};`)
+    .join("\n");
+
+const generateRegistryCss = (cssVars: Record<string, string>) =>
+  Object.entries(cssVars)
+    .map(([key, value]) => `  --${key}: ${value};`)
+    .join("\n");
+
+const processCustomCss = (css: string | RegistryItemCss): string => {
+  if (typeof css === "string") {
+    return css;
+  }
+
+  const processStyles = (
+    styles: RegistryItemCss | string,
+    indent = "",
+  ): string[] => {
+    if (typeof styles === "string") {
+      return [`${indent}${styles}`];
+    }
+
+    const rules = [];
+    for (const [key, value] of Object.entries(styles)) {
+      if (typeof value === "string") {
+        rules.push(`${indent}${key}: ${value};`);
+      } else {
+        rules.push(`${indent}${key} {`);
+        rules.push(...processStyles(value, `${indent}  `));
+        rules.push(`${indent}}`);
+      }
+    }
+    return rules;
+  };
+
+  return processStyles(css).join("\n");
+};
+
+const MAIN_REPLACE = "/* @vite-plugin-inject main */";
+const DEFAULT_THEME_REPLACE = "/* @vite-plugin-inject defaultTheme */";
+
+// prettier-ignore
+export const GOOGLE_FONTS = [
+  "Inter", "Roboto", "Open Sans", "Poppins", "Montserrat", "Outfit",
+  "Plus Jakarta Sans", "DM Sans", "IBM Plex Sans", "Geist", "Oxanium",
+  "Architects Daughter", "Merriweather", "Playfair Display", "Lora",
+  "Source Serif Pro", "Libre Baskerville", "Space Grotesk", "JetBrains Mono",
+  "Fira Code", "Source Code Pro", "IBM Plex Mono", "Roboto Mono", "Space Mono", "Geist Mono",
+] as const;
+type GoogleFont = (typeof GOOGLE_FONTS)[number];
+
+const getGoogleFontUrl = (font: string) =>
+  `https://fonts.googleapis.com/css2?family=${font.replaceAll(/\s+/g, "+")}:wght@400;500;600;700&display=swap`;
+
+const processFont = (fontValue: string) => {
+  const families = fontValue
+    .split(",")
+    .map((f) => f.trim().replaceAll(/['"]/g, ""));
+
+  return families
+    .filter((family) => GOOGLE_FONTS.includes(family as GoogleFont))
+    .map((family) => getGoogleFontUrl(family));
+};
+
+const processFontConfig = (fontConfig?: FontConfig) => {
+  if (!fontConfig) return { url: undefined, fontFamily: undefined };
+
+  if (typeof fontConfig === "string") {
+    if (GOOGLE_FONTS.includes(fontConfig as GoogleFont)) {
+      return {
+        url: getGoogleFontUrl(fontConfig),
+        fontFamily: fontConfig,
+      };
+    }
+    return { url: undefined, fontFamily: fontConfig };
+  }
+
+  return {
+    url: fontConfig.url,
+    fontFamily: fontConfig.fontFamily,
+  };
+};
+
+/**
+ * The default fonts ship inside the portal (Latin subset, four weights) so a first paint makes no third-party
+ * request. Fonts a tenant picks by name still load from Google Fonts: that is their explicit choice.
+ */
+const bundledFont = (pkg: string) => {
+  // Absolute paths: the CSS is compiled from the site root, which does not see this package's dependencies.
+  const dir = path.dirname(
+    createRequire(import.meta.url).resolve(`@fontsource/${pkg}/package.json`),
+  );
+  return [400, 500, 600, 700].map((weight) =>
+    path.join(dir, `latin-${weight}.css`).split(path.sep).join("/"),
+  );
+};
+
+const DEFAULT_FONT_SANS = '"IBM Plex Sans", system-ui, sans-serif';
+const DEFAULT_FONT_MONO = '"JetBrains Mono", monospace';
+const DEFAULT_FONT_HEADING = '"Space Grotesk", system-ui, sans-serif';
+
+const processFonts = async (themeConfig: ZudokuConfig["theme"]) => {
+  const imports: string[] = [];
+  const bundled: string[] = [];
+  const families = {
+    sans: DEFAULT_FONT_SANS,
+    serif: undefined as string | undefined,
+    mono: DEFAULT_FONT_MONO,
+    heading: DEFAULT_FONT_HEADING,
+  };
+
+  // Process user fonts
+  const userFonts = {
+    sans: processFontConfig(themeConfig?.fonts?.sans),
+    serif: processFontConfig(themeConfig?.fonts?.serif),
+    mono: processFontConfig(themeConfig?.fonts?.mono),
+  };
+
+  // Add user font imports
+  for (const font of Object.values(userFonts)) {
+    if (font.url) {
+      imports.push(font.url);
+    }
+  }
+
+  // Process registry fonts if available
+  let registryFonts = {
+    sans: undefined as string | undefined,
+    serif: undefined as string | undefined,
+    mono: undefined as string | undefined,
+  };
+
+  if (themeConfig?.registryUrl) {
+    try {
+      const registryItem = await fetchShadcnRegistryItem(
+        themeConfig.registryUrl,
+      );
+      const { cssVars = {} } = registryItem;
+      const { theme: regThemeVars = {}, light: regLightVars = {} } = cssVars;
+
+      registryFonts = {
+        sans: regLightVars["font-sans"] ?? regThemeVars["font-sans"],
+        serif: regLightVars["font-serif"] ?? regThemeVars["font-serif"],
+        mono: regLightVars["font-mono"] ?? regThemeVars["font-mono"],
+      };
+
+      // Add registry font imports
+      for (const font of Object.values(registryFonts)) {
+        if (font) {
+          imports.push(...processFont(font));
+        }
+      }
+    } catch {
+      // Registry fonts failed to load, continue with user fonts and defaults
+    }
+  }
+
+  // Determine final font families with priority: user > registry > defaults
+  families.sans =
+    userFonts.sans.fontFamily || registryFonts.sans || DEFAULT_FONT_SANS;
+  families.serif = userFonts.serif.fontFamily || registryFonts.serif;
+  families.mono =
+    userFonts.mono.fontFamily || registryFonts.mono || DEFAULT_FONT_MONO;
+
+  // Add default font imports if no user or registry fonts
+  if (!userFonts.sans.fontFamily && !registryFonts.sans) {
+    bundled.push(...bundledFont("ibm-plex-sans"));
+  }
+  if (!userFonts.mono.fontFamily && !registryFonts.mono) {
+    bundled.push(...bundledFont("jetbrains-mono"));
+  }
+  bundled.push(...bundledFont("space-grotesk"));
+
+  return { imports, bundled, families };
+};
+
+const MODULE_SOURCE_PACKAGES = [
+  "@lukoweb/apitogo-module-landing",
+  "@lukoweb/apitogo-module-user-panel",
+];
+
+/**
+ * Directories of module packages (landing, user panel) that use Tailwind
+ * utility classes. They live outside the Tailwind `source("..")` root set in
+ * main.css, so they must be added as explicit `@source` scan paths — otherwise
+ * their arbitrary-value utilities (e.g. the landing hero grid template and
+ * terminal card colors) are missing from the generated CSS.
+ */
+const resolveModuleSourceDirs = (config: ConfigWithMeta): string[] => {
+  if (config.__meta.mode === "internal") {
+    return MODULE_SOURCE_PACKAGES.map((pkg) =>
+      path.join(
+        config.__meta.moduleDir,
+        "..",
+        pkg.replace("@lukoweb/apitogo-", ""),
+        "src",
+      ),
+    );
+  }
+
+  const require = createRequire(
+    path.join(config.__meta.rootDir, "package.json"),
+  );
+  const dirs: string[] = [];
+  for (const pkg of MODULE_SOURCE_PACKAGES) {
+    try {
+      dirs.push(path.dirname(require.resolve(pkg)));
+    } catch {
+      // Module package not installed — nothing to scan.
+    }
+  }
+  return dirs;
+};
+
+export const virtualModuleId = "virtual:zudoku-theme.css";
+export const resolvedVirtualModuleId = `\0${virtualModuleId}`;
+
+export const viteThemePlugin = (): Plugin => {
+  return {
+    // It is important to run before the Tailwind plugin
+    enforce: "pre",
+    name: "zudoku-css-theme",
+
+    resolveId(id) {
+      if (id === "virtual:zudoku-theme.css") {
+        return resolvedVirtualModuleId;
+      }
+    },
+    // Handle the virtual module for dynamic theme content
+    async load(id) {
+      if (id !== resolvedVirtualModuleId) return;
+
+      const config = getCurrentConfig();
+
+      const themeConfig = config.theme ?? {};
+      const themeCss: string[] = [];
+
+      // Consolidate all font processing
+      const fonts = await processFonts(themeConfig);
+
+      // Add all font imports at once
+      themeCss.push(
+        ...fonts.bundled.map((specifier) => `@import '${specifier}';`),
+        ...fonts.imports.map((url) => `@import url('${url}');`),
+      );
+
+      // Handle registry theme variables
+      if (themeConfig.registryUrl) {
+        try {
+          const registryItem = await fetchShadcnRegistryItem(
+            themeConfig.registryUrl,
+          );
+
+          // Extract theme variables from registry
+          const { cssVars = {}, css = {} } = registryItem;
+          const { light: regLightVars = {}, dark: regDarkVars = {} } = cssVars;
+
+          // Process custom CSS from registry
+          if (Object.keys(css).length > 0) {
+            themeCss.push(processCustomCss(css));
+          }
+
+          // Merge registry variables with user overrides
+          const applyOverrides = (
+            vars: Record<string, string>,
+            overrides?: Theme,
+          ) => {
+            if (!overrides) return vars;
+
+            const result = { ...vars };
+            for (const [key, value] of objectEntries(overrides)) {
+              if (value && THEME_VARIABLES.includes(key)) {
+                result[uncamelize(key)] = processColorValue(value);
+              }
+            }
+            return result;
+          };
+
+          const lightVars = applyOverrides(regLightVars, themeConfig.light);
+          const darkVars = applyOverrides(regDarkVars, themeConfig.dark);
+
+          // Generate CSS for light and dark themes
+          if (Object.keys(lightVars).length > 0) {
+            themeCss.push(`:root {\n${generateRegistryCss(lightVars)}\n}`);
+          }
+
+          if (Object.keys(darkVars).length > 0) {
+            themeCss.push(`.dark {\n${generateRegistryCss(darkVars)}\n}`);
+          }
+
+          if (lightVars["letter-spacing"] !== "0em") {
+            themeCss.push(
+              "@theme inline {",
+              "  --tracking-tighter: calc(var(--tracking-normal) - 0.05em);",
+              "  --tracking-tight: calc(var(--tracking-normal) - 0.025em);",
+              "  --tracking-normal: var(--tracking-normal);",
+              "  --tracking-wide: calc(var(--tracking-normal) + 0.025em);",
+              "  --tracking-wider: calc(var(--tracking-normal) + 0.05em);",
+              "  --tracking-widest: calc(var(--tracking-normal) + 0.1em);",
+              "}",
+            );
+            themeCss.push(
+              `body {\n  letter-spacing: var(--tracking-normal);\n}`,
+            );
+          }
+        } catch (error) {
+          // biome-ignore lint/suspicious/noConsole: Logging allowed here
+          console.error("Failed to load shadcn registry theme:", error);
+        }
+      }
+
+      if (themeConfig.light) {
+        themeCss.push(`:root {\n${generateCss(themeConfig.light)}\n}`);
+      }
+      if (themeConfig.dark) {
+        themeCss.push(`.dark {\n${generateCss(themeConfig.dark)}\n}`);
+      }
+
+      // Add font family CSS variables
+      const rootVars = [
+        `  --font-sans: ${fonts.families.sans};`,
+        `  --font-mono: ${fonts.families.mono};`,
+        `  --font-heading: ${fonts.families.heading};`,
+      ];
+
+      if (fonts.families.serif) {
+        rootVars.push(`  --font-serif: ${fonts.families.serif};`);
+      }
+
+      // Make shiki theme background colors available as CSS variables
+      const shikiThemes =
+        config.syntaxHighlighting?.themes ?? defaultHighlightOptions.themes;
+
+      const [lightTheme, darkTheme] = (
+        await Promise.all<ThemeRegistration>([
+          import(`@shikijs/themes/${shikiThemes.light}`).then((m) => m.default),
+          import(`@shikijs/themes/${shikiThemes.dark}`).then((m) => m.default),
+        ])
+      ).map(normalizeTheme);
+
+      rootVars.push(
+        `  --shiki-light: ${lightTheme?.fg ?? "#000"};`,
+        `  --shiki-dark: ${darkTheme?.fg ?? "#fff"};`,
+        `  --shiki-light-bg: ${lightTheme?.bg ?? "#fff"};`,
+        `  --shiki-dark-bg: ${darkTheme?.bg ?? "#000"};`,
+      );
+
+      themeCss.push(`:root {\n${rootVars.join("\n")}\n}`);
+
+      return themeCss.join("\n");
+    },
+
+    // Handle static theme content in main.css
+    // This goes through the normal CSS pipeline so Tailwind can process it
+    async transform(src, id) {
+      if (!id.endsWith("/src/app/main.css")) return;
+
+      const config = getCurrentConfig();
+
+      const files = new Set(
+        [
+          config.__meta.rootDir,
+          ...config.__meta.dependencies,
+          ...(config.__pluginDirs ?? []),
+          ...resolveModuleSourceDirs(config),
+        ].map((file) => path.relative(path.dirname(id), file)),
+      );
+
+      const code = [...files].map((file) => `@source "${file}";`);
+
+      // NOTE: Font imports and declarations are handled by virtual:zudoku-theme.css
+      // This @theme block only maps CSS variables to Tailwind utilities
+      code.push("@theme inline {");
+
+      // prettier-ignore
+      const colorVars = [
+        "background", "foreground", "card", "card-foreground", "popover", "popover-foreground", "primary",
+        "primary-foreground", "secondary", "secondary-foreground", "muted", "muted-foreground", "accent",
+        "accent-foreground", "destructive", "destructive-foreground", "border", "input", "ring", "chart-1",
+        "chart-2", "chart-3", "chart-4", "chart-5", "sidebar", "sidebar-foreground", "sidebar-primary",
+        "sidebar-primary-foreground", "sidebar-accent", "sidebar-accent-foreground", "sidebar-border", "sidebar-ring",
+      ];
+
+      code.push(
+        ...colorVars.map((color) => `  --color-${color}: var(--${color});`),
+      );
+
+      code.push(
+        `  --radius-sm: calc(var(--radius) - 4px);`,
+        `  --radius-md: calc(var(--radius) - 2px);`,
+        `  --radius-lg: var(--radius);`,
+        `  --radius-xl: calc(var(--radius) + 4px);`,
+        `  --font-sans: var(--font-sans);`,
+        `  --font-mono: var(--font-mono);`,
+        `  --font-serif: var(--font-serif);`,
+      );
+
+      code.push("}");
+
+      const customCss = config.theme?.customCss;
+      if (customCss) {
+        code.push(processCustomCss(customCss));
+      }
+
+      const defaultThemeImport = config.theme?.noDefaultTheme
+        ? ""
+        : '@import "./defaultTheme.css" layer(theme);';
+
+      return src
+        .replace(DEFAULT_THEME_REPLACE, defaultThemeImport)
+        .replace(MAIN_REPLACE, code.join("\n"));
+    },
+  };
+};