import { createUnplugin } from 'unplugin' import { genDynamicImport, genImport } from 'knitwork' import MagicString from 'magic-string' import { pascalCase } from 'scule' import { resolve } from 'pathe' import { distDir } from '../dirs' import { isVueTemplate } from './helpers' import type { Component, ComponentsOptions } from 'nuxt/schema' interface LoaderOptions { getComponents (): Component[] mode: 'server' | 'client' sourcemap?: boolean transform?: ComponentsOptions['transform'] experimentalComponentIslands?: boolean } export const loaderPlugin = createUnplugin((options: LoaderOptions) => { const exclude = options.transform?.exclude || [] const include = options.transform?.include || [] const serverComponentRuntime = resolve(distDir, 'components/runtime/server-component') return { name: 'nuxt:components-loader', enforce: 'post', transformInclude (id) { if (exclude.some(pattern => id.match(pattern))) { return false } if (include.some(pattern => id.match(pattern))) { return true } return isVueTemplate(id) }, transform (code, id) { const components = options.getComponents() let num = 0 const imports = new Set() const map = new Map() const s = new MagicString(code) // replace `_resolveComponent("...")` to direct import s.replace(/(?<=[ (])_?resolveComponent\(\s*["'](lazy-|Lazy)?([^'"]*?)["'][\s,]*[^)]*\)/g, (full: string, lazy: string, name: string) => { const component = findComponent(components, name, options.mode) if (component) { let identifier = map.get(component) || `__nuxt_component_${num++}` map.set(component, identifier) const isServerOnly = component.mode === 'server' && !components.some(c => c.pascalName === component.pascalName && c.mode === 'client') if (isServerOnly) { imports.add(genImport(serverComponentRuntime, [{ name: 'createServerComponent' }])) imports.add(`const ${identifier} = createServerComponent(${JSON.stringify(name)})`) if (!options.experimentalComponentIslands) { console.warn(`Standalone server components (\`${name}\`) are not yet supported without enabling \`experimental.componentIslands\`.`) } return identifier } const isClientOnly = component.mode === 'client' && component.pascalName !== 'NuxtClientFallback' if (isClientOnly) { imports.add(genImport('#app/components/client-only', [{ name: 'createClientOnly' }])) identifier += '_client' } if (lazy) { imports.add(genImport('vue', [{ name: 'defineAsyncComponent', as: '__defineAsyncComponent' }])) identifier += '_lazy' imports.add(`const ${identifier} = /*#__PURE__*/ __defineAsyncComponent(${genDynamicImport(component.filePath, { interopDefault: true })}${isClientOnly ? '.then(c => createClientOnly(c))' : ''})`) } else { imports.add(genImport(component.filePath, [{ name: component.export, as: identifier }])) if (isClientOnly) { imports.add(`const ${identifier}_wrapped = /*#__PURE__*/ createClientOnly(${identifier})`) identifier += '_wrapped' } } return identifier } // no matched return full }) if (imports.size) { s.prepend([...imports, ''].join('\n')) } if (s.hasChanged()) { return { code: s.toString(), map: options.sourcemap ? s.generateMap({ source: id, includeContent: true }) : undefined } } } } }) function findComponent (components: Component[], name: string, mode: LoaderOptions['mode']) { const id = pascalCase(name).replace(/["']/g, '') // Prefer exact match const component = components.find(component => id === component.pascalName && ['all', mode, undefined].includes(component.mode)) if (component) { return component } const otherModeComponent = components.find(component => id === component.pascalName) // Render client-only components on the server with (a simple div) if (mode === 'server' && otherModeComponent) { return components.find(c => c.pascalName === 'ServerPlaceholder') } // Return the other-mode component in all other cases - we'll handle createClientOnly // and createServerComponent above return otherModeComponent }