miniread 1.86.0 → 1.87.0

package/dist/transforms/_generated/manifest.js

@@ -268,6 +268,10 @@ const manifestData = {
         notes: "Supersedes rename-promise-executor-parameters with improved error-handler detection. Intentionally self-contained (helpers duplicated) per docs/workflow.md §3.6.",
         evaluations: { "legacy:evaluation": { "diffSizePercent": 100, "evaluatedAt": "2026-01-25T21:22:01.643Z", "changedLines": 1086, "durationSeconds": 0, "stableNames": 0 }, "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 99.99622028196697, "evaluatedAt": "2026-01-29T14:37:20.798Z", "changedLines": 1102, "durationSeconds": 50.116025500000006, "stableNames": 1359 } },
     },
+    "rename-queue-traversal-variables": {
+        recommended: true,
+        evaluations: { "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 100, "evaluatedAt": "2026-02-06T21:04:31.256Z", "changedLines": 38, "durationSeconds": 223.94200929, "stableNames": 1359 } },
+    },
     "rename-range-parameters": {
         recommended: true,
         notes: "Renames range-style parameters when the count defaults to the start value and start resets to 0.",
@@ -505,6 +509,7 @@ export const recommendedTransformIds = [
     "rename-interval-ids",
     "rename-indexeddb-request-variables",
     "rename-loop-index-variables-v3",
+    "rename-queue-traversal-variables",
     "rename-loop-length-variables",
     "rename-document-fragment-variables",
     "rename-object-keys-variables",

package/dist/transforms/_generated/registry.js

@@ -55,6 +55,7 @@ import { renameProcessStdoutHandlersTransform } from "../rename-process-stdout-h
 import { renamePromiseCatchParametersTransform } from "../rename-promise-catch-parameters/rename-promise-catch-parameters-transform.js";
 import { renamePromiseExecutorParametersTransform } from "../rename-promise-executor-parameters/rename-promise-executor-parameters-transform.js";
 import { renamePromiseExecutorParametersV2Transform } from "../rename-promise-executor-parameters-v2/rename-promise-executor-parameters-v2-transform.js";
+import { renameQueueTraversalVariablesTransform } from "../rename-queue-traversal-variables/rename-queue-traversal-variables-transform.js";
 import { renameRangeParametersTransform } from "../rename-range-parameters/rename-range-parameters-transform.js";
 import { renameReadFileLinesTransform } from "../rename-read-file-lines/rename-read-file-lines-transform.js";
 import { renameRegexBuildersTransform } from "../rename-regex-builders/rename-regex-builders-transform.js";
@@ -148,6 +149,7 @@ export const transformRegistry = {
     [renamePromiseCatchParametersTransform.id]: renamePromiseCatchParametersTransform,
     [renamePromiseExecutorParametersTransform.id]: renamePromiseExecutorParametersTransform,
     [renamePromiseExecutorParametersV2Transform.id]: renamePromiseExecutorParametersV2Transform,
+    [renameQueueTraversalVariablesTransform.id]: renameQueueTraversalVariablesTransform,
     [renameRangeParametersTransform.id]: renameRangeParametersTransform,
     [renameReadFileLinesTransform.id]: renameReadFileLinesTransform,
     [renameRegexBuildersTransform.id]: renameRegexBuildersTransform,

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-platform-win32-flags", "rename-date-now-start-times", "rename-default-options-parameters-v2", "rename-default-options-parameters-v3", "rename-deferred-resolve-parameters", "rename-deferred-resolve-parameters-v2", "rename-destructured-aliases", "rename-rest-parameters", "rename-rest-pop-callbacks", "rename-execfile-arguments", "rename-file-reader-variables", "rename-error-first-callback-parameters", "rename-error-first-callback-parameters-v2", "rename-error-variables", "rename-event-parameters", "rename-add-event-listener-parameters", "rename-http-server-parameters", "rename-fs-sync-variables", "rename-http-method-parameters", "rename-interval-ids", "rename-indexeddb-request-variables", "rename-loop-index-variables-v3", "rename-loop-length-variables", "rename-document-fragment-variables", "rename-object-keys-variables", "rename-object-keys-iterator-variables", "rename-object-keys-reducer-parameters", "rename-object-entries-parameters", "rename-parameters-to-match-properties-v2", "rename-invalid-parameter-arguments", "rename-promise-executor-parameters-v2", "rename-range-parameters", "rename-read-file-lines", "rename-regex-builders", "rename-regex-source-parameters", "rename-search-parameters-variables", "rename-setstate-updater-parameters", "rename-file-extension-variables", "rename-string-split-variables", "rename-this-aliases", "rename-timeout-promises", "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"];
+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-platform-win32-flags", "rename-date-now-start-times", "rename-default-options-parameters-v2", "rename-default-options-parameters-v3", "rename-deferred-resolve-parameters", "rename-deferred-resolve-parameters-v2", "rename-destructured-aliases", "rename-rest-parameters", "rename-rest-pop-callbacks", "rename-execfile-arguments", "rename-file-reader-variables", "rename-error-first-callback-parameters", "rename-error-first-callback-parameters-v2", "rename-error-variables", "rename-event-parameters", "rename-add-event-listener-parameters", "rename-http-server-parameters", "rename-fs-sync-variables", "rename-http-method-parameters", "rename-interval-ids", "rename-indexeddb-request-variables", "rename-loop-index-variables-v3", "rename-queue-traversal-variables", "rename-loop-length-variables", "rename-document-fragment-variables", "rename-object-keys-variables", "rename-object-keys-iterator-variables", "rename-object-keys-reducer-parameters", "rename-object-entries-parameters", "rename-parameters-to-match-properties-v2", "rename-invalid-parameter-arguments", "rename-promise-executor-parameters-v2", "rename-range-parameters", "rename-read-file-lines", "rename-regex-builders", "rename-regex-source-parameters", "rename-search-parameters-variables", "rename-setstate-updater-parameters", "rename-file-extension-variables", "rename-string-split-variables", "rename-this-aliases", "rename-timeout-promises", "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

@@ -61,6 +61,7 @@ export const recommendedTransformOrder = [
     "rename-interval-ids",
     "rename-indexeddb-request-variables",
     "rename-loop-index-variables-v3",
+    "rename-queue-traversal-variables",
     "rename-loop-length-variables",
     "rename-document-fragment-variables",
     "rename-object-keys-variables",

package/dist/transforms/rename-queue-traversal-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-06T21:04:31.256Z",
+            "changedLines": 38,
+            "durationSeconds": 223.94200929,
+            "stableNames": 1359
+        }
+    }
+}

package/dist/transforms/rename-queue-traversal-variables/queue-traversal-heuristics.d.ts

@@ -0,0 +1,14 @@
+import type { NodePath } from "@babel/traverse";
+import type { ForStatement } from "@babel/types";
+type QueueTraversalLoop = {
+    arrayName: string;
+    indexName: string;
+};
+type QueueTraversalUsage = {
+    hasIndexAccess: boolean;
+    hasQueuePush: boolean;
+};
+declare const getQueueTraversalLoop: (path: NodePath<ForStatement>) => QueueTraversalLoop | undefined;
+declare const getQueueTraversalUsage: (path: NodePath<ForStatement>, arrayName: string, indexName: string) => QueueTraversalUsage;
+declare const shouldSkipRename: (currentName: string, targetBaseName: string) => boolean;
+export { getQueueTraversalLoop, getQueueTraversalUsage, shouldSkipRename };

package/dist/transforms/rename-queue-traversal-variables/queue-traversal-heuristics.js

@@ -0,0 +1,131 @@
+import { isStableRenamed } from "../../core/stable-naming.js";
+const getQueueTraversalLoop = (path) => {
+    const init = path.node.init;
+    if (init?.type !== "VariableDeclaration")
+        return undefined;
+    if (init.kind === "const")
+        return undefined;
+    if (init.declarations.length !== 1)
+        return undefined;
+    const declarator = init.declarations[0];
+    if (declarator?.id.type !== "Identifier")
+        return undefined;
+    if (declarator.init?.type !== "NumericLiteral")
+        return undefined;
+    if (declarator.init.value !== 0)
+        return undefined;
+    const indexName = declarator.id.name;
+    const test = path.node.test;
+    if (test?.type !== "BinaryExpression")
+        return undefined;
+    if (test.operator !== "<")
+        return undefined;
+    if (test.left.type !== "Identifier")
+        return undefined;
+    if (test.left.name !== indexName)
+        return undefined;
+    const right = test.right;
+    if (right.type !== "MemberExpression")
+        return undefined;
+    if (right.optional)
+        return undefined;
+    if (right.object.type !== "Identifier")
+        return undefined;
+    if (right.property.type !== "Identifier")
+        return undefined;
+    if (right.property.name !== "length")
+        return undefined;
+    if (right.computed)
+        return undefined;
+    if (path.node.update !== null)
+        return undefined;
+    return {
+        arrayName: right.object.name,
+        indexName,
+    };
+};
+const isQueueIndexAccess = (path, arrayName, indexName, arrayBinding, indexBinding) => {
+    const member = path.node;
+    if (member.optional)
+        return false;
+    if (member.object.type !== "Identifier")
+        return false;
+    if (member.object.name !== arrayName)
+        return false;
+    if (!hasExpectedBinding(path, arrayName, arrayBinding))
+        return false;
+    if (!member.computed)
+        return false;
+    if (member.property.type !== "UpdateExpression")
+        return false;
+    const update = member.property;
+    if (!isPostIncrement(update, indexName))
+        return false;
+    if (!hasExpectedBinding(path, indexName, indexBinding))
+        return false;
+    return true;
+};
+const isPostIncrement = (update, indexName) => {
+    if (update.operator !== "++")
+        return false;
+    if (update.prefix)
+        return false;
+    if (update.argument.type !== "Identifier")
+        return false;
+    return update.argument.name === indexName;
+};
+const isQueuePushCall = (path, arrayName, arrayBinding) => {
+    const call = path.node;
+    if (call.callee.type !== "MemberExpression")
+        return false;
+    if (call.callee.optional)
+        return false;
+    if (call.callee.object.type !== "Identifier")
+        return false;
+    if (call.callee.object.name !== arrayName)
+        return false;
+    if (!hasExpectedBinding(path, arrayName, arrayBinding))
+        return false;
+    if (call.callee.property.type !== "Identifier")
+        return false;
+    if (call.callee.property.name !== "push")
+        return false;
+    if (call.callee.computed)
+        return false;
+    return true;
+};
+const getQueueTraversalUsage = (path, arrayName, indexName) => {
+    const arrayBinding = path.scope.getBinding(arrayName);
+    const indexBinding = path.scope.getBinding(indexName);
+    let hasIndexAccess = false;
+    let hasQueuePush = false;
+    path.get("body").traverse({
+        Function(innerPath) {
+            innerPath.skip();
+        },
+        MemberExpression(memberPath) {
+            if (hasIndexAccess)
+                return;
+            if (isQueueIndexAccess(memberPath, arrayName, indexName, arrayBinding, indexBinding)) {
+                hasIndexAccess = true;
+            }
+        },
+        CallExpression(callPath) {
+            if (hasQueuePush)
+                return;
+            if (isQueuePushCall(callPath, arrayName, arrayBinding)) {
+                hasQueuePush = true;
+            }
+        },
+    });
+    return { hasIndexAccess, hasQueuePush };
+};
+const hasExpectedBinding = (path, name, expectedBinding) => path.scope.getBinding(name) === expectedBinding;
+const shouldSkipRename = (currentName, targetBaseName) => {
+    if (isStableRenamed(currentName))
+        return true;
+    if (currentName === targetBaseName)
+        return true;
+    return false;
+};
+export { getQueueTraversalLoop, getQueueTraversalUsage, shouldSkipRename };

package/dist/transforms/rename-queue-traversal-variables/rename-queue-traversal-variables-transform.d.ts

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

package/dist/transforms/rename-queue-traversal-variables/rename-queue-traversal-variables-transform.js

@@ -0,0 +1,58 @@
+import { createRequire } from "node:module";
+import { RenameGroup } from "../../core/stable-naming.js";
+import { getFilesToProcess, } from "../../core/types.js";
+import { getQueueTraversalLoop, getQueueTraversalUsage, shouldSkipRename, } from "./queue-traversal-heuristics.js";
+const require = createRequire(import.meta.url);
+// eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+const traverse = require("@babel/traverse").default;
+const QUEUE_BASE_NAME = "queue";
+const QUEUE_INDEX_BASE_NAME = "queueIndex";
+export const renameQueueTraversalVariablesTransform = {
+    id: "rename-queue-traversal-variables",
+    description: "Renames array/index variables used for queue-style traversal loops to $queue/$queueIndex (or readable variants when multiple)",
+    scope: "file",
+    parallelizable: true,
+    transform(context) {
+        let nodesVisited = 0;
+        let transformationsApplied = 0;
+        for (const fileInfo of getFilesToProcess(context)) {
+            const queueGroup = new RenameGroup();
+            const queueIndexGroup = new RenameGroup();
+            traverse(fileInfo.ast, {
+                ForStatement(path) {
+                    nodesVisited++;
+                    const loopInfo = getQueueTraversalLoop(path);
+                    if (!loopInfo)
+                        return;
+                    const { arrayName, indexName } = loopInfo;
+                    const queueUsage = getQueueTraversalUsage(path, arrayName, indexName);
+                    if (!queueUsage.hasIndexAccess || !queueUsage.hasQueuePush)
+                        return;
+                    const arrayBinding = path.scope.getBinding(arrayName);
+                    const indexBinding = path.scope.getBinding(indexName);
+                    if (arrayBinding && !shouldSkipRename(arrayName, QUEUE_BASE_NAME)) {
+                        queueGroup.add({
+                            scope: arrayBinding.scope,
+                            currentName: arrayName,
+                            baseName: QUEUE_BASE_NAME,
+                        });
+                    }
+                    if (indexBinding &&
+                        !shouldSkipRename(indexName, QUEUE_INDEX_BASE_NAME)) {
+                        queueIndexGroup.add({
+                            scope: indexBinding.scope,
+                            currentName: indexName,
+                            baseName: QUEUE_INDEX_BASE_NAME,
+                        });
+                    }
+                },
+            });
+            transformationsApplied += queueGroup.apply();
+            transformationsApplied += queueIndexGroup.apply();
+        }
+        return Promise.resolve({
+            nodesVisited,
+            transformationsApplied,
+        });
+    },
+};

package/package.json

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