@angular-devkit/build-angular 18.0.0-next.2 → 18.0.0-next.4

package/src/utils/i18n-options.js

@@ -1,254 +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
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadTranslations = exports.configureI18nBuild = exports.createI18nOptions = void 0;
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_module_1 = require("node:module");
-const node_os_1 = __importDefault(require("node:os"));
-const node_path_1 = __importDefault(require("node:path"));
-const schema_1 = require("../builders/browser/schema");
-const read_tsconfig_1 = require("../utils/read-tsconfig");
-const load_translations_1 = require("./load-translations");
-/**
- * The base module location used to search for locale specific data.
- */
-const LOCALE_DATA_BASE_MODULE = '@angular/common/locales/global';
-function normalizeTranslationFileOption(option, locale, expectObjectInError) {
-    if (typeof option === 'string') {
-        return [option];
-    }
-    if (Array.isArray(option) && option.every((element) => typeof element === 'string')) {
-        return option;
-    }
-    let errorMessage = `Project i18n locales translation field value for '${locale}' is malformed. `;
-    if (expectObjectInError) {
-        errorMessage += 'Expected a string, array of strings, or object.';
-    }
-    else {
-        errorMessage += 'Expected a string or array of strings.';
-    }
-    throw new Error(errorMessage);
-}
-function ensureObject(value, name) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-        throw new Error(`Project ${name} field is malformed. Expected an object.`);
-    }
-}
-function ensureString(value, name) {
-    if (typeof value !== 'string') {
-        throw new Error(`Project ${name} field is malformed. Expected a string.`);
-    }
-}
-function createI18nOptions(projectMetadata, inline) {
-    const { i18n: metadata = {} } = projectMetadata;
-    ensureObject(metadata, 'i18n');
-    const i18n = {
-        inlineLocales: new Set(),
-        // en-US is the default locale added to Angular applications (https://angular.io/guide/i18n#i18n-pipes)
-        sourceLocale: 'en-US',
-        locales: {},
-        get shouldInline() {
-            return this.inlineLocales.size > 0;
-        },
-    };
-    let rawSourceLocale;
-    let rawSourceLocaleBaseHref;
-    if (typeof metadata.sourceLocale === 'string') {
-        rawSourceLocale = metadata.sourceLocale;
-    }
-    else if (metadata.sourceLocale !== undefined) {
-        ensureObject(metadata.sourceLocale, 'i18n sourceLocale');
-        if (metadata.sourceLocale.code !== undefined) {
-            ensureString(metadata.sourceLocale.code, 'i18n sourceLocale code');
-            rawSourceLocale = metadata.sourceLocale.code;
-        }
-        if (metadata.sourceLocale.baseHref !== undefined) {
-            ensureString(metadata.sourceLocale.baseHref, 'i18n sourceLocale baseHref');
-            rawSourceLocaleBaseHref = metadata.sourceLocale.baseHref;
-        }
-    }
-    if (rawSourceLocale !== undefined) {
-        i18n.sourceLocale = rawSourceLocale;
-        i18n.hasDefinedSourceLocale = true;
-    }
-    i18n.locales[i18n.sourceLocale] = {
-        files: [],
-        baseHref: rawSourceLocaleBaseHref,
-    };
-    if (metadata.locales !== undefined) {
-        ensureObject(metadata.locales, 'i18n locales');
-        for (const [locale, options] of Object.entries(metadata.locales)) {
-            let translationFiles;
-            let baseHref;
-            if (options && typeof options === 'object' && 'translation' in options) {
-                translationFiles = normalizeTranslationFileOption(options.translation, locale, false);
-                if ('baseHref' in options) {
-                    ensureString(options.baseHref, `i18n locales ${locale} baseHref`);
-                    baseHref = options.baseHref;
-                }
-            }
-            else {
-                translationFiles = normalizeTranslationFileOption(options, locale, true);
-            }
-            if (locale === i18n.sourceLocale) {
-                throw new Error(`An i18n locale ('${locale}') cannot both be a source locale and provide a translation.`);
-            }
-            i18n.locales[locale] = {
-                files: translationFiles.map((file) => ({ path: file })),
-                baseHref,
-            };
-        }
-    }
-    if (inline === true) {
-        i18n.inlineLocales.add(i18n.sourceLocale);
-        Object.keys(i18n.locales).forEach((locale) => i18n.inlineLocales.add(locale));
-    }
-    else if (inline) {
-        for (const locale of inline) {
-            if (!i18n.locales[locale] && i18n.sourceLocale !== locale) {
-                throw new Error(`Requested locale '${locale}' is not defined for the project.`);
-            }
-            i18n.inlineLocales.add(locale);
-        }
-    }
-    return i18n;
-}
-exports.createI18nOptions = createI18nOptions;
-async function configureI18nBuild(context, options) {
-    if (!context.target) {
-        throw new Error('The builder requires a target.');
-    }
-    const buildOptions = { ...options };
-    const tsConfig = await (0, read_tsconfig_1.readTsconfig)(buildOptions.tsConfig, context.workspaceRoot);
-    const metadata = await context.getProjectMetadata(context.target);
-    const i18n = createI18nOptions(metadata, buildOptions.localize);
-    // No additional processing needed if no inlining requested and no source locale defined.
-    if (!i18n.shouldInline && !i18n.hasDefinedSourceLocale) {
-        return { buildOptions, i18n };
-    }
-    const projectRoot = node_path_1.default.join(context.workspaceRoot, metadata.root || '');
-    // The trailing slash is required to signal that the path is a directory and not a file.
-    const projectRequire = (0, node_module_1.createRequire)(projectRoot + '/');
-    const localeResolver = (locale) => projectRequire.resolve(node_path_1.default.join(LOCALE_DATA_BASE_MODULE, locale));
-    // Load locale data and translations (if present)
-    let loader;
-    const usedFormats = new Set();
-    for (const [locale, desc] of Object.entries(i18n.locales)) {
-        if (!i18n.inlineLocales.has(locale) && locale !== i18n.sourceLocale) {
-            continue;
-        }
-        let localeDataPath = findLocaleDataPath(locale, localeResolver);
-        if (!localeDataPath) {
-            const [first] = locale.split('-');
-            if (first) {
-                localeDataPath = findLocaleDataPath(first.toLowerCase(), localeResolver);
-                if (localeDataPath) {
-                    context.logger.warn(`Locale data for '${locale}' cannot be found. Using locale data for '${first}'.`);
-                }
-            }
-        }
-        if (!localeDataPath) {
-            context.logger.warn(`Locale data for '${locale}' cannot be found. No locale data will be included for this locale.`);
-        }
-        else {
-            desc.dataPath = localeDataPath;
-        }
-        if (!desc.files.length) {
-            continue;
-        }
-        loader ??= await (0, load_translations_1.createTranslationLoader)();
-        loadTranslations(locale, desc, context.workspaceRoot, loader, {
-            warn(message) {
-                context.logger.warn(message);
-            },
-            error(message) {
-                throw new Error(message);
-            },
-        }, usedFormats, buildOptions.i18nDuplicateTranslation);
-        if (usedFormats.size > 1 && tsConfig.options.enableI18nLegacyMessageIdFormat !== false) {
-            // This limitation is only for legacy message id support (defaults to true as of 9.0)
-            throw new Error('Localization currently only supports using one type of translation file format for the entire application.');
-        }
-    }
-    // If inlining store the output in a temporary location to facilitate post-processing
-    if (i18n.shouldInline) {
-        // TODO: we should likely save these in the .angular directory in the next major version.
-        // We'd need to do a migration to add the temp directory to gitignore.
-        const tempPath = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_fs_1.default.realpathSync(node_os_1.default.tmpdir()), 'angular-cli-i18n-'));
-        buildOptions.outputPath = tempPath;
-        process.on('exit', () => {
-            try {
-                node_fs_1.default.rmSync(tempPath, { force: true, recursive: true, maxRetries: 3 });
-            }
-            catch { }
-        });
-    }
-    return { buildOptions, i18n };
-}
-exports.configureI18nBuild = configureI18nBuild;
-function findLocaleDataPath(locale, resolver) {
-    // Remove private use subtags
-    const scrubbedLocale = locale.replace(/-x(-[a-zA-Z0-9]{1,8})+$/, '');
-    try {
-        return resolver(scrubbedLocale);
-    }
-    catch {
-        // fallback to known existing en-US locale data as of 14.0
-        return scrubbedLocale === 'en-US' ? findLocaleDataPath('en', resolver) : null;
-    }
-}
-function loadTranslations(locale, desc, workspaceRoot, loader, logger, usedFormats, duplicateTranslation) {
-    let translations = undefined;
-    for (const file of desc.files) {
-        const loadResult = loader(node_path_1.default.join(workspaceRoot, file.path));
-        for (const diagnostics of loadResult.diagnostics.messages) {
-            if (diagnostics.type === 'error') {
-                logger.error(`Error parsing translation file '${file.path}': ${diagnostics.message}`);
-            }
-            else {
-                logger.warn(`WARNING [${file.path}]: ${diagnostics.message}`);
-            }
-        }
-        if (loadResult.locale !== undefined && loadResult.locale !== locale) {
-            logger.warn(`WARNING [${file.path}]: File target locale ('${loadResult.locale}') does not match configured locale ('${locale}')`);
-        }
-        usedFormats?.add(loadResult.format);
-        file.format = loadResult.format;
-        file.integrity = loadResult.integrity;
-        if (translations) {
-            // Merge translations
-            for (const [id, message] of Object.entries(loadResult.translations)) {
-                if (translations[id] !== undefined) {
-                    const duplicateTranslationMessage = `[${file.path}]: Duplicate translations for message '${id}' when merging.`;
-                    switch (duplicateTranslation) {
-                        case schema_1.I18NTranslation.Ignore:
-                            break;
-                        case schema_1.I18NTranslation.Error:
-                            logger.error(`ERROR ${duplicateTranslationMessage}`);
-                            break;
-                        case schema_1.I18NTranslation.Warning:
-                        default:
-                            logger.warn(`WARNING ${duplicateTranslationMessage}`);
-                            break;
-                    }
-                }
-                translations[id] = message;
-            }
-        }
-        else {
-            // First or only translation file
-            translations = loadResult.translations;
-        }
-    }
-    desc.translation = translations;
-}
-exports.loadTranslations = loadTranslations;

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,238 +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);
-                    }
-                }
-        }
-        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,47 +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[];
-}
-export type IndexHtmlTransform = (content: string) => Promise<string>;
-export interface IndexHtmlTransformResult {
-    content: string;
-    warnings: string[];
-    errors: string[];
-}
-export declare class IndexHtmlGenerator {
-    readonly options: IndexHtmlGeneratorOptions;
-    private readonly plugins;
-    constructor(options: IndexHtmlGeneratorOptions);
-    process(options: IndexHtmlGeneratorProcessOptions): Promise<IndexHtmlTransformResult>;
-    readAsset(path: string): Promise<string>;
-    protected readIndex(path: string): Promise<string>;
-}