@angular-devkit/build-angular 18.0.0-next.3 → 18.0.0-next.5

package/src/utils/index-file/add-event-dispatch-contract.js

@@ -1,28 +0,0 @@
-"use strict";
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.addEventDispatchContract = void 0;
-const promises_1 = require("node:fs/promises");
-const html_rewriting_stream_1 = require("./html-rewriting-stream");
-let jsActionContractScript;
-async function addEventDispatchContract(html) {
-    const { rewriter, transformedContent } = await (0, html_rewriting_stream_1.htmlRewritingStream)(html);
-    jsActionContractScript ??=
-        '<script type="text/javascript" id="ng-event-dispatch-contract">' +
-            (await (0, promises_1.readFile)(require.resolve('@angular/core/event-dispatch-contract.min.js'), 'utf-8')) +
-            '</script>';
-    rewriter.on('startTag', (tag) => {
-        rewriter.emitStartTag(tag);
-        if (tag.tagName === 'body') {
-            rewriter.emitRaw(jsActionContractScript);
-        }
-    });
-    return transformedContent();
-}
-exports.addEventDispatchContract = addEventDispatchContract;

package/src/utils/index-file/augment-index-html.d.ts

@@ -1,40 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-export type LoadOutputFileFunctionType = (file: string) => Promise<string>;
-export type CrossOriginValue = 'none' | 'anonymous' | 'use-credentials';
-export type Entrypoint = [name: string, isModule: boolean];
-export interface AugmentIndexHtmlOptions {
-    html: string;
-    baseHref?: string;
-    deployUrl?: string;
-    sri: boolean;
-    /** crossorigin attribute setting of elements that provide CORS support */
-    crossOrigin?: CrossOriginValue;
-    files: FileInfo[];
-    loadOutputFile: LoadOutputFileFunctionType;
-    /** Used to sort the inseration of files in the HTML file */
-    entrypoints: Entrypoint[];
-    /** Used to set the document default locale */
-    lang?: string;
-    hints?: {
-        url: string;
-        mode: string;
-        as?: string;
-    }[];
-    imageDomains?: string[];
-}
-export interface FileInfo {
-    file: string;
-    name?: string;
-    extension: string;
-}
-export declare function augmentIndexHtml(params: AugmentIndexHtmlOptions): Promise<{
-    content: string;
-    warnings: string[];
-    errors: string[];
-}>;

package/src/utils/index-file/augment-index-html.js

@@ -1,239 +0,0 @@
-"use strict";
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.augmentIndexHtml = void 0;
-const node_crypto_1 = require("node:crypto");
-const node_path_1 = require("node:path");
-const load_esm_1 = require("../load-esm");
-const html_rewriting_stream_1 = require("./html-rewriting-stream");
-/*
- * Helper function used by the IndexHtmlWebpackPlugin.
- * Can also be directly used by builder, e. g. in order to generate an index.html
- * after processing several configurations in order to build different sets of
- * bundles for differential serving.
- */
-// eslint-disable-next-line max-lines-per-function
-async function augmentIndexHtml(params) {
-    const { loadOutputFile, files, entrypoints, sri, deployUrl = '', lang, baseHref, html, imageDomains, } = params;
-    const warnings = [];
-    const errors = [];
-    let { crossOrigin = 'none' } = params;
-    if (sri && crossOrigin === 'none') {
-        crossOrigin = 'anonymous';
-    }
-    const stylesheets = new Set();
-    const scripts = new Map();
-    // Sort files in the order we want to insert them by entrypoint
-    for (const [entrypoint, isModule] of entrypoints) {
-        for (const { extension, file, name } of files) {
-            if (name !== entrypoint || scripts.has(file) || stylesheets.has(file)) {
-                continue;
-            }
-            switch (extension) {
-                case '.js':
-                    // Also, non entrypoints need to be loaded as no module as they can contain problematic code.
-                    scripts.set(file, isModule);
-                    break;
-                case '.mjs':
-                    if (!isModule) {
-                        // It would be very confusing to link an `*.mjs` file in a non-module script context,
-                        // so we disallow it entirely.
-                        throw new Error('`.mjs` files *must* set `isModule` to `true`.');
-                    }
-                    scripts.set(file, true /* isModule */);
-                    break;
-                case '.css':
-                    stylesheets.add(file);
-                    break;
-            }
-        }
-    }
-    let scriptTags = [];
-    for (const [src, isModule] of scripts) {
-        const attrs = [`src="${deployUrl}${src}"`];
-        // This is also need for non entry-points as they may contain problematic code.
-        if (isModule) {
-            attrs.push('type="module"');
-        }
-        else {
-            attrs.push('defer');
-        }
-        if (crossOrigin !== 'none') {
-            attrs.push(`crossorigin="${crossOrigin}"`);
-        }
-        if (sri) {
-            const content = await loadOutputFile(src);
-            attrs.push(generateSriAttributes(content));
-        }
-        scriptTags.push(`<script ${attrs.join(' ')}></script>`);
-    }
-    let linkTags = [];
-    for (const src of stylesheets) {
-        const attrs = [`rel="stylesheet"`, `href="${deployUrl}${src}"`];
-        if (crossOrigin !== 'none') {
-            attrs.push(`crossorigin="${crossOrigin}"`);
-        }
-        if (sri) {
-            const content = await loadOutputFile(src);
-            attrs.push(generateSriAttributes(content));
-        }
-        linkTags.push(`<link ${attrs.join(' ')}>`);
-    }
-    if (params.hints?.length) {
-        for (const hint of params.hints) {
-            const attrs = [`rel="${hint.mode}"`, `href="${deployUrl}${hint.url}"`];
-            if (hint.mode !== 'modulepreload' && crossOrigin !== 'none') {
-                // Value is considered anonymous by the browser when not present or empty
-                attrs.push(crossOrigin === 'anonymous' ? 'crossorigin' : `crossorigin="${crossOrigin}"`);
-            }
-            if (hint.mode === 'preload' || hint.mode === 'prefetch') {
-                switch ((0, node_path_1.extname)(hint.url)) {
-                    case '.js':
-                        attrs.push('as="script"');
-                        break;
-                    case '.css':
-                        attrs.push('as="style"');
-                        break;
-                    default:
-                        if (hint.as) {
-                            attrs.push(`as="${hint.as}"`);
-                        }
-                        break;
-                }
-            }
-            if (sri &&
-                (hint.mode === 'preload' || hint.mode === 'prefetch' || hint.mode === 'modulepreload')) {
-                const content = await loadOutputFile(hint.url);
-                attrs.push(generateSriAttributes(content));
-            }
-            linkTags.push(`<link ${attrs.join(' ')}>`);
-        }
-    }
-    const dir = lang ? await getLanguageDirection(lang, warnings) : undefined;
-    const { rewriter, transformedContent } = await (0, html_rewriting_stream_1.htmlRewritingStream)(html);
-    const baseTagExists = html.includes('<base');
-    const foundPreconnects = new Set();
-    rewriter
-        .on('startTag', (tag) => {
-        switch (tag.tagName) {
-            case 'html':
-                // Adjust document locale if specified
-                if (isString(lang)) {
-                    updateAttribute(tag, 'lang', lang);
-                }
-                if (dir) {
-                    updateAttribute(tag, 'dir', dir);
-                }
-                break;
-            case 'head':
-                // Base href should be added before any link, meta tags
-                if (!baseTagExists && isString(baseHref)) {
-                    rewriter.emitStartTag(tag);
-                    rewriter.emitRaw(`<base href="${baseHref}">`);
-                    return;
-                }
-                break;
-            case 'base':
-                // Adjust base href if specified
-                if (isString(baseHref)) {
-                    updateAttribute(tag, 'href', baseHref);
-                }
-                break;
-            case 'link':
-                if (readAttribute(tag, 'rel') === 'preconnect') {
-                    const href = readAttribute(tag, 'href');
-                    if (href) {
-                        foundPreconnects.add(href);
-                    }
-                }
-                break;
-        }
-        rewriter.emitStartTag(tag);
-    })
-        .on('endTag', (tag) => {
-        switch (tag.tagName) {
-            case 'head':
-                for (const linkTag of linkTags) {
-                    rewriter.emitRaw(linkTag);
-                }
-                if (imageDomains) {
-                    for (const imageDomain of imageDomains) {
-                        if (!foundPreconnects.has(imageDomain)) {
-                            rewriter.emitRaw(`<link rel="preconnect" href="${imageDomain}" data-ngimg>`);
-                        }
-                    }
-                }
-                linkTags = [];
-                break;
-            case 'body':
-                // Add script tags
-                for (const scriptTag of scriptTags) {
-                    rewriter.emitRaw(scriptTag);
-                }
-                scriptTags = [];
-                break;
-        }
-        rewriter.emitEndTag(tag);
-    });
-    const content = await transformedContent();
-    return {
-        content: linkTags.length || scriptTags.length
-            ? // In case no body/head tags are not present (dotnet partial templates)
-                linkTags.join('') + scriptTags.join('') + content
-            : content,
-        warnings,
-        errors,
-    };
-}
-exports.augmentIndexHtml = augmentIndexHtml;
-function generateSriAttributes(content) {
-    const algo = 'sha384';
-    const hash = (0, node_crypto_1.createHash)(algo).update(content, 'utf8').digest('base64');
-    return `integrity="${algo}-${hash}"`;
-}
-function updateAttribute(tag, name, value) {
-    const index = tag.attrs.findIndex((a) => a.name === name);
-    const newValue = { name, value };
-    if (index === -1) {
-        tag.attrs.push(newValue);
-    }
-    else {
-        tag.attrs[index] = newValue;
-    }
-}
-function readAttribute(tag, name) {
-    const targetAttr = tag.attrs.find((attr) => attr.name === name);
-    return targetAttr ? targetAttr.value : undefined;
-}
-function isString(value) {
-    return typeof value === 'string';
-}
-async function getLanguageDirection(locale, warnings) {
-    const dir = await getLanguageDirectionFromLocales(locale);
-    if (!dir) {
-        warnings.push(`Locale data for '${locale}' cannot be found. 'dir' attribute will not be set for this locale.`);
-    }
-    return dir;
-}
-async function getLanguageDirectionFromLocales(locale) {
-    try {
-        const localeData = (await (0, load_esm_1.loadEsmModule)(`@angular/common/locales/${locale}`)).default;
-        const dir = localeData[localeData.length - 2];
-        return isString(dir) ? dir : undefined;
-    }
-    catch {
-        // In some cases certain locales might map to files which are named only with language id.
-        // Example: `en-US` -> `en`.
-        const [languageId] = locale.split('-', 1);
-        if (languageId !== locale) {
-            return getLanguageDirectionFromLocales(languageId);
-        }
-    }
-    return undefined;
-}

package/src/utils/index-file/html-rewriting-stream.d.ts

@@ -1,11 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-export declare function htmlRewritingStream(content: string): Promise<{
-    rewriter: import('parse5-html-rewriting-stream').RewritingStream;
-    transformedContent: () => Promise<string>;
-}>;

package/src/utils/index-file/html-rewriting-stream.js

@@ -1,28 +0,0 @@
-"use strict";
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.htmlRewritingStream = void 0;
-const node_stream_1 = require("node:stream");
-const promises_1 = require("node:stream/promises");
-const load_esm_1 = require("../load-esm");
-async function htmlRewritingStream(content) {
-    const { RewritingStream } = await (0, load_esm_1.loadEsmModule)('parse5-html-rewriting-stream');
-    const rewriter = new RewritingStream();
-    return {
-        rewriter,
-        transformedContent: () => (0, promises_1.pipeline)(node_stream_1.Readable.from(content), rewriter, async function (source) {
-            const chunks = [];
-            for await (const chunk of source) {
-                chunks.push(Buffer.from(chunk));
-            }
-            return Buffer.concat(chunks).toString('utf-8');
-        }),
-    };
-}
-exports.htmlRewritingStream = htmlRewritingStream;

package/src/utils/index-file/index-html-generator.d.ts

@@ -1,57 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-import { NormalizedCachedOptions } from '../normalize-cache';
-import { NormalizedOptimizationOptions } from '../normalize-optimization';
-import { CrossOriginValue, Entrypoint, FileInfo } from './augment-index-html';
-export type HintMode = 'prefetch' | 'preload' | 'modulepreload' | 'preconnect' | 'dns-prefetch';
-export interface IndexHtmlGeneratorProcessOptions {
-    lang: string | undefined;
-    baseHref: string | undefined;
-    outputPath: string;
-    files: FileInfo[];
-    hints?: {
-        url: string;
-        mode: HintMode;
-        as?: string;
-    }[];
-}
-export interface IndexHtmlGeneratorOptions {
-    indexPath: string;
-    deployUrl?: string;
-    sri?: boolean;
-    entrypoints: Entrypoint[];
-    postTransform?: IndexHtmlTransform;
-    crossOrigin?: CrossOriginValue;
-    optimization?: NormalizedOptimizationOptions;
-    cache?: NormalizedCachedOptions;
-    imageDomains?: string[];
-    generateDedicatedSSRContent?: boolean;
-}
-export type IndexHtmlTransform = (content: string) => Promise<string>;
-export interface IndexHtmlPluginTransformResult {
-    content: string;
-    warnings: string[];
-    errors: string[];
-}
-export interface IndexHtmlProcessResult {
-    csrContent: string;
-    ssrContent?: string;
-    warnings: string[];
-    errors: string[];
-}
-export declare class IndexHtmlGenerator {
-    readonly options: IndexHtmlGeneratorOptions;
-    private readonly plugins;
-    private readonly csrPlugins;
-    private readonly ssrPlugins;
-    constructor(options: IndexHtmlGeneratorOptions);
-    process(options: IndexHtmlGeneratorProcessOptions): Promise<IndexHtmlProcessResult>;
-    private runPlugins;
-    readAsset(path: string): Promise<string>;
-    protected readIndex(path: string): Promise<string>;
-}

package/src/utils/index-file/index-html-generator.js

@@ -1,135 +0,0 @@
-"use strict";
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IndexHtmlGenerator = void 0;
-const promises_1 = require("node:fs/promises");
-const node_path_1 = require("node:path");
-const add_event_dispatch_contract_1 = require("./add-event-dispatch-contract");
-const augment_index_html_1 = require("./augment-index-html");
-const inline_critical_css_1 = require("./inline-critical-css");
-const inline_fonts_1 = require("./inline-fonts");
-const nonce_1 = require("./nonce");
-class IndexHtmlGenerator {
-    options;
-    plugins;
-    csrPlugins = [];
-    ssrPlugins = [];
-    constructor(options) {
-        this.options = options;
-        const extraCommonPlugins = [];
-        if (options?.optimization?.fonts.inline) {
-            extraCommonPlugins.push(inlineFontsPlugin(this), nonce_1.addNonce);
-        }
-        // Common plugins
-        this.plugins = [augmentIndexHtmlPlugin(this), ...extraCommonPlugins, postTransformPlugin(this)];
-        // CSR plugins
-        if (options?.optimization?.styles?.inlineCritical) {
-            this.csrPlugins.push(inlineCriticalCssPlugin(this));
-        }
-        // SSR plugins
-        if (options.generateDedicatedSSRContent) {
-            this.ssrPlugins.push(addEventDispatchContractPlugin(), addNoncePlugin());
-        }
-    }
-    async process(options) {
-        let content = await this.readIndex(this.options.indexPath);
-        const warnings = [];
-        const errors = [];
-        content = await this.runPlugins(content, this.plugins, options, warnings, errors);
-        const [csrContent, ssrContent] = await Promise.all([
-            this.runPlugins(content, this.csrPlugins, options, warnings, errors),
-            this.ssrPlugins.length
-                ? this.runPlugins(content, this.ssrPlugins, options, warnings, errors)
-                : undefined,
-        ]);
-        return {
-            ssrContent,
-            csrContent,
-            warnings,
-            errors,
-        };
-    }
-    async runPlugins(content, plugins, options, warnings, errors) {
-        for (const plugin of plugins) {
-            const result = await plugin(content, options);
-            if (typeof result === 'string') {
-                content = result;
-            }
-            else {
-                content = result.content;
-                if (result.warnings.length) {
-                    warnings.push(...result.warnings);
-                }
-                if (result.errors.length) {
-                    errors.push(...result.errors);
-                }
-            }
-        }
-        return content;
-    }
-    async readAsset(path) {
-        try {
-            return await (0, promises_1.readFile)(path, 'utf-8');
-        }
-        catch {
-            throw new Error(`Failed to read asset "${path}".`);
-        }
-    }
-    async readIndex(path) {
-        try {
-            return new TextDecoder('utf-8').decode(await (0, promises_1.readFile)(path));
-        }
-        catch (cause) {
-            throw new Error(`Failed to read index HTML file "${path}".`, { cause });
-        }
-    }
-}
-exports.IndexHtmlGenerator = IndexHtmlGenerator;
-function augmentIndexHtmlPlugin(generator) {
-    const { deployUrl, crossOrigin, sri = false, entrypoints, imageDomains } = generator.options;
-    return async (html, options) => {
-        const { lang, baseHref, outputPath = '', files, hints } = options;
-        return (0, augment_index_html_1.augmentIndexHtml)({
-            html,
-            baseHref,
-            deployUrl,
-            crossOrigin,
-            sri,
-            lang,
-            entrypoints,
-            loadOutputFile: (filePath) => generator.readAsset((0, node_path_1.join)(outputPath, filePath)),
-            imageDomains,
-            files,
-            hints,
-        });
-    };
-}
-function inlineFontsPlugin({ options }) {
-    const inlineFontsProcessor = new inline_fonts_1.InlineFontsProcessor({
-        minify: options.optimization?.styles.minify,
-    });
-    return async (html) => inlineFontsProcessor.process(html);
-}
-function inlineCriticalCssPlugin(generator) {
-    const inlineCriticalCssProcessor = new inline_critical_css_1.InlineCriticalCssProcessor({
-        minify: generator.options.optimization?.styles.minify,
-        deployUrl: generator.options.deployUrl,
-        readAsset: (filePath) => generator.readAsset(filePath),
-    });
-    return async (html, options) => inlineCriticalCssProcessor.process(html, { outputPath: options.outputPath });
-}
-function addNoncePlugin() {
-    return (html) => (0, nonce_1.addNonce)(html);
-}
-function postTransformPlugin({ options }) {
-    return async (html) => (options.postTransform ? options.postTransform(html) : html);
-}
-function addEventDispatchContractPlugin() {
-    return (html) => (0, add_event_dispatch_contract_1.addEventDispatchContract)(html);
-}

package/src/utils/index-file/inline-critical-css.d.ts

@@ -1,24 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-export interface InlineCriticalCssProcessOptions {
-    outputPath: string;
-}
-export interface InlineCriticalCssProcessorOptions {
-    minify?: boolean;
-    deployUrl?: string;
-    readAsset?: (path: string) => Promise<string>;
-}
-export declare class InlineCriticalCssProcessor {
-    protected readonly options: InlineCriticalCssProcessorOptions;
-    constructor(options: InlineCriticalCssProcessorOptions);
-    process(html: string, options: InlineCriticalCssProcessOptions): Promise<{
-        content: string;
-        warnings: string[];
-        errors: string[];
-    }>;
-}