miniread 1.100.4 → 1.101.0

package/dist/transforms/_generated/manifest.js

@@ -320,6 +320,11 @@ const manifestData = {
         notes: "Measured with baseline none: 0.00%. Added to recommended for readability.",
         evaluations: { "legacy:evaluation": { "evaluatedAt": "2026-01-24T12:41:44.793Z", "changedLines": 0, "durationSeconds": 0, "stableNames": 0, "diffSizePercent": 100 }, "claude-code-2.1.10:claude-code-2.1.11": { "diffSizePercent": 100, "evaluatedAt": "2026-01-25T23:34:11.401Z", "changedLines": 0, "durationSeconds": 40.287627666, "stableNames": 1357 } },
     },
+    "rename-unix-timestamp-parameters": {
+        recommended: true,
+        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-07T12:52:07.764Z", "changedLines": 6, "durationSeconds": 201.341115137, "stableNames": 1358 } },
+    },
     "rename-url-parameters": {
         recommended: true,
         notes: "Measured with baseline none: 0.00%. Added to recommended for readability.",
@@ -443,6 +448,7 @@ export const recommendedTransformIds = [
     "rename-platform-win32-flags",
     "rename-comparison-flags-v2",
     "rename-date-now-start-times",
+    "rename-unix-timestamp-parameters",
     "rename-default-options-parameters-v3",
     "rename-deferred-resolve-parameters",
     "rename-deferred-resolve-parameters-v2",

package/dist/transforms/_generated/registry.js

@@ -68,6 +68,7 @@ import { renameToBufferResultsTransform } from "../rename-to-buffer-results/rena
 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";
+import { renameUnixTimestampParametersTransform } from "../rename-unix-timestamp-parameters/rename-unix-timestamp-parameters-transform.js";
 import { renameUrlParametersTransform } from "../rename-url-parameters/rename-url-parameters-transform.js";
 import { renameUrlVariablesTransform } from "../rename-url-variables/rename-url-variables-transform.js";
 import { renameUseReferenceGuardsV2Transform } from "../rename-use-reference-guards-v2/rename-use-reference-guards-v2-transform.js";
@@ -154,6 +155,7 @@ export const transformRegistry = {
     [renameTypeofVariablesTransform.id]: renameTypeofVariablesTransform,
     [renameTypescriptHelperAliasesTransform.id]: renameTypescriptHelperAliasesTransform,
     [renameUint8arrayConcatVariablesTransform.id]: renameUint8arrayConcatVariablesTransform,
+    [renameUnixTimestampParametersTransform.id]: renameUnixTimestampParametersTransform,
     [renameUrlParametersTransform.id]: renameUrlParametersTransform,
     [renameUrlVariablesTransform.id]: renameUrlVariablesTransform,
     [renameUseReferenceGuardsV2Transform.id]: renameUseReferenceGuardsV2Transform,

package/dist/transforms/preset-stats.json

@@ -1,6 +1,6 @@
 {
     "recommended": {
-        "diffSizePercent": 30.524057905280266,
-        "notes": "Measured with baseline none: 30.52% of original diff."
+        "diffSizePercent": 30.450475921213833,
+        "notes": "Measured with baseline none: 30.45% of original diff."
     }
 }

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-platform-win32-flags", "rename-comparison-flags-v2", "rename-date-now-start-times", "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-map-by-id-variables", "rename-object-property-value-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-v2", "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-platform-win32-flags", "rename-comparison-flags-v2", "rename-date-now-start-times", "rename-unix-timestamp-parameters", "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-map-by-id-variables", "rename-object-property-value-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-v2", "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

@@ -39,6 +39,7 @@ export const recommendedTransformOrder = [
     // Run the specialized win32 transform before generic comparison-flag naming.
     "rename-comparison-flags-v2",
     "rename-date-now-start-times",
+    "rename-unix-timestamp-parameters",
     "rename-default-options-parameters-v3",
     "rename-deferred-resolve-parameters",
     "rename-deferred-resolve-parameters-v2",

package/dist/transforms/rename-platform-win32-flags/rename-platform-win32-flags-transform.js

@@ -67,8 +67,9 @@ export const renamePlatformWin32FlagsTransform = {
         let transformationsApplied = 0;
         for (const fileInfo of getFilesToProcess(context)) {
             const hasRawWin32Literal = fileInfo.content.includes(WIN32_LITERAL);
-            if (!hasRawWin32Literal) {
-                // Escaped string literals (e.g. "\u0077in32") do not contain "win32" in source text.
+            const hasRawPlatformIdentifier = fileInfo.content.includes("platform");
+            if (!hasRawWin32Literal || !hasRawPlatformIdentifier) {
+                // Escaped identifiers/literals may not contain the raw text.
                 if (!fileInfo.content.includes(ESCAPE_CHARACTER))
                     continue;
                 if (!hasWin32StringLiteral(fileInfo.ast))

package/dist/transforms/rename-unix-timestamp-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-07T12:52:07.764Z",
+            "changedLines": 6,
+            "durationSeconds": 201.341115137,
+            "stableNames": 1358
+        }
+    },
+    "notes": "Measured with baseline none: 100.00%. Added to recommended for readability."
+}

package/dist/transforms/rename-unix-timestamp-parameters/rename-unix-timestamp-parameters-transform.d.ts

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

package/dist/transforms/rename-unix-timestamp-parameters/rename-unix-timestamp-parameters-transform.js

@@ -0,0 +1,152 @@
+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 = "timestampSeconds";
+const isThousandLiteral = (node) => node.value === 1000;
+const unwrapTransparentParent = (path) => {
+    let wrappedNode = path.node;
+    let parentPath = path.parentPath;
+    while (parentPath &&
+        (parentPath.isParenthesizedExpression() ||
+            parentPath.isTSAsExpression() ||
+            parentPath.isTSTypeAssertion() ||
+            parentPath.isTSNonNullExpression())) {
+        wrappedNode = parentPath.node;
+        parentPath = parentPath.parentPath;
+    }
+    return { wrappedNode, parentPath };
+};
+const getDateConstructorPath = (path) => {
+    if (!path.isNewExpression())
+        return undefined;
+    const callee = path.node.callee;
+    if (callee.type !== "Identifier")
+        return undefined;
+    if (callee.name !== "Date")
+        return undefined;
+    if (path.scope.hasBinding("Date", true))
+        return undefined;
+    return path;
+};
+const isDateSecondsReference = (referencePath) => {
+    const { wrappedNode, parentPath } = unwrapTransparentParent(referencePath);
+    if (!parentPath?.isBinaryExpression({ operator: "*" }))
+        return false;
+    const binary = parentPath.node;
+    const matchesLeft = binary.left === wrappedNode;
+    const matchesRight = binary.right === wrappedNode;
+    if (!matchesLeft && !matchesRight)
+        return false;
+    const otherSide = matchesLeft ? binary.right : binary.left;
+    if (otherSide.type !== "NumericLiteral")
+        return false;
+    if (!isThousandLiteral(otherSide))
+        return false;
+    const { wrappedNode: wrappedBinary, parentPath: binaryParent } = unwrapTransparentParent(parentPath);
+    if (!binaryParent)
+        return false;
+    const dateConstructorPath = getDateConstructorPath(binaryParent);
+    if (!dateConstructorPath)
+        return false;
+    const newExpression = dateConstructorPath.node;
+    if (newExpression.arguments.length !== 1)
+        return false;
+    if (newExpression.arguments[0] !== wrappedBinary)
+        return false;
+    return true;
+};
+const isTruthinessCheck = (referencePath) => {
+    // Keep this intentionally narrow: only direct if/ternary guard tests are
+    // considered "harmless" non-Date uses for this transform.
+    const { wrappedNode, parentPath } = unwrapTransparentParent(referencePath);
+    if (!parentPath)
+        return false;
+    if (parentPath.isIfStatement({ test: wrappedNode }))
+        return true;
+    if (parentPath.isConditionalExpression({ test: wrappedNode }))
+        return true;
+    if (parentPath.isUnaryExpression({ operator: "!" })) {
+        if (parentPath.node.argument !== wrappedNode)
+            return false;
+        const { wrappedNode: wrappedUnary, parentPath: unaryParent } = unwrapTransparentParent(parentPath);
+        if (!unaryParent)
+            return false;
+        if (unaryParent.isIfStatement({ test: wrappedUnary }))
+            return true;
+        if (unaryParent.isConditionalExpression({ test: wrappedUnary }))
+            return true;
+    }
+    return false;
+};
+const isTimestampSecondsParameter = (path, parameterName) => {
+    const binding = path.scope.getBinding(parameterName);
+    if (!binding)
+        return false;
+    if (!binding.constant)
+        return false;
+    if (binding.referencePaths.length === 0)
+        return false;
+    let hasDateConstructorUsage = false;
+    for (const referencePath of binding.referencePaths) {
+        if (!referencePath.isIdentifier())
+            return false;
+        if (isDateSecondsReference(referencePath)) {
+            hasDateConstructorUsage = true;
+            continue;
+        }
+        if (isTruthinessCheck(referencePath))
+            continue;
+        return false;
+    }
+    return hasDateConstructorUsage;
+};
+const getParameterName = (path) => {
+    if (path.isIdentifier())
+        return path.node.name;
+    if (!path.isAssignmentPattern())
+        return undefined;
+    const leftPath = path.get("left");
+    if (!leftPath.isIdentifier())
+        return undefined;
+    return leftPath.node.name;
+};
+export const renameUnixTimestampParametersTransform = {
+    id: "rename-unix-timestamp-parameters",
+    description: "Renames parameters used only for new Date(timestampSeconds * 1000) constructions to timestampSeconds-based names",
+    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, {
+                Function(path) {
+                    nodesVisited++;
+                    const parameters = path.get("params");
+                    for (const parameterPath of parameters) {
+                        const parameterName = getParameterName(parameterPath);
+                        if (!parameterName)
+                            continue;
+                        if (parameterName === BASE_NAME)
+                            continue;
+                        if (isStableRenamed(parameterName))
+                            continue;
+                        if (!isTimestampSecondsParameter(path, parameterName))
+                            continue;
+                        group.add({
+                            scope: path.scope,
+                            currentName: parameterName,
+                            baseName: BASE_NAME,
+                        });
+                    }
+                },
+            });
+            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.100.4",
+  "version": "1.101.0",
   "description": "Transform minified JavaScript/TypeScript into a more readable form using deterministic AST-based transforms.",
   "repository": {
     "type": "git",