@roots/bud-api/lib/methods/lazy/index.js

bud.js core module

/**
 * Enables lazy compilation of built assets.
 *
 * @example
 * Enable:
 *
 * ```js
 * bud.lazy()
 * ```
 *
 * @example
 * Explicitly disable:
 *
 * ```js
 * bud.lazy(false)
 * ```
 *
 * @example
 * Explicitly enable:
 *
 * ```js
 * bud.lazy(true)
 * ```
 *
 * @example
 * Use with object options:
 *
 * ```js
 * bud.lazy({
 *   entries: false,
 *   imports: true,
 * })
 * ```
 */
export const lazy = function (value = true) {
    this.hooks.on(`build.experiments`, experiments => {
        if (!experiments) {
            return { lazyCompilation: value };
        }
        return { ...experiments, lazyCompilation: value };
    });
    return this;
};