@nikala-ui/folio 0.13.0

package/dist/mdx/rehype-shiki.js

@@ -0,0 +1,83 @@
+import { ensureLanguage, ensureTheme, getDocsHighlighter } from "./highlighter.js";
+export function rehypeShiki(config) {
+    return async (tree) => {
+        const highlighter = await getDocsHighlighter(config);
+        const lightTheme = config?.themes?.light
+            ? await ensureTheme(highlighter, config.themes.light)
+            : "github-light";
+        const darkTheme = config?.themes?.dark
+            ? await ensureTheme(highlighter, config.themes.dark)
+            : "github-dark";
+        const tasks = [];
+        function visit(node, parent, index) {
+            if (node && node.type === "element" && node.tagName === "pre") {
+                const codeNode = node.children?.find((child) => child.type === "element" && child.tagName === "code");
+                if (codeNode) {
+                    const className = codeNode.properties?.className || [];
+                    const langClass = className.find((c) => c.startsWith("language-"));
+                    const rawLang = langClass ? langClass.replace("language-", "") : "text";
+                    // Extract text content from code children
+                    let codeText = "";
+                    for (const child of codeNode.children || []) {
+                        if (child.type === "text") {
+                            codeText += child.value;
+                        }
+                    }
+                    tasks.push((async () => {
+                        try {
+                            // Dynamically ensure language is loaded on-demand
+                            const targetLang = await ensureLanguage(highlighter, rawLang);
+                            const hast = highlighter.codeToHast(codeText.trimEnd(), {
+                                lang: targetLang,
+                                themes: {
+                                    light: lightTheme,
+                                    dark: darkTheme,
+                                },
+                                defaultColor: false,
+                            });
+                            if (hast.children?.[0] && parent && typeof index === "number") {
+                                const highlightedPre = hast.children[0];
+                                // Preserve or merge existing classes
+                                const existingClass = highlightedPre.properties?.className || [];
+                                highlightedPre.properties = highlightedPre.properties || {};
+                                highlightedPre.properties.className = [
+                                    ...existingClass,
+                                    "nikala-code-block",
+                                    "font-mono",
+                                    "text-xs",
+                                ];
+                                // Store raw code in data attribute for copy actions
+                                highlightedPre.properties["data-code"] = codeText.trimEnd();
+                                highlightedPre.properties["data-lang"] = targetLang;
+                                // Add class to code element so MdxCode knows it is inside pre
+                                const codeEl = highlightedPre.children?.find((child) => child.type === "element" && child.tagName === "code");
+                                if (codeEl) {
+                                    const codeClass = codeEl.properties?.className || [];
+                                    codeEl.properties = codeEl.properties || {};
+                                    codeEl.properties.className = [
+                                        ...codeClass,
+                                        "shiki-code",
+                                        `language-${targetLang}`,
+                                    ];
+                                }
+                                parent.children[index] = highlightedPre;
+                            }
+                        }
+                        catch (err) {
+                            // Fallback to unhighlighted code on error
+                            console.warn(`[folio] Shiki highlighting failed for lang: ${rawLang}`, err);
+                        }
+                    })());
+                }
+            }
+            if (node.children && Array.isArray(node.children)) {
+                for (let i = 0; i < node.children.length; i++) {
+                    visit(node.children[i], node, i);
+                }
+            }
+        }
+        visit(tree, null, -1);
+        await Promise.all(tasks);
+    };
+}
+//# sourceMappingURL=rehype-shiki.js.map

package/dist/mdx/rehype-shiki.js.map

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

package/dist/navigation/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./sidebar-state.js";
+export * from "./repository-links.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}

package/dist/navigation/index.js

@@ -0,0 +1,3 @@
+export * from "./sidebar-state.js";
+export * from "./repository-links.js";
+//# sourceMappingURL=index.js.map

package/dist/navigation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}

package/dist/navigation/repository-links.d.ts

@@ -0,0 +1,3 @@
+import type { DocsConfig } from "../types.js";
+export declare function getRepositorySourceUrl(repository: NonNullable<DocsConfig["repository"]>, sourcePath: string, contentDir?: string): string | undefined;
+//# sourceMappingURL=repository-links.d.ts.map

package/dist/navigation/repository-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-links.d.ts","sourceRoot":"","sources":["../../src/navigation/repository-links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAqB9C,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EACjD,UAAU,EAAE,MAAM,EAClB,UAAU,SAAS,GAClB,MAAM,GAAG,SAAS,CAiBpB"}

package/dist/navigation/repository-links.js

@@ -0,0 +1,35 @@
+function normalizeRepositoryPath(...parts) {
+    const segments = parts
+        .flatMap((part) => part.replace(/\\/g, "/").split("/"))
+        .filter((segment) => segment && segment !== ".");
+    if (segments.some((segment) => segment === ".."))
+        return undefined;
+    return segments.map((segment) => encodeURIComponent(segment)).join("/");
+}
+function repositoryBaseUrl(url) {
+    try {
+        const parsed = new URL(url);
+        if (!parsed.protocol.startsWith("http"))
+            return undefined;
+        return parsed.toString().replace(/\/$/, "").replace(/\.git$/, "");
+    }
+    catch {
+        return undefined;
+    }
+}
+export function getRepositorySourceUrl(repository, sourcePath, contentDir = "docs") {
+    const baseUrl = repositoryBaseUrl(repository.url);
+    const filePath = normalizeRepositoryPath(repository.rootDir || "", contentDir, sourcePath);
+    if (!baseUrl || !filePath)
+        return undefined;
+    const branch = encodeURIComponent(repository.branch || "main");
+    const hostname = new URL(baseUrl).hostname.toLowerCase();
+    if (hostname === "gitlab.com" || hostname.endsWith(".gitlab.com")) {
+        return `${baseUrl}/-/blob/${branch}/${filePath}`;
+    }
+    if (hostname === "bitbucket.org" || hostname.endsWith(".bitbucket.org")) {
+        return `${baseUrl}/src/${branch}/${filePath}`;
+    }
+    return `${baseUrl}/blob/${branch}/${filePath}`;
+}
+//# sourceMappingURL=repository-links.js.map

package/dist/navigation/repository-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-links.js","sourceRoot":"","sources":["../../src/navigation/repository-links.ts"],"names":[],"mappings":"AAEA,SAAS,uBAAuB,CAAC,GAAG,KAAe;IACjD,MAAM,QAAQ,GAAG,KAAK;SACnB,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACtD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,OAAO,KAAK,GAAG,CAAC,CAAC;IAEnD,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACnE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC;QAC1D,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,UAAiD,EACjD,UAAkB,EAClB,UAAU,GAAG,MAAM;IAEnB,MAAM,OAAO,GAAG,iBAAiB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAC3F,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAE5C,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAEzD,IAAI,QAAQ,KAAK,YAAY,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAClE,OAAO,GAAG,OAAO,WAAW,MAAM,IAAI,QAAQ,EAAE,CAAC;IACnD,CAAC;IAED,IAAI,QAAQ,KAAK,eAAe,IAAI,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxE,OAAO,GAAG,OAAO,QAAQ,MAAM,IAAI,QAAQ,EAAE,CAAC;IAChD,CAAC;IAED,OAAO,GAAG,OAAO,SAAS,MAAM,IAAI,QAAQ,EAAE,CAAC;AACjD,CAAC"}

package/dist/navigation/sidebar-state.d.ts

@@ -0,0 +1,6 @@
+import type { SidebarItem } from "../types.js";
+export declare function isSidebarItemActive(item: SidebarItem, currentUrl?: string): boolean;
+export declare function containsActiveSidebarItem(item: SidebarItem, currentUrl?: string): boolean;
+export declare function isSidebarItemNew(item: SidebarItem): boolean;
+export declare function containsNewSidebarItem(item: SidebarItem): boolean;
+//# sourceMappingURL=sidebar-state.d.ts.map

package/dist/navigation/sidebar-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-state.d.ts","sourceRoot":"","sources":["../../src/navigation/sidebar-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAEnF;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAGzF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAM3D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAEjE"}

package/dist/navigation/sidebar-state.js

@@ -0,0 +1,20 @@
+export function isSidebarItemActive(item, currentUrl) {
+    return Boolean(item.href && currentUrl && item.href === currentUrl);
+}
+export function containsActiveSidebarItem(item, currentUrl) {
+    return isSidebarItemActive(item, currentUrl)
+        || Boolean(item.items?.some((child) => containsActiveSidebarItem(child, currentUrl)));
+}
+export function isSidebarItemNew(item) {
+    if (!item.addedAt)
+        return false;
+    const timestamp = new Date(item.addedAt).getTime();
+    if (!Number.isFinite(timestamp))
+        return false;
+    const ageInDays = (Date.now() - timestamp) / (1000 * 60 * 60 * 24);
+    return ageInDays >= 0 && ageInDays <= 14;
+}
+export function containsNewSidebarItem(item) {
+    return isSidebarItemNew(item) || Boolean(item.items?.some(containsNewSidebarItem));
+}
+//# sourceMappingURL=sidebar-state.js.map

package/dist/navigation/sidebar-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-state.js","sourceRoot":"","sources":["../../src/navigation/sidebar-state.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CAAC,IAAiB,EAAE,UAAmB;IACxE,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,UAAU,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAiB,EAAE,UAAmB;IAC9E,OAAO,mBAAmB,CAAC,IAAI,EAAE,UAAU,CAAC;WACvC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,yBAAyB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAiB;IAChD,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IACnE,OAAO,SAAS,IAAI,CAAC,IAAI,SAAS,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAiB;IACtD,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC;AACrF,CAAC"}

package/dist/navigation/sidebar-tree.d.ts

@@ -0,0 +1,7 @@
+import type { SidebarItem } from "../types.js";
+export interface FlatSidebarItem {
+    title: string;
+    href: string;
+}
+export declare function flattenSidebarItems(items: SidebarItem[]): FlatSidebarItem[];
+//# sourceMappingURL=sidebar-tree.d.ts.map

package/dist/navigation/sidebar-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-tree.d.ts","sourceRoot":"","sources":["../../src/navigation/sidebar-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,CAO3E"}

package/dist/navigation/sidebar-tree.js

@@ -0,0 +1,11 @@
+export function flattenSidebarItems(items) {
+    const flattened = [];
+    for (const item of items) {
+        if (item.href)
+            flattened.push({ title: item.title, href: item.href });
+        if (item.items)
+            flattened.push(...flattenSidebarItems(item.items));
+    }
+    return flattened;
+}
+//# sourceMappingURL=sidebar-tree.js.map

package/dist/navigation/sidebar-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-tree.js","sourceRoot":"","sources":["../../src/navigation/sidebar-tree.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,mBAAmB,CAAC,KAAoB;IACtD,MAAM,SAAS,GAAsB,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI;YAAE,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,IAAI,IAAI,CAAC,KAAK;YAAE,SAAS,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/providers/theme-provider.d.ts

@@ -0,0 +1,33 @@
+import { type ParentComponent, type Accessor } from "solid-js";
+import { type DocsAccentColor } from "../theme-accent.js";
+export type Theme = "light" | "dark" | "system";
+export type AccentColor = DocsAccentColor;
+export type Radius = "0" | "0.3" | "0.5" | "0.75" | "1.0";
+export interface ThemeProviderProps {
+    /** Initial default theme mode if no saved preference is found in localStorage */
+    defaultTheme?: Theme;
+    /** Initial default accent color override if needed */
+    defaultAccent?: AccentColor;
+    /** Initial default border radius override if needed */
+    defaultRadius?: Radius;
+    /** Key used to store theme preferences in localStorage */
+    storageKey?: string;
+}
+interface ThemeProviderContextValue {
+    theme: Accessor<Theme>;
+    setTheme: (theme: Theme) => void;
+    accent: Accessor<AccentColor | undefined>;
+    setAccent: (accent: AccentColor) => void;
+    radius: Accessor<Radius | undefined>;
+    setRadius: (radius: Radius) => void;
+}
+/**
+ * Context provider managing application theme state (light/dark/system), accent colors, and border radius.
+ */
+export declare const ThemeProvider: ParentComponent<ThemeProviderProps>;
+/**
+ * Accesses Nikala UI theme state, accent colors, border radius, and update functions.
+ */
+export declare function useTheme(): ThemeProviderContextValue;
+export { ThemeScript, type ThemeScriptProps } from "./theme-script";
+//# sourceMappingURL=theme-provider.d.ts.map

package/dist/providers/theme-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-provider.d.ts","sourceRoot":"","sources":["../../src/providers/theme-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,eAAe,EACpB,KAAK,QAAQ,EACd,MAAM,UAAU,CAAC;AAClB,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAChD,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC;AAC1C,MAAM,MAAM,MAAM,GAAG,GAAG,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,iFAAiF;IACjF,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,sDAAsD;IACtD,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,yBAAyB;IACjC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,MAAM,EAAE,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAC1C,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACzC,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACrC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAID;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,eAAe,CAAC,kBAAkB,CAgJ7D,CAAC;AAEF;;GAEG;AACH,wBAAgB,QAAQ,IAAI,yBAAyB,CAMpD;AAED,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/providers/theme-provider.jsx

@@ -0,0 +1,158 @@
+import { createContext, createEffect, createSignal, onCleanup, onMount, useContext, } from "solid-js";
+import { getAccentCssVariables, isDocsAccentColor, } from "../theme-accent.js";
+const ThemeProviderContext = createContext();
+/**
+ * Context provider managing application theme state (light/dark/system), accent colors, and border radius.
+ */
+export const ThemeProvider = (props) => {
+    const storageKey = props.storageKey || "nikala-theme";
+    const defaultTheme = props.defaultTheme || "system";
+    // Safely read saved values from localStorage without forcing unnecessary fallbacks
+    const getInitialTheme = () => {
+        if (typeof window === "undefined")
+            return defaultTheme;
+        try {
+            const saved = localStorage.getItem(`${storageKey}-mode`);
+            if (saved === "light" || saved === "dark" || saved === "system")
+                return saved;
+        }
+        catch { }
+        return defaultTheme;
+    };
+    const getInitialAccent = () => {
+        if (typeof window === "undefined")
+            return props.defaultAccent;
+        try {
+            const saved = localStorage.getItem(`${storageKey}-accent`);
+            if (isDocsAccentColor(saved))
+                return saved;
+        }
+        catch { }
+        return props.defaultAccent;
+    };
+    const getInitialRadius = () => {
+        if (typeof window === "undefined")
+            return props.defaultRadius;
+        try {
+            const saved = localStorage.getItem(`${storageKey}-radius`);
+            if (saved)
+                return saved;
+        }
+        catch { }
+        return props.defaultRadius;
+    };
+    const [theme, setThemeSignal] = createSignal(getInitialTheme());
+    const [accent, setAccentSignal] = createSignal(getInitialAccent());
+    const [radius, setRadiusSignal] = createSignal(getInitialRadius());
+    // Applies classes and CSS custom properties when custom overrides are explicitly set
+    const applyTheme = (targetTheme, currentAccent, currentRadius) => {
+        if (typeof window === "undefined")
+            return;
+        const root = document.documentElement;
+        root.classList.remove("light", "dark");
+        let resolvedDark = false;
+        if (targetTheme === "system") {
+            resolvedDark = window.matchMedia("(prefers-color-scheme: dark)").matches;
+            root.classList.add(resolvedDark ? "dark" : "light");
+        }
+        else {
+            resolvedDark = targetTheme === "dark";
+            root.classList.add(targetTheme);
+        }
+        root.style.colorScheme = resolvedDark ? "dark" : "light";
+        // Override --primary CSS variables ONLY if explicitly chosen
+        if (currentAccent && isDocsAccentColor(currentAccent)) {
+            const accentTokens = getAccentCssVariables(currentAccent, resolvedDark);
+            root.style.setProperty("--primary", accentTokens.primary);
+            root.style.setProperty("--primary-foreground", accentTokens.foreground);
+        }
+        else {
+            root.style.removeProperty("--primary");
+            root.style.removeProperty("--primary-foreground");
+        }
+        // Override --radius CSS variable ONLY if explicitly chosen
+        if (currentRadius) {
+            root.style.setProperty("--radius", `${currentRadius}rem`);
+        }
+        else {
+            root.style.removeProperty("--radius");
+        }
+    };
+    // Reactively apply theme updates and store preferences in localStorage
+    createEffect(() => {
+        const t = theme();
+        const a = accent();
+        const r = radius();
+        applyTheme(t, a, r);
+        if (typeof window !== "undefined") {
+            try {
+                localStorage.setItem(`${storageKey}-mode`, t);
+                if (a)
+                    localStorage.setItem(`${storageKey}-accent`, a);
+                else
+                    localStorage.removeItem(`${storageKey}-accent`);
+                if (r)
+                    localStorage.setItem(`${storageKey}-radius`, r);
+                else
+                    localStorage.removeItem(`${storageKey}-radius`);
+            }
+            catch { }
+        }
+    });
+    onMount(() => {
+        if (typeof window === "undefined")
+            return;
+        const mediaQuery = window.matchMedia("(prefers-color-scheme: dark)");
+        const handleSystemChange = (e) => {
+            if (theme() === "system") {
+                const root = document.documentElement;
+                root.classList.remove("light", "dark");
+                root.classList.add(e.matches ? "dark" : "light");
+                root.style.colorScheme = e.matches ? "dark" : "light";
+                const currentAccent = accent();
+                if (currentAccent && isDocsAccentColor(currentAccent)) {
+                    const accentTokens = getAccentCssVariables(currentAccent, e.matches);
+                    root.style.setProperty("--primary", accentTokens.primary);
+                    root.style.setProperty("--primary-foreground", accentTokens.foreground);
+                }
+            }
+        };
+        if (mediaQuery.addEventListener) {
+            mediaQuery.addEventListener("change", handleSystemChange);
+        }
+        else if ("addListener" in mediaQuery) {
+            mediaQuery.addListener(handleSystemChange);
+        }
+        onCleanup(() => {
+            if (mediaQuery.removeEventListener) {
+                mediaQuery.removeEventListener("change", handleSystemChange);
+            }
+            else if ("removeListener" in mediaQuery) {
+                mediaQuery.removeListener(handleSystemChange);
+            }
+        });
+    });
+    const value = {
+        theme,
+        setTheme: (newTheme) => setThemeSignal(newTheme),
+        accent,
+        setAccent: (newAccent) => setAccentSignal(newAccent),
+        radius,
+        setRadius: (newRadius) => setRadiusSignal(newRadius),
+    };
+    return (<ThemeProviderContext.Provider value={value}>
+      {props.children}
+    </ThemeProviderContext.Provider>);
+};
+/**
+ * Accesses Nikala UI theme state, accent colors, border radius, and update functions.
+ */
+export function useTheme() {
+    const context = useContext(ThemeProviderContext);
+    if (!context) {
+        throw new Error("useTheme must be used within a ThemeProvider");
+    }
+    return context;
+}
+export { ThemeScript } from "./theme-script";
+//# sourceMappingURL=theme-provider.jsx.map

package/dist/providers/theme-provider.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-provider.jsx","sourceRoot":"","sources":["../../src/providers/theme-provider.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,16 @@
+import type { Component } from "solid-js";
+export interface ThemeScriptProps {
+    /** Storage key namespace used in localStorage (default: "nikala-theme") */
+    storageKey?: string;
+    /** Initial default theme mode if no saved preference exists (default: "system") */
+    defaultTheme?: "light" | "dark" | "system";
+    /** Initial default primary accent color if no saved preference exists */
+    defaultAccent?: string;
+    /** Initial default border radius if no saved preference exists */
+    defaultRadius?: string;
+}
+/**
+ * Pre-hydration inline script executed synchronously before DOM paint to prevent theme flickering (anti-FOUC).
+ */
+export declare const ThemeScript: Component<ThemeScriptProps>;
+//# sourceMappingURL=theme-script.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme-script.d.ts","sourceRoot":"","sources":["../../src/providers/theme-script.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,YAAY,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC3C,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,CAAC,gBAAgB,CAoCnD,CAAC"}

package/dist/providers/theme-script.jsx

@@ -0,0 +1,41 @@
+import { isServer } from "solid-js/web";
+/**
+ * Pre-hydration inline script executed synchronously before DOM paint to prevent theme flickering (anti-FOUC).
+ */
+export const ThemeScript = (props) => {
+    if (!isServer)
+        return null;
+    const key = props.storageKey || "nikala-theme";
+    const defTheme = props.defaultTheme || "system";
+    const defAccent = props.defaultAccent || "";
+    const defRadius = props.defaultRadius || "";
+    const scriptText = `(function(){try{
+  var key = '${key}';
+  var mode = localStorage.getItem(key + '-mode') || '${defTheme}';
+  var accent = localStorage.getItem(key + '-accent') || '${defAccent}';
+  var radius = localStorage.getItem(key + '-radius') || '${defRadius}';
+
+  var isDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+  var resolvedDark = mode === 'dark' || (mode === 'system' && isDark);
+
+  var root = document.documentElement;
+  root.classList.remove('light', 'dark');
+  root.classList.add(resolvedDark ? 'dark' : 'light');
+  root.style.colorScheme = resolvedDark ? 'dark' : 'light';
+
+  var supportedAccents = ['slate', 'gray', 'zinc', 'neutral', 'stone', 'red', 'orange', 'amber', 'yellow', 'lime', 'green', 'emerald', 'teal', 'cyan', 'sky', 'blue', 'indigo', 'violet', 'purple', 'fuchsia', 'pink', 'rose'];
+  if (supportedAccents.indexOf(accent) !== -1) {
+    var foreground = accent === 'amber' || accent === 'yellow' || accent === 'lime'
+      ? 'var(--color-black)' : 'var(--color-white)';
+    root.style.setProperty('--primary', 'var(--color-' + accent + '-' + (resolvedDark ? '400' : '500') + ')');
+    root.style.setProperty('--primary-foreground', foreground);
+  }
+
+  if (radius) {
+    var radVal = radius.endsWith('rem') ? radius : radius + 'rem';
+    root.style.setProperty('--radius', radVal);
+  }
+}catch(e){}})();`;
+    return <script innerHTML={scriptText}/>;
+};
+//# sourceMappingURL=theme-script.jsx.map

package/dist/providers/theme-script.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-script.jsx","sourceRoot":"","sources":["../../src/providers/theme-script.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAcxC;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAgC,CAAC,KAAK,EAAE,EAAE;IAChE,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,IAAI,cAAc,CAAC;IAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,IAAI,QAAQ,CAAC;IAChD,MAAM,SAAS,GAAG,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC;IAE5C,MAAM,UAAU,GAAG;eACN,GAAG;uDACqC,QAAQ;2DACJ,SAAS;2DACT,SAAS;;;;;;;;;;;;;;;;;;;;;;iBAsBnD,CAAC;IAEhB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,EAAG,CAAC;AAC3C,CAAC,CAAC"}

package/dist/providers/theme-transitions.d.ts

@@ -0,0 +1,12 @@
+export type ThemeEffect = "none" | "circular" | "fade";
+/**
+ * Executes a theme change with the specified transition effect using the Web View Transitions API.
+ * Supported on modern browsers, Windows (Tauri WebView2), and macOS (Tauri WKWebView).
+ * Automatically falls back to safe instant transitions on Linux WebKitGTK.
+ *
+ * @param effect - Desired transition animation ("none", "circular", "fade")
+ * @param event - Mouse or Pointer event to calculate transition center coordinates
+ * @param updateThemeCallback - Callback function performing the actual theme state change
+ */
+export declare function runThemeTransition(effect: ThemeEffect | undefined, event: MouseEvent | undefined, updateThemeCallback: () => void): void;
+//# sourceMappingURL=theme-transitions.d.ts.map

package/dist/providers/theme-transitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-transitions.d.ts","sourceRoot":"","sources":["../../src/providers/theme-transitions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AA2CvD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,YAAS,EAC5B,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,mBAAmB,EAAE,MAAM,IAAI,QAmFhC"}

package/dist/providers/theme-transitions.js

@@ -0,0 +1,115 @@
+/**
+ * Injects required CSS view-transition pseudo-element styles to prevent browser mix-blend artifacts.
+ */
+function ensureTransitionStyles() {
+    if (typeof document === "undefined")
+        return;
+    const styleId = "nikala-view-transition-styles";
+    if (!document.getElementById(styleId)) {
+        const style = document.createElement("style");
+        style.id = styleId;
+        style.textContent = `
+      ::view-transition-old(root),
+      ::view-transition-new(root) {
+        animation: none;
+        mix-blend-mode: normal;
+      }
+      ::view-transition-old(root) {
+        z-index: 1;
+      }
+      ::view-transition-new(root) {
+        z-index: 9999;
+      }
+    `;
+        document.head.appendChild(style);
+    }
+}
+/**
+ * Checks whether the current environment is Linux WebKitGTK (e.g. Tauri on Linux)
+ * where CSS View Transitions pseudo-element animations trigger known WebProcess crashes.
+ */
+function isLinuxWebKit() {
+    if (typeof navigator === "undefined")
+        return false;
+    const ua = navigator.userAgent || "";
+    const isLinux = /linux/i.test(ua);
+    const isWebKit = /applewebkit/i.test(ua);
+    const isChrome = /chrome|chromium|edg/i.test(ua);
+    const isTauri = typeof window !== "undefined" && typeof window.__TAURI_INTERNALS__ !== "undefined";
+    return isLinux && ((isWebKit && !isChrome) || isTauri);
+}
+/**
+ * Executes a theme change with the specified transition effect using the Web View Transitions API.
+ * Supported on modern browsers, Windows (Tauri WebView2), and macOS (Tauri WKWebView).
+ * Automatically falls back to safe instant transitions on Linux WebKitGTK.
+ *
+ * @param effect - Desired transition animation ("none", "circular", "fade")
+ * @param event - Mouse or Pointer event to calculate transition center coordinates
+ * @param updateThemeCallback - Callback function performing the actual theme state change
+ */
+export function runThemeTransition(effect = "none", event, updateThemeCallback) {
+    // Safe fallback if View Transitions API is unsupported, reduced motion is preferred,
+    // or on Linux WebKitGTK where pseudo-element clipping transitions trigger WebProcess faults
+    if (effect === "none" ||
+        typeof document === "undefined" ||
+        !document.startViewTransition ||
+        window.matchMedia("(prefers-reduced-motion: reduce)").matches ||
+        isLinuxWebKit()) {
+        updateThemeCallback();
+        return;
+    }
+    ensureTransitionStyles();
+    try {
+        // Circular expanding ripple transition originating from click coordinates
+        if (effect === "circular" && event) {
+            const x = event.clientX;
+            const y = event.clientY;
+            const endRadius = Math.hypot(Math.max(x, window.innerWidth - x), Math.max(y, window.innerHeight - y));
+            const transition = document.startViewTransition(() => {
+                updateThemeCallback();
+            });
+            transition.ready
+                ?.then(() => {
+                document.documentElement.animate({
+                    clipPath: [
+                        `circle(0px at ${x}px ${y}px)`,
+                        `circle(${endRadius}px at ${x}px ${y}px)`,
+                    ],
+                }, {
+                    duration: 500,
+                    easing: "ease-in-out",
+                    pseudoElement: "::view-transition-new(root)",
+                });
+            })
+                ?.catch(() => {
+                // Graceful fallback
+            });
+            return;
+        }
+        // Smooth opacity fade view transition
+        if (effect === "fade") {
+            const transition = document.startViewTransition(() => {
+                updateThemeCallback();
+            });
+            transition.ready
+                ?.then(() => {
+                document.documentElement.animate({
+                    opacity: [0, 1],
+                }, {
+                    duration: 350,
+                    easing: "ease-in-out",
+                    pseudoElement: "::view-transition-new(root)",
+                });
+            })
+                ?.catch(() => {
+                // Graceful fallback
+            });
+            return;
+        }
+        updateThemeCallback();
+    }
+    catch {
+        updateThemeCallback();
+    }
+}
+//# sourceMappingURL=theme-transitions.js.map