@futdevpro/dynamo-eslint 1.12.1

package/.eslintrc.json

@@ -0,0 +1,16 @@
+{
+  "root": true,
+  "env": { "node": true, "es2021": true },
+  "extends": ["eslint:recommended", "plugin:@typescript-eslint/recommended"],
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": { "ecmaVersion": "latest", "sourceType": "module" },
+  "plugins": ["@typescript-eslint"],
+  "ignorePatterns": ["build/**"],
+  "rules": {
+    "indent": ["warn", 2, { "SwitchCase": 1 }],
+    "quotes": ["warn", "single", { "allowTemplateLiterals": true }],
+    "semi": ["warn", "always"]
+  }
+}
+
+

package/.github/workflows/main.yml

@@ -0,0 +1,393 @@
+name: Test and Deploy
+on: 
+  push:
+    branches:
+      - '**'
+permissions:
+  actions: read
+  id-token: write
+  contents: read
+  checks: write
+  issues: read
+  pull-requests: write
+env:
+  PACKAGE_NAME: ''
+  THIS_VERSION: 0.0.0
+  LATEST_VERSION: 0.0.0
+  VERSION_PUBLISHED: true
+  
+  
+jobs:
+  notification0:
+    name: 🏹 Discord start Notification
+    runs-on: ubuntu-latest
+    #runs-on: plo-koon
+    timeout-minutes: 20
+    outputs:
+      start: ${{ steps.mark_start.outputs.started }}
+    steps:
+    - uses: actions/checkout@v4
+    - id: mark_start
+      run: echo "started=$(date +%s)" >> "$GITHUB_OUTPUT"
+    - name: Send Discord start notification
+      uses: futdevpro/fdp-github-actions/discord-start-notification@latest
+      with:
+        NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        APPLICATION_NAME: "Dynamo-ESLint"
+        APPLICATION_EMOJI: "🔧"
+        COMMIT_MESSAGE: ${{ github.event.head_commit.message }}
+        EVENT_DATETIME: ${{ github.event.head_commit.timestamp }}
+        DISCORD_WEBHOOK_ID: ${{ secrets.DISCORD_WEBHOOK_ID }}
+        DISCORD_WEBHOOK_TOKEN: ${{ secrets.DISCORD_WEBHOOK_TOKEN }}
+
+  notification0_fail_report:
+    name: 💣 Discord Start Notification Fail Report
+    runs-on: ubuntu-latest
+    #runs-on: plo-koon
+    timeout-minutes: 20
+    if: always() && needs.notification0.result == 'failure'
+    needs: [notification0]
+    steps:
+      - name: send custom message with args
+        uses: appleboy/discord-action@master
+        with:
+          webhook_id: ${{ secrets.DISCORD_WEBHOOK_ID }}
+          webhook_token: ${{ secrets.DISCORD_WEBHOOK_TOKEN }}
+          message: |
+            ❌❌❌🔧 Failed to send Discord start notification for ${{ github.repository }}! [🔗](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }})
+
+  check_secrets:
+    name: 🔍 Check Required Secrets and Variables
+    #runs-on: ubuntu-latest
+    runs-on: plo-koon
+    timeout-minutes: 20
+    steps:
+    - name: Check Required Secrets and Variables
+      uses: futdevpro/fdp-github-actions/check-secrets-and-variables@latest
+      with:
+        NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        ITEMS_TO_CHECK: |
+          [
+            {
+              "valueName": "NPM_TOKEN", 
+              "value": "${{ secrets.NPM_TOKEN }}", 
+              "type": "SECRET"
+            }, 
+            {
+              "valueName": "DISCORD_WEBHOOK_ID", 
+              "value": "${{ secrets.DISCORD_WEBHOOK_ID }}", 
+              "type": "SECRET"
+            }, 
+            {
+              "valueName": "DISCORD_WEBHOOK_TOKEN", 
+              "value": "${{ secrets.DISCORD_WEBHOOK_TOKEN }}", 
+              "type": "SECRET"
+            }, 
+            {
+              "valueName": "OVERSEER_SECRET_KEY", 
+              "value": "${{ secrets.OVERSEER_SECRET_KEY }}", 
+              "type": "SECRET"
+            }, 
+            
+            {
+              "valueName": "OVERSEER_URL", 
+              "value": "${{ vars.OVERSEER_URL }}", 
+              "type": "VARIABLE"
+            }
+          ]
+
+  check_dev_leftovers:
+    name: 🔍 Check Dev leftovers
+    #runs-on: ubuntu-latest
+    runs-on: plo-koon
+    timeout-minutes: 20
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v2
+
+    - name: Install Node.js
+      uses: actions/setup-node@v2
+      with:
+        node-version: '16'
+    
+# TODO: Check build version (to ALL packages)
+    - name: Check build folder
+      run: |
+        node -e "
+          const buildFolder = './build/';
+          const fs = require('fs');
+          
+          fs.readdir(buildFolder, (err, files) => {
+            if (!files?.length) {
+              console.error(
+                'FDPError: ./build folder is MISSING!' +
+                '\nbuild the project locally before push!'
+              );
+              process.exit(1);
+            }
+
+            if (files.includes('dynamo-eslint')) {
+              console.error(
+                'FDPError: ./build contains dynamo-eslint folder which means this is a local dev build!' +
+                '\nrebuild the project locally before push!'
+              );
+              process.exit(1);
+            }
+          });
+        "
+
+  test:
+    name: 🧪 Test Build
+    runs-on: ubuntu-latest
+    needs: [ check_dev_leftovers ]
+    timeout-minutes: 20
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v2
+
+    - name: Set NPM RC
+      run: |
+        echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" > ~/.npmrc
+
+    - name: Install pnpm
+      run: |
+        npm i -g pnpm 
+
+    - name: Install Packages
+      run: |
+        pnpm i
+
+    - name: Build
+      run: |
+        npx tsc
+
+    - name: Install Jasmine
+      run: |
+        npm i -g jasmine
+
+    - name: Test
+      run: |
+        jasmine
+        
+    - name: Test Pack
+      run: |
+        pnpm pack
+
+
+  check_version:
+    name: 🔍 Check Version
+    needs: [ test ]
+    #runs-on: ubuntu-latest
+    runs-on: plo-koon
+    timeout-minutes: 20
+    outputs:
+      version_published: ${{ steps.version_check_results.outputs.version_published }}
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v2
+
+    - name: Set Package Name
+      run: |
+        echo "PACKAGE_NAME=$(node -p -e "require('./package.json').name")" >> $GITHUB_ENV
+
+    - name: Set RC
+      run: |
+        echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" > ~/.npmrc
+
+    - name: Get This Version
+      run: |
+        RAW_THIS_VERSION=$(node -p -e "require('./package.json').version")
+          # replace ALL: 'v0' with '', '01' with '1', '.0' with '.'
+        RAW_THIS_VERSION=$(echo $RAW_THIS_VERSION | sed 's:v0::g'  | sed 's:01:1:g' | sed -e 's:\.0:\.:g')
+        echo "THIS_VERSION=$RAW_THIS_VERSION" >> $GITHUB_ENV
+
+    - name: Get Latest Version
+      run: |
+        echo "LATEST_VERSION=$(npm view ${{ env.PACKAGE_NAME }} version)" >> $GITHUB_ENV
+
+    - name: Check All Versions
+      run: |
+        ALL_VERSIONS=$(npm view ${{ env.PACKAGE_NAME }} versions)
+        if echo "$ALL_VERSIONS" | grep -q "${{ env.THIS_VERSION }}"; then
+          echo "VERSION_PUBLISHED=true" >> $GITHUB_ENV
+        else
+          echo "VERSION_PUBLISHED=false" >> $GITHUB_ENV          
+        fi
+
+    - name: Version Check Results
+      id: version_check_results
+      run: |
+        echo package name: "${{ env.PACKAGE_NAME }}"
+        echo this: "${{ env.THIS_VERSION }}" 
+        echo latest: "${{ env.LATEST_VERSION }}"
+        echo this is the latest: "${{ env.LATEST_VERSION == env.THIS_VERSION }}"
+        echo this version is published: "${{ env.VERSION_PUBLISHED }}"
+        echo all published versions: $(npm view ${{ env.PACKAGE_NAME }} versions)
+          echo "::set-output name=version_published::${{ env.VERSION_PUBLISHED }}"
+          
+  deploy:
+    needs: [ check_version ]
+    name: 🚀 Deploy to NPM
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+#    if: ${{ needs.check_version.outputs.version_published != 'true' }}
+    if: always()
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v2 
+      
+    - name: Set RC
+      run: |
+        echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" > ~/.npmrc
+
+    - name: Install pnpm
+      run: |
+        npm i -g pnpm 
+
+    - name: Install Packages
+      run: |
+        pnpm i
+
+    - name: Build
+      run: |
+        npx tsc
+
+    - name: Pack
+      run: |
+        pnpm pack
+
+    - name: Publish
+      run: |
+        npm publish
+
+  build_report:
+    name: 📊 Build Report
+    needs: [ 
+      notification0, 
+      check_dev_leftovers, 
+      test, 
+      check_version, 
+      deploy 
+    ]
+    #runs-on: ubuntu-latest
+    runs-on: plo-koon
+    timeout-minutes: 20
+    if: always()
+    steps:
+      
+    # NEW IMPLEMENTATION using futdevpro/fdp-github-actions/send-build-report@master:
+    - name: Checkout code
+      uses: actions/checkout@v2
+      
+    - name: Send Build Report
+      uses: futdevpro/fdp-github-actions/send-build-report@master
+      with:
+        NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        SETTINGS: |
+          {
+            "overseerUrl": "${{ vars.OVERSEER_URL }}",
+            "overseerSecret": "${{ secrets.OVERSEER_SECRET_KEY }}",
+            "branchName": "${{ github.ref_name }}",
+            "repository": "${{ github.repository }}",
+            "runId": "${{ github.run_id }}",
+            "linkToAction": "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}",
+            "eventDateTime": "${{ needs.notification0.outputs.start }}",
+            "projects": [
+              {
+                "environment": "prod",
+                "stepResults": [
+                  {
+                    "stepName": "checkDevLeftovers",
+                    "resultCode": "${{ needs.check_dev_leftovers.result }}",
+                    "requirement": "optional"
+                  },
+                  {
+                    "stepName": "tests",
+                    "resultCode": "${{ needs.test.result }}",
+                    "requirement": "required"
+                  },
+                  {
+                    "stepName": "checkVersion",
+                    "resultCode": "${{ needs.check_version.result }}",
+                    "requirement": "required"
+                  },
+                  {
+                    "stepName": "deploy",
+                    "resultCode": "${{ needs.deploy.result }}",
+                    "requirement": "optional"
+                  }
+                ]
+              }
+            ]
+          }
+
+
+  end:
+    name: 🎯 Discord Results
+    needs: [ 
+      notification0, 
+      check_secrets, 
+      check_dev_leftovers, 
+      test, 
+      check_version, 
+      deploy, 
+      build_report 
+    ]
+    #runs-on: ubuntu-latest
+    runs-on: plo-koon
+    timeout-minutes: 20
+    if: always()
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      
+    - name: Send Discord result notification
+      uses: futdevpro/fdp-github-actions/discord-result-notification@latest
+      with:
+        NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        APPLICATION_NAME: "Dynamo-ESLint"
+        APPLICATION_EMOJI: "🔧"
+        BRANCH: ${{ github.ref_name }}
+        RUN_NUMBER: ${{ github.run_number }}
+        RUN_ID: ${{ github.run_id }}
+        REPOSITORY: ${{ github.repository }}
+        START_TIME: ${{ needs.notification0.outputs.start }}
+        DISCORD_WEBHOOK_ID: ${{ secrets.DISCORD_WEBHOOK_ID }}
+        DISCORD_WEBHOOK_TOKEN: ${{ secrets.DISCORD_WEBHOOK_TOKEN }}
+        STEPS_CONFIG: |
+          [
+            {
+              "stepName": "Secrets Check",
+              "stepEmoji": "🔑",
+              "resultCode": "${{ needs.check_secrets.result }}"
+            },
+            {
+              "stepName": "Dev Leftovers Check",
+              "stepEmoji": "🔍",
+              "resultCode": "${{ needs.check_dev_leftovers.result }}"
+            },
+            {
+              "stepName": "Test Build",
+              "stepEmoji": "🧪",
+              "resultCode": "${{ needs.test.result }}"
+            },
+            {
+              "stepName": "Check Version",
+              "stepEmoji": "🔍",
+              "resultCode": "${{ needs.check_version.result }}"
+            },
+            {
+              "stepName": "Deploy",
+              "stepEmoji": "📦",
+              "resultCode": "${{ needs.deploy.result }}",
+              "specialSuccessEmoji": "🚀🚀🚀"
+            },
+            {
+              "stepName": "Build Report",
+              "stepEmoji": "📊",
+              "resultCode": "${{ needs.build_report.result }}"
+            }
+          ]
+
+
+

package/INTEGRATION.md

@@ -0,0 +1,74 @@
+# Integration Guide
+
+Use these steps in each repo to adopt `@futdevpro/dynamo-eslint` with on-save current-file linting.
+
+## 1) Install
+
+```bash
+pnpm add -D @futdevpro/dynamo-eslint eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin
+# For Angular projects also install:
+pnpm add -D @angular-eslint/eslint-plugin @angular-eslint/eslint-plugin-template @angular-eslint/template-parser
+```
+
+Optional (enables deeper custom checks):
+```bash
+pnpm add -D @futdevpro/fsm-dynamo
+```
+
+## 2) .eslintrc.json
+
+Pick one preset per project type and keep project-specific overrides.
+
+Node TS (service/lib):
+```json
+{
+  "root": true,
+  "extends": ["@futdevpro/dynamo-eslint/nts"]
+}
+```
+
+Angular app/lib:
+```json
+{
+  "root": true,
+  "extends": ["@futdevpro/dynamo-eslint/ngx"]
+}
+```
+
+Package flavors:
+- `@futdevpro/dynamo-eslint/fsm`
+- `@futdevpro/dynamo-eslint/nts-package`
+- `@futdevpro/dynamo-eslint/ngx-package`
+
+## 3) VSCode settings (current file only)
+
+Create or update `.vscode/settings.json`:
+```json
+{
+  "eslint.run": "onSave",
+  "eslint.workingDirectories": [{ "mode": "auto" }],
+  "editor.codeActionsOnSave": { "source.fixAll.eslint": true }
+}
+```
+
+## 4) NPM scripts
+
+```json
+{
+  "scripts": {
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "validate:imports": "dynamo-validate-imports",
+    "validate:naming": "dynamo-validate-naming"
+  }
+}
+```
+
+## 5) CI
+- Ensure your repo CI runs `npm run lint`.
+- Heavy lint runs should be CLI-based (not editor) for performance when many repos are open.
+
+## Notes
+- Presets derive from existing org configs; adjust local overrides sparingly.
+- Custom validators are no-ops unless `@futdevpro/fsm-dynamo` is installed.
+

package/POC-README.md

@@ -0,0 +1,147 @@
+# Dynamo ESLint POC - Import Ordering Rules
+
+This POC demonstrates the implementation of comprehensive import ordering rules for the `@futdevpro/dynamo-eslint` package.
+
+## 🎯 Features Implemented
+
+### Import Grouping Rules
+The linter enforces a specific import order with empty lines between groups:
+
+1. **Non-FutDevPro packages** (e.g., `@angular/core`, `rxjs`)
+2. **FutDevPro packages** (e.g., `@futdevpro/fsm-dynamo`, `@futdevpro/fdp-templates`)
+3. **Scripts from other modules** (3+ levels without underscore, or 3+ levels with underscore)
+4. **Scripts from same module** (up to 2 levels, or up to 3 levels with underscore)
+
+### Forbidden Import Patterns
+- ❌ **NPM-packages imports**: `import { Something } from '../../../NPM-packages/some-package'`
+- ❌ **JavaScript extensions**: `import { Something } from './some-file.js'`
+- ❌ **Import type usage**: `import type { SomeType } from './some-file'`
+
+### Validation Features
+- ✅ **Empty line enforcement**: Groups must be separated by empty lines
+- ✅ **Order validation**: Imports must be in the correct group order
+- ✅ **Same module detection**: Smart detection based on path depth and underscore patterns
+
+## 📁 File Structure
+
+```
+src/
+├── plugin/
+│   ├── rules/
+│   │   ├── import-order.ts          # Main import ordering rule
+│   │   ├── import-order.spec.ts     # Comprehensive test suite
+│   │   ├── naming-patterns.ts       # Naming patterns rule (placeholder)
+│   │   └── naming-patterns.spec.ts  # Naming patterns tests
+│   └── index.ts                     # Plugin exports
+├── scripts/
+│   ├── validate-imports.ts          # CLI script for import validation
+│   ├── validate-naming.ts           # CLI script for naming validation
+│   └── eslintrc-audit.ts            # ESLint config audit script
+└── configs/                         # ESLint configuration presets
+```
+
+## 🧪 Testing
+
+### Sample Files
+- `samples/poc-sample.ts` - Demonstrates correct import ordering
+- `samples/poc-violations.ts` - Shows various violations for testing
+
+### Test Results
+The POC successfully detects and reports:
+- ✅ Forbidden NPM-packages imports
+- ✅ Forbidden .js extension imports  
+- ✅ Forbidden import type usage
+- ✅ Misordered import groups
+- ✅ Missing empty lines between groups
+
+## 🚀 Usage
+
+### As ESLint Rule
+```json
+{
+  "plugins": ["@futdevpro/dynamo"],
+  "rules": {
+    "@futdevpro/dynamo/import-order": "error"
+  }
+}
+```
+
+### CLI Validation
+```bash
+# Validate imports
+npx dynamo-validate-imports
+
+# Validate naming
+npx dynamo-validate-naming
+
+# Audit ESLint configs
+npx dynamo-eslintrc-audit
+```
+
+## 📋 Example Output
+
+```
+❌ Violation: forbiddenNpmPackages
+   Line: 3
+   Message: Import from "*/../NPM-packages/*" is forbidden. Use "@futdevpro/*" instead.
+
+❌ Violation: forbiddenJsExtension
+   Line: 4
+   Message: Import with ".js" extension is forbidden. Use ".ts" or no extension.
+
+❌ Violation: forbiddenImportType
+   Line: 5
+   Message: Use of "import type" is forbidden.
+
+❌ Violation: misordered
+   Line: 2
+   Message: Import statements should be grouped and ordered by convention.
+
+❌ Violation: missingEmptyLine
+   Line: 1
+   Message: Missing empty line between import groups.
+```
+
+## 🔧 Implementation Details
+
+### Import Group Detection Logic
+```typescript
+function getImportGroup(importNode: any): ImportGroup['type'] {
+  const source = importNode.source.value as string;
+  
+  // Check for forbidden patterns first
+  if (source.includes('/NPM-packages/')) return 'non-futdevpro';
+  if (source.endsWith('.js')) return 'non-futdevpro';
+  
+  // FutDevPro packages
+  if (source.startsWith('@futdevpro/')) return 'futdevpro';
+  
+  // Same module detection
+  if (source.startsWith('./') || source.startsWith('../')) {
+    const pathParts = source.split('/');
+    const upLevels = pathParts.filter(part => part === '..').length;
+    
+    // Same module: up to 3 ".." and starts with "_", or less than 2 ".."
+    if (upLevels <= 2 || (upLevels <= 3 && pathParts.some(part => part.startsWith('_')))) {
+      return 'same-module';
+    }
+    
+    return 'other-modules';
+  }
+  
+  return 'non-futdevpro';
+}
+```
+
+## ✅ POC Status
+
+- [x] Import grouping logic implemented
+- [x] Forbidden pattern detection
+- [x] Empty line validation
+- [x] Order validation
+- [x] Comprehensive test suite
+- [x] CLI validation scripts
+- [x] Sample files for demonstration
+- [x] Documentation and examples
+
+The POC successfully demonstrates all requested import ordering rules and is ready for integration into the main package.

package/README.md

@@ -0,0 +1,36 @@
+# @futdevpro/dynamo-eslint
+
+Shared ESLint presets and Dynamo validators for Node TS and Angular.
+
+## Usage
+
+- Install peers then extend one preset:
+
+```json
+{
+  "root": true,
+  "extends": ["@futdevpro/dynamo-eslint/nts"]
+}
+```
+
+- VSCode settings for current-file on save:
+
+```json
+{
+  "eslint.run": "onSave",
+  "eslint.workingDirectories": [{ "mode": "auto" }],
+  "editor.codeActionsOnSave": { "source.fixAll.eslint": true }
+}
+```
+
+## Presets
+- base
+- nts
+- ngx
+- fsm
+- nts-package
+- ngx-package
+
+## Audit
+
+Run `dynamo-eslintrc-audit` in a workspace to analyze duplicated rules.