miniread 1.71.0 → 1.73.0

package/dist/transforms/_generated/manifest.js

@@ -140,6 +140,10 @@ const manifestData = {
         notes: "Measured with baseline none: 100.00%. Added to recommended for readability.",
         evaluations: { "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 100, "evaluatedAt": "2026-02-05T18:46:50.023Z", "changedLines": 4, "durationSeconds": 165.60063108, "stableNames": 1358 } },
     },
+    "rename-file-reader-variables": {
+        recommended: true,
+        evaluations: { "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 100, "evaluatedAt": "2026-02-05T18:45:30.224Z", "changedLines": 56, "durationSeconds": 179.39064335899997, "stableNames": 1358 } },
+    },
     "rename-fs-sync-variables": {
         recommended: true,
         notes: "Auto-added by evaluation script. Note: rename transforms can slightly increase diff size in isolation (longer identifiers), but the goal here is stability/readability and improved alignment when composed with other transforms in the recommended preset. Safety: skips files with obvious dynamic name-lookup patterns (e.g. free `eval` / `Function` / `with`) since string-based lookups are not rewritten by renames.",
@@ -323,6 +327,11 @@ const manifestData = {
         recommended: true,
         evaluations: { "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 100, "evaluatedAt": "2026-02-01T22:24:10.587Z", "changedLines": 8, "durationSeconds": 154.843114025, "stableNames": 1358 } },
     },
+    "rename-zod-check-parameters": {
+        recommended: true,
+        notes: "Auto-added by evaluation script.",
+        evaluations: { "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 100, "evaluatedAt": "2026-02-05T18:47:17.374Z", "changedLines": 198, "durationSeconds": 166.72227692599998, "stableNames": 1358 } },
+    },
     "replace-dynamic-require-eval": {
         recommended: true,
         notes: "Rewrites the obfuscated Node.js dynamic require pattern `eval(\"quire\".replace(/^/, \"re\"))(x)` into a direct call to the local `createRequire(import.meta.url)` function (e.g. `require(x)`). This reduces direct-eval usage for this specific case and can unblock other transforms that conservatively bail out when `eval` is present.",
@@ -422,6 +431,7 @@ export const recommendedTransformIds = [
     "rename-destructured-aliases",
     "rename-rest-parameters",
     "rename-execfile-arguments",
+    "rename-file-reader-variables",
     "rename-error-first-callback-parameters",
     "rename-error-variables",
     "rename-event-parameters",
@@ -453,6 +463,7 @@ export const recommendedTransformIds = [
     "rename-use-reference-guards-v2",
     "rename-use-reference-sets",
     "rename-worker-handles",
+    "rename-zod-check-parameters",
     "simplify-boolean-negations",
     "simplify-string-trim",
     "split-variable-declarations",

package/dist/transforms/_generated/registry.js

@@ -28,6 +28,7 @@ import { renameErrorVariablesTransform } from "../rename-error-variables/rename-
 import { renameEventParametersTransform } from "../rename-event-parameters/rename-event-parameters-transform.js";
 import { renameExecfileArgumentsTransform } from "../rename-execfile-arguments/rename-execfile-arguments-transform.js";
 import { renameFileExtensionVariablesTransform } from "../rename-file-extension-variables/rename-file-extension-variables-transform.js";
+import { renameFileReaderVariablesTransform } from "../rename-file-reader-variables/rename-file-reader-variables-transform.js";
 import { renameFsSyncVariablesTransform } from "../rename-fs-sync-variables/rename-fs-sync-variables-transform.js";
 import { renameHttpMethodParametersTransform } from "../rename-http-method-parameters/rename-http-method-parameters-transform.js";
 import { renameHttpServerParametersTransform } from "../rename-http-server-parameters/rename-http-server-parameters-transform.js";
@@ -66,6 +67,7 @@ import { renameUseReferenceGuardsTransform } from "../rename-use-reference-guard
 import { renameUseReferenceGuardsV2Transform } from "../rename-use-reference-guards-v2/rename-use-reference-guards-v2-transform.js";
 import { renameUseReferenceSetsTransform } from "../rename-use-reference-sets/rename-use-reference-sets-transform.js";
 import { renameWorkerHandlesTransform } from "../rename-worker-handles/rename-worker-handles-transform.js";
+import { renameZodCheckParametersTransform } from "../rename-zod-check-parameters/rename-zod-check-parameters-transform.js";
 import { replaceDynamicRequireEvalTransform } from "../replace-dynamic-require-eval/replace-dynamic-require-eval-transform.js";
 import { simplifyBooleanNegationsTransform } from "../simplify-boolean-negations/simplify-boolean-negations-transform.js";
 import { simplifyStringTrimTransform } from "../simplify-string-trim/simplify-string-trim-transform.js";
@@ -106,6 +108,7 @@ export const transformRegistry = {
     [renameEventParametersTransform.id]: renameEventParametersTransform,
     [renameExecfileArgumentsTransform.id]: renameExecfileArgumentsTransform,
     [renameFileExtensionVariablesTransform.id]: renameFileExtensionVariablesTransform,
+    [renameFileReaderVariablesTransform.id]: renameFileReaderVariablesTransform,
     [renameFsSyncVariablesTransform.id]: renameFsSyncVariablesTransform,
     [renameHttpMethodParametersTransform.id]: renameHttpMethodParametersTransform,
     [renameHttpServerParametersTransform.id]: renameHttpServerParametersTransform,
@@ -144,6 +147,7 @@ export const transformRegistry = {
     [renameUseReferenceGuardsV2Transform.id]: renameUseReferenceGuardsV2Transform,
     [renameUseReferenceSetsTransform.id]: renameUseReferenceSetsTransform,
     [renameWorkerHandlesTransform.id]: renameWorkerHandlesTransform,
+    [renameZodCheckParametersTransform.id]: renameZodCheckParametersTransform,
     [replaceDynamicRequireEvalTransform.id]: replaceDynamicRequireEvalTransform,
     [simplifyBooleanNegationsTransform.id]: simplifyBooleanNegationsTransform,
     [simplifyStringTrimTransform.id]: simplifyStringTrimTransform,

package/dist/transforms/recommended-transform-order.d.ts

@@ -4,4 +4,4 @@
  * This lets us tune transform interactions intentionally instead of relying on
  * alphabetical ID sorting.
  */
-export declare const recommendedTransformOrder: readonly ["stabilize-top-level-bindings", "stabilize-nested-bindings", "stabilize-deferred-top-level-bindings", "stabilize-deferred-stable-rhs", "expand-boolean-literals", "expand-sequence-expressions-v5", "expand-special-number-literals", "expand-typeof-undefined-comparisons", "expand-undefined-literals", "remove-redundant-else", "rename-arguments-length-flags", "rename-asap-wrappers", "rename-awaiter-parameters", "rename-awaiter-helper-functions", "rename-buffer-variables", "rename-to-buffer-results", "rename-catch-parameters", "rename-promise-catch-parameters", "rename-char-code-at", "rename-charcode-variables-v2", "rename-client-aliases", "rename-comparison-flags", "rename-date-now-start-times", "rename-default-options-parameters", "rename-deferred-resolve-parameters", "rename-destructured-aliases", "rename-rest-parameters", "rename-execfile-arguments", "rename-error-first-callback-parameters", "rename-error-variables", "rename-event-parameters", "rename-http-server-parameters", "rename-fs-sync-variables", "rename-http-method-parameters", "rename-interval-ids", "rename-loop-index-variables-v3", "rename-loop-length-variables", "rename-document-fragment-variables", "rename-object-keys-variables", "rename-object-keys-iterator-variables", "rename-parameters-to-match-properties-v2", "rename-promise-executor-parameters-v2", "rename-range-parameters", "rename-read-file-lines", "rename-regex-builders", "rename-regex-source-parameters", "rename-search-parameters-variables", "rename-file-extension-variables", "rename-string-split-variables", "rename-this-aliases", "rename-timeout-ids", "rename-typeof-variables", "rename-typescript-helper-aliases", "rename-uint8array-concat-variables", "rename-url-parameters", "rename-url-variables", "rename-use-reference-guards-v2", "rename-use-reference-sets", "rename-worker-handles", "simplify-boolean-negations", "simplify-string-trim", "split-variable-declarations", "use-optional-chaining", "use-object-property-shorthand", "use-object-shorthand", "replace-dynamic-require-eval"];
+export declare const recommendedTransformOrder: readonly ["stabilize-top-level-bindings", "stabilize-nested-bindings", "stabilize-deferred-top-level-bindings", "stabilize-deferred-stable-rhs", "expand-boolean-literals", "expand-sequence-expressions-v5", "expand-special-number-literals", "expand-typeof-undefined-comparisons", "expand-undefined-literals", "remove-redundant-else", "rename-arguments-length-flags", "rename-asap-wrappers", "rename-awaiter-parameters", "rename-awaiter-helper-functions", "rename-buffer-variables", "rename-to-buffer-results", "rename-catch-parameters", "rename-promise-catch-parameters", "rename-char-code-at", "rename-charcode-variables-v2", "rename-client-aliases", "rename-comparison-flags", "rename-date-now-start-times", "rename-default-options-parameters", "rename-deferred-resolve-parameters", "rename-destructured-aliases", "rename-rest-parameters", "rename-execfile-arguments", "rename-file-reader-variables", "rename-error-first-callback-parameters", "rename-error-variables", "rename-event-parameters", "rename-http-server-parameters", "rename-fs-sync-variables", "rename-http-method-parameters", "rename-interval-ids", "rename-loop-index-variables-v3", "rename-loop-length-variables", "rename-document-fragment-variables", "rename-object-keys-variables", "rename-object-keys-iterator-variables", "rename-parameters-to-match-properties-v2", "rename-promise-executor-parameters-v2", "rename-range-parameters", "rename-read-file-lines", "rename-regex-builders", "rename-regex-source-parameters", "rename-search-parameters-variables", "rename-file-extension-variables", "rename-string-split-variables", "rename-this-aliases", "rename-timeout-ids", "rename-typeof-variables", "rename-typescript-helper-aliases", "rename-uint8array-concat-variables", "rename-url-parameters", "rename-url-variables", "rename-use-reference-guards-v2", "rename-use-reference-sets", "rename-worker-handles", "rename-zod-check-parameters", "simplify-boolean-negations", "simplify-string-trim", "split-variable-declarations", "use-optional-chaining", "use-object-property-shorthand", "use-object-shorthand", "replace-dynamic-require-eval"];

package/dist/transforms/recommended-transform-order.js

@@ -42,6 +42,7 @@ export const recommendedTransformOrder = [
     "rename-destructured-aliases",
     "rename-rest-parameters",
     "rename-execfile-arguments",
+    "rename-file-reader-variables",
     "rename-error-first-callback-parameters",
     "rename-error-variables",
     "rename-event-parameters",
@@ -76,6 +77,7 @@ export const recommendedTransformOrder = [
     "rename-use-reference-guards-v2",
     "rename-use-reference-sets",
     "rename-worker-handles",
+    "rename-zod-check-parameters",
     "simplify-boolean-negations",
     "simplify-string-trim",
     "split-variable-declarations",

package/dist/transforms/rename-file-reader-variables/manifest.json

@@ -0,0 +1,12 @@
+{
+    "recommended": true,
+    "evaluations": {
+        "claude-code-2.1.10:claude-code-2.1.11": {
+            "diffSizePercent": 100,
+            "evaluatedAt": "2026-02-05T18:45:30.224Z",
+            "changedLines": 56,
+            "durationSeconds": 179.39064335899997,
+            "stableNames": 1358
+        }
+    }
+}

package/dist/transforms/rename-file-reader-variables/rename-file-reader-variables-transform.d.ts

@@ -0,0 +1,2 @@
+import { type Transform } from "../../core/types.js";
+export declare const renameFileReaderVariablesTransform: Transform;

package/dist/transforms/rename-file-reader-variables/rename-file-reader-variables-transform.js

@@ -0,0 +1,111 @@
+import { createRequire } from "node:module";
+import { collectExportedNames } from "../../core/collect-exported-names.js";
+import { RenameGroup, isStableRenamed } from "../../core/stable-naming.js";
+import { getFilesToProcess, } from "../../core/types.js";
+const require = createRequire(import.meta.url);
+// eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+const traverse = require("@babel/traverse").default;
+const isTypeOnlyImportSpecifier = (binding, node) => {
+    const declaration = binding.path.parent;
+    if (declaration.type !== "ImportDeclaration") {
+        return false;
+    }
+    if (node.type === "ImportSpecifier" && node.importKind === "type") {
+        return true;
+    }
+    return declaration.importKind === "type";
+};
+const isTypeOnlyFileReaderBinding = (binding) => {
+    const node = binding.path.node;
+    const declaration = binding.path.parent;
+    if (node.type === "ImportSpecifier" ||
+        node.type === "ImportDefaultSpecifier") {
+        return isTypeOnlyImportSpecifier(binding, node);
+    }
+    if (declaration.type === "VariableDeclaration" && declaration.declare) {
+        return true;
+    }
+    if (node.type === "TSDeclareFunction" ||
+        (node.type === "ClassDeclaration" && node.declare === true) ||
+        (node.type === "FunctionDeclaration" && node.declare === true)) {
+        return true;
+    }
+    return (node.type === "TSTypeAliasDeclaration" ||
+        node.type === "TSInterfaceDeclaration");
+};
+const hasRuntimeFileReaderShadowing = (path) => {
+    const binding = path.scope.getBinding("FileReader");
+    // Ambient declarations like `declare class FileReader` typically do not
+    // produce bindings in Babel's TS scope model, so `binding` is often absent.
+    if (!binding) {
+        return false;
+    }
+    // Keep using getBinding so we can inspect and ignore type-only TS bindings.
+    if (isTypeOnlyFileReaderBinding(binding)) {
+        return false;
+    }
+    return true;
+};
+const isFileReaderConstructor = (path) => {
+    const { callee } = path.node;
+    if (callee.type !== "Identifier")
+        return false;
+    if (callee.name !== "FileReader")
+        return false;
+    if (hasRuntimeFileReaderShadowing(path))
+        return false;
+    return true;
+};
+export const renameFileReaderVariablesTransform = {
+    id: "rename-file-reader-variables",
+    description: "Rename variables initialized with new FileReader() to stable fileReader-derived names",
+    scope: "file",
+    parallelizable: true,
+    transform(context) {
+        let nodesVisited = 0;
+        let transformationsApplied = 0;
+        for (const fileInfo of getFilesToProcess(context)) {
+            const renameGroup = new RenameGroup();
+            const exportedNames = collectExportedNames(fileInfo.ast.program);
+            traverse(fileInfo.ast, {
+                VariableDeclarator(path) {
+                    nodesVisited++;
+                    const { id } = path.node;
+                    if (id.type !== "Identifier") {
+                        return;
+                    }
+                    const initPath = path.get("init");
+                    if (Array.isArray(initPath) || !initPath.isNewExpression()) {
+                        return;
+                    }
+                    if (!isFileReaderConstructor(initPath)) {
+                        return;
+                    }
+                    const currentName = id.name;
+                    if (isStableRenamed(currentName)) {
+                        return;
+                    }
+                    // Preserve already-semantic names (e.g. myFileReader) to avoid needless churn.
+                    if (currentName.toLowerCase().includes("filereader")) {
+                        return;
+                    }
+                    const binding = path.scope.getBinding(currentName);
+                    if (!binding?.constant) {
+                        return;
+                    }
+                    if (binding.scope.block.type === "Program" &&
+                        exportedNames.has(currentName)) {
+                        return;
+                    }
+                    renameGroup.add({
+                        scope: path.scope,
+                        currentName,
+                        baseName: "fileReader",
+                    });
+                },
+            });
+            transformationsApplied += renameGroup.apply();
+        }
+        return Promise.resolve({ nodesVisited, transformationsApplied });
+    },
+};

package/dist/transforms/rename-zod-check-parameters/manifest.json

@@ -0,0 +1,13 @@
+{
+    "recommended": true,
+    "evaluations": {
+        "claude-code-2.1.10:claude-code-2.1.11": {
+            "diffSizePercent": 100,
+            "evaluatedAt": "2026-02-05T18:47:17.374Z",
+            "changedLines": 198,
+            "durationSeconds": 166.72227692599998,
+            "stableNames": 1358
+        }
+    },
+    "notes": "Auto-added by evaluation script."
+}

package/dist/transforms/rename-zod-check-parameters/rename-zod-check-parameters-transform.d.ts

@@ -0,0 +1,2 @@
+import { type Transform } from "../../core/types.js";
+export declare const renameZodCheckParametersTransform: Transform;

package/dist/transforms/rename-zod-check-parameters/rename-zod-check-parameters-transform.js

@@ -0,0 +1,105 @@
+import { createRequire } from "node:module";
+import { isStableRenamed, RenameGroup } from "../../core/stable-naming.js";
+import { getFilesToProcess, } from "../../core/types.js";
+const require = createRequire(import.meta.url);
+// eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+const traverse = require("@babel/traverse").default;
+const BASE_NAME = "ctx";
+const isIdentifierProperty = (property, name) => property.type === "Identifier" && property.name === name;
+const isZodCheckMember = (node) => {
+    if (node.computed)
+        return false;
+    if (!isIdentifierProperty(node.property, "check"))
+        return false;
+    const object = node.object;
+    if (object.type !== "MemberExpression")
+        return false;
+    if (object.computed)
+        return false;
+    return isIdentifierProperty(object.property, "_zod");
+};
+const getCheckHandlerParameter = (path) => {
+    if (path.node.left.type !== "MemberExpression")
+        return undefined;
+    if (!isZodCheckMember(path.node.left))
+        return undefined;
+    const rightPath = path.get("right");
+    if (!rightPath.isFunctionExpression() &&
+        !rightPath.isArrowFunctionExpression()) {
+        return undefined;
+    }
+    if (rightPath.node.params.length !== 1)
+        return undefined;
+    const firstParameter = rightPath.node.params[0];
+    if (firstParameter?.type !== "Identifier")
+        return undefined;
+    return firstParameter;
+};
+const isIssuesPushCall = (referencePath) => {
+    if (!referencePath.isIdentifier())
+        return false;
+    // Binding.referencePaths are concrete identifier usages with parent paths,
+    // so we intentionally rely on direct parentPath traversal here.
+    const issuesMemberPath = referencePath.parentPath;
+    if (!issuesMemberPath.isMemberExpression())
+        return false;
+    if (issuesMemberPath.node.object !== referencePath.node)
+        return false;
+    if (issuesMemberPath.node.computed)
+        return false;
+    if (!isIdentifierProperty(issuesMemberPath.node.property, "issues")) {
+        return false;
+    }
+    const pushMemberPath = issuesMemberPath.parentPath;
+    if (!pushMemberPath.isMemberExpression())
+        return false;
+    if (pushMemberPath.node.object !== issuesMemberPath.node)
+        return false;
+    if (pushMemberPath.node.computed)
+        return false;
+    if (!isIdentifierProperty(pushMemberPath.node.property, "push"))
+        return false;
+    const callPath = pushMemberPath.parentPath;
+    if (!callPath.isCallExpression())
+        return false;
+    return callPath.node.callee === pushMemberPath.node;
+};
+const hasIssuesPushCall = (binding) => binding.referencePaths.some((referencePath) => isIssuesPushCall(referencePath));
+export const renameZodCheckParametersTransform = {
+    id: "rename-zod-check-parameters",
+    description: "Renames Zod _zod.check callback parameters to $ctx when issues are pushed",
+    scope: "file",
+    parallelizable: true,
+    transform(context) {
+        let nodesVisited = 0;
+        let transformationsApplied = 0;
+        for (const fileInfo of getFilesToProcess(context)) {
+            const renameGroup = new RenameGroup();
+            traverse(fileInfo.ast, {
+                AssignmentExpression(path) {
+                    nodesVisited++;
+                    const parameter = getCheckHandlerParameter(path);
+                    if (!parameter)
+                        return;
+                    if (isStableRenamed(parameter.name))
+                        return;
+                    const rightPath = path.get("right");
+                    const binding = rightPath.scope.getBinding(parameter.name);
+                    if (!binding)
+                        return;
+                    if (!binding.constant)
+                        return;
+                    if (!hasIssuesPushCall(binding))
+                        return;
+                    renameGroup.add({
+                        scope: binding.scope,
+                        currentName: parameter.name,
+                        baseName: BASE_NAME,
+                    });
+                },
+            });
+            transformationsApplied += renameGroup.apply();
+        }
+        return Promise.resolve({ nodesVisited, transformationsApplied });
+    },
+};

package/package.json

@@ -2,7 +2,7 @@
   "name": "miniread",
   "author": "Łukasz Jerciński",
   "license": "MIT",
-  "version": "1.71.0",
+  "version": "1.73.0",
   "description": "Transform minified JavaScript/TypeScript into a more readable form using deterministic AST-based transforms.",
   "repository": {
     "type": "git",