@fluentui/react-compiler-analyzer 0.0.0-experimental.rc-analyzer.20260430-fc3bb2e193.0

package/dist/src/discovery.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    discoverAllFiles: function() {
+        return discoverAllFiles;
+    },
+    discoverDirectiveFiles: function() {
+        return discoverDirectiveFiles;
+    },
+    findPackageName: function() {
+        return findPackageName;
+    }
+});
+const _nodefs = require("node:fs");
+const _promises = require("node:fs/promises");
+const _nodepath = require("node:path");
+const USE_NO_MEMO_RE = /['(]use no memo[')]/;
+async function findPackageName(startDir) {
+    let dir = (0, _nodepath.resolve)(startDir);
+    const root = (0, _nodepath.resolve)('/');
+    while(dir !== root){
+        const pkgJsonPath = (0, _nodepath.join)(dir, 'package.json');
+        if ((0, _nodefs.existsSync)(pkgJsonPath)) try {
+            const content = await (0, _promises.readFile)(pkgJsonPath, 'utf-8');
+            const pkg = JSON.parse(content);
+            if (typeof pkg.name === 'string') return pkg.name;
+        } catch  {
+        // ignore parse errors, keep walking
+        }
+        dir = (0, _nodepath.dirname)(dir);
+    }
+    return (0, _nodepath.basename)(startDir);
+}
+async function discoverDirectiveFiles(scanDir, packageName, exclude, verbose) {
+    const files = [];
+    const tsFiles = (0, _nodefs.globSync)('**/*.{ts,tsx}', {
+        cwd: scanDir,
+        exclude
+    }).map((relative)=>(0, _nodepath.join)(scanDir, relative));
+    for (const filePath of tsFiles){
+        const content = await (0, _promises.readFile)(filePath, 'utf-8');
+        if (USE_NO_MEMO_RE.test(content)) files.push({
+            filePath,
+            packageName
+        });
+    }
+    if (verbose && files.length === 0) console.log(`  No 'use no memo' files found in ${scanDir}`);
+    return files;
+}
+async function discoverAllFiles(scanDir, packageName, exclude, verbose) {
+    const tsFiles = (0, _nodefs.globSync)('**/*.{ts,tsx}', {
+        cwd: scanDir,
+        exclude
+    }).map((relative)=>(0, _nodepath.join)(scanDir, relative));
+    if (verbose) console.log(`  Found ${tsFiles.length} TypeScript files in ${scanDir}`);
+    return tsFiles.map((filePath)=>({
+            filePath,
+            packageName
+        }));
+}
+
+//# sourceMappingURL=discovery.js.map

package/dist/src/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/discovery.ts"],"sourcesContent":["import { existsSync, globSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { basename, dirname, join, resolve } from 'node:path';\n\nimport type { FileEntry } from './types';\n\nconst USE_NO_MEMO_RE = /['(]use no memo[')]/;\n\n/**\n * Walk up from `startDir` to find the nearest package.json and return its `name` field.\n * Falls back to the basename of `startDir`.\n */\nexport async function findPackageName(startDir: string): Promise<string> {\n  let dir = resolve(startDir);\n  const root = resolve('/');\n\n  while (dir !== root) {\n    const pkgJsonPath = join(dir, 'package.json');\n    if (existsSync(pkgJsonPath)) {\n      try {\n        const content = await readFile(pkgJsonPath, 'utf-8');\n        const pkg = JSON.parse(content);\n        if (typeof pkg.name === 'string') {\n          return pkg.name;\n        }\n      } catch {\n        // ignore parse errors, keep walking\n      }\n    }\n    dir = dirname(dir);\n  }\n\n  return basename(startDir);\n}\n\n/**\n * Discover files containing 'use no memo' in the given directory.\n */\nexport async function discoverDirectiveFiles(\n  scanDir: string,\n  packageName: string,\n  exclude: string[],\n  verbose: boolean,\n): Promise<FileEntry[]> {\n  const files: FileEntry[] = [];\n\n  const tsFiles = globSync('**/*.{ts,tsx}', {\n    cwd: scanDir,\n    exclude,\n  }).map(relative => join(scanDir, relative));\n\n  for (const filePath of tsFiles) {\n    const content = await readFile(filePath, 'utf-8');\n    if (USE_NO_MEMO_RE.test(content)) {\n      files.push({ filePath, packageName });\n    }\n  }\n\n  if (verbose && files.length === 0) {\n    console.log(`  No 'use no memo' files found in ${scanDir}`);\n  }\n\n  return files;\n}\n\n/**\n * Discover all TypeScript files in the given directory (for coverage analysis).\n */\nexport async function discoverAllFiles(\n  scanDir: string,\n  packageName: string,\n  exclude: string[],\n  verbose: boolean,\n): Promise<FileEntry[]> {\n  const tsFiles = globSync('**/*.{ts,tsx}', {\n    cwd: scanDir,\n    exclude,\n  }).map(relative => join(scanDir, relative));\n\n  if (verbose) {\n    console.log(`  Found ${tsFiles.length} TypeScript files in ${scanDir}`);\n  }\n\n  return tsFiles.map(filePath => ({ filePath, packageName }));\n}\n"],"names":["discoverAllFiles","discoverDirectiveFiles","findPackageName","USE_NO_MEMO_RE","startDir","dir","resolve","root","pkgJsonPath","join","existsSync","content","readFile","pkg","JSON","parse","name","dirname","basename","scanDir","packageName","exclude","verbose","files","tsFiles","globSync","cwd","map","relative","filePath","test","push","length","console","log"],"mappings":";;;;;;;;;;;IAoEsBA,gBAAgB;eAAhBA;;IA9BAC,sBAAsB;eAAtBA;;IA1BAC,eAAe;eAAfA;;;wBAZe;0BACZ;0BACwB;AAIjD,MAAMC,iBAAiB;AAMhB,eAAeD,gBAAgBE,QAAgB;IACpD,IAAIC,MAAMC,IAAAA,iBAAO,EAACF;IAClB,MAAMG,OAAOD,IAAAA,iBAAO,EAAC;IAErB,MAAOD,QAAQE,KAAM;QACnB,MAAMC,cAAcC,IAAAA,cAAI,EAACJ,KAAK;QAC9B,IAAIK,IAAAA,kBAAU,EAACF,cACb,IAAI;YACF,MAAMG,UAAU,MAAMC,IAAAA,kBAAQ,EAACJ,aAAa;YAC5C,MAAMK,MAAMC,KAAKC,KAAK,CAACJ;YACvB,IAAI,OAAOE,IAAIG,IAAI,KAAK,UACtB,OAAOH,IAAIG,IAAI;QAEnB,EAAE,OAAM;QACN,oCAAoC;QACtC;QAEFX,MAAMY,IAAAA,iBAAO,EAACZ;IAChB;IAEA,OAAOa,IAAAA,kBAAQ,EAACd;AAClB;AAKO,eAAeH,uBACpBkB,OAAe,EACfC,WAAmB,EACnBC,OAAiB,EACjBC,OAAgB;IAEhB,MAAMC,QAAqB,EAAE;IAE7B,MAAMC,UAAUC,IAAAA,gBAAQ,EAAC,iBAAiB;QACxCC,KAAKP;QACLE;IACF,GAAGM,GAAG,CAACC,CAAAA,WAAYnB,IAAAA,cAAI,EAACU,SAASS;IAEjC,KAAK,MAAMC,YAAYL,QAAS;QAC9B,MAAMb,UAAU,MAAMC,IAAAA,kBAAQ,EAACiB,UAAU;QACzC,IAAI1B,eAAe2B,IAAI,CAACnB,UACtBY,MAAMQ,IAAI,CAAC;YAAEF;YAAUT;QAAY;IAEvC;IAEA,IAAIE,WAAWC,MAAMS,MAAM,KAAK,GAC9BC,QAAQC,GAAG,CAAC,CAAC,kCAAkC,EAAEf,SAAS;IAG5D,OAAOI;AACT;AAKO,eAAevB,iBACpBmB,OAAe,EACfC,WAAmB,EACnBC,OAAiB,EACjBC,OAAgB;IAEhB,MAAME,UAAUC,IAAAA,gBAAQ,EAAC,iBAAiB;QACxCC,KAAKP;QACLE;IACF,GAAGM,GAAG,CAACC,CAAAA,WAAYnB,IAAAA,cAAI,EAACU,SAASS;IAEjC,IAAIN,SACFW,QAAQC,GAAG,CAAC,CAAC,QAAQ,EAAEV,QAAQQ,MAAM,CAAC,qBAAqB,EAAEb,SAAS;IAGxE,OAAOK,QAAQG,GAAG,CAACE,CAAAA,WAAa,CAAA;YAAEA;YAAUT;QAAY,CAAA;AAC1D"}

package/dist/src/fixer.d.ts

@@ -0,0 +1,9 @@
+import type { DirectiveAnalysis, FixResult } from './types';
+/**
+ * Auto-fix directives in source files:
+ * - Remove redundant 'use no memo' directives
+ * - Annotate active directives with `// justified: <reason>`
+ *
+ * Processes changes bottom-to-top within each file to avoid offset shifts.
+ */
+export declare function applyFixes(results: DirectiveAnalysis[]): Promise<FixResult>;

package/dist/src/fixer.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "applyFixes", {
+    enumerable: true,
+    get: function() {
+        return applyFixes;
+    }
+});
+const _promises = require("node:fs/promises");
+async function applyFixes(results) {
+    const actionable = results.filter((r)=>r.status === 'redundant' || r.status === 'active');
+    if (actionable.length === 0) return {
+        filesModified: 0,
+        directivesRemoved: 0,
+        directivesJustified: 0
+    };
+    // Group actions by file
+    const byFile = new Map();
+    for (const r of actionable){
+        const actions = byFile.get(r.filePath) ?? [];
+        if (r.status === 'redundant') actions.push({
+            kind: 'remove',
+            line: r.line
+        });
+        else if (r.status === 'active') actions.push({
+            kind: 'justify',
+            line: r.line,
+            reason: buildJustification(r)
+        });
+        byFile.set(r.filePath, actions);
+    }
+    let filesModified = 0;
+    let directivesRemoved = 0;
+    let directivesJustified = 0;
+    for (const [filePath, actions] of byFile){
+        const source = await (0, _promises.readFile)(filePath, 'utf-8');
+        const lines = source.split('\n');
+        // Sort descending so we process from bottom-to-top
+        const sorted = [
+            ...actions
+        ].sort((a, b)=>b.line - a.line);
+        for (const action of sorted){
+            const idx = action.line - 1; // 0-based index
+            if (idx < 0 || idx >= lines.length) continue;
+            if (action.kind === 'remove') {
+                lines.splice(idx, 1);
+                directivesRemoved++;
+            } else {
+                // Append justification comment to the directive line
+                const currentLine = lines[idx];
+                // Strip any existing trailing comment (shouldn't have one, but be safe)
+                const withoutTrailingComment = currentLine.replace(/\s*\/\/.*$/, '');
+                // Ensure semicolon before the comment
+                const base = withoutTrailingComment.trimEnd().endsWith(';') ? withoutTrailingComment.trimEnd() : withoutTrailingComment.trimEnd() + ';';
+                lines[idx] = `${base} // justified: ${action.reason}`;
+                directivesJustified++;
+            }
+        }
+        await (0, _promises.writeFile)(filePath, lines.join('\n'), 'utf-8');
+        filesModified++;
+    }
+    return {
+        filesModified,
+        directivesRemoved,
+        directivesJustified
+    };
+}
+/**
+ * Build a concise justification string for an active directive.
+ * Summarizes why the compiler would optimize the function (and thus
+ * why the directive is intentionally keeping it unoptimized).
+ */ function buildJustification(r) {
+    const fnName = r.functionName ?? 'unknown function';
+    return `compiler would optimize ${fnName} — manual opt-out to preserve runtime behavior`;
+}
+
+//# sourceMappingURL=fixer.js.map

package/dist/src/fixer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fixer.ts"],"sourcesContent":["import { readFile, writeFile } from 'node:fs/promises';\n\nimport type { DirectiveAnalysis, FixResult } from './types';\n\ntype LineAction = { kind: 'remove'; line: number } | { kind: 'justify'; line: number; reason: string };\n\n/**\n * Auto-fix directives in source files:\n * - Remove redundant 'use no memo' directives\n * - Annotate active directives with `// justified: <reason>`\n *\n * Processes changes bottom-to-top within each file to avoid offset shifts.\n */\nexport async function applyFixes(results: DirectiveAnalysis[]): Promise<FixResult> {\n  const actionable = results.filter(r => r.status === 'redundant' || r.status === 'active');\n  if (actionable.length === 0) {\n    return { filesModified: 0, directivesRemoved: 0, directivesJustified: 0 };\n  }\n\n  // Group actions by file\n  const byFile = new Map<string, LineAction[]>();\n  for (const r of actionable) {\n    const actions = byFile.get(r.filePath) ?? [];\n    if (r.status === 'redundant') {\n      actions.push({ kind: 'remove', line: r.line });\n    } else if (r.status === 'active') {\n      actions.push({ kind: 'justify', line: r.line, reason: buildJustification(r) });\n    }\n    byFile.set(r.filePath, actions);\n  }\n\n  let filesModified = 0;\n  let directivesRemoved = 0;\n  let directivesJustified = 0;\n\n  for (const [filePath, actions] of byFile) {\n    const source = await readFile(filePath, 'utf-8');\n    const lines = source.split('\\n');\n\n    // Sort descending so we process from bottom-to-top\n    const sorted = [...actions].sort((a, b) => b.line - a.line);\n\n    for (const action of sorted) {\n      const idx = action.line - 1; // 0-based index\n      if (idx < 0 || idx >= lines.length) {\n        continue;\n      }\n\n      if (action.kind === 'remove') {\n        lines.splice(idx, 1);\n        directivesRemoved++;\n      } else {\n        // Append justification comment to the directive line\n        const currentLine = lines[idx];\n        // Strip any existing trailing comment (shouldn't have one, but be safe)\n        const withoutTrailingComment = currentLine.replace(/\\s*\\/\\/.*$/, '');\n        // Ensure semicolon before the comment\n        const base = withoutTrailingComment.trimEnd().endsWith(';')\n          ? withoutTrailingComment.trimEnd()\n          : withoutTrailingComment.trimEnd() + ';';\n        lines[idx] = `${base} // justified: ${action.reason}`;\n        directivesJustified++;\n      }\n    }\n\n    await writeFile(filePath, lines.join('\\n'), 'utf-8');\n    filesModified++;\n  }\n\n  return { filesModified, directivesRemoved, directivesJustified };\n}\n\n/**\n * Build a concise justification string for an active directive.\n * Summarizes why the compiler would optimize the function (and thus\n * why the directive is intentionally keeping it unoptimized).\n */\nfunction buildJustification(r: DirectiveAnalysis): string {\n  const fnName = r.functionName ?? 'unknown function';\n  return `compiler would optimize ${fnName} — manual opt-out to preserve runtime behavior`;\n}\n"],"names":["applyFixes","results","actionable","filter","r","status","length","filesModified","directivesRemoved","directivesJustified","byFile","Map","actions","get","filePath","push","kind","line","reason","buildJustification","set","source","readFile","lines","split","sorted","sort","a","b","action","idx","splice","currentLine","withoutTrailingComment","replace","base","trimEnd","endsWith","writeFile","join","fnName","functionName"],"mappings":";;;;+BAasBA;;;eAAAA;;;0BAbc;AAa7B,eAAeA,WAAWC,OAA4B;IAC3D,MAAMC,aAAaD,QAAQE,MAAM,CAACC,CAAAA,IAAKA,EAAEC,MAAM,KAAK,eAAeD,EAAEC,MAAM,KAAK;IAChF,IAAIH,WAAWI,MAAM,KAAK,GACxB,OAAO;QAAEC,eAAe;QAAGC,mBAAmB;QAAGC,qBAAqB;IAAE;IAG1E,wBAAwB;IACxB,MAAMC,SAAS,IAAIC;IACnB,KAAK,MAAMP,KAAKF,WAAY;QAC1B,MAAMU,UAAUF,OAAOG,GAAG,CAACT,EAAEU,QAAQ,KAAK,EAAE;QAC5C,IAAIV,EAAEC,MAAM,KAAK,aACfO,QAAQG,IAAI,CAAC;YAAEC,MAAM;YAAUC,MAAMb,EAAEa,IAAI;QAAC;aACvC,IAAIb,EAAEC,MAAM,KAAK,UACtBO,QAAQG,IAAI,CAAC;YAAEC,MAAM;YAAWC,MAAMb,EAAEa,IAAI;YAAEC,QAAQC,mBAAmBf;QAAG;QAE9EM,OAAOU,GAAG,CAAChB,EAAEU,QAAQ,EAAEF;IACzB;IAEA,IAAIL,gBAAgB;IACpB,IAAIC,oBAAoB;IACxB,IAAIC,sBAAsB;IAE1B,KAAK,MAAM,CAACK,UAAUF,QAAQ,IAAIF,OAAQ;QACxC,MAAMW,SAAS,MAAMC,IAAAA,kBAAQ,EAACR,UAAU;QACxC,MAAMS,QAAQF,OAAOG,KAAK,CAAC;QAE3B,mDAAmD;QACnD,MAAMC,SAAS;eAAIb;SAAQ,CAACc,IAAI,CAAC,CAACC,GAAGC,IAAMA,EAAEX,IAAI,GAAGU,EAAEV,IAAI;QAE1D,KAAK,MAAMY,UAAUJ,OAAQ;YAC3B,MAAMK,MAAMD,OAAOZ,IAAI,GAAG,GAAG,gBAAgB;YAC7C,IAAIa,MAAM,KAAKA,OAAOP,MAAMjB,MAAM,EAChC;YAGF,IAAIuB,OAAOb,IAAI,KAAK,UAAU;gBAC5BO,MAAMQ,MAAM,CAACD,KAAK;gBAClBtB;YACF,OAAO;gBACL,qDAAqD;gBACrD,MAAMwB,cAAcT,KAAK,CAACO,IAAI;gBAC9B,wEAAwE;gBACxE,MAAMG,yBAAyBD,YAAYE,OAAO,CAAC,cAAc;gBACjE,sCAAsC;gBACtC,MAAMC,OAAOF,uBAAuBG,OAAO,GAAGC,QAAQ,CAAC,OACnDJ,uBAAuBG,OAAO,KAC9BH,uBAAuBG,OAAO,KAAK;gBACvCb,KAAK,CAACO,IAAI,GAAG,GAAGK,KAAK,eAAe,EAAEN,OAAOX,MAAM,EAAE;gBACrDT;YACF;QACF;QAEA,MAAM6B,IAAAA,mBAAS,EAACxB,UAAUS,MAAMgB,IAAI,CAAC,OAAO;QAC5ChC;IACF;IAEA,OAAO;QAAEA;QAAeC;QAAmBC;IAAoB;AACjE;AAEA;;;;CAIC,GACD,SAASU,mBAAmBf,CAAoB;IAC9C,MAAMoC,SAASpC,EAAEqC,YAAY,IAAI;IACjC,OAAO,CAAC,wBAAwB,EAAED,OAAO,8CAA8C,CAAC;AAC1F"}

package/dist/src/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/index.ts"],"names":[],"mappings":""}

package/dist/src/manual-memo-plugin.d.ts

@@ -0,0 +1,16 @@
+import type { PluginObj } from '@babel/core';
+export interface ManualMemoEntry {
+    useMemo: number;
+    useCallback: number;
+    reactMemo: boolean;
+    bodyInsertionLine: number;
+}
+export interface ManualMemoPluginOptions {
+    /** Shared map keyed by `line:column` of the enclosing function start */
+    results: Map<string, ManualMemoEntry>;
+}
+/**
+ * Babel plugin that detects manual memoization (useMemo, useCallback, React.memo)
+ * within function bodies. Populates a shared Map in plugin options keyed by function location.
+ */
+export declare function manualMemoPlugin(): PluginObj;

package/dist/src/manual-memo-plugin.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "manualMemoPlugin", {
+    enumerable: true,
+    get: function() {
+        return manualMemoPlugin;
+    }
+});
+function fnKey(loc) {
+    return `${loc.line}:${loc.column}`;
+}
+function getBodyInsertionLine(fnPath) {
+    const body = fnPath.node.body;
+    if (body.type === 'BlockStatement' && body.loc) // Insert after the opening brace — first statement line, or body start + 1
+    return body.loc.start.line + 1;
+    // Arrow function with expression body — use the function start line
+    if (fnPath.node.loc) return fnPath.node.loc.start.line;
+    return 0;
+}
+function hasUseMemoDirective(fnPath) {
+    const body = fnPath.node.body;
+    if (body.type !== 'BlockStatement') return false;
+    for (const directive of body.directives ?? []){
+        if (directive.value.value === 'use memo') return true;
+    }
+    return false;
+}
+function manualMemoPlugin() {
+    return {
+        name: 'manual-memo-detection',
+        visitor: {
+            // eslint-disable-next-line @typescript-eslint/naming-convention
+            CallExpression (path, state) {
+                const opts = state.opts;
+                const callee = path.node.callee;
+                let hookName = null;
+                // Direct call: memo(...), useMemo(...), useCallback(...)
+                if (callee.type === 'Identifier') {
+                    const binding = path.scope.getBinding(callee.name);
+                    if (binding?.path.parent?.type === 'ImportDeclaration' && binding.path.parent.source.value === 'react') {
+                        if (callee.name === 'useMemo') hookName = 'useMemo';
+                        else if (callee.name === 'useCallback') hookName = 'useCallback';
+                        else if (callee.name === 'memo') hookName = 'reactMemo';
+                    }
+                }
+                // Member expression: React.memo(...), React.useMemo(...), React.useCallback(...)
+                if (callee.type === 'MemberExpression' && callee.object.type === 'Identifier' && callee.property.type === 'Identifier') {
+                    const binding = path.scope.getBinding(callee.object.name);
+                    if (binding?.path.parent?.type === 'ImportDeclaration' && binding.path.parent.source.value === 'react') {
+                        if (callee.property.name === 'memo') hookName = 'reactMemo';
+                        else if (callee.property.name === 'useMemo') hookName = 'useMemo';
+                        else if (callee.property.name === 'useCallback') hookName = 'useCallback';
+                    }
+                }
+                if (!hookName) return;
+                // Find the enclosing function
+                const fnPath = path.findParent((p)=>p.isFunctionDeclaration() || p.isFunctionExpression() || p.isArrowFunctionExpression());
+                if (!fnPath || !fnPath.node.loc) return;
+                // Skip functions that already have 'use memo' directive
+                if (hasUseMemoDirective(fnPath)) return;
+                const key = fnKey(fnPath.node.loc.start);
+                let entry = opts.results.get(key);
+                if (!entry) {
+                    entry = {
+                        useMemo: 0,
+                        useCallback: 0,
+                        reactMemo: false,
+                        bodyInsertionLine: getBodyInsertionLine(fnPath)
+                    };
+                    opts.results.set(key, entry);
+                }
+                if (hookName === 'useMemo') entry.useMemo++;
+                else if (hookName === 'useCallback') entry.useCallback++;
+                else if (hookName === 'reactMemo') entry.reactMemo = true;
+            }
+        }
+    };
+}
+
+//# sourceMappingURL=manual-memo-plugin.js.map

package/dist/src/manual-memo-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/manual-memo-plugin.ts"],"sourcesContent":["import type { PluginObj, NodePath } from '@babel/core';\nimport type { Function as BabelFunction } from '@babel/types';\n\nimport type { ManualMemoization } from './types';\n\nexport interface ManualMemoEntry {\n  useMemo: number;\n  useCallback: number;\n  reactMemo: boolean;\n  bodyInsertionLine: number;\n}\n\nexport interface ManualMemoPluginOptions {\n  /** Shared map keyed by `line:column` of the enclosing function start */\n  results: Map<string, ManualMemoEntry>;\n}\n\nfunction fnKey(loc: { line: number; column: number }): string {\n  return `${loc.line}:${loc.column}`;\n}\n\nfunction getBodyInsertionLine(fnPath: NodePath<BabelFunction>): number {\n  const body = fnPath.node.body;\n  if (body.type === 'BlockStatement' && body.loc) {\n    // Insert after the opening brace — first statement line, or body start + 1\n    return body.loc.start.line + 1;\n  }\n  // Arrow function with expression body — use the function start line\n  if (fnPath.node.loc) {\n    return fnPath.node.loc.start.line;\n  }\n  return 0;\n}\n\nfunction hasUseMemoDirective(fnPath: NodePath<BabelFunction>): boolean {\n  const body = fnPath.node.body;\n  if (body.type !== 'BlockStatement') {\n    return false;\n  }\n  for (const directive of body.directives ?? []) {\n    if (directive.value.value === 'use memo') {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Babel plugin that detects manual memoization (useMemo, useCallback, React.memo)\n * within function bodies. Populates a shared Map in plugin options keyed by function location.\n */\nexport function manualMemoPlugin(): PluginObj {\n  return {\n    name: 'manual-memo-detection',\n    visitor: {\n      // eslint-disable-next-line @typescript-eslint/naming-convention\n      CallExpression(path, state) {\n        const opts = state.opts as unknown as ManualMemoPluginOptions;\n        const callee = path.node.callee;\n\n        let hookName: 'useMemo' | 'useCallback' | 'reactMemo' | null = null;\n\n        // Direct call: memo(...), useMemo(...), useCallback(...)\n        if (callee.type === 'Identifier') {\n          const binding = path.scope.getBinding(callee.name);\n          if (binding?.path.parent?.type === 'ImportDeclaration' && binding.path.parent.source.value === 'react') {\n            if (callee.name === 'useMemo') {\n              hookName = 'useMemo';\n            } else if (callee.name === 'useCallback') {\n              hookName = 'useCallback';\n            } else if (callee.name === 'memo') {\n              hookName = 'reactMemo';\n            }\n          }\n        }\n\n        // Member expression: React.memo(...), React.useMemo(...), React.useCallback(...)\n        if (\n          callee.type === 'MemberExpression' &&\n          callee.object.type === 'Identifier' &&\n          callee.property.type === 'Identifier'\n        ) {\n          const binding = path.scope.getBinding(callee.object.name);\n          if (binding?.path.parent?.type === 'ImportDeclaration' && binding.path.parent.source.value === 'react') {\n            if (callee.property.name === 'memo') {\n              hookName = 'reactMemo';\n            } else if (callee.property.name === 'useMemo') {\n              hookName = 'useMemo';\n            } else if (callee.property.name === 'useCallback') {\n              hookName = 'useCallback';\n            }\n          }\n        }\n\n        if (!hookName) {\n          return;\n        }\n\n        // Find the enclosing function\n        const fnPath = path.findParent(\n          p => p.isFunctionDeclaration() || p.isFunctionExpression() || p.isArrowFunctionExpression(),\n        ) as NodePath<BabelFunction> | null;\n\n        if (!fnPath || !fnPath.node.loc) {\n          return;\n        }\n\n        // Skip functions that already have 'use memo' directive\n        if (hasUseMemoDirective(fnPath)) {\n          return;\n        }\n\n        const key = fnKey(fnPath.node.loc.start);\n        let entry = opts.results.get(key);\n\n        if (!entry) {\n          entry = {\n            useMemo: 0,\n            useCallback: 0,\n            reactMemo: false,\n            bodyInsertionLine: getBodyInsertionLine(fnPath),\n          };\n          opts.results.set(key, entry);\n        }\n\n        if (hookName === 'useMemo') {\n          entry.useMemo++;\n        } else if (hookName === 'useCallback') {\n          entry.useCallback++;\n        } else if (hookName === 'reactMemo') {\n          entry.reactMemo = true;\n        }\n      },\n    },\n  };\n}\n"],"names":["manualMemoPlugin","fnKey","loc","line","column","getBodyInsertionLine","fnPath","body","node","type","start","hasUseMemoDirective","directive","directives","value","name","visitor","CallExpression","path","state","opts","callee","hookName","binding","scope","getBinding","parent","source","object","property","findParent","p","isFunctionDeclaration","isFunctionExpression","isArrowFunctionExpression","key","entry","results","get","useMemo","useCallback","reactMemo","bodyInsertionLine","set"],"mappings":"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"}

package/dist/src/reporter.d.ts

@@ -0,0 +1,9 @@
+import type { DirectiveAnalysis } from './types';
+/**
+ * Print a markdown-formatted report of all directive analyses, grouped by package and status.
+ */
+export declare function printReport(results: DirectiveAnalysis[], workspaceRoot: string, fullReasons: boolean): void;
+/**
+ * Print a summary of the analysis results.
+ */
+export declare function printSummary(results: DirectiveAnalysis[]): void;

package/dist/src/reporter.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    printReport: function() {
+        return printReport;
+    },
+    printSummary: function() {
+        return printSummary;
+    }
+});
+const _nodepath = require("node:path");
+const TABLE_REASON_MAX_LEN = 80;
+function printReport(results, workspaceRoot, fullReasons) {
+    if (results.length === 0) {
+        console.log("\nNo 'use no memo' directives found.");
+        return;
+    }
+    // Group by package
+    const byPackage = new Map();
+    for (const r of results){
+        const existing = byPackage.get(r.packageName) ?? [];
+        existing.push(r);
+        byPackage.set(r.packageName, existing);
+    }
+    // Sort packages alphabetically
+    const sortedPackages = [
+        ...byPackage.keys()
+    ].sort();
+    for (const pkg of sortedPackages){
+        const pkgResults = byPackage.get(pkg);
+        const active = pkgResults.filter((r)=>r.status === 'active');
+        const redundant = pkgResults.filter((r)=>r.status === 'redundant');
+        const skipped = pkgResults.filter((r)=>r.status === 'skipped');
+        console.log(`\n## ${pkg}\n`);
+        if (active.length > 0) {
+            console.log('### Active (needs `// justified:` comment)\n');
+            printTable(active, workspaceRoot, fullReasons);
+        }
+        if (redundant.length > 0) {
+            console.log('### Redundant (removable)\n');
+            printTable(redundant, workspaceRoot, fullReasons);
+        }
+        if (skipped.length > 0) {
+            console.log('### Skipped (already justified)\n');
+            printTable(skipped, workspaceRoot, fullReasons);
+        }
+    }
+}
+function printTable(results, workspaceRoot, fullReasons) {
+    console.log('| Location | Function | Compiler Event | Reason |');
+    console.log('|----------|----------|----------------|--------|');
+    for (const r of results){
+        const relPath = (0, _nodepath.relative)(workspaceRoot, r.filePath);
+        const fn = r.functionName ?? '(unknown)';
+        const reason = r.reason ? fullReasons ? escapeTableCell(r.reason) : truncate(r.reason, TABLE_REASON_MAX_LEN) : '';
+        console.log(`| ${relPath}:${r.line} | ${fn} | ${r.compilerEvent} | ${reason} |`);
+    }
+    console.log('');
+    if (fullReasons) {
+        // Print full reasons as details blocks below the table for readability
+        const withReasons = results.filter((r)=>r.reason && r.reason.includes('\n'));
+        if (withReasons.length > 0) {
+            console.log('<details><summary>Full compiler output</summary>\n');
+            for (const r of withReasons){
+                const relPath = (0, _nodepath.relative)(workspaceRoot, r.filePath);
+                const fn = r.functionName ?? '(unknown)';
+                console.log(`#### ${relPath}:${r.line} — ${fn}\n`);
+                console.log('```');
+                console.log(r.reason);
+                console.log('```\n');
+            }
+            console.log('</details>\n');
+        }
+    }
+}
+function printSummary(results) {
+    const total = results.length;
+    const redundant = results.filter((r)=>r.status === 'redundant').length;
+    const active = results.filter((r)=>r.status === 'active').length;
+    const skipped = results.filter((r)=>r.status === 'skipped').length;
+    console.log('## Summary\n');
+    console.log(`- **Total directives:** ${total}`);
+    console.log(`- **Redundant** (removable): ${redundant}`);
+    console.log(`- **Active** (needs \`// justified:\` comment): ${active}`);
+    console.log(`- **Skipped** (already justified): ${skipped}`);
+    console.log('');
+    if (redundant > 0 && active > 0) {
+        console.log(`> **${redundant}** redundant directive(s) can be safely removed.`);
+        console.log(`> **${active}** active directive(s) need a \`// justified: <reason>\` comment — the compiler would optimize these functions without the directive.`);
+        console.log('>');
+        console.log('> Run with `--fix` to auto-remove redundant directives and annotate active ones.\n');
+    } else if (redundant > 0) {
+        console.log(`> **${redundant}** redundant \`'use no memo'\` directive(s) found.`);
+        console.log('> Run with `--fix` to auto-remove them.\n');
+    } else if (active > 0) {
+        console.log(`> **${active}** active directive(s) need a \`// justified: <reason>\` comment.`);
+        console.log('> Run with `--fix` to annotate them.\n');
+    } else console.log('> All directives are justified. Nothing to do.\n');
+}
+function truncate(str, maxLen) {
+    const cleaned = str.replace(/\n/g, ' ');
+    return cleaned.length > maxLen ? cleaned.slice(0, maxLen - 3) + '...' : cleaned;
+}
+function escapeTableCell(str) {
+    // For table cells, collapse to single line
+    return str.replace(/\n/g, ' ').replace(/\|/g, '\\|');
+}
+
+//# sourceMappingURL=reporter.js.map

package/dist/src/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/reporter.ts"],"sourcesContent":["import { relative } from 'node:path';\n\nimport type { DirectiveAnalysis } from './types';\n\nconst TABLE_REASON_MAX_LEN = 80;\n\n/**\n * Print a markdown-formatted report of all directive analyses, grouped by package and status.\n */\nexport function printReport(results: DirectiveAnalysis[], workspaceRoot: string, fullReasons: boolean): void {\n  if (results.length === 0) {\n    console.log(\"\\nNo 'use no memo' directives found.\");\n    return;\n  }\n\n  // Group by package\n  const byPackage = new Map<string, DirectiveAnalysis[]>();\n  for (const r of results) {\n    const existing = byPackage.get(r.packageName) ?? [];\n    existing.push(r);\n    byPackage.set(r.packageName, existing);\n  }\n\n  // Sort packages alphabetically\n  const sortedPackages = [...byPackage.keys()].sort();\n\n  for (const pkg of sortedPackages) {\n    const pkgResults = byPackage.get(pkg)!;\n    const active = pkgResults.filter(r => r.status === 'active');\n    const redundant = pkgResults.filter(r => r.status === 'redundant');\n    const skipped = pkgResults.filter(r => r.status === 'skipped');\n\n    console.log(`\\n## ${pkg}\\n`);\n\n    if (active.length > 0) {\n      console.log('### Active (needs `// justified:` comment)\\n');\n      printTable(active, workspaceRoot, fullReasons);\n    }\n\n    if (redundant.length > 0) {\n      console.log('### Redundant (removable)\\n');\n      printTable(redundant, workspaceRoot, fullReasons);\n    }\n\n    if (skipped.length > 0) {\n      console.log('### Skipped (already justified)\\n');\n      printTable(skipped, workspaceRoot, fullReasons);\n    }\n  }\n}\n\nfunction printTable(results: DirectiveAnalysis[], workspaceRoot: string, fullReasons: boolean): void {\n  console.log('| Location | Function | Compiler Event | Reason |');\n  console.log('|----------|----------|----------------|--------|');\n\n  for (const r of results) {\n    const relPath = relative(workspaceRoot, r.filePath);\n    const fn = r.functionName ?? '(unknown)';\n    const reason = r.reason ? (fullReasons ? escapeTableCell(r.reason) : truncate(r.reason, TABLE_REASON_MAX_LEN)) : '';\n    console.log(`| ${relPath}:${r.line} | ${fn} | ${r.compilerEvent} | ${reason} |`);\n  }\n  console.log('');\n\n  if (fullReasons) {\n    // Print full reasons as details blocks below the table for readability\n    const withReasons = results.filter(r => r.reason && r.reason.includes('\\n'));\n    if (withReasons.length > 0) {\n      console.log('<details><summary>Full compiler output</summary>\\n');\n      for (const r of withReasons) {\n        const relPath = relative(workspaceRoot, r.filePath);\n        const fn = r.functionName ?? '(unknown)';\n        console.log(`#### ${relPath}:${r.line} — ${fn}\\n`);\n        console.log('```');\n        console.log(r.reason);\n        console.log('```\\n');\n      }\n      console.log('</details>\\n');\n    }\n  }\n}\n\n/**\n * Print a summary of the analysis results.\n */\nexport function printSummary(results: DirectiveAnalysis[]): void {\n  const total = results.length;\n  const redundant = results.filter(r => r.status === 'redundant').length;\n  const active = results.filter(r => r.status === 'active').length;\n  const skipped = results.filter(r => r.status === 'skipped').length;\n\n  console.log('## Summary\\n');\n  console.log(`- **Total directives:** ${total}`);\n  console.log(`- **Redundant** (removable): ${redundant}`);\n  console.log(`- **Active** (needs \\`// justified:\\` comment): ${active}`);\n  console.log(`- **Skipped** (already justified): ${skipped}`);\n  console.log('');\n\n  if (redundant > 0 && active > 0) {\n    console.log(`> **${redundant}** redundant directive(s) can be safely removed.`);\n    console.log(\n      `> **${active}** active directive(s) need a \\`// justified: <reason>\\` comment — the compiler would optimize these functions without the directive.`,\n    );\n    console.log('>');\n    console.log('> Run with `--fix` to auto-remove redundant directives and annotate active ones.\\n');\n  } else if (redundant > 0) {\n    console.log(`> **${redundant}** redundant \\`'use no memo'\\` directive(s) found.`);\n    console.log('> Run with `--fix` to auto-remove them.\\n');\n  } else if (active > 0) {\n    console.log(`> **${active}** active directive(s) need a \\`// justified: <reason>\\` comment.`);\n    console.log('> Run with `--fix` to annotate them.\\n');\n  } else {\n    console.log('> All directives are justified. Nothing to do.\\n');\n  }\n}\n\nfunction truncate(str: string, maxLen: number): string {\n  const cleaned = str.replace(/\\n/g, ' ');\n  return cleaned.length > maxLen ? cleaned.slice(0, maxLen - 3) + '...' : cleaned;\n}\n\nfunction escapeTableCell(str: string): string {\n  // For table cells, collapse to single line\n  return str.replace(/\\n/g, ' ').replace(/\\|/g, '\\\\|');\n}\n"],"names":["printReport","printSummary","TABLE_REASON_MAX_LEN","results","workspaceRoot","fullReasons","length","console","log","byPackage","Map","r","existing","get","packageName","push","set","sortedPackages","keys","sort","pkg","pkgResults","active","filter","status","redundant","skipped","printTable","relPath","relative","filePath","fn","functionName","reason","escapeTableCell","truncate","line","compilerEvent","withReasons","includes","total","str","maxLen","cleaned","replace","slice"],"mappings":";;;;;;;;;;;IASgBA,WAAW;eAAXA;;IA2EAC,YAAY;eAAZA;;;0BApFS;AAIzB,MAAMC,uBAAuB;AAKtB,SAASF,YAAYG,OAA4B,EAAEC,aAAqB,EAAEC,WAAoB;IACnG,IAAIF,QAAQG,MAAM,KAAK,GAAG;QACxBC,QAAQC,GAAG,CAAC;QACZ;IACF;IAEA,mBAAmB;IACnB,MAAMC,YAAY,IAAIC;IACtB,KAAK,MAAMC,KAAKR,QAAS;QACvB,MAAMS,WAAWH,UAAUI,GAAG,CAACF,EAAEG,WAAW,KAAK,EAAE;QACnDF,SAASG,IAAI,CAACJ;QACdF,UAAUO,GAAG,CAACL,EAAEG,WAAW,EAAEF;IAC/B;IAEA,+BAA+B;IAC/B,MAAMK,iBAAiB;WAAIR,UAAUS,IAAI;KAAG,CAACC,IAAI;IAEjD,KAAK,MAAMC,OAAOH,eAAgB;QAChC,MAAMI,aAAaZ,UAAUI,GAAG,CAACO;QACjC,MAAME,SAASD,WAAWE,MAAM,CAACZ,CAAAA,IAAKA,EAAEa,MAAM,KAAK;QACnD,MAAMC,YAAYJ,WAAWE,MAAM,CAACZ,CAAAA,IAAKA,EAAEa,MAAM,KAAK;QACtD,MAAME,UAAUL,WAAWE,MAAM,CAACZ,CAAAA,IAAKA,EAAEa,MAAM,KAAK;QAEpDjB,QAAQC,GAAG,CAAC,CAAC,KAAK,EAAEY,IAAI,EAAE,CAAC;QAE3B,IAAIE,OAAOhB,MAAM,GAAG,GAAG;YACrBC,QAAQC,GAAG,CAAC;YACZmB,WAAWL,QAAQlB,eAAeC;QACpC;QAEA,IAAIoB,UAAUnB,MAAM,GAAG,GAAG;YACxBC,QAAQC,GAAG,CAAC;YACZmB,WAAWF,WAAWrB,eAAeC;QACvC;QAEA,IAAIqB,QAAQpB,MAAM,GAAG,GAAG;YACtBC,QAAQC,GAAG,CAAC;YACZmB,WAAWD,SAAStB,eAAeC;QACrC;IACF;AACF;AAEA,SAASsB,WAAWxB,OAA4B,EAAEC,aAAqB,EAAEC,WAAoB;IAC3FE,QAAQC,GAAG,CAAC;IACZD,QAAQC,GAAG,CAAC;IAEZ,KAAK,MAAMG,KAAKR,QAAS;QACvB,MAAMyB,UAAUC,IAAAA,kBAAQ,EAACzB,eAAeO,EAAEmB,QAAQ;QAClD,MAAMC,KAAKpB,EAAEqB,YAAY,IAAI;QAC7B,MAAMC,SAAStB,EAAEsB,MAAM,GAAI5B,cAAc6B,gBAAgBvB,EAAEsB,MAAM,IAAIE,SAASxB,EAAEsB,MAAM,EAAE/B,wBAAyB;QACjHK,QAAQC,GAAG,CAAC,CAAC,EAAE,EAAEoB,QAAQ,CAAC,EAAEjB,EAAEyB,IAAI,CAAC,GAAG,EAAEL,GAAG,GAAG,EAAEpB,EAAE0B,aAAa,CAAC,GAAG,EAAEJ,OAAO,EAAE,CAAC;IACjF;IACA1B,QAAQC,GAAG,CAAC;IAEZ,IAAIH,aAAa;QACf,uEAAuE;QACvE,MAAMiC,cAAcnC,QAAQoB,MAAM,CAACZ,CAAAA,IAAKA,EAAEsB,MAAM,IAAItB,EAAEsB,MAAM,CAACM,QAAQ,CAAC;QACtE,IAAID,YAAYhC,MAAM,GAAG,GAAG;YAC1BC,QAAQC,GAAG,CAAC;YACZ,KAAK,MAAMG,KAAK2B,YAAa;gBAC3B,MAAMV,UAAUC,IAAAA,kBAAQ,EAACzB,eAAeO,EAAEmB,QAAQ;gBAClD,MAAMC,KAAKpB,EAAEqB,YAAY,IAAI;gBAC7BzB,QAAQC,GAAG,CAAC,CAAC,KAAK,EAAEoB,QAAQ,CAAC,EAAEjB,EAAEyB,IAAI,CAAC,GAAG,EAAEL,GAAG,EAAE,CAAC;gBACjDxB,QAAQC,GAAG,CAAC;gBACZD,QAAQC,GAAG,CAACG,EAAEsB,MAAM;gBACpB1B,QAAQC,GAAG,CAAC;YACd;YACAD,QAAQC,GAAG,CAAC;QACd;IACF;AACF;AAKO,SAASP,aAAaE,OAA4B;IACvD,MAAMqC,QAAQrC,QAAQG,MAAM;IAC5B,MAAMmB,YAAYtB,QAAQoB,MAAM,CAACZ,CAAAA,IAAKA,EAAEa,MAAM,KAAK,aAAalB,MAAM;IACtE,MAAMgB,SAASnB,QAAQoB,MAAM,CAACZ,CAAAA,IAAKA,EAAEa,MAAM,KAAK,UAAUlB,MAAM;IAChE,MAAMoB,UAAUvB,QAAQoB,MAAM,CAACZ,CAAAA,IAAKA,EAAEa,MAAM,KAAK,WAAWlB,MAAM;IAElEC,QAAQC,GAAG,CAAC;IACZD,QAAQC,GAAG,CAAC,CAAC,wBAAwB,EAAEgC,OAAO;IAC9CjC,QAAQC,GAAG,CAAC,CAAC,6BAA6B,EAAEiB,WAAW;IACvDlB,QAAQC,GAAG,CAAC,CAAC,gDAAgD,EAAEc,QAAQ;IACvEf,QAAQC,GAAG,CAAC,CAAC,mCAAmC,EAAEkB,SAAS;IAC3DnB,QAAQC,GAAG,CAAC;IAEZ,IAAIiB,YAAY,KAAKH,SAAS,GAAG;QAC/Bf,QAAQC,GAAG,CAAC,CAAC,IAAI,EAAEiB,UAAU,gDAAgD,CAAC;QAC9ElB,QAAQC,GAAG,CACT,CAAC,IAAI,EAAEc,OAAO,qIAAqI,CAAC;QAEtJf,QAAQC,GAAG,CAAC;QACZD,QAAQC,GAAG,CAAC;IACd,OAAO,IAAIiB,YAAY,GAAG;QACxBlB,QAAQC,GAAG,CAAC,CAAC,IAAI,EAAEiB,UAAU,kDAAkD,CAAC;QAChFlB,QAAQC,GAAG,CAAC;IACd,OAAO,IAAIc,SAAS,GAAG;QACrBf,QAAQC,GAAG,CAAC,CAAC,IAAI,EAAEc,OAAO,iEAAiE,CAAC;QAC5Ff,QAAQC,GAAG,CAAC;IACd,OACED,QAAQC,GAAG,CAAC;AAEhB;AAEA,SAAS2B,SAASM,GAAW,EAAEC,MAAc;IAC3C,MAAMC,UAAUF,IAAIG,OAAO,CAAC,OAAO;IACnC,OAAOD,QAAQrC,MAAM,GAAGoC,SAASC,QAAQE,KAAK,CAAC,GAAGH,SAAS,KAAK,QAAQC;AAC1E;AAEA,SAAST,gBAAgBO,GAAW;IAClC,2CAA2C;IAC3C,OAAOA,IAAIG,OAAO,CAAC,OAAO,KAAKA,OAAO,CAAC,OAAO;AAChD"}

package/dist/src/types.d.ts

@@ -0,0 +1,70 @@
+export interface FileEntry {
+    filePath: string;
+    packageName: string;
+}
+export type DirectiveStatus = 'redundant' | 'active' | 'skipped';
+export interface DirectiveLocation {
+    /** 1-based line number in the original source */
+    line: number;
+    /** The full text of the directive line (for removal) */
+    lineText: string;
+    /** Whether the directive has a `// justified: <reason>` comment */
+    justified: boolean;
+    /** The justification reason, if present */
+    justification?: string;
+}
+export interface DirectiveAnalysis {
+    filePath: string;
+    packageName: string;
+    line: number;
+    functionName: string | null;
+    status: DirectiveStatus;
+    compilerEvent: 'CompileError' | 'CompileSuccess' | 'PipelineError' | 'none' | 'skipped';
+    reason?: string;
+}
+export interface AnalyzerOptions {
+    concurrency: number;
+    verbose: boolean;
+}
+export interface FixResult {
+    filesModified: number;
+    directivesRemoved: number;
+    directivesJustified: number;
+}
+export type CompilationMode = 'infer' | 'annotation' | 'all';
+export type FunctionStatus = 'compiled' | 'skipped' | 'error';
+export interface MemoStats {
+    memoSlots: number;
+    memoBlocks: number;
+    memoValues: number;
+    prunedMemoBlocks: number;
+    prunedMemoValues: number;
+}
+export interface ManualMemoization {
+    useMemo: number;
+    useCallback: number;
+    reactMemo: boolean;
+}
+export interface FunctionAnalysis {
+    filePath: string;
+    packageName: string;
+    line: number;
+    column: number;
+    functionName: string | null;
+    status: FunctionStatus;
+    compilerEvent: 'CompileSuccess' | 'CompileError' | 'CompileSkip' | 'PipelineError';
+    reason?: string;
+    memoStats?: MemoStats;
+    manualMemo?: ManualMemoization;
+    bodyInsertionLine?: number;
+}
+export interface AnnotateResult {
+    filesModified: number;
+    functionsAnnotated: number;
+}
+export interface CoverageAnalyzerOptions {
+    concurrency: number;
+    verbose: boolean;
+    compilationMode: CompilationMode;
+    annotate?: boolean;
+}

package/dist/src/types.js

@@ -0,0 +1,7 @@
+// ── Shared types ──
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types.ts"],"sourcesContent":["// ── Shared types ──\n\nexport interface FileEntry {\n  filePath: string;\n  packageName: string;\n}\n\n// ── Directive analysis types ──\n\nexport type DirectiveStatus = 'redundant' | 'active' | 'skipped';\n\nexport interface DirectiveLocation {\n  /** 1-based line number in the original source */\n  line: number;\n  /** The full text of the directive line (for removal) */\n  lineText: string;\n  /** Whether the directive has a `// justified: <reason>` comment */\n  justified: boolean;\n  /** The justification reason, if present */\n  justification?: string;\n}\n\nexport interface DirectiveAnalysis {\n  filePath: string;\n  packageName: string;\n  line: number;\n  functionName: string | null;\n  status: DirectiveStatus;\n  compilerEvent: 'CompileError' | 'CompileSuccess' | 'PipelineError' | 'none' | 'skipped';\n  reason?: string;\n}\n\nexport interface AnalyzerOptions {\n  concurrency: number;\n  verbose: boolean;\n}\n\nexport interface FixResult {\n  filesModified: number;\n  directivesRemoved: number;\n  directivesJustified: number;\n}\n\n// ── Coverage analysis types ──\n\nexport type CompilationMode = 'infer' | 'annotation' | 'all';\n\nexport type FunctionStatus = 'compiled' | 'skipped' | 'error';\n\nexport interface MemoStats {\n  memoSlots: number;\n  memoBlocks: number;\n  memoValues: number;\n  prunedMemoBlocks: number;\n  prunedMemoValues: number;\n}\n\nexport interface ManualMemoization {\n  useMemo: number;\n  useCallback: number;\n  reactMemo: boolean;\n}\n\nexport interface FunctionAnalysis {\n  filePath: string;\n  packageName: string;\n  line: number;\n  column: number;\n  functionName: string | null;\n  status: FunctionStatus;\n  compilerEvent: 'CompileSuccess' | 'CompileError' | 'CompileSkip' | 'PipelineError';\n  reason?: string;\n  memoStats?: MemoStats;\n  manualMemo?: ManualMemoization;\n  bodyInsertionLine?: number;\n}\n\nexport interface AnnotateResult {\n  filesModified: number;\n  functionsAnnotated: number;\n}\n\nexport interface CoverageAnalyzerOptions {\n  concurrency: number;\n  verbose: boolean;\n  compilationMode: CompilationMode;\n  annotate?: boolean;\n}\n"],"names":[],"mappings":"AAAA,qBAAqB"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@fluentui/react-compiler-analyzer",
+  "version": "0.0.0-experimental.rc-analyzer.20260430-fc3bb2e193.0",
+  "type": "commonjs",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "bin",
+    "*.md",
+    "dist",
+    "lib",
+    "lib-commonjs"
+  ],
+  "bin": {
+    "react-compiler-analyzer": "./bin/react-compiler-analyzer.js"
+  },
+  "dependencies": {
+    "@swc/helpers": "~0.5.1",
+    "yargs": "^17.7.2",
+    "@babel/core": "^7.28.5",
+    "@babel/preset-typescript": "^7.28.5",
+    "babel-plugin-react-compiler": "^1.0.0"
+  }
+}