tutanus 0.12.0

package/dist/shared/helpers/rule-config.d.ts

@@ -0,0 +1,11 @@
+import type { RuleConfig, RuleOverride } from '../../types/index.js';
+export type { RuleConfig, RuleOverride };
+export declare function isRuleSuppressed(ruleName: string, fileCaminho: string): boolean;
+export declare function isTestArquivo(fileCaminho: string, configData?: {
+    testPadroes?: {
+        files?: string[];
+    };
+}): boolean;
+export declare function getRuleSeverity(ruleName: string, fileCaminho: string): 'error' | 'warning' | 'info' | undefined;
+export declare function shouldSuppressOccurrence(tipo: string, fileCaminho: string, _severity?: string): boolean;
+//# sourceMappingURL=rule-config.d.ts.map

package/dist/shared/helpers/rule-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-config.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/rule-config.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC;AAElD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AAKzC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAyD/E;AAGD,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE;IACX,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;CACH,GACA,OAAO,CAoBT;AAKD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CA6B/G;AAKD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAWvG"}

package/dist/shared/helpers/rule-config.js

@@ -0,0 +1,82 @@
+import { config } from '../../core/config/index.js';
+import { minimatch } from 'minimatch';
+export function isRuleSuppressed(ruleName, fileCaminho) {
+    const normalizedCaminho = fileCaminho.replace(/^\.\//, '').replace(/\\/g, '/');
+    const configData = config;
+    const suppressRules = configData.suppressRules;
+    if (suppressRules?.includes(ruleName)) {
+        return true;
+    }
+    const suppressBySeverity = configData.suppressBySeverity;
+    if (suppressBySeverity?.[ruleName] === 'off') {
+        return true;
+    }
+    const ruleConfiguracao = configData.rules?.[ruleName];
+    if (ruleConfiguracao) {
+        if (ruleConfiguracao.severity === 'off') {
+            return true;
+        }
+        if (ruleConfiguracao.exclude) {
+            for (const pattern of ruleConfiguracao.exclude) {
+                if (minimatch(normalizedCaminho, pattern, {
+                    dot: true
+                })) {
+                    return true;
+                }
+            }
+        }
+        if (ruleConfiguracao.allowTestFiles && isTestArquivo(normalizedCaminho, configData)) {
+            return true;
+        }
+    }
+    if (ruleName === 'tipo-inseguro' || ruleName === 'tipo-inseguro-any') {
+        const testPadroes = configData.testPadroes;
+        if (testPadroes?.allowAnyType && isTestArquivo(normalizedCaminho, configData)) {
+            return true;
+        }
+    }
+    return false;
+}
+export function isTestArquivo(fileCaminho, configData) {
+    const data = configData || config;
+    const testPadroes = data.testPadroes?.files || [
+        '**/*.test.*',
+        '**/*.spec.*',
+        'test/**/*',
+        'tests/**/*',
+        '**/__tests__/**',
+    ];
+    const normalizedCaminho = fileCaminho.replace(/\\/g, '/');
+    return testPadroes.some((pattern) => minimatch(normalizedCaminho, pattern, {
+        dot: true,
+    }));
+}
+export function getRuleSeverity(ruleName, fileCaminho) {
+    const configData = config;
+    if (isRuleSuppressed(ruleName, fileCaminho)) {
+        return undefined;
+    }
+    const ruleConfiguracao = configData.rules?.[ruleName];
+    if (ruleConfiguracao) {
+        if (ruleConfiguracao.severity === 'error')
+            return 'error';
+        if (ruleConfiguracao.severity === 'warning')
+            return 'warning';
+        if (ruleConfiguracao.severity === 'info')
+            return 'info';
+    }
+    const suppressBySeverity = configData.suppressBySeverity;
+    if (suppressBySeverity?.[ruleName]) {
+        const sev = suppressBySeverity[ruleName];
+        if (sev === 'error' || sev === 'warning' || sev === 'info') {
+            return sev;
+        }
+    }
+    return undefined;
+}
+export function shouldSuppressOccurrence(tipo, fileCaminho, _severity) {
+    const baseRuleNome = tipo.replace(/-(any|unknown|assertion|cast).*$/, '');
+    const rulesToCheck = [tipo, baseRuleNome];
+    return rulesToCheck.some(rule => isRuleSuppressed(rule, fileCaminho));
+}
+//# sourceMappingURL=rule-config.js.map

package/dist/shared/helpers/rule-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-config.js","sourceRoot":"","sources":["../../../src/shared/helpers/rule-config.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAStC,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,WAAmB;IAEpE,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAG/E,MAAM,UAAU,GAAG,MAQlB,CAAC;IACF,MAAM,aAAa,GAAG,UAAU,CAAC,aAAa,CAAC;IAC/C,IAAI,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,MAAM,kBAAkB,GAAG,UAAU,CAAC,kBAAkB,CAAC;IACzD,IAAI,kBAAkB,EAAE,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,MAAM,gBAAgB,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,gBAAgB,EAAE,CAAC;QACrB,IAAI,gBAAgB,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QACd,CAAC;QAGD,IAAI,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC7B,KAAK,MAAM,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,CAAC;gBAC/C,IAAI,SAAS,CAAC,iBAAiB,EAAE,OAAO,EAAE;oBACxC,GAAG,EAAE,IAAI;iBACV,CAAC,EAAE,CAAC;oBACH,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QAGD,IAAI,gBAAgB,CAAC,cAAc,IAAI,aAAa,CAAC,iBAAiB,EAAE,UAAU,CAAC,EAAE,CAAC;YACpF,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAGD,IAAI,QAAQ,KAAK,eAAe,IAAI,QAAQ,KAAK,mBAAmB,EAAE,CAAC;QACrE,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC3C,IAAI,WAAW,EAAE,YAAY,IAAI,aAAa,CAAC,iBAAiB,EAAE,UAAU,CAAC,EAAE,CAAC;YAC9E,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAGD,MAAM,UAAU,aAAa,CAC3B,WAAmB,EACnB,UAIC;IAED,MAAM,IAAI,GAAG,UAAU,IAAK,MAI1B,CAAC;IACH,MAAM,WAAW,GACf,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI;QACzB,aAAa;QACb,aAAa;QACb,WAAW;QACX,YAAY;QACZ,iBAAiB;KAClB,CAAC;IACJ,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC1D,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,OAAe,EAAE,EAAE,CAC1C,SAAS,CAAC,iBAAiB,EAAE,OAAO,EAAE;QACpC,GAAG,EAAE,IAAI;KACV,CAAC,CACH,CAAC;AACJ,CAAC;AAKD,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,WAAmB;IACnE,MAAM,UAAU,GAAG,MAGlB,CAAC;IAGF,IAAI,gBAAgB,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;IAGD,MAAM,gBAAgB,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,gBAAgB,EAAE,CAAC;QACrB,IAAI,gBAAgB,CAAC,QAAQ,KAAK,OAAO;YAAE,OAAO,OAAO,CAAC;QAC1D,IAAI,gBAAgB,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC9D,IAAI,gBAAgB,CAAC,QAAQ,KAAK,MAAM;YAAE,OAAO,MAAM,CAAC;IAC1D,CAAC;IAGD,MAAM,kBAAkB,GAAG,UAAU,CAAC,kBAAkB,CAAC;IACzD,IAAI,kBAAkB,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YAC3D,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAKD,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,WAAmB,EAAE,SAAkB;IAM5F,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,kCAAkC,EAAE,EAAE,CAAC,CAAC;IAG1E,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC1C,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;AACxE,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * Sistema de configuração granular de regras\n * Suporta:\n * - Regras por arquivo/diretório (glob patterns)\n * - Overrides específicos\n * - Severidade customizada\n * - Exclusões por padrão de arquivo\n */\n\nimport { config } from '@core/config';\nimport { minimatch } from 'minimatch';\n\nimport type { RuleConfig, RuleOverride } from '@';\n\nexport type { RuleConfig, RuleOverride };\n\n/**\n * Verifica se uma regra deve ser aplicada para um arquivo específico\n */\nexport function isRuleSuppressed(ruleName: string, fileCaminho: string): boolean {\n  // Normaliza o caminho do arquivo (remove ./ e normaliza barras)\n  const normalizedCaminho = fileCaminho.replace(/^\\.\\//, '').replace(/\\\\/g, '/');\n\n  // 1. Verifica suppressRules globais (config antigo - compatibilidade)\n  const configData = config as unknown as {\n    suppressRules?: string[];\n    suppressBySeverity?: Record<string, string>;\n    rules?: Record<string, RuleConfig>;\n    testPadroes?: {\n      files?: string[];\n      allowAnyType?: boolean;\n    };\n  };\n  const suppressRules = configData.suppressRules;\n  if (suppressRules?.includes(ruleName)) {\n    return true;\n  }\n\n  // 2. Verifica suppress.severity overrides (\"off\" suprime)\n  const suppressBySeverity = configData.suppressBySeverity;\n  if (suppressBySeverity?.[ruleName] === 'off') {\n    return true;\n  }\n\n  // 3. Verifica config.rules (novo sistema)\n  const ruleConfiguracao = configData.rules?.[ruleName];\n  if (ruleConfiguracao) {\n    if (ruleConfiguracao.severity === 'off') {\n      return true;\n    }\n\n    // Verifica se arquivo está em exclude patterns\n    if (ruleConfiguracao.exclude) {\n      for (const pattern of ruleConfiguracao.exclude) {\n        if (minimatch(normalizedCaminho, pattern, {\n          dot: true\n        })) {\n          return true;\n        }\n      }\n    }\n\n    // Verifica allowTestFiles para arquivos de teste\n    if (ruleConfiguracao.allowTestFiles && isTestArquivo(normalizedCaminho, configData)) {\n      return true;\n    }\n  }\n\n  // 4. Verifica padrões de teste globais (para tipo-inseguro em testes)\n  if (ruleName === 'tipo-inseguro' || ruleName === 'tipo-inseguro-any') {\n    const testPadroes = configData.testPadroes;\n    if (testPadroes?.allowAnyType && isTestArquivo(normalizedCaminho, configData)) {\n      return true;\n    }\n  }\n  return false;\n} /**\n * Verifica se um arquivo é de teste baseado nos padrões configurados\n */\nexport function isTestArquivo(\n  fileCaminho: string,\n  configData?: {\n    testPadroes?: {\n      files?: string[];\n    };\n  }\n): boolean {\n  const data = configData || (config as unknown as {\n    testPadroes?: {\n      files?: string[];\n    };\n  });\n  const testPadroes =\n    data.testPadroes?.files || [\n      '**/*.test.*',\n      '**/*.spec.*',\n      'test/**/*',\n      'tests/**/*',\n      '**/__tests__/**',\n    ];\n  const normalizedCaminho = fileCaminho.replace(/\\\\/g, '/');\n  return testPadroes.some((pattern: string) =>\n    minimatch(normalizedCaminho, pattern, {\n      dot: true,\n    }),\n  );\n}\n\n/**\n * Obtém a severidade configurada para uma regra\n */\nexport function getRuleSeverity(ruleName: string, fileCaminho: string): 'error' | 'warning' | 'info' | undefined {\n  const configData = config as unknown as {\n    suppressBySeverity?: Record<string, string>;\n    rules?: Record<string, RuleConfig>;\n  };\n\n  // Se regra está suprimida, retorna undefined\n  if (isRuleSuppressed(ruleName, fileCaminho)) {\n    return undefined;\n  }\n\n  // 1. Verifica config.rules primeiro (mais específico)\n  const ruleConfiguracao = configData.rules?.[ruleName];\n  if (ruleConfiguracao) {\n    if (ruleConfiguracao.severity === 'error') return 'error';\n    if (ruleConfiguracao.severity === 'warning') return 'warning';\n    if (ruleConfiguracao.severity === 'info') return 'info';\n  }\n\n  // 2. Verifica suppress.severity overrides\n  const suppressBySeverity = configData.suppressBySeverity;\n  if (suppressBySeverity?.[ruleName]) {\n    const sev = suppressBySeverity[ruleName];\n    if (sev === 'error' || sev === 'warning' || sev === 'info') {\n      return sev;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Verifica se uma ocorrência deve ser suprimida baseado na configuração\n */\nexport function shouldSuppressOccurrence(tipo: string, fileCaminho: string, _severity?: string): boolean {\n  // Extrai o nome base da regra\n  // tipo-inseguro-any -> tipo-inseguro\n  // tipo-inseguro-any-assertion -> tipo-inseguro\n  // tipo-inseguro-any-cast -> tipo-inseguro\n  // tipo-inseguro-unknown -> tipo-inseguro\n  const baseRuleNome = tipo.replace(/-(any|unknown|assertion|cast).*$/, '');\n\n  // Verifica supressão para regra base e variantes\n  const rulesToCheck = [tipo, baseRuleNome];\n  return rulesToCheck.some(rule => isRuleSuppressed(rule, fileCaminho));\n}"]}

package/dist/shared/helpers/structural-hash.d.ts

@@ -0,0 +1,6 @@
+import type { NodePath } from '@babel/traverse';
+import type { Node } from '@babel/types';
+type AstNode = NodePath<Node> | object | null | undefined;
+export declare function calcularHashEstrutural(ast: AstNode, content?: string): string;
+export {};
+//# sourceMappingURL=structural-hash.d.ts.map

package/dist/shared/helpers/structural-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-hash.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/structural-hash.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAGzC,KAAK,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAyM1D,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAe7E"}

package/dist/shared/helpers/structural-hash.js

@@ -0,0 +1,205 @@
+import XXH from 'xxhashjs';
+function toRecord(valor) {
+    if (typeof valor === 'object' && valor !== null && !Array.isArray(valor)) {
+        return valor;
+    }
+    return undefined;
+}
+function isNodePath(ast) {
+    return typeof ast === 'object' && ast !== null && 'node' in ast;
+}
+const RE_FUNCAO = /^\s*(?:export\s+)?(?:async\s+)?function\s+\*?\s*(\w+)\s*\(/gm;
+const RE_CLASSE = /^\s*(?:export\s+)?class\s+(\w+)/gm;
+const RE_IMPORT = /^\s*import\s+(?:\{[^}]*\}\s*|[\w*]\s*,?\s*)?from\s+['"]([^'"]+)['"]/gm;
+const RE_EXPORT_FUNCAO = /^\s*export\s+(?:async\s+)?function\s+\*?\s*(\w+)/gm;
+const RE_EXPORT_CLASSE = /^\s*export\s+class\s+(\w+)/gm;
+const RE_EXPORT_VAR = /^\s*export\s+(?:const|let|var)\s+(\w+)/gm;
+const RE_EXPORT_DEFAULT = /^\s*export\s+default\s+(?:function|class)\s+(\w+)/gm;
+const RE_INTERFACE = /^\s*(?:export\s+)?interface\s+(\w+)/gm;
+const RE_TYPE = /^\s*(?:export\s+)?type\s+(\w+)\s*=/gm;
+const RE_ENUM = /^\s*(?:export\s+)?enum\s+(\w+)/gm;
+function extrairEstrutura(ast) {
+    const elementos = [];
+    if (!ast || typeof ast !== 'object')
+        return elementos;
+    const node = isNodePath(ast) ? ast.node : ast;
+    if (!node || typeof node !== 'object')
+        return elementos;
+    const nodeRecord = toRecord(node);
+    if (!nodeRecord || nodeRecord.type !== 'File' || !nodeRecord.program)
+        return elementos;
+    const program = toRecord(nodeRecord.program);
+    if (!program)
+        return elementos;
+    const body = Array.isArray(program.body) ? program.body : [];
+    for (const stmt of body) {
+        const tipo = String(stmt.type || '');
+        const stmtRecord = toRecord(stmt);
+        if (!stmtRecord)
+            continue;
+        switch (tipo) {
+            case 'ImportDeclaration': {
+                const sourceRec = toRecord(stmtRecord.source);
+                if (sourceRec && typeof sourceRec.value === 'string') {
+                    elementos.push(`import:${sourceRec.value}`);
+                }
+                break;
+            }
+            case 'ExportNamedDeclaration':
+            case 'ExportDefaultDeclaration': {
+                const decl = toRecord(stmtRecord.declaration);
+                if (decl && decl.type === 'FunctionDeclaration') {
+                    const idObj = toRecord(decl.id);
+                    if (idObj && typeof idObj.name === 'string') {
+                        elementos.push(`export:function:${idObj.name}`);
+                    }
+                    else {
+                        elementos.push('export:function:anonymous');
+                    }
+                }
+                else if (decl && decl.type === 'ClassDeclaration') {
+                    const idObj = toRecord(decl.id);
+                    if (idObj && typeof idObj.name === 'string') {
+                        elementos.push(`export:class:${idObj.name}`);
+                    }
+                }
+                else if (decl && decl.type === 'VariableDeclaration') {
+                    const vars = extractVariableNames(decl);
+                    for (const v of vars)
+                        elementos.push(`export:var:${v}`);
+                }
+                else if (stmtRecord.type === 'ExportDefaultDeclaration') {
+                    elementos.push('export:default');
+                }
+                else {
+                    elementos.push('export:named');
+                }
+                break;
+            }
+            case 'FunctionDeclaration': {
+                const idObj = toRecord(stmtRecord.id);
+                if (idObj && typeof idObj.name === 'string') {
+                    elementos.push(`function:${idObj.name}`);
+                }
+                break;
+            }
+            case 'ClassDeclaration': {
+                const idObj = toRecord(stmtRecord.id);
+                if (idObj && typeof idObj.name === 'string') {
+                    elementos.push(`class:${idObj.name}`);
+                }
+                break;
+            }
+            case 'VariableDeclaration': {
+                const vars = extractVariableNames(stmtRecord);
+                for (const v of vars)
+                    elementos.push(`var:${v}`);
+                break;
+            }
+            case 'TSTypeAliasDeclaration':
+            case 'TypeAlias': {
+                const idObj = toRecord(stmtRecord.id);
+                if (idObj && typeof idObj.name === 'string') {
+                    elementos.push(`type:${idObj.name}`);
+                }
+                break;
+            }
+            case 'TSInterfaceDeclaration':
+            case 'InterfaceDeclaration': {
+                const idObj = toRecord(stmtRecord.id);
+                if (idObj && typeof idObj.name === 'string') {
+                    elementos.push(`interface:${idObj.name}`);
+                }
+                break;
+            }
+            case 'TSEnumDeclaration':
+            case 'EnumDeclaration': {
+                const idObj = toRecord(stmtRecord.id);
+                if (idObj && typeof idObj.name === 'string') {
+                    elementos.push(`enum:${idObj.name}`);
+                }
+                break;
+            }
+            case 'ExportAllDeclaration': {
+                const sourceRec = toRecord(stmtRecord.source);
+                if (sourceRec && typeof sourceRec.value === 'string') {
+                    elementos.push(`export-all:${sourceRec.value}`);
+                }
+                break;
+            }
+        }
+    }
+    return elementos.sort();
+}
+function extractVariableNames(decl) {
+    const names = [];
+    const declarations = Array.isArray(decl.declarations) ? decl.declarations : [];
+    for (const d of declarations) {
+        const idObj = toRecord(d);
+        if (idObj && typeof idObj.name === 'string') {
+            names.push(idObj.name);
+        }
+    }
+    return names;
+}
+function extrairEstruturaDoConteudo(content) {
+    const elementos = [];
+    const seen = new Set();
+    function add(el) {
+        if (!seen.has(el)) {
+            seen.add(el);
+            elementos.push(el);
+        }
+    }
+    let match;
+    while ((match = RE_FUNCAO.exec(content)) !== null)
+        add(`function:${match[1]}`);
+    while ((match = RE_CLASSE.exec(content)) !== null)
+        add(`class:${match[1]}`);
+    while ((match = RE_IMPORT.exec(content)) !== null)
+        add(`import:${match[1]}`);
+    while ((match = RE_EXPORT_FUNCAO.exec(content)) !== null)
+        add(`export:function:${match[1]}`);
+    while ((match = RE_EXPORT_CLASSE.exec(content)) !== null)
+        add(`export:class:${match[1]}`);
+    while ((match = RE_EXPORT_VAR.exec(content)) !== null)
+        add(`export:var:${match[1]}`);
+    while ((match = RE_EXPORT_DEFAULT.exec(content)) !== null)
+        add(`export:default:${match[1]}`);
+    while ((match = RE_INTERFACE.exec(content)) !== null)
+        add(`interface:${match[1]}`);
+    while ((match = RE_TYPE.exec(content)) !== null)
+        add(`type:${match[1]}`);
+    while ((match = RE_ENUM.exec(content)) !== null)
+        add(`enum:${match[1]}`);
+    return elementos.sort();
+}
+function hashString(str) {
+    try {
+        return XXH.h64(str, 0xdef).toString(16);
+    }
+    catch {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            hash = ((hash << 5) - hash) + str.charCodeAt(i);
+            hash |= 0;
+        }
+        return (hash >>> 0).toString(16);
+    }
+}
+export function calcularHashEstrutural(ast, content) {
+    let estrutura;
+    if (ast && typeof ast === 'object') {
+        estrutura = extrairEstrutura(ast);
+    }
+    else {
+        estrutura = [];
+    }
+    if (estrutura.length === 0 && content) {
+        estrutura = extrairEstruturaDoConteudo(content);
+    }
+    if (estrutura.length === 0)
+        return '';
+    return hashString(estrutura.join('|'));
+}
+//# sourceMappingURL=structural-hash.js.map

package/dist/shared/helpers/structural-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-hash.js","sourceRoot":"","sources":["../../../src/shared/helpers/structural-hash.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\nimport type { NodePath } from '@babel/traverse';\nimport type { Node } from '@babel/types';\nimport XXH from 'xxhashjs';\n\ntype AstNode = NodePath<Node> | object | null | undefined;\n\nfunction toRecord(valor: unknown): Record<string, unknown> | undefined {\n  if (typeof valor === 'object' && valor !== null && !Array.isArray(valor)) {\n    return valor as Record<string, unknown>;\n  }\n  return undefined;\n}\n\nfunction isNodePath(ast: AstNode): ast is NodePath<Node> {\n  return typeof ast === 'object' && ast !== null && 'node' in ast;\n}\n\n// Regex para extração estrutural baseada em conteúdo (fallback quando AST não está disponível)\n// Captura declarações de função, classe, import, export, interface, type, enum\nconst RE_FUNCAO = /^\\s*(?:export\\s+)?(?:async\\s+)?function\\s+\\*?\\s*(\\w+)\\s*\\(/gm;\nconst RE_CLASSE = /^\\s*(?:export\\s+)?class\\s+(\\w+)/gm;\nconst RE_IMPORT = /^\\s*import\\s+(?:\\{[^}]*\\}\\s*|[\\w*]\\s*,?\\s*)?from\\s+['\"]([^'\"]+)['\"]/gm;\nconst RE_EXPORT_FUNCAO = /^\\s*export\\s+(?:async\\s+)?function\\s+\\*?\\s*(\\w+)/gm;\nconst RE_EXPORT_CLASSE = /^\\s*export\\s+class\\s+(\\w+)/gm;\nconst RE_EXPORT_VAR = /^\\s*export\\s+(?:const|let|var)\\s+(\\w+)/gm;\nconst RE_EXPORT_DEFAULT = /^\\s*export\\s+default\\s+(?:function|class)\\s+(\\w+)/gm;\nconst RE_INTERFACE = /^\\s*(?:export\\s+)?interface\\s+(\\w+)/gm;\nconst RE_TYPE = /^\\s*(?:export\\s+)?type\\s+(\\w+)\\s*=/gm;\nconst RE_ENUM = /^\\s*(?:export\\s+)?enum\\s+(\\w+)/gm;\n\n/**\n * Extrai uma assinatura estrutural do AST, ignorando detalhes de implementação.\n * Apenas nós estruturais de alto nível são considerados: declarações de função,\n * classes, imports, exports, interfaces, tipos.\n *\n * Mudanças de formatação, comentários, ou implementação interna (corpo de funções)\n * NÃO alteram a assinatura estrutural.\n */\nfunction extrairEstrutura(ast: AstNode): string[] {\n  const elementos: string[] = [];\n  if (!ast || typeof ast !== 'object') return elementos;\n\n  const node = isNodePath(ast) ? ast.node : ast;\n  if (!node || typeof node !== 'object') return elementos;\n\n  const nodeRecord = toRecord(node);\n  if (!nodeRecord || nodeRecord.type !== 'File' || !nodeRecord.program) return elementos;\n\n  const program = toRecord(nodeRecord.program);\n  if (!program) return elementos;\n  const body = Array.isArray(program.body) ? program.body as Record<string, unknown>[] : [];\n\n  for (const stmt of body) {\n    const tipo = String(stmt.type || '');\n    const stmtRecord = toRecord(stmt);\n    if (!stmtRecord) continue;\n\n    switch (tipo) {\n      case 'ImportDeclaration': {\n        const sourceRec = toRecord(stmtRecord.source);\n        if (sourceRec && typeof sourceRec.value === 'string') {\n          elementos.push(`import:${sourceRec.value}`);\n        }\n        break;\n      }\n      case 'ExportNamedDeclaration':\n      case 'ExportDefaultDeclaration': {\n        const decl = toRecord(stmtRecord.declaration);\n        if (decl && decl.type === 'FunctionDeclaration') {\n          const idObj = toRecord(decl.id);\n          if (idObj && typeof idObj.name === 'string') {\n            elementos.push(`export:function:${idObj.name}`);\n          } else {\n            elementos.push('export:function:anonymous');\n          }\n        } else if (decl && decl.type === 'ClassDeclaration') {\n          const idObj = toRecord(decl.id);\n          if (idObj && typeof idObj.name === 'string') {\n            elementos.push(`export:class:${idObj.name}`);\n          }\n        } else if (decl && decl.type === 'VariableDeclaration') {\n          const vars = extractVariableNames(decl);\n          for (const v of vars) elementos.push(`export:var:${v}`);\n        } else if (stmtRecord.type === 'ExportDefaultDeclaration') {\n          elementos.push('export:default');\n        } else {\n          elementos.push('export:named');\n        }\n        break;\n      }\n      case 'FunctionDeclaration': {\n        const idObj = toRecord(stmtRecord.id);\n        if (idObj && typeof idObj.name === 'string') {\n          elementos.push(`function:${idObj.name}`);\n        }\n        break;\n      }\n      case 'ClassDeclaration': {\n        const idObj = toRecord(stmtRecord.id);\n        if (idObj && typeof idObj.name === 'string') {\n          elementos.push(`class:${idObj.name}`);\n        }\n        break;\n      }\n      case 'VariableDeclaration': {\n        const vars = extractVariableNames(stmtRecord);\n        for (const v of vars) elementos.push(`var:${v}`);\n        break;\n      }\n      case 'TSTypeAliasDeclaration':\n      case 'TypeAlias': {\n        const idObj = toRecord(stmtRecord.id);\n        if (idObj && typeof idObj.name === 'string') {\n          elementos.push(`type:${idObj.name}`);\n        }\n        break;\n      }\n      case 'TSInterfaceDeclaration':\n      case 'InterfaceDeclaration': {\n        const idObj = toRecord(stmtRecord.id);\n        if (idObj && typeof idObj.name === 'string') {\n          elementos.push(`interface:${idObj.name}`);\n        }\n        break;\n      }\n      case 'TSEnumDeclaration':\n      case 'EnumDeclaration': {\n        const idObj = toRecord(stmtRecord.id);\n        if (idObj && typeof idObj.name === 'string') {\n          elementos.push(`enum:${idObj.name}`);\n        }\n        break;\n      }\n      case 'ExportAllDeclaration': {\n        const sourceRec = toRecord(stmtRecord.source);\n        if (sourceRec && typeof sourceRec.value === 'string') {\n          elementos.push(`export-all:${sourceRec.value}`);\n        }\n        break;\n      }\n    }\n  }\n\n  return elementos.sort();\n}\n\nfunction extractVariableNames(decl: Record<string, unknown>): string[] {\n  const names: string[] = [];\n  const declarations = Array.isArray(decl.declarations) ? decl.declarations as Record<string, unknown>[] : [];\n  for (const d of declarations) {\n    const idObj = toRecord(d);\n    if (idObj && typeof idObj.name === 'string') {\n      names.push(idObj.name);\n    }\n  }\n  return names;\n}\n\n/**\n * Extrai elementos estruturais do conteúdo usando regex (fallback quando AST não disponível)\n */\nfunction extrairEstruturaDoConteudo(content: string): string[] {\n  const elementos: string[] = [];\n  const seen = new Set<string>();\n\n  function add(el: string) {\n    if (!seen.has(el)) { seen.add(el); elementos.push(el); }\n  }\n\n  let match: RegExpExecArray | null;\n  while ((match = RE_FUNCAO.exec(content)) !== null) add(`function:${match[1]}`);\n  while ((match = RE_CLASSE.exec(content)) !== null) add(`class:${match[1]}`);\n  while ((match = RE_IMPORT.exec(content)) !== null) add(`import:${match[1]}`);\n  while ((match = RE_EXPORT_FUNCAO.exec(content)) !== null) add(`export:function:${match[1]}`);\n  while ((match = RE_EXPORT_CLASSE.exec(content)) !== null) add(`export:class:${match[1]}`);\n  while ((match = RE_EXPORT_VAR.exec(content)) !== null) add(`export:var:${match[1]}`);\n  while ((match = RE_EXPORT_DEFAULT.exec(content)) !== null) add(`export:default:${match[1]}`);\n  while ((match = RE_INTERFACE.exec(content)) !== null) add(`interface:${match[1]}`);\n  while ((match = RE_TYPE.exec(content)) !== null) add(`type:${match[1]}`);\n  while ((match = RE_ENUM.exec(content)) !== null) add(`enum:${match[1]}`);\n\n  return elementos.sort();\n}\n\nfunction hashString(str: string): string {\n  try {\n    return XXH.h64(str, 0xdef).toString(16);\n  } catch {\n    let hash = 0;\n    for (let i = 0; i < str.length; i++) {\n      hash = ((hash << 5) - hash) + str.charCodeAt(i);\n      hash |= 0;\n    }\n    return (hash >>> 0).toString(16);\n  }\n}\n\n/**\n * Calcula um hash estrutural do AST ou conteúdo do arquivo.\n * Ignora detalhes de implementação (corpo de funções, formatação, comentários).\n * Retorna string vazia se não for possível extrair estrutura.\n *\n * @param ast - AST do arquivo (se disponível)\n * @param content - Conteúdo do arquivo (fallback quando AST não disponível ou é sentinela)\n */\nexport function calcularHashEstrutural(ast: AstNode, content?: string): string {\n  let estrutura: string[];\n\n  if (ast && typeof ast === 'object') {\n    estrutura = extrairEstrutura(ast);\n  } else {\n    estrutura = [];\n  }\n\n  if (estrutura.length === 0 && content) {\n    estrutura = extrairEstruturaDoConteudo(content);\n  }\n\n  if (estrutura.length === 0) return '';\n  return hashString(estrutura.join('|'));\n}\n"]}

package/dist/shared/helpers/structure.d.ts

@@ -0,0 +1,16 @@
+import type { NomeacaoEstilo, OpcoesEstrategista, ParseNomeResultado } from '../../types/index.js';
+export type { NomeacaoEstilo, OpcoesEstrategista, ParseNomeResultado };
+export declare const CATEGORIAS_PADRAO: Required<NonNullable<OpcoesEstrategista['categoriasMapa']>>;
+export declare const PADRAO_OPCOES: Required<Pick<OpcoesEstrategista, 'raizCodigo' | 'criarSubpastasPorEntidade' | 'apenasCategoriasConfiguradas' | 'categoriasMapa' | 'ignorarPastas'>> & Pick<OpcoesEstrategista, 'estiloPreferido'>;
+export declare const PRESETS: Record<string, Partial<typeof PADRAO_OPCOES> & {
+    nome: string;
+}>;
+export declare function deveIgnorar(rel: string, ignorar: string[]): boolean;
+export declare function parseNomeArquivo(baseNome: string): ParseNomeResultado;
+export declare function destinoPara(relPath: string, raizCodigo: string, criarSubpastasPorEntidade: boolean, apenasCategoriasConfiguradas: boolean, categoriasMapa: Record<string, string>): {
+    destinoDir: string | null;
+    motivo?: string;
+};
+export declare function normalizarRel(relPath: string): string;
+export declare function carregarConfigEstrategia(baseDir: string, overrides?: OpcoesEstrategista): Promise<Required<typeof PADRAO_OPCOES>>;
+//# sourceMappingURL=structure.d.ts.map

package/dist/shared/helpers/structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/structure.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,GAAG,CAAC;AAGhF,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;AACvE,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,WAAW,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CA0DzF,CAAC;AACF,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,YAAY,GAAG,2BAA2B,GAAG,8BAA8B,GAAG,gBAAgB,GAAG,eAAe,CAAC,CAAC,GAAG,IAAI,CAAC,kBAAkB,EAAE,iBAAiB,CAO5N,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,aAAa,CAAC,GAAG;IACnE,IAAI,EAAE,MAAM,CAAC;CACd,CAqEA,CAAC;AACF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAuBnE;AACD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAyCrE;AACD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,yBAAyB,EAAE,OAAO,EAAE,4BAA4B,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IACnL,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAgCA;AACD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AACD,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,aAAa,CAAC,CAAC,CA2BvI"}