@decaf-ts/for-angular 0.1.3 → 0.1.4

package/angular.json

@@ -0,0 +1,274 @@
+{
+  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
+  "version": 1,
+  "newProjectRoot": "projects",
+  "projects": {
+    "for-angular": {
+      "projectType": "library",
+      "root": ".",
+      "sourceRoot": "src/lib",
+      "prefix": "ngx-decaf",
+      "cli": {
+        "schematicCollections": ["./schematics"]
+      },
+      "schematics": {
+        "@schematics/angular:component": {
+          "style": "scss",
+          "standalone": true,
+          "path": "src/lib/components"
+        },
+        "@schematics/angular:service": {
+          "path": "src/lib/services"
+        },
+        "@schematics/angular:directive": {
+          "standalone": true,
+          "path": "src/lib/directives"
+        }
+      },
+      "architect": {
+        "build": {
+          "builder": "@angular-devkit/build-angular:ng-packagr",
+          "options": {
+            "project": "ng-package.json"
+          },
+          "configurations": {
+            "production": {
+              "tsConfig": "tsconfig.lib.prod.json"
+            },
+            "development": {
+              "tsConfig": "tsconfig.lib.json"
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "storybook": {
+          "builder": "@storybook/angular:start-storybook",
+          "options": {
+            "configDir": ".storybook",
+            "browserTarget": "for-angular:build",
+            "compodoc": false,
+            "port": 6006,
+            "assets": [
+              {
+                "glob": "**/*",
+                "input": "src/assets",
+                "output": "assets"
+              },
+              {
+                "glob": "**/*.svg",
+                "input": "node_modules/ionicons/dist/ionicons/svg",
+                "output": "./svg"
+              }
+            ],
+            "styles": ["src/theme/variables.scss", "src/global.scss"]
+          }
+        },
+        "build-storybook": {
+          "builder": "@storybook/angular:build-storybook",
+          "options": {
+            "configDir": "./.storybook",
+            "browserTarget": "for-angular:build",
+            "compodoc": false,
+            "outputDir": "dist/storybook/for-angular"
+          }
+        },
+        "lint": {
+          "builder": "@angular-eslint/builder:lint",
+          "options": {
+            "lintFilePatterns": ["src/**/*.ts", "src/**/*.html"]
+          }
+        }
+      }
+    },
+    "for-angular-app": {
+      "projectType": "application",
+      "root": "",
+      "sourceRoot": "src",
+      "prefix": "app",
+      "architect": {
+        "build": {
+          "builder": "@angular-builders/custom-webpack:browser",
+          "options": {
+            "preserveSymlinks": true,
+            "outputPath": "www",
+            "index": "src/index.html",
+            "main": "src/main.ts",
+            "polyfills": ["src/polyfills.ts", "zone.js", "zone.js/testing"],
+            "customWebpackConfig": {
+              "path": "./webpack.config.js"
+            },
+
+            "tsConfig": "tsconfig.app.json",
+            "inlineStyleLanguage": "scss",
+            "assets": [
+              {
+                "glob": "**/*",
+                "input": "src/assets",
+                "output": "assets"
+              },
+              {
+                "glob": "**/*",
+                "input": "src/app/assets",
+                "output": "app/assets"
+              },
+              "src/manifest.webmanifest",
+              "src/cli-module.ts",
+              "src/lib/**/*"
+            ],
+            "styles": ["src/global.scss", "src/theme/variables.scss"],
+            "serviceWorker": false,
+            "ngswConfigPath": "ngsw-config.json"
+          },
+          "configurations": {
+            "production": {
+              "budgets": [
+                {
+                  "type": "initial",
+                  "maximumWarning": "5mb",
+                  "maximumError": "10mb"
+                },
+                {
+                  "type": "anyComponentStyle",
+                  "maximumWarning": "8kb",
+                  "maximumError": "16kb"
+                }
+              ],
+              "outputHashing": "all"
+            },
+            "development": {
+              "buildOptimizer": false,
+              "optimization": false,
+              "vendorChunk": true,
+              "extractLicenses": false,
+              "sourceMap": true,
+              "namedChunks": true
+            },
+            "ci": {
+              "progress": false
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "serve": {
+          "builder": "@angular-devkit/build-angular:dev-server",
+          "options": {
+            "port": 8111
+          },
+          "configurations": {
+            "production": {
+              "buildTarget": "for-angular-app:build:production"
+            },
+            "development": {
+              "buildTarget": "for-angular-app:build:development"
+            },
+            "ci": {}
+          },
+          "defaultConfiguration": "development"
+        },
+        "extract-i18n": {
+          "builder": "@angular-devkit/build-angular:extract-i18n",
+          "options": {
+            "buildTarget": "for-angular-app:build"
+          }
+        },
+        "test": {
+          "builder": "@angular-devkit/build-angular:karma",
+          "options": {
+            "main": "src/test.ts",
+            "polyfills": "src/polyfills.ts",
+            "tsConfig": "tsconfig.spec.json",
+            "karmaConfig": "karma.conf.js",
+            "inlineStyleLanguage": "scss",
+            "assets": [
+              {
+                "glob": "**/*",
+                "input": "src/assets",
+                "output": "assets"
+              },
+              {
+                "glob": "**/*.svg",
+                "input": "node_modules/ionicons/dist/ionicons/svg",
+                "output": "./svg"
+              },
+              "src/manifest.webmanifest",
+              "src/cli-module.ts",
+              "src/lib/**/*"
+            ],
+            "styles": ["src/global.scss", "src/theme/variables.scss"],
+            "scripts": []
+          },
+          "configurations": {
+            "ci": {
+              "progress": false,
+              "watch": false
+            }
+          }
+        },
+        "storybook": {
+          "builder": "@storybook/angular:start-storybook",
+          "options": {
+            "configDir": ".storybook",
+            "browserTarget": "for-angular-app:build",
+            "compodoc": false,
+            "port": 6006,
+            "assets": [
+              {
+                "glob": "**/*",
+                "input": "src/assets",
+                "output": "assets"
+              },
+              {
+                "glob": "**/*.svg",
+                "input": "node_modules/ionicons/dist/ionicons/svg",
+                "output": "./svg"
+              }
+            ],
+            "styles": ["src/theme/variables.scss", "src/global.scss"]
+          }
+        },
+        "build-storybook": {
+          "builder": "@storybook/angular:build-storybook",
+          "options": {
+            "configDir": "./.storybook",
+            "browserTarget": "for-angular-app:build",
+            "compodoc": false,
+            "outputDir": "dist/storybook/for-angular-app"
+          }
+        },
+        "lint": {
+          "builder": "@angular-eslint/builder:lint",
+          "options": {
+            "lintFilePatterns": ["src/**/*.ts", "src/**/*.html"]
+          }
+        }
+      }
+    }
+  },
+  "cli": {
+    "schematicCollections": ["@ionic/angular-toolkit"],
+    "analytics": false
+  },
+  "schematics": {
+    "@ionic/angular-toolkit:component": {
+      "styleext": "scss",
+      "path": "src/app/components",
+      "standalone": true
+    },
+    "@ionic/angular-toolkit:page": {
+      "styleext": "scss",
+      "path": "src/app/pages",
+      "standalone": true,
+      "schematicCollections": ".schematics"
+    },
+    "@schematics/angular:service": {
+      "path": "src/app/services"
+    },
+    "@schematics/angular:directive": {
+      "standalone": true,
+      "path": "src/app/directives"
+    },
+    "@schematics/angular:pipe": {
+      "path": "src/app/pipes"
+    }
+  }
+}

package/bs-config.json

@@ -0,0 +1,5 @@
+{
+  "port": 8122,
+  "files": ["./src/**/*.{html,htm,css,js}"],
+  "server": { "baseDir": "./www" }
+}

package/cli-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-module.js","sourceRoot":"","sources":["src/cli-module.ts"],"names":[],"mappings":";;;AAAA,yCAAoC;AAEpC,SAAgB,OAAO;IACrB,OAAO,IAAI,mBAAO,EAAE;SACjB,OAAO,CAAC,wBAAwB,CAAC;SACjC,WAAW,CAAC,8BAA8B,CAAC;SAC3C,MAAM,CAAC,CAAC,IAAY,EAAE,IAAY,EAAE,EAAE;QACrC,OAAO,CAAC,GAAG,CACT,6CAA6C,IAAI,aAAa,IAAI,EAAE,CACrE,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC;AATD,0BASC"}

package/dist/for-angular/cli/cli-module.d.ts

@@ -0,0 +1,22 @@
+import { Command } from 'commander';
+/**
+ * Creates and returns a Command object for the Angular CLI module in decaf-ts.
+ * This function sets up a 'generate' command that can create various Angular artifacts.
+ *
+ * @returns {Command} A Command object configured with the 'generate' subcommand and its action.
+ *
+ * The command syntax is: generate <type> <name> [project]
+ * @param {Types} type - The type of artifact to generate (e.g., service, component, directive, page).
+ * @param {string} name - The name of the artifact to be generated.
+ * @param {Projects} [project=Projects.FOR_ANGULAR] - The project for which to generate the artifact.
+ *                   Defaults to the main Angular project if not specified.
+ *
+ * @throws {Error} If an invalid type is provided.
+ *
+ * @example
+ * // Usage in CLI
+ * // decaf-ts generate service my-service
+ * // decaf-ts generate component my-component for-angular-app
+ */
+export default function angular(): Command;
+//# sourceMappingURL=cli-module.d.ts.map

package/dist/for-angular/cli/cli-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-module.d.ts","sourceRoot":"","sources":["../../../src/cli-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBpC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,YA+B9B"}

package/dist/for-angular/cli/cli-module.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = angular;
+const commander_1 = require("commander");
+const utils_1 = require("@decaf-ts/utils");
+const logging_1 = require("@decaf-ts/logging");
+var Projects;
+(function (Projects) {
+    Projects["FOR_ANGULAR"] = "for-angular";
+    Projects["FOR_ANGULAR_APP"] = "for-angular-app";
+    Projects["LIB"] = "lib";
+    Projects["APP"] = "app";
+})(Projects || (Projects = {}));
+;
+var Types;
+(function (Types) {
+    Types["PAGE"] = "page";
+    Types["SERVICE"] = "service";
+    Types["COMPONENT"] = "component";
+    Types["DIRECTIVE"] = "directive";
+    Types["SCHEMATICS"] = "schematics";
+})(Types || (Types = {}));
+;
+const logger = logging_1.Logging.for("for-angular-cli");
+/**
+ * Creates and returns a Command object for the Angular CLI module in decaf-ts.
+ * This function sets up a 'generate' command that can create various Angular artifacts.
+ *
+ * @returns {Command} A Command object configured with the 'generate' subcommand and its action.
+ *
+ * The command syntax is: generate <type> <name> [project]
+ * @param {Types} type - The type of artifact to generate (e.g., service, component, directive, page).
+ * @param {string} name - The name of the artifact to be generated.
+ * @param {Projects} [project=Projects.FOR_ANGULAR] - The project for which to generate the artifact.
+ *                   Defaults to the main Angular project if not specified.
+ *
+ * @throws {Error} If an invalid type is provided.
+ *
+ * @example
+ * // Usage in CLI
+ * // decaf-ts generate service my-service
+ * // decaf-ts generate component my-component for-angular-app
+ */
+function angular() {
+    return new commander_1.Command()
+        .name('decaf generate')
+        .command('generate <type> <name> [project]')
+        .description(`decaf-ts Angular CLI module`)
+        .action(async (type, name, project = Projects.FOR_ANGULAR) => {
+        if (!validateType(type))
+            return logger.error(`${type} is not valid. Use service, component or directive.`);
+        if (type === Types.SCHEMATICS)
+            return await generateSchematics();
+        if (type === Types.PAGE) {
+            logger.info(`Pages can be only generate for app. Forcing project to: ${Projects.FOR_ANGULAR_APP}`);
+            project = Projects.FOR_ANGULAR_APP;
+        }
+        project = parseProjectName(project);
+        if (!validateProject(project))
+            project = Projects.FOR_ANGULAR;
+        const command = project === Projects.FOR_ANGULAR_APP ?
+            'ionic generate' : `ng generate --project=${Projects.FOR_ANGULAR} --path=src/lib/${type}s`;
+        try {
+            const result = await execute(`${command} ${type} ${name}`);
+            logger.info(result);
+        }
+        catch (error) {
+            logger.error(error?.message || error);
+        }
+    });
+}
+async function generateSchematics() {
+    return Promise.all([
+        execute(`npm link schematics`),
+        execute(`cd schematics`),
+        execute(`npm install`),
+        execute(`npm run build`),
+        execute(`npx schematics .:schematics --name=decaf`)
+    ])
+        .then(res => res)
+        .catch(error => error);
+}
+/**
+ * Executes a shell command asynchronously.
+ *
+ * @param command - The shell command to execute.
+ * @returns A Promise that resolves with the command's stdout output as a string if successful,
+ *          or rejects with an error message if the command fails or produces stderr output.
+ */
+async function execute(command) {
+    try {
+        return await (0, utils_1.runCommand)(command).promise;
+    }
+    catch (error) {
+        logger.error(error?.message || error);
+    }
+}
+/**
+ * Parses and normalizes the project name input.
+ *
+ * @param value - The input project name to be parsed.
+ *                Can be 'app', 'lib', or any other string value.
+ * @returns A normalized string representation of the project name.
+ *          Returns 'for-angular-app' if input is 'app',
+ *          'for-angular' if input is 'lib',
+ *          or the lowercase version of the input for any other value.
+ */
+function parseProjectName(value) {
+    return (value === Projects.APP ?
+        Projects.FOR_ANGULAR_APP : value === Projects.LIB ?
+        Projects.FOR_ANGULAR : value).toLowerCase();
+}
+/**
+ * Validates if the given type value is a valid enum member of Types.
+ *
+ * @param value - The type value to validate.
+ * @returns A boolean indicating whether the value is a valid Types enum member.
+ */
+function validateType(value) {
+    return Object.values(Types).includes(value);
+}
+/**
+ * Validates if the given project value is a valid enum member of Projects.
+ *
+ * @param value - The project value to validate.
+ * @returns A boolean indicating whether the value is a valid Projects enum member.
+ */
+function validateProject(value) {
+    return Object.values(Projects).includes(value);
+}
+//# sourceMappingURL=cli-module.js.map

package/dist/for-angular/cli/cli-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-module.js","sourceRoot":"","sources":["../../../src/cli-module.ts"],"names":[],"mappings":"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"}

package/dist/lib/README.md

@@ -0,0 +1,117 @@
+![Banner](./workdocs/assets/decaf-logo.svg)
+
+# Decaf's Angular Module
+
+> Release docs refreshed on 2025-11-26. See [workdocs/reports/RELEASE_NOTES.md](./workdocs/reports/RELEASE_NOTES.md) for ticket summaries.
+
+![Licence](https://img.shields.io/github/license/decaf-ts/for-angular.svg?style=plastic)
+![GitHub language count](https://img.shields.io/github/languages/count/decaf-ts/for-angular?style=plastic)
+![GitHub top language](https://img.shields.io/github/languages/top/decaf-ts/for-angular?style=plastic)
+
+[![Build & Test](https://github.com/decaf-ts/for-angular/actions/workflows/nodejs-build-prod.yaml/badge.svg)](https://github.com/decaf-ts/for-angular/actions/workflows/nodejs-build-prod.yaml)
+[![CodeQL](https://github.com/decaf-ts/for-angular/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/decaf-ts/for-angular/actions/workflows/codeql-analysis.yml)[![Snyk Analysis](https://github.com/decaf-ts/for-angular/actions/workflows/snyk-analysis.yaml/badge.svg)](https://github.com/decaf-ts/for-angular/actions/workflows/snyk-analysis.yaml)
+[![Pages builder](https://github.com/decaf-ts/for-angular/actions/workflows/pages.yaml/badge.svg)](https://github.com/decaf-ts/for-angular/actions/workflows/pages.yaml)
+[![.github/workflows/release-on-tag.yaml](https://github.com/decaf-ts/for-angular/actions/workflows/release-on-tag.yaml/badge.svg?event=release)](https://github.com/decaf-ts/for-angular/actions/workflows/release-on-tag.yaml)
+
+![Open Issues](https://img.shields.io/github/issues/decaf-ts/for-angular.svg)
+![Closed Issues](https://img.shields.io/github/issues-closed/decaf-ts/for-angular.svg)
+![Pull Requests](https://img.shields.io/github/issues-pr-closed/decaf-ts/for-angular.svg)
+![Maintained](https://img.shields.io/badge/Maintained%3F-yes-green.svg)
+
+![Line Coverage](workdocs/reports/coverage/badge-lines.svg)
+![Function Coverage](workdocs/reports/coverage/badge-functions.svg)
+![Statement Coverage](workdocs/reports/coverage/badge-statements.svg)
+![Branch Coverage](workdocs/reports/coverage/badge-branches.svg)
+
+
+![Forks](https://img.shields.io/github/forks/decaf-ts/for-angular.svg)
+![Stars](https://img.shields.io/github/stars/decaf-ts/for-angular.svg)
+![Watchers](https://img.shields.io/github/watchers/decaf-ts/for-angular.svg)
+
+![Node Version](https://img.shields.io/badge/dynamic/json.svg?url=https%3A%2F%2Fraw.githubusercontent.com%2Fbadges%2Fshields%2Fmaster%2Fpackage.json&label=Node&query=$.engines.node&colorB=blue)
+![NPM Version](https://img.shields.io/badge/dynamic/json.svg?url=https%3A%2F%2Fraw.githubusercontent.com%2Fbadges%2Fshields%2Fmaster%2Fpackage.json&label=NPM&query=$.engines.npm&colorB=purple)
+
+Documentation available [here](https://decaf-ts.github.io/for-angular/)
+
+Minimal size: unknown kb gzipped
+
+
+### Description
+
+A very versatile persistence layer. from smart contracts, Digital wallets or just regular database access
+
+
+
+### How to Use
+
+- [Initial Setup](./workdocs/tutorials/For%20Developers.md#_initial-setup_)
+- [Installation](./workdocs/tutorials/For%20Developers.md#installation)
+
+
+
+
+## Coding Principles
+
+- group similar functionality in folders (analog to namespaces but without any namespace declaration)
+- one class per file;
+- one interface per file (unless interface is just used as a type);
+- group types as other interfaces in a types.ts file per folder;
+- group constants or enums in a constants.ts file per folder;
+- group decorators in a decorators.ts file per folder;
+- always import from the specific file, never from a folder or index file (exceptions for dependencies on other packages);
+- prefer the usage of established design patters where applicable:
+  - Singleton (can be an anti-pattern. use with care);
+  - factory;
+  - observer;
+  - strategy;
+  - builder;
+  - etc;
+
+## Release Documentation Hooks
+Stay aligned with the automated release pipeline by reviewing [Release Notes](./workdocs/reports/RELEASE_NOTES.md) and [Dependencies](./workdocs/reports/DEPENDENCIES.md) after trying these recipes (updated on 2025-11-26).
+
+
+### Related
+
+[![decaf-ts](https://github-readme-stats.vercel.app/api/pin/?username=decaf-ts&repo=decaf-ts)](https://github.com/decaf-ts/decaf-ts)
+[![ui-decorators](https://github-readme-stats.vercel.app/api/pin/?username=decaf-ts&repo=ui-decorators)](https://github.com/decaf-ts/ui-decorators)
+[![styles](https://github-readme-stats.vercel.app/api/pin/?username=decaf-ts&repo=styles)](https://github.com/decaf-ts/styles)
+[![decorator-validation](https://github-readme-stats.vercel.app/api/pin/?username=decaf-ts&repo=decorator-validation)](https://github.com/decaf-ts/decorator-validation)
+[![db-decorators](https://github-readme-stats.vercel.app/api/pin/?username=decaf-ts&repo=db-decorators)](https://github.com/decaf-ts/db-decorators)
+
+
+### Social
+
+[![LinkedIn](https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/decaf-ts/)
+
+
+
+
+#### Languages
+
+![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white)
+![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge&logo=javascript&logoColor=black)
+![NodeJS](https://img.shields.io/badge/Node.js-43853D?style=for-the-badge&logo=node.js&logoColor=white)
+![ShellScript](https://img.shields.io/badge/Shell_Script-121011?style=for-the-badge&logo=gnu-bash&logoColor=white)
+
+## Getting help
+
+If you have bug reports, questions or suggestions please [create a new issue](https://github.com/decaf-ts/ts-workspace/issues/new/choose).
+
+## Contributing
+
+I am grateful for any contributions made to this project. Please read [this](./workdocs/98-Contributing.md) to get started.
+
+## Supporting
+
+The first and easiest way you can support it is by [Contributing](./workdocs/98-Contributing.md). Even just finding a typo in the documentation is important.
+
+Financial support is always welcome and helps keep both me and the project alive and healthy.
+
+So if you can, if this project in any way. either by learning something or simply by helping you save precious time, please consider donating.
+
+## License
+
+This project is licensed under the Mozilla Public License 2.0 (MPL-2.0). See `./LICENSE.md` for a Fair Usage Addendum that explains when AGPL-3.0 applies (automated AI/Decaf MCP code generation and non-deterministic UI generation).
+
+By developers, for developers...

package/eslint.config.mjs

@@ -0,0 +1,101 @@
+import eslint from '@eslint/js';
+import angular from 'angular-eslint';
+import unusedImports from 'eslint-plugin-unused-imports';
+import tseslint from 'typescript-eslint';
+// import Ajv from 'ajv/dist/ajv.bundle.js';
+
+// new Ajv({ missingRefs: 'ignore' });
+export default tseslint.config(
+  {
+    ignores: [
+      '.vscode/*',
+      'tests/**',
+      '**/*.spec.*',
+      '**/cli-module.*',
+      'src/tests/**',
+      'src/app/**',
+      'src/stories/**/*.ts',
+      'src/polyfills.ts',
+      'src/zone-flags.ts',
+    ],
+  },
+  {
+    files: ['**/*.ts'],
+    languageOptions: {
+      parserOptions: {
+        project: './tsconfig.json',
+      },
+    },
+
+    extends: [
+      eslint.configs.recommended,
+      ...tseslint.configs.recommended,
+      ...tseslint.configs.stylistic,
+      ...angular.configs.tsRecommended,
+    ],
+    processor: angular.processInlineTemplates,
+    plugins: {
+      'unused-imports': unusedImports,
+    },
+    rules: {
+      'prefer-const': 'warn',
+      '@typescript-eslint/no-explicit-any': 'warn',
+      'no-useless-constructor': 'off',
+      '@typescript-eslint/no-useless-constructor': 'warn',
+      '@typescript-eslint/no-inferrable-types': 'off',
+      '@typescript-eslint/no-empty-function': 'warn',
+
+      '@angular-eslint/no-empty-lifecycle-method': 'warn',
+      '@angular-eslint/prefer-inject': 'warn',
+      '@angular-eslint/component-class-suffix': ['error', { suffixes: ['Page', 'Component'] }],
+      '@angular-eslint/directive-selector': [
+        'error',
+        {
+          type: 'attribute',
+          prefix: ['ngx-decaf', ''],
+          style: 'kebab-case',
+        },
+      ],
+      '@angular-eslint/component-selector': [
+        'error',
+        {
+          type: 'element',
+          prefix: ['app', 'for-angular', 'decaf', 'ngx-decaf'],
+          style: 'kebab-case',
+        },
+      ],
+
+      'unused-imports/no-unused-imports': 'warn',
+      'unused-imports/no-unused-vars': [
+        'warn',
+        {
+          vars: 'all',
+          varsIgnorePattern: '^_',
+          args: 'after-used',
+          argsIgnorePattern: '^_',
+        },
+      ],
+
+      '@typescript-eslint/no-unused-vars': 'warn',
+    },
+  },
+
+  // regras para tipos
+  {
+    files: ['**/*.ts', '**/*.spec.ts'],
+    rules: {
+      'unused-imports/no-unused-imports': 'off',
+      'unused-imports/no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-vars': 'off',
+    },
+    // Só ativa este override se o arquivo estiver na mesma pasta que types.ts
+    // ou se o caminho contiver "types"
+    ignores: ['!**/types.ts', '!**/types/*'],
+  },
+
+  {
+    files: ['**/*.html'],
+    extends: [...angular.configs.templateRecommended, ...angular.configs.templateAccessibility],
+    rules: {},
+  }
+);