angular-v20-bulk-file-refactor 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Esther White
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# Angular v20 File Refactor
+
+A CLI tool to automate file renaming and content refactoring for Angular 20 projects. This tool updates file names and TypeScript file contents to align with Angular 20 conventions, handling patterns like `.component`, `.service`, `.directive`, and `.model`.
+
+## Installation
+
+### Global Installation
+Install the tool globally to use it from any directory:
+
+```bash
+npm install -g angular-v20-bulk-file-refactor
+```
+
+Run the tool directly:
+
+```bash
+angular-v20-bulk-file-refactor /path/to/your/angular/project
+```
+
+### Local Installation
+Install the tool locally within a project:
+
+```bash
+npm install angular-v20-bulk-file-refactor
+```
+
+Run the tool using `npx`:
+
+```bash
+npx angular-v20-bulk-file-refactor /path/to/your/angular/project
+```
+
+Alternatively, add a script to your `package.json`:
+
+```json
+{
+  "scripts": {
+    "refactor": "angular-v20-bulk-file-refactor"
+  }
+}
+```
+
+Then run:
+
+```bash
+npm run refactor -- /path/to/your/angular/project
+```
+
+## Usage
+
+Run the tool on your Angular project by specifying the project folder path. Use the global command or `npx` depending on your installation method.
+
+### Options
+
+- `--skip-dirs <dirs>`: Comma-separated list of directories to skip during processing.  
+  **Default**: `models,partials`  
+  **Example**: `--skip-dirs models,tests` skips the `models` and `tests` directories.
+
+- `--replace-file-name-segments <segments>`: Comma-separated list of file name segments to replace with a hyphenated version (e.g., `.service` becomes `-service` in the `services` folder).  
+  **Default**: `services,directives`  
+  **Example**: `--replace-file-name-segments services,pipes` replaces `.service` with `-service` in the `services` folder.
+
+- `--remove-file-name-segments <segments>`: Comma-separated list of file name segments to remove (e.g., `.model` is removed from file names in the `models` folder).  
+  **Default**: `models`  
+  **Example**: `--remove-file-name-segments models,utils` removes `.model` from file names in the `models` folder.
+
+- `--replace-import-segments <segments>`: Comma-separated list of import segments to replace (e.g., `.service` becomes `-service` in import statements).  
+  **Default**: `.service`  
+  **Example**: `--replace-import-segments .service` replaces `.service` with `-service` in imports.
+
+- `--remove-import-segments <segments>`: Comma-separated list of import segments to remove from import statements.  
+  **Default**: `.component,.directive,.model`  
+  **Example**: `--remove-import-segments .component,.directive` removes these segments from imports.
+
+### Example
+
+Run the tool on a specific Angular project folder with custom options:
+
+```bash
+# Global installation
+angular-v20-bulk-file-refactor D:\\Estee\\Programming\\My-Projects\\angular-app\\src\\app --skip-dirs models,tests --replace-file-name-segments services,pipes --remove-file-name-segments models,utils
+
+# Local installation with default options
+npx angular-v20-bulk-file-refactor D:\\Estee\\Programming\\My-Projects\\angular-app\\src\\app --skip-dirs models,partials --replace-file-name-segments services,directives --remove-file-name-segments models --replace-import-segments .service --remove-import-segments .component,.directive,.model
+
+# Local installation with custom options
+npx angular-v20-bulk-file-refactor D:\\Estee\\Programming\\My-Projects\\angular-app\\src\\app --skip-dirs models,tests --replace-file-name-segments services,pipes --remove-file-name-segments models,utils
+
+# Using package.json script
+npm run refactor -- D:\\Estee\\Programming\\My-Projects\\angular-app\\src\\app --skip-dirs models,tests --replace-file-name-segments services,pipes --remove-file-name-segments models,utils
+```
+
+## Compatibility
+
+This tool has been tested on Windows and works reliably. A Linux binary is included but hasn’t been fully tested yet. I’d love to hear how it performs on Linux or macOS! Please share your experience or report issues at [github.com/esteecodes/angular-v20-bulk-file-refactor/issues](github.com/esteecodes/angular-v20-bulk-file-refactor/issues).
+
+## License
+
+MIT License. See [LICENSE](./LICENSE) for details.
+
+## Author
+
+Esther White [esteecodes](https://github.com/esteecodes)
+
+## Repository
+
+[github.com/esteecodes/angular-v20-bulk-file-refactor](https://github.com/esteecodes/angular-v20-bulk-file-refactor)
+
+## Issues
+
+Report bugs or suggest improvements at [github.com/esteecodes/angular-v20-bulk-file-refactor/issues](https://github.com/esteecodes/angular-v20-bulk-file-refactor/issues).
+
+## Security Measures
+
+This package includes several security features to protect users:
+- **SHA-256 Verification**: Each binary comes with a `.sha256` file containing a unique fingerprint that verifies the file hasn't been tampered with during download.
+- **GPG Signatures**: All binaries include `.asc` signature files that prove the software was created by the package author and not modified by third parties.
+- **Automated Builds**: All binaries are built using GitHub Actions automated workflows, ensuring consistent and reproducible builds without manual intervention.
+
+Read more at [keys/README.md](keys/README.md)
+

package/bin/cli.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+const { program } = require('commander');
+const { execFile } = require('child_process');
+const path = require('path');
+
+program
+  .version('1.0.01')
+  .description('CLI tool to refactor Angular 20 project files by renaming and updating contents')
+  .argument('<projectPath>', 'Path to the Angular project folder')
+  .option('-s, --skip-dirs <dirs>', 'Comma-separated list of directories to skip', 'models,partials')
+  .option('--replace-file-name-segments <segments>', 'Comma-separated list of file segments to replace (e.g., services,directives)', 'services,directives')
+  .option('--remove-file-name-segments <segments>', 'Comma-separated list of file segments to remove (e.g., models)', 'models')
+  .option('--replace-import-segments <segments>', 'Comma-separated list of import segments to replace (e.g., .service)', '.service')
+  .option('--remove-import-segments <segments>', 'Comma-separated list of import segments to remove (e.g., .component,.directive,.model)', '.component,.directive,.model')
+  .action((projectPath, options) => {
+    let binaryName;
+    switch (process.platform) {
+      case 'win32':
+        binaryName = 'angular-v20-bulk-file-refactor'; // Resolves to .exe on Windows
+        break;
+      case 'darwin':
+        binaryName = 'angular-v20-bulk-file-refactor-darwin';
+        break;
+      case 'linux':
+        binaryName = 'angular-v20-bulk-file-refactor-linux';
+        break;
+      default:
+        console.error(`Unsupported platform: ${process.platform}`);
+        process.exit(1);
+    }
+
+    const binaryPath = path.join(__dirname, binaryName);
+    const args = [
+      projectPath,
+      '--skip-dirs', options.skipDirs,
+      '--replace-file-name-segments', options.replaceFileNameSegments,
+      '--remove-file-name-segments', options.removeFileNameSegments,
+      '--replace-import-segments', options.replaceImportSegments,
+      '--remove-import-segments', options.removeImportSegments
+    ];
+
+    execFile(binaryPath, args, (error, stdout, stderr) => {
+      if (error) {
+        console.error('Error executing refactor binary:', stderr);
+        process.exit(1);
+      }
+      console.log(stdout);
+    });
+  });
+
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "angular-v20-bulk-file-refactor",
+  "version": "1.0.01",
+  "description": "A CLI tool to automate file renaming and TypeScript refactoring for Angular 20 projects, aligning with conventions for components, services, directives, models, and standalone components.",
+  "keywords": [
+    "angular",
+    "angular20",
+    "angular-20",
+    "angular-v20",
+    "automation",
+    "automated-tool",
+    "refactor",
+    "typescript",
+    "cli",
+    "update",
+    "migration-tool",
+    "file-rename",
+    "file-refactor",
+    "bulk-file-refactor",
+    "bulk-file-rename",
+    "typescript-refactor",
+    "angular-cli",
+    "angular-refactoring",
+    "standalone"
+  ],
+  "license": "MIT",
+  "author": "Esther White <esteecodes@gmail.com>[](https://github.com/esteecodes)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/esteecodes/angular-v20-bulk-file-refactor.git"
+  },
+  "homepage": "https://angular-v20-bulk-file-refactor.esteecodes.com",
+  "bin": {
+    "angular-v20-bulk-file-refactor": "./bin/cli.js"
+  },
+  "files": [
+    "bin/cli.js",
+    "bin/angular-v20-bulk-file-refactor.exe",
+    "bin/angular-v20-bulk-file-refactor-linux"
+  ],
+  "dependencies": {
+    "commander": "^12.1.0"
+  }
+}