miniread 1.63.0 → 1.64.0

package/dist/transforms/_generated/manifest.js

@@ -136,6 +136,10 @@ const manifestData = {
         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.",
         evaluations: { "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 100.01319385543303, "evaluatedAt": "2026-02-01T23:10:38.195Z", "changedLines": 515, "durationSeconds": 398.35224649, "stableNames": 1358 } },
     },
+    "rename-http-server-parameters": {
+        recommended: true,
+        evaluations: { "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 100, "evaluatedAt": "2026-02-04T12:54:37.434Z", "changedLines": 14, "durationSeconds": 231.553556391, "stableNames": 1358 } },
+    },
     "rename-interval-ids": {
         recommended: true,
         evaluations: { "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 100, "evaluatedAt": "2026-02-01T09:30:55.276Z", "changedLines": 58, "durationSeconds": 201.398360841, "stableNames": 1358 } },
@@ -380,6 +384,7 @@ export const recommendedTransformIds = [
     "rename-error-first-callback-parameters",
     "rename-error-variables",
     "rename-event-parameters",
+    "rename-http-server-parameters",
     "rename-fs-sync-variables",
     "rename-interval-ids",
     "rename-loop-index-variables-v3",

package/dist/transforms/_generated/registry.js

@@ -27,6 +27,7 @@ import { renameErrorFirstCallbackParametersTransform } from "../rename-error-fir
 import { renameErrorVariablesTransform } from "../rename-error-variables/rename-error-variables-transform.js";
 import { renameEventParametersTransform } from "../rename-event-parameters/rename-event-parameters-transform.js";
 import { renameFsSyncVariablesTransform } from "../rename-fs-sync-variables/rename-fs-sync-variables-transform.js";
+import { renameHttpServerParametersTransform } from "../rename-http-server-parameters/rename-http-server-parameters-transform.js";
 import { renameIntervalIdsTransform } from "../rename-interval-ids/rename-interval-ids-transform.js";
 import { renameLoopIndexVariablesTransform } from "../rename-loop-index-variables/rename-loop-index-variables-transform.js";
 import { renameLoopIndexVariablesV2Transform } from "../rename-loop-index-variables-v2/rename-loop-index-variables-v2-transform.js";
@@ -96,6 +97,7 @@ export const transformRegistry = {
     [renameErrorVariablesTransform.id]: renameErrorVariablesTransform,
     [renameEventParametersTransform.id]: renameEventParametersTransform,
     [renameFsSyncVariablesTransform.id]: renameFsSyncVariablesTransform,
+    [renameHttpServerParametersTransform.id]: renameHttpServerParametersTransform,
     [renameIntervalIdsTransform.id]: renameIntervalIdsTransform,
     [renameLoopIndexVariablesTransform.id]: renameLoopIndexVariablesTransform,
     [renameLoopIndexVariablesV2Transform.id]: renameLoopIndexVariablesV2Transform,

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", "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-error-first-callback-parameters", "rename-error-variables", "rename-event-parameters", "rename-fs-sync-variables", "rename-interval-ids", "rename-loop-index-variables-v3", "rename-loop-length-variables", "rename-document-fragment-variables", "rename-object-keys-variables", "rename-parameters-to-match-properties-v2", "rename-promise-executor-parameters-v2", "rename-range-parameters", "rename-read-file-lines", "rename-regex-builders", "rename-rest-parameters", "rename-search-parameters-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", "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-error-first-callback-parameters", "rename-error-variables", "rename-event-parameters", "rename-http-server-parameters", "rename-fs-sync-variables", "rename-interval-ids", "rename-loop-index-variables-v3", "rename-loop-length-variables", "rename-document-fragment-variables", "rename-object-keys-variables", "rename-parameters-to-match-properties-v2", "rename-promise-executor-parameters-v2", "rename-range-parameters", "rename-read-file-lines", "rename-regex-builders", "rename-rest-parameters", "rename-search-parameters-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"];

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

@@ -33,6 +33,7 @@ export const recommendedTransformOrder = [
     "rename-error-first-callback-parameters",
     "rename-error-variables",
     "rename-event-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
     // `$fs`-style names.

package/dist/transforms/rename-http-server-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-04T12:54:37.434Z",
+            "changedLines": 14,
+            "durationSeconds": 231.553556391,
+            "stableNames": 1358
+        }
+    }
+}

package/dist/transforms/rename-http-server-parameters/rename-http-server-parameters-transform.d.ts

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

package/dist/transforms/rename-http-server-parameters/rename-http-server-parameters-transform.js

@@ -0,0 +1,109 @@
+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;
+// prettier-ignore
+const REQUEST_PROPERTY_NAMES = new Set(["url", "method", "headers", "socket", "connection", "httpVersion", "trailers"]);
+// prettier-ignore
+const RESPONSE_PROPERTY_NAMES = new Set(["end", "write", "writeHead", "setHeader", "getHeader", "removeHeader", "statusCode", "statusMessage"]);
+// prettier-ignore
+const isListenerFunction = (argumentPath) => argumentPath.isFunctionExpression() || argumentPath.isArrowFunctionExpression();
+const getListenerFromCreateServerCall = (path) => {
+    // Intentionally module-agnostic: rely on request/response property usage (one high-signal access each).
+    const callee = path.node.callee;
+    if ((callee.type !== "MemberExpression" &&
+        callee.type !== "OptionalMemberExpression") ||
+        callee.computed ||
+        callee.property.type !== "Identifier" ||
+        callee.property.name !== "createServer")
+        return undefined;
+    const [firstArgument, secondArgument] = path.get("arguments");
+    if (firstArgument && isListenerFunction(firstArgument))
+        return firstArgument;
+    if (secondArgument && isListenerFunction(secondArgument))
+        return secondArgument;
+    return undefined;
+};
+const getMemberExpressionPropertyName = (expression) => {
+    const key = expression.property;
+    if (!expression.computed)
+        return key.type === "Identifier"
+            ? key.name
+            : key.type === "StringLiteral"
+                ? key.value
+                : undefined;
+    if (key.type === "StringLiteral")
+        return key.value;
+    if (key.type === "TemplateLiteral" &&
+        key.expressions.length === 0 &&
+        key.quasis.length === 1) {
+        const quasi = key.quasis[0];
+        return quasi?.value.cooked ?? quasi?.value.raw;
+    }
+    return undefined;
+};
+const hasPropertyUsage = (bindingName, referencePaths, propertyNames) => referencePaths.some((referencePath) => {
+    if (!referencePath.isIdentifier() ||
+        referencePath.node.name !== bindingName)
+        return false;
+    let parentPath = referencePath.parentPath;
+    let objectNode = referencePath.node;
+    if (parentPath.isTSNonNullExpression()) {
+        objectNode = parentPath.node;
+        parentPath = parentPath.parentPath;
+    }
+    if ((!parentPath.isMemberExpression() &&
+        !parentPath.isOptionalMemberExpression()) ||
+        parentPath.node.object !== objectNode)
+        return false;
+    const propertyName = getMemberExpressionPropertyName(parentPath.node);
+    return propertyName ? propertyNames.has(propertyName) : false;
+});
+// prettier-ignore
+const canRenameParameter = (parameter, bindingReferences, propertyNames, targetName) => parameter.name !== targetName && !isStableRenamed(parameter.name) && hasPropertyUsage(parameter.name, bindingReferences, propertyNames);
+const handleCreateServerCall = (path, group, nodesVisited) => {
+    nodesVisited.value++;
+    const listenerPath = getListenerFromCreateServerCall(path);
+    if (!listenerPath)
+        return;
+    const [firstParameter, secondParameter] = listenerPath.node.params;
+    if (!firstParameter ||
+        !secondParameter ||
+        firstParameter.type !== "Identifier" ||
+        secondParameter.type !== "Identifier" ||
+        firstParameter.name === secondParameter.name)
+        return;
+    const requestBinding = listenerPath.scope.getBinding(firstParameter.name);
+    const responseBinding = listenerPath.scope.getBinding(secondParameter.name);
+    if (!requestBinding ||
+        !responseBinding ||
+        !requestBinding.constant ||
+        !responseBinding.constant ||
+        !canRenameParameter(firstParameter, requestBinding.referencePaths, REQUEST_PROPERTY_NAMES, "$request") ||
+        !canRenameParameter(secondParameter, responseBinding.referencePaths, RESPONSE_PROPERTY_NAMES, "$response"))
+        return;
+    // prettier-ignore
+    group.add({ scope: listenerPath.scope, currentName: firstParameter.name, baseName: "request" });
+    // prettier-ignore
+    group.add({ scope: listenerPath.scope, currentName: secondParameter.name, baseName: "response" });
+};
+export const renameHttpServerParametersTransform = {
+    id: "rename-http-server-parameters",
+    description: "Renames createServer request/response parameters to $request/$response when usage is high-confidence",
+    scope: "file",
+    parallelizable: true,
+    transform(context) {
+        const nodesVisited = { value: 0 };
+        let transformationsApplied = 0;
+        for (const fileInfo of getFilesToProcess(context)) {
+            const group = new RenameGroup();
+            // prettier-ignore
+            traverse(fileInfo.ast, { CallExpression(path) { handleCreateServerCall(path, group, nodesVisited); }, OptionalCallExpression(path) { handleCreateServerCall(path, group, nodesVisited); } });
+            transformationsApplied += group.apply();
+        }
+        // prettier-ignore
+        return Promise.resolve({ nodesVisited: nodesVisited.value, transformationsApplied });
+    },
+};

package/package.json

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