miniread 1.60.1 → 1.62.0

package/dist/transforms/_generated/manifest.js

@@ -108,6 +108,10 @@ const manifestData = {
         notes: "Auto-added by evaluation script. Measured with baseline none: 0.09%.",
         evaluations: { "legacy:evaluation": { "evaluatedAt": "2026-01-25T19:59:48.188Z", "changedLines": 38927, "durationSeconds": 0, "stableNames": 0, "diffSizePercent": 97.80020410477378 }, "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 97.80020410477378, "evaluatedAt": "2026-01-25T23:15:44.243Z", "changedLines": 38927, "durationSeconds": 76.61873741599999, "stableNames": 4505 } },
     },
+    "rename-document-fragment-variables": {
+        recommended: true,
+        evaluations: { "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 100, "evaluatedAt": "2026-02-02T22:12:52.993Z", "changedLines": 20, "durationSeconds": 207.34089557, "stableNames": 1358 } },
+    },
     "rename-error-first-callback-parameters": {
         recommended: true,
         notes: "Measured with baseline none: 0.00%.",
@@ -244,6 +248,10 @@ const manifestData = {
         notes: "Measured with baseline none: 0.00%. Added to recommended for readability.",
         evaluations: { "legacy:evaluation": { "evaluatedAt": "2026-01-25T20:13:48.297Z", "changedLines": 154, "durationSeconds": 0, "stableNames": 0, "diffSizePercent": 99.99622028196697 }, "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 99.99622028196697, "evaluatedAt": "2026-01-25T23:31:54.696Z", "changedLines": 154, "durationSeconds": 53.15604825, "stableNames": 1358 } },
     },
+    "rename-to-buffer-results": {
+        recommended: true,
+        evaluations: { "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 100, "evaluatedAt": "2026-02-04T13:06:29.691Z", "changedLines": 56, "durationSeconds": 171.52518661899998, "stableNames": 1359 } },
+    },
     "rename-typeof-variables": {
         recommended: true,
         evaluations: { "legacy:evaluation": { "evaluatedAt": "2026-01-25T20:14:40.653Z", "changedLines": 372, "durationSeconds": 0, "stableNames": 0, "diffSizePercent": 100 }, "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 100, "evaluatedAt": "2026-01-25T23:32:45.594Z", "changedLines": 372, "durationSeconds": 48.026398584, "stableNames": 1358 } },
@@ -353,6 +361,7 @@ export const recommendedTransformIds = [
     "rename-asap-wrappers",
     "rename-awaiter-parameters",
     "rename-buffer-variables",
+    "rename-to-buffer-results",
     "rename-catch-parameters",
     "rename-promise-catch-parameters",
     "rename-char-code-at",
@@ -370,6 +379,7 @@ export const recommendedTransformIds = [
     "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",

package/dist/transforms/_generated/registry.js

@@ -21,6 +21,7 @@ import { renameDateNowStartTimesTransform } from "../rename-date-now-start-times
 import { renameDefaultOptionsParametersTransform } from "../rename-default-options-parameters/rename-default-options-parameters-transform.js";
 import { renameDeferredResolveParametersTransform } from "../rename-deferred-resolve-parameters/rename-deferred-resolve-parameters-transform.js";
 import { renameDestructuredAliasesTransform } from "../rename-destructured-aliases/rename-destructured-aliases-transform.js";
+import { renameDocumentFragmentVariablesTransform } from "../rename-document-fragment-variables/rename-document-fragment-variables-transform.js";
 import { renameErrorFirstCallbackParametersTransform } from "../rename-error-first-callback-parameters/rename-error-first-callback-parameters-transform.js";
 import { renameErrorVariablesTransform } from "../rename-error-variables/rename-error-variables-transform.js";
 import { renameEventParametersTransform } from "../rename-event-parameters/rename-event-parameters-transform.js";
@@ -48,6 +49,7 @@ import { renameStringSplitVariablesTransform } from "../rename-string-split-vari
 import { renameThisAliasesTransform } from "../rename-this-aliases/rename-this-aliases-transform.js";
 import { renameTimeoutDurationParametersTransform } from "../rename-timeout-duration-parameters/rename-timeout-duration-parameters-transform.js";
 import { renameTimeoutIdsTransform } from "../rename-timeout-ids/rename-timeout-ids-transform.js";
+import { renameToBufferResultsTransform } from "../rename-to-buffer-results/rename-to-buffer-results-transform.js";
 import { renameTypeofVariablesTransform } from "../rename-typeof-variables/rename-typeof-variables-transform.js";
 import { renameTypescriptHelperAliasesTransform } from "../rename-typescript-helper-aliases/rename-typescript-helper-aliases-transform.js";
 import { renameUint8arrayConcatVariablesTransform } from "../rename-uint8array-concat-variables/rename-uint8array-concat-variables-transform.js";
@@ -87,6 +89,7 @@ export const transformRegistry = {
     [renameDefaultOptionsParametersTransform.id]: renameDefaultOptionsParametersTransform,
     [renameDeferredResolveParametersTransform.id]: renameDeferredResolveParametersTransform,
     [renameDestructuredAliasesTransform.id]: renameDestructuredAliasesTransform,
+    [renameDocumentFragmentVariablesTransform.id]: renameDocumentFragmentVariablesTransform,
     [renameErrorFirstCallbackParametersTransform.id]: renameErrorFirstCallbackParametersTransform,
     [renameErrorVariablesTransform.id]: renameErrorVariablesTransform,
     [renameEventParametersTransform.id]: renameEventParametersTransform,
@@ -114,6 +117,7 @@ export const transformRegistry = {
     [renameThisAliasesTransform.id]: renameThisAliasesTransform,
     [renameTimeoutDurationParametersTransform.id]: renameTimeoutDurationParametersTransform,
     [renameTimeoutIdsTransform.id]: renameTimeoutIdsTransform,
+    [renameToBufferResultsTransform.id]: renameToBufferResultsTransform,
     [renameTypeofVariablesTransform.id]: renameTypeofVariablesTransform,
     [renameTypescriptHelperAliasesTransform.id]: renameTypescriptHelperAliasesTransform,
     [renameUint8arrayConcatVariablesTransform.id]: renameUint8arrayConcatVariablesTransform,

package/dist/transforms/preset-stats.json

@@ -1,6 +1,6 @@
 {
     "recommended": {
-        "diffSizePercent": 78.49401564414286,
-        "notes": "Measured with baseline none: 78.49% of original diff."
+        "diffSizePercent": 78.49967015361418,
+        "notes": "Measured with baseline none: 78.50% of original diff. Stats re-evaluated against updated sources (Feb 2026)."
     }
 }

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-buffer-variables", "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-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-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"];

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

@@ -18,6 +18,7 @@ export const recommendedTransformOrder = [
     "rename-asap-wrappers",
     "rename-awaiter-parameters",
     "rename-buffer-variables",
+    "rename-to-buffer-results",
     "rename-catch-parameters",
     "rename-promise-catch-parameters",
     "rename-char-code-at",
@@ -38,6 +39,7 @@ export const recommendedTransformOrder = [
     "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",

package/dist/transforms/rename-document-fragment-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-02T22:12:52.993Z",
+            "changedLines": 20,
+            "durationSeconds": 207.34089557,
+            "stableNames": 1358
+        }
+    }
+}

package/dist/transforms/rename-document-fragment-variables/rename-document-fragment-variables-transform.d.ts

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

package/dist/transforms/rename-document-fragment-variables/rename-document-fragment-variables-transform.js

@@ -0,0 +1,84 @@
+import { createRequire } from "node:module";
+import { collectExportedNames } from "../../core/collect-exported-names.js";
+import { isStableRenamed, RenameGroup } from "../../core/stable-naming.js";
+import { getFilesToProcess, } from "../../core/types.js";
+import * as t from "@babel/types";
+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 = "documentFragment";
+const METHOD_NAME = "createDocumentFragment";
+const isCreateDocumentFragmentCall = (init) => {
+    if (!init)
+        return false;
+    if (init.type !== "CallExpression" && init.type !== "OptionalCallExpression")
+        return false;
+    if (init.arguments.length > 0)
+        return false;
+    if (init.callee.type !== "MemberExpression" &&
+        init.callee.type !== "OptionalMemberExpression")
+        return false;
+    if (init.callee.computed) {
+        if (t.isStringLiteral(init.callee.property) &&
+            init.callee.property.value === METHOD_NAME) {
+            return true;
+        }
+        if (t.isTemplateLiteral(init.callee.property) &&
+            init.callee.property.expressions.length === 0 &&
+            init.callee.property.quasis.length === 1) {
+            const quasi = init.callee.property.quasis[0];
+            return quasi?.value.cooked === METHOD_NAME;
+        }
+        return false;
+    }
+    return (init.callee.property.type === "Identifier" &&
+        init.callee.property.name === METHOD_NAME);
+};
+const getDocumentFragmentIdentifier = (declarator) => {
+    if (declarator.id.type !== "Identifier")
+        return undefined;
+    if (!isCreateDocumentFragmentCall(declarator.init))
+        return undefined;
+    return declarator.id;
+};
+export const renameDocumentFragmentVariablesTransform = {
+    id: "rename-document-fragment-variables",
+    description: "Renames variables assigned from createDocumentFragment() to a stable $documentFragment (or suffixed variant when needed) when unique in scope, otherwise uses readable documentFragment/documentFragment2/...",
+    scope: "file",
+    parallelizable: true,
+    transform(context) {
+        let nodesVisited = 0;
+        let transformationsApplied = 0;
+        for (const fileInfo of getFilesToProcess(context)) {
+            const group = new RenameGroup();
+            const exportedNames = collectExportedNames(fileInfo.ast.program);
+            traverse(fileInfo.ast, {
+                VariableDeclarator(path) {
+                    nodesVisited++;
+                    const identifier = getDocumentFragmentIdentifier(path.node);
+                    if (!identifier)
+                        return;
+                    if (isStableRenamed(identifier.name))
+                        return;
+                    const currentName = identifier.name;
+                    const binding = path.scope.getBinding(identifier.name);
+                    if (!binding)
+                        return;
+                    if (!binding.constant)
+                        return;
+                    if (binding.scope.block.type === "Program" &&
+                        exportedNames.has(currentName)) {
+                        return;
+                    }
+                    group.add({
+                        scope: binding.scope,
+                        currentName,
+                        baseName: BASE_NAME,
+                    });
+                },
+            });
+            transformationsApplied += group.apply();
+        }
+        return Promise.resolve({ nodesVisited, transformationsApplied });
+    },
+};

package/dist/transforms/rename-to-buffer-results/manifest.json

@@ -0,0 +1,12 @@
+{
+    "recommended": true,
+    "evaluations": {
+        "claude-code-2.1.10:claude-code-2.1.11": {
+            "diffSizePercent": 100,
+            "evaluatedAt": "2026-02-04T13:06:29.691Z",
+            "changedLines": 56,
+            "durationSeconds": 171.52518661899998,
+            "stableNames": 1359
+        }
+    }
+}

package/dist/transforms/rename-to-buffer-results/rename-to-buffer-results-transform.d.ts

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

package/dist/transforms/rename-to-buffer-results/rename-to-buffer-results-transform.js

@@ -0,0 +1,83 @@
+import { createRequire } from "node:module";
+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 isToBufferCall = (callee) => {
+    if (callee.type !== "MemberExpression" &&
+        callee.type !== "OptionalMemberExpression") {
+        return false;
+    }
+    if (callee.computed) {
+        if (callee.property.type === "StringLiteral") {
+            return callee.property.value === "toBuffer";
+        }
+        if (callee.property.type === "TemplateLiteral" &&
+            callee.property.expressions.length === 0 &&
+            callee.property.quasis.length === 1) {
+            const quasi = callee.property.quasis[0];
+            return quasi?.value.cooked === "toBuffer";
+        }
+        return false;
+    }
+    return (callee.property.type === "Identifier" && callee.property.name === "toBuffer");
+};
+export const renameToBufferResultsTransform = {
+    id: "rename-to-buffer-results",
+    description: "Renames variables assigned from toBuffer() results to buffer",
+    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, {
+                VariableDeclarator(path) {
+                    nodesVisited++;
+                    const { id, init } = path.node;
+                    if (!init || id.type !== "Identifier") {
+                        return;
+                    }
+                    let callExpression;
+                    if (init.type === "CallExpression" ||
+                        init.type === "OptionalCallExpression") {
+                        callExpression = init;
+                    }
+                    else if (init.type === "AwaitExpression") {
+                        if (init.argument.type !== "CallExpression" &&
+                            init.argument.type !== "OptionalCallExpression") {
+                            return;
+                        }
+                        callExpression = init.argument;
+                    }
+                    else {
+                        return;
+                    }
+                    if (!isToBufferCall(callExpression.callee)) {
+                        return;
+                    }
+                    const currentName = id.name;
+                    if (isStableRenamed(currentName)) {
+                        return;
+                    }
+                    if (currentName.toLowerCase().includes("buffer")) {
+                        return;
+                    }
+                    const binding = path.scope.getBinding(currentName);
+                    if (!binding?.constant) {
+                        return;
+                    }
+                    renameGroup.add({
+                        scope: path.scope,
+                        currentName,
+                        baseName: "buffer",
+                    });
+                },
+            });
+            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.60.1",
+  "version": "1.62.0",
   "description": "Transform minified JavaScript/TypeScript into a more readable form using deterministic AST-based transforms.",
   "repository": {
     "type": "git",