nuxt-users 1.41.0 → 1.41.1

package/dist/module.d.mts

@@ -1,5 +1,5 @@
 import * as _nuxt_schema from '@nuxt/schema';
-import { M as ModuleOptions } from './shared/nuxt-users.XW6DYM7t.mjs';
+import { M as ModuleOptions } from './shared/nuxt-users.DUmdxjpk.mjs';
 export * from '../dist/runtime/server/internal/index.js';
 
 declare const defaultOptions: ModuleOptions;

package/dist/module.d.ts

@@ -1,5 +1,5 @@
 import * as _nuxt_schema from '@nuxt/schema';
-import { M as ModuleOptions } from './shared/nuxt-users.XW6DYM7t.js';
+import { M as ModuleOptions } from './shared/nuxt-users.DUmdxjpk.js';
 export * from '../dist/runtime/server/internal/index.js';
 
 declare const defaultOptions: ModuleOptions;

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": ">=3.0.0"
   },
-  "version": "1.41.0",
+  "version": "1.41.1",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -56,8 +56,11 @@ const defaultOptions = {
     fallbackLocale: "en",
     texts: {}
   },
-  tokenCleanupSchedule: "0 2 * * *"
+  tokenCleanupSchedule: "0 2 * * *",
   // Daily at 2 AM
+  theme: {
+    enabled: true
+  }
 };
 const module$1 = defineNuxtModule({
   meta: {
@@ -122,6 +125,7 @@ const module$1 = defineNuxtModule({
     nuxt.options.runtimeConfig.public.nuxtUsers = {
       passwordValidation: runtimeConfigOptions.passwordValidation,
       locale: runtimeConfigOptions.locale,
+      theme: runtimeConfigOptions.theme,
       auth: {
         whitelist: (() => {
           const combinedWhitelist = [...defaultOptions.auth?.whitelist || [], ...runtimeConfigOptions.auth?.whitelist || []];

package/dist/runtime/composables/useTheme.d.ts

@@ -0,0 +1,40 @@
+import type { Ref } from 'vue';
+export type ThemeMode = 'light' | 'dark' | 'system';
+export interface UseThemeReturn {
+    /**
+     * Current theme mode
+     */
+    theme: Ref<ThemeMode>;
+    /**
+     * Current resolved theme (system resolved to actual light/dark)
+     */
+    resolvedTheme: Ref<'light' | 'dark'>;
+    /**
+     * Set the theme mode
+     */
+    setTheme: (mode: ThemeMode) => void;
+    /**
+     * Toggle between light and dark themes
+     */
+    toggleTheme: () => void;
+}
+/**
+ * Composable for managing theme state in nuxt-users module
+ *
+ * This composable provides a reactive theme state that can be shared
+ * between the module and consumer applications.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * const { theme, setTheme, toggleTheme } = useTheme()
+ * </script>
+ *
+ * <template>
+ *   <button @click="toggleTheme">
+ *     Current: {{ theme }}
+ *   </button>
+ * </template>
+ * ```
+ */
+export declare const useTheme: () => UseThemeReturn;

package/dist/runtime/composables/useTheme.js

@@ -0,0 +1,47 @@
+import { useState } from "#app";
+export const useTheme = () => {
+  const theme = useState("nuxt-users-theme", () => "system");
+  const resolvedTheme = useState("nuxt-users-resolved-theme", () => "light");
+  const resolveTheme = () => {
+    if (theme.value === "system") {
+      if (typeof window === "undefined") {
+        return "light";
+      }
+      return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
+    }
+    return theme.value;
+  };
+  const applyTheme = (resolved) => {
+    if (typeof document === "undefined") {
+      return;
+    }
+    if (resolved === "dark") {
+      document.documentElement.classList.add("dark");
+    }
+    if (resolved === "light") {
+      document.documentElement.classList.remove("dark");
+    }
+    resolvedTheme.value = resolved;
+  };
+  const setTheme = (mode) => {
+    theme.value = mode;
+    const resolved = resolveTheme();
+    applyTheme(resolved);
+    if (typeof window !== "undefined") {
+      window.dispatchEvent(new CustomEvent("nuxt-users:theme-change", {
+        detail: { mode, resolved }
+      }));
+    }
+  };
+  const toggleTheme = () => {
+    const current = resolveTheme();
+    const newMode = current === "dark" ? "light" : "dark";
+    setTheme(newMode);
+  };
+  return {
+    theme,
+    resolvedTheme,
+    setTheme,
+    toggleTheme
+  };
+};

package/dist/runtime/plugin.theme.d.ts

@@ -1,8 +1,21 @@
 /**
- * Theme detection plugin
+ * Theme detection plugin with hybrid detection support
  *
- * Automatically applies dark theme class based on system preferences.
- * Listens for changes to system theme and updates accordingly.
+ * This plugin provides flexible theme management that works seamlessly
+ * with consumer applications that have their own theme systems.
+ *
+ * Detection methods:
+ * 1. System preference changes (prefers-color-scheme)
+ * 2. DOM class changes via MutationObserver (consumer app control)
+ * 3. Custom events (consumer app notification)
+ * 4. Shared state via useTheme composable
+ *
+ * The plugin respects consumer app theme changes and won't conflict
+ * with external theme management systems.
  */
-declare const _default: import("#app").Plugin<Record<string, unknown>> & import("#app").ObjectPlugin<Record<string, unknown>>;
+declare const _default: import("#app").Plugin<{
+    nuxtUsersTheme: import("./composables/useTheme.js").UseThemeReturn;
+}> & import("#app").ObjectPlugin<{
+    nuxtUsersTheme: import("./composables/useTheme.js").UseThemeReturn;
+}>;
 export default _default;

package/dist/runtime/plugin.theme.js

@@ -1,27 +1,92 @@
-import { defineNuxtPlugin } from "#app";
+import { defineNuxtPlugin, useRuntimeConfig } from "#app";
+import { useTheme } from "./composables/useTheme.js";
 export default defineNuxtPlugin(() => {
   if (import.meta.server) {
     return;
   }
-  const applyTheme = () => {
-    if (typeof window === "undefined" || typeof document === "undefined") {
+  const config = useRuntimeConfig();
+  const themeConfig = config.public?.nuxtUsers?.theme;
+  if (themeConfig?.enabled === false) {
+    return;
+  }
+  const { setTheme, theme } = useTheme();
+  let isInternalChange = false;
+  const syncThemeFromDOM = () => {
+    if (isInternalChange) {
+      return;
+    }
+    if (typeof document === "undefined") {
       return;
     }
-    const prefersDark = window.matchMedia("(prefers-color-scheme: dark)").matches;
-    if (prefersDark) {
-      document.documentElement.classList.add("dark");
+    const isDark = document.documentElement.classList.contains("dark");
+    const currentResolved = window.matchMedia("(prefers-color-scheme: dark)").matches;
+    if (isDark) {
+      theme.value = "dark";
     }
-    if (!prefersDark) {
-      document.documentElement.classList.remove("dark");
+    if (!isDark && !currentResolved) {
+      theme.value = "light";
+    }
+    if (!isDark && currentResolved) {
+      theme.value = "light";
+    }
+  };
+  const handleSystemThemeChange = () => {
+    if (theme.value === "system") {
+      isInternalChange = true;
+      setTheme("system");
+      isInternalChange = false;
     }
   };
-  applyTheme();
   if (typeof window !== "undefined" && window.matchMedia) {
     const mediaQuery = window.matchMedia("(prefers-color-scheme: dark)");
     if (mediaQuery.addEventListener) {
-      mediaQuery.addEventListener("change", applyTheme);
-    } else if (mediaQuery.addListener) {
-      mediaQuery.addListener(applyTheme);
+      mediaQuery.addEventListener("change", handleSystemThemeChange);
+    }
+    if (mediaQuery.addListener) {
+      mediaQuery.addListener(handleSystemThemeChange);
     }
   }
+  if (typeof window !== "undefined" && typeof MutationObserver !== "undefined") {
+    const observer = new MutationObserver(() => {
+      syncThemeFromDOM();
+    });
+    observer.observe(document.documentElement, {
+      attributes: true,
+      attributeFilter: ["class"]
+    });
+  }
+  if (typeof window !== "undefined") {
+    window.addEventListener("theme-change", (event) => {
+      const customEvent = event;
+      const newTheme = customEvent.detail?.theme;
+      if (newTheme === "light" || newTheme === "dark") {
+        isInternalChange = true;
+        setTheme(newTheme);
+        isInternalChange = false;
+      }
+    });
+    window.addEventListener("color-scheme-change", (event) => {
+      const customEvent = event;
+      const newTheme = customEvent.detail?.colorScheme || customEvent.detail?.theme;
+      if (newTheme === "light" || newTheme === "dark") {
+        isInternalChange = true;
+        setTheme(newTheme);
+        isInternalChange = false;
+      }
+    });
+  }
+  if (typeof document !== "undefined") {
+    const hasExistingDarkClass = document.documentElement.classList.contains("dark");
+    if (hasExistingDarkClass) {
+      theme.value = "dark";
+    }
+    if (!hasExistingDarkClass) {
+      setTheme("system");
+    }
+  }
+  return {
+    provide: {
+      nuxtUsersTheme: useTheme()
+    }
+  };
 });

package/dist/shared/{nuxt-users.XW6DYM7t.d.mts → nuxt-users.DUmdxjpk.d.mts}

@@ -192,6 +192,18 @@ interface RuntimeModuleOptions {
      * Locale configuration for component labels and messages
      */
     locale?: LocaleOptions;
+    /**
+     * Theme configuration for color scheme management
+     */
+    theme?: {
+        /**
+         * Enable the automatic theme plugin
+         * When disabled, the module won't manage themes automatically,
+         * allowing consumer apps full control over theme management
+         * @default true
+         */
+        enabled?: boolean;
+    };
 }
 interface ModuleOptions {
     connector: {
@@ -235,6 +247,18 @@ interface ModuleOptions {
      * Default: '0 2 * * *' (daily at 2 AM)
      */
     tokenCleanupSchedule?: string | false | null;
+    /**
+     * Theme configuration for color scheme management
+     */
+    theme?: {
+        /**
+         * Enable the automatic theme plugin
+         * When disabled, the module won't manage themes automatically,
+         * allowing consumer apps full control over theme management
+         * @default true
+         */
+        enabled?: boolean;
+    };
 }
 interface MailerOptions {
     host: string;

package/dist/shared/{nuxt-users.XW6DYM7t.d.ts → nuxt-users.DUmdxjpk.d.ts}

@@ -192,6 +192,18 @@ interface RuntimeModuleOptions {
      * Locale configuration for component labels and messages
      */
     locale?: LocaleOptions;
+    /**
+     * Theme configuration for color scheme management
+     */
+    theme?: {
+        /**
+         * Enable the automatic theme plugin
+         * When disabled, the module won't manage themes automatically,
+         * allowing consumer apps full control over theme management
+         * @default true
+         */
+        enabled?: boolean;
+    };
 }
 interface ModuleOptions {
     connector: {
@@ -235,6 +247,18 @@ interface ModuleOptions {
      * Default: '0 2 * * *' (daily at 2 AM)
      */
     tokenCleanupSchedule?: string | false | null;
+    /**
+     * Theme configuration for color scheme management
+     */
+    theme?: {
+        /**
+         * Enable the automatic theme plugin
+         * When disabled, the module won't manage themes automatically,
+         * allowing consumer apps full control over theme management
+         * @default true
+         */
+        enabled?: boolean;
+    };
 }
 interface MailerOptions {
     host: string;

package/dist/utils.d.mts

@@ -1,7 +1,7 @@
 export { defaultLocaleMessages, en, hu, huFormal } from '../dist/runtime/locales/index.js';
 export { getNestedValue, getTranslation } from '../dist/runtime/utils/locale.js';
 export { deepMerge } from '../dist/runtime/utils/deep-merge.js';
-export { g as DatabaseConfig, f as DatabaseType, D as DisplayFieldsProps, G as GoogleOAuthOptions, i as LocaleMessages, h as LocaleOptions, L as LoginFormData, c as LoginFormProps, M as ModuleOptions, b as PasswordResetToken, e as Permission, P as PersonalAccessToken, d as ResetPasswordFormProps, R as RuntimeModuleOptions, U as User, a as UserWithoutPassword, j as defaultDisplayFields, k as defaultFieldLabels } from './shared/nuxt-users.XW6DYM7t.mjs';
+export { g as DatabaseConfig, f as DatabaseType, D as DisplayFieldsProps, G as GoogleOAuthOptions, i as LocaleMessages, h as LocaleOptions, L as LoginFormData, c as LoginFormProps, M as ModuleOptions, b as PasswordResetToken, e as Permission, P as PersonalAccessToken, d as ResetPasswordFormProps, R as RuntimeModuleOptions, U as User, a as UserWithoutPassword, j as defaultDisplayFields, k as defaultFieldLabels } from './shared/nuxt-users.DUmdxjpk.mjs';
 
 interface PasswordValidationResult {
     isValid: boolean;

package/dist/utils.d.ts

@@ -1,7 +1,7 @@
 export { defaultLocaleMessages, en, hu, huFormal } from '../dist/runtime/locales/index.js';
 export { getNestedValue, getTranslation } from '../dist/runtime/utils/locale.js';
 export { deepMerge } from '../dist/runtime/utils/deep-merge.js';
-export { g as DatabaseConfig, f as DatabaseType, D as DisplayFieldsProps, G as GoogleOAuthOptions, i as LocaleMessages, h as LocaleOptions, L as LoginFormData, c as LoginFormProps, M as ModuleOptions, b as PasswordResetToken, e as Permission, P as PersonalAccessToken, d as ResetPasswordFormProps, R as RuntimeModuleOptions, U as User, a as UserWithoutPassword, j as defaultDisplayFields, k as defaultFieldLabels } from './shared/nuxt-users.XW6DYM7t.js';
+export { g as DatabaseConfig, f as DatabaseType, D as DisplayFieldsProps, G as GoogleOAuthOptions, i as LocaleMessages, h as LocaleOptions, L as LoginFormData, c as LoginFormProps, M as ModuleOptions, b as PasswordResetToken, e as Permission, P as PersonalAccessToken, d as ResetPasswordFormProps, R as RuntimeModuleOptions, U as User, a as UserWithoutPassword, j as defaultDisplayFields, k as defaultFieldLabels } from './shared/nuxt-users.DUmdxjpk.js';
 
 interface PasswordValidationResult {
     isValid: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-users",
-  "version": "1.41.0",
+  "version": "1.41.1",
   "description": "A comprehensive user management module for Nuxt 3 and Nuxt 4 applications with authentication, authorization, database support, and CLI tools",
   "keywords": [
     "nuxt",
@@ -66,7 +66,7 @@
     "check:locale-consistency": "tsx scripts/check-locale-consistency.ts",
     "check:npm_token": "dotenv -- sh -c 'if [ -z \"$NPM_TOKEN\" ]; then echo \"❌ NPM_TOKEN environment variable is not set in .env file. Please set it to your npm token.\"; exit 1; fi'",
     "prerelease": "node -v | grep -q 'v22' || (echo 'Please use Node.js v22 for deployment' && exit 1)",
-    "release": "yarn check:npm_token && yarn lint && yarn check:translations && yarn check:locale-consistency && yarn test && yarn prepack && dotenv -- changelogen --release && dotenv -- npm publish --registry https://registry.npmjs.org/ && git push --follow-tags",
+    "release": "yarn check:npm_token && yarn lint && yarn check:translations && yarn check:locale-consistency && yarn test && yarn prepack && dotenv -- changelogen --release && dotenv -- sh -c 'npm publish --//registry.npmjs.org/:_authToken=$NPM_TOKEN --registry https://registry.npmjs.org/' && git push --follow-tags",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "pretest": "node -v | grep -q 'v22' || (echo 'Please use Node.js v22 for testing' && exit 1)",