nuxt-ignis 0.5.3 → 0.6.0-rc.2

package/bin/setup.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 
+import { readFileSync } from 'node:fs'
 import {
   createFileFromWebTemplate, deletePath, getPackageManager, hasJsonKey,
   pathExists, promptUser, removeFromJsonFile, showMessage,
@@ -14,12 +15,15 @@ import {
  * The script will first ask whether to run in "auto" mode (no prompts, force = true) or "manual" mode (with prompts, force = false). If `autoRun = true` is passed, no prompt will be shown.
  *
  * The script will:
- *  1) add `nuxt-ignis` into `package.json` dependencies, remove `nuxt`, `vue` and `vue-router` if present and adjust `pnpm` settings if `pnpm` is used
- *  2) add `extends: ['nuxt-ignis']` to `nuxt.config.ts`
- *  3) create/update `.npmrc` file (only if pnpm is used)
- *  4) update `.gitignore` file
- *  5) create default `vitest.config.ts` file and add test-related scripts into `package.json`
- *  6) clear node_modules and lock file(s)
+ *  1) add `nuxt-ignis` into `package.json` dependencies
+ *  2) remove `nuxt`, `vue` and `vue-router` if present
+ *  3) and `packageManager` setting (only if pnpm is used)
+ *  4) create/update `pnpm-workspace.yaml` file (only if pnpm is used)
+ *  5) add `extends: ['nuxt-ignis']` to `nuxt.config.ts`
+ *  6) update `.gitignore` file
+ *  7) replace default Nuxt `app/app.vue` with Nuxt Ignis default (if detected)
+ *  8) create default `vitest.config.ts` file and add test-related scripts into `package.json`
+ *  9) clear node_modules and lock file(s)
  */
 export async function nuxtIgnisSetup(autoRun = false) {
   showMessage('NUXT IGNIS SETUP')
@@ -31,15 +35,15 @@ export async function nuxtIgnisSetup(autoRun = false) {
 
   const packageManager = getPackageManager()
 
-  // 1.1 - add nuxt-ignis dependency
+  // 1 - add nuxt-ignis dependency to package.json
   try {
-    await updateJsonFile('package.json', 'dependencies', { 'nuxt-ignis': '0.5.3' },
+    await updateJsonFile('package.json', 'dependencies', { 'nuxt-ignis': '0.6.0-rc.2' },
       isAutoRun, 'This will add \'nuxt-ignis\' dependency to your \'package.json\'. Proceed?')
   } catch (error) {
     console.error('Error adding \'nuxt-ignis\' dependency:\n', error.message)
   }
 
-  // 1.2 - remove now obsolete nuxt, vue and vue-router
+  // 2 - remove now obsolete nuxt, vue and vue-router from package.json
   const removeDeps = isAutoRun || await promptUser('As \'nuxt-ignis\' provides \'nuxt\', \'vue\' and \'vue-router\' dependencies out of the box, do you want to remove them from your \'package.json\' to avoid duplications and possible version clashes?')
   if (removeDeps) {
     if (hasJsonKey('package.json', 'dependencies.nuxt')) {
@@ -86,38 +90,35 @@ export async function nuxtIgnisSetup(autoRun = false) {
     }
   }
 
-  // 1.3 - adjust pnpm settings
+  // 3 - adjust pnpm settings in package.json (only if pnpm is used)
   if (packageManager === 'pnpm') {
-    const pnpmSettings = isAutoRun || await promptUser('This will adjust pnpm settings in your \'package.json\'. Proceed?')
+    const pnpmSettings = isAutoRun || await promptUser('This will add package manager definition in your \'package.json\'. Proceed?')
     if (pnpmSettings) {
-      try {
-        // allow related build scripts
-        await updateJsonFile('package.json', 'pnpm', {
-          onlyBuiltDependencies: [
-            '@parcel/watcher',
-            '@tailwindcss/oxide',
-            'better-sqlite3',
-            'esbuild',
-            'maplibre-gl',
-            'puppeteer',
-            'sharp',
-            'unrs-resolver',
-            'vue-demi',
-          ],
-        }, true)
-      } catch (error) {
-        console.error('Error adjusting pnpm settings:\n', error.message)
-      }
       // set pnpm as package manager
       try {
-        await updateJsonFile('package.json', 'packageManager', 'pnpm@10.26.2', true)
+        await updateJsonFile('package.json', 'packageManager', 'pnpm@11.1.3', true)
       } catch (error) {
         console.error('Error setting packageManager:\n', error.message)
       }
     }
   }
 
-  // 2 - add nuxt-ignis module to nuxt.config.ts
+  // 4 - pnpm-workspace.yaml file (only if pnpm is used)
+  if (packageManager === 'pnpm') {
+    try {
+      if (pathExists('pnpm-workspace.yaml')) {
+        await updateTextFile('pnpm-workspace.yaml', ['shamefully-hoist: true'], isAutoRun,
+          'This will adjust \'pnpm-workspace.yaml\' file in your project. Continue?')
+      } else {
+        await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-ignis/refs/tags/v0.6.0-rc.2/bin/templates/pnpm-workspace.yaml.template',
+          'pnpm-workspace.yaml', isAutoRun, 'This will add \'pnpm-workspace.yaml\' file for your project. Continue?')
+      }
+    } catch (error) {
+      console.error('Error setting \'pnpm-workspace.yaml\':\n', error.message)
+    }
+  }
+
+  // 5 - add nuxt-ignis module to nuxt.config.ts
   try {
     await updateConfigFile('nuxt.config.ts', {
       extends: [
@@ -128,39 +129,46 @@ export async function nuxtIgnisSetup(autoRun = false) {
     console.error('Error enabling \'nuxt-ignis\' module:\n', error.message)
   }
 
-  // 3 - .npmrc file (only if pnpm is used)
-  if (packageManager === 'pnpm') {
-    try {
-      if (pathExists('.npmrc')) {
-        await updateTextFile('.npmrc', ['shamefully-hoist=true'], isAutoRun,
-          'This will adjust \'.npmrc\' file in your project. Continue?')
-      } else {
-        await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-ignis/refs/tags/v0.5.3/core/.npmrc',
-          '.npmrc', isAutoRun, 'This will add \'.npmrc\' file for your project. Continue?')
-      }
-    } catch (error) {
-      console.error('Error setting \'.npmrc\':\n', error.message)
-    }
-  }
-
-  // 4 - .gitignore file
+  // 6 - .gitignore file
   try {
     await updateTextFile('.gitignore', [
       '',
       '# Nuxt Ignis files',
       '# configuration overview created upon Nuxt Ignis start',
       '_ignis-config.json',
+      '_nuxt-config.json',
     ], isAutoRun, 'This will add Nuxt Ignis-related entries into your \'.gitignore\'. Continue?')
   } catch (error) {
     console.error('Error updating .gitignore file:\n', error.message)
   }
 
-  // 5) nuxt-spec related setup
+  // 7 - replace default Nuxt app.vue with Nuxt Ignis default
+  if (pathExists('app/app.vue')) {
+    let appVueContent = ''
+    try {
+      appVueContent = readFileSync('app/app.vue', 'utf-8')
+    } catch (error) {
+      // ignore read errors
+      console.warn('Failed to read existing \'app/app.vue\':\n', error.message)
+    }
+    if (appVueContent.includes('<NuxtWelcome />')) {
+      const replaceAppVue = isAutoRun || await promptUser('Default Nuxt \'app/app.vue\' detected. This will replace it with Nuxt Ignis default. Continue?')
+      if (replaceAppVue) {
+        try {
+          await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-ignis/refs/tags/v0.6.0-rc.2/core/app/app.vue', 'app/app.vue', true)
+        } catch (error) {
+          console.error('Error replacing \'app/app.vue\':\n', error.message)
+        }
+      }
+    }
+  }
+
+  // 8 - nuxt-spec related setup
   const setupNuxtSpec = isAutoRun || await promptUser('Nuxt Ignis comes with support for testing. Do you want to set up the default test settings now?')
   if (setupNuxtSpec) {
     // create vitest.config.ts
     try {
-      await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.1.14/config/vitest.config.ts.template',
+      await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.2/config/templates/vitest.config.ts.template',
         'vitest.config.ts', true, 'This will create a new \'vitest.config.ts\' file for your project. Continue?')
     } catch (error) {
       console.error('Error setting up \'vitest.config.ts\':\n', error.message)
@@ -181,27 +189,39 @@ export async function nuxtIgnisSetup(autoRun = false) {
     const createSampleTests = isAutoRun || await promptUser('Do you want to create sample tests in \'/test\' folder?')
     if (createSampleTests) {
       try {
-        await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.1.14/test/e2e/nuxt-e2e.test.ts',
+        await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.2/test/browser/vitest-browser.test.ts',
+          'test/browser/vitest-browser.test.ts', true)
+      } catch (error) {
+        console.error('Error setting up \'vitest-browser.test.ts\':\n', error.message)
+      }
+      try {
+        await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.2/test/e2e/nuxt-e2e.test.ts',
           'test/e2e/nuxt-e2e.test.ts', true)
       } catch (error) {
         console.error('Error setting up \'nuxt-e2e.test.ts\':\n', error.message)
       }
       try {
-        await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.1.14/test/nuxt/nuxt-unit.test.ts',
+        await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.2/test/e2e/nuxt-visual.test.ts',
+          'test/e2e/nuxt-visual.test.ts', true)
+      } catch (error) {
+        console.error('Error setting up \'nuxt-visual.test.ts\':\n', error.message)
+      }
+      try {
+        await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.2/test/nuxt/nuxt-unit.test.ts',
           'test/nuxt/nuxt-unit.test.ts', true)
       } catch (error) {
         console.error('Error setting up \'nuxt-unit.test.ts\':\n', error.message)
       }
       try {
-        await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.1.14/test/unit/vitest.test.ts',
-          'test/unit/vitest.test.ts', true)
+        await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.2/test/unit/vitest-unit.test.ts',
+          'test/unit/vitest-unit.test.ts', true)
       } catch (error) {
-        console.error('Error setting up \'vitest.test.ts\':\n', error.message)
+        console.error('Error setting up \'vitest-unit.test.ts\':\n', error.message)
       }
     }
   }
 
-  // 6) clear node_modules and lock file(s)
+  // 9 - clear node_modules and lock file(s)
   const prepareForReinstall = isAutoRun || await promptUser('Dependencies should be re-installed now. Do you want to remove node_modules and the lock file?')
   if (prepareForReinstall) {
     if (pathExists('node_modules')) {
@@ -248,7 +268,7 @@ export async function nuxtIgnisSetup(autoRun = false) {
     }
   }
 
-  // 7) inform user
+  // 9 - inform user
   showMessage('')
   showMessage('NUXT IGNIS SETUP COMPLETE', 2)
   showMessage(`Proceed with \`${packageManager} install\` to get started.`)

package/bin/templates/eslint.config.mjs.template

@@ -0,0 +1,5 @@
+import withNuxt from './.nuxt/eslint.config.mjs'
+
+export default withNuxt(
+  // your custom config here
+)

package/bin/templates/netlify.toml.template

@@ -0,0 +1,7 @@
+[build]
+  command = "pnpm install --frozen-lockfile && pnpm build"
+  publish = "dist"
+
+[build.environment]
+  NODE_VERSION = "24"
+  PNPM_VERSION = "10"

package/bin/templates/pnpm-workspace.yaml.template

@@ -0,0 +1,40 @@
+# settings for Nuxt & pnpm
+
+# https://pnpm.io/settings#shamefullyhoist
+# required to handle transitive dependencies 
+# without having to explicitly declare them
+shamefullyHoist: true
+
+# https://pnpm.io/settings#trustpolicy
+# for better supply-chain attack protection, new packages
+# cannot change their state from trusted to untrusted
+trustPolicy: no-downgrade
+
+# https://pnpm.io/settings#minimumreleaseage
+# for better supply-chain attack protection, new packages
+# cannot be installed unless they are at least 3 days old
+minimumReleaseAge: 4320
+
+# trusted and verified packages may be excluded
+minimumReleaseAgeExclude:
+  # nuxt-ignis must be excluded to allow installing latest
+  - nuxt-ignis 
+  # add more if needed
+  # - package-name
+
+# https://pnpm.io/settings#allowBuilds
+# pnpm naturally blocks all post-install scripts
+# some are required for development, others are not relevant
+allowBuilds:
+  # post-install scripts required for correct behavior
+  '@parcel/watcher': true
+  '@tailwindcss/oxide': true
+  esbuild: true
+  sharp: true
+  unrs-resolver: true
+  vue-demi: true
+  # post-install scripts that can be ignored
+  maplibre-gl: false
+  puppeteer: false
+  # add more if needed
+  # - package-name: boolean

package/bin/templates/vscode-settings.json.template

@@ -0,0 +1,19 @@
+{
+    // enable auto-linting
+    "editor.codeActionsOnSave": {
+        "source.fixAll": "explicit",
+        "source.fixAll.eslint": "explicit"
+    },
+    // ESlint flat config
+    "eslint.useFlatConfig": true,
+    // should resolve issues with tracking newly added files
+    "eslint.validate": [
+        "javascript",
+        "typescript",
+        "vue",
+    ],
+    // allow multiple eslint configurations
+    "eslint.workingDirectories": [
+        { "mode": "auto" },
+    ],
+}

package/i18n/locales/en.json

@@ -36,6 +36,7 @@
         "charts" : "Nuxt Charts for drawing charts with ease"
     },
     "config" : {
-        "header" : "Current Nuxt Ignis iteration was started with following config applied:"
+        "ignis" : "Current Nuxt Ignis iteration was started with following config applied:",
+        "nuxt" : "Fully resolved Nuxt config object for reference:"
     }
 }

package/modules/01-config.ts

@@ -0,0 +1,105 @@
+import { defineNuxtModule, useLogger } from 'nuxt/kit'
+import type { NuxtOptions, PublicRuntimeConfig } from 'nuxt/schema'
+
+// shared augmentable interface for all @nuxt-ignis/* submodules
+// submodules extending this via:
+// `declare module 'nuxt/schema' { interface IgnisPublicRuntimeConfig { ... } }`
+declare module 'nuxt/schema' {
+  interface IgnisPublicRuntimeConfig {
+    config?: IgnisConfigOptions
+  }
+  interface PublicRuntimeConfig {
+    ignis: IgnisPublicRuntimeConfig
+  }
+}
+
+export interface IgnisConfigOptions {
+  html?: {
+    // HTML lang attribute,
+    lang?: string
+    // HTML page title,
+    title?: string
+  }
+  // nuxt options
+  nuxt?: {
+    // use built-in SSR
+    ssr?: boolean
+    // use built-in file-based routing
+    pages?: boolean
+    // include custom CSS files
+    css?: string
+    // register central error handler
+    error?: boolean // true/false
+  }
+  // logging
+  log?: {
+    // default logging level
+    level?: 'info' | 'warn' | 'error' | 'debug'
+  }
+  // extra behavior
+  warn?: {
+    // warn when using more than one preset options
+    // i.e. both 'neon' and 'supabase', or both 'valibot' and 'zod'
+    duplicates?: boolean
+  }
+}
+
+// this module has no configKey of its own; the actual user-provided config
+// lives under `ignis.config` (configKey of the sibling 02-features module),
+// which is already normalized via `applyEnv()` in its moduleDependencies hook
+// before this setup runs.
+export type NuxtIgnisConfigOptions = Partial<NuxtOptions> & {
+  ignis: {
+    config?: IgnisConfigOptions
+  }
+}
+
+const logger = useLogger('ignis/config')
+
+export default defineNuxtModule<IgnisConfigOptions>({
+  meta: {
+    name: 'ignis/config',
+  },
+  setup(_options, nuxt) {
+    logger.debug('Nuxt Ignis Config module setup called!')
+
+    const options = (nuxt.options as NuxtIgnisConfigOptions).ignis?.config ?? {}
+
+    // inject runtime config values
+    const runtimeConfig = nuxt.options.runtimeConfig.public as PublicRuntimeConfig & { ignis: { config?: IgnisConfigOptions } }
+    runtimeConfig.ignis ??= {}
+    runtimeConfig.ignis.config ??= {}
+    runtimeConfig.ignis.config.html ??= {}
+    runtimeConfig.ignis.config.html.lang ??= options.html?.lang ?? 'en'
+    runtimeConfig.ignis.config.html.title ??= options.html?.title ?? 'Nuxt Ignis App'
+    runtimeConfig.ignis.config.nuxt ??= {}
+    runtimeConfig.ignis.config.nuxt.ssr ??= options.nuxt?.ssr ?? true
+    runtimeConfig.ignis.config.nuxt.pages ??= options.nuxt?.pages ?? true
+    runtimeConfig.ignis.config.nuxt.css ??= options.nuxt?.css ?? ''
+    runtimeConfig.ignis.config.nuxt.error ??= options.nuxt?.error ?? true
+    runtimeConfig.ignis.config.log ??= {}
+    runtimeConfig.ignis.config.log.level ??= options.log?.level ?? 'info'
+    runtimeConfig.ignis.config.warn ??= {}
+    runtimeConfig.ignis.config.warn.duplicates ??= options.warn?.duplicates ?? true
+
+    // additional processing
+
+    // apply Nuxt config options, if they differ from defaults
+    if (options.nuxt?.ssr === false) {
+      nuxt.options.ssr = false
+    }
+    if (options.nuxt?.pages === false) {
+      nuxt.options.pages = false
+    }
+    if (options.nuxt?.css) {
+      nuxt.options.css = options.nuxt.css.split(',').map(path => path.trim())
+    }
+
+    // apply basic HTML options
+    nuxt.options.app.head ||= {}
+    nuxt.options.app.head.title = runtimeConfig.ignis.config.html.title
+    nuxt.options.app.head.htmlAttrs = {
+      ...(nuxt.options.app.head.htmlAttrs || {}), lang: runtimeConfig.ignis.config.html.lang,
+    }
+  },
+})

package/modules/02-features.ts

@@ -0,0 +1,199 @@
+import { defineNuxtModule } from 'nuxt/kit'
+import type { NuxtOptions } from 'nuxt/schema'
+import type { IgnisConfigOptions } from './01-config'
+import type { IgnisDefaultOptions } from '@nuxt-ignis/default'
+import type { IgnisUIOptions } from '@nuxt-ignis/ui'
+import type { IgnisDBOptions } from '@nuxt-ignis/db'
+import type { IgnisFormsOptions } from '@nuxt-ignis/forms'
+import type { IgnisValidationOptions } from '@nuxt-ignis/validation'
+import type { IgnisContentOptions } from '@nuxt-ignis/content'
+import type { IgnisUtilsOptions } from '@nuxt-ignis/utils'
+import { envApply } from './utils/env-apply'
+import { envValidate } from './utils/env-validate'
+import { checkForDuplicateModules } from './utils/duplicates'
+import { resolveUiPreset, resolveDbPreset, resolveFormsPreset, resolveValidationPreset } from './utils/presets'
+import { isDefaultActive, isUiActive, isDbActive, isFormsActive, isValidationActive, isContentActive, isUtilsActive } from './utils/activation'
+
+declare module 'nuxt/schema' {
+  interface IgnisPublicRuntimeConfig {
+    default?: IgnisDefaultOptions
+    ui?: IgnisUIOptions
+    db?: IgnisDBOptions
+    forms?: IgnisFormsOptions
+    validation?: IgnisValidationOptions
+    content?: IgnisContentOptions
+    utils?: IgnisUtilsOptions
+  }
+}
+
+export interface IgnisPresetOptions {
+  ui?: 'nuxt-ui' | 'tailwind' | 'off'
+  db?: 'neon' | 'supabase' | 'off'
+  forms?: 'vueform' | 'formkit' | 'off'
+  validation?: 'zod' | 'valibot' | 'off'
+}
+
+export interface IgnisOptions {
+  // core/modules/config.ts
+  config?: IgnisConfigOptions
+  // core/modules/features.ts
+  preset?: IgnisPresetOptions
+  // @nuxt-ignis/default module
+  default?: IgnisDefaultOptions
+  // @nuxt-ignis/ui module
+  ui?: IgnisUIOptions
+  // @nuxt-ignis/db module
+  db?: IgnisDBOptions
+  // @nuxt-ignis/forms module
+  forms?: IgnisFormsOptions
+  // @nuxt-ignis/validation module
+  validation?: IgnisValidationOptions
+  // @nuxt-ignis/content module
+  content?: IgnisContentOptions
+  // @nuxt-ignis/utils module
+  utils?: IgnisUtilsOptions
+}
+
+export default defineNuxtModule<IgnisOptions>({
+  meta: {
+    name: 'ignis/features',
+    configKey: 'ignis',
+  },
+  moduleDependencies(nuxt) {
+    console.debug('Nuxt Ignis Features - module dependencies are being resolved')
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const modules: Record<string, any> = {}
+
+    const nuxtOpts = nuxt.options as NuxtOptions & { ignis?: IgnisOptions }
+    if (!nuxtOpts.ignis) {
+      nuxtOpts.ignis = {}
+    }
+    const ignisOpts = nuxtOpts.ignis
+
+    // Nuxt Ignis supports configuration via .env variables
+    // but at this time, they are not yet evaluated and applied
+    // we are resolving them manually so they can take effect in Ignis module resolution
+    // note .env variables take precedence over options passed directly from nuxt.config.ts
+    // when neither is, Ignis will apply defaults
+
+    // #171 - guard rejecting corrupted .env variables that does not match expected values
+    envValidate()
+
+    envApply(ignisOpts)
+
+    if (!ignisOpts) {
+      console.debug('No Ignis options provided. Setting defaults.')
+      modules['@nuxt-ignis/default'] = { }
+      return modules
+    }
+
+    if (isDefaultActive(ignisOpts)) {
+      modules['@nuxt-ignis/default'] = { }
+    }
+
+    if (isUiActive(ignisOpts)) {
+      modules['@nuxt-ignis/ui'] = {
+        defaults: resolveUiPreset(ignisOpts.preset?.ui),
+      }
+    }
+
+    if (isDbActive(ignisOpts)) {
+      modules['@nuxt-ignis/db'] = {
+        defaults: resolveDbPreset(ignisOpts.preset?.db),
+      }
+    }
+
+    if (isFormsActive(ignisOpts)) {
+      modules['@nuxt-ignis/forms'] = {
+        defaults: resolveFormsPreset(ignisOpts.preset?.forms),
+      }
+    }
+
+    if (isValidationActive(ignisOpts)) {
+      modules['@nuxt-ignis/validation'] = {
+        defaults: resolveValidationPreset(ignisOpts.preset?.validation),
+      }
+    }
+
+    if (isContentActive(ignisOpts)) {
+      modules['@nuxt-ignis/content'] = { }
+    }
+
+    if (isUtilsActive(ignisOpts)) {
+      modules['@nuxt-ignis/utils'] = { }
+    }
+
+    return modules
+  },
+  setup(_options, nuxt) {
+    console.debug('Nuxt Ignis Features module setup called!')
+
+    const nuxtOpts = nuxt.options as NuxtOptions & { ignis?: IgnisOptions }
+    const ignisOpts = nuxtOpts.ignis || {}
+
+    // ensure proper runtime config type inference for modules that are NOT active
+    const ignis = (nuxt.options.runtimeConfig.public.ignis ||= {}) as IgnisOptions
+    if (!isDefaultActive(ignisOpts)) {
+      ignis.default ||= {
+        eslint: false, fonts: false, image: false, scripts: false, security: false, auth: false, vueuse: false, pinia: false, css: false,
+      }
+    }
+    ignis.preset ||= {
+      ui: 'off', db: 'off', forms: 'off', validation: 'off',
+    }
+    if (!isUiActive(ignisOpts)) {
+      ignis.ui ||= {
+        ui: false, tailwind: false, openprops: false, charts: false,
+      }
+    }
+    if (!isDbActive(ignisOpts)) {
+      ignis.db ||= {
+        neon: { enabled: false },
+        supabase: { enabled: false, types: false },
+      }
+    }
+    if (!isFormsActive(ignisOpts)) {
+      ignis.forms ||= {
+        formkit: { enabled: false, default: '', config: '' },
+        vueform: { enabled: false },
+      }
+    }
+    if (!isValidationActive(ignisOpts)) {
+      ignis.validation ||= {
+        zod: false, valibot: false,
+      }
+    }
+    if (!isContentActive(ignisOpts)) {
+      ignis.content ||= {
+        content: { enabled: false },
+        i18n: { enabled: false, default: '' },
+        seo: { enabled: false },
+        social: { enabled: false, url: '' },
+        pslo: { enabled: false, content: false },
+      }
+    }
+    if (!isUtilsActive(ignisOpts)) {
+      ignis.utils ||= {
+        equipment: { enabled: false, composables: '', plugins: '' },
+        regexp: { enabled: false },
+      }
+    }
+
+    // additional processing
+
+    // warn if duplicate modules find
+    // this means e.g. 2 database modules or 2 form solutions
+    if (ignisOpts.config?.warn?.duplicates) {
+      checkForDuplicateModules(ignisOpts)
+    }
+
+    // temporary fix for Nuxt 4.4.4 regression
+    // see https://github.com/nuxt/nuxt/issues/34957#issuecomment-4355775463
+    // TODO remove after patched version Nuxt 4.4.5 is integrated
+    if (ignisOpts.config?.nuxt?.ssr === false) {
+      nuxt.options.experimental ||= {} as NuxtOptions['experimental']
+      nuxt.options.experimental.viteEnvironmentApi = true
+    }
+  },
+})

package/modules/utils/activation.ts

@@ -0,0 +1,59 @@
+import type { IgnisOptions } from '../02-features'
+
+/** Default module is active unless every feature is explicitly disabled. */
+export function isDefaultActive(opts: IgnisOptions): boolean {
+  const c = opts.default
+  if (!c) return true
+  if (!Object.keys(c).length) return true // empty object (all features are still true by defaut)
+  return !!(c.eslint || c.fonts || c.image || c.scripts || c.security || c.auth || c.vueuse || c.pinia)
+}
+
+/** UI module is active when any UI feature is enabled or a UI preset is selected. */
+export function isUiActive(opts: IgnisOptions): boolean {
+  if (isPresetSet(opts.preset?.ui)) return true
+  const u = opts.ui
+  if (!u) return false
+  return !!(u.ui || u.tailwind || u.openprops || u.charts)
+}
+
+/** DB module is active when any DB connector is enabled or a DB preset is selected. */
+export function isDbActive(opts: IgnisOptions): boolean {
+  if (isPresetSet(opts.preset?.db)) return true
+  const d = opts.db
+  if (!d) return false
+  return !!(d.neon?.enabled || d.supabase?.enabled)
+}
+
+/** Forms module is active when any form provider is enabled or a forms preset is selected. */
+export function isFormsActive(opts: IgnisOptions): boolean {
+  if (isPresetSet(opts.preset?.forms)) return true
+  const f = opts.forms
+  if (!f) return false
+  return !!(f.formkit?.enabled || f.vueform?.enabled)
+}
+
+/** Validation module is active when any validation lib is enabled or a validation preset is selected. */
+export function isValidationActive(opts: IgnisOptions): boolean {
+  if (isPresetSet(opts.preset?.validation)) return true
+  const v = opts.validation
+  if (!v) return false
+  return !!(v.zod || v.valibot)
+}
+
+/** Content module is active when any content feature is enabled. */
+export function isContentActive(opts: IgnisOptions): boolean {
+  const c = opts.content
+  if (!c) return false
+  return !!(c.content?.enabled || c.i18n?.enabled || c.seo?.enabled || c.social?.enabled || c.pslo?.enabled)
+}
+
+/** Utils module is active when any utility feature is enabled. */
+export function isUtilsActive(opts: IgnisOptions): boolean {
+  const u = opts.utils
+  if (!u) return false
+  return !!(u.equipment?.enabled || u.regexp?.enabled)
+}
+
+function isPresetSet(value: string | undefined): boolean {
+  return !!value && value !== 'off'
+}