@rangojs/router 0.0.0-experimental.0b82333f

package/dist/theme/__tests__/theme.test.js

@@ -0,0 +1,103 @@
+import { describe, it, expect } from "vitest";
+import { resolveThemeConfig, THEME_DEFAULTS, THEME_COOKIE } from "../constants.js";
+import { generateThemeScript } from "../theme-script.js";
+describe("Theme Configuration", () => {
+    describe("resolveThemeConfig", () => {
+        it("should apply defaults when no config provided", () => {
+            const config = {};
+            const resolved = resolveThemeConfig(config);
+            expect(resolved.defaultTheme).toBe(THEME_DEFAULTS.defaultTheme);
+            expect(resolved.themes).toEqual(THEME_DEFAULTS.themes);
+            expect(resolved.attribute).toBe(THEME_DEFAULTS.attribute);
+            expect(resolved.storageKey).toBe(THEME_DEFAULTS.storageKey);
+            expect(resolved.enableSystem).toBe(THEME_DEFAULTS.enableSystem);
+            expect(resolved.enableColorScheme).toBe(THEME_DEFAULTS.enableColorScheme);
+        });
+        it("should preserve custom config values", () => {
+            const config = {
+                defaultTheme: "dark",
+                themes: ["light", "dark", "sepia"],
+                attribute: "data-theme",
+                storageKey: "app-theme",
+                enableSystem: false,
+                enableColorScheme: false,
+            };
+            const resolved = resolveThemeConfig(config);
+            expect(resolved.defaultTheme).toBe("dark");
+            expect(resolved.themes).toEqual(["light", "dark", "sepia"]);
+            expect(resolved.attribute).toBe("data-theme");
+            expect(resolved.storageKey).toBe("app-theme");
+            expect(resolved.enableSystem).toBe(false);
+            expect(resolved.enableColorScheme).toBe(false);
+        });
+        it("should generate value mapping for themes", () => {
+            const config = {
+                themes: ["light", "dark"],
+            };
+            const resolved = resolveThemeConfig(config);
+            expect(resolved.value).toEqual({
+                light: "light",
+                dark: "dark",
+            });
+        });
+        it("should use custom value mapping when provided", () => {
+            const config = {
+                themes: ["light", "dark"],
+                value: {
+                    light: "light-mode",
+                    dark: "dark-mode",
+                },
+            };
+            const resolved = resolveThemeConfig(config);
+            expect(resolved.value).toEqual({
+                light: "light-mode",
+                dark: "dark-mode",
+            });
+        });
+    });
+    describe("THEME_COOKIE", () => {
+        it("should have correct defaults", () => {
+            expect(THEME_COOKIE.maxAge).toBe(60 * 60 * 24 * 365);
+            expect(THEME_COOKIE.path).toBe("/");
+            expect(THEME_COOKIE.sameSite).toBe("lax");
+        });
+    });
+});
+describe("Theme Script", () => {
+    describe("generateThemeScript", () => {
+        it("should generate a minified script", () => {
+            const config = {
+                defaultTheme: "system",
+                themes: ["light", "dark"],
+                attribute: "class",
+                storageKey: "theme",
+                enableSystem: true,
+                enableColorScheme: true,
+                value: { light: "light", dark: "dark" },
+            };
+            const script = generateThemeScript(config);
+            // Should be a string
+            expect(typeof script).toBe("string");
+            // Should not have multi-line formatting (minified)
+            expect(script.includes("\n  ")).toBe(false);
+            // Should contain key configuration values
+            expect(script.includes('"theme"')).toBe(true);
+            expect(script.includes('"system"')).toBe(true);
+            expect(script.includes('"class"')).toBe(true);
+        });
+        it("should handle data-* attributes", () => {
+            const config = {
+                defaultTheme: "light",
+                themes: ["light", "dark"],
+                attribute: "data-theme",
+                storageKey: "theme",
+                enableSystem: true,
+                enableColorScheme: true,
+                value: { light: "light", dark: "dark" },
+            };
+            const script = generateThemeScript(config);
+            expect(script.includes('"data-theme"')).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=theme.test.js.map

package/dist/theme/__tests__/theme.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.test.js","sourceRoot":"","sources":["../../../src/theme/__tests__/theme.test.ts"],"names":[],"mappings":"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"}

package/dist/theme/constants.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Default values for theme configuration
+ */
+import type { ResolvedThemeConfig, ThemeConfig } from "./types.js";
+/**
+ * Default theme configuration values
+ */
+export declare const THEME_DEFAULTS: {
+    readonly defaultTheme: "system";
+    readonly themes: readonly ["light", "dark"];
+    readonly attribute: "class";
+    readonly storageKey: "theme";
+    readonly enableSystem: true;
+    readonly enableColorScheme: true;
+};
+/**
+ * Cookie configuration for theme persistence
+ */
+export declare const THEME_COOKIE: {
+    readonly maxAge: number;
+    readonly path: string;
+    readonly sameSite: "lax";
+};
+/**
+ * Resolve theme config by applying defaults.
+ * Accepts `true` to enable with all defaults, or a config object.
+ */
+export declare function resolveThemeConfig(config: ThemeConfig | true): ResolvedThemeConfig;
+//# sourceMappingURL=constants.d.ts.map

package/dist/theme/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/theme/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;CAK1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,mBAAmB,CAuBlF"}

package/dist/theme/constants.js

@@ -0,0 +1,48 @@
+/**
+ * Default values for theme configuration
+ */
+/**
+ * Default theme configuration values
+ */
+export const THEME_DEFAULTS = {
+    defaultTheme: "system",
+    themes: ["light", "dark"],
+    attribute: "class",
+    storageKey: "theme",
+    enableSystem: true,
+    enableColorScheme: true,
+};
+/**
+ * Cookie configuration for theme persistence
+ */
+export const THEME_COOKIE = {
+    maxAge: 60 * 60 * 24 * 365, // 1 year
+    path: "/",
+    sameSite: "lax",
+};
+/**
+ * Resolve theme config by applying defaults.
+ * Accepts `true` to enable with all defaults, or a config object.
+ */
+export function resolveThemeConfig(config) {
+    // Handle `theme: true` shorthand
+    if (config === true) {
+        config = {};
+    }
+    const themes = config.themes ?? [...THEME_DEFAULTS.themes];
+    // Build value mapping - default to identity mapping
+    const value = {};
+    for (const theme of themes) {
+        value[theme] = config.value?.[theme] ?? theme;
+    }
+    return {
+        defaultTheme: config.defaultTheme ?? THEME_DEFAULTS.defaultTheme,
+        themes,
+        attribute: config.attribute ?? THEME_DEFAULTS.attribute,
+        storageKey: config.storageKey ?? THEME_DEFAULTS.storageKey,
+        enableSystem: config.enableSystem ?? THEME_DEFAULTS.enableSystem,
+        enableColorScheme: config.enableColorScheme ?? THEME_DEFAULTS.enableColorScheme,
+        value,
+    };
+}
+//# sourceMappingURL=constants.js.map

package/dist/theme/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/theme/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,YAAY,EAAE,QAAQ;IACtB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,OAAO;IAClB,UAAU,EAAE,OAAO;IACnB,YAAY,EAAE,IAAI;IAClB,iBAAiB,EAAE,IAAI;CACf,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAIrB;IACF,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,SAAS;IACrC,IAAI,EAAE,GAAG;IACT,QAAQ,EAAE,KAAK;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,iCAAiC;IACjC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,GAAG,EAAE,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAE3D,oDAAoD;IACpD,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;IAChD,CAAC;IAED,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,cAAc,CAAC,YAAY;QAChE,MAAM;QACN,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,cAAc,CAAC,SAAS;QACvD,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,cAAc,CAAC,UAAU;QAC1D,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,cAAc,CAAC,YAAY;QAChE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,cAAc,CAAC,iBAAiB;QAC/E,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/theme/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Theme module exports for @rangojs/router/theme
+ *
+ * This module provides theme management for rsc-router:
+ * - useTheme: Hook for accessing theme state in client components
+ * - ThemeProvider: Component for manual theme provider setup (typically not needed)
+ * - Types for theme configuration
+ *
+ * @example
+ * ```tsx
+ * // In a client component
+ * import { useTheme } from "@rangojs/router/theme";
+ *
+ * function ThemeToggle() {
+ *   const { theme, setTheme, themes } = useTheme();
+ *   return (
+ *     <select value={theme} onChange={e => setTheme(e.target.value)}>
+ *       {themes.map(t => <option key={t}>{t}</option>)}
+ *     </select>
+ *   );
+ * }
+ * ```
+ */
+export { useTheme } from "./use-theme.js";
+export { ThemeProvider } from "./ThemeProvider.js";
+export { ThemeScript, type ThemeScriptProps } from "./ThemeScript.js";
+export type { Theme, ResolvedTheme, ThemeAttribute, ThemeConfig, ResolvedThemeConfig, UseThemeReturn, ThemeProviderProps, ThemeContextValue, } from "./types.js";
+export { THEME_DEFAULTS, THEME_COOKIE, resolveThemeConfig } from "./constants.js";
+export { generateThemeScript, getNonceAttribute } from "./theme-script.js";
+export { ThemeContext, useThemeContext, initThemeConfigSync, getSSRThemeConfig, } from "./theme-context.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/theme/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGtE,YAAY,EACV,KAAK,EACL,aAAa,EACb,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGlF,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3E,OAAO,EACL,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/theme/index.js

@@ -0,0 +1,36 @@
+/**
+ * Theme module exports for @rangojs/router/theme
+ *
+ * This module provides theme management for rsc-router:
+ * - useTheme: Hook for accessing theme state in client components
+ * - ThemeProvider: Component for manual theme provider setup (typically not needed)
+ * - Types for theme configuration
+ *
+ * @example
+ * ```tsx
+ * // In a client component
+ * import { useTheme } from "@rangojs/router/theme";
+ *
+ * function ThemeToggle() {
+ *   const { theme, setTheme, themes } = useTheme();
+ *   return (
+ *     <select value={theme} onChange={e => setTheme(e.target.value)}>
+ *       {themes.map(t => <option key={t}>{t}</option>)}
+ *     </select>
+ *   );
+ * }
+ * ```
+ */
+// Main hook for accessing theme
+export { useTheme } from "./use-theme.js";
+// Provider (typically auto-included via NavigationProvider when theme is enabled)
+export { ThemeProvider } from "./ThemeProvider.js";
+// Script component for FOUC prevention (use in document head)
+export { ThemeScript } from "./ThemeScript.js";
+// Constants (for advanced use cases)
+export { THEME_DEFAULTS, THEME_COOKIE, resolveThemeConfig } from "./constants.js";
+// Script generation (for advanced SSR use cases)
+export { generateThemeScript, getNonceAttribute } from "./theme-script.js";
+// Context (for advanced use cases)
+export { ThemeContext, useThemeContext, initThemeConfigSync, getSSRThemeConfig, } from "./theme-context.js";
+//# sourceMappingURL=index.js.map

package/dist/theme/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,gCAAgC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,kFAAkF;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,8DAA8D;AAC9D,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AActE,qCAAqC;AACrC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAElF,iDAAiD;AACjD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3E,mCAAmC;AACnC,OAAO,EACL,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/theme/theme-context.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Theme context for sharing theme state and configuration.
+ *
+ * Used by:
+ * - ThemeProvider to provide theme state
+ * - useTheme hook to access theme state
+ * - MetaTags to check if theme is enabled and render script
+ */
+import { type Context } from "react";
+import type { ResolvedThemeConfig, ThemeContextValue } from "./types.js";
+/**
+ * React context for theme state
+ * null when theme is not enabled in router config
+ */
+export declare const ThemeContext: Context<ThemeContextValue | null>;
+/**
+ * Initialize theme config synchronously for SSR.
+ * Called before rendering to populate state for MetaTags.
+ *
+ * @param config - Theme config from router, or null if theme is disabled
+ */
+export declare function initThemeConfigSync(config: ResolvedThemeConfig | null): void;
+/**
+ * Get theme config for SSR/hydration.
+ * Used by MetaTags to render the theme script.
+ *
+ * @returns Theme config if available, null otherwise
+ */
+export declare function getSSRThemeConfig(): ResolvedThemeConfig | null;
+/**
+ * Get theme context (internal use)
+ * Returns null if theme is not enabled
+ */
+export declare function useThemeContext(): ThemeContextValue | null;
+/**
+ * Get theme context, throwing if not available
+ * Use this in useTheme hook
+ */
+export declare function requireThemeContext(): ThemeContextValue;
+//# sourceMappingURL=theme-context.d.ts.map

package/dist/theme/theme-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-context.d.ts","sourceRoot":"","sources":["../../src/theme/theme-context.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,EAA6B,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAiD,CAAC;AAS7G;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,mBAAmB,GAAG,IAAI,CAE9D;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,GAAG,IAAI,CAE1D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,iBAAiB,CAUvD"}

package/dist/theme/theme-context.js

@@ -0,0 +1,60 @@
+"use client";
+/**
+ * Theme context for sharing theme state and configuration.
+ *
+ * Used by:
+ * - ThemeProvider to provide theme state
+ * - useTheme hook to access theme state
+ * - MetaTags to check if theme is enabled and render script
+ */
+import { createContext, useContext } from "react";
+/**
+ * React context for theme state
+ * null when theme is not enabled in router config
+ */
+export const ThemeContext = createContext(null);
+/**
+ * SSR module-level state for theme config.
+ * Populated by initThemeConfigSync before React renders.
+ * Used by MetaTags during SSR to render the theme script.
+ */
+let ssrThemeConfig = null;
+/**
+ * Initialize theme config synchronously for SSR.
+ * Called before rendering to populate state for MetaTags.
+ *
+ * @param config - Theme config from router, or null if theme is disabled
+ */
+export function initThemeConfigSync(config) {
+    ssrThemeConfig = config;
+}
+/**
+ * Get theme config for SSR/hydration.
+ * Used by MetaTags to render the theme script.
+ *
+ * @returns Theme config if available, null otherwise
+ */
+export function getSSRThemeConfig() {
+    return ssrThemeConfig;
+}
+/**
+ * Get theme context (internal use)
+ * Returns null if theme is not enabled
+ */
+export function useThemeContext() {
+    return useContext(ThemeContext);
+}
+/**
+ * Get theme context, throwing if not available
+ * Use this in useTheme hook
+ */
+export function requireThemeContext() {
+    const ctx = useContext(ThemeContext);
+    if (!ctx) {
+        throw new Error("useTheme must be used within a ThemeProvider. " +
+            "Make sure theme is enabled in your router config: " +
+            "createRouter({ theme: { ... } })");
+    }
+    return ctx;
+}
+//# sourceMappingURL=theme-context.js.map

package/dist/theme/theme-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-context.js","sourceRoot":"","sources":["../../src/theme/theme-context.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAgB,MAAM,OAAO,CAAC;AAGhE;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAsC,aAAa,CAA2B,IAAI,CAAC,CAAC;AAE7G;;;;GAIG;AACH,IAAI,cAAc,GAA+B,IAAI,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkC;IACpE,cAAc,GAAG,MAAM,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC,YAAY,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,gDAAgD;YAC9C,oDAAoD;YACpD,kCAAkC,CACrC,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/theme/theme-script.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Generates an inline script for FOUC prevention.
+ *
+ * This script runs synchronously before page paint to:
+ * 1. Read theme from cookie or localStorage
+ * 2. Detect system preference if theme is "system"
+ * 3. Apply theme to HTML element via class or data attribute
+ * 4. Optionally set color-scheme CSS property
+ *
+ * The script is minified and inlined in <head> before any other content.
+ */
+import type { ResolvedThemeConfig } from "./types.js";
+/**
+ * Generate the inline script for theme initialization
+ *
+ * The script is designed to:
+ * - Run synchronously before paint (blocking)
+ * - Be as small as possible to minimize blocking time
+ * - Work without any external dependencies
+ * - Handle all edge cases (no localStorage, no cookie, etc.)
+ */
+export declare function generateThemeScript(config: ResolvedThemeConfig): string;
+/**
+ * Generate nonce attribute string if nonce is provided
+ */
+export declare function getNonceAttribute(nonce?: string): string;
+//# sourceMappingURL=theme-script.d.ts.map

package/dist/theme/theme-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-script.d.ts","sourceRoot":"","sources":["../../src/theme/theme-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAiGvE;AA0BD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/theme/theme-script.js

@@ -0,0 +1,147 @@
+/**
+ * Generates an inline script for FOUC prevention.
+ *
+ * This script runs synchronously before page paint to:
+ * 1. Read theme from cookie or localStorage
+ * 2. Detect system preference if theme is "system"
+ * 3. Apply theme to HTML element via class or data attribute
+ * 4. Optionally set color-scheme CSS property
+ *
+ * The script is minified and inlined in <head> before any other content.
+ */
+/**
+ * Generate the inline script for theme initialization
+ *
+ * The script is designed to:
+ * - Run synchronously before paint (blocking)
+ * - Be as small as possible to minimize blocking time
+ * - Work without any external dependencies
+ * - Handle all edge cases (no localStorage, no cookie, etc.)
+ */
+export function generateThemeScript(config) {
+    // Build the script as a string, then minify
+    const script = `
+(function() {
+  var storageKey = ${JSON.stringify(config.storageKey)};
+  var defaultTheme = ${JSON.stringify(config.defaultTheme)};
+  var attribute = ${JSON.stringify(config.attribute)};
+  var enableSystem = ${config.enableSystem};
+  var enableColorScheme = ${config.enableColorScheme};
+  var valueMap = ${JSON.stringify(config.value)};
+  var themes = ${JSON.stringify(config.themes)};
+
+  // Read theme from cookie or localStorage
+  function getStoredTheme() {
+    // Try cookie first (for SSR consistency)
+    var cookies = document.cookie.split(';');
+    for (var i = 0; i < cookies.length; i++) {
+      var cookie = cookies[i].trim();
+      if (cookie.indexOf(storageKey + '=') === 0) {
+        return decodeURIComponent(cookie.substring(storageKey.length + 1));
+      }
+    }
+    // Fall back to localStorage
+    try {
+      return localStorage.getItem(storageKey);
+    } catch (e) {
+      return null;
+    }
+  }
+
+  // Get system preference
+  function getSystemTheme() {
+    if (typeof window !== 'undefined' && window.matchMedia) {
+      return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+    }
+    return 'light';
+  }
+
+  // Resolve "system" to actual theme
+  function resolveTheme(theme) {
+    if (theme === 'system' && enableSystem) {
+      return getSystemTheme();
+    }
+    return theme;
+  }
+
+  // Apply theme to HTML element
+  function applyTheme(theme) {
+    var resolved = resolveTheme(theme);
+    var value = valueMap[resolved] || resolved;
+    var el = document.documentElement;
+
+    // Apply attribute
+    if (attribute === 'class') {
+      // Remove all theme classes, then add current
+      for (var i = 0; i < themes.length; i++) {
+        var v = valueMap[themes[i]] || themes[i];
+        el.classList.remove(v);
+      }
+      el.classList.add(value);
+    } else {
+      el.setAttribute(attribute, value);
+    }
+
+    // Set color-scheme for native dark mode support
+    if (enableColorScheme) {
+      el.style.colorScheme = resolved;
+    }
+  }
+
+  // Get stored theme or use default
+  var stored = getStoredTheme();
+  var theme = stored && (stored === 'system' || themes.indexOf(stored) !== -1)
+    ? stored
+    : defaultTheme;
+
+  // Apply immediately
+  applyTheme(theme);
+
+  // Listen for system preference changes (for "system" theme)
+  if (enableSystem && typeof window !== 'undefined' && window.matchMedia) {
+    try {
+      window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', function() {
+        var current = getStoredTheme() || defaultTheme;
+        if (current === 'system') {
+          applyTheme('system');
+        }
+      });
+    } catch (e) {
+      // Older browsers may not support addEventListener on MediaQueryList
+    }
+  }
+})();
+`;
+    // Minify by removing comments, extra whitespace, and newlines
+    return minifyScript(script);
+}
+/**
+ * Basic script minification
+ * Removes comments, extra whitespace, and unnecessary newlines
+ */
+function minifyScript(script) {
+    return script
+        // Remove single-line comments
+        .replace(/\/\/.*$/gm, "")
+        // Remove multi-line comments
+        .replace(/\/\*[\s\S]*?\*\//g, "")
+        // Remove leading/trailing whitespace from lines
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0)
+        .join("")
+        // Collapse multiple spaces to single space
+        .replace(/\s+/g, " ")
+        // Remove spaces around operators and punctuation
+        .replace(/\s*([{};,=!<>()[\]+\-*/&|?:])\s*/g, "$1")
+        // Add back necessary spaces (e.g., "var x")
+        .replace(/(var|function|return|if|for|try|catch|typeof|else)\(/g, "$1 (")
+        .replace(/\)([a-zA-Z])/g, ") $1");
+}
+/**
+ * Generate nonce attribute string if nonce is provided
+ */
+export function getNonceAttribute(nonce) {
+    return nonce ? ` nonce="${nonce}"` : "";
+}
+//# sourceMappingURL=theme-script.js.map

package/dist/theme/theme-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-script.js","sourceRoot":"","sources":["../../src/theme/theme-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA2B;IAC7D,4CAA4C;IAC5C,MAAM,MAAM,GAAG;;qBAEI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC;uBAC/B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC;oBACtC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC;uBAC7B,MAAM,CAAC,YAAY;4BACd,MAAM,CAAC,iBAAiB;mBACjC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmF7C,CAAC;IAEA,8DAA8D;IAC9D,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,MAAM;QACX,8BAA8B;SAC7B,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;QACzB,6BAA6B;SAC5B,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;QACjC,gDAAgD;SAC/C,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,IAAI,CAAC,EAAE,CAAC;QACT,2CAA2C;SAC1C,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;QACrB,iDAAiD;SAChD,OAAO,CAAC,mCAAmC,EAAE,IAAI,CAAC;QACnD,4CAA4C;SAC3C,OAAO,CAAC,uDAAuD,EAAE,MAAM,CAAC;SACxE,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,CAAC,CAAC,CAAC,WAAW,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1C,CAAC"}