@mocoto/mahoraga 0.14.0

package/dist/analysts/python/scorers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './scorer-python.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/analysts/python/scorers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/analysts/python/scorers/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC"}

package/dist/analysts/python/scorers/index.js

@@ -0,0 +1,2 @@
+export * from './scorer-python.js';
+//# sourceMappingURL=index.js.map

package/dist/analysts/python/scorers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/analysts/python/scorers/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\nexport * from './scorer-python.js';\n"]}

package/dist/analysts/python/scorers/scorer-python.d.ts

@@ -0,0 +1,15 @@
+export interface PythonScoreResult {
+    score: number;
+    maxScore: number;
+    percentage: number;
+    issues: string[];
+    strengths: string[];
+}
+export declare function pontuarPython(src: string, _relPath: string): PythonScoreResult;
+export declare const pontuadorPython: {
+    nome: string;
+    categoria: string;
+    descricao: string;
+    pontuar: typeof pontuarPython;
+};
+//# sourceMappingURL=scorer-python.d.ts.map

package/dist/analysts/python/scorers/scorer-python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer-python.d.ts","sourceRoot":"","sources":["../../../../src/analysts/python/scorers/scorer-python.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CA2E9E;AAED,eAAO,MAAM,eAAe;;;;;CAK3B,CAAC"}

package/dist/analysts/python/scorers/scorer-python.js

@@ -0,0 +1,79 @@
+import { maskPythonComments, splitLines } from '../../../shared/helpers/index.js';
+export function pontuarPython(src, _relPath) {
+    let score = 0;
+    const maxScore = 100;
+    const issues = [];
+    const strengths = [];
+    const scan = maskPythonComments(src);
+    const _linhas = splitLines(scan);
+    const srcCompleto = scan;
+    const funcs = (srcCompleto.match(/def\s+\w+/g) || []).length;
+    const funcsWithHints = (srcCompleto.match(/def\s+\w+\s*\([^)]*\)\s*->/g) || []).length;
+    if (funcs > 0) {
+        const ratio = funcsWithHints / funcs;
+        score += Math.round(ratio * 25);
+        if (ratio > 0.8)
+            strengths.push('Boa cobertura de type hints');
+        else if (ratio > 0.5)
+            issues.push('Type hints parciais');
+        else
+            issues.push('Poucas funções com type hints');
+    }
+    else {
+        score += 25;
+    }
+    if (!/\b(eval|exec)\s*\(/.test(srcCompleto)) {
+        score += 20;
+        strengths.push('Sem uso de eval/exec');
+    }
+    else {
+        issues.push('eval/exec detectado - risco de segurança');
+    }
+    const bareExcept = (srcCompleto.match(/^\s*except\s*:/gm) || []).length;
+    if (bareExcept === 0) {
+        score += 20;
+        strengths.push('Error handling adequado');
+    }
+    else {
+        score += Math.max(0, 20 - bareExcept * 5);
+        issues.push(`${bareExcept} bare except(s) detectado(s)`);
+    }
+    const mutableDefaults = (srcCompleto.match(/def\s+\w+\s*\([^)]*=\s*(?:\[|\{)/g) || []).length;
+    if (mutableDefaults === 0) {
+        score += 15;
+        strengths.push('Sem argumentos default mutáveis');
+    }
+    else {
+        issues.push(`${mutableDefaults} função(ões) com default mutável`);
+    }
+    const printCount = (srcCompleto.match(/^\s*print\s*\(/gm) || []).length;
+    const loggingCount = (srcCompleto.match(/logging\.\w+\(/g) || []).length;
+    if (printCount === 0 || loggingCount > printCount) {
+        score += 10;
+        strengths.push('Uso adequado de logging');
+    }
+    else {
+        issues.push(`${printCount} print(s) - considere usar logging`);
+    }
+    if (!/subprocess.*shell\s*=\s*True/.test(srcCompleto)) {
+        score += 10;
+        strengths.push('Sem subprocess com shell=True');
+    }
+    else {
+        issues.push('subprocess com shell=True detectado');
+    }
+    return {
+        score,
+        maxScore,
+        percentage: Math.round((score / maxScore) * 100),
+        issues,
+        strengths
+    };
+}
+export const pontuadorPython = {
+    nome: 'pontuador-python',
+    categoria: 'framework',
+    descricao: 'Pontua qualidade de código Python',
+    pontuar: pontuarPython
+};
+//# sourceMappingURL=scorer-python.js.map

package/dist/analysts/python/scorers/scorer-python.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer-python.js","sourceRoot":"","sources":["../../../../src/analysts/python/scorers/scorer-python.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * [GRAFICO] Pontuador de qualidade Python\n *\n * Avalia a qualidade do código Python baseado em:\n * - Type hints coverage\n * - Security issues\n * - Error handling\n * - Code organization\n */\n\nimport { maskPythonComments, splitLines } from '@shared/helpers';\n\nexport interface PythonScoreResult {\n  score: number;\n  maxScore: number;\n  percentage: number;\n  issues: string[];\n  strengths: string[];\n}\n\nexport function pontuarPython(src: string, _relPath: string): PythonScoreResult {\n  let score = 0;\n  const maxScore = 100;\n  const issues: string[] = [];\n  const strengths: string[] = [];\n\n  const scan = maskPythonComments(src);\n  const _linhas = splitLines(scan);\n  const srcCompleto = scan;\n\n  // Type hints (25 pontos)\n  const funcs = (srcCompleto.match(/def\\s+\\w+/g) || []).length;\n  const funcsWithHints = (srcCompleto.match(/def\\s+\\w+\\s*\\([^)]*\\)\\s*->/g) || []).length;\n  if (funcs > 0) {\n    const ratio = funcsWithHints / funcs;\n    score += Math.round(ratio * 25);\n    if (ratio > 0.8) strengths.push('Boa cobertura de type hints');\n    else if (ratio > 0.5) issues.push('Type hints parciais');\n    else issues.push('Poucas funções com type hints');\n  } else {\n    score += 25;\n  }\n\n  // Sem eval/exec (20 pontos)\n  if (!/\\b(eval|exec)\\s*\\(/.test(srcCompleto)) {\n    score += 20;\n    strengths.push('Sem uso de eval/exec');\n  } else {\n    issues.push('eval/exec detectado - risco de segurança');\n  }\n\n  // Error handling (20 pontos)\n  const bareExcept = (srcCompleto.match(/^\\s*except\\s*:/gm) || []).length;\n  if (bareExcept === 0) {\n    score += 20;\n    strengths.push('Error handling adequado');\n  } else {\n    score += Math.max(0, 20 - bareExcept * 5);\n    issues.push(`${bareExcept} bare except(s) detectado(s)`);\n  }\n\n  // Sem mutable defaults (15 pontos)\n  const mutableDefaults = (srcCompleto.match(/def\\s+\\w+\\s*\\([^)]*=\\s*(?:\\[|\\{)/g) || []).length;\n  if (mutableDefaults === 0) {\n    score += 15;\n    strengths.push('Sem argumentos default mutáveis');\n  } else {\n    issues.push(`${mutableDefaults} função(ões) com default mutável`);\n  }\n\n  // Logging ao invés de print (10 pontos)\n  const printCount = (srcCompleto.match(/^\\s*print\\s*\\(/gm) || []).length;\n  const loggingCount = (srcCompleto.match(/logging\\.\\w+\\(/g) || []).length;\n  if (printCount === 0 || loggingCount > printCount) {\n    score += 10;\n    strengths.push('Uso adequado de logging');\n  } else {\n    issues.push(`${printCount} print(s) - considere usar logging`);\n  }\n\n  // Sem subprocess shell=True (10 pontos)\n  if (!/subprocess.*shell\\s*=\\s*True/.test(srcCompleto)) {\n    score += 10;\n    strengths.push('Sem subprocess com shell=True');\n  } else {\n    issues.push('subprocess com shell=True detectado');\n  }\n\n  return {\n    score,\n    maxScore,\n    percentage: Math.round((score / maxScore) * 100),\n    issues,\n    strengths\n  };\n}\n\nexport const pontuadorPython = {\n  nome: 'pontuador-python',\n  categoria: 'framework',\n  descricao: 'Pontua qualidade de código Python',\n  pontuar: pontuarPython\n};\n"]}

package/dist/analysts/react/analysts/analyst-react-hooks.d.ts

@@ -0,0 +1,12 @@
+import { criarOcorrencia } from '../../../types/index.js';
+type Msg = ReturnType<typeof criarOcorrencia>;
+export declare const analistaReactHooks: {
+    nome: string;
+    categoria: string;
+    descricao: string;
+    global: false;
+    test: (relPath: string) => boolean;
+    aplicar: (src: string, relPath: string) => Promise<Msg[] | null>;
+};
+export {};
+//# sourceMappingURL=analyst-react-hooks.d.ts.map

package/dist/analysts/react/analysts/analyst-react-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst-react-hooks.d.ts","sourceRoot":"","sources":["../../../../src/analysts/react/analysts/analyst-react-hooks.ts"],"names":[],"mappings":"AASA,OAAO,EAAiB,eAAe,EAAE,MAAM,GAAG,CAAC;AAGnD,KAAK,GAAG,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAmR9C,eAAO,MAAM,kBAAkB;;;;;oBAKb,MAAM,KAAG,OAAO;+CACD,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;CAoBpD,CAAC"}

package/dist/analysts/react/analysts/analyst-react-hooks.js

@@ -0,0 +1,304 @@
+import { parse as babelParse } from '@babel/parser';
+import traverse from '@babel/traverse';
+import * as t from '@babel/types';
+import { messages } from '../../../core/messages/index.js';
+import { createLineLookup } from '../../../shared/helpers/index.js';
+import { criarAnalista, criarOcorrencia } from '../../../types/index.js';
+const disableEnv = process.env.MAHORAGA_DISABLE_PLUGIN_REACT_HOOKS === '1';
+function hasHooksUsage(src) {
+    return /use(State|Effect|Memo|Callback|Reducer|Ref|LayoutEffect|ImperativeHandle|Transition|DeferredValue|SyncExternalStore|InsertionEffect|Id|DebugValue)/.test(src);
+}
+function warn(message, relPath, line, nivel = messages.SeverityNiveis.warning) {
+    return criarOcorrencia({
+        relPath,
+        mensagem: message,
+        linha: line,
+        nivel,
+        origem: messages.AnalystOrigens.reactHooks,
+        tipo: messages.AnalystTipos.reactHooks
+    });
+}
+function extractHookCallContent(src, startIndex) {
+    let depth = 0;
+    let started = false;
+    let content = '';
+    for (let i = startIndex; i < src.length; i++) {
+        const char = src[i];
+        if (char === '(') {
+            depth++;
+            started = true;
+        }
+        else if (char === ')') {
+            depth--;
+        }
+        if (started)
+            content += char;
+        if (started && depth === 0)
+            break;
+    }
+    return content;
+}
+function collectHookIssues(src, relPath) {
+    const ocorrencias = [];
+    const lineOf = createLineLookup(src).lineAt;
+    const effectMatches = [...src.matchAll(/use(Layout)?Effect\s*\(/g)];
+    effectMatches.forEach(m => {
+        const hookInicio = m.index ?? 0;
+        const fullCall = extractHookCallContent(src, hookInicio + m[0].length - 1);
+        const hasDepsArg = /,\s*(\[[\s\S]*?\]|\w+)\s*\)$/.test(fullCall);
+        const skip = /no-deps-ok|eslint-disable-next-line\s+react-hooks\/exhaustive-deps/i.test(fullCall);
+        if (!hasDepsArg && !skip) {
+            const line = lineOf(hookInicio);
+            ocorrencias.push(warn(messages.ReactHooksMensagens.useEffectNoDeps, relPath, line));
+        }
+        if (hasDepsArg && /\[\s*\]/.test(fullCall)) {
+            const bodyWithRefs = fullCall.match(/^[\s\S]*?(?=,\s*\[)/);
+            if (bodyWithRefs) {
+                const varRefs = bodyWithRefs[0].match(/\b([a-z]\w+)\b/g) || [];
+                const nonTrivialRefs = varRefs.filter(v => !/^(set|use)/.test(v) && v.length > 1 && !['undefined', 'null', 'true', 'false'].includes(v));
+                if (nonTrivialRefs.length > 0) {
+                    const line = lineOf(hookInicio);
+                    ocorrencias.push(warn('Empty deps array but effect references component variables', relPath, line));
+                }
+            }
+        }
+    });
+    const memoMatches = [...src.matchAll(/use(Memo|Callback)\s*\(/g)];
+    memoMatches.forEach(m => {
+        const hookInicio = m.index ?? 0;
+        const fullCall = extractHookCallContent(src, hookInicio + m[0].length - 1);
+        const hasDepsArg = /,\s*(\[[\s\S]*?\]|\w+)\s*\)$/.test(fullCall);
+        const skip = /no-deps-ok|eslint-disable-next-line\s+react-hooks\/exhaustive-deps/i.test(fullCall);
+        if (!hasDepsArg && !skip) {
+            const line = lineOf(hookInicio);
+            ocorrencias.push(warn(messages.ReactHooksMensagens.memoCallbackNoDeps, relPath, line));
+        }
+    });
+    const conditionalHooks = [...src.matchAll(/(if|for|while)\s*\([^)]*\)\s*\{[\s\S]{0,160}?use[A-Z][A-Za-z0-9_]*/g)];
+    conditionalHooks.forEach(m => {
+        const line = lineOf(m.index || 0);
+        ocorrencias.push(warn(messages.ReactHooksMensagens.hookInConditional, relPath, line));
+    });
+    const customHooks = [...src.matchAll(/\buse[A-Z][A-Za-z0-9_]*\s*=\s*\(/g)];
+    customHooks.forEach(m => {
+        const hookName = m[0].replace(/\s*=\s*\(/, '');
+        if (!/^(useState|useEffect|useMemo|useCallback|useRef|useContext|useReducer|useLayoutEffect|useImperativeHandle|useDebugValue|useDeferredValue|useTransition|useSyncExternalStore|useInsertionEffect|useId)$/.test(hookName)) {
+            if (/^use[A-Z]/.test(hookName)) {
+                const line = lineOf(m.index || 0);
+                ocorrencias.push(warn(`Custom hook '${hookName}' - verify naming follows useXxx convention`, relPath, line));
+            }
+        }
+    });
+    return ocorrencias;
+}
+const traverseFn = traverse;
+function parseHooksWithBabel(src, relPath) {
+    const lower = relPath.toLowerCase();
+    const isTs = lower.endsWith('.ts') || lower.endsWith('.tsx');
+    const isJsxLike = lower.endsWith('.tsx') || lower.endsWith('.jsx');
+    try {
+        const plugins = ['decorators-legacy'];
+        if (isTs)
+            plugins.unshift('typescript');
+        if (isJsxLike)
+            plugins.unshift('jsx');
+        const ast = babelParse(src, { sourceType: 'unambiguous', errorRecovery: true, plugins });
+        const out = [];
+        const seen = new Set();
+        const pushOnce = (m) => {
+            const chave = `${m.mensagem}|${m.relPath}|${m.linha ?? 0}`;
+            if (seen.has(chave))
+                return;
+            seen.add(chave);
+            out.push(m);
+        };
+        const declaredRefs = new Set();
+        const isHookCallee = (callee) => {
+            if (t.isIdentifier(callee))
+                return { name: callee.name };
+            if (t.isMemberExpression(callee)) {
+                const obj = callee.object;
+                const prop = callee.property;
+                const objNome = t.isIdentifier(obj) ? obj.name : '';
+                const propNome = t.isIdentifier(prop) ? prop.name : '';
+                if (objNome === 'React' && propNome)
+                    return { name: propNome };
+            }
+            return null;
+        };
+        const isEffectLike = (name) => name === 'useEffect' || name === 'useLayoutEffect' || name === 'useInsertionEffect';
+        const isMemoLike = (name) => name === 'useMemo' || name === 'useCallback';
+        const isAnyHook = (name) => /^use[A-Z0-9_]/.test(name);
+        const inConditionalOrLoop = (path) => {
+            return Boolean(path.findParent(p => p.isIfStatement() || p.isForStatement() || p.isWhileStatement() || p.isDoWhileStatement() || p.isSwitchStatement() || p.isConditionalExpression()));
+        };
+        const getIdentifiersInNode = (node) => {
+            const ids = new Set();
+            if (!node)
+                return ids;
+            const text = src.slice(node.start ?? 0, node.end ?? 0);
+            const refMatches = text.matchAll(/\b([a-z]\w*)\b/g);
+            for (const m of refMatches) {
+                const ref = m[1];
+                if (ref.length > 1 && !['undefined', 'null', 'true', 'false'].includes(ref)) {
+                    ids.add(ref);
+                }
+            }
+            return ids;
+        };
+        const visitor = {
+            VariableDeclarator(path) {
+                if (t.isIdentifier(path.node.id) && t.isCallExpression(path.node.init)) {
+                    const callee = path.node.init.callee;
+                    if (t.isIdentifier(callee) && /^use[A-Z]/.test(callee.name) && callee.name !== 'useState' && callee.name !== 'useReducer' && callee.name !== 'useRef') {
+                        declaredRefs.add(path.node.id.name);
+                    }
+                    if (t.isIdentifier(callee) && callee.name === 'useRef') {
+                        declaredRefs.add(path.node.id.name);
+                    }
+                }
+            },
+            CallExpression(path) {
+                try {
+                    const calleeInfo = isHookCallee(path.node.callee);
+                    if (!calleeInfo)
+                        return;
+                    const { name } = calleeInfo;
+                    const locLine = path.node.loc?.start?.line;
+                    if (isEffectLike(name) && path.node.arguments.length < 2 && path.node.arguments.length >= 1) {
+                        pushOnce(warn(messages.ReactHooksMensagens.useEffectNoDeps, relPath, locLine));
+                    }
+                    if (isMemoLike(name) && path.node.arguments.length < 2 && path.node.arguments.length >= 1) {
+                        pushOnce(warn(messages.ReactHooksMensagens.memoCallbackNoDeps, relPath, locLine));
+                    }
+                    if (isAnyHook(name) && inConditionalOrLoop(path)) {
+                        pushOnce(warn(messages.ReactHooksMensagens.hookInConditional, relPath, locLine));
+                    }
+                    const fnParent = path.findParent(p => p.isFunction() && !p.isArrowFunctionExpression());
+                    const arrowParent = path.findParent(p => p.isArrowFunctionExpression());
+                    if (isAnyHook(name) && arrowParent && fnParent) {
+                        pushOnce(warn('Hook inside nested callback - move to top level', relPath, locLine));
+                    }
+                    if (fnParent && fnParent.isFunction()) {
+                        const fnBody = fnParent.node.body;
+                        if (t.isBlockStatement(fnBody)) {
+                            const bodyStmts = fnBody.body;
+                            let foundReturn = false;
+                            for (const stmt of bodyStmts) {
+                                if (t.isReturnStatement(stmt)) {
+                                    foundReturn = true;
+                                    continue;
+                                }
+                                if (foundReturn && t.isExpressionStatement(stmt) && t.isCallExpression(stmt.expression)) {
+                                    const inner = stmt.expression.callee;
+                                    if (t.isIdentifier(inner) && isAnyHook(inner.name)) {
+                                        pushOnce(warn('Hook after return statement', relPath, locLine));
+                                    }
+                                }
+                            }
+                        }
+                    }
+                    if (isEffectLike(name) && path.node.arguments.length >= 2) {
+                        const callback = path.node.arguments[0];
+                        const deps = path.node.arguments[1];
+                        const refsInCb = getIdentifiersInNode(callback);
+                        if (t.isArrayExpression(deps)) {
+                            const depsSet = new Set();
+                            for (const el of deps.elements) {
+                                if (t.isIdentifier(el))
+                                    depsSet.add(el.name);
+                            }
+                            const maybeMissing = [...refsInCb].filter(r => {
+                                if (/^[A-Z]/.test(r))
+                                    return false;
+                                if (r === name || r === 'undefined' || r === 'null' || r === 'true' || r === 'false')
+                                    return false;
+                                if (/^(set|dispatch)/.test(r))
+                                    return false;
+                                if (declaredRefs.has(r) && r.startsWith('ref'))
+                                    return false;
+                                return !depsSet.has(r);
+                            });
+                            if (maybeMissing.length > 1) {
+                                if (isMemoLike(name)) {
+                                    pushOnce(warn(messages.ReactHooksMensagens.memoCallbackNoDeps, relPath, locLine));
+                                }
+                                else {
+                                    pushOnce(warn(messages.ReactHooksMensagens.useEffectNoDeps, relPath, locLine));
+                                }
+                            }
+                            if (deps.elements.length === 0 && refsInCb.size > 0) {
+                                const nonTrivialRefs = [...refsInCb].filter(r => {
+                                    if (/^[A-Z]/.test(r))
+                                        return false;
+                                    if (r === 'undefined' || r === 'null' || r === 'true' || r === 'false')
+                                        return false;
+                                    return !/^(set|dispatch)/.test(r);
+                                });
+                                if (nonTrivialRefs.length > 0) {
+                                    pushOnce(warn('Effect with empty deps references component variables', relPath, locLine));
+                                }
+                            }
+                        }
+                    }
+                    if (isEffectLike(name) && path.node.arguments.length >= 1) {
+                        const callback = path.node.arguments[0];
+                        if (t.isFunctionExpression(callback) || t.isArrowFunctionExpression(callback)) {
+                            if (t.isBlockStatement(callback.body)) {
+                                const body = callback.body.body;
+                                const hasCleanup = body.some(stmt => t.isReturnStatement(stmt) && stmt.argument && (t.isFunctionExpression(stmt.argument) || t.isArrowFunctionExpression(stmt.argument)));
+                                const cbText = src.slice(callback.start ?? 0, callback.end ?? 0);
+                                const hasSub = cbText.includes('subscribe') || cbText.includes('addEventListener');
+                                if (hasSub && !hasCleanup) {
+                                    pushOnce(warn('useEffect with subscription but no cleanup function', relPath, locLine));
+                                }
+                            }
+                        }
+                    }
+                    if (isAnyHook(name) && !isEffectLike(name) && !isMemoLike(name) && name !== 'useState' && name !== 'useRef' && name !== 'useContext' && name !== 'useReducer' && name !== 'useDebugValue' && name !== 'useId') {
+                        pushOnce(warn(`Custom hook '${name}' usage detected`, relPath, locLine));
+                    }
+                }
+                catch {
+                }
+            }
+        };
+        traverseFn(ast, visitor);
+        return out;
+    }
+    catch {
+        return null;
+    }
+}
+export const analistaReactHooks = criarAnalista({
+    nome: 'analista-react-hooks',
+    categoria: 'framework',
+    descricao: 'Heurísticas de Hooks com análise de dependências (sem ESLint).',
+    global: false,
+    test: (relPath) => /\.(jsx|tsx|js|ts)$/i.test(relPath),
+    aplicar: async (src, relPath) => {
+        if (disableEnv)
+            return null;
+        if (relPath.includes('src/analysts/react/analysts/analyst-react-hooks.ts'))
+            return null;
+        if (!hasHooksUsage(src))
+            return null;
+        const astMsgs = parseHooksWithBabel(src, relPath);
+        if (astMsgs !== null) {
+            const regexMsgs = collectHookIssues(src, relPath);
+            const all = [...astMsgs, ...regexMsgs];
+            const seen = new Set();
+            const deduped = all.filter(m => {
+                const chave = `${m.mensagem}|${m.relPath}|${m.linha ?? 0}`;
+                if (seen.has(chave))
+                    return false;
+                seen.add(chave);
+                return true;
+            });
+            return deduped.length ? deduped : null;
+        }
+        const msgs = collectHookIssues(src, relPath);
+        return msgs.length ? msgs : null;
+    }
+});
+//# sourceMappingURL=analyst-react-hooks.js.map

package/dist/analysts/react/analysts/analyst-react-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst-react-hooks.js","sourceRoot":"","sources":["../../../../src/analysts/react/analysts/analyst-react-hooks.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\nimport type { ParserPlugin as BabelParserPlugin } from '@babel/parser';\nimport { parse as babelParse } from '@babel/parser';\nimport type { NodePath, Visitor } from '@babel/traverse';\nimport traverse from '@babel/traverse';\nimport * as t from '@babel/types';\nimport { messages } from '@core/messages';\nimport { createLineLookup } from '@shared/helpers';\n\nimport { criarAnalista, criarOcorrencia } from '@';\n\nconst disableEnv = process.env.MAHORAGA_DISABLE_PLUGIN_REACT_HOOKS === '1';\ntype Msg = ReturnType<typeof criarOcorrencia>;\n\nfunction hasHooksUsage(src: string): boolean {\n  return /use(State|Effect|Memo|Callback|Reducer|Ref|LayoutEffect|ImperativeHandle|Transition|DeferredValue|SyncExternalStore|InsertionEffect|Id|DebugValue)/.test(src);\n}\n\nfunction warn(message: string, relPath: string, line?: number, nivel = messages.SeverityNiveis.warning): Msg {\n  return criarOcorrencia({\n    relPath,\n    mensagem: message,\n    linha: line,\n    nivel,\n    origem: messages.AnalystOrigens.reactHooks,\n    tipo: messages.AnalystTipos.reactHooks\n  });\n}\n\nfunction extractHookCallContent(src: string, startIndex: number): string {\n  let depth = 0;\n  let started = false;\n  let content = '';\n  for (let i = startIndex; i < src.length; i++) {\n    const char = src[i];\n    if (char === '(') { depth++; started = true; }\n    else if (char === ')') { depth--; }\n    if (started) content += char;\n    if (started && depth === 0) break;\n  }\n  return content;\n}\n\nfunction collectHookIssues(src: string, relPath: string): Msg[] {\n  const ocorrencias: Msg[] = [];\n  const lineOf = createLineLookup(src).lineAt;\n\n  const effectMatches = [...src.matchAll(/use(Layout)?Effect\\s*\\(/g)];\n  effectMatches.forEach(m => {\n    const hookInicio = m.index ?? 0;\n    const fullCall = extractHookCallContent(src, hookInicio + m[0].length - 1);\n    const hasDepsArg = /,\\s*(\\[[\\s\\S]*?\\]|\\w+)\\s*\\)$/.test(fullCall);\n    const skip = /no-deps-ok|eslint-disable-next-line\\s+react-hooks\\/exhaustive-deps/i.test(fullCall);\n    if (!hasDepsArg && !skip) {\n      const line = lineOf(hookInicio);\n      ocorrencias.push(warn(messages.ReactHooksMensagens.useEffectNoDeps, relPath, line));\n    }\n\n    if (hasDepsArg && /\\[\\s*\\]/.test(fullCall)) {\n      const bodyWithRefs = fullCall.match(/^[\\s\\S]*?(?=,\\s*\\[)/);\n      if (bodyWithRefs) {\n        const varRefs = bodyWithRefs[0].match(/\\b([a-z]\\w+)\\b/g) || [];\n        const nonTrivialRefs = varRefs.filter(v => !/^(set|use)/.test(v) && v.length > 1 && !['undefined', 'null', 'true', 'false'].includes(v));\n        if (nonTrivialRefs.length > 0) {\n          const line = lineOf(hookInicio);\n          ocorrencias.push(warn('Empty deps array but effect references component variables', relPath, line));\n        }\n      }\n    }\n  });\n\n  const memoMatches = [...src.matchAll(/use(Memo|Callback)\\s*\\(/g)];\n  memoMatches.forEach(m => {\n    const hookInicio = m.index ?? 0;\n    const fullCall = extractHookCallContent(src, hookInicio + m[0].length - 1);\n    const hasDepsArg = /,\\s*(\\[[\\s\\S]*?\\]|\\w+)\\s*\\)$/.test(fullCall);\n    const skip = /no-deps-ok|eslint-disable-next-line\\s+react-hooks\\/exhaustive-deps/i.test(fullCall);\n    if (!hasDepsArg && !skip) {\n      const line = lineOf(hookInicio);\n      ocorrencias.push(warn(messages.ReactHooksMensagens.memoCallbackNoDeps, relPath, line));\n    }\n  });\n\n  const conditionalHooks = [...src.matchAll(/(if|for|while)\\s*\\([^)]*\\)\\s*\\{[\\s\\S]{0,160}?use[A-Z][A-Za-z0-9_]*/g)];\n  conditionalHooks.forEach(m => {\n    const line = lineOf(m.index || 0);\n    ocorrencias.push(warn(messages.ReactHooksMensagens.hookInConditional, relPath, line));\n  });\n\n  const customHooks = [...src.matchAll(/\\buse[A-Z][A-Za-z0-9_]*\\s*=\\s*\\(/g)];\n  customHooks.forEach(m => {\n    const hookName = m[0].replace(/\\s*=\\s*\\(/, '');\n    if (!/^(useState|useEffect|useMemo|useCallback|useRef|useContext|useReducer|useLayoutEffect|useImperativeHandle|useDebugValue|useDeferredValue|useTransition|useSyncExternalStore|useInsertionEffect|useId)$/.test(hookName)) {\n      if (/^use[A-Z]/.test(hookName)) {\n        const line = lineOf(m.index || 0);\n        ocorrencias.push(warn(`Custom hook '${hookName}' - verify naming follows useXxx convention`, relPath, line));\n      }\n    }\n  });\n\n  return ocorrencias;\n}\n\nconst traverseFn = traverse as unknown as typeof import('@babel/traverse').default;\n\nfunction parseHooksWithBabel(src: string, relPath: string): Msg[] | null {\n  const lower = relPath.toLowerCase();\n  const isTs = lower.endsWith('.ts') || lower.endsWith('.tsx');\n  const isJsxLike = lower.endsWith('.tsx') || lower.endsWith('.jsx');\n  try {\n    const plugins: BabelParserPlugin[] = ['decorators-legacy'];\n    if (isTs) plugins.unshift('typescript');\n    if (isJsxLike) plugins.unshift('jsx');\n    const ast = babelParse(src, { sourceType: 'unambiguous', errorRecovery: true, plugins });\n    const out: Msg[] = [];\n    const seen = new Set<string>();\n    const pushOnce = (m: Msg) => {\n      const chave = `${m.mensagem}|${m.relPath}|${m.linha ?? 0}`;\n      if (seen.has(chave)) return;\n      seen.add(chave);\n      out.push(m);\n    };\n\n    const declaredRefs = new Set<string>();\n\n    const isHookCallee = (callee: t.CallExpression['callee']): { name: string } | null => {\n      if (t.isIdentifier(callee)) return { name: callee.name };\n      if (t.isMemberExpression(callee)) {\n        const obj = callee.object;\n        const prop = callee.property;\n        const objNome = t.isIdentifier(obj) ? obj.name : '';\n        const propNome = t.isIdentifier(prop) ? prop.name : '';\n        if (objNome === 'React' && propNome) return { name: propNome };\n      }\n      return null;\n    };\n\n    const isEffectLike = (name: string) => name === 'useEffect' || name === 'useLayoutEffect' || name === 'useInsertionEffect';\n    const isMemoLike = (name: string) => name === 'useMemo' || name === 'useCallback';\n    const isAnyHook = (name: string) => /^use[A-Z0-9_]/.test(name);\n\n    const inConditionalOrLoop = (path: NodePath<t.CallExpression>): boolean => {\n      return Boolean(path.findParent(p => p.isIfStatement() || p.isForStatement() || p.isWhileStatement() || p.isDoWhileStatement() || p.isSwitchStatement() || p.isConditionalExpression()));\n    };\n\n    const getIdentifiersInNode = (node: t.Node | null | undefined): Set<string> => {\n      const ids = new Set<string>();\n      if (!node) return ids;\n      const text = src.slice(node.start ?? 0, node.end ?? 0);\n      const refMatches = text.matchAll(/\\b([a-z]\\w*)\\b/g);\n      for (const m of refMatches) {\n        const ref = m[1];\n        if (ref.length > 1 && !['undefined', 'null', 'true', 'false'].includes(ref)) {\n          ids.add(ref);\n        }\n      }\n      return ids;\n    };\n\n    const visitor: Visitor<unknown> = {\n      VariableDeclarator(path: NodePath<t.VariableDeclarator>) {\n        if (t.isIdentifier(path.node.id) && t.isCallExpression(path.node.init)) {\n          const callee = path.node.init.callee;\n          if (t.isIdentifier(callee) && /^use[A-Z]/.test(callee.name) && callee.name !== 'useState' && callee.name !== 'useReducer' && callee.name !== 'useRef') {\n            declaredRefs.add(path.node.id.name);\n          }\n          if (t.isIdentifier(callee) && callee.name === 'useRef') {\n            declaredRefs.add(path.node.id.name);\n          }\n        }\n      },\n      CallExpression(path: NodePath<t.CallExpression>) {\n        try {\n          const calleeInfo = isHookCallee(path.node.callee);\n          if (!calleeInfo) return;\n          const { name } = calleeInfo;\n          const locLine = path.node.loc?.start?.line;\n\n          if (isEffectLike(name) && path.node.arguments.length < 2 && path.node.arguments.length >= 1) {\n            pushOnce(warn(messages.ReactHooksMensagens.useEffectNoDeps, relPath, locLine));\n          }\n\n          if (isMemoLike(name) && path.node.arguments.length < 2 && path.node.arguments.length >= 1) {\n            pushOnce(warn(messages.ReactHooksMensagens.memoCallbackNoDeps, relPath, locLine));\n          }\n\n          if (isAnyHook(name) && inConditionalOrLoop(path)) {\n            pushOnce(warn(messages.ReactHooksMensagens.hookInConditional, relPath, locLine));\n          }\n\n          const fnParent = path.findParent(p => p.isFunction() && !p.isArrowFunctionExpression());\n          const arrowParent = path.findParent(p => p.isArrowFunctionExpression());\n          if (isAnyHook(name) && arrowParent && fnParent) {\n            pushOnce(warn('Hook inside nested callback - move to top level', relPath, locLine));\n          }\n\n          if (fnParent && fnParent.isFunction()) {\n            const fnBody = fnParent.node.body;\n            if (t.isBlockStatement(fnBody)) {\n              const bodyStmts = fnBody.body;\n              let foundReturn = false;\n              for (const stmt of bodyStmts) {\n                if (t.isReturnStatement(stmt)) {\n                  foundReturn = true;\n                  continue;\n                }\n                if (foundReturn && t.isExpressionStatement(stmt) && t.isCallExpression(stmt.expression)) {\n                  const inner = stmt.expression.callee;\n                  if (t.isIdentifier(inner) && isAnyHook(inner.name)) {\n                    pushOnce(warn('Hook after return statement', relPath, locLine));\n                  }\n                }\n              }\n            }\n          }\n\n          if (isEffectLike(name) && path.node.arguments.length >= 2) {\n            const callback = path.node.arguments[0];\n            const deps = path.node.arguments[1];\n            const refsInCb = getIdentifiersInNode(callback);\n\n            if (t.isArrayExpression(deps)) {\n              const depsSet = new Set<string>();\n              for (const el of deps.elements) {\n                if (t.isIdentifier(el)) depsSet.add(el.name);\n              }\n\n              const maybeMissing = [...refsInCb].filter(r => {\n                if (/^[A-Z]/.test(r)) return false;\n                if (r === name || r === 'undefined' || r === 'null' || r === 'true' || r === 'false') return false;\n                if (/^(set|dispatch)/.test(r)) return false;\n                if (declaredRefs.has(r) && r.startsWith('ref')) return false;\n                return !depsSet.has(r);\n              });\n\n              if (maybeMissing.length > 1) {\n                if (isMemoLike(name)) {\n                  pushOnce(warn(messages.ReactHooksMensagens.memoCallbackNoDeps, relPath, locLine));\n                } else {\n                  pushOnce(warn(messages.ReactHooksMensagens.useEffectNoDeps, relPath, locLine));\n                }\n              }\n\n              if (deps.elements.length === 0 && refsInCb.size > 0) {\n                const nonTrivialRefs = [...refsInCb].filter(r => {\n                  if (/^[A-Z]/.test(r)) return false;\n                  if (r === 'undefined' || r === 'null' || r === 'true' || r === 'false') return false;\n                  return !/^(set|dispatch)/.test(r);\n                });\n                if (nonTrivialRefs.length > 0) {\n                  pushOnce(warn('Effect with empty deps references component variables', relPath, locLine));\n                }\n              }\n            }\n          }\n\n          if (isEffectLike(name) && path.node.arguments.length >= 1) {\n            const callback = path.node.arguments[0];\n            if (t.isFunctionExpression(callback) || t.isArrowFunctionExpression(callback)) {\n              if (t.isBlockStatement(callback.body)) {\n                const body = callback.body.body;\n                const hasCleanup = body.some(stmt => t.isReturnStatement(stmt) && stmt.argument && (t.isFunctionExpression(stmt.argument) || t.isArrowFunctionExpression(stmt.argument)));\n                const cbText = src.slice(callback.start ?? 0, callback.end ?? 0);\n                const hasSub = cbText.includes('subscribe') || cbText.includes('addEventListener');\n                if (hasSub && !hasCleanup) {\n                  pushOnce(warn('useEffect with subscription but no cleanup function', relPath, locLine));\n                }\n              }\n            }\n          }\n\n          if (isAnyHook(name) && !isEffectLike(name) && !isMemoLike(name) && name !== 'useState' && name !== 'useRef' && name !== 'useContext' && name !== 'useReducer' && name !== 'useDebugValue' && name !== 'useId') {\n            pushOnce(warn(`Custom hook '${name}' usage detected`, relPath, locLine));\n          }\n        } catch {\n          // ignora\n        }\n      }\n    };\n\n    traverseFn(ast, visitor);\n    return out;\n  } catch {\n    return null;\n  }\n}\n\nexport const analistaReactHooks = criarAnalista({\n  nome: 'analista-react-hooks',\n  categoria: 'framework',\n  descricao: 'Heurísticas de Hooks com análise de dependências (sem ESLint).',\n  global: false,\n  test: (relPath: string): boolean => /\\.(jsx|tsx|js|ts)$/i.test(relPath),\n  aplicar: async (src, relPath): Promise<Msg[] | null> => {\n    if (disableEnv) return null;\n    if (relPath.includes('src/analysts/react/analysts/analyst-react-hooks.ts')) return null;\n    if (!hasHooksUsage(src)) return null;\n    const astMsgs = parseHooksWithBabel(src, relPath);\n    if (astMsgs !== null) {\n      const regexMsgs = collectHookIssues(src, relPath);\n      const all = [...astMsgs, ...regexMsgs];\n      const seen = new Set<string>();\n      const deduped = all.filter(m => {\n        const chave = `${m.mensagem}|${m.relPath}|${m.linha ?? 0}`;\n        if (seen.has(chave)) return false;\n        seen.add(chave);\n        return true;\n      });\n      return deduped.length ? deduped : null;\n    }\n    const msgs = collectHookIssues(src, relPath);\n    return msgs.length ? msgs : null;\n  }\n});\n"]}

package/dist/analysts/react/analysts/analyst-react.d.ts

@@ -0,0 +1,12 @@
+import { criarOcorrencia } from '../../../types/index.js';
+type Msg = ReturnType<typeof criarOcorrencia>;
+export declare const analistaReact: {
+    nome: string;
+    categoria: string;
+    descricao: string;
+    global: false;
+    test: (relPath: string) => boolean;
+    aplicar: (src: string, relPath: string) => Promise<Msg[] | null>;
+};
+export {};
+//# sourceMappingURL=analyst-react.d.ts.map

package/dist/analysts/react/analysts/analyst-react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst-react.d.ts","sourceRoot":"","sources":["../../../../src/analysts/react/analysts/analyst-react.ts"],"names":[],"mappings":"AASA,OAAO,EAAiB,eAAe,EAAE,MAAM,GAAG,CAAC;AAGnD,KAAK,GAAG,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAwV9C,eAAO,MAAM,aAAa;;;;;oBAKR,MAAM,KAAG,OAAO;+CACD,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;CA6BpD,CAAC"}