@onecx/nx-migration-utils 6.0.0-rc.9 → 6.1.0

package/src/lib/utils/modification/update-style-sheets.utils.d.ts

@@ -0,0 +1,20 @@
+import { Tree } from '@nx/devkit';
+import postcss from 'postcss';
+/**
+ * Updates all stylesheet files within a specified directory using a PostCSS-based updater function.
+ * Only processes files that are identified as stylesheets (e.g., .css, .scss).
+ * Optionally logs warnings if certain content conditions are met.
+ *
+ * @param tree - The Nx Tree (virtual file system).
+ * @param dirPath - The directory path to search for stylesheet files.
+ * @param updater - A function that receives the parsed PostCSS root and returns the updated stylesheet as a string.
+ * @param options - Optional settings:
+ *  - warn: Whether to print warnings.
+ *  - warning: The warning message to display.
+ *  - contentCondition: A string to match in file paths for triggering warnings.
+ */
+export declare function updateStyleSheets(tree: Tree, dirPath: string, updater: (styleSheetContent: postcss.Root) => string, options?: {
+    warn: boolean;
+    warning: string;
+    contentCondition: string;
+}): void;

package/src/lib/utils/modification/update-style-sheets.utils.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateStyleSheets = updateStyleSheets;
+const devkit_1 = require("@nx/devkit");
+const print_warnings_utils_1 = require("../print-warnings.utils");
+const is_file_style_sheet_utils_1 = require("../validation/is-file-style-sheet.utils");
+const update_style_sheet_utils_1 = require("./update-style-sheet.utils");
+/**
+ * Updates all stylesheet files within a specified directory using a PostCSS-based updater function.
+ * Only processes files that are identified as stylesheets (e.g., .css, .scss).
+ * Optionally logs warnings if certain content conditions are met.
+ *
+ * @param tree - The Nx Tree (virtual file system).
+ * @param dirPath - The directory path to search for stylesheet files.
+ * @param updater - A function that receives the parsed PostCSS root and returns the updated stylesheet as a string.
+ * @param options - Optional settings:
+ *  - warn: Whether to print warnings.
+ *  - warning: The warning message to display.
+ *  - contentCondition: A string to match in file paths for triggering warnings.
+ */
+function updateStyleSheets(tree, dirPath, updater, options) {
+    const foundInFiles = [];
+    (0, devkit_1.visitNotIgnoredFiles)(tree, dirPath, (file) => {
+        if ((0, is_file_style_sheet_utils_1.isStyleSheet)(file)) {
+            options && file.includes(options.contentCondition) && foundInFiles.push(file);
+            (0, update_style_sheet_utils_1.updateStyleSheet)(tree, file, updater);
+        }
+    });
+    options?.warn && (0, print_warnings_utils_1.printWarnings)(options.warning, foundInFiles);
+}
+//# sourceMappingURL=update-style-sheets.utils.js.map

package/src/lib/utils/modification/update-style-sheets.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-style-sheets.utils.js","sourceRoot":"","sources":["../../../../../../../libs/nx-migration-utils/src/lib/utils/modification/update-style-sheets.utils.ts"],"names":[],"mappings":";;AAmBA,8CAgBC;AAnCD,uCAAuD;AACvD,kEAAuD;AACvD,uFAAsE;AACtE,yEAA6D;AAG7D;;;;;;;;;;;;GAYG;AACH,SAAgB,iBAAiB,CAC/B,IAAU,EACV,OAAe,EACf,OAAoD,EACpD,OAAsE;IAEtE,MAAM,YAAY,GAAa,EAAE,CAAA;IAEjC,IAAA,6BAAoB,EAAC,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QAC3C,IAAI,IAAA,wCAAY,EAAC,IAAI,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC7E,IAAA,2CAAgB,EAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QACvC,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,EAAE,IAAI,IAAI,IAAA,oCAAa,EAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;AAC/D,CAAC"}

package/src/lib/utils/patterns.utils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Creates a pattern to look for a variable containing the identifier
+ * @param identifierName - identifier to look for
+ * @returns {string} ast query pattern
+ */
+export declare function variableContainingIdentifierPattern(identifierName: string): string;
+/**
+ * Creates a pattern to look for import.
+ * @param importPath - import path to look for
+ * @returns {string} ast query pattern
+ */
+export declare function importPattern(importPath: string): string;
+/**
+ * Creates a pattern to look for namespace import (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#namespace_import).
+ * @param importPath - import path to look for
+ * @returns {string} ast query pattern
+ */
+export declare function importNamespacePattern(importPath: string): string;
+/**
+ * Creates a pattern to look for named import (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#named_import).
+ * @param importPath - import path to look for
+ * @returns {string} ast query pattern
+ */
+export declare function importNamedImportsPattern(importPath: string): string;
+/**
+ * Creates a pattern to look for import specifier.
+ * @param importPath - import path to look for
+ * @param specifier - specifier to look for, e.g., "MyClass"
+ * @returns {string} ast query pattern
+ */
+export declare function importSpecifierPattern(importPath: string, specifier: string): string;

package/src/lib/utils/patterns.utils.js

@@ -0,0 +1,51 @@
+"use strict";
+// General patterns
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.variableContainingIdentifierPattern = variableContainingIdentifierPattern;
+exports.importPattern = importPattern;
+exports.importNamespacePattern = importNamespacePattern;
+exports.importNamedImportsPattern = importNamedImportsPattern;
+exports.importSpecifierPattern = importSpecifierPattern;
+/**
+ * Creates a pattern to look for a variable containing the identifier
+ * @param identifierName - identifier to look for
+ * @returns {string} ast query pattern
+ */
+function variableContainingIdentifierPattern(identifierName) {
+    return `VariableDeclaration:has(Identifier[name=${identifierName}])`;
+}
+// Import patterns
+/**
+ * Creates a pattern to look for import.
+ * @param importPath - import path to look for
+ * @returns {string} ast query pattern
+ */
+function importPattern(importPath) {
+    return `ImportDeclaration:has(StringLiteral[value=${importPath}])`;
+}
+/**
+ * Creates a pattern to look for namespace import (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#namespace_import).
+ * @param importPath - import path to look for
+ * @returns {string} ast query pattern
+ */
+function importNamespacePattern(importPath) {
+    return `ImportDeclaration:has(StringLiteral[value=${importPath}]):has(NamespaceImport)`;
+}
+/**
+ * Creates a pattern to look for named import (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#named_import).
+ * @param importPath - import path to look for
+ * @returns {string} ast query pattern
+ */
+function importNamedImportsPattern(importPath) {
+    return `${importPattern(importPath)} NamedImports`;
+}
+/**
+ * Creates a pattern to look for import specifier.
+ * @param importPath - import path to look for
+ * @param specifier - specifier to look for, e.g., "MyClass"
+ * @returns {string} ast query pattern
+ */
+function importSpecifierPattern(importPath, specifier) {
+    return `ImportDeclaration:has(StringLiteral[value=${importPath}]):has(ImportSpecifier:has(Identifier[name=${specifier}]))`;
+}
+//# sourceMappingURL=patterns.utils.js.map

package/src/lib/utils/patterns.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.utils.js","sourceRoot":"","sources":["../../../../../../libs/nx-migration-utils/src/lib/utils/patterns.utils.ts"],"names":[],"mappings":";AAAA,mBAAmB;;AAOnB,kFAEC;AASD,sCAEC;AAOD,wDAEC;AAOD,8DAEC;AAQD,wDAEC;AA9CD;;;;GAIG;AACH,SAAgB,mCAAmC,CAAC,cAAsB;IACxE,OAAO,2CAA2C,cAAc,IAAI,CAAA;AACtE,CAAC;AAED,kBAAkB;AAElB;;;;GAIG;AACH,SAAgB,aAAa,CAAC,UAAkB;IAC9C,OAAO,6CAA6C,UAAU,IAAI,CAAA;AACpE,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB,CAAC,UAAkB;IACvD,OAAO,6CAA6C,UAAU,yBAAyB,CAAA;AACzF,CAAC;AAED;;;;GAIG;AACH,SAAgB,yBAAyB,CAAC,UAAkB;IAC1D,OAAO,GAAG,aAAa,CAAC,UAAU,CAAC,eAAe,CAAA;AACpD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,UAAkB,EAAE,SAAiB;IAC1E,OAAO,6CAA6C,UAAU,8CAA8C,SAAS,KAAK,CAAA;AAC5H,CAAC"}

package/src/lib/utils/print-warnings.d.ts

@@ -1,6 +1 @@
-/**
- * Prints a warning message if there are affected files.
- * @param warning The warning message to print.
- * @param affectedFiles An array of affected file paths.
- */
 export declare function printWarnings(warning: string, affectedFiles: string[]): void;

package/src/lib/utils/print-warnings.js

@@ -2,11 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.printWarnings = printWarnings;
 const devkit_1 = require("@nx/devkit");
-/**
- * Prints a warning message if there are affected files.
- * @param warning The warning message to print.
- * @param affectedFiles An array of affected file paths.
- */
 function printWarnings(warning, affectedFiles) {
     if (affectedFiles.length > 0) {
         devkit_1.logger.warn(warning);

package/src/lib/utils/print-warnings.js.map

@@ -1 +1 @@
-{"version":3,"file":"print-warnings.js","sourceRoot":"","sources":["../../../../../../libs/nx-migration-utils/src/lib/utils/print-warnings.ts"],"names":[],"mappings":";;AAOA,sCAQC;AAfD,uCAAmC;AAEnC;;;;GAIG;AACH,SAAgB,aAAa,CAAC,OAAe,EAAE,aAAuB;IAClE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,eAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACpB,eAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACxB,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAC7B,eAAM,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;IACJ,CAAC;AACP,CAAC"}
+{"version":3,"file":"print-warnings.js","sourceRoot":"","sources":["../../../../../../libs/nx-migration-utils/src/lib/utils/print-warnings.ts"],"names":[],"mappings":";;AACA,sCAQC;AATD,uCAAmC;AACnC,SAAgB,aAAa,CAAC,OAAe,EAAE,aAAuB;IAClE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,eAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACpB,eAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACxB,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAC7B,eAAM,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;IACJ,CAAC;AACP,CAAC"}

package/src/lib/utils/print-warnings.utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Prints a warning message if there are affected files.
+ * @param warning The warning message to print.
+ * @param affectedFiles An array of affected file paths.
+ */
+export declare function printWarnings(warning: string, affectedFiles: string[]): void;

package/src/lib/utils/print-warnings.utils.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printWarnings = printWarnings;
+const devkit_1 = require("@nx/devkit");
+/**
+ * Prints a warning message if there are affected files.
+ * @param warning The warning message to print.
+ * @param affectedFiles An array of affected file paths.
+ */
+function printWarnings(warning, affectedFiles) {
+    if (affectedFiles.length > 0) {
+        devkit_1.logger.warn(`${warning} Found in: ${affectedFiles.join(',')}`);
+    }
+}
+//# sourceMappingURL=print-warnings.utils.js.map

package/src/lib/utils/print-warnings.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-warnings.utils.js","sourceRoot":"","sources":["../../../../../../libs/nx-migration-utils/src/lib/utils/print-warnings.utils.ts"],"names":[],"mappings":";;AAOA,sCAIC;AAXD,uCAAmC;AAEnC;;;;GAIG;AACH,SAAgB,aAAa,CAAC,OAAe,EAAE,aAAuB;IACpE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,eAAM,CAAC,IAAI,CAAC,GAAG,OAAO,cAAc,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAChE,CAAC;AACH,CAAC"}

package/src/lib/utils/typescript-files.utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Checks if a file's content matches a given tsquery string.
+ * @param fileContent - The content of the TypeScript file.
+ * @param queryStr - A tsquery selector string.
+ * @returns True if the file matches the query; otherwise, false.
+ */
+export declare function fileMatchesQuery(fileContent: string, queryStr: string): boolean;
+/**
+ * Removes empty slots (i.e., omitted expressions like `[1,,2]`) from all array literals
+ * in a given TypeScript code string.
+ * @param code - The TypeScript source code as a string.
+ * @returns A new string with all empty array slots removed.
+ */
+export declare function removeEmptySlotsFromArrays(code: string): string;
+/**
+ * Determines whether a given string is likely to represent a file path.
+ * @param input - The input string to evaluate.
+ * @returns `true` if the input appears to be a file path, otherwise `false`.
+ */
+export declare function isFilePath(input: string): boolean;

package/src/lib/utils/typescript-files.utils.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fileMatchesQuery = fileMatchesQuery;
+exports.removeEmptySlotsFromArrays = removeEmptySlotsFromArrays;
+exports.isFilePath = isFilePath;
+const tsquery_1 = require("@phenomnomnominal/tsquery");
+const path_1 = require("path");
+const typescript_1 = require("typescript");
+/**
+ * Checks if a file's content matches a given tsquery string.
+ * @param fileContent - The content of the TypeScript file.
+ * @param queryStr - A tsquery selector string.
+ * @returns True if the file matches the query; otherwise, false.
+ */
+function fileMatchesQuery(fileContent, queryStr) {
+    try {
+        const contentAst = (0, tsquery_1.ast)(fileContent);
+        return (0, tsquery_1.query)(contentAst, queryStr).length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Removes empty slots (i.e., omitted expressions like `[1,,2]`) from all array literals
+ * in a given TypeScript code string.
+ * @param code - The TypeScript source code as a string.
+ * @returns A new string with all empty array slots removed.
+ */
+function removeEmptySlotsFromArrays(code) {
+    try {
+        return (0, tsquery_1.replace)(code, 'ArrayLiteralExpression', (node) => {
+            if (!(0, typescript_1.isArrayLiteralExpression)(node))
+                return null;
+            const elements = node.elements.filter((expression) => expression.kind !== typescript_1.SyntaxKind.OmittedExpression);
+            if (elements.length === node.elements.length)
+                return null;
+            const updatedArray = typescript_1.factory.updateArrayLiteralExpression(node, elements);
+            return (0, typescript_1.createPrinter)().printNode(typescript_1.EmitHint.Unspecified, updatedArray, node.getSourceFile());
+        }, typescript_1.ScriptKind.TS);
+    }
+    catch (error) {
+        console.error(`Failed to remove empty array slots: `, error);
+        return code;
+    }
+}
+/**
+ * Determines whether a given string is likely to represent a file path.
+ * @param input - The input string to evaluate.
+ * @returns `true` if the input appears to be a file path, otherwise `false`.
+ */
+function isFilePath(input) {
+    const hasExtension = !!(0, path_1.extname)(input);
+    const looksLikePath = input.includes('/') || (0, path_1.isAbsolute)(input);
+    return hasExtension && looksLikePath;
+}
+//# sourceMappingURL=typescript-files.utils.js.map

package/src/lib/utils/typescript-files.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-files.utils.js","sourceRoot":"","sources":["../../../../../../libs/nx-migration-utils/src/lib/utils/typescript-files.utils.ts"],"names":[],"mappings":";;AAUA,4CAOC;AAQD,gEAqBC;AAOD,gCAIC;AAzDD,uDAA+D;AAC/D,+BAA0C;AAC1C,2CAA+G;AAE/G;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,WAAmB,EAAE,QAAgB;IACpE,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAA,aAAG,EAAC,WAAW,CAAC,CAAA;QACnC,OAAO,IAAA,eAAK,EAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,0BAA0B,CAAC,IAAY;IACrD,IAAI,CAAC;QACH,OAAO,IAAA,iBAAO,EACZ,IAAI,EACJ,wBAAwB,EACxB,CAAC,IAAI,EAAE,EAAE;YACP,IAAI,CAAC,IAAA,qCAAwB,EAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAA;YAEhD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,uBAAU,CAAC,iBAAiB,CAAC,CAAA;YAEvG,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAA;YAEzD,MAAM,YAAY,GAAG,oBAAO,CAAC,4BAA4B,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;YACzE,OAAO,IAAA,0BAAa,GAAE,CAAC,SAAS,CAAC,qBAAQ,CAAC,WAAW,EAAE,YAAY,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAA;QAC5F,CAAC,EACD,uBAAU,CAAC,EAAE,CACd,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAA;QAC5D,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,KAAa;IACtC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAA,cAAO,EAAC,KAAK,CAAC,CAAA;IACrC,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAA,iBAAU,EAAC,KAAK,CAAC,CAAA;IAC9D,OAAO,YAAY,IAAI,aAAa,CAAA;AACtC,CAAC"}

package/src/lib/utils/update-gitignore.utils.d.ts

@@ -0,0 +1,9 @@
+import { Tree } from '@nx/devkit';
+/**
+ * Adds an entry to .gitignore if it doesn't already exist.
+ */
+export declare function addGitignoreEntry(tree: Tree, entry: string): void;
+/**
+ * Removes an entry from .gitignore if it exists.
+ */
+export declare function removeGitignoreEntry(tree: Tree, entry: string): void;

package/src/lib/utils/update-gitignore.utils.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addGitignoreEntry = addGitignoreEntry;
+exports.removeGitignoreEntry = removeGitignoreEntry;
+const normalizeLine = (line) => line.trim();
+/**
+ * Adds an entry to .gitignore if it doesn't already exist.
+ */
+function addGitignoreEntry(tree, entry) {
+    const gitignorePath = '.gitignore';
+    const normalizedEntry = normalizeLine(entry);
+    if (!tree.exists(gitignorePath)) {
+        tree.write(gitignorePath, `${normalizedEntry}\n`);
+        return;
+    }
+    const content = tree.read(gitignorePath, 'utf-8');
+    if (!content)
+        return;
+    const lines = content.split('\n').map(normalizeLine);
+    if (!lines.includes(normalizedEntry)) {
+        const updatedContent = content.trimEnd() + `\n${normalizedEntry}\n`;
+        tree.write(gitignorePath, updatedContent);
+    }
+}
+/**
+ * Removes an entry from .gitignore if it exists.
+ */
+function removeGitignoreEntry(tree, entry) {
+    const gitignorePath = '.gitignore';
+    const normalizedEntry = normalizeLine(entry);
+    if (!tree.exists(gitignorePath))
+        return;
+    const content = tree.read(gitignorePath, 'utf-8');
+    if (!content)
+        return;
+    const lines = content.split('\n');
+    const filteredLines = lines.filter((line) => normalizeLine(line) !== normalizedEntry);
+    if (lines.length !== filteredLines.length) {
+        tree.write(gitignorePath, filteredLines.join('\n') + '\n');
+    }
+}
+//# sourceMappingURL=update-gitignore.utils.js.map

package/src/lib/utils/update-gitignore.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-gitignore.utils.js","sourceRoot":"","sources":["../../../../../../libs/nx-migration-utils/src/lib/utils/update-gitignore.utils.ts"],"names":[],"mappings":";;AAOA,8CAkBC;AAKD,oDAgBC;AA5CD,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;AAEnD;;GAEG;AACH,SAAgB,iBAAiB,CAAC,IAAU,EAAE,KAAa;IACzD,MAAM,aAAa,GAAG,YAAY,CAAA;IAClC,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;IAE5C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,GAAG,eAAe,IAAI,CAAC,CAAA;QACjD,OAAM;IACR,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;IACjD,IAAI,CAAC,OAAO;QAAE,OAAM;IAEpB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IAEpD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QACrC,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,KAAK,eAAe,IAAI,CAAA;QACnE,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IAC3C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,IAAU,EAAE,KAAa;IAC5D,MAAM,aAAa,GAAG,YAAY,CAAA;IAClC,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;IAE5C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;QAAE,OAAM;IAEvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;IACjD,IAAI,CAAC,OAAO;QAAE,OAAM;IAEpB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAEjC,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,eAAe,CAAC,CAAA;IAErF,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa,CAAC,MAAM,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;IAC5D,CAAC;AACH,CAAC"}

package/src/lib/utils/validation/has-html-tag.utils.d.ts

@@ -0,0 +1,10 @@
+import { Tree } from '@nx/devkit';
+/**
+ * Checks if a specific tag exists in HTML content or an HTML file using Nx Tree.
+ * Automatically detects if the input is a HTML file path.
+ * @param tree - The Nx Tree (virtual file system).
+ * @param input - HTML string or file path.
+ * @param tagName - The tag name to search for.
+ * @returns True if the tag is found, false otherwise.
+ */
+export declare function hasHtmlTag(tree: Tree, input: string, tagName: string): boolean;

package/src/lib/utils/validation/has-html-tag.utils.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasHtmlTag = hasHtmlTag;
+const node_html_parser_1 = require("node-html-parser");
+const typescript_files_utils_1 = require("../typescript-files.utils");
+/**
+ * Checks if a specific tag exists in HTML content or an HTML file using Nx Tree.
+ * Automatically detects if the input is a HTML file path.
+ * @param tree - The Nx Tree (virtual file system).
+ * @param input - HTML string or file path.
+ * @param tagName - The tag name to search for.
+ * @returns True if the tag is found, false otherwise.
+ */
+function hasHtmlTag(tree, input, tagName) {
+    try {
+        const isHtmlFile = (0, typescript_files_utils_1.isFilePath)(input) && input.endsWith('.html');
+        const html = isHtmlFile ? tree.read(input, 'utf-8') : input;
+        if (!html) {
+            return false;
+        }
+        const root = (0, node_html_parser_1.parse)(html);
+        return root.querySelectorAll(tagName).length > 0;
+    }
+    catch (error) {
+        console.error(`Error checking for tag "${tagName}": `, error);
+        return false;
+    }
+}
+//# sourceMappingURL=has-html-tag.utils.js.map

package/src/lib/utils/validation/has-html-tag.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-html-tag.utils.js","sourceRoot":"","sources":["../../../../../../../libs/nx-migration-utils/src/lib/utils/validation/has-html-tag.utils.ts"],"names":[],"mappings":";;AAYA,gCAgBC;AA3BD,uDAAwC;AACxC,sEAAsD;AAEtD;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAC,IAAU,EAAE,KAAa,EAAE,OAAe;IACnE,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAA,mCAAU,EAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAC/D,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QAE3D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,KAAK,CAAA;QACd,CAAC;QAED,MAAM,IAAI,GAAG,IAAA,wBAAK,EAAC,IAAI,CAAC,CAAA;QAExB,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,OAAO,KAAK,EAAE,KAAK,CAAC,CAAA;QAC7D,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}

package/src/lib/utils/validation/is-file-style-sheet.utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Determines whether a given file path points to a stylesheet file.
+ * Supports `.css` and `.scss` extensions.
+ *
+ * @param filePath - The file path to check.
+ * @returns True if the file is a stylesheet, false otherwise.
+ */
+export declare function isStyleSheet(filePath: string): boolean;

package/src/lib/utils/validation/is-file-style-sheet.utils.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isStyleSheet = isStyleSheet;
+/**
+ * Determines whether a given file path points to a stylesheet file.
+ * Supports `.css` and `.scss` extensions.
+ *
+ * @param filePath - The file path to check.
+ * @returns True if the file is a stylesheet, false otherwise.
+ */
+function isStyleSheet(filePath) {
+    return filePath.endsWith('.css') || filePath.endsWith('.scss');
+}
+//# sourceMappingURL=is-file-style-sheet.utils.js.map

package/src/lib/utils/validation/is-file-style-sheet.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-file-style-sheet.utils.js","sourceRoot":"","sources":["../../../../../../../libs/nx-migration-utils/src/lib/utils/validation/is-file-style-sheet.utils.ts"],"names":[],"mappings":";;AAOA,oCAEC;AATD;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,QAAgB;IAC3C,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;AAChE,CAAC"}

package/src/lib/utils/validation/is-import-in-content.utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Checks if file contains import.
+ * @param fileContent - the content of the file to check
+ * @param importPath - import path to look for
+ * @returns {boolean} if file contains the import
+ */
+export declare function isImportInContent(fileContent: string, importPath: string): boolean;

package/src/lib/utils/validation/is-import-in-content.utils.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isImportInContent = isImportInContent;
+const tsquery_1 = require("@phenomnomnominal/tsquery");
+const patterns_utils_1 = require("../patterns.utils");
+/**
+ * Checks if file contains import.
+ * @param fileContent - the content of the file to check
+ * @param importPath - import path to look for
+ * @returns {boolean} if file contains the import
+ */
+function isImportInContent(fileContent, importPath) {
+    const contentAst = (0, tsquery_1.ast)(fileContent);
+    const imports = (0, tsquery_1.query)(contentAst, (0, patterns_utils_1.importPattern)(importPath));
+    return imports.length > 0;
+}
+//# sourceMappingURL=is-import-in-content.utils.js.map

package/src/lib/utils/validation/is-import-in-content.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-import-in-content.utils.js","sourceRoot":"","sources":["../../../../../../../libs/nx-migration-utils/src/lib/utils/validation/is-import-in-content.utils.ts"],"names":[],"mappings":";;AASA,8CAMC;AAfD,uDAAsD;AACtD,sDAAiD;AAEjD;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,WAAmB,EAAE,UAAkB;IACvE,MAAM,UAAU,GAAG,IAAA,aAAG,EAAC,WAAW,CAAC,CAAA;IAEnC,MAAM,OAAO,GAAG,IAAA,eAAK,EAAoB,UAAU,EAAE,IAAA,8BAAa,EAAC,UAAU,CAAC,CAAC,CAAA;IAE/E,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAA;AAC3B,CAAC"}

package/src/lib/utils/validation/is-import-in-file-content.utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Checks if file contains import specifier.
+ * @param fileContent - the content of the file to check
+ * @param importPath - import path to look for
+ * @param specifier - import specifier to look for
+ * @returns {boolean} if file contains the import
+ */
+export declare function isImportSpecifierInContent(fileContent: string, importPath: string, specifier: string): boolean;

package/src/lib/utils/validation/is-import-in-file-content.utils.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isImportSpecifierInContent = isImportSpecifierInContent;
+const tsquery_1 = require("@phenomnomnominal/tsquery");
+const patterns_utils_1 = require("../patterns.utils");
+/**
+ * Checks if file contains import specifier.
+ * @param fileContent - the content of the file to check
+ * @param importPath - import path to look for
+ * @param specifier - import specifier to look for
+ * @returns {boolean} if file contains the import
+ */
+function isImportSpecifierInContent(fileContent, importPath, specifier) {
+    const contentAst = (0, tsquery_1.ast)(fileContent);
+    const imports = (0, tsquery_1.query)(contentAst, (0, patterns_utils_1.importSpecifierPattern)(importPath, specifier));
+    return imports.length > 0;
+}
+//# sourceMappingURL=is-import-in-file-content.utils.js.map

package/src/lib/utils/validation/is-import-in-file-content.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-import-in-file-content.utils.js","sourceRoot":"","sources":["../../../../../../../libs/nx-migration-utils/src/lib/utils/validation/is-import-in-file-content.utils.ts"],"names":[],"mappings":";;AAUA,gEAMC;AAhBD,uDAAsD;AACtD,sDAA0D;AAE1D;;;;;;GAMG;AACH,SAAgB,0BAA0B,CAAC,WAAmB,EAAE,UAAkB,EAAE,SAAiB;IACnG,MAAM,UAAU,GAAG,IAAA,aAAG,EAAC,WAAW,CAAC,CAAA;IAEnC,MAAM,OAAO,GAAG,IAAA,eAAK,EAAoB,UAAU,EAAE,IAAA,uCAAsB,EAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAA;IAEnG,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAA;AAC3B,CAAC"}

package/src/lib/utils/validation/is-namespace-import-in-content.utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Checks if file contains namespace import (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#namespace_import).
+ * @param fileContent - the content of the file to check
+ * @param importPath - import path to look for
+ * @returns {boolean} if file contains the namespace import
+ */
+export declare function isNamespaceImportInContent(fileContent: string, importPath: string): boolean;

package/src/lib/utils/validation/is-namespace-import-in-content.utils.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNamespaceImportInContent = isNamespaceImportInContent;
+const tsquery_1 = require("@phenomnomnominal/tsquery");
+const patterns_utils_1 = require("../patterns.utils");
+/**
+ * Checks if file contains namespace import (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#namespace_import).
+ * @param fileContent - the content of the file to check
+ * @param importPath - import path to look for
+ * @returns {boolean} if file contains the namespace import
+ */
+function isNamespaceImportInContent(fileContent, importPath) {
+    const contentAst = (0, tsquery_1.ast)(fileContent);
+    const namespaceImports = (0, tsquery_1.query)(contentAst, (0, patterns_utils_1.importNamespacePattern)(importPath));
+    return namespaceImports.length > 0;
+}
+//# sourceMappingURL=is-namespace-import-in-content.utils.js.map

package/src/lib/utils/validation/is-namespace-import-in-content.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-namespace-import-in-content.utils.js","sourceRoot":"","sources":["../../../../../../../libs/nx-migration-utils/src/lib/utils/validation/is-namespace-import-in-content.utils.ts"],"names":[],"mappings":";;AAUA,gEAMC;AAhBD,uDAAsD;AACtD,sDAA0D;AAG1D;;;;;GAKG;AACH,SAAgB,0BAA0B,CAAC,WAAmB,EAAE,UAAkB;IAChF,MAAM,UAAU,GAAG,IAAA,aAAG,EAAC,WAAW,CAAC,CAAA;IAEnC,MAAM,gBAAgB,GAAG,IAAA,eAAK,EAAoB,UAAU,EAAE,IAAA,uCAAsB,EAAC,UAAU,CAAC,CAAC,CAAA;IAEjG,OAAO,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAA;AACpC,CAAC"}

package/src/test-setup.d.ts

@@ -0,0 +1 @@
+export {};

package/src/test-setup.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const matchers = require("jest-extended");
+globals_1.expect.extend(matchers);
+//# sourceMappingURL=test-setup.js.map

package/src/test-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.js","sourceRoot":"","sources":["../../../../libs/nx-migration-utils/src/test-setup.ts"],"names":[],"mappings":";;AAAA,2CAAsC;AACtC,0CAAyC;AACzC,gBAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA"}