@wise/wds-codemods 1.0.0-experimental-601f194 → 1.0.0-experimental-49d2d08

package/dist/{helpers-RWhTD5Is.js → helpers-59xSDDPO.js}

@@ -31,6 +31,8 @@ let node_path = require("node:path");
 node_path = __toESM(node_path);
 let __inquirer_prompts = require("@inquirer/prompts");
 let node_fs = require("node:fs");
+let jscodeshift = require("jscodeshift");
+jscodeshift = __toESM(jscodeshift);
 
 //#region node_modules/.pnpm/semver@7.7.2/node_modules/semver/internal/constants.js
 var require_constants = /* @__PURE__ */ __commonJS({ "node_modules/.pnpm/semver@7.7.2/node_modules/semver/internal/constants.js": ((exports, module) => {
@@ -1947,6 +1949,384 @@ async function runTransformPrompts(codemodPath) {
 	return answers;
 }
 
+//#endregion
+//#region src/helpers/hasImport.ts
+/**
+* Checks if a specific import exists in the given root collection and provides
+* a method to remove it if found.
+*/
+function hasImport(root, sourceValue, importName, j) {
+	const importDeclarations = root.find(j.ImportDeclaration, { source: { value: sourceValue } });
+	/**
+	* Finds all ImportSpecifier nodes that expose `importName` but
+	* from a different source than `sourceValue`.
+	*/
+	const conflictingImports = (() => {
+		const result = [];
+		root.find(j.ImportDeclaration).filter((path$3) => path$3.node.source.value !== sourceValue).forEach((path$3) => {
+			for (const specifier of path$3.node.specifiers ?? []) if (specifier.type === "ImportSpecifier" && specifier.imported.name === importName && specifier.local?.name === importName) result.push(specifier);
+		});
+		return result;
+	})();
+	if (importDeclarations.size() === 0) return {
+		exists: false,
+		remove: () => {},
+		resolvedName: importName,
+		conflictingImports
+	};
+	const namedImport = importDeclarations.find(j.ImportSpecifier, { imported: { name: importName } });
+	const defaultImport = importDeclarations.find(j.ImportDefaultSpecifier, { local: { name: importName } });
+	const aliasImport = importDeclarations.find(j.ImportSpecifier).filter((path$3) => {
+		return path$3.node.imported.name === importName && path$3.node.imported.name !== path$3.node.local?.name;
+	});
+	const exists = namedImport.size() > 0 || defaultImport.size() > 0;
+	const resolveName = () => {
+		if (aliasImport.size() > 0) {
+			const localName = aliasImport.get(0).node.local?.name;
+			if (typeof localName === "string") return localName;
+			if (localName && typeof localName === "object" && "name" in localName && typeof localName.name === "string") return localName.name;
+			return importName;
+		}
+		return importName;
+	};
+	const remove = () => {
+		importDeclarations.forEach((path$3) => {
+			const filteredSpecifiers = path$3.node.specifiers?.filter((specifier) => {
+				if (specifier.type === "ImportSpecifier" && specifier.imported.name === importName) return false;
+				if (specifier.type === "ImportDefaultSpecifier" && specifier.local?.name === importName) return false;
+				return true;
+			}) ?? [];
+			if (filteredSpecifiers.length === 0) path$3.prune();
+			else j(path$3).replaceWith(j.importDeclaration(filteredSpecifiers, path$3.node.source, path$3.node.importKind));
+		});
+	};
+	return {
+		exists,
+		remove,
+		aliases: aliasImport,
+		resolvedName: resolveName(),
+		conflictingImports
+	};
+}
+var hasImport_default = hasImport;
+
+//#endregion
+//#region src/helpers/addImport.ts
+/**
+* Adds a named import if it doesn't already exist.
+*/
+function addImport(root, sourceValue, importName, j) {
+	const existingImports = root.find(j.ImportDeclaration, { source: { value: sourceValue } });
+	if (existingImports.size() > 0) {
+		if (existingImports.find(j.ImportSpecifier, { imported: { name: importName } }).size() > 0) return;
+		existingImports.forEach((path$3) => {
+			if (path$3.node.specifiers) path$3.node.specifiers.push(j.importSpecifier(j.identifier(importName)));
+		});
+	} else {
+		const newImport = j.importDeclaration([j.importSpecifier(j.identifier(importName))], j.literal(sourceValue));
+		const firstImport = root.find(j.ImportDeclaration).at(0);
+		if (firstImport.size() > 0) firstImport.insertBefore(newImport);
+		else {
+			const program = root.find(j.Program);
+			if (program.size() > 0) program.get("body", 0).insertBefore(newImport);
+		}
+	}
+}
+var addImport_default = addImport;
+
+//#endregion
+//#region src/helpers/iconUtils.ts
+/**
+* Process children of a JSX element to detect icon components and add iconStart or iconEnd attributes accordingly.
+* This is specific to icon handling but can be reused in codemods dealing with icon children.
+*/
+const processIconChildren = (j, children, iconImports, openingElement) => {
+	if (!children || !openingElement.attributes) return;
+	const unwrapJsxElement = (node) => {
+		if (typeof node === "object" && node !== null && "type" in node && node.type === "JSXExpressionContainer" && j.JSXElement.check(node.expression)) return node.expression;
+		return node;
+	};
+	const totalChildren = children.length;
+	const iconChildIndex = children.findIndex((child) => {
+		const unwrapped = unwrapJsxElement(child);
+		return j.JSXElement.check(unwrapped) && unwrapped.openingElement.name.type === "JSXIdentifier" && iconImports.has(unwrapped.openingElement.name.name);
+	});
+	if (iconChildIndex === -1) return;
+	const iconChild = unwrapJsxElement(children[iconChildIndex]);
+	if (!iconChild || iconChild.openingElement.name.type !== "JSXIdentifier") return;
+	iconChild.openingElement.name.name;
+	const iconPropName = iconChildIndex <= totalChildren - 1 - iconChildIndex ? "addonStart" : "addonEnd";
+	const iconObject = j.objectExpression([j.property("init", j.identifier("type"), j.literal("icon")), j.property("init", j.identifier("value"), iconChild)]);
+	const iconProp = j.jsxAttribute(j.jsxIdentifier(iconPropName), j.jsxExpressionContainer(iconObject));
+	openingElement.attributes.push(iconProp);
+	children.splice(iconChildIndex, 1);
+	const isWhitespaceJsxText = (node) => {
+		return typeof node === "object" && node !== null && node.type === "JSXText" && typeof node.value === "string" && node.value.trim() === "";
+	};
+	if (iconChildIndex - 1 >= 0 && isWhitespaceJsxText(children[iconChildIndex - 1])) children.splice(iconChildIndex - 1, 1);
+	else if (isWhitespaceJsxText(children[iconChildIndex])) children.splice(iconChildIndex, 1);
+};
+var iconUtils_default = processIconChildren;
+
+//#endregion
+//#region src/helpers/jsxElementUtils.ts
+/**
+* Rename a JSX element name if it is a JSXIdentifier.
+*/
+const setNameIfJSXIdentifier = (elementName, newName) => {
+	if (elementName && elementName.type === "JSXIdentifier") return {
+		...elementName,
+		name: newName
+	};
+	return elementName;
+};
+/**
+* Check if a list of attributes contains a specific attribute by name.
+*/
+const hasAttribute = (attributes, attributeName) => {
+	return Array.isArray(attributes) && attributes.some((attr) => attr.type === "JSXAttribute" && attr.name.type === "JSXIdentifier" && attr.name.name === attributeName);
+};
+/**
+* Check if a JSX element's openingElement has a specific attribute.
+*/
+const hasAttributeOnElement = (element, attributeName) => {
+	return hasAttribute(element.attributes, attributeName);
+};
+/**
+* Add specified attributes to a JSX element's openingElement if they are not already present.
+*/
+const addAttributesIfMissing = (j, openingElement, attributesToAdd) => {
+	if (!Array.isArray(openingElement.attributes)) return;
+	const attrs = openingElement.attributes;
+	attributesToAdd.forEach(({ attribute, name }) => {
+		if (!hasAttributeOnElement(openingElement, name)) attrs.push(attribute);
+	});
+};
+/**
+* Returns a collection of JSX elements that match the specified
+* exported name or names of the found aliases.
+*/
+const findJSXElementsByName = (root, j) => (exportedName, aliases) => {
+	const aliasNames = aliases?.size() ? aliases.paths().map((path$3) => path$3.node.local?.name) : [];
+	return root.find(j.JSXElement).filter((path$3) => {
+		const { name } = path$3.node.openingElement;
+		return name.type === "JSXIdentifier" && (name.name === exportedName || aliasNames.includes(name.name));
+	});
+};
+/**
+* Removes an attribute by name from a JSX element's openingElement.
+*/
+const removeAttributeByName = (j, openingElement, attributeName) => {
+	if (!Array.isArray(openingElement.attributes)) return;
+	openingElement.attributes = openingElement.attributes.filter((attr) => {
+		return !(attr.type === "JSXAttribute" && attr.name.type === "JSXIdentifier" && attr.name.name === attributeName);
+	});
+};
+
+//#endregion
+//#region src/helpers/jsxReportingUtils.ts
+/**
+* CodemodReporter is a utility class for reporting issues found during codemod transformations.
+* It provides methods to report issues related to JSX elements, props, and attributes.
+*
+* @example
+* ```typescript
+* const issues: string[] = [];
+* const reporter = createReporter(j, issues);
+*
+* // Report a deprecated prop
+* reporter.reportDeprecatedProp(buttonElement, 'flat', 'variant="text"');
+*
+* // Report complex expression that needs review
+* reporter.reportAmbiguousExpression(element, 'size');
+*
+* // Auto-detect common issues
+* reporter.reportAttributeIssues(element);
+* ```
+*/
+var CodemodReporter = class {
+	j;
+	issues;
+	constructor(options) {
+		this.j = options.jscodeshift;
+		this.issues = options.issues;
+	}
+	/**
+	* Reports an issue with a JSX element
+	*/
+	reportElement(element, reason) {
+		const node = this.getNode(element);
+		const componentName = this.getComponentName(node);
+		const line = this.getLineNumber(node);
+		this.addIssue(`Manual review required: <${componentName}> at line ${line} ${reason}.`);
+	}
+	/**
+	* Reports an issue with a specific prop
+	*/
+	reportProp(element, propName, reason) {
+		const node = this.getNode(element);
+		const componentName = this.getComponentName(node);
+		const line = this.getLineNumber(node);
+		this.addIssue(`Manual review required: prop "${propName}" on <${componentName}> at line ${line} ${reason}.`);
+	}
+	/**
+	* Reports an issue with a JSX attribute directly
+	*/
+	reportAttribute(attr, element, reason) {
+		const node = this.getNode(element);
+		const componentName = this.getComponentName(node);
+		const propName = this.getAttributeName(attr);
+		const line = this.getLineNumber(attr) || this.getLineNumber(node);
+		const defaultReason = this.getAttributeReason(attr);
+		const finalReason = reason || defaultReason;
+		this.addIssue(`Manual review required: prop "${propName}" on <${componentName}> at line ${line} ${finalReason}.`);
+	}
+	/**
+	* Reports spread props on an element
+	*/
+	reportSpreadProps(element) {
+		this.reportElement(element, "contains spread props that need manual review");
+	}
+	/**
+	* Reports conflicting prop and children
+	*/
+	reportPropWithChildren(element, propName) {
+		this.reportProp(element, propName, `conflicts with children - both "${propName}" prop and children are present`);
+	}
+	/**
+	* Reports unsupported prop value
+	*/
+	reportUnsupportedValue(element, propName, value) {
+		this.reportProp(element, propName, `has unsupported value "${value}"`);
+	}
+	/**
+	* Reports ambiguous expression in prop
+	*/
+	reportAmbiguousExpression(element, propName) {
+		this.reportProp(element, propName, "contains a complex expression that needs manual review");
+	}
+	/**
+	* Reports ambiguous children (like dynamic icons)
+	*/
+	reportAmbiguousChildren(element, childType = "content") {
+		this.reportElement(element, `contains ambiguous ${childType} that needs manual review`);
+	}
+	/**
+	* Reports deprecated prop usage
+	*/
+	reportDeprecatedProp(element, propName, alternative) {
+		const suggestion = alternative ? ` Use ${alternative} instead` : "";
+		this.reportProp(element, propName, `is deprecated${suggestion}`);
+	}
+	/**
+	* Reports missing required prop
+	*/
+	reportMissingRequiredProp(element, propName) {
+		this.reportProp(element, propName, "is required but missing");
+	}
+	/**
+	* Reports conflicting props
+	*/
+	reportConflictingProps(element, propNames) {
+		const propList = propNames.map((name) => `"${name}"`).join(", ");
+		this.reportElement(element, `has conflicting props: ${propList} cannot be used together`);
+	}
+	/**
+	* Auto-detects and reports common attribute issues
+	*/
+	reportAttributeIssues(element) {
+		const { attributes } = this.getNode(element).openingElement;
+		if (!attributes) return;
+		if (attributes.some((attr) => attr.type === "JSXSpreadAttribute")) this.reportSpreadProps(element);
+		attributes.forEach((attr) => {
+			if (attr.type === "JSXAttribute" && attr.value?.type === "JSXExpressionContainer") this.reportAttribute(attr, element);
+		});
+	}
+	/**
+	* Finds and reports instances of components that are under an alias (imported with a different name)
+	*/
+	reportAliases(element) {
+		this.reportElement(element, "is used via an import alias and needs manual review");
+	}
+	/**
+	* Finds and reports instances of non-DS import declarations that conflict with the component name
+	*/
+	reportConflictingImports(node) {
+		this.addIssue(`Manual review required: Non-WDS package resulting in an import conflict at line ${this.getLineNumber(node)}.`);
+	}
+	/**
+	* Reports enum usage for future conversion tracking
+	*/
+	reportEnumUsage(element, propName, enumValue) {
+		this.reportProp(element, propName, `uses enum value "${enumValue}" which has been preserved but should be migrated to a string literal in the future`);
+	}
+	getNode(element) {
+		return "node" in element ? element.node : element;
+	}
+	getComponentName(node) {
+		const { name } = node.openingElement;
+		if (name.type === "JSXIdentifier") return name.name;
+		return this.j(name).toSource();
+	}
+	getLineNumber(node) {
+		return node.loc?.start.line?.toString() || "unknown";
+	}
+	getAttributeName(attr) {
+		if (attr.name.type === "JSXIdentifier") return attr.name.name;
+		return this.j(attr.name).toSource();
+	}
+	getAttributeReason(attr) {
+		if (!attr.value) return "has no value";
+		if (attr.value.type === "JSXExpressionContainer") {
+			const expr = attr.value.expression;
+			const expressionType = expr.type.replace("Expression", "").toLowerCase();
+			if (expr.type === "Identifier" || expr.type === "MemberExpression") return `contains a ${expressionType} (${this.j(expr).toSource()})`;
+			return `contains a complex ${expressionType} expression`;
+		}
+		return "needs manual review";
+	}
+	addIssue(message) {
+		this.issues.push(message);
+	}
+};
+const createReporter = (j, issues) => {
+	return new CodemodReporter({
+		jscodeshift: j,
+		issues
+	});
+};
+
+//#endregion
+//#region src/helpers/index.ts
+const EXT = /\.(?:jsx?|tsx?)$/iu;
+function isCodeFile(p) {
+	return EXT.test(p);
+}
+function walk(p) {
+	if ((0, node_fs.statSync)(p).isFile()) return isCodeFile(p) ? [p] : [];
+	return (0, node_fs.readdirSync)(p, { withFileTypes: true }).flatMap((d) => {
+		if (d.name === "node_modules" || d.name.startsWith(".")) return [];
+		return walk((0, node_path.join)(p, d.name));
+	});
+}
+function findFilesWithImports(targetPaths, source, names, parser = "tsx") {
+	const j = jscodeshift.default.withParser(parser);
+	return Array.from(new Set(targetPaths.map((p) => (0, node_path.resolve)(p)).flatMap((p) => {
+		try {
+			return (0, node_fs.statSync)(p).isDirectory() ? walk(p) : isCodeFile(p) ? [p] : [];
+		} catch {
+			return [];
+		}
+	}))).filter((file) => {
+		try {
+			const root = j((0, node_fs.readFileSync)(file, "utf8"));
+			return names.some((n) => hasImport_default(root, source, n, j).exists);
+		} catch {
+			return false;
+		}
+	});
+}
+
 //#endregion
 Object.defineProperty(exports, '__toESM', {
   enumerable: true,
@@ -1954,12 +2334,42 @@ Object.defineProperty(exports, '__toESM', {
     return __toESM;
   }
 });
+Object.defineProperty(exports, 'addAttributesIfMissing', {
+  enumerable: true,
+  get: function () {
+    return addAttributesIfMissing;
+  }
+});
+Object.defineProperty(exports, 'addImport_default', {
+  enumerable: true,
+  get: function () {
+    return addImport_default;
+  }
+});
 Object.defineProperty(exports, 'assessPrerequisites', {
   enumerable: true,
   get: function () {
     return assessPrerequisites;
   }
 });
+Object.defineProperty(exports, 'createReporter', {
+  enumerable: true,
+  get: function () {
+    return createReporter;
+  }
+});
+Object.defineProperty(exports, 'findFilesWithImports', {
+  enumerable: true,
+  get: function () {
+    return findFilesWithImports;
+  }
+});
+Object.defineProperty(exports, 'findJSXElementsByName', {
+  enumerable: true,
+  get: function () {
+    return findJSXElementsByName;
+  }
+});
 Object.defineProperty(exports, 'findPackages', {
   enumerable: true,
   get: function () {
@@ -1978,6 +2388,24 @@ Object.defineProperty(exports, 'getOptions_default', {
     return getOptions_default;
   }
 });
+Object.defineProperty(exports, 'hasAttributeOnElement', {
+  enumerable: true,
+  get: function () {
+    return hasAttributeOnElement;
+  }
+});
+Object.defineProperty(exports, 'hasImport_default', {
+  enumerable: true,
+  get: function () {
+    return hasImport_default;
+  }
+});
+Object.defineProperty(exports, 'iconUtils_default', {
+  enumerable: true,
+  get: function () {
+    return iconUtils_default;
+  }
+});
 Object.defineProperty(exports, 'loadTransformModules_default', {
   enumerable: true,
   get: function () {
@@ -1990,6 +2418,12 @@ Object.defineProperty(exports, 'logToInquirer', {
     return logToInquirer;
   }
 });
+Object.defineProperty(exports, 'removeAttributeByName', {
+  enumerable: true,
+  get: function () {
+    return removeAttributeByName;
+  }
+});
 Object.defineProperty(exports, 'reportManualReview_default', {
   enumerable: true,
   get: function () {
@@ -2002,4 +2436,10 @@ Object.defineProperty(exports, 'runTransformPrompts', {
     return runTransformPrompts;
   }
 });
-//# sourceMappingURL=helpers-RWhTD5Is.js.map
+Object.defineProperty(exports, 'setNameIfJSXIdentifier', {
+  enumerable: true,
+  get: function () {
+    return setNameIfJSXIdentifier;
+  }
+});
+//# sourceMappingURL=helpers-59xSDDPO.js.map