@trackunit/react-components 1.24.7 → 1.25.0

package/migrations/entry.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=entry.js.map

package/migrations/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../../../libs/react/components/migrations/entry.ts"],"names":[],"mappings":"","sourcesContent":["// Migration entry point for @nx/js:tsc build target.\n// Migrations are registered in ../migrations.json and resolved by NX at runtime.\nexport {};\n"]}

package/migrations/utils/jsx-utils.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.insertAttributeIntoOpeningTag = exports.logSummary = exports.tsquery = exports.parseTsx = exports.hasSpreadAttribute = exports.findJsxAttribute = exports.findJsxElements = exports.getLocalAliasFor = exports.getImportedAliases = exports.visitTsFiles = exports.visitTsxFiles = void 0;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const tsquery_1 = require("@phenomnomnominal/tsquery");
+Object.defineProperty(exports, "tsquery", { enumerable: true, get: function () { return tsquery_1.tsquery; } });
+const ts = tslib_1.__importStar(require("typescript"));
+const TSX_EXTENSIONS = [".tsx", ".jsx"];
+const TS_EXTENSIONS = [".ts", ".tsx", ".jsx"];
+const isTsxFile = (filePath) => TSX_EXTENSIONS.some(ext => filePath.endsWith(ext));
+const isTsFile = (filePath) => TS_EXTENSIONS.some(ext => filePath.endsWith(ext));
+const isUnderNodeModules = (filePath) => filePath.includes("/node_modules/") || filePath.startsWith("node_modules/");
+const isUnderDist = (filePath) => filePath.includes("/dist/") || filePath.startsWith("dist/") || filePath.includes("/.nx/");
+/**
+ * Visits every `.tsx`/`.jsx` file under the workspace root and invokes the
+ * callback with the file path and its current contents. Files that don't
+ * include the marker substring are skipped, which makes large workspaces
+ * cheap to scan.
+ */
+const visitTsxFiles = (tree, marker, callback) => {
+    let touched = 0;
+    (0, devkit_1.visitNotIgnoredFiles)(tree, "/", filePath => {
+        if (!isTsxFile(filePath))
+            return;
+        if (isUnderNodeModules(filePath) || isUnderDist(filePath))
+            return;
+        const content = tree.read(filePath, "utf-8");
+        if (content === null)
+            return;
+        if (!content.includes(marker))
+            return;
+        const updated = callback(filePath, content);
+        if (updated !== null && updated !== undefined && updated !== content) {
+            tree.write(filePath, updated);
+            touched += 1;
+        }
+    });
+    return touched;
+};
+exports.visitTsxFiles = visitTsxFiles;
+/**
+ * Same as {@link visitTsxFiles} but also includes plain `.ts` files. Use this
+ * when the codemod also rewrites non-JSX files such as helpers or hooks.
+ */
+const visitTsFiles = (tree, marker, callback) => {
+    let touched = 0;
+    (0, devkit_1.visitNotIgnoredFiles)(tree, "/", filePath => {
+        if (!isTsFile(filePath))
+            return;
+        if (isUnderNodeModules(filePath) || isUnderDist(filePath))
+            return;
+        const content = tree.read(filePath, "utf-8");
+        if (content === null)
+            return;
+        if (!content.includes(marker))
+            return;
+        const updated = callback(filePath, content);
+        if (updated !== null && updated !== undefined && updated !== content) {
+            tree.write(filePath, updated);
+            touched += 1;
+        }
+    });
+    return touched;
+};
+exports.visitTsFiles = visitTsFiles;
+/**
+ * Mapping of imported component aliases to their original names for a given
+ * package. For `import { IconButton as Btn } from "@trackunit/react-components"`
+ * this returns `{ Btn: "IconButton" }`.
+ *
+ * Returns `null` when the file imports nothing from the package, which lets
+ * callers short-circuit before parsing JSX.
+ */
+const getImportedAliases = (sourceFile, packageName) => {
+    const result = {};
+    let found = false;
+    for (const stmt of sourceFile.statements) {
+        if (!ts.isImportDeclaration(stmt))
+            continue;
+        const moduleSpecifier = stmt.moduleSpecifier;
+        if (!ts.isStringLiteral(moduleSpecifier))
+            continue;
+        if (moduleSpecifier.text !== packageName)
+            continue;
+        const namedBindings = stmt.importClause?.namedBindings;
+        if (namedBindings === undefined || !ts.isNamedImports(namedBindings))
+            continue;
+        for (const element of namedBindings.elements) {
+            const localName = element.name.text;
+            const importedName = element.propertyName?.text ?? localName;
+            result[localName] = importedName;
+            found = true;
+        }
+    }
+    return found ? result : null;
+};
+exports.getImportedAliases = getImportedAliases;
+/**
+ * Returns the local alias used in this file for `originalName` when imported
+ * from `packageName`, or `null` if the component is not imported.
+ */
+const getLocalAliasFor = (sourceFile, packageName, originalName) => {
+    const aliases = (0, exports.getImportedAliases)(sourceFile, packageName);
+    if (aliases === null)
+        return null;
+    for (const [local, original] of Object.entries(aliases)) {
+        if (original === originalName)
+            return local;
+    }
+    return null;
+};
+exports.getLocalAliasFor = getLocalAliasFor;
+/**
+ * Finds every JSX element whose tag name resolves to one of `tagNames`
+ * (typically the local aliases returned by {@link getImportedAliases}).
+ *
+ * The result intentionally includes both opening and full elements so callers
+ * can manipulate attributes (via `openingElement`) or wrap/replace the whole
+ * element (via `element`).
+ */
+const findJsxElements = (sourceFile, tagNames) => {
+    const matches = [];
+    const tagSet = new Set(tagNames);
+    const visit = (node) => {
+        if (ts.isJsxSelfClosingElement(node)) {
+            if (ts.isIdentifier(node.tagName) && tagSet.has(node.tagName.text)) {
+                matches.push({ openingElement: node, element: node });
+            }
+        }
+        else if (ts.isJsxElement(node)) {
+            const opening = node.openingElement;
+            if (ts.isIdentifier(opening.tagName) && tagSet.has(opening.tagName.text)) {
+                matches.push({ openingElement: opening, element: node });
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return matches;
+};
+exports.findJsxElements = findJsxElements;
+/**
+ * Looks up a named JSX attribute on the opening element. Returns `null` when
+ * the attribute is missing or part of a spread attribute (which we cannot
+ * statically inspect).
+ */
+const findJsxAttribute = (openingElement, attributeName) => {
+    for (const attr of openingElement.attributes.properties) {
+        if (!ts.isJsxAttribute(attr))
+            continue;
+        if (!ts.isIdentifier(attr.name))
+            continue;
+        if (attr.name.text === attributeName)
+            return attr;
+    }
+    return null;
+};
+exports.findJsxAttribute = findJsxAttribute;
+/**
+ * `true` when the element forwards a spread expression such as `{...rest}`,
+ * which means we can't be sure which attributes are actually set.
+ */
+const hasSpreadAttribute = (openingElement) => {
+    return openingElement.attributes.properties.some(prop => ts.isJsxSpreadAttribute(prop));
+};
+exports.hasSpreadAttribute = hasSpreadAttribute;
+/**
+ * Parses the file as TSX so JSX is recognised. We do not need a full program
+ * here; tsquery's `ast` helper produces a script-kind source file which loses
+ * JSX context, so we go through `createSourceFile` directly.
+ */
+const parseTsx = (content, fileName = "file.tsx") => ts.createSourceFile(fileName, content, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+exports.parseTsx = parseTsx;
+/**
+ * Helper for codemods to log a one-line summary at the end of a run. Migration
+ * runners aggregate logs per migration, so this keeps output focused.
+ */
+const logSummary = (migrationName, touched, manualReviewNeeded) => {
+    if (touched === 0) {
+        devkit_1.logger.info(`  ${migrationName}: no files changed`);
+        return;
+    }
+    const reviewSuffix = manualReviewNeeded !== undefined && manualReviewNeeded > 0
+        ? ` (${manualReviewNeeded} location(s) need manual review)`
+        : "";
+    devkit_1.logger.info(`  ${migrationName}: updated ${touched} file(s)${reviewSuffix}`);
+};
+exports.logSummary = logSummary;
+/**
+ * Inserts an attribute string immediately after the tag name (so the new
+ * attribute appears first). Returns the resulting source content.
+ *
+ * The added attribute is rendered verbatim, so callers are responsible for
+ * including the leading space (e.g. ` title="Close"`).
+ */
+const insertAttributeIntoOpeningTag = (content, openingElement, attributeText) => {
+    const tagName = openingElement.tagName;
+    const insertPos = tagName.getEnd();
+    return content.slice(0, insertPos) + ` ${attributeText}` + content.slice(insertPos);
+};
+exports.insertAttributeIntoOpeningTag = insertAttributeIntoOpeningTag;
+//# sourceMappingURL=jsx-utils.js.map

package/migrations/utils/jsx-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-utils.js","sourceRoot":"","sources":["../../../../../../libs/react/components/migrations/utils/jsx-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { logger, type Tree, visitNotIgnoredFiles } from \"@nx/devkit\";\nimport { tsquery } from \"@phenomnomnominal/tsquery\";\nimport * as ts from \"typescript\";\n\nconst TSX_EXTENSIONS = [\".tsx\", \".jsx\"] as const;\nconst TS_EXTENSIONS = [\".ts\", \".tsx\", \".jsx\"] as const;\n\nconst isTsxFile = (filePath: string): boolean => TSX_EXTENSIONS.some(ext => filePath.endsWith(ext));\nconst isTsFile = (filePath: string): boolean => TS_EXTENSIONS.some(ext => filePath.endsWith(ext));\n\nconst isUnderNodeModules = (filePath: string): boolean =>\n  filePath.includes(\"/node_modules/\") || filePath.startsWith(\"node_modules/\");\n\nconst isUnderDist = (filePath: string): boolean =>\n  filePath.includes(\"/dist/\") || filePath.startsWith(\"dist/\") || filePath.includes(\"/.nx/\");\n\n/**\n * Visits every `.tsx`/`.jsx` file under the workspace root and invokes the\n * callback with the file path and its current contents. Files that don't\n * include the marker substring are skipped, which makes large workspaces\n * cheap to scan.\n */\nexport const visitTsxFiles = (\n  tree: Tree,\n  marker: string,\n  callback: (filePath: string, content: string) => string | null | undefined\n): number => {\n  let touched = 0;\n  visitNotIgnoredFiles(tree, \"/\", filePath => {\n    if (!isTsxFile(filePath)) return;\n    if (isUnderNodeModules(filePath) || isUnderDist(filePath)) return;\n    const content = tree.read(filePath, \"utf-8\");\n    if (content === null) return;\n    if (!content.includes(marker)) return;\n    const updated = callback(filePath, content);\n    if (updated !== null && updated !== undefined && updated !== content) {\n      tree.write(filePath, updated);\n      touched += 1;\n    }\n  });\n  return touched;\n};\n\n/**\n * Same as {@link visitTsxFiles} but also includes plain `.ts` files. Use this\n * when the codemod also rewrites non-JSX files such as helpers or hooks.\n */\nexport const visitTsFiles = (\n  tree: Tree,\n  marker: string,\n  callback: (filePath: string, content: string) => string | null | undefined\n): number => {\n  let touched = 0;\n  visitNotIgnoredFiles(tree, \"/\", filePath => {\n    if (!isTsFile(filePath)) return;\n    if (isUnderNodeModules(filePath) || isUnderDist(filePath)) return;\n    const content = tree.read(filePath, \"utf-8\");\n    if (content === null) return;\n    if (!content.includes(marker)) return;\n    const updated = callback(filePath, content);\n    if (updated !== null && updated !== undefined && updated !== content) {\n      tree.write(filePath, updated);\n      touched += 1;\n    }\n  });\n  return touched;\n};\n\n/**\n * Mapping of imported component aliases to their original names for a given\n * package. For `import { IconButton as Btn } from \"@trackunit/react-components\"`\n * this returns `{ Btn: \"IconButton\" }`.\n *\n * Returns `null` when the file imports nothing from the package, which lets\n * callers short-circuit before parsing JSX.\n */\nexport const getImportedAliases = (sourceFile: ts.SourceFile, packageName: string): Record<string, string> | null => {\n  const result: Record<string, string> = {};\n  let found = false;\n\n  for (const stmt of sourceFile.statements) {\n    if (!ts.isImportDeclaration(stmt)) continue;\n    const moduleSpecifier = stmt.moduleSpecifier;\n    if (!ts.isStringLiteral(moduleSpecifier)) continue;\n    if (moduleSpecifier.text !== packageName) continue;\n\n    const namedBindings = stmt.importClause?.namedBindings;\n    if (namedBindings === undefined || !ts.isNamedImports(namedBindings)) continue;\n\n    for (const element of namedBindings.elements) {\n      const localName = element.name.text;\n      const importedName = element.propertyName?.text ?? localName;\n      result[localName] = importedName;\n      found = true;\n    }\n  }\n\n  return found ? result : null;\n};\n\n/**\n * Returns the local alias used in this file for `originalName` when imported\n * from `packageName`, or `null` if the component is not imported.\n */\nexport const getLocalAliasFor = (\n  sourceFile: ts.SourceFile,\n  packageName: string,\n  originalName: string\n): string | null => {\n  const aliases = getImportedAliases(sourceFile, packageName);\n  if (aliases === null) return null;\n  for (const [local, original] of Object.entries(aliases)) {\n    if (original === originalName) return local;\n  }\n  return null;\n};\n\nexport type JsxElementMatch = {\n  /** The opening JSX element (the one carrying the attributes). */\n  openingElement: ts.JsxOpeningElement | ts.JsxSelfClosingElement;\n  /** The full element including children, or the self-closing element. */\n  element: ts.JsxElement | ts.JsxSelfClosingElement;\n};\n\n/**\n * Finds every JSX element whose tag name resolves to one of `tagNames`\n * (typically the local aliases returned by {@link getImportedAliases}).\n *\n * The result intentionally includes both opening and full elements so callers\n * can manipulate attributes (via `openingElement`) or wrap/replace the whole\n * element (via `element`).\n */\nexport const findJsxElements = (\n  sourceFile: ts.SourceFile,\n  tagNames: ReadonlyArray<string>\n): ReadonlyArray<JsxElementMatch> => {\n  const matches: Array<JsxElementMatch> = [];\n  const tagSet = new Set(tagNames);\n\n  const visit = (node: ts.Node): void => {\n    if (ts.isJsxSelfClosingElement(node)) {\n      if (ts.isIdentifier(node.tagName) && tagSet.has(node.tagName.text)) {\n        matches.push({ openingElement: node, element: node });\n      }\n    } else if (ts.isJsxElement(node)) {\n      const opening = node.openingElement;\n      if (ts.isIdentifier(opening.tagName) && tagSet.has(opening.tagName.text)) {\n        matches.push({ openingElement: opening, element: node });\n      }\n    }\n    ts.forEachChild(node, visit);\n  };\n\n  visit(sourceFile);\n  return matches;\n};\n\n/**\n * Looks up a named JSX attribute on the opening element. Returns `null` when\n * the attribute is missing or part of a spread attribute (which we cannot\n * statically inspect).\n */\nexport const findJsxAttribute = (\n  openingElement: ts.JsxOpeningElement | ts.JsxSelfClosingElement,\n  attributeName: string\n): ts.JsxAttribute | null => {\n  for (const attr of openingElement.attributes.properties) {\n    if (!ts.isJsxAttribute(attr)) continue;\n    if (!ts.isIdentifier(attr.name)) continue;\n    if (attr.name.text === attributeName) return attr;\n  }\n  return null;\n};\n\n/**\n * `true` when the element forwards a spread expression such as `{...rest}`,\n * which means we can't be sure which attributes are actually set.\n */\nexport const hasSpreadAttribute = (openingElement: ts.JsxOpeningElement | ts.JsxSelfClosingElement): boolean => {\n  return openingElement.attributes.properties.some(prop => ts.isJsxSpreadAttribute(prop));\n};\n\n/**\n * Parses the file as TSX so JSX is recognised. We do not need a full program\n * here; tsquery's `ast` helper produces a script-kind source file which loses\n * JSX context, so we go through `createSourceFile` directly.\n */\nexport const parseTsx = (content: string, fileName = \"file.tsx\"): ts.SourceFile =>\n  ts.createSourceFile(fileName, content, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);\n\n/** Re-exported for codemods that need direct AST queries. */\nexport { tsquery };\n\n/**\n * Helper for codemods to log a one-line summary at the end of a run. Migration\n * runners aggregate logs per migration, so this keeps output focused.\n */\nexport const logSummary = (migrationName: string, touched: number, manualReviewNeeded?: number): void => {\n  if (touched === 0) {\n    logger.info(`  ${migrationName}: no files changed`);\n    return;\n  }\n  const reviewSuffix =\n    manualReviewNeeded !== undefined && manualReviewNeeded > 0\n      ? ` (${manualReviewNeeded} location(s) need manual review)`\n      : \"\";\n  logger.info(`  ${migrationName}: updated ${touched} file(s)${reviewSuffix}`);\n};\n\n/**\n * Inserts an attribute string immediately after the tag name (so the new\n * attribute appears first). Returns the resulting source content.\n *\n * The added attribute is rendered verbatim, so callers are responsible for\n * including the leading space (e.g. ` title=\"Close\"`).\n */\nexport const insertAttributeIntoOpeningTag = (\n  content: string,\n  openingElement: ts.JsxOpeningElement | ts.JsxSelfClosingElement,\n  attributeText: string\n): string => {\n  const tagName = openingElement.tagName;\n  const insertPos = tagName.getEnd();\n  return content.slice(0, insertPos) + ` ${attributeText}` + content.slice(insertPos);\n};\n"]}

package/migrations/v2-0-0/breadcrumb-remove-deprecated-props.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.breadcrumbRemoveDeprecatedProps = void 0;
+const devkit_1 = require("@nx/devkit");
+const jsx_utils_1 = require("../utils/jsx-utils");
+const PACKAGE_NAME = "@trackunit/react-components";
+const COMPONENT_NAMES = ["Breadcrumb", "BreadcrumbContainer", "BreadcrumbForMediumScreen"];
+const PROPS_TO_REMOVE = ["backButtonTitle", "expandCollapsedItemsTitle"];
+const stripDeprecatedProps = (filePath, content) => {
+    const sourceFile = (0, jsx_utils_1.parseTsx)(content, filePath);
+    const aliases = (0, jsx_utils_1.getImportedAliases)(sourceFile, PACKAGE_NAME);
+    if (aliases === null)
+        return null;
+    const localTagNames = [];
+    for (const [local, original] of Object.entries(aliases)) {
+        if (COMPONENT_NAMES.some(name => name === original)) {
+            localTagNames.push(local);
+        }
+    }
+    if (localTagNames.length === 0)
+        return null;
+    const matches = (0, jsx_utils_1.findJsxElements)(sourceFile, localTagNames);
+    if (matches.length === 0)
+        return null;
+    // Collect every (start, end) range we want to delete. We process them in
+    // reverse so earlier offsets stay valid while we splice.
+    const ranges = [];
+    for (const { openingElement } of matches) {
+        for (const propName of PROPS_TO_REMOVE) {
+            const attr = (0, jsx_utils_1.findJsxAttribute)(openingElement, propName);
+            if (attr === null)
+                continue;
+            // Drop trailing whitespace + the attribute itself so we don't leave a
+            // dangling space inside the opening tag. e.g. `<X foo="a" bar="b" />`
+            // becomes `<X foo="a" />` and `<X bar="b" />` becomes `<X />`.
+            let start = attr.getFullStart();
+            const end = attr.getEnd();
+            // getFullStart includes leading whitespace which is what we want.
+            // Guard against negative ranges if multiple props collapse later.
+            if (start < 0)
+                start = attr.getStart();
+            ranges.push({ start, end });
+        }
+    }
+    if (ranges.length === 0)
+        return null;
+    ranges.sort((a, b) => b.start - a.start);
+    let updated = content;
+    for (const { start, end } of ranges) {
+        updated = updated.slice(0, start) + updated.slice(end);
+    }
+    return updated;
+};
+/**
+ * Removes the no-longer-supported `backButtonTitle` and
+ * `expandCollapsedItemsTitle` props from `<Breadcrumb>`,
+ * `<BreadcrumbContainer>`, and `<BreadcrumbForMediumScreen>`. Their accessible
+ * names are now sourced from the `react-components` library translations.
+ */
+const breadcrumbRemoveDeprecatedProps = (tree) => {
+    const touched = (0, jsx_utils_1.visitTsxFiles)(tree, "Breadcrumb", stripDeprecatedProps);
+    (0, jsx_utils_1.logSummary)("breadcrumb-remove-deprecated-props", touched);
+    devkit_1.logger.info("  Ensure the host application registers the @trackunit/react-components library translations so the back/expand buttons render localized labels.");
+};
+exports.breadcrumbRemoveDeprecatedProps = breadcrumbRemoveDeprecatedProps;
+exports.default = exports.breadcrumbRemoveDeprecatedProps;
+//# sourceMappingURL=breadcrumb-remove-deprecated-props.js.map

package/migrations/v2-0-0/breadcrumb-remove-deprecated-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb-remove-deprecated-props.js","sourceRoot":"","sources":["../../../../../../libs/react/components/migrations/v2-0-0/breadcrumb-remove-deprecated-props.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Tree, logger } from \"@nx/devkit\";\nimport {\n  findJsxAttribute,\n  findJsxElements,\n  getImportedAliases,\n  logSummary,\n  parseTsx,\n  visitTsxFiles,\n} from \"../utils/jsx-utils\";\n\nconst PACKAGE_NAME = \"@trackunit/react-components\";\nconst COMPONENT_NAMES = [\"Breadcrumb\", \"BreadcrumbContainer\", \"BreadcrumbForMediumScreen\"] as const;\nconst PROPS_TO_REMOVE = [\"backButtonTitle\", \"expandCollapsedItemsTitle\"] as const;\n\nconst stripDeprecatedProps = (filePath: string, content: string): string | null => {\n  const sourceFile = parseTsx(content, filePath);\n\n  const aliases = getImportedAliases(sourceFile, PACKAGE_NAME);\n  if (aliases === null) return null;\n\n  const localTagNames: Array<string> = [];\n  for (const [local, original] of Object.entries(aliases)) {\n    if (COMPONENT_NAMES.some(name => name === original)) {\n      localTagNames.push(local);\n    }\n  }\n  if (localTagNames.length === 0) return null;\n\n  const matches = findJsxElements(sourceFile, localTagNames);\n  if (matches.length === 0) return null;\n\n  // Collect every (start, end) range we want to delete. We process them in\n  // reverse so earlier offsets stay valid while we splice.\n  const ranges: Array<{ start: number; end: number }> = [];\n  for (const { openingElement } of matches) {\n    for (const propName of PROPS_TO_REMOVE) {\n      const attr = findJsxAttribute(openingElement, propName);\n      if (attr === null) continue;\n\n      // Drop trailing whitespace + the attribute itself so we don't leave a\n      // dangling space inside the opening tag. e.g. `<X foo=\"a\" bar=\"b\" />`\n      // becomes `<X foo=\"a\" />` and `<X bar=\"b\" />` becomes `<X />`.\n      let start = attr.getFullStart();\n      const end = attr.getEnd();\n      // getFullStart includes leading whitespace which is what we want.\n      // Guard against negative ranges if multiple props collapse later.\n      if (start < 0) start = attr.getStart();\n      ranges.push({ start, end });\n    }\n  }\n\n  if (ranges.length === 0) return null;\n\n  ranges.sort((a, b) => b.start - a.start);\n\n  let updated = content;\n  for (const { start, end } of ranges) {\n    updated = updated.slice(0, start) + updated.slice(end);\n  }\n\n  return updated;\n};\n\n/**\n * Removes the no-longer-supported `backButtonTitle` and\n * `expandCollapsedItemsTitle` props from `<Breadcrumb>`,\n * `<BreadcrumbContainer>`, and `<BreadcrumbForMediumScreen>`. Their accessible\n * names are now sourced from the `react-components` library translations.\n */\nexport const breadcrumbRemoveDeprecatedProps = (tree: Tree): void => {\n  const touched = visitTsxFiles(tree, \"Breadcrumb\", stripDeprecatedProps);\n  logSummary(\"breadcrumb-remove-deprecated-props\", touched);\n  logger.info(\n    \"  Ensure the host application registers the @trackunit/react-components library translations so the back/expand buttons render localized labels.\"\n  );\n};\n\nexport default breadcrumbRemoveDeprecatedProps;\n"]}

package/migrations/v2-0-0/cardheader-onclickclose-to-actions.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cardHeaderOnClickCloseToActions = void 0;
+const tslib_1 = require("tslib");
+const ts = tslib_1.__importStar(require("typescript"));
+const jsx_utils_1 = require("../utils/jsx-utils");
+const PACKAGE_NAME = "@trackunit/react-components";
+const COMPONENT_NAME = "CardHeader";
+const CLOSE_BUTTON_NAMES = ["IconButton", "Icon"];
+const renderCloseButton = (handlerExpr, iconAlias, iconButtonAlias) => `<${iconButtonAlias} icon={<${iconAlias} name="XMark" size="small" />} onClick={${handlerExpr}} title="Close" variant="ghost-neutral" />`;
+const ensureNamedImport = (content, packageName, namesToAdd) => {
+    const sourceFile = (0, jsx_utils_1.parseTsx)(content, "source.tsx");
+    const aliases = (0, jsx_utils_1.getImportedAliases)(sourceFile, packageName) ?? {};
+    const missing = namesToAdd.filter(name => !Object.values(aliases).includes(name));
+    if (missing.length === 0)
+        return content;
+    for (const stmt of sourceFile.statements) {
+        if (!ts.isImportDeclaration(stmt))
+            continue;
+        const moduleSpecifier = stmt.moduleSpecifier;
+        if (!ts.isStringLiteral(moduleSpecifier) || moduleSpecifier.text !== packageName)
+            continue;
+        const namedBindings = stmt.importClause?.namedBindings;
+        if (namedBindings === undefined || !ts.isNamedImports(namedBindings))
+            continue;
+        const elementsText = namedBindings.elements.map(el => el.getText()).join(", ");
+        const merged = [elementsText, ...missing].join(", ");
+        const before = content.slice(0, namedBindings.getStart());
+        const after = content.slice(namedBindings.getEnd());
+        return `${before}{ ${merged} }${after}`;
+    }
+    // No existing import from the package; add a fresh line near the top.
+    const importLine = `import { ${missing.join(", ")} } from "${packageName}";\n`;
+    return importLine + content;
+};
+const transformCardHeaderUsage = (filePath, content) => {
+    const sourceFile = (0, jsx_utils_1.parseTsx)(content, filePath);
+    const aliases = (0, jsx_utils_1.getImportedAliases)(sourceFile, PACKAGE_NAME);
+    if (aliases === null)
+        return null;
+    const cardHeaderAlias = Object.entries(aliases).find(([, name]) => name === COMPONENT_NAME)?.[0];
+    if (cardHeaderAlias === undefined)
+        return null;
+    const matches = (0, jsx_utils_1.findJsxElements)(sourceFile, [cardHeaderAlias]);
+    if (matches.length === 0)
+        return null;
+    const edits = [];
+    for (const { openingElement } of matches) {
+        const onClickCloseAttr = (0, jsx_utils_1.findJsxAttribute)(openingElement, "onClickClose");
+        if (onClickCloseAttr === null)
+            continue;
+        const initializer = onClickCloseAttr.initializer;
+        if (initializer === undefined)
+            continue;
+        let handlerExpr;
+        if (ts.isJsxExpression(initializer) && initializer.expression !== undefined) {
+            handlerExpr = initializer.expression.getText();
+        }
+        else if (ts.isStringLiteral(initializer)) {
+            handlerExpr = `"${initializer.text}"`;
+        }
+        else {
+            continue;
+        }
+        const actionsAttr = (0, jsx_utils_1.findJsxAttribute)(openingElement, "actions");
+        if (actionsAttr !== null) {
+            // Don't try to merge with an existing actions prop; flag and skip.
+            continue;
+        }
+        const replacement = `actions={${renderCloseButton(handlerExpr, "Icon", "IconButton")}}`;
+        edits.push({
+            start: onClickCloseAttr.getStart(),
+            end: onClickCloseAttr.getEnd(),
+            replacement,
+        });
+    }
+    if (edits.length === 0)
+        return null;
+    edits.sort((a, b) => b.start - a.start);
+    let updated = content;
+    for (const { start, end, replacement } of edits) {
+        updated = updated.slice(0, start) + replacement + updated.slice(end);
+    }
+    updated = ensureNamedImport(updated, PACKAGE_NAME, [...CLOSE_BUTTON_NAMES]);
+    return updated;
+};
+/**
+ * Replaces the removed `onClickClose` prop on `<CardHeader>` with the
+ * equivalent action rendered through the `actions` slot using `IconButton` +
+ * the `XMark` icon.
+ *
+ * Cards that already declared `actions` are skipped to avoid clobbering
+ * existing markup.
+ */
+const cardHeaderOnClickCloseToActions = (tree) => {
+    const touched = (0, jsx_utils_1.visitTsxFiles)(tree, "CardHeader", transformCardHeaderUsage);
+    (0, jsx_utils_1.logSummary)("cardheader-onclickclose-to-actions", touched);
+};
+exports.cardHeaderOnClickCloseToActions = cardHeaderOnClickCloseToActions;
+exports.default = exports.cardHeaderOnClickCloseToActions;
+//# sourceMappingURL=cardheader-onclickclose-to-actions.js.map

package/migrations/v2-0-0/cardheader-onclickclose-to-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardheader-onclickclose-to-actions.js","sourceRoot":"","sources":["../../../../../../libs/react/components/migrations/v2-0-0/cardheader-onclickclose-to-actions.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Tree } from \"@nx/devkit\";\nimport * as ts from \"typescript\";\nimport {\n  findJsxAttribute,\n  findJsxElements,\n  getImportedAliases,\n  logSummary,\n  parseTsx,\n  visitTsxFiles,\n} from \"../utils/jsx-utils\";\n\nconst PACKAGE_NAME = \"@trackunit/react-components\";\nconst COMPONENT_NAME = \"CardHeader\";\n\nconst CLOSE_BUTTON_NAMES = [\"IconButton\", \"Icon\"] as const;\n\nconst renderCloseButton = (handlerExpr: string, iconAlias: string, iconButtonAlias: string): string =>\n  `<${iconButtonAlias} icon={<${iconAlias} name=\"XMark\" size=\"small\" />} onClick={${handlerExpr}} title=\"Close\" variant=\"ghost-neutral\" />`;\n\nconst ensureNamedImport = (content: string, packageName: string, namesToAdd: ReadonlyArray<string>): string => {\n  const sourceFile = parseTsx(content, \"source.tsx\");\n  const aliases = getImportedAliases(sourceFile, packageName) ?? {};\n\n  const missing = namesToAdd.filter(name => !Object.values(aliases).includes(name));\n  if (missing.length === 0) return content;\n\n  for (const stmt of sourceFile.statements) {\n    if (!ts.isImportDeclaration(stmt)) continue;\n    const moduleSpecifier = stmt.moduleSpecifier;\n    if (!ts.isStringLiteral(moduleSpecifier) || moduleSpecifier.text !== packageName) continue;\n\n    const namedBindings = stmt.importClause?.namedBindings;\n    if (namedBindings === undefined || !ts.isNamedImports(namedBindings)) continue;\n\n    const elementsText = namedBindings.elements.map(el => el.getText()).join(\", \");\n    const merged = [elementsText, ...missing].join(\", \");\n    const before = content.slice(0, namedBindings.getStart());\n    const after = content.slice(namedBindings.getEnd());\n    return `${before}{ ${merged} }${after}`;\n  }\n\n  // No existing import from the package; add a fresh line near the top.\n  const importLine = `import { ${missing.join(\", \")} } from \"${packageName}\";\\n`;\n  return importLine + content;\n};\n\nconst transformCardHeaderUsage = (filePath: string, content: string): string | null => {\n  const sourceFile = parseTsx(content, filePath);\n\n  const aliases = getImportedAliases(sourceFile, PACKAGE_NAME);\n  if (aliases === null) return null;\n\n  const cardHeaderAlias = Object.entries(aliases).find(([, name]) => name === COMPONENT_NAME)?.[0];\n  if (cardHeaderAlias === undefined) return null;\n\n  const matches = findJsxElements(sourceFile, [cardHeaderAlias]);\n  if (matches.length === 0) return null;\n\n  type Edit = { start: number; end: number; replacement: string };\n  const edits: Array<Edit> = [];\n\n  for (const { openingElement } of matches) {\n    const onClickCloseAttr = findJsxAttribute(openingElement, \"onClickClose\");\n    if (onClickCloseAttr === null) continue;\n\n    const initializer = onClickCloseAttr.initializer;\n    if (initializer === undefined) continue;\n\n    let handlerExpr: string;\n    if (ts.isJsxExpression(initializer) && initializer.expression !== undefined) {\n      handlerExpr = initializer.expression.getText();\n    } else if (ts.isStringLiteral(initializer)) {\n      handlerExpr = `\"${initializer.text}\"`;\n    } else {\n      continue;\n    }\n\n    const actionsAttr = findJsxAttribute(openingElement, \"actions\");\n    if (actionsAttr !== null) {\n      // Don't try to merge with an existing actions prop; flag and skip.\n      continue;\n    }\n\n    const replacement = `actions={${renderCloseButton(handlerExpr, \"Icon\", \"IconButton\")}}`;\n    edits.push({\n      start: onClickCloseAttr.getStart(),\n      end: onClickCloseAttr.getEnd(),\n      replacement,\n    });\n  }\n\n  if (edits.length === 0) return null;\n\n  edits.sort((a, b) => b.start - a.start);\n\n  let updated = content;\n  for (const { start, end, replacement } of edits) {\n    updated = updated.slice(0, start) + replacement + updated.slice(end);\n  }\n\n  updated = ensureNamedImport(updated, PACKAGE_NAME, [...CLOSE_BUTTON_NAMES]);\n\n  return updated;\n};\n\n/**\n * Replaces the removed `onClickClose` prop on `<CardHeader>` with the\n * equivalent action rendered through the `actions` slot using `IconButton` +\n * the `XMark` icon.\n *\n * Cards that already declared `actions` are skipped to avoid clobbering\n * existing markup.\n */\nexport const cardHeaderOnClickCloseToActions = (tree: Tree): void => {\n  const touched = visitTsxFiles(tree, \"CardHeader\", transformCardHeaderUsage);\n  logSummary(\"cardheader-onclickclose-to-actions\", touched);\n};\n\nexport default cardHeaderOnClickCloseToActions;\n"]}

package/migrations/v2-0-0/iconbutton-add-required-name.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.iconButtonAddRequiredName = void 0;
+const devkit_1 = require("@nx/devkit");
+const jsx_utils_1 = require("../utils/jsx-utils");
+const PACKAGE_NAME = "@trackunit/react-components";
+const COMPONENT_NAME = "IconButton";
+const PLACEHOLDER_TITLE = "TODO Replace with localized button title";
+const transformIconButtonUsage = (filePath, content) => {
+    const sourceFile = (0, jsx_utils_1.parseTsx)(content, filePath);
+    const aliases = (0, jsx_utils_1.getImportedAliases)(sourceFile, PACKAGE_NAME);
+    if (aliases === null)
+        return null;
+    const localAlias = Object.entries(aliases).find(([, name]) => name === COMPONENT_NAME)?.[0];
+    if (localAlias === undefined)
+        return null;
+    const matches = (0, jsx_utils_1.findJsxElements)(sourceFile, [localAlias]);
+    if (matches.length === 0)
+        return null;
+    const edits = [];
+    for (const { openingElement } of matches) {
+        if ((0, jsx_utils_1.hasSpreadAttribute)(openingElement))
+            continue;
+        const hasTitle = (0, jsx_utils_1.findJsxAttribute)(openingElement, "title") !== null;
+        const hasAriaLabel = (0, jsx_utils_1.findJsxAttribute)(openingElement, "ariaLabel") !== null;
+        if (hasTitle || hasAriaLabel)
+            continue;
+        edits.push({
+            offset: openingElement.tagName.getEnd(),
+            text: ` title="${PLACEHOLDER_TITLE}"`,
+        });
+    }
+    if (edits.length === 0)
+        return null;
+    edits.sort((a, b) => (a.offset === b.offset ? 0 : b.offset - a.offset));
+    let updated = content;
+    for (const { offset, text } of edits) {
+        updated = updated.slice(0, offset) + text + updated.slice(offset);
+    }
+    return updated;
+};
+/**
+ * Adds a placeholder `title` to `<IconButton>` usages that don't already
+ * provide either `title` or `ariaLabel`. The new accessible name requirement
+ * means every icon button must carry one of these two props.
+ *
+ * Usages with a spread attribute (e.g. `<IconButton {...props} />`) are
+ * skipped because we cannot tell whether `title`/`ariaLabel` is forwarded.
+ */
+const iconButtonAddRequiredName = (tree) => {
+    const touched = (0, jsx_utils_1.visitTsxFiles)(tree, "IconButton", transformIconButtonUsage);
+    (0, jsx_utils_1.logSummary)("iconbutton-add-required-name", touched);
+    if (touched > 0) {
+        devkit_1.logger.info(`  Replace the placeholder "${PLACEHOLDER_TITLE}" titles with localized strings (or switch to ariaLabel where appropriate).`);
+    }
+};
+exports.iconButtonAddRequiredName = iconButtonAddRequiredName;
+exports.default = exports.iconButtonAddRequiredName;
+//# sourceMappingURL=iconbutton-add-required-name.js.map

package/migrations/v2-0-0/iconbutton-add-required-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconbutton-add-required-name.js","sourceRoot":"","sources":["../../../../../../libs/react/components/migrations/v2-0-0/iconbutton-add-required-name.ts"],"names":[],"mappings":";;;AAAA,uCAA+C;AAC/C,kDAQ4B;AAE5B,MAAM,YAAY,GAAG,6BAA6B,CAAC;AACnD,MAAM,cAAc,GAAG,YAAY,CAAC;AAEpC,MAAM,iBAAiB,GAAG,0CAA0C,CAAC;AAErE,MAAM,wBAAwB,GAAG,CAAC,QAAgB,EAAE,OAAe,EAAiB,EAAE;IACpF,MAAM,UAAU,GAAG,IAAA,oBAAQ,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAE/C,MAAM,OAAO,GAAG,IAAA,8BAAkB,EAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC7D,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5F,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAE1C,MAAM,OAAO,GAAG,IAAA,2BAAe,EAAC,UAAU,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAGtC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,KAAK,MAAM,EAAE,cAAc,EAAE,IAAI,OAAO,EAAE,CAAC;QACzC,IAAI,IAAA,8BAAkB,EAAC,cAAc,CAAC;YAAE,SAAS;QAEjD,MAAM,QAAQ,GAAG,IAAA,4BAAgB,EAAC,cAAc,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACpE,MAAM,YAAY,GAAG,IAAA,4BAAgB,EAAC,cAAc,EAAE,WAAW,CAAC,KAAK,IAAI,CAAC;QAC5E,IAAI,QAAQ,IAAI,YAAY;YAAE,SAAS;QAEvC,KAAK,CAAC,IAAI,CAAC;YACT,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE;YACvC,IAAI,EAAE,WAAW,iBAAiB,GAAG;SACtC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAExE,IAAI,OAAO,GAAG,OAAO,CAAC;IACtB,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;QACrC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;;;;;;GAOG;AACI,MAAM,yBAAyB,GAAG,CAAC,IAAU,EAAQ,EAAE;IAC5D,MAAM,OAAO,GAAG,IAAA,yBAAa,EAAC,IAAI,EAAE,YAAY,EAAE,wBAAwB,CAAC,CAAC;IAC5E,IAAA,sBAAU,EAAC,8BAA8B,EAAE,OAAO,CAAC,CAAC;IACpD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,eAAM,CAAC,IAAI,CACT,8BAA8B,iBAAiB,6EAA6E,CAC7H,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AARW,QAAA,yBAAyB,6BAQpC;AAEF,kBAAe,iCAAyB,CAAC","sourcesContent":["import { type Tree, logger } from \"@nx/devkit\";\nimport {\n  findJsxAttribute,\n  findJsxElements,\n  getImportedAliases,\n  hasSpreadAttribute,\n  logSummary,\n  parseTsx,\n  visitTsxFiles,\n} from \"../utils/jsx-utils\";\n\nconst PACKAGE_NAME = \"@trackunit/react-components\";\nconst COMPONENT_NAME = \"IconButton\";\n\nconst PLACEHOLDER_TITLE = \"TODO Replace with localized button title\";\n\nconst transformIconButtonUsage = (filePath: string, content: string): string | null => {\n  const sourceFile = parseTsx(content, filePath);\n\n  const aliases = getImportedAliases(sourceFile, PACKAGE_NAME);\n  if (aliases === null) return null;\n\n  const localAlias = Object.entries(aliases).find(([, name]) => name === COMPONENT_NAME)?.[0];\n  if (localAlias === undefined) return null;\n\n  const matches = findJsxElements(sourceFile, [localAlias]);\n  if (matches.length === 0) return null;\n\n  type Edit = { offset: number; text: string };\n  const edits: Array<Edit> = [];\n\n  for (const { openingElement } of matches) {\n    if (hasSpreadAttribute(openingElement)) continue;\n\n    const hasTitle = findJsxAttribute(openingElement, \"title\") !== null;\n    const hasAriaLabel = findJsxAttribute(openingElement, \"ariaLabel\") !== null;\n    if (hasTitle || hasAriaLabel) continue;\n\n    edits.push({\n      offset: openingElement.tagName.getEnd(),\n      text: ` title=\"${PLACEHOLDER_TITLE}\"`,\n    });\n  }\n\n  if (edits.length === 0) return null;\n\n  edits.sort((a, b) => (a.offset === b.offset ? 0 : b.offset - a.offset));\n\n  let updated = content;\n  for (const { offset, text } of edits) {\n    updated = updated.slice(0, offset) + text + updated.slice(offset);\n  }\n  return updated;\n};\n\n/**\n * Adds a placeholder `title` to `<IconButton>` usages that don't already\n * provide either `title` or `ariaLabel`. The new accessible name requirement\n * means every icon button must carry one of these two props.\n *\n * Usages with a spread attribute (e.g. `<IconButton {...props} />`) are\n * skipped because we cannot tell whether `title`/`ariaLabel` is forwarded.\n */\nexport const iconButtonAddRequiredName = (tree: Tree): void => {\n  const touched = visitTsxFiles(tree, \"IconButton\", transformIconButtonUsage);\n  logSummary(\"iconbutton-add-required-name\", touched);\n  if (touched > 0) {\n    logger.info(\n      `  Replace the placeholder \"${PLACEHOLDER_TITLE}\" titles with localized strings (or switch to ariaLabel where appropriate).`\n    );\n  }\n};\n\nexport default iconButtonAddRequiredName;\n"]}

package/migrations/v2-0-0/kpi-tooltiplabel-to-wrapper.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kpiTooltipLabelToWrapper = void 0;
+const tslib_1 = require("tslib");
+const ts = tslib_1.__importStar(require("typescript"));
+const jsx_utils_1 = require("../utils/jsx-utils");
+const PACKAGE_NAME = "@trackunit/react-components";
+const COMPONENT_NAME = "KPI";
+const ensureTooltipImport = (content) => {
+    const sourceFile = (0, jsx_utils_1.parseTsx)(content, "source.tsx");
+    const aliases = (0, jsx_utils_1.getImportedAliases)(sourceFile, PACKAGE_NAME);
+    if (aliases !== null && Object.values(aliases).includes("Tooltip"))
+        return content;
+    for (const stmt of sourceFile.statements) {
+        if (!ts.isImportDeclaration(stmt))
+            continue;
+        const moduleSpecifier = stmt.moduleSpecifier;
+        if (!ts.isStringLiteral(moduleSpecifier) || moduleSpecifier.text !== PACKAGE_NAME)
+            continue;
+        const namedBindings = stmt.importClause?.namedBindings;
+        if (namedBindings === undefined || !ts.isNamedImports(namedBindings))
+            continue;
+        const elementsText = namedBindings.elements.map(el => el.getText()).join(", ");
+        const merged = `${elementsText}, Tooltip`;
+        const before = content.slice(0, namedBindings.getStart());
+        const after = content.slice(namedBindings.getEnd());
+        return `${before}{ ${merged} }${after}`;
+    }
+    return `import { Tooltip } from "${PACKAGE_NAME}";\n${content}`;
+};
+const renderTooltipExpression = (label) => label;
+const transformKpiUsage = (filePath, content) => {
+    const sourceFile = (0, jsx_utils_1.parseTsx)(content, filePath);
+    const aliases = (0, jsx_utils_1.getImportedAliases)(sourceFile, PACKAGE_NAME);
+    if (aliases === null)
+        return null;
+    const localAlias = Object.entries(aliases).find(([, name]) => name === COMPONENT_NAME)?.[0];
+    if (localAlias === undefined)
+        return null;
+    const matches = (0, jsx_utils_1.findJsxElements)(sourceFile, [localAlias]);
+    if (matches.length === 0)
+        return null;
+    const edits = [];
+    for (const { openingElement, element } of matches) {
+        const tooltipLabelAttr = (0, jsx_utils_1.findJsxAttribute)(openingElement, "tooltipLabel");
+        if (tooltipLabelAttr === null)
+            continue;
+        const initializer = tooltipLabelAttr.initializer;
+        if (initializer === undefined)
+            continue;
+        let label;
+        if (ts.isStringLiteral(initializer)) {
+            label = `"${initializer.text}"`;
+        }
+        else if (ts.isJsxExpression(initializer) && initializer.expression !== undefined) {
+            label = `{${initializer.expression.getText()}}`;
+        }
+        else {
+            continue;
+        }
+        edits.push({
+            elementStart: element.getStart(),
+            elementEnd: element.getEnd(),
+            attrStart: tooltipLabelAttr.getFullStart(),
+            attrEnd: tooltipLabelAttr.getEnd(),
+            label,
+            elementText: content.slice(element.getStart(), element.getEnd()),
+        });
+    }
+    if (edits.length === 0)
+        return null;
+    edits.sort((a, b) => b.elementStart - a.elementStart);
+    let updated = content;
+    for (const edit of edits) {
+        // Remove the tooltipLabel attribute first (it's inside the element).
+        const elementWithoutAttr = edit.elementText.slice(0, edit.attrStart - edit.elementStart) +
+            edit.elementText.slice(edit.attrEnd - edit.elementStart);
+        const wrapped = `<Tooltip label=${renderTooltipExpression(edit.label)} placement="bottom">${elementWithoutAttr}</Tooltip>`;
+        updated = updated.slice(0, edit.elementStart) + wrapped + updated.slice(edit.elementEnd);
+    }
+    updated = ensureTooltipImport(updated);
+    return updated;
+};
+/**
+ * Replaces the removed `tooltipLabel` prop on `<KPI>` with an explicit
+ * `<Tooltip>` wrapper. The `KPICard` variant is intentionally not touched
+ * because it still owns its own `tooltipLabel` prop.
+ */
+const kpiTooltipLabelToWrapper = (tree) => {
+    const touched = (0, jsx_utils_1.visitTsxFiles)(tree, "tooltipLabel", transformKpiUsage);
+    (0, jsx_utils_1.logSummary)("kpi-tooltiplabel-to-wrapper", touched);
+};
+exports.kpiTooltipLabelToWrapper = kpiTooltipLabelToWrapper;
+exports.default = exports.kpiTooltipLabelToWrapper;
+//# sourceMappingURL=kpi-tooltiplabel-to-wrapper.js.map

package/migrations/v2-0-0/kpi-tooltiplabel-to-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kpi-tooltiplabel-to-wrapper.js","sourceRoot":"","sources":["../../../../../../libs/react/components/migrations/v2-0-0/kpi-tooltiplabel-to-wrapper.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Tree } from \"@nx/devkit\";\nimport * as ts from \"typescript\";\nimport {\n  findJsxAttribute,\n  findJsxElements,\n  getImportedAliases,\n  logSummary,\n  parseTsx,\n  visitTsxFiles,\n} from \"../utils/jsx-utils\";\n\nconst PACKAGE_NAME = \"@trackunit/react-components\";\nconst COMPONENT_NAME = \"KPI\";\n\nconst ensureTooltipImport = (content: string): string => {\n  const sourceFile = parseTsx(content, \"source.tsx\");\n  const aliases = getImportedAliases(sourceFile, PACKAGE_NAME);\n  if (aliases !== null && Object.values(aliases).includes(\"Tooltip\")) return content;\n\n  for (const stmt of sourceFile.statements) {\n    if (!ts.isImportDeclaration(stmt)) continue;\n    const moduleSpecifier = stmt.moduleSpecifier;\n    if (!ts.isStringLiteral(moduleSpecifier) || moduleSpecifier.text !== PACKAGE_NAME) continue;\n\n    const namedBindings = stmt.importClause?.namedBindings;\n    if (namedBindings === undefined || !ts.isNamedImports(namedBindings)) continue;\n\n    const elementsText = namedBindings.elements.map(el => el.getText()).join(\", \");\n    const merged = `${elementsText}, Tooltip`;\n    const before = content.slice(0, namedBindings.getStart());\n    const after = content.slice(namedBindings.getEnd());\n    return `${before}{ ${merged} }${after}`;\n  }\n\n  return `import { Tooltip } from \"${PACKAGE_NAME}\";\\n${content}`;\n};\n\nconst renderTooltipExpression = (label: string): string => label;\n\nconst transformKpiUsage = (filePath: string, content: string): string | null => {\n  const sourceFile = parseTsx(content, filePath);\n\n  const aliases = getImportedAliases(sourceFile, PACKAGE_NAME);\n  if (aliases === null) return null;\n\n  const localAlias = Object.entries(aliases).find(([, name]) => name === COMPONENT_NAME)?.[0];\n  if (localAlias === undefined) return null;\n\n  const matches = findJsxElements(sourceFile, [localAlias]);\n  if (matches.length === 0) return null;\n\n  type Edit = {\n    elementStart: number;\n    elementEnd: number;\n    attrStart: number;\n    attrEnd: number;\n    label: string;\n    elementText: string;\n  };\n  const edits: Array<Edit> = [];\n\n  for (const { openingElement, element } of matches) {\n    const tooltipLabelAttr = findJsxAttribute(openingElement, \"tooltipLabel\");\n    if (tooltipLabelAttr === null) continue;\n\n    const initializer = tooltipLabelAttr.initializer;\n    if (initializer === undefined) continue;\n\n    let label: string;\n    if (ts.isStringLiteral(initializer)) {\n      label = `\"${initializer.text}\"`;\n    } else if (ts.isJsxExpression(initializer) && initializer.expression !== undefined) {\n      label = `{${initializer.expression.getText()}}`;\n    } else {\n      continue;\n    }\n\n    edits.push({\n      elementStart: element.getStart(),\n      elementEnd: element.getEnd(),\n      attrStart: tooltipLabelAttr.getFullStart(),\n      attrEnd: tooltipLabelAttr.getEnd(),\n      label,\n      elementText: content.slice(element.getStart(), element.getEnd()),\n    });\n  }\n\n  if (edits.length === 0) return null;\n\n  edits.sort((a, b) => b.elementStart - a.elementStart);\n\n  let updated = content;\n  for (const edit of edits) {\n    // Remove the tooltipLabel attribute first (it's inside the element).\n    const elementWithoutAttr =\n      edit.elementText.slice(0, edit.attrStart - edit.elementStart) +\n      edit.elementText.slice(edit.attrEnd - edit.elementStart);\n    const wrapped = `<Tooltip label=${renderTooltipExpression(edit.label)} placement=\"bottom\">${elementWithoutAttr}</Tooltip>`;\n    updated = updated.slice(0, edit.elementStart) + wrapped + updated.slice(edit.elementEnd);\n  }\n\n  updated = ensureTooltipImport(updated);\n\n  return updated;\n};\n\n/**\n * Replaces the removed `tooltipLabel` prop on `<KPI>` with an explicit\n * `<Tooltip>` wrapper. The `KPICard` variant is intentionally not touched\n * because it still owns its own `tooltipLabel` prop.\n */\nexport const kpiTooltipLabelToWrapper = (tree: Tree): void => {\n  const touched = visitTsxFiles(tree, \"tooltipLabel\", transformKpiUsage);\n  logSummary(\"kpi-tooltiplabel-to-wrapper\", touched);\n};\n\nexport default kpiTooltipLabelToWrapper;\n"]}