Reexport management example (#41)

* .

* .

* .

* .

* .

* .

* .

* .

* .

* .

* .

* .

* .

* .

* .

* .

* .

* .

* Automated pre-commit update

---------

Co-authored-by: kopekC <28070492+kopekC@users.noreply.github.com>

Author: kopekC

examples/reexport_management/README.md

@@ -0,0 +1,109 @@
+# Transform Module Re-exports Organization
+
+This example demonstrates how to use Codegen to automatically analyze and reorganize TypeScript module re-exports through shared directories. The script makes this process simple by handling all the tedious manual updates automatically.
+
+> [!NOTE]
+> This codemod helps maintain clean module boundaries and improves code organization by centralizing shared exports.
+
+## How the Migration Script Works
+
+The script automates the entire reorganization process in a few key steps:
+
+1. **Export Analysis**
+   ```python
+   for export_stmt in file.export_statements:
+       for export in export_stmt.exports:
+           if export.is_reexport() and not export.is_external_export:
+               all_reexports.append(export)
+   ```
+   - Automatically identifies re-exports in shared directories
+   - Analyzes export patterns and dependencies
+   - Uses Codegen's intelligent code analysis engine
+
+2. **Shared File Management**
+   ```python
+   resolved_public_file = export.resolved_symbol.filepath.replace("src/", "src/shared/")
+   if not codebase.has_file(resolved_public_file):
+       target_file = codebase.create_file(resolved_public_file, sync=True)
+   ```
+   - Creates or updates shared export files
+   - Maintains proper file structure
+   - Handles path resolution automatically
+
+3. **Import Updates**
+   ```python
+   # Updates imports to use new shared paths
+   new_path = usage.file.ts_config.translate_import_path(resolved_public_file)
+   new_import = f'import {{ {name} }} from "{new_path}"'
+   ```
+   - Updates all import statements to use new paths
+   - Maintains proper TypeScript path resolution
+   - Handles different import types (normal, type)
+
+## Why This Makes Organization Easy
+
+1. **Zero Manual Updates**
+   - Codegen SDK handles all file creation and updates
+   - No tedious export management
+
+2. **Consistent Structure**
+   - Ensures all shared exports follow the same pattern
+   - Maintains clean module boundaries
+
+3. **Safe Transformations**
+   - Validates changes before applying them
+   - Preserves existing functionality
+
+## Common Re-export Patterns
+
+### Module to Shared Exports
+```typescript
+// Before: Direct module import
+import { validateEmail } from '../module_a/src/functions';
+
+// After: Import through shared
+import { validateEmail } from '../module_a/src/shared';
+```
+
+### Export Consolidation
+```typescript
+// Before: Multiple export files
+export { foo } from './foo';
+export { bar } from './bar';
+
+// After: Consolidated in shared
+export * from '../functions';
+```
+
+## Key Benefits to Note
+
+1. **Better Module Boundaries**
+   - Clear public API for each module
+   - Centralized shared functionality
+
+2. **Improved Maintainability**
+   - Easier to track dependencies
+   - Simplified import paths
+
+3. **Code Organization**
+   - Consistent export structure
+   - Reduced import complexity
+
+
+The script will:
+1. 🎯 Start the reexport organization
+2. 📁 Analyze shared directories
+3. 🔄 Process and update exports
+4. ✨ Create shared export files
+5. 🧹 Clean up redundant exports
+
+## Learn More
+
+- [TypeScript Modules](https://www.typescriptlang.org/docs/handbook/modules.html)
+- [Export/Import Documentation](https://www.typescriptlang.org/docs/handbook/modules.html#export)
+- [Codegen Documentation](https://docs.codegen.com)
+- [Tutorial on Analyzing and Organizing Re-exports](https://docs.codegen.com/tutorials/managing-typescript-exports)
+- [More on exports ](https://docs.codegen.com/building-with-codegen/exports)
+## Contributing
+
+Feel free to submit issues and enhancement requests! 

examples/reexport_management/input_repo/modules/module_a/src/functions.ts

@@ -0,0 +1,20 @@
+export const calculateSum = (a: number, b: number): number => {
+    return a + b;
+};
+
+export const formatName = (firstName: string, lastName: string): string => {
+    return `${firstName} ${lastName}`;
+};
+
+export const generateId = (): string => {
+    return Math.random().toString(36).substring(7);
+};
+
+export const validateEmail = (email: string): boolean => {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email);
+};
+
+export const capitalize = (str: string): string => {
+    return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+};

examples/reexport_management/input_repo/modules/module_a/src/shared/index.ts

@@ -0,0 +1,3 @@
+export { calculateSum, formatName, capitalize } from '../module_a/src/functions';
+export { validateEmail } from '../module_c/src/shared/symbols/exports';
+

examples/reexport_management/input_repo/modules/module_b/imports.ts

@@ -0,0 +1,24 @@
+import { calculateSum, formatName, capitalize, validateEmail } from './shared/exports';
+
+export const calculateAverage = (numbers: number[]): number => {
+    const sum = numbers.reduce((acc, curr) => calculateSum(acc, curr), 0);
+    return sum / numbers.length;
+};
+
+export const createUserProfile = (firstName: string, lastName: string): string => {
+    const formattedName = formatName(firstName, lastName);
+    return `Profile: ${formattedName}`;
+};
+
+export const formatText = (text: string): string => {
+    return text.split(' ').map(capitalize).join(' ');
+};
+
+export const multiply = (a: number, b: number): number => {
+    return a * b;
+};
+
+export const generateGreeting = (name: string): string => {
+    const email = validateEmail(name);
+    return `Hello, ${capitalize(name)}!`;
+};

examples/reexport_management/input_repo/modules/module_b/src/functions.ts

@@ -0,0 +1,2 @@
+export { calculateSum, formatName, capitalize } from "../../imports";
+export {validateEmail} from "../../imports"

examples/reexport_management/input_repo/modules/module_b/src/shared/exports.ts

@@ -0,0 +1,3 @@
+export { validateEmail, generateId } from '../module_a/src/functions';
+export { calculateAverage, multiply, createUserProfile } from '../module_b/src/functions';
+

examples/reexport_management/input_repo/modules/module_c/imports.ts

@@ -0,0 +1,39 @@
+import { validateEmail, generateId, calculateAverage, multiply, createUserProfile } from './shared/symbols/exports';
+
+export const createUser = (email: string, firstName: string, lastName: string) => {
+    if (!validateEmail(email)) {
+        throw new Error('Invalid email');
+    }
+    
+    return {
+        id: generateId(),
+        profile: createUserProfile(firstName, lastName),
+        email
+    };
+};
+
+export const calculateMetrics = (values: number[]): { average: number; scaled: number[] } => {
+    const avg = calculateAverage(values);
+    const scaled = values.map(v => multiply(v, 2));
+    return { average: avg, scaled };
+};
+
+export const validateAndFormatUser = (email: string, firstName: string, lastName: string) => {
+    if (!validateEmail(email)) {
+        return { success: false, message: 'Invalid email' };
+    }
+    
+    const profile = createUserProfile(firstName, lastName);
+    return { success: true, profile };
+};
+
+export const processNumbers = (numbers: number[]): number => {
+    const { average } = calculateMetrics(numbers);
+    return multiply(average, 100);
+};
+
+export const generateReport = (userData: { email: string; name: string }): string => {
+    const isValidEmail = validateEmail(userData.email);
+    const id = generateId();
+    return `Report ${id}: Email ${isValidEmail ? 'valid' : 'invalid'} - ${userData.name}`;
+};

examples/reexport_management/input_repo/modules/module_c/src/functions.ts

@@ -0,0 +1,2 @@
+export { validateEmail, generateId } from '../../../imports'
+export { calculateAverage, multiply, createUserProfile } from '../../../imports'

examples/reexport_management/input_repo/modules/module_c/src/shared/symbols/exports.ts

@@ -0,0 +1,15 @@
+{
+  "name": "default-exports-test",
+  "version": "1.0.0",
+  "description": "Test codebase for converting default exports",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}