chore: import upstream snapshot with attribution

2026-07-13 13:39:12 +08:00
commit d8dcd5f6d1
8604 changed files with 2479390 additions and 0 deletions
@@ -0,0 +1,103 @@
+/**
+ * Theme Manager Plugin — injects CSS custom properties into HTML responses.
+ *
+ * Reads the X-User-Theme header from requests, merges with plugin config,
+ * and injects CSS variables into HTML responses via a <style> tag.
+ *
+ * @module theme-manager
+ */
+
+const DEFAULT_THEMES = {
+  light: {
+    "--bg-primary": "#ffffff",
+    "--bg-secondary": "#f5f5f5",
+    "--text-primary": "#1a1a1a",
+    "--text-secondary": "#666666",
+    "--border-color": "#e0e0e0",
+    "--shadow": "0 1px 3px rgba(0,0,0,0.1)",
+  },
+  dark: {
+    "--bg-primary": "#1a1a1a",
+    "--bg-secondary": "#2d2d2d",
+    "--text-primary": "#f5f5f5",
+    "--text-secondary": "#a0a0a0",
+    "--border-color": "#404040",
+    "--shadow": "0 1px 3px rgba(0,0,0,0.4)",
+  },
+};
+
+function resolveThemeMode(darkMode, header) {
+  if (header === "light" || header === "dark") return header;
+  if (darkMode === "light" || darkMode === "dark") return darkMode;
+  return "light";
+}
+
+function buildCssVariables(mode, config) {
+  const base = DEFAULT_THEMES[mode] || DEFAULT_THEMES.light;
+  const vars = { ...base };
+  if (config.primaryColor) vars["--color-primary"] = config.primaryColor;
+  if (config.borderRadius) vars["--border-radius"] = config.borderRadius;
+  if (config.fontFamily) vars["--font-family"] = config.fontFamily;
+  return vars;
+}
+
+function varsToCss(vars) {
+  return Object.entries(vars)
+    .map(([k, v]) => `  ${k}: ${v};`)
+    .join("\n");
+}
+
+/**
+ * onRequest hook — reads X-User-Theme header and stores resolved mode in metadata.
+ */
+export function onRequest(ctx) {
+  const config = ctx?.config || {};
+  const header = ctx?.headers?.["x-user-theme"] || ctx?.headers?.["X-User-Theme"];
+  const mode = resolveThemeMode(config.darkMode, header);
+  if (ctx?.metadata) {
+    ctx.metadata.__themeMode = mode;
+  }
+}
+
+/**
+ * onResponse hook — injects <style> tag with CSS variables into HTML responses.
+ */
+export function onResponse(ctx, response) {
+  const config = ctx?.config || {};
+  const mode = ctx?.metadata?.__themeMode || "light";
+
+  const isHtml =
+    response?.headers?.["content-type"]?.includes("text/html") ||
+    typeof response?.body === "string" &&
+      (response.body.includes("<!DOCTYPE html>") || response.body.includes("<html"));
+
+  if (!isHtml || typeof response?.body !== "string") return response;
+
+  const vars = buildCssVariables(mode, config);
+  const styleTag = `<style id="omniroute-theme">\n:root {\n${varsToCss(vars)}\n}\n</style>`;
+
+  const body = response.body.replace(/<head([^>]*)>/i, `<head$1>${styleTag}`);
+
+  return { ...response, body };
+}
+
+/**
+ * onInstall lifecycle hook — log installation.
+ */
+export function onInstall(ctx) {
+  console.log(`[theme-manager] Installed v${ctx?.version || "unknown"}`);
+}
+
+/**
+ * onActivate lifecycle hook — log activation.
+ */
+export function onActivate(ctx) {
+  console.log(`[theme-manager] Activated with config:`, ctx?.config || {});
+}
+
+/**
+ * onDeactivate lifecycle hook — log deactivation.
+ */
+export function onDeactivate(ctx) {
+  console.log(`[theme-manager] Deactivated`);
+}
@@ -0,0 +1,46 @@
+{
+  "name": "theme-manager",
+  "version": "1.0.0",
+  "description": "Dynamic UI theme management via CSS variable injection",
+  "author": "OmniRoute",
+  "license": "MIT",
+  "main": "index.mjs",
+  "source": "local",
+  "tags": ["theme", "ui", "css", "customization"],
+  "hooks": {
+    "onRequest": true,
+    "onResponse": true,
+    "onError": false,
+    "onInstall": true,
+    "onActivate": true,
+    "onDeactivate": true,
+    "onUninstall": false
+  },
+  "requires": {
+    "permissions": []
+  },
+  "enabledByDefault": true,
+  "configSchema": {
+    "primaryColor": {
+      "type": "string",
+      "default": "#6C5CE7",
+      "description": "Primary accent color (CSS hex value)"
+    },
+    "darkMode": {
+      "type": "select",
+      "default": "auto",
+      "enum": ["light", "dark", "auto"],
+      "description": "Theme mode preference"
+    },
+    "borderRadius": {
+      "type": "string",
+      "default": "8px",
+      "description": "Default border radius for UI elements"
+    },
+    "fontFamily": {
+      "type": "string",
+      "default": "Inter, system-ui, sans-serif",
+      "description": "Default font family"
+    }
+  }
+}