@reapit/elements 5.0.0-beta.71 → 5.0.0-beta.72

package/bin/elements.cjs

@@ -35,11 +35,9 @@ For more information, visit: https://github.com/reapit/elements
 }
 
 function handleCodemod(codemodArgs) {
-  const child = spawn(
-    process.execPath,
-    ['--experimental-strip-types', '--no-warnings', join(__dirname, '..', 'codemods', 'bin.ts'), ...codemodArgs],
-    { stdio: 'inherit' },
-  )
+  const child = spawn(process.execPath, [join(__dirname, '..', 'dist', 'codemods', 'bin.js'), ...codemodArgs], {
+    stdio: 'inherit',
+  })
 
   child.on('exit', (code) => {
     process.exit(code ?? 0)

package/dist/codemods/at-a-glance-article-card/transform.d.ts

@@ -0,0 +1,4 @@
+export default function transform(source: string, filePath?: string, options?: {
+    facadePackage?: string;
+}): string;
+//# sourceMappingURL=transform.d.ts.map

package/dist/codemods/at-a-glance-article-card/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../codemods/at-a-glance-article-card/transform.ts"],"names":[],"mappings":"AA6QA,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAmB,EAC7B,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,MAAM,CAiBR"}

package/dist/codemods/at-a-glance-article-card/transform.js

@@ -0,0 +1,223 @@
+import { Project, SyntaxKind } from 'ts-morph';
+/**
+ * Checks if a module specifier matches a package name.
+ * Handles both exact matches and subpath imports.
+ * @example
+ * matchesPackage('@company/ui', '@company/ui') // true
+ * matchesPackage('@company/ui/elements', '@company/ui') // true
+ * matchesPackage('@company/ui-v2', '@company/ui') // false
+ */
+function matchesPackage(moduleSpecifier, packageName) {
+    return moduleSpecifier === packageName || moduleSpecifier.startsWith(packageName + '/');
+}
+/**
+ * Checks if a module specifier is an import from @reapit/elements or a facade package.
+ */
+function isElementsImport(moduleSpecifier, facadePackage) {
+    return (matchesPackage(moduleSpecifier, '@reapit/elements') ||
+        (facadePackage !== undefined && matchesPackage(moduleSpecifier, facadePackage)));
+}
+function getTagName(element) {
+    return element.getTagNameNode().getText();
+}
+function isNamespacedComponent(element, componentName) {
+    return getTagName(element) === `AtAGlance.${componentName}`;
+}
+function hasProp(element, propName) {
+    const attributes = element.getAttributes();
+    return attributes.some((attr) => {
+        if (attr.getKind() !== SyntaxKind.JsxAttribute) {
+            return false;
+        }
+        const jsxAttr = attr.asKindOrThrow(SyntaxKind.JsxAttribute);
+        const nameNode = jsxAttr.getNameNode();
+        return nameNode.getText() === propName;
+    });
+}
+function hasChildren(element) {
+    // Self-closing elements have no children
+    if (element.getKind() === SyntaxKind.JsxSelfClosingElement) {
+        return false;
+    }
+    // For opening elements, check the parent JsxElement's children
+    const parent = element.getParent();
+    if (parent?.getKind() === SyntaxKind.JsxElement) {
+        const jsxElement = parent.asKindOrThrow(SyntaxKind.JsxElement);
+        const children = jsxElement.getJsxChildren();
+        // Filter out whitespace-only text
+        return children.some((child) => {
+            if (child.getKind() === SyntaxKind.JsxText) {
+                return child.getText().trim().length > 0;
+            }
+            return true;
+        });
+    }
+    return false;
+}
+function isUsingOldApi(element) {
+    // New API uses subcomponents as children or grid prop
+    if (hasChildren(element) || hasProp(element, 'grid')) {
+        return false;
+    }
+    // Old API has displayValue or label props, or is completely empty (no props, no children)
+    // Empty cards should be migrated to ArticleCard (will cause TS errors, but that's expected)
+    return true;
+}
+function renameTagTo(element, newTagName) {
+    const tagNameNode = element.getTagNameNode();
+    tagNameNode.replaceWithText(newTagName);
+}
+function transformJsxElements(sourceFile, atAGlanceCardAliases) {
+    // Two-pass transformation approach:
+    // Pass 1: Transform namespaced components (AtAGlance.Card -> AtAGlance.ArticleCard)
+    // Pass 2: Transform direct imports (AtAGlanceCard -> AtAGlance.ArticleCard)
+    //
+    // We cannot do this in a single pass because mutating the AST while iterating
+    // over it can cause nodes to be invalidated or missed. By collecting all elements
+    // first, then mutating, we avoid iterator invalidation issues.
+    // Pass 1: Process namespaced AtAGlance.Card components
+    const selfClosingElements = sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement);
+    const openingElements = sourceFile.getDescendantsOfKind(SyntaxKind.JsxOpeningElement);
+    // Transform namespaced AtAGlance.Card to AtAGlance.ArticleCard when using old API
+    for (const element of [...selfClosingElements, ...openingElements]) {
+        if (isNamespacedComponent(element, 'Card') && isUsingOldApi(element)) {
+            renameTagTo(element, 'AtAGlance.ArticleCard');
+            // Also rename closing tag for non-self-closing elements
+            if (element.getKind() === SyntaxKind.JsxOpeningElement) {
+                const parent = element.getParent();
+                if (parent?.getKind() === SyntaxKind.JsxElement) {
+                    const jsxElement = parent.asKindOrThrow(SyntaxKind.JsxElement);
+                    const closingElement = jsxElement.getClosingElement();
+                    if (closingElement) {
+                        closingElement.getTagNameNode().replaceWithText('AtAGlance.ArticleCard');
+                    }
+                }
+            }
+        }
+    }
+    // Pass 2: Re-fetch elements after Pass 1 mutations, then transform direct imports
+    const selfClosingElements2 = sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement);
+    const openingElements2 = sourceFile.getDescendantsOfKind(SyntaxKind.JsxOpeningElement);
+    // Transform direct AtAGlanceCard (or its aliases) to AtAGlance.ArticleCard when using old API
+    for (const element of [...selfClosingElements2, ...openingElements2]) {
+        const tagName = getTagName(element);
+        if (atAGlanceCardAliases.has(tagName) && isUsingOldApi(element)) {
+            renameTagTo(element, 'AtAGlance.ArticleCard');
+            // Also rename closing tag for non-self-closing elements
+            if (element.getKind() === SyntaxKind.JsxOpeningElement) {
+                const parent = element.getParent();
+                if (parent?.getKind() === SyntaxKind.JsxElement) {
+                    const jsxElement = parent.asKindOrThrow(SyntaxKind.JsxElement);
+                    const closingElement = jsxElement.getClosingElement();
+                    if (closingElement) {
+                        closingElement.getTagNameNode().replaceWithText('AtAGlance.ArticleCard');
+                    }
+                }
+            }
+        }
+    }
+}
+function getAtAGlanceCardAliases(sourceFile, facadePackage) {
+    const aliases = new Set();
+    for (const importDecl of sourceFile.getImportDeclarations()) {
+        const moduleSpecifier = importDecl.getModuleSpecifierValue();
+        if (!isElementsImport(moduleSpecifier, facadePackage))
+            continue;
+        for (const namedImport of importDecl.getNamedImports()) {
+            if (namedImport.getName() === 'AtAGlanceCard') {
+                // Get the alias if it exists, otherwise use the original name
+                // Only add the alias (or original name) that's actually used in the file
+                const alias = namedImport.getAliasNode()?.getText();
+                aliases.add(alias ?? 'AtAGlanceCard');
+            }
+        }
+    }
+    // Add default only if file has NO imports at all (handles test snippets without imports)
+    if (aliases.size === 0 && sourceFile.getImportDeclarations().length === 0) {
+        aliases.add('AtAGlanceCard');
+    }
+    return aliases;
+}
+function isAtAGlanceCardStillUsed(sourceFile, aliases) {
+    const selfClosingElements = sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement);
+    const openingElements = sourceFile.getDescendantsOfKind(SyntaxKind.JsxOpeningElement);
+    return [...selfClosingElements, ...openingElements].some((element) => {
+        const tagName = getTagName(element);
+        return aliases.has(tagName);
+    });
+}
+function hasAtAGlanceImport(sourceFile, facadePackage) {
+    return sourceFile.getImportDeclarations().some((importDecl) => {
+        const moduleSpecifier = importDecl.getModuleSpecifierValue();
+        if (!isElementsImport(moduleSpecifier, facadePackage))
+            return false;
+        return importDecl.getNamedImports().some((namedImport) => namedImport.getName() === 'AtAGlance');
+    });
+}
+function usesAtAGlanceNamespace(sourceFile) {
+    const selfClosingElements = sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement);
+    const openingElements = sourceFile.getDescendantsOfKind(SyntaxKind.JsxOpeningElement);
+    return [...selfClosingElements, ...openingElements].some((element) => getTagName(element).startsWith('AtAGlance.'));
+}
+function updateImports(sourceFile, atAGlanceCardAliases, facadePackage) {
+    const importDeclarations = sourceFile.getImportDeclarations();
+    const atAGlanceCardStillUsed = isAtAGlanceCardStillUsed(sourceFile, atAGlanceCardAliases);
+    const needsAtAGlanceImport = usesAtAGlanceNamespace(sourceFile) && !hasAtAGlanceImport(sourceFile, facadePackage);
+    let importDeclWhereAtAGlanceCardWasRemoved = null;
+    // First pass: Remove AtAGlanceCard imports and track where it was removed
+    for (const importDecl of importDeclarations) {
+        const moduleSpecifier = importDecl.getModuleSpecifierValue();
+        if (!isElementsImport(moduleSpecifier, facadePackage))
+            continue;
+        if (!atAGlanceCardStillUsed) {
+            const namedImports = importDecl.getNamedImports();
+            for (const namedImport of namedImports) {
+                if (namedImport.getName() === 'AtAGlanceCard') {
+                    namedImport.remove();
+                    importDeclWhereAtAGlanceCardWasRemoved = importDecl;
+                }
+            }
+        }
+    }
+    // Second pass: Add AtAGlance import to the same declaration where AtAGlanceCard was removed
+    // Do this BEFORE removing empty imports to avoid accessing removed nodes
+    if (needsAtAGlanceImport && importDeclWhereAtAGlanceCardWasRemoved) {
+        importDeclWhereAtAGlanceCardWasRemoved.addNamedImport('AtAGlance');
+    }
+    else if (needsAtAGlanceImport) {
+        // If we didn't find where AtAGlanceCard was removed, add to first elements import
+        for (const importDecl of importDeclarations) {
+            const moduleSpecifier = importDecl.getModuleSpecifierValue();
+            if (isElementsImport(moduleSpecifier, facadePackage)) {
+                importDecl.addNamedImport('AtAGlance');
+                break;
+            }
+        }
+    }
+    // Third pass: Remove empty import declarations
+    for (const importDecl of importDeclarations) {
+        const moduleSpecifier = importDecl.getModuleSpecifierValue();
+        if (!isElementsImport(moduleSpecifier, facadePackage))
+            continue;
+        if (importDecl.getNamedImports().length === 0 &&
+            !importDecl.getDefaultImport() &&
+            !importDecl.getNamespaceImport()) {
+            importDecl.remove();
+        }
+    }
+}
+export default function transform(source, filePath = 'file.tsx', options) {
+    const project = new Project({
+        useInMemoryFileSystem: true,
+        compilerOptions: {
+            jsx: 2, // JsxEmit.React
+        },
+    });
+    const sourceFile = project.createSourceFile(filePath, source);
+    // Get aliases before transforming (e.g., import { AtAGlanceCard as Card })
+    const atAGlanceCardAliases = getAtAGlanceCardAliases(sourceFile, options?.facadePackage);
+    transformJsxElements(sourceFile, atAGlanceCardAliases);
+    updateImports(sourceFile, atAGlanceCardAliases, options?.facadePackage);
+    return sourceFile.getFullText();
+}
+//# sourceMappingURL=transform.js.map

package/dist/codemods/at-a-glance-article-card/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../codemods/at-a-glance-article-card/transform.ts"],"names":[],"mappings":"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","sourcesContent":["import { Project, SyntaxKind, JsxOpeningElement, JsxSelfClosingElement, SourceFile } from 'ts-morph'\n\n/**\n * Codemod to migrate AtAGlance.Card to the new AtAGlance.ArticleCard.\n *\n * The old AtAGlance.Card component accepted props like `displayValue`, `label`,\n * `description`, and `icon` directly. The new API separates concerns:\n *\n * - `AtAGlance.Card` is now a primitive for custom layouts using `grid` prop and\n *   subcomponents (Icon, Label, Description, Value)\n * - `AtAGlance.ArticleCard` is the new high-level component for static article cards\n *\n * Transformations:\n * - AtAGlance.Card (with displayValue/label props) -> AtAGlance.ArticleCard\n * - AtAGlanceCard (with displayValue/label props) -> AtAGlance.ArticleCard\n * - AtAGlance.Card (with children/grid) -> No change (already using new API)\n * - AtAGlanceCard (with children/grid) -> No change (already using new API)\n * - AtAGlance.AnchorCard / AtAGlanceAnchorCard -> No change (API unchanged)\n * - AtAGlance.ButtonCard / AtAGlanceButtonCard -> No change (API unchanged)\n */\n\ntype JsxElementWithTag = JsxOpeningElement | JsxSelfClosingElement\n\n/**\n * Checks if a module specifier matches a package name.\n * Handles both exact matches and subpath imports.\n * @example\n * matchesPackage('@company/ui', '@company/ui') // true\n * matchesPackage('@company/ui/elements', '@company/ui') // true\n * matchesPackage('@company/ui-v2', '@company/ui') // false\n */\nfunction matchesPackage(moduleSpecifier: string, packageName: string): boolean {\n  return moduleSpecifier === packageName || moduleSpecifier.startsWith(packageName + '/')\n}\n\n/**\n * Checks if a module specifier is an import from @reapit/elements or a facade package.\n */\nfunction isElementsImport(moduleSpecifier: string, facadePackage?: string): boolean {\n  return (\n    matchesPackage(moduleSpecifier, '@reapit/elements') ||\n    (facadePackage !== undefined && matchesPackage(moduleSpecifier, facadePackage))\n  )\n}\n\nfunction getTagName(element: JsxElementWithTag): string {\n  return element.getTagNameNode().getText()\n}\n\nfunction isNamespacedComponent(element: JsxElementWithTag, componentName: string): boolean {\n  return getTagName(element) === `AtAGlance.${componentName}`\n}\n\nfunction hasProp(element: JsxElementWithTag, propName: string): boolean {\n  const attributes = element.getAttributes()\n  return attributes.some((attr) => {\n    if (attr.getKind() !== SyntaxKind.JsxAttribute) {\n      return false\n    }\n    const jsxAttr = attr.asKindOrThrow(SyntaxKind.JsxAttribute)\n    const nameNode = jsxAttr.getNameNode()\n    return nameNode.getText() === propName\n  })\n}\n\nfunction hasChildren(element: JsxElementWithTag): boolean {\n  // Self-closing elements have no children\n  if (element.getKind() === SyntaxKind.JsxSelfClosingElement) {\n    return false\n  }\n\n  // For opening elements, check the parent JsxElement's children\n  const parent = element.getParent()\n  if (parent?.getKind() === SyntaxKind.JsxElement) {\n    const jsxElement = parent.asKindOrThrow(SyntaxKind.JsxElement)\n    const children = jsxElement.getJsxChildren()\n    // Filter out whitespace-only text\n    return children.some((child) => {\n      if (child.getKind() === SyntaxKind.JsxText) {\n        return child.getText().trim().length > 0\n      }\n      return true\n    })\n  }\n\n  return false\n}\n\nfunction isUsingOldApi(element: JsxElementWithTag): boolean {\n  // New API uses subcomponents as children or grid prop\n  if (hasChildren(element) || hasProp(element, 'grid')) {\n    return false\n  }\n  // Old API has displayValue or label props, or is completely empty (no props, no children)\n  // Empty cards should be migrated to ArticleCard (will cause TS errors, but that's expected)\n  return true\n}\n\nfunction renameTagTo(element: JsxElementWithTag, newTagName: string): void {\n  const tagNameNode = element.getTagNameNode()\n  tagNameNode.replaceWithText(newTagName)\n}\n\nfunction transformJsxElements(sourceFile: SourceFile, atAGlanceCardAliases: Set<string>): void {\n  // Two-pass transformation approach:\n  // Pass 1: Transform namespaced components (AtAGlance.Card -> AtAGlance.ArticleCard)\n  // Pass 2: Transform direct imports (AtAGlanceCard -> AtAGlance.ArticleCard)\n  //\n  // We cannot do this in a single pass because mutating the AST while iterating\n  // over it can cause nodes to be invalidated or missed. By collecting all elements\n  // first, then mutating, we avoid iterator invalidation issues.\n\n  // Pass 1: Process namespaced AtAGlance.Card components\n  const selfClosingElements = sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement)\n  const openingElements = sourceFile.getDescendantsOfKind(SyntaxKind.JsxOpeningElement)\n\n  // Transform namespaced AtAGlance.Card to AtAGlance.ArticleCard when using old API\n  for (const element of [...selfClosingElements, ...openingElements]) {\n    if (isNamespacedComponent(element, 'Card') && isUsingOldApi(element)) {\n      renameTagTo(element, 'AtAGlance.ArticleCard')\n\n      // Also rename closing tag for non-self-closing elements\n      if (element.getKind() === SyntaxKind.JsxOpeningElement) {\n        const parent = element.getParent()\n        if (parent?.getKind() === SyntaxKind.JsxElement) {\n          const jsxElement = parent.asKindOrThrow(SyntaxKind.JsxElement)\n          const closingElement = jsxElement.getClosingElement()\n          if (closingElement) {\n            closingElement.getTagNameNode().replaceWithText('AtAGlance.ArticleCard')\n          }\n        }\n      }\n    }\n  }\n\n  // Pass 2: Re-fetch elements after Pass 1 mutations, then transform direct imports\n  const selfClosingElements2 = sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement)\n  const openingElements2 = sourceFile.getDescendantsOfKind(SyntaxKind.JsxOpeningElement)\n\n  // Transform direct AtAGlanceCard (or its aliases) to AtAGlance.ArticleCard when using old API\n  for (const element of [...selfClosingElements2, ...openingElements2]) {\n    const tagName = getTagName(element)\n    if (atAGlanceCardAliases.has(tagName) && isUsingOldApi(element)) {\n      renameTagTo(element, 'AtAGlance.ArticleCard')\n\n      // Also rename closing tag for non-self-closing elements\n      if (element.getKind() === SyntaxKind.JsxOpeningElement) {\n        const parent = element.getParent()\n        if (parent?.getKind() === SyntaxKind.JsxElement) {\n          const jsxElement = parent.asKindOrThrow(SyntaxKind.JsxElement)\n          const closingElement = jsxElement.getClosingElement()\n          if (closingElement) {\n            closingElement.getTagNameNode().replaceWithText('AtAGlance.ArticleCard')\n          }\n        }\n      }\n    }\n  }\n}\n\nfunction getAtAGlanceCardAliases(sourceFile: SourceFile, facadePackage?: string): Set<string> {\n  const aliases = new Set<string>()\n\n  for (const importDecl of sourceFile.getImportDeclarations()) {\n    const moduleSpecifier = importDecl.getModuleSpecifierValue()\n\n    if (!isElementsImport(moduleSpecifier, facadePackage)) continue\n\n    for (const namedImport of importDecl.getNamedImports()) {\n      if (namedImport.getName() === 'AtAGlanceCard') {\n        // Get the alias if it exists, otherwise use the original name\n        // Only add the alias (or original name) that's actually used in the file\n        const alias = namedImport.getAliasNode()?.getText()\n        aliases.add(alias ?? 'AtAGlanceCard')\n      }\n    }\n  }\n\n  // Add default only if file has NO imports at all (handles test snippets without imports)\n  if (aliases.size === 0 && sourceFile.getImportDeclarations().length === 0) {\n    aliases.add('AtAGlanceCard')\n  }\n\n  return aliases\n}\n\nfunction isAtAGlanceCardStillUsed(sourceFile: SourceFile, aliases: Set<string>): boolean {\n  const selfClosingElements = sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement)\n  const openingElements = sourceFile.getDescendantsOfKind(SyntaxKind.JsxOpeningElement)\n\n  return [...selfClosingElements, ...openingElements].some((element) => {\n    const tagName = getTagName(element)\n    return aliases.has(tagName)\n  })\n}\n\nfunction hasAtAGlanceImport(sourceFile: SourceFile, facadePackage?: string): boolean {\n  return sourceFile.getImportDeclarations().some((importDecl) => {\n    const moduleSpecifier = importDecl.getModuleSpecifierValue()\n\n    if (!isElementsImport(moduleSpecifier, facadePackage)) return false\n\n    return importDecl.getNamedImports().some((namedImport) => namedImport.getName() === 'AtAGlance')\n  })\n}\n\nfunction usesAtAGlanceNamespace(sourceFile: SourceFile): boolean {\n  const selfClosingElements = sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement)\n  const openingElements = sourceFile.getDescendantsOfKind(SyntaxKind.JsxOpeningElement)\n\n  return [...selfClosingElements, ...openingElements].some((element) => getTagName(element).startsWith('AtAGlance.'))\n}\n\nfunction updateImports(sourceFile: SourceFile, atAGlanceCardAliases: Set<string>, facadePackage?: string): void {\n  const importDeclarations = sourceFile.getImportDeclarations()\n  const atAGlanceCardStillUsed = isAtAGlanceCardStillUsed(sourceFile, atAGlanceCardAliases)\n  const needsAtAGlanceImport = usesAtAGlanceNamespace(sourceFile) && !hasAtAGlanceImport(sourceFile, facadePackage)\n  let importDeclWhereAtAGlanceCardWasRemoved: (typeof importDeclarations)[0] | null = null\n\n  // First pass: Remove AtAGlanceCard imports and track where it was removed\n  for (const importDecl of importDeclarations) {\n    const moduleSpecifier = importDecl.getModuleSpecifierValue()\n\n    if (!isElementsImport(moduleSpecifier, facadePackage)) continue\n\n    if (!atAGlanceCardStillUsed) {\n      const namedImports = importDecl.getNamedImports()\n\n      for (const namedImport of namedImports) {\n        if (namedImport.getName() === 'AtAGlanceCard') {\n          namedImport.remove()\n          importDeclWhereAtAGlanceCardWasRemoved = importDecl\n        }\n      }\n    }\n  }\n\n  // Second pass: Add AtAGlance import to the same declaration where AtAGlanceCard was removed\n  // Do this BEFORE removing empty imports to avoid accessing removed nodes\n  if (needsAtAGlanceImport && importDeclWhereAtAGlanceCardWasRemoved) {\n    importDeclWhereAtAGlanceCardWasRemoved.addNamedImport('AtAGlance')\n  } else if (needsAtAGlanceImport) {\n    // If we didn't find where AtAGlanceCard was removed, add to first elements import\n    for (const importDecl of importDeclarations) {\n      const moduleSpecifier = importDecl.getModuleSpecifierValue()\n\n      if (isElementsImport(moduleSpecifier, facadePackage)) {\n        importDecl.addNamedImport('AtAGlance')\n        break\n      }\n    }\n  }\n\n  // Third pass: Remove empty import declarations\n  for (const importDecl of importDeclarations) {\n    const moduleSpecifier = importDecl.getModuleSpecifierValue()\n\n    if (!isElementsImport(moduleSpecifier, facadePackage)) continue\n\n    if (\n      importDecl.getNamedImports().length === 0 &&\n      !importDecl.getDefaultImport() &&\n      !importDecl.getNamespaceImport()\n    ) {\n      importDecl.remove()\n    }\n  }\n}\n\nexport default function transform(\n  source: string,\n  filePath: string = 'file.tsx',\n  options?: { facadePackage?: string },\n): string {\n  const project = new Project({\n    useInMemoryFileSystem: true,\n    compilerOptions: {\n      jsx: 2, // JsxEmit.React\n    },\n  })\n\n  const sourceFile = project.createSourceFile(filePath, source)\n\n  // Get aliases before transforming (e.g., import { AtAGlanceCard as Card })\n  const atAGlanceCardAliases = getAtAGlanceCardAliases(sourceFile, options?.facadePackage)\n\n  transformJsxElements(sourceFile, atAGlanceCardAliases)\n  updateImports(sourceFile, atAGlanceCardAliases, options?.facadePackage)\n\n  return sourceFile.getFullText()\n}\n"]}

package/dist/codemods/bin.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/codemods/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../codemods/bin.ts"],"names":[],"mappings":""}

package/dist/codemods/bin.js

@@ -0,0 +1,140 @@
+import { run } from './runner.js';
+import { listCodemods, getCodemodDescription, validateCodemodName } from './codemods.js';
+function printHelp() {
+    console.log(`
+Usage: yarn dlx @reapit/elements@beta codemod <command> [options]
+
+Commands:
+  list                    List available codemods
+  apply <name> <dir>      Apply a codemod to a directory
+
+Options:
+  --help, -h              Show this help message
+
+Examples:
+  yarn dlx @reapit/elements@beta codemod list
+  yarn dlx @reapit/elements@beta codemod apply at-a-glance-article-card src/
+  yarn dlx @reapit/elements@beta codemod apply at-a-glance-article-card src/ --dry-run
+`);
+}
+function printApplyHelp(codemodName) {
+    console.log(`
+Usage: yarn dlx @reapit/elements@beta codemod apply ${codemodName} <directory> [options]
+
+Arguments:
+  <directory>             Directory to search for files to transform
+
+Options:
+  --ext <extensions>      File extensions to process (default: .tsx,.ts,.jsx,.js)
+  --facade-package <pkg>  Package name that re-exports @reapit/elements
+  --dry-run, -d           Preview changes without writing files
+  --help, -h              Show this help message
+
+Examples:
+  yarn dlx @reapit/elements@beta codemod apply ${codemodName} src/
+  yarn dlx @reapit/elements@beta codemod apply ${codemodName} src/ --dry-run
+  yarn dlx @reapit/elements@beta codemod apply ${codemodName} src/ --ext .tsx,.jsx
+  yarn dlx @reapit/elements@beta codemod apply ${codemodName} src/ --facade-package @company/ui-components
+`);
+}
+function printList() {
+    const codemods = listCodemods();
+    if (codemods.length === 0) {
+        console.log('No codemods available.');
+        return;
+    }
+    console.log('\nAvailable codemods:\n');
+    // Calculate padding for alignment
+    const maxNameLength = Math.max(...codemods.map((name) => name.length));
+    for (const name of codemods) {
+        const description = getCodemodDescription(name);
+        const padding = ' '.repeat(maxNameLength - name.length + 4);
+        if (description) {
+            console.log(`  ${name}${padding}${description}`);
+        }
+        else {
+            console.log(`  ${name}`);
+        }
+    }
+    console.log();
+}
+function printAvailableCodemods() {
+    const codemods = listCodemods();
+    if (codemods.length === 0) {
+        console.log('No codemods available.');
+        return;
+    }
+    console.log('\nAvailable codemods:');
+    const maxNameLength = Math.max(...codemods.map((name) => name.length));
+    for (const name of codemods) {
+        const description = getCodemodDescription(name);
+        const padding = ' '.repeat(maxNameLength - name.length + 4);
+        if (description) {
+            console.log(`  ${name}${padding}${description}`);
+        }
+        else {
+            console.log(`  ${name}`);
+        }
+    }
+}
+async function handleApply(args) {
+    const codemodName = args[0];
+    if (!codemodName || codemodName.startsWith('-')) {
+        console.error('Error: No codemod name provided');
+        console.log('\nUsage: yarn dlx @reapit/elements@beta codemod apply <name> <directory> [options]');
+        console.log("\nRun 'yarn dlx @reapit/elements@beta codemod list' to see available codemods.");
+        process.exit(1);
+    }
+    // Security: Sanitize codemod name by validating it against the allowlist
+    // This prevents path traversal attacks in the dynamic import below
+    const sanitizedCodemodName = validateCodemodName(codemodName);
+    if (!sanitizedCodemodName) {
+        console.error(`Error: Unknown codemod '${codemodName}'`);
+        printAvailableCodemods();
+        process.exit(1);
+    }
+    const remainingArgs = args.slice(1);
+    // Handle help for specific codemod
+    if (remainingArgs.includes('--help') || remainingArgs.includes('-h')) {
+        printApplyHelp(sanitizedCodemodName);
+        process.exit(0);
+    }
+    // Load and run the codemod
+    const codemodModule = await import(`./${sanitizedCodemodName}/transform.js`);
+    const transform = codemodModule.default;
+    if (typeof transform !== 'function') {
+        console.error(`Error: Codemod '${codemodName}' does not export a default transform function`);
+        process.exit(1);
+    }
+    await run({
+        transform,
+        codemodName: sanitizedCodemodName,
+        args: remainingArgs,
+    });
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    // Handle no command or help
+    if (!command || command === '--help' || command === '-h') {
+        printHelp();
+        process.exit(0);
+    }
+    switch (command) {
+        case 'list':
+            printList();
+            break;
+        case 'apply':
+            await handleApply(args.slice(1));
+            break;
+        default:
+            console.error(`Error: Unknown command '${command}'`);
+            printHelp();
+            process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error('Error:', error.message);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/codemods/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../codemods/bin.ts"],"names":[],"mappings":"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","sourcesContent":["import { run } from './runner.js'\nimport { listCodemods, getCodemodDescription, validateCodemodName } from './codemods.js'\n\nfunction printHelp(): void {\n  console.log(`\nUsage: yarn dlx @reapit/elements@beta codemod <command> [options]\n\nCommands:\n  list                    List available codemods\n  apply <name> <dir>      Apply a codemod to a directory\n\nOptions:\n  --help, -h              Show this help message\n\nExamples:\n  yarn dlx @reapit/elements@beta codemod list\n  yarn dlx @reapit/elements@beta codemod apply at-a-glance-article-card src/\n  yarn dlx @reapit/elements@beta codemod apply at-a-glance-article-card src/ --dry-run\n`)\n}\n\nfunction printApplyHelp(codemodName: string): void {\n  console.log(`\nUsage: yarn dlx @reapit/elements@beta codemod apply ${codemodName} <directory> [options]\n\nArguments:\n  <directory>             Directory to search for files to transform\n\nOptions:\n  --ext <extensions>      File extensions to process (default: .tsx,.ts,.jsx,.js)\n  --facade-package <pkg>  Package name that re-exports @reapit/elements\n  --dry-run, -d           Preview changes without writing files\n  --help, -h              Show this help message\n\nExamples:\n  yarn dlx @reapit/elements@beta codemod apply ${codemodName} src/\n  yarn dlx @reapit/elements@beta codemod apply ${codemodName} src/ --dry-run\n  yarn dlx @reapit/elements@beta codemod apply ${codemodName} src/ --ext .tsx,.jsx\n  yarn dlx @reapit/elements@beta codemod apply ${codemodName} src/ --facade-package @company/ui-components\n`)\n}\n\nfunction printList(): void {\n  const codemods = listCodemods()\n\n  if (codemods.length === 0) {\n    console.log('No codemods available.')\n    return\n  }\n\n  console.log('\\nAvailable codemods:\\n')\n\n  // Calculate padding for alignment\n  const maxNameLength = Math.max(...codemods.map((name) => name.length))\n\n  for (const name of codemods) {\n    const description = getCodemodDescription(name)\n    const padding = ' '.repeat(maxNameLength - name.length + 4)\n    if (description) {\n      console.log(`  ${name}${padding}${description}`)\n    } else {\n      console.log(`  ${name}`)\n    }\n  }\n\n  console.log()\n}\n\nfunction printAvailableCodemods(): void {\n  const codemods = listCodemods()\n\n  if (codemods.length === 0) {\n    console.log('No codemods available.')\n    return\n  }\n\n  console.log('\\nAvailable codemods:')\n\n  const maxNameLength = Math.max(...codemods.map((name) => name.length))\n\n  for (const name of codemods) {\n    const description = getCodemodDescription(name)\n    const padding = ' '.repeat(maxNameLength - name.length + 4)\n    if (description) {\n      console.log(`  ${name}${padding}${description}`)\n    } else {\n      console.log(`  ${name}`)\n    }\n  }\n}\n\nasync function handleApply(args: string[]): Promise<void> {\n  const codemodName = args[0]\n\n  if (!codemodName || codemodName.startsWith('-')) {\n    console.error('Error: No codemod name provided')\n    console.log('\\nUsage: yarn dlx @reapit/elements@beta codemod apply <name> <directory> [options]')\n    console.log(\"\\nRun 'yarn dlx @reapit/elements@beta codemod list' to see available codemods.\")\n    process.exit(1)\n  }\n\n  // Security: Sanitize codemod name by validating it against the allowlist\n  // This prevents path traversal attacks in the dynamic import below\n  const sanitizedCodemodName = validateCodemodName(codemodName)\n\n  if (!sanitizedCodemodName) {\n    console.error(`Error: Unknown codemod '${codemodName}'`)\n    printAvailableCodemods()\n    process.exit(1)\n  }\n\n  const remainingArgs = args.slice(1)\n\n  // Handle help for specific codemod\n  if (remainingArgs.includes('--help') || remainingArgs.includes('-h')) {\n    printApplyHelp(sanitizedCodemodName)\n    process.exit(0)\n  }\n\n  // Load and run the codemod\n  const codemodModule = await import(`./${sanitizedCodemodName}/transform.js`)\n  const transform = codemodModule.default\n\n  if (typeof transform !== 'function') {\n    console.error(`Error: Codemod '${codemodName}' does not export a default transform function`)\n    process.exit(1)\n  }\n\n  await run({\n    transform,\n    codemodName: sanitizedCodemodName,\n    args: remainingArgs,\n  })\n}\n\nasync function main(): Promise<void> {\n  const args = process.argv.slice(2)\n  const command = args[0]\n\n  // Handle no command or help\n  if (!command || command === '--help' || command === '-h') {\n    printHelp()\n    process.exit(0)\n  }\n\n  switch (command) {\n    case 'list':\n      printList()\n      break\n\n    case 'apply':\n      await handleApply(args.slice(1))\n      break\n\n    default:\n      console.error(`Error: Unknown command '${command}'`)\n      printHelp()\n      process.exit(1)\n  }\n}\n\nmain().catch((error: Error) => {\n  console.error('Error:', error.message)\n  process.exit(1)\n})\n"]}

package/dist/codemods/codemods.d.ts

@@ -0,0 +1,29 @@
+export interface CodemodMetadata {
+    readonly name: string;
+    readonly description: string | null;
+}
+export declare const AVAILABLE_CODEMODS: readonly CodemodMetadata[];
+export declare const CODEMOD_NAMES: readonly string[];
+export type CodemodName = (typeof CODEMOD_NAMES)[number];
+/**
+ * Returns available codemods from the generated manifest.
+ *
+ * @returns Array of codemod names
+ */
+export declare function listCodemods(): string[];
+/**
+ * Retrieves the description from the manifest for a specific codemod.
+ *
+ * @param name - The codemod name
+ * @returns The description, or null if not found
+ */
+export declare function getCodemodDescription(name: string): string | null;
+/**
+ * Validates that a codemod exists in the manifest.
+ * Returns the sanitized name to prevent path traversal attacks.
+ *
+ * @param name - The codemod name to validate
+ * @returns The sanitized codemod name, or null if invalid
+ */
+export declare function validateCodemodName(name: string): CodemodName | null;
+//# sourceMappingURL=codemods.d.ts.map

package/dist/codemods/codemods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemods.d.ts","sourceRoot":"","sources":["../../codemods/codemods.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC;AAMD,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EAAoC,CAAA;AAC7F,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAAuD,CAAA;AAClG,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGjE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAEpE"}

package/dist/codemods/codemods.js

@@ -0,0 +1,32 @@
+import manifest from './manifest.json' with { type: 'json' };
+export const AVAILABLE_CODEMODS = manifest.codemods;
+export const CODEMOD_NAMES = manifest.codemods.map((c) => c.name);
+/**
+ * Returns available codemods from the generated manifest.
+ *
+ * @returns Array of codemod names
+ */
+export function listCodemods() {
+    return CODEMOD_NAMES.slice(); // Return copy to prevent mutation
+}
+/**
+ * Retrieves the description from the manifest for a specific codemod.
+ *
+ * @param name - The codemod name
+ * @returns The description, or null if not found
+ */
+export function getCodemodDescription(name) {
+    const metadata = AVAILABLE_CODEMODS.find((c) => c.name === name);
+    return metadata?.description ?? null;
+}
+/**
+ * Validates that a codemod exists in the manifest.
+ * Returns the sanitized name to prevent path traversal attacks.
+ *
+ * @param name - The codemod name to validate
+ * @returns The sanitized codemod name, or null if invalid
+ */
+export function validateCodemodName(name) {
+    return CODEMOD_NAMES.includes(name) ? name : null;
+}
+//# sourceMappingURL=codemods.js.map

package/dist/codemods/codemods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemods.js","sourceRoot":"","sources":["../../codemods/codemods.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAY5D,MAAM,CAAC,MAAM,kBAAkB,GAAgC,QAAqB,CAAC,QAAQ,CAAA;AAC7F,MAAM,CAAC,MAAM,aAAa,GAAuB,QAAqB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AAGlG;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,aAAa,CAAC,KAAK,EAAE,CAAA,CAAC,kCAAkC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;IAChE,OAAO,QAAQ,EAAE,WAAW,IAAI,IAAI,CAAA;AACtC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,aAAa,CAAC,QAAQ,CAAC,IAAmB,CAAC,CAAC,CAAC,CAAE,IAAoB,CAAC,CAAC,CAAC,IAAI,CAAA;AACnF,CAAC","sourcesContent":["import manifest from './manifest.json' with { type: 'json' }\n\n// Type definitions for the manifest\nexport interface CodemodMetadata {\n  readonly name: string\n  readonly description: string | null\n}\n\ninterface Manifest {\n  codemods: CodemodMetadata[]\n}\n\nexport const AVAILABLE_CODEMODS: readonly CodemodMetadata[] = (manifest as Manifest).codemods\nexport const CODEMOD_NAMES: readonly string[] = (manifest as Manifest).codemods.map((c) => c.name)\nexport type CodemodName = (typeof CODEMOD_NAMES)[number]\n\n/**\n * Returns available codemods from the generated manifest.\n *\n * @returns Array of codemod names\n */\nexport function listCodemods(): string[] {\n  return CODEMOD_NAMES.slice() // Return copy to prevent mutation\n}\n\n/**\n * Retrieves the description from the manifest for a specific codemod.\n *\n * @param name - The codemod name\n * @returns The description, or null if not found\n */\nexport function getCodemodDescription(name: string): string | null {\n  const metadata = AVAILABLE_CODEMODS.find((c) => c.name === name)\n  return metadata?.description ?? null\n}\n\n/**\n * Validates that a codemod exists in the manifest.\n * Returns the sanitized name to prevent path traversal attacks.\n *\n * @param name - The codemod name to validate\n * @returns The sanitized codemod name, or null if invalid\n */\nexport function validateCodemodName(name: string): CodemodName | null {\n  return CODEMOD_NAMES.includes(name as CodemodName) ? (name as CodemodName) : null\n}\n"]}

package/{codemods → dist/codemods}/manifest.json

@@ -1,6 +1,6 @@
 {
   "$schema": "./manifest.schema.json",
-  "generated": "2026-02-03T07:20:40.780Z",
+  "generated": "2026-02-10T04:40:51.016Z",
   "codemods": [
     {
       "name": "at-a-glance-article-card",

package/dist/codemods/runner.d.ts

@@ -0,0 +1,21 @@
+export type Transform = (source: string, filePath: string, options?: {
+    facadePackage?: string;
+}) => string;
+export interface RunOptions {
+    transform: Transform;
+    codemodName: string;
+    args: string[];
+}
+/**
+ * Recursively finds files matching the given patterns within a directory.
+ * Includes path traversal protection via isPathSafe validation.
+ *
+ * @param dir - The directory to search
+ * @param patterns - File patterns to match (e.g., ["*.ts", "*.tsx"])
+ * @param results - Accumulator for matching file paths
+ * @returns Array of absolute paths to matching files
+ */
+export declare function findFiles(dir: string, patterns: string[], results?: string[]): string[];
+export declare function matchesPatterns(filename: string, patterns: string[]): boolean;
+export declare function run({ transform, codemodName, args }: RunOptions): Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/codemods/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../codemods/runner.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,MAAM,CAAA;AAE1G,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,SAAS,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AA2BD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAyB3F;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAyB7E;AAuBD,wBAAsB,GAAG,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA2ErF"}