miniread 1.82.0 → 1.83.0

package/dist/transforms/_generated/manifest.js

@@ -38,6 +38,10 @@ const manifestData = {
         notes: "Added manually; improves readability by reducing nesting.",
         evaluations: { "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 100, "evaluatedAt": "2026-01-25T23:01:41.815Z", "changedLines": 5208, "durationSeconds": 58.302647375, "stableNames": 1357 } },
     },
+    "rename-add-event-listener-parameters": {
+        recommended: true,
+        evaluations: { "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 100, "evaluatedAt": "2026-02-06T17:38:36.844Z", "changedLines": 8, "durationSeconds": 179.627881234, "stableNames": 1359 } },
+    },
     "rename-arguments-length-flags": {
         recommended: true,
         notes: "Measured with baseline none: 0.00%. Added to recommended for readability.",
@@ -475,6 +479,7 @@ export const recommendedTransformIds = [
     "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",

package/dist/transforms/_generated/registry.js

@@ -7,6 +7,7 @@ import { expandSpecialNumberLiteralsTransform } from "../expand-special-number-l
 import { expandTypeofUndefinedComparisonsTransform } from "../expand-typeof-undefined-comparisons/expand-typeof-undefined-comparisons-transform.js";
 import { expandUndefinedLiteralsTransform } from "../expand-undefined-literals/expand-undefined-literals-transform.js";
 import { removeRedundantElseTransform } from "../remove-redundant-else/remove-redundant-else-transform.js";
+import { renameAddEventListenerParametersTransform } from "../rename-add-event-listener-parameters/rename-add-event-listener-parameters-transform.js";
 import { renameArgumentsLengthFlagsTransform } from "../rename-arguments-length-flags/rename-arguments-length-flags-transform.js";
 import { renameAsapWrappersTransform } from "../rename-asap-wrappers/rename-asap-wrappers-transform.js";
 import { renameAwaiterHelperFunctionsTransform } from "../rename-awaiter-helper-functions/rename-awaiter-helper-functions-transform.js";
@@ -95,6 +96,7 @@ export const transformRegistry = {
     [expandTypeofUndefinedComparisonsTransform.id]: expandTypeofUndefinedComparisonsTransform,
     [expandUndefinedLiteralsTransform.id]: expandUndefinedLiteralsTransform,
     [removeRedundantElseTransform.id]: removeRedundantElseTransform,
+    [renameAddEventListenerParametersTransform.id]: renameAddEventListenerParametersTransform,
     [renameArgumentsLengthFlagsTransform.id]: renameArgumentsLengthFlagsTransform,
     [renameAsapWrappersTransform.id]: renameAsapWrappersTransform,
     [renameAwaiterHelperFunctionsTransform.id]: renameAwaiterHelperFunctionsTransform,

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-v2", "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-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-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-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-date-now-start-times", "rename-default-options-parameters-v2", "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-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-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

@@ -49,6 +49,7 @@ export const recommendedTransformOrder = [
     "rename-error-first-callback-parameters-v2",
     "rename-error-variables",
     "rename-event-parameters",
+    "rename-add-event-listener-parameters",
     "rename-http-server-parameters",
     // Runs after stabilize-top-level-bindings: in the recommended preset, top-level `fs` bindings
     // are already stable-hashed. This transform gives remaining non-stable `fs` helpers stable

package/dist/transforms/rename-add-event-listener-parameters/has-event-handler-usage.d.ts

@@ -0,0 +1,2 @@
+import type { Binding } from "@babel/traverse";
+export declare const hasEventHandlerUsage: (binding: Binding) => boolean;

package/dist/transforms/rename-add-event-listener-parameters/has-event-handler-usage.js

@@ -0,0 +1,42 @@
+const isHandleEventAccess = (node) => {
+    if (!node.computed && node.property.type === "Identifier") {
+        return node.property.name === "handleEvent";
+    }
+    if (node.computed && node.property.type === "StringLiteral") {
+        return node.property.value === "handleEvent";
+    }
+    return false;
+};
+const isWriteSideHandleEventAccess = (memberPath) => {
+    const parent = memberPath.parentPath;
+    if (parent.isAssignmentExpression()) {
+        return parent.node.left === memberPath.node;
+    }
+    if (parent.isUpdateExpression()) {
+        return parent.node.argument === memberPath.node;
+    }
+    return false;
+};
+export const hasEventHandlerUsage = (binding) => {
+    return binding.referencePaths.some((referencePath) => {
+        const parent = referencePath.parentPath;
+        if (!parent)
+            return false;
+        if ((parent.isCallExpression() || parent.isOptionalCallExpression()) &&
+            referencePath.key === "callee")
+            return true;
+        if ((parent.isMemberExpression() || parent.isOptionalMemberExpression()) &&
+            referencePath.key === "object") {
+            if (isWriteSideHandleEventAccess(parent))
+                return false;
+            const property = parent.node.property;
+            if (property.type !== "Identifier" && property.type !== "StringLiteral")
+                return false;
+            return isHandleEventAccess({
+                property,
+                computed: parent.node.computed,
+            });
+        }
+        return false;
+    });
+};

package/dist/transforms/rename-add-event-listener-parameters/has-event-name-comparison.d.ts

@@ -0,0 +1,2 @@
+import type { Binding } from "@babel/traverse";
+export declare const hasEventNameComparison: (binding: Binding) => boolean;

package/dist/transforms/rename-add-event-listener-parameters/has-event-name-comparison.js

@@ -0,0 +1,21 @@
+export const hasEventNameComparison = (binding) => {
+    return binding.referencePaths.some((referencePath) => {
+        const parent = referencePath.parentPath;
+        if (!parent)
+            return false;
+        if (parent.isBinaryExpression()) {
+            const { left, right, operator } = parent.node;
+            if (operator !== "===" && operator !== "==")
+                return false;
+            if (left === referencePath.node)
+                return right.type === "StringLiteral";
+            if (right === referencePath.node)
+                return left.type === "StringLiteral";
+            return false;
+        }
+        if (parent.isSwitchStatement() && referencePath.key === "discriminant") {
+            return parent.node.cases.some((caseClause) => caseClause.test?.type === "StringLiteral");
+        }
+        return false;
+    });
+};

package/dist/transforms/rename-add-event-listener-parameters/is-add-event-listener-key.d.ts

@@ -0,0 +1,3 @@
+import type { NodePath } from "@babel/traverse";
+import type { ObjectMethod, ObjectProperty } from "@babel/types";
+export declare const isAddEventListenerKey: (path: NodePath<ObjectMethod | ObjectProperty>) => boolean;

package/dist/transforms/rename-add-event-listener-parameters/is-add-event-listener-key.js

@@ -0,0 +1,8 @@
+export const isAddEventListenerKey = (path) => {
+    const { key, computed } = path.node;
+    if (key.type === "Identifier")
+        return !computed && key.name === "addEventListener";
+    if (key.type === "StringLiteral")
+        return key.value === "addEventListener";
+    return false;
+};

package/dist/transforms/rename-add-event-listener-parameters/manifest.json

@@ -0,0 +1,12 @@
+{
+    "recommended": true,
+    "evaluations": {
+        "claude-code-2.1.10:claude-code-2.1.11": {
+            "diffSizePercent": 100,
+            "evaluatedAt": "2026-02-06T17:38:36.844Z",
+            "changedLines": 8,
+            "durationSeconds": 179.627881234,
+            "stableNames": 1359
+        }
+    }
+}

package/dist/transforms/rename-add-event-listener-parameters/rename-add-event-listener-parameters-transform.d.ts

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

package/dist/transforms/rename-add-event-listener-parameters/rename-add-event-listener-parameters-transform.js

@@ -0,0 +1,91 @@
+import { createRequire } from "node:module";
+import { RenameGroup, isStableRenamed } from "../../core/stable-naming.js";
+import { getFilesToProcess, } from "../../core/types.js";
+import { hasEventHandlerUsage } from "./has-event-handler-usage.js";
+import { hasEventNameComparison } from "./has-event-name-comparison.js";
+import { isAddEventListenerKey } from "./is-add-event-listener-key.js";
+const require = createRequire(import.meta.url);
+// eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+const traverse = require("@babel/traverse").default;
+const EVENT_NAME_BASE = "eventName";
+const EVENT_HANDLER_BASE = "eventHandler";
+const collectAddEventListenerRename = (path, group) => {
+    if (path.node.params.length !== 2)
+        return;
+    const [eventNameParameter, handlerParameter] = path.node.params;
+    if (eventNameParameter?.type !== "Identifier")
+        return;
+    if (handlerParameter?.type !== "Identifier")
+        return;
+    const eventName = eventNameParameter.name;
+    const handlerName = handlerParameter.name;
+    if (eventName === handlerName)
+        return;
+    const shouldRenameEventName = !isStableRenamed(eventName);
+    const shouldRenameHandlerName = !isStableRenamed(handlerName);
+    if (!shouldRenameEventName && !shouldRenameHandlerName)
+        return;
+    const eventBinding = path.scope.getBinding(eventName);
+    if (!eventBinding)
+        return;
+    if (!eventBinding.constant)
+        return;
+    const handlerBinding = path.scope.getBinding(handlerName);
+    if (!handlerBinding)
+        return;
+    if (!handlerBinding.constant)
+        return;
+    if (!hasEventNameComparison(eventBinding))
+        return;
+    if (!hasEventHandlerUsage(handlerBinding))
+        return;
+    if (shouldRenameEventName) {
+        group.add({
+            scope: path.scope,
+            currentName: eventName,
+            baseName: EVENT_NAME_BASE,
+        });
+    }
+    if (shouldRenameHandlerName) {
+        group.add({
+            scope: path.scope,
+            currentName: handlerName,
+            baseName: EVENT_HANDLER_BASE,
+        });
+    }
+};
+export const renameAddEventListenerParametersTransform = {
+    id: "rename-add-event-listener-parameters",
+    description: "Renames addEventListener parameters to eventName/eventHandler when usage is high-confidence",
+    scope: "file",
+    parallelizable: true,
+    transform(context) {
+        let nodesVisited = 0;
+        let transformationsApplied = 0;
+        for (const fileInfo of getFilesToProcess(context)) {
+            const group = new RenameGroup();
+            traverse(fileInfo.ast, {
+                ObjectMethod(path) {
+                    nodesVisited++;
+                    if (!isAddEventListenerKey(path))
+                        return;
+                    collectAddEventListenerRename(path, group);
+                },
+                ObjectProperty(path) {
+                    nodesVisited++;
+                    if (!isAddEventListenerKey(path))
+                        return;
+                    const valuePath = path.get("value");
+                    if (valuePath.isFunctionExpression()) {
+                        collectAddEventListenerRename(valuePath, group);
+                    }
+                    else if (valuePath.isArrowFunctionExpression()) {
+                        collectAddEventListenerRename(valuePath, group);
+                    }
+                },
+            });
+            transformationsApplied += group.apply();
+        }
+        return Promise.resolve({ nodesVisited, transformationsApplied });
+    },
+};

package/package.json

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