vike/dist/node/vite/shared/importString.js

The Framework *You* Control - Next.js & Nuxt alternative for unprecedented flexibility and dependability.

import '../assertEnvVite.js';
export { parseImportString };
export { isImportString };
export { serializeImportString };
import pc from '@brillout/picocolors';
import { assert, assertWarning } from '../../../utils/assert.js';
const IMPORT = 'import';
const SEP = ':';
/**
 * Parse import string in format: import:importPath:exportName
 *
 * @example parseImportString('import:react/jsx-runtime:jsx')
 * // => { importPath: 'react/jsx-runtime', exportName: 'jsx' }
 *
 * @example parseImportString('import:./Layout:default')
 * // => { importPath: './Layout', exportName: 'default' }
 *
 * @example parseImportString('import:./Layout', { legacy: true })
 * // => { importPath: './Layout', exportName: 'default' }
 */
function parseImportString(importString, { legacy = false } = {}) {
    if (!importString.startsWith(`${IMPORT}${SEP}`))
        return null;
    const parts = importString.split(SEP);
    assert(parts[0] === IMPORT);
    if (legacy && parts.length === 2) {
        assertWarning(false, `Replace ${pc.cyan(importString)} with ${pc.cyan(importString)}${pc.cyan(':default')} (import strings must include the export name)`, { onlyOnce: true });
        const exportName = 'default';
        const importPath = parts[1];
        assert(importPath);
        return { importPath, exportName };
    }
    assert(parts.length >= 3);
    const exportName = parts[parts.length - 1];
    const importPath = parts.slice(1, -1).join(SEP);
    assert(exportName);
    assert(importPath);
    return { importPath, exportName };
}
/**
 * Check if a string is an import string (starts with 'import:').
 *
 * @example isImportString('import:react:jsx')
 * // => true
 *
 * @example isImportString('some-other-string')
 * // => false
 */
function isImportString(str) {
    return !!parseImportString(str, { legacy: true });
}
/**
 * Serialize import string from importPath and export name.
 *
 * @example serializeImportString({ importPath: 'react/jsx-runtime', exportName: 'jsx' })
 * // => 'import:react/jsx-runtime:jsx'
 *
 * @example serializeImportString({ importPath: './Layout', exportName: 'default' })
 * // => 'import:./Layout:default'
 */
function serializeImportString({ importPath, exportName }) {
    const importString = `${IMPORT}${SEP}${importPath}${SEP}${exportName}`;
    return importString;
}