@nikala-ui/folio 0.13.0

package/dist/vendor/docs-src/providers/theme-script.tsx

@@ -0,0 +1,54 @@
+import { isServer } from "solid-js/web";
+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 const ThemeScript: Component<ThemeScriptProps> = (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} />;
+};

package/dist/vendor/docs-src/providers/theme-transitions.ts

@@ -0,0 +1,139 @@
+export type ThemeEffect = "none" | "circular" | "fade";
+
+/**
+ * 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(): boolean {
+  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 as any).__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: ThemeEffect = "none",
+  event: MouseEvent | undefined,
+  updateThemeCallback: () => void
+) {
+  // 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 as any).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 as any).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 as any).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();
+  }
+}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const FOLIO_VERSION = "0.13.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,WAAW,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const FOLIO_VERSION = "0.13.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC"}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@nikala-ui/folio",
+  "version": "0.13.0",
+  "description": "Zero-config, fast, and elegant documentation engine for SolidJS, built on Nikala UI and Tailwind CSS v4",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "folio": "./dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/server/plugin.d.ts",
+      "import": "./dist/server/plugin.js"
+    },
+    "./theme": {
+      "types": "./dist/themes/default/index.d.ts",
+      "import": "./dist/themes/default/index.js"
+    },
+    "./themes": {
+      "types": "./dist/themes/index.d.ts",
+      "import": "./dist/themes/index.js"
+    },
+    "./themes/*": {
+      "types": "./dist/themes/*/index.d.ts",
+      "import": "./dist/themes/*/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nikala-ui/folio.git"
+  },
+  "scripts": {
+    "typecheck": "bunx tsc --noEmit -p tsconfig.json",
+    "test": "bun test tests",
+    "test:browser": "bun tests/ssr-preview.playwright.ts",
+    "test:generated": "bun tests/generated-project.smoke.ts",
+    "package:check": "bun run build && bun scripts/check-package.ts",
+    "bundle:check": "bun run docs:build && bun scripts/check-bundle.ts",
+    "bump": "bun scripts/bump.ts",
+    "build": "bun scripts/build.ts",
+    "docs:dev": "bun run build && bun dist/cli/index.js dev",
+    "docs:build": "bun run build && bun dist/cli/index.js build -o .docs-dist",
+    "docs:preview": "bun run build && bun dist/cli/index.js build -o .docs-dist && bun dist/cli/index.js preview -o .docs-dist",
+    "check": "bun run typecheck && bun run test && bun run build && bun run docs:build",
+    "dev": "tsc -p tsconfig.build.json --watch"
+  },
+  "dependencies": {
+    "@nikala-ui/cli": "0.12.2",
+    "@kobalte/core": "^0.13.12",
+    "@mdx-js/mdx": "^3.1.0",
+    "@mdx-js/rollup": "^3.1.0",
+    "@shikijs/langs": "^4.4.3",
+    "@shikijs/themes": "^4.4.3",
+    "@tailwindcss/vite": "^4.0.7",
+    "chokidar": "^5.0.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "commander": "^15.0.0",
+    "corvu": "^0.7.2",
+    "fs-extra": "^11.3.6",
+    "gray-matter": "^4.0.3",
+    "lucide-solid": "^1.28.0",
+    "picocolors": "^1.1.1",
+    "rehype-autolink-headings": "^7.1.0",
+    "rehype-slug": "^6.0.0",
+    "remark-gfm": "^4.0.0",
+    "shiki": "^4.4.3",
+    "tailwind-merge": "^3.6.0",
+    "vite": "^8.2.2",
+    "vite-plugin-solid": "^2.11.14"
+  },
+  "peerDependencies": {
+    "solid-js": ">=1.9.0",
+    "tailwindcss": ">=4.0.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^26.1.1",
+    "playwright": "1.63.0",
+    "solid-js": "^1.9.14",
+    "tailwindcss": "^4.0.7",
+    "typescript": "^7.0.2"
+  }
+}