@jeffcaradona/eslint-plugin-eta 0.2.1 → 0.2.2

package/LICENSE

@@ -1,22 +1,7 @@
+Copyright 2025 Jeff Caradona <jeffcaradona@gmail.com>
 
-MIT License
+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:
 
-Copyright (c) 2020 shadowtime2000
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 
-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.
+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

@@ -1,9 +1,9 @@
 # eslint-plugin-eta
+An ESLint plugin so you can lint Eta template files (forked from <https://github.com/bgub/eslint-plugin-eta>)
 
 <span align="center">
 
-[![Travis](https://img.shields.io/travis/com/eta-dev/eslint-plugin-eta/master.svg)](https://travis-ci.com/eta-dev/eslint-plugin-eta)
-[![Coveralls](https://img.shields.io/coveralls/eta-dev/eslint-plugin-eta.svg)](https://coveralls.io/github/eta-dev/eslint-plugin-eta)
+
 
 </span>
 
@@ -12,22 +12,20 @@
 
 
 ### Installation
-Run `npm install --save-dev eslint-plugin-eta` to install this ESLint plugin.
+Run `npm install --save-dev @jeffcaradona/eslint-plugin-eta` to install this ESLint plugin.
 
 ### Usage
-Add this to your ESLint config:
+Add this to your `eslint.config.js`:
 ```javascript
-module.exports = {
-    ...
-    plugins: [
-        "eta"
-    ],
-    overrides: [
-        {
-            files: ["*.eta"],
-            processor: "eta/eta"
-        }
-    ],
-    ...
-}
+import eta from '@jeffcaradona/eslint-plugin-eta'
+
+export default [
+    {
+        files: ['**/*.eta'],
+        plugins: {
+            eta
+        },
+        processor: 'eta/eta'
+    }
+]
 ```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jeffcaradona/eslint-plugin-eta",
-  "version": "0.2.1",
-  "description": "An ESLint plugin so you can lint Eta template files",
+  "version": "0.2.2",
+  "description": "An ESLint plugin so you can lint Eta template files (forked from bgub/eslint-plugin-eta)",
   "type": "module",
   "main": "lib/index.js",
   "scripts": {
@@ -16,11 +16,16 @@
     "eslint",
     "eslintplugin"
   ],
-  "author": "jeffcaradona",
+  "author": "jeffcaradona <jeffcaradona@gmail.com>",
   "contributors": [
-    "shadowtime2000 (Original Author)"
+    "Ben Gubler (Original Author)"
   ],
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jeffcaradona/eslint-plugin-eta.git",
+    "baseUrl": "https://github.com/bgub/eslint-plugin-eta"
+  },
   "peerDependencies": {
     "eslint": ">=9 <10",
     "eta": ">=1.0.0 <5.0.0"
@@ -55,4 +60,4 @@
       "/test/"
     ]
   }
-}
+}

package/.travis.yml

@@ -1,14 +0,0 @@
-language: node_js
-cache:
-  yarn: true
-  directories:
-    - ~/npm
-notifications:
-  email: false
-node_js:
-  - '10'
-  - '12'
-script:
-  - yarn test:prod
-after_sucess:
-  - yarn run report-coverage

package/ETA_V4_API_RESEARCH.md

@@ -1,149 +0,0 @@
-# Eta v4.5.0 API Research Findings
-
-## Overview
-Eta v4 is a significant rewrite. The current code uses `Eta.parse()` which is a static function on the old API. In v4, the API changed to an instance-based approach.
-
-## 1. Parse Method Replacement
-
-**Old API (v3):**
-```javascript
-const result = Eta.parse(text, config)
-```
-
-**New API (v4.5.0):**
-```javascript
-const eta = new Eta(config)
-const result = eta.parse(text)
-```
-
-**Key Change:** `parse()` is now an **instance method**, not a static method. Config must be passed to the constructor.
-
-### Source Evidence
-From `src/internal.ts`:
-```typescript
-export class Eta {
-  constructor(customConfig?: Partial<EtaConfig>) {
-    if (customConfig) {
-      this.config = { ...defaultConfig, ...customConfig };
-    } else {
-      this.config = { ...defaultConfig };
-    }
-  }
-  
-  parse = parse;  // parse is an instance method
-  compile = compile;
-  compileToString = compileToString;
-  // ... other methods
-}
-```
-
-## 2. Token Schema - UNCHANGED ✓
-
-The token schema remains the same:
-```typescript
-export interface TemplateObject {
-  t: TagType;        // Tag type: "r" (raw), "e" (exec), "i" (interpolate), "" (text)
-  val: string;       // Token value/content
-  lineNo?: number;   // Line number (optional, when debug: true)
-}
-```
-
-**In v4, the schema uses `lineNo` instead of `line` for the debug property:**
-- Old: `{t, val, line}`
-- New: `{t, val, lineNo}`
-
-Note: Current ESLint processor code doesn't use lineNo, so minimal change needed here.
-
-## 3. Tag/Config Option Names - MOSTLY UNCHANGED ✓
-
-The parsing configuration structure is preserved in v4:
-
-```typescript
-// From src/config.ts
-parse: {
-  exec: string;        // Prefix for code execution (default: "")
-  interpolate: string; // Prefix for interpolation (default: "=")
-  raw: string;         // Prefix for raw output (default: "~")
-}
-
-tags: [string, string]; // Delimiters (default: ["<%", "%>"])
-```
-
-**These are identical to v3 usage.** No changes needed for tag/delimiter configuration.
-
-Additional relevant config options (same as v3):
-- `debug`: boolean - enables `lineNo` in tokens
-- `autoEscape`: boolean (default: true)
-- `autoFilter`: boolean (default: false)
-- `rmWhitespace`: boolean (default: false)
-- `varName`: string (default: "it")
-- `useWith`: boolean (default: false)
-
-## 4. Main Export and Available Methods
-
-**Eta class (v4.5.0) instance methods:**
-
-Core methods:
-- `parse(str)` → returns `Array<AstObject>` - Parses template string to AST
-- `compile(str, options?)` → returns `TemplateFunction` - Compiles to function
-- `compileToString(str, options?)` → returns `string` - Returns JS code as string
-- `render(name, data, options?)` - Render from cache/file
-- `renderAsync(name, data, options?)` - Async render
-- `renderString(str, data, options?)` - Render inline string
-- `renderStringAsync(str, data, options?)` - Async render inline
-
-Configuration methods:
-- `configure(customConfig)` - Update config on existing instance
-- `withConfig(customConfig)` - Return new instance with config
-
-Template management:
-- `loadTemplate(name, template, options?)` - Cache a template function
-
-## 5. How to Adapt the ESLint Processor
-
-**Current code:**
-```javascript
-const Eta = require('eta')
-
-module.exports = {
-  preprocess: (text, filename) => {
-    let result = Eta.parse(text, {
-      parse: { exec: '', interpolate: '=', raw: '~' },
-      tags: ['<%', '%>']
-    })
-```
-
-**Updated code:**
-```javascript
-const { Eta } = require('eta')  // Import Eta class
-
-module.exports = {
-  preprocess: (text, filename) => {
-    const eta = new Eta({  // Create instance with config
-      parse: { exec: '', interpolate: '=', raw: '~' },
-      tags: ['<%', '%>']
-    })
-    let result = eta.parse(text)  // Call parse on instance
-```
-
-**Changes needed:**
-1. `const Eta = require('eta')` → `const { Eta } = require('eta')`
-2. `Eta.parse(text, config)` → Create instance then `eta.parse(text)`
-3. Optional: Handle `lineNo` instead of `line` if used (not applicable to current code)
-
-## Summary Table
-
-| Aspect | Old (v3) | New (v4.5.0) | Status |
-|--------|----------|--------------|--------|
-| Parse API | `Eta.parse(str, config)` | `new Eta(config).parse(str)` | **CHANGED** |
-| Import | `const Eta = require('eta')` | `const { Eta } = require('eta')` | **CHANGED** |
-| Token schema | `{t, val, line}` | `{t, val, lineNo}` | ✓ Compatible |
-| Tag config | `tags: ['<%', '%>']` | `tags: ['<%', '%>']` | ✓ Same |
-| Parse options | `parse: {exec, interpolate, raw}` | `parse: {exec, interpolate, raw}` | ✓ Same |
-| Token types | `r`, `e`, `i`, `` | `r`, `e`, `i`, `` | ✓ Same |
-
-## Implementation Priority
-
-**Critical:** Update parse call from static to instance method
-**Low Priority:** Handle `lineNo` field (current code doesn't use it)
-**Optional:** Use new instance methods like `renderString()` if needed

package/eslint.config.js

@@ -1,19 +0,0 @@
-import js from '@eslint/js'
-import globals from 'globals'
-
-export default [
-  js.configs.recommended,
-  {
-    languageOptions: {
-      ecmaVersion: 2020,
-      sourceType: 'module',
-      globals: {
-        ...globals.node,
-        ...globals.jest
-      }
-    },
-    rules: {
-      'no-unused-vars': ['error', { argsIgnorePattern: '^_' }]
-    }
-  }
-]

package/upgrade_path.md

@@ -1,41 +0,0 @@
-# Upgrade Path (ESLint 9 target)
-
-Target: move to ESLint 9.x (flat config support) while stepping dependencies through patch/minor before majors. Keep Node on a supported version for ESLint 9 (>=18.18.0; aim for 22.x as the long-term target, 20.x acceptable while upgrading).
-
-## Order of operations
-- Patch/minor only: coveralls, eslint-plugin-import, existing majors at latest patch. 
-
-- ESLint family to 9.x: migrate config to flat-config (or maintain legacy via eslint-compat if desired), upgrade eslint, eslint-plugin-node (or eslint-plugin-n), eslint-plugin-promise, eslint-plugin-standard, @typescript-eslint/eslint-plugin.
-
-- Eta to chosen major (recommended 4.x after staged checks below).
-- Tooling majors: jest, prettier, typescript.
-- Final sweep: rerun lint/test/format, update peer ranges and docs.
-
-## Component paths
-
-### ESLint core and plugins
-- eslint 7.11.0 → 7.32.0 (latest 7.x) → 8.x.latest → 9.x.latest. Migrate to flat config on the 9 jump; consider eslint-compat to bridge eslintrc if needed.
-- eslint-plugin-import 2.22.1 → 2.32.0 (patch/minor only); re-run lint for new rules/options.
-- eslint-plugin-promise 4.2.1 → 4.x.latest → 5.x → 6.x → 7.2.1; watch for rule defaults changing severity/options.
-- eslint-plugin-standard 4.0.1 → 4.x.latest → 5.0.0; update any extended configs if rules moved.
-- eslint-plugin-node 11.1.0 → 11.x.latest; consider migrating to eslint-plugin-n if/when rules move; ensure Node version map matches runtime.
-- @typescript-eslint/eslint-plugin 4.5.0 → 4.x.latest → 5.x → 6.x → 7.x → 8.50.0; ensure parser version aligns with ESLint 9 support matrix.
-- Peer ranges: set eslint to ">=9 <10" and align @typescript-eslint peer if required by chosen major.
-
-### Eta processor
-- Current usage: Eta.parse with options {parse: {exec:"", interpolate:"=", raw:"~"}, tags:["<%","%>"]}, filtering tokens where t ∈ {r,i,e} and using val strings.
-- Path: 1.11.0 → 1.x.latest → 2.x → 3.x → 4.5.0.
-- Checks per jump: confirm parse() signature and token schema (t/val/line), option names (tags, parse, autoEscape/includeLineNo) unchanged, and CommonJS require still supported; add/adjust tests that snapshot parse output for representative templates.
-- If Eta becomes ESM-only, add an import shim (dynamic import or esm proxy) before moving on.
-- Update peer range to match chosen Eta major once validated.
-
-### Tooling and formatters
-- jest 26.6.0 → 27.x.latest → 28.x.latest → 29.x.latest → 30.2.0; update fake timers config and watch ESM defaults if used. Until Jest is on 29+, keep a moduleNameMapper for `^node:(.*)$` → `$1`.
-- prettier 2.1.2 → 2.8.8 → 3.7.4; expect formatting churn—run format after Prettier 3 bump and commit separately.
-- typescript 4.0.3 → 4.9.5 → 5.9.3; adjust tsconfig lib/target as needed; ensure @typescript-eslint major matches.
-- coveralls 3.1.0 → 3.1.1 (patch).
-
-## Verification checkpoints
-- After each stage, run: npm test, npm run lint, npm run format (post-Prettier 3) to isolate regressions.
-- Add processor-focused tests to lock Eta.parse output and ensure extracted JS matches expectations.
-- Update README usage to note supported ESLint 9.x and Eta major once validated.