Primeiro commit do projeto Angular

This commit is contained in:
2026-03-14 20:41:55 +00:00
parent 9bebe1de72
commit 94f4f46395
22413 changed files with 3221690 additions and 0 deletions
@@ -0,0 +1,27 @@
/**
* @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.dev/license
*/
export interface RequireInfo {
module: string;
export?: string;
isCall?: boolean;
arguments?: KarmaConfigValue[];
}
export type KarmaConfigValue = string | boolean | number | KarmaConfigValue[] | {
[key: string]: KarmaConfigValue;
} | RequireInfo | undefined;
export interface KarmaConfigAnalysis {
settings: Map<string, KarmaConfigValue>;
hasUnsupportedValues: boolean;
}
/**
* Analyzes the content of a Karma configuration file to extract its settings.
*
* @param content The string content of the `karma.conf.js` file.
* @returns An object containing the configuration settings and a flag indicating if unsupported values were found.
*/
export declare function analyzeKarmaConfig(content: string): KarmaConfigAnalysis;
@@ -0,0 +1,132 @@
"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.dev/license
*/
var __importDefault = (this && this.__importDefault) || function (mod) {
return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
exports.analyzeKarmaConfig = analyzeKarmaConfig;
const typescript_1 = __importDefault(require("../../third_party/github.com/Microsoft/TypeScript/lib/typescript"));
function isRequireInfo(value) {
return typeof value === 'object' && value !== null && !Array.isArray(value) && 'module' in value;
}
function isSupportedPropertyAssignment(prop) {
return (typescript_1.default.isPropertyAssignment(prop) && (typescript_1.default.isIdentifier(prop.name) || typescript_1.default.isStringLiteral(prop.name)));
}
/**
* Analyzes the content of a Karma configuration file to extract its settings.
*
* @param content The string content of the `karma.conf.js` file.
* @returns An object containing the configuration settings and a flag indicating if unsupported values were found.
*/
function analyzeKarmaConfig(content) {
const sourceFile = typescript_1.default.createSourceFile('karma.conf.js', content, typescript_1.default.ScriptTarget.Latest, true);
const settings = new Map();
let hasUnsupportedValues = false;
function visit(node) {
// The Karma configuration is defined within a `config.set({ ... })` call.
if (typescript_1.default.isCallExpression(node) &&
typescript_1.default.isPropertyAccessExpression(node.expression) &&
node.expression.expression.getText(sourceFile) === 'config' &&
node.expression.name.text === 'set' &&
node.arguments.length === 1 &&
typescript_1.default.isObjectLiteralExpression(node.arguments[0])) {
// We found `config.set`, now we extract the properties from the object literal.
for (const prop of node.arguments[0].properties) {
if (isSupportedPropertyAssignment(prop)) {
const key = prop.name.text;
const value = extractValue(prop.initializer);
settings.set(key, value);
}
else {
hasUnsupportedValues = true;
}
}
}
else {
typescript_1.default.forEachChild(node, visit);
}
}
function extractValue(node) {
switch (node.kind) {
case typescript_1.default.SyntaxKind.StringLiteral:
return node.text;
case typescript_1.default.SyntaxKind.NumericLiteral:
return Number(node.text);
case typescript_1.default.SyntaxKind.TrueKeyword:
return true;
case typescript_1.default.SyntaxKind.FalseKeyword:
return false;
case typescript_1.default.SyntaxKind.Identifier: {
const identifier = node.text;
if (identifier === '__dirname' || identifier === '__filename') {
return identifier;
}
break;
}
case typescript_1.default.SyntaxKind.CallExpression: {
const callExpr = node;
// Handle require('...')
if (typescript_1.default.isIdentifier(callExpr.expression) &&
callExpr.expression.text === 'require' &&
callExpr.arguments.length === 1 &&
typescript_1.default.isStringLiteral(callExpr.arguments[0])) {
return { module: callExpr.arguments[0].text };
}
// Handle calls on a require, e.g. require('path').join()
const calleeValue = extractValue(callExpr.expression);
if (isRequireInfo(calleeValue)) {
return {
...calleeValue,
isCall: true,
arguments: callExpr.arguments.map(extractValue),
};
}
break;
}
case typescript_1.default.SyntaxKind.PropertyAccessExpression: {
const propAccessExpr = node;
// Handle config constants like `config.LOG_INFO`
if (typescript_1.default.isIdentifier(propAccessExpr.expression) &&
propAccessExpr.expression.text === 'config') {
return `config.${propAccessExpr.name.text}`;
}
const value = extractValue(propAccessExpr.expression);
if (isRequireInfo(value)) {
const currentExport = value.export
? `${value.export}.${propAccessExpr.name.text}`
: propAccessExpr.name.text;
return { ...value, export: currentExport };
}
break;
}
case typescript_1.default.SyntaxKind.ArrayLiteralExpression:
return node.elements.map(extractValue);
case typescript_1.default.SyntaxKind.ObjectLiteralExpression: {
const obj = {};
for (const prop of node.properties) {
if (isSupportedPropertyAssignment(prop)) {
// Recursively extract values for nested objects.
obj[prop.name.text] = extractValue(prop.initializer);
}
else {
hasUnsupportedValues = true;
}
}
return obj;
}
}
// For complex expressions (like variables) that we don't need to resolve,
// we mark the analysis as potentially incomplete.
hasUnsupportedValues = true;
return undefined;
}
visit(sourceFile);
return { settings, hasUnsupportedValues };
}
//# sourceMappingURL=karma-config-analyzer.js.map
@@ -0,0 +1 @@
{"version":3,"file":"karma-config-analyzer.js","sourceRoot":"","sources":["karma-config-analyzer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,63 @@
/**
* @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.dev/license
*/
import { KarmaConfigAnalysis, KarmaConfigValue } from './karma-config-analyzer';
/**
* Represents the difference between two Karma configurations.
*/
export interface KarmaConfigDiff {
/** A map of settings that were added in the project's configuration. */
added: Map<string, KarmaConfigValue>;
/** A map of settings that were removed from the project's configuration. */
removed: Map<string, KarmaConfigValue>;
/** A map of settings that were modified between the two configurations. */
modified: Map<string, {
projectValue: KarmaConfigValue;
defaultValue: KarmaConfigValue;
}>;
/** A boolean indicating if the comparison is reliable (i.e., no unsupported values were found). */
isReliable: boolean;
}
/**
* Generates the default Karma configuration file content as a string.
* @param relativePathToWorkspaceRoot The relative path from the Karma config file to the workspace root.
* @param projectName The name of the project.
* @param needDevkitPlugin A boolean indicating if the devkit plugin is needed.
* @returns The content of the default `karma.conf.js` file.
*/
export declare function generateDefaultKarmaConfig(relativePathToWorkspaceRoot: string, projectName: string, needDevkitPlugin: boolean): Promise<string>;
/**
* Compares two Karma configuration analyses and returns the difference.
* @param projectAnalysis The analysis of the project's configuration.
* @param defaultAnalysis The analysis of the default configuration to compare against.
* @returns A diff object representing the changes between the two configurations.
*/
export declare function compareKarmaConfigs(projectAnalysis: KarmaConfigAnalysis, defaultAnalysis: KarmaConfigAnalysis): KarmaConfigDiff;
/**
* Checks if there are any differences in the provided Karma configuration diff.
* @param diff The Karma configuration diff object to check.
* @returns True if there are any differences; false otherwise.
*/
export declare function hasDifferences(diff: KarmaConfigDiff): boolean;
/**
* Compares a project's Karma configuration with the default configuration.
* @param projectConfigContent The content of the project's `karma.conf.js` file.
* @param projectRoot The root directory of the project.
* @param needDevkitPlugin A boolean indicating if the devkit plugin is needed for the default config.
* @param karmaConfigPath The path to the Karma configuration file, used to resolve relative paths.
* @returns A diff object representing the changes.
*/
export declare function compareKarmaConfigToDefault(projectConfigContent: string, projectName: string, karmaConfigPath: string, needDevkitPlugin: boolean): Promise<KarmaConfigDiff>;
/**
* Compares a project's Karma configuration with the default configuration.
* @param projectAnalysis The analysis of the project's configuration.
* @param projectRoot The root directory of the project.
* @param needDevkitPlugin A boolean indicating if the devkit plugin is needed for the default config.
* @param karmaConfigPath The path to the Karma configuration file, used to resolve relative paths.
* @returns A diff object representing the changes.
*/
export declare function compareKarmaConfigToDefault(projectAnalysis: KarmaConfigAnalysis, projectName: string, karmaConfigPath: string, needDevkitPlugin: boolean): Promise<KarmaConfigDiff>;
@@ -0,0 +1,90 @@
"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.dev/license
*/
var __importDefault = (this && this.__importDefault) || function (mod) {
return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
exports.generateDefaultKarmaConfig = generateDefaultKarmaConfig;
exports.compareKarmaConfigs = compareKarmaConfigs;
exports.hasDifferences = hasDifferences;
exports.compareKarmaConfigToDefault = compareKarmaConfigToDefault;
const promises_1 = require("node:fs/promises");
const posix_1 = __importDefault(require("node:path/posix"));
const node_util_1 = require("node:util");
const paths_1 = require("../../utility/paths");
const karma_config_analyzer_1 = require("./karma-config-analyzer");
/**
* Generates the default Karma configuration file content as a string.
* @param relativePathToWorkspaceRoot The relative path from the Karma config file to the workspace root.
* @param projectName The name of the project.
* @param needDevkitPlugin A boolean indicating if the devkit plugin is needed.
* @returns The content of the default `karma.conf.js` file.
*/
async function generateDefaultKarmaConfig(relativePathToWorkspaceRoot, projectName, needDevkitPlugin) {
const templatePath = require.resolve('../../config/files/karma.conf.js.template');
let template = await (0, promises_1.readFile)(templatePath, 'utf-8');
// TODO: Replace this with the actual schematic templating logic.
template = template
.replace(/<%= relativePathToWorkspaceRoot %>/g, posix_1.default.normalize(relativePathToWorkspaceRoot).replace(/\\/g, '/'))
.replace(/<%= folderName %>/g, projectName);
const devkitPluginRegex = /<% if \(needDevkitPlugin\) { %>(.*?)<% } %>/gs;
const replacement = needDevkitPlugin ? '$1' : '';
template = template.replace(devkitPluginRegex, replacement);
return template;
}
/**
* Compares two Karma configuration analyses and returns the difference.
* @param projectAnalysis The analysis of the project's configuration.
* @param defaultAnalysis The analysis of the default configuration to compare against.
* @returns A diff object representing the changes between the two configurations.
*/
function compareKarmaConfigs(projectAnalysis, defaultAnalysis) {
const added = new Map();
const removed = new Map();
const modified = new Map();
const allKeys = new Set([...projectAnalysis.settings.keys(), ...defaultAnalysis.settings.keys()]);
for (const key of allKeys) {
const projectValue = projectAnalysis.settings.get(key);
const defaultValue = defaultAnalysis.settings.get(key);
if (projectValue !== undefined && defaultValue === undefined) {
added.set(key, projectValue);
}
else if (projectValue === undefined && defaultValue !== undefined) {
removed.set(key, defaultValue);
}
else if (projectValue !== undefined && defaultValue !== undefined) {
if (!(0, node_util_1.isDeepStrictEqual)(projectValue, defaultValue)) {
modified.set(key, { projectValue, defaultValue });
}
}
}
return {
added,
removed,
modified,
isReliable: !projectAnalysis.hasUnsupportedValues && !defaultAnalysis.hasUnsupportedValues,
};
}
/**
* Checks if there are any differences in the provided Karma configuration diff.
* @param diff The Karma configuration diff object to check.
* @returns True if there are any differences; false otherwise.
*/
function hasDifferences(diff) {
return diff.added.size > 0 || diff.removed.size > 0 || diff.modified.size > 0;
}
async function compareKarmaConfigToDefault(projectConfigOrAnalysis, projectName, karmaConfigPath, needDevkitPlugin) {
const projectAnalysis = typeof projectConfigOrAnalysis === 'string'
? (0, karma_config_analyzer_1.analyzeKarmaConfig)(projectConfigOrAnalysis)
: projectConfigOrAnalysis;
const defaultContent = await generateDefaultKarmaConfig((0, paths_1.relativePathToWorkspaceRoot)(posix_1.default.dirname(karmaConfigPath)), projectName, needDevkitPlugin);
const defaultAnalysis = (0, karma_config_analyzer_1.analyzeKarmaConfig)(defaultContent);
return compareKarmaConfigs(projectAnalysis, defaultAnalysis);
}
//# sourceMappingURL=karma-config-comparer.js.map
@@ -0,0 +1 @@
{"version":3,"file":"karma-config-comparer.js","sourceRoot":"","sources":["karma-config-comparer.ts"],"names":[],"mappings":"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"}
+9
View File
@@ -0,0 +1,9 @@
/**
* @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.dev/license
*/
import type { Rule } from '@angular-devkit/schematics';
export default function (): Rule;
+63
View File
@@ -0,0 +1,63 @@
"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.dev/license
*/
Object.defineProperty(exports, "__esModule", { value: true });
exports.default = default_1;
const workspace_1 = require("../../utility/workspace");
const workspace_models_1 = require("../../utility/workspace-models");
const karma_config_analyzer_1 = require("./karma-config-analyzer");
const karma_config_comparer_1 = require("./karma-config-comparer");
function updateProjects(tree) {
return (0, workspace_1.updateWorkspace)(async (workspace) => {
const removableKarmaConfigs = new Map();
for (const [projectName, project] of workspace.projects) {
for (const [, target] of project.targets) {
let needDevkitPlugin = false;
switch (target.builder) {
case workspace_models_1.Builders.Karma:
needDevkitPlugin = true;
break;
case workspace_models_1.Builders.BuildKarma:
break;
default:
continue;
}
for (const [, options] of (0, workspace_1.allTargetOptions)(target, false)) {
const karmaConfig = options['karmaConfig'];
if (typeof karmaConfig !== 'string') {
continue;
}
let isRemovable = removableKarmaConfigs.get(karmaConfig);
if (isRemovable === undefined && tree.exists(karmaConfig)) {
const content = tree.readText(karmaConfig);
const analysis = (0, karma_config_analyzer_1.analyzeKarmaConfig)(content);
if (analysis.hasUnsupportedValues) {
// Cannot safely determine if the file is removable.
isRemovable = false;
}
else {
const diff = await (0, karma_config_comparer_1.compareKarmaConfigToDefault)(analysis, projectName, karmaConfig, needDevkitPlugin);
isRemovable = !(0, karma_config_comparer_1.hasDifferences)(diff) && diff.isReliable;
}
removableKarmaConfigs.set(karmaConfig, isRemovable);
if (isRemovable) {
tree.delete(karmaConfig);
}
}
if (isRemovable) {
delete options['karmaConfig'];
}
}
}
}
});
}
function default_1() {
return updateProjects;
}
//# sourceMappingURL=migration.js.map
+1
View File
@@ -0,0 +1 @@
{"version":3,"file":"migration.js","sourceRoot":"","sources":["migration.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAiEH,4BAEC;AAhED,uDAA4E;AAC5E,qEAA0D;AAC1D,mEAA6D;AAC7D,mEAAsF;AAEtF,SAAS,cAAc,CAAC,IAAU;IAChC,OAAO,IAAA,2BAAe,EAAC,KAAK,EAAE,SAAS,EAAE,EAAE;QACzC,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAmB,CAAC;QAEzD,KAAK,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YACxD,KAAK,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACzC,IAAI,gBAAgB,GAAG,KAAK,CAAC;gBAC7B,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC;oBACvB,KAAK,2BAAQ,CAAC,KAAK;wBACjB,gBAAgB,GAAG,IAAI,CAAC;wBACxB,MAAM;oBACR,KAAK,2BAAQ,CAAC,UAAU;wBACtB,MAAM;oBACR;wBACE,SAAS;gBACb,CAAC;gBAED,KAAK,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,IAAA,4BAAgB,EAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;oBAC1D,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;oBAC3C,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;wBACpC,SAAS;oBACX,CAAC;oBAED,IAAI,WAAW,GAAG,qBAAqB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;oBACzD,IAAI,WAAW,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;wBAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;wBAC3C,MAAM,QAAQ,GAAG,IAAA,0CAAkB,EAAC,OAAO,CAAC,CAAC;wBAE7C,IAAI,QAAQ,CAAC,oBAAoB,EAAE,CAAC;4BAClC,oDAAoD;4BACpD,WAAW,GAAG,KAAK,CAAC;wBACtB,CAAC;6BAAM,CAAC;4BACN,MAAM,IAAI,GAAG,MAAM,IAAA,mDAA2B,EAC5C,QAAQ,EACR,WAAW,EACX,WAAW,EACX,gBAAgB,CACjB,CAAC;4BACF,WAAW,GAAG,CAAC,IAAA,sCAAc,EAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC;wBACzD,CAAC;wBAED,qBAAqB,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;wBAEpD,IAAI,WAAW,EAAE,CAAC;4BAChB,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;wBAC3B,CAAC;oBACH,CAAC;oBAED,IAAI,WAAW,EAAE,CAAC;wBAChB,OAAO,OAAO,CAAC,aAAa,CAAC,CAAC;oBAChC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;IACE,OAAO,cAAc,CAAC;AACxB,CAAC"}
+28
View File
@@ -0,0 +1,28 @@
{
"encapsulation": false,
"schematics": {
"use-application-builder": {
"version": "21.0.0",
"factory": "./use-application-builder/migration",
"description": "Migrate application projects to the new build system. Application projects that are using the '@angular-devkit/build-angular' package's 'browser' and/or 'browser-esbuild' builders will be migrated to use the new 'application' builder. You can read more about this, including known issues and limitations, here: https://angular.dev/tools/cli/build-system-migration",
"optional": true,
"recommended": true,
"documentation": "tools/cli/build-system-migration"
},
"remove-default-karma-config": {
"version": "21.0.0",
"factory": "./karma/migration",
"description": "Remove any karma configuration files that only contain the default content. The default configuration is automatically available without a specific project file."
},
"update-typescript-lib": {
"version": "21.0.0",
"factory": "./update-typescript-lib/migration",
"description": "Updates the 'lib' property in tsconfig files to use 'es2022' or a more modern version."
},
"update-module-resolution": {
"version": "21.0.0",
"factory": "./update-module-resolution/migration",
"description": "Update 'moduleResolution' to 'bundler' in TypeScript configurations. You can read more about this, here: https://www.typescriptlang.org/tsconfig/#moduleResolution"
}
}
}
@@ -0,0 +1,9 @@
/**
* @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.dev/license
*/
import { Rule } from '@angular-devkit/schematics';
export default function (): Rule;
@@ -0,0 +1,53 @@
"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.dev/license
*/
Object.defineProperty(exports, "__esModule", { value: true });
exports.default = default_1;
const json_file_1 = require("../../utility/json-file");
const workspace_1 = require("../../utility/workspace");
function default_1() {
return async (host) => {
const uniqueTsConfigs = new Set();
if (host.exists('tsconfig.json')) {
// Workspace level tsconfig
uniqueTsConfigs.add('tsconfig.json');
}
const workspace = await (0, workspace_1.getWorkspace)(host);
for (const [, target] of (0, workspace_1.allWorkspaceTargets)(workspace)) {
for (const [, opt] of (0, workspace_1.allTargetOptions)(target)) {
if (typeof opt?.tsConfig === 'string') {
uniqueTsConfigs.add(opt.tsConfig);
}
}
}
for (const tsConfig of uniqueTsConfigs) {
if (host.exists(tsConfig)) {
updateModuleResolution(host, tsConfig);
}
}
};
}
function updateModuleResolution(host, tsConfigPath) {
const json = new json_file_1.JSONFile(host, tsConfigPath);
const jsonPath = ['compilerOptions'];
const compilerOptions = json.get(jsonPath);
if (compilerOptions && typeof compilerOptions === 'object') {
const { moduleResolution, module } = compilerOptions;
if (typeof moduleResolution !== 'string' || moduleResolution.toLowerCase() === 'bundler') {
return;
}
if (typeof module === 'string' && module.toLowerCase() === 'preserve') {
return;
}
json.modify(jsonPath, {
...compilerOptions,
'moduleResolution': 'bundler',
});
}
}
//# sourceMappingURL=migration.js.map
@@ -0,0 +1 @@
{"version":3,"file":"migration.js","sourceRoot":"","sources":["migration.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAOH,4BAwBC;AA3BD,uDAAmD;AACnD,uDAA8F;AAE9F;IACE,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE;QACpB,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;QAE1C,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;YACjC,2BAA2B;YAC3B,eAAe,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,IAAA,wBAAY,EAAC,IAAI,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,IAAA,+BAAmB,EAAC,SAAS,CAAC,EAAE,CAAC;YACxD,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,IAAA,4BAAgB,EAAC,MAAM,CAAC,EAAE,CAAC;gBAC/C,IAAI,OAAO,GAAG,EAAE,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBACtC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,eAAe,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1B,sBAAsB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAU,EAAE,YAAoB;IAC9D,MAAM,IAAI,GAAG,IAAI,oBAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACrC,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,eAAe,IAAI,OAAO,eAAe,KAAK,QAAQ,EAAE,CAAC;QAC3D,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,eAA6B,CAAC;QACnE,IAAI,OAAO,gBAAgB,KAAK,QAAQ,IAAI,gBAAgB,CAAC,WAAW,EAAE,KAAK,SAAS,EAAE,CAAC;YACzF,OAAO;QACT,CAAC;QAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,UAAU,EAAE,CAAC;YACtE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;YACpB,GAAG,eAAe;YAClB,kBAAkB,EAAE,SAAS;SAC9B,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
@@ -0,0 +1,9 @@
/**
* @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.dev/license
*/
import { Rule } from '@angular-devkit/schematics';
export default function (): Rule;
@@ -0,0 +1,80 @@
"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.dev/license
*/
Object.defineProperty(exports, "__esModule", { value: true });
exports.default = default_1;
const json_file_1 = require("../../utility/json-file");
const workspace_1 = require("../../utility/workspace");
function default_1() {
return async (host, context) => {
// Workspace level tsconfig
if (host.exists('tsconfig.json')) {
updateLib(host, 'tsconfig.json');
}
const workspace = await (0, workspace_1.getWorkspace)(host);
// Find all tsconfig which are references used by builders
for (const [, project] of workspace.projects) {
for (const [targetName, target] of project.targets) {
if (!target.options) {
continue;
}
// Update all other known CLI builders that use a tsconfig
const tsConfigs = [target.options, ...Object.values(target.configurations || {})]
.filter((opt) => typeof opt?.tsConfig === 'string')
.map((opt) => opt.tsConfig);
const uniqueTsConfigs = new Set(tsConfigs);
for (const tsConfig of uniqueTsConfigs) {
if (host.exists(tsConfig)) {
updateLib(host, tsConfig);
}
else {
context.logger.warn(`'${tsConfig}' referenced in the '${targetName}' target does not exist.`);
}
}
}
}
};
}
function updateLib(host, tsConfigPath) {
const json = new json_file_1.JSONFile(host, tsConfigPath);
const jsonPath = ['compilerOptions', 'lib'];
const lib = json.get(jsonPath);
if (!lib || !Array.isArray(lib)) {
return;
}
const esLibs = lib.filter((l) => typeof l === 'string' && l.toLowerCase().startsWith('es'));
const hasDom = lib.some((l) => typeof l === 'string' && l.toLowerCase() === 'dom');
if (esLibs.length === 0) {
return;
}
const esLibToVersion = new Map();
for (const l of esLibs) {
const version = l.toLowerCase().match(/^es(next|(\d+))$/)?.[1];
if (version) {
esLibToVersion.set(l, version === 'next' ? Infinity : Number(version));
}
}
if (esLibToVersion.size === 0) {
return;
}
const latestEsLib = [...esLibToVersion.entries()].sort(([, v1], [, v2]) => v2 - v1)[0];
const latestVersion = latestEsLib[1];
if (hasDom) {
if (latestVersion <= 2022) {
json.remove(jsonPath);
}
return;
}
// No 'dom' with 'es' libs, so update 'es' lib.
if (latestVersion < 2022) {
const newLibs = lib.filter((l) => !esLibToVersion.has(l));
newLibs.push('es2022');
json.modify(jsonPath, newLibs);
}
}
//# sourceMappingURL=migration.js.map
@@ -0,0 +1 @@
{"version":3,"file":"migration.js","sourceRoot":"","sources":["migration.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
/**
* @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.dev/license
*/
/**
* Scans a CSS or Sass file and locates all valid import/use directive values as defined by the
* syntax specification.
* @param contents A string containing a CSS or Sass file to scan.
* @returns An iterable that yields each CSS directive value found.
*/
export declare function findImports(contents: string, sass: boolean): Iterable<{
start: number;
end: number;
specifier: string;
fromUse?: boolean;
}>;
@@ -0,0 +1,118 @@
"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.dev/license
*/
Object.defineProperty(exports, "__esModule", { value: true });
exports.findImports = findImports;
/**
* Determines if a unicode code point is a CSS whitespace character.
* @param code The unicode code point to test.
* @returns true, if the code point is CSS whitespace; false, otherwise.
*/
function isWhitespace(code) {
// Based on https://www.w3.org/TR/css-syntax-3/#whitespace
switch (code) {
case 0x0009: // tab
case 0x0020: // space
case 0x000a: // line feed
case 0x000c: // form feed
case 0x000d: // carriage return
return true;
default:
return false;
}
}
/**
* Scans a CSS or Sass file and locates all valid import/use directive values as defined by the
* syntax specification.
* @param contents A string containing a CSS or Sass file to scan.
* @returns An iterable that yields each CSS directive value found.
*/
function* findImports(contents, sass) {
yield* find(contents, '@import ');
if (sass) {
for (const result of find(contents, '@use ')) {
yield { ...result, fromUse: true };
}
}
}
/**
* Scans a CSS or Sass file and locates all valid function/directive values as defined by the
* syntax specification.
* @param contents A string containing a CSS or Sass file to scan.
* @param prefix The prefix to start a valid segment.
* @returns An iterable that yields each CSS url function value found.
*/
function* find(contents, prefix) {
let pos = 0;
let width = 1;
let current = -1;
const next = () => {
pos += width;
current = contents.codePointAt(pos) ?? -1;
width = current > 0xffff ? 2 : 1;
return current;
};
// Based on https://www.w3.org/TR/css-syntax-3/#consume-ident-like-token
while ((pos = contents.indexOf(prefix, pos)) !== -1) {
// Set to position of the last character in prefix
pos += prefix.length - 1;
width = 1;
// Consume all leading whitespace
while (isWhitespace(next())) {
/* empty */
}
// Initialize URL state
const url = { start: pos, end: -1, specifier: '' };
let complete = false;
// If " or ', then consume the value as a string
if (current === 0x0022 || current === 0x0027) {
const ending = current;
// Based on https://www.w3.org/TR/css-syntax-3/#consume-string-token
while (!complete) {
switch (next()) {
case -1: // EOF
return;
case 0x000a: // line feed
case 0x000c: // form feed
case 0x000d: // carriage return
// Invalid
complete = true;
break;
case 0x005c: // \ -- character escape
// If not EOF or newline, add the character after the escape
switch (next()) {
case -1:
return;
case 0x000a: // line feed
case 0x000c: // form feed
case 0x000d: // carriage return
// Skip when inside a string
break;
default:
// TODO: Handle hex escape codes
url.specifier += String.fromCodePoint(current);
break;
}
break;
case ending:
// Full string position should include the quotes for replacement
url.end = pos + 1;
complete = true;
yield url;
break;
default:
url.specifier += String.fromCodePoint(current);
break;
}
}
next();
continue;
}
}
}
//# sourceMappingURL=css-import-lexer.js.map
@@ -0,0 +1 @@
{"version":3,"file":"css-import-lexer.js","sourceRoot":"","sources":["css-import-lexer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
/**
* @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.dev/license
*/
import { Rule } from '@angular-devkit/schematics';
/**
* Migration main entrypoint
*/
export default function (): Rule;
@@ -0,0 +1,283 @@
"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.dev/license
*/
Object.defineProperty(exports, "__esModule", { value: true });
exports.default = default_1;
const schematics_1 = require("@angular-devkit/schematics");
const posix_1 = require("node:path/posix");
const dependency_1 = require("../../utility/dependency");
const json_file_1 = require("../../utility/json-file");
const latest_versions_1 = require("../../utility/latest-versions");
const workspace_1 = require("../../utility/workspace");
const workspace_models_1 = require("../../utility/workspace-models");
const stylesheet_updates_1 = require("./stylesheet-updates");
function* updateBuildTarget(projectName, buildTarget, serverTarget, tree, context) {
// Update builder target and options
buildTarget.builder = workspace_models_1.Builders.Application;
for (const [, options] of (0, workspace_1.allTargetOptions)(buildTarget, false)) {
if (options['index'] === '') {
options['index'] = false;
}
// Rename and transform options
options['browser'] = options['main'];
if (serverTarget && typeof options['browser'] === 'string') {
options['server'] = (0, posix_1.dirname)(options['browser']) + '/main.server.ts';
}
options['serviceWorker'] = options['ngswConfigPath'] ?? options['serviceWorker'];
if (typeof options['polyfills'] === 'string') {
options['polyfills'] = [options['polyfills']];
}
let outputPath = options['outputPath'];
if (typeof outputPath === 'string') {
if (!/\/browser\/?$/.test(outputPath)) {
// TODO: add prompt.
context.logger.warn(`The output location of the browser build has been updated from "${outputPath}" to ` +
`"${(0, posix_1.join)(outputPath, 'browser')}". ` +
'You might need to adjust your deployment pipeline or, as an alternative, ' +
'set outputPath.browser to "" in order to maintain the previous functionality.');
}
else {
outputPath = outputPath.replace(/\/browser\/?$/, '');
}
options['outputPath'] = {
base: outputPath,
};
if (typeof options['resourcesOutputPath'] === 'string') {
const media = options['resourcesOutputPath'].replaceAll('/', '');
if (media && media !== 'media') {
options['outputPath'] = {
base: outputPath,
media,
};
}
}
}
// Delete removed options
delete options['vendorChunk'];
delete options['commonChunk'];
delete options['resourcesOutputPath'];
delete options['buildOptimizer'];
delete options['main'];
delete options['ngswConfigPath'];
}
// Merge browser and server tsconfig
if (serverTarget) {
const browserTsConfig = buildTarget.options?.tsConfig;
const serverTsConfig = serverTarget.options?.tsConfig;
if (typeof browserTsConfig !== 'string') {
throw new schematics_1.SchematicsException(`Cannot update project "${projectName}" to use the application builder` +
` as the browser tsconfig cannot be located.`);
}
if (typeof serverTsConfig !== 'string') {
throw new schematics_1.SchematicsException(`Cannot update project "${projectName}" to use the application builder` +
` as the server tsconfig cannot be located.`);
}
const browserJson = new json_file_1.JSONFile(tree, browserTsConfig);
const serverJson = new json_file_1.JSONFile(tree, serverTsConfig);
const filesPath = ['files'];
const files = new Set([
...(browserJson.get(filesPath) ?? []),
...(serverJson.get(filesPath) ?? []),
]);
// Server file will be added later by the means of the ssr schematic.
files.delete('server.ts');
browserJson.modify(filesPath, Array.from(files));
const typesPath = ['compilerOptions', 'types'];
browserJson.modify(typesPath, Array.from(new Set([
...(browserJson.get(typesPath) ?? []),
...(serverJson.get(typesPath) ?? []),
])));
// Delete server tsconfig
yield deleteFile(serverTsConfig);
}
// Update server file
const ssrMainFile = serverTarget?.options?.['main'];
if (typeof ssrMainFile === 'string') {
// Do not delete the server main file if it's the same as the browser file.
if (buildTarget.options?.browser !== ssrMainFile) {
yield deleteFile(ssrMainFile);
}
yield (0, schematics_1.externalSchematic)('@schematics/angular', 'ssr', {
project: projectName,
});
}
}
function updateProjects(tree, context) {
return (0, workspace_1.updateWorkspace)((workspace) => {
const rules = [];
for (const [name, project] of workspace.projects) {
if (project.extensions.projectType !== workspace_models_1.ProjectType.Application) {
// Only interested in application projects since these changes only effects application builders
continue;
}
const buildTarget = project.targets.get('build');
if (!buildTarget ||
buildTarget.builder === workspace_models_1.Builders.Application ||
buildTarget.builder === workspace_models_1.Builders.BuildApplication) {
continue;
}
if (buildTarget.builder !== workspace_models_1.Builders.BrowserEsbuild &&
buildTarget.builder !== workspace_models_1.Builders.Browser) {
context.logger.error(`Cannot update project "${name}" to use the application builder.` +
` Only "${workspace_models_1.Builders.BrowserEsbuild}" and "${workspace_models_1.Builders.Browser}" can be automatically migrated.`);
continue;
}
const serverTarget = project.targets.get('server');
rules.push(...updateBuildTarget(name, buildTarget, serverTarget, tree, context));
// Delete all redundant targets
for (const [key, target] of project.targets) {
switch (target.builder) {
case workspace_models_1.Builders.Server:
case workspace_models_1.Builders.Prerender:
case workspace_models_1.Builders.AppShell:
case workspace_models_1.Builders.SsrDevServer:
project.targets.delete(key);
break;
}
}
// Update CSS/Sass import specifiers
const projectSourceRoot = (0, posix_1.join)(project.root, project.sourceRoot ?? 'src');
(0, stylesheet_updates_1.updateStyleImports)(tree, projectSourceRoot, buildTarget);
}
// Check for @angular-devkit/build-angular Webpack usage
let hasAngularDevkitUsage = false;
for (const [, target] of (0, workspace_1.allWorkspaceTargets)(workspace)) {
switch (target.builder) {
case workspace_models_1.Builders.Application:
case workspace_models_1.Builders.DevServer:
case workspace_models_1.Builders.ExtractI18n:
case workspace_models_1.Builders.Karma:
case workspace_models_1.Builders.NgPackagr:
// Ignore application, dev server, and i18n extraction for devkit usage check.
// Both will be replaced if no other usage is found.
continue;
}
if (target.builder.startsWith('@angular-devkit/build-angular:')) {
hasAngularDevkitUsage = true;
break;
}
}
// Use @angular/build directly if there is no devkit package usage
if (!hasAngularDevkitUsage) {
const karmaConfigFiles = new Set();
for (const [, target] of (0, workspace_1.allWorkspaceTargets)(workspace)) {
switch (target.builder) {
case workspace_models_1.Builders.Application:
target.builder = '@angular/build:application';
break;
case workspace_models_1.Builders.DevServer:
target.builder = '@angular/build:dev-server';
break;
case workspace_models_1.Builders.ExtractI18n:
target.builder = '@angular/build:extract-i18n';
break;
case workspace_models_1.Builders.Karma:
target.builder = '@angular/build:karma';
for (const [, karmaOptions] of (0, workspace_1.allTargetOptions)(target)) {
// Remove "builderMode" option since the builder will always use "application"
delete karmaOptions['builderMode'];
// Collect custom karma configurations for @angular-devkit/build-angular plugin removal
const karmaConfig = karmaOptions['karmaConfig'];
if (karmaConfig && typeof karmaConfig === 'string') {
karmaConfigFiles.add(karmaConfig);
}
}
break;
case workspace_models_1.Builders.NgPackagr:
target.builder = '@angular/build:ng-packagr';
break;
}
}
// Add direct @angular/build dependencies and remove @angular-devkit/build-angular
rules.push((0, dependency_1.addDependency)('@angular/build', latest_versions_1.latestVersions.DevkitBuildAngular, {
type: dependency_1.DependencyType.Dev,
existing: dependency_1.ExistingBehavior.Replace,
}), (0, dependency_1.removeDependency)('@angular-devkit/build-angular'));
// Add less dependency if any projects contain a Less stylesheet file.
// This check does not consider Node.js packages due to the performance
// cost of searching such a large directory structure. A build time error
// will provide instructions to install the package in this case.
if ((0, stylesheet_updates_1.hasLessStylesheets)(tree)) {
rules.push((0, dependency_1.addDependency)('less', latest_versions_1.latestVersions['less'], {
type: dependency_1.DependencyType.Dev,
existing: dependency_1.ExistingBehavior.Skip,
}));
}
// Add postcss dependency if any projects have a custom postcss configuration file.
// The build system only supports files in a project root or workspace root with
// names of either 'postcss.config.json' or '.postcssrc.json'.
if ((0, stylesheet_updates_1.hasPostcssConfiguration)(tree, workspace)) {
rules.push((0, dependency_1.addDependency)('postcss', latest_versions_1.latestVersions['postcss'], {
type: dependency_1.DependencyType.Dev,
existing: dependency_1.ExistingBehavior.Replace,
}));
}
for (const karmaConfigFile of karmaConfigFiles) {
if (!tree.exists(karmaConfigFile)) {
continue;
}
try {
const originalKarmaConfigText = tree.readText(karmaConfigFile);
const updatedKarmaConfigText = originalKarmaConfigText
.replaceAll(`require('@angular-devkit/build-angular/plugins/karma'),`, '')
.replaceAll(`require('@angular-devkit/build-angular/plugins/karma')`, '');
if (updatedKarmaConfigText.includes('@angular-devkit/build-angular/plugins')) {
throw new Error('Migration does not support found usage of "@angular-devkit/build-angular".');
}
else {
tree.overwrite(karmaConfigFile, updatedKarmaConfigText);
}
}
catch (error) {
const reason = error instanceof Error ? `Reason: ${error.message}` : '';
context.logger.warn(`Unable to update custom karma configuration file ("${karmaConfigFile}"). ` +
reason +
'\nReferences to the "@angular-devkit/build-angular" package within the file may need to be removed manually.');
}
}
}
return (0, schematics_1.chain)(rules);
});
}
function deleteFile(path) {
return (tree) => {
tree.delete(path);
};
}
function updateJsonFile(path, updater) {
return (tree, ctx) => {
if (tree.exists(path)) {
updater(new json_file_1.JSONFile(tree, path));
}
else {
ctx.logger.info(`Skipping updating '${path}' as it does not exist.`);
}
};
}
/**
* Migration main entrypoint
*/
function default_1() {
return (0, schematics_1.chain)([
updateProjects,
// Delete package.json helper scripts
updateJsonFile('package.json', (pkgJson) => ['build:ssr', 'dev:ssr', 'serve:ssr', 'prerender'].forEach((s) => pkgJson.remove(['scripts', s]))),
// Update main tsconfig
updateJsonFile('tsconfig.json', (rootJson) => {
const module = rootJson.get(['compilerOptions', 'module']);
const hasPreserveModule = typeof module === 'string' && module.toLowerCase() === 'preserve';
if (!hasPreserveModule) {
rootJson.modify(['compilerOptions', 'esModuleInterop'], true);
rootJson.modify(['compilerOptions', 'moduleResolution'], 'bundler');
}
rootJson.modify(['compilerOptions', 'downlevelIteration'], undefined);
rootJson.modify(['compilerOptions', 'allowSyntheticDefaultImports'], undefined);
}),
]);
}
//# sourceMappingURL=migration.js.map
File diff suppressed because one or more lines are too long
@@ -0,0 +1,36 @@
/**
* @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.dev/license
*/
import { Tree } from '@angular-devkit/schematics';
import { TargetDefinition, WorkspaceDefinition } from '../../utility/workspace';
/**
* Searches the schematic tree for files that have a `.less` extension.
* This is used to determine if the `less` package should be added as a dependency.
*
* @param tree A Schematics tree instance to search.
* @returns `true` if Less stylesheet files are found; otherwise, `false`.
*/
export declare function hasLessStylesheets(tree: Tree): boolean;
/**
* Searches for a PostCSS configuration file within the workspace root or any of the project roots.
* This is used to determine if the `postcss` package should be added as a dependency.
*
* @param tree A Schematics tree instance to search.
* @param workspace A Workspace to check for projects.
* @returns `true` if a PostCSS configuration file is found; otherwise, `false`.
*/
export declare function hasPostcssConfiguration(tree: Tree, workspace: WorkspaceDefinition): boolean;
/**
* The main orchestrator function for updating stylesheets.
* It iterates through all stylesheets in a project, analyzes them, and applies the necessary
* changes to the files and the build configuration.
*
* @param tree A Schematics tree instance.
* @param projectSourceRoot The source root of the project being updated.
* @param buildTarget The build target of the project being updated.
*/
export declare function updateStyleImports(tree: Tree, projectSourceRoot: string, buildTarget: TargetDefinition): void;
@@ -0,0 +1,220 @@
"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.dev/license
*/
Object.defineProperty(exports, "__esModule", { value: true });
exports.hasLessStylesheets = hasLessStylesheets;
exports.hasPostcssConfiguration = hasPostcssConfiguration;
exports.updateStyleImports = updateStyleImports;
const posix_1 = require("node:path/posix");
const css_import_lexer_1 = require("./css-import-lexer");
/** A list of all supported SASS style extensions.
* Order of extension is important and matches Sass behavior.
*/
const SASS_EXTENSIONS = ['.scss', '.sass', '.css'];
/** The prefix used to indicate a SASS partial file. */
const SASS_PARTIAL_PREFIX = '_';
/**
* Searches the schematic tree for files that have a `.less` extension.
* This is used to determine if the `less` package should be added as a dependency.
*
* @param tree A Schematics tree instance to search.
* @returns `true` if Less stylesheet files are found; otherwise, `false`.
*/
function hasLessStylesheets(tree) {
const directories = [tree.getDir('/')];
let current;
while ((current = directories.pop())) {
for (const path of current.subfiles) {
if (path.endsWith('.less')) {
return true;
}
}
for (const path of current.subdirs) {
if (path === 'node_modules' || path.startsWith('.')) {
continue;
}
directories.push(current.dir(path));
}
}
return false;
}
/**
* Searches for a PostCSS configuration file within the workspace root or any of the project roots.
* This is used to determine if the `postcss` package should be added as a dependency.
*
* @param tree A Schematics tree instance to search.
* @param workspace A Workspace to check for projects.
* @returns `true` if a PostCSS configuration file is found; otherwise, `false`.
*/
function hasPostcssConfiguration(tree, workspace) {
const projectRoots = [...workspace.projects.values()].map((p) => p.root).filter(Boolean);
const searchDirectories = new Set(['', ...projectRoots]);
for (const dir of searchDirectories) {
if (tree.exists((0, posix_1.join)(dir, 'postcss.config.json')) ||
tree.exists((0, posix_1.join)(dir, '.postcssrc.json'))) {
return true;
}
}
return false;
}
/**
* Recursively visits all stylesheet files in a directory and yields their path and content.
*
* @param directory The directory to visit.
*/
function* visitStylesheets(directory) {
for (const path of directory.subfiles) {
if (path.endsWith('.css') || path.endsWith('.scss') || path.endsWith('.sass')) {
const entry = directory.file(path);
if (entry) {
yield [entry.path, entry.content.toString()];
}
}
}
for (const path of directory.subdirs) {
if (path === 'node_modules' || path.startsWith('.')) {
continue;
}
yield* visitStylesheets(directory.dir(path));
}
}
/**
* Determines if a Sass import is likely intended to be relative to the workspace root.
* This is considered true if the import cannot be resolved relative to the containing file,
* but can be resolved relative to the workspace root.
*
* @param specifier The import specifier to check.
* @param filePath The path of the file containing the import.
* @param tree A Schematics tree instance.
* @param fromImport Whether the specifier is from an `@import` rule.
* @returns `true` if the import is likely workspace-relative; otherwise, `false`.
*/
function isWorkspaceRelativeSassImport(specifier, filePath, tree, fromImport) {
const relativeBase = (0, posix_1.dirname)(filePath);
const potentialWorkspacePaths = [...potentialSassImports(specifier, '/', fromImport)];
if (potentialWorkspacePaths.some((p) => tree.exists(p))) {
const potentialRelativePaths = [...potentialSassImports(specifier, relativeBase, fromImport)];
return potentialRelativePaths.every((p) => !tree.exists(p));
}
return false;
}
/**
* Analyzes a single stylesheet's content for import patterns that need to be updated.
*
* @param filePath The path of the stylesheet file.
* @param content The content of the stylesheet file.
* @param tree A Schematics tree instance.
* @returns A `StylesheetAnalysis` object containing the results of the analysis.
*/
function analyzeStylesheet(filePath, content, tree) {
const isSass = filePath.endsWith('.scss') || filePath.endsWith('.sass');
const analysis = {
needsWorkspaceIncludePath: false,
externalDependencies: new Set(),
contentChanges: [],
};
for (const { start, specifier, fromUse } of (0, css_import_lexer_1.findImports)(content, isSass)) {
if (specifier.startsWith('~')) {
analysis.contentChanges.push({ start: start + 1, length: 1 });
}
else if (specifier.startsWith('^')) {
analysis.contentChanges.push({ start: start + 1, length: 1 });
analysis.externalDependencies.add(specifier.slice(1));
}
else if (isSass && isWorkspaceRelativeSassImport(specifier, filePath, tree, !fromUse)) {
analysis.needsWorkspaceIncludePath = true;
}
}
return analysis;
}
/**
* The main orchestrator function for updating stylesheets.
* It iterates through all stylesheets in a project, analyzes them, and applies the necessary
* changes to the files and the build configuration.
*
* @param tree A Schematics tree instance.
* @param projectSourceRoot The source root of the project being updated.
* @param buildTarget The build target of the project being updated.
*/
function updateStyleImports(tree, projectSourceRoot, buildTarget) {
const allExternalDeps = new Set();
let projectNeedsIncludePath = false;
for (const [path, content] of visitStylesheets(tree.getDir(projectSourceRoot))) {
const { needsWorkspaceIncludePath, externalDependencies, contentChanges } = analyzeStylesheet(path, content, tree);
if (needsWorkspaceIncludePath) {
projectNeedsIncludePath = true;
}
for (const dep of externalDependencies) {
allExternalDeps.add(dep);
}
if (contentChanges.length > 0) {
const updater = tree.beginUpdate(path);
// Apply changes in reverse to avoid index shifting
for (const change of contentChanges.sort((a, b) => b.start - a.start)) {
updater.remove(change.start, change.length);
}
tree.commitUpdate(updater);
}
}
if (projectNeedsIncludePath) {
buildTarget.options ??= {};
const styleOptions = (buildTarget.options['stylePreprocessorOptions'] ??= {});
const includePaths = (styleOptions['includePaths'] ??= []);
if (Array.isArray(includePaths)) {
includePaths.push('.');
}
}
if (allExternalDeps.size > 0) {
buildTarget.options ??= {};
const externalDeps = (buildTarget.options['externalDependencies'] ??=
[]);
if (Array.isArray(externalDeps)) {
externalDeps.push(...allExternalDeps);
}
}
}
/**
* A helper generator that yields potential Sass import candidates for a given filename and extensions.
*
* @param directory The directory in which to resolve the candidates.
* @param filename The base filename of the import.
* @param extensions The file extensions to try.
* @param fromImport Whether the specifier is from an `@import` rule.
* @returns An iterable of potential import file paths.
*/
function* yieldSassImportCandidates(directory, filename, extensions, fromImport) {
if (fromImport) {
for (const ext of extensions) {
yield (0, posix_1.join)(directory, filename + '.import' + ext);
yield (0, posix_1.join)(directory, SASS_PARTIAL_PREFIX + filename + '.import' + ext);
}
}
for (const ext of extensions) {
yield (0, posix_1.join)(directory, filename + ext);
yield (0, posix_1.join)(directory, SASS_PARTIAL_PREFIX + filename + ext);
}
}
/**
* Generates a sequence of potential file paths that the Sass compiler would attempt to resolve
* for a given import specifier, following the official Sass resolution algorithm.
* Based on https://github.com/sass/dart-sass/blob/44d6bb6ac72fe6b93f5bfec371a1fffb18e6b76d/lib/src/importer/utils.dart
*
* @param specifier The import specifier to resolve.
* @param base The base path from which to resolve the specifier.
* @param fromImport Whether the specifier is from an `@import` rule.
* @returns An iterable of potential file paths.
*/
function* potentialSassImports(specifier, base, fromImport) {
const directory = (0, posix_1.join)(base, (0, posix_1.dirname)(specifier));
const extension = (0, posix_1.extname)(specifier);
const hasStyleExtension = SASS_EXTENSIONS.includes(extension);
const filename = (0, posix_1.basename)(specifier, hasStyleExtension ? extension : undefined);
const extensionsToTry = hasStyleExtension ? [extension] : SASS_EXTENSIONS;
yield* yieldSassImportCandidates(directory, filename, extensionsToTry, fromImport);
}
//# sourceMappingURL=stylesheet-updates.js.map
File diff suppressed because one or more lines are too long