miniread 1.17.0 → 1.19.0

package/dist/transforms/transform-registry.js

@@ -1,51 +1 @@
-import { expandBooleanLiteralsTransform } from "./expand-boolean-literals/expand-boolean-literals-transform.js";
-import { expandSpecialNumberLiteralsTransform } from "./expand-special-number-literals/expand-special-number-literals-transform.js";
-import { expandSequenceExpressionsV4Transform } from "./expand-sequence-expressions-v4/expand-sequence-expressions-v4-transform.js";
-import { expandSequenceExpressionsV5Transform } from "./expand-sequence-expressions-v5/expand-sequence-expressions-v5-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 { renameCatchParametersTransform } from "./rename-catch-parameters/rename-catch-parameters-transform.js";
-import { renameCharCodeAtTransform } from "./rename-char-code-at/rename-char-code-at-transform.js";
-import { renameCharcodeVariablesTransform } from "./rename-charcode-variables/rename-charcode-variables-transform.js";
-import { renameCharcodeVariablesV2Transform } from "./rename-charcode-variables-v2/rename-charcode-variables-v2-transform.js";
-import { renameComparisonFlagsTransform } from "./rename-comparison-flags/rename-comparison-flags-transform.js";
-import { renameDestructuredAliasesTransform } from "./rename-destructured-aliases/rename-destructured-aliases-transform.js";
-import { renameEventParametersTransform } from "./rename-event-parameters/rename-event-parameters-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";
-import { renameLoopIndexVariablesV3Transform } from "./rename-loop-index-variables-v3/rename-loop-index-variables-v3-transform.js";
-import { renameParametersToMatchPropertiesTransform } from "./rename-parameters-to-match-properties/rename-parameters-to-match-properties-transform.js";
-import { renamePromiseExecutorParametersTransform } from "./rename-promise-executor-parameters/rename-promise-executor-parameters-transform.js";
-import { renameReplaceChildParametersTransform } from "./rename-replace-child-parameters/rename-replace-child-parameters-transform.js";
-import { renameThisAliasesTransform } from "./rename-this-aliases/rename-this-aliases-transform.js";
-import { renameTimeoutIdsTransform } from "./rename-timeout-ids/rename-timeout-ids-transform.js";
-import { renameUseReferenceGuardsTransform } from "./rename-use-reference-guards/rename-use-reference-guards-transform.js";
-import { renameUseReferenceGuardsV2Transform } from "./rename-use-reference-guards-v2/rename-use-reference-guards-v2-transform.js";
-import { splitVariableDeclarationsTransform } from "./split-variable-declarations/split-variable-declarations-transform.js";
-export const transformRegistry = {
-    [expandBooleanLiteralsTransform.id]: expandBooleanLiteralsTransform,
-    [expandSpecialNumberLiteralsTransform.id]: expandSpecialNumberLiteralsTransform,
-    [expandSequenceExpressionsV4Transform.id]: expandSequenceExpressionsV4Transform,
-    [expandSequenceExpressionsV5Transform.id]: expandSequenceExpressionsV5Transform,
-    [expandUndefinedLiteralsTransform.id]: expandUndefinedLiteralsTransform,
-    [removeRedundantElseTransform.id]: removeRedundantElseTransform,
-    [renameCatchParametersTransform.id]: renameCatchParametersTransform,
-    [renameCharCodeAtTransform.id]: renameCharCodeAtTransform,
-    [renameCharcodeVariablesTransform.id]: renameCharcodeVariablesTransform,
-    [renameCharcodeVariablesV2Transform.id]: renameCharcodeVariablesV2Transform,
-    [renameComparisonFlagsTransform.id]: renameComparisonFlagsTransform,
-    [renameDestructuredAliasesTransform.id]: renameDestructuredAliasesTransform,
-    [renameEventParametersTransform.id]: renameEventParametersTransform,
-    [renameLoopIndexVariablesTransform.id]: renameLoopIndexVariablesTransform,
-    [renameLoopIndexVariablesV2Transform.id]: renameLoopIndexVariablesV2Transform,
-    [renameLoopIndexVariablesV3Transform.id]: renameLoopIndexVariablesV3Transform,
-    [renameParametersToMatchPropertiesTransform.id]: renameParametersToMatchPropertiesTransform,
-    [renamePromiseExecutorParametersTransform.id]: renamePromiseExecutorParametersTransform,
-    [renameReplaceChildParametersTransform.id]: renameReplaceChildParametersTransform,
-    [renameThisAliasesTransform.id]: renameThisAliasesTransform,
-    [renameTimeoutIdsTransform.id]: renameTimeoutIdsTransform,
-    [renameUseReferenceGuardsTransform.id]: renameUseReferenceGuardsTransform,
-    [renameUseReferenceGuardsV2Transform.id]: renameUseReferenceGuardsV2Transform,
-    [splitVariableDeclarationsTransform.id]: splitVariableDeclarationsTransform,
-};
-export const allTransformIds = Object.keys(transformRegistry);
+export { transformRegistry, allTransformIds } from "./_generated/registry.js";

package/package.json

@@ -2,7 +2,7 @@
   "name": "miniread",
   "author": "Łukasz Jerciński",
   "license": "MIT",
-  "version": "1.17.0",
+  "version": "1.19.0",
   "description": "Transform minified JavaScript/TypeScript into a more readable form using deterministic AST-based transforms.",
   "repository": {
     "type": "git",
@@ -30,16 +30,15 @@
   "files": [
     "bin/",
     "dist/",
-    "transform-manifest.json",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
     "prepare": "git config core.hooksPath .githooks",
     "prepublishOnly": "pnpm run rebuild",
-    "build": "tsc -p tsconfig.app.json",
+    "build": "node --experimental-strip-types scripts/generate-registry.ts && tsc -p tsconfig.app.json",
     "check": "pnpm -s run rebuild && node bin/miniread-evaluate -- --check",
-    "clean": "rm -rf dist *.tsbuildinfo",
+    "clean": "rm -rf dist src/transforms/_generated *.tsbuildinfo",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "fta": "fta-check",
@@ -50,6 +49,7 @@
     "miniread-sample": "pnpm -s run rebuild && node bin/miniread-sample",
     "snapshot": "pnpm -s run rebuild && node bin/miniread-snapshot",
     "rebuild": "pnpm run clean && pnpm run build",
+    "pretest": "node --experimental-strip-types scripts/generate-registry.ts",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "test:watch": "vitest",
@@ -69,8 +69,7 @@
     "@commander-js/extra-typings": "^14.0.0",
     "commander": "^14.0.2",
     "env-paths": "^3.0.0",
-    "p-queue": "^9.1.0",
-    "zod": "^4.3.6"
+    "p-queue": "^9.1.0"
   },
   "devDependencies": {
     "@total-typescript/ts-reset": "^0.6.1",

package/dist/scripts/evaluate/parse-transform-manifest.d.ts

@@ -1,22 +0,0 @@
-import type { Transform } from "../../core/types.js";
-type TransformManifestEntry = {
-    id: string;
-    description: string;
-    scope: Transform["scope"];
-    parallelizable: boolean;
-    diffReductionImpact: number;
-    recommended: boolean;
-    evaluatedAt?: string;
-    notes?: string;
-    supersededBy?: string;
-};
-type PresetStatsEntry = {
-    diffReductionImpact: number;
-    notes?: string;
-};
-type TransformManifest = {
-    transforms: TransformManifestEntry[];
-    presetStats?: Record<string, PresetStatsEntry>;
-};
-export declare const parseTransformManifest: (raw: string) => TransformManifest;
-export {};

package/dist/scripts/evaluate/parse-transform-manifest.js

@@ -1,29 +0,0 @@
-import * as z from "zod";
-const TransformManifestEntrySchema = z
-    .object({
-    id: z.string().min(1),
-    description: z.string(),
-    scope: z.union([z.literal("file"), z.literal("project")]),
-    parallelizable: z.boolean(),
-    diffReductionImpact: z.number(),
-    recommended: z.boolean(),
-    evaluatedAt: z.iso.datetime().optional(),
-    notes: z.string().optional(),
-    supersededBy: z.string().min(1).optional(),
-})
-    .loose();
-const PresetStatsEntrySchema = z
-    .object({
-    diffReductionImpact: z.number(),
-    notes: z.string().optional(),
-})
-    .loose();
-const TransformManifestSchema = z
-    .object({
-    transforms: z.array(TransformManifestEntrySchema),
-    presetStats: z.record(z.string(), PresetStatsEntrySchema).optional(),
-})
-    .loose();
-export const parseTransformManifest = (raw) => {
-    return TransformManifestSchema.parse(JSON.parse(raw));
-};

package/transform-manifest.json

@@ -1,251 +0,0 @@
-{
-  "transforms": [
-    {
-      "id": "expand-boolean-literals",
-      "description": "Expands !0 to true and !1 to false",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": true,
-      "evaluatedAt": "2026-01-21T15:01:23.708Z",
-      "notes": "Improves readability but does not reduce diffs (boolean literals are already deterministic)"
-    },
-    {
-      "id": "expand-undefined-literals",
-      "description": "Expands void 0 to undefined (when undefined is not shadowed)",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": true,
-      "evaluatedAt": "2026-01-21T16:27:42.316Z",
-      "notes": "Auto-added by evaluation script."
-    },
-    {
-      "id": "rename-loop-index-variables",
-      "description": "Renames numeric for-loop counters to index/index2/... based on nesting depth",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": false,
-      "evaluatedAt": "2026-01-21T21:06:19.512Z",
-      "notes": "Superseded by rename-loop-index-variables-v3.",
-      "supersededBy": "rename-loop-index-variables-v3"
-    },
-    {
-      "id": "rename-loop-index-variables-v2",
-      "description": "Renames numeric for-loop counters in `for (var ...)` (single or multi-declarator) and `for (let ...)` (multi-declarator) inits to index/index2/...",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": false,
-      "evaluatedAt": "2026-01-23T16:34:06.000Z",
-      "notes": "Superseded by rename-loop-index-variables-v3.",
-      "supersededBy": "rename-loop-index-variables-v3"
-    },
-    {
-      "id": "rename-loop-index-variables-v3",
-      "description": "Renames numeric for-loop counters (single or multi-declarator `for (var/let ...)`) to index/index2/... based on nesting depth",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": true,
-      "evaluatedAt": "2026-01-23T17:09:04.000Z",
-      "notes": "Unifies rename-loop-index-variables and rename-loop-index-variables-v2 without modifying older transforms. Measured with baseline none: 0.00%."
-    },
-    {
-      "id": "rename-catch-parameters",
-      "description": "Renames minified catch clause parameters to caughtError/caughtError2/...",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0.0007738623280043599,
-      "recommended": true,
-      "evaluatedAt": "2026-01-23T07:48:59.087Z",
-      "notes": "Auto-added by evaluation script."
-    },
-    {
-      "id": "rename-event-parameters",
-      "description": "Renames minified single-parameter event handlers to event/mouseEvent/keyboardEvent when usage is high-confidence",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": true,
-      "notes": "Added manually; recommended based on high-confidence heuristics (not yet evaluated)."
-    },
-    {
-      "id": "rename-destructured-aliases",
-      "description": "Renames destructuring aliases to match property names (e.g., { foo: x } → { foo })",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0.000943734546346775,
-      "recommended": true,
-      "evaluatedAt": "2026-01-22T12:49:10.952Z",
-      "notes": "Auto-added by evaluation script. Measured with baseline none: 0.09%."
-    },
-    {
-      "id": "rename-this-aliases",
-      "description": "Renames `var x = this` aliases to $thisRef (stable when unique) or thisRef/thisRef2/...",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0.00003774938185385768,
-      "recommended": true,
-      "evaluatedAt": "2026-01-23T17:57:26.908Z",
-      "notes": "Measured with baseline none: 0.00%. Improves readability by stabilizing `this` aliases used for closures."
-    },
-    {
-      "id": "expand-sequence-expressions-v4",
-      "description": "Expands comma operator sequences in returns, throws, statements (including control-flow bodies), and variable initializers",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": -0.01730809158000035,
-      "recommended": false,
-      "evaluatedAt": "2026-01-23T10:57:45.082Z",
-      "notes": "Measured with baseline none: -1.73%. Supersedes all prior sequence expression transforms. Superseded by expand-sequence-expressions-v5.",
-      "supersededBy": "expand-sequence-expressions-v5"
-    },
-    {
-      "id": "expand-sequence-expressions-v5",
-      "description": "Expands comma operator sequences in returns, throws, statements (including control-flow bodies), variable initializers, and `if` tests",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": -0.020243106019139034,
-      "recommended": true,
-      "notes": "Extends expand-sequence-expressions-v4 by also expanding `if ((a, b)) ...` style tests."
-    },
-    {
-      "id": "rename-use-reference-guards",
-      "description": "Renames boolean useRef(false) guard variables to hasRunRef/hasRunRef2/...",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": false,
-      "evaluatedAt": "2026-01-22T17:03:19.826Z",
-      "notes": "Superseded by rename-use-reference-guards-v2.",
-      "supersededBy": "rename-use-reference-guards-v2"
-    },
-    {
-      "id": "rename-use-reference-guards-v2",
-      "description": "Renames boolean useRef(false) guard variables (including reset-to-false guards) to hasRunRef/hasRunRef2/...",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": true,
-      "notes": "Supersedes rename-use-reference-guards and also covers guards that reset to false."
-    },
-    {
-      "id": "rename-timeout-ids",
-      "description": "Renames setTimeout handle variables to timeoutId/timeoutId2/... when usage is only clearTimeout(...)",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0.00003774938185385768,
-      "recommended": true,
-      "evaluatedAt": "2026-01-23T10:29:23.279Z",
-      "notes": "Measured with baseline none: 0.00%. Added to recommended for readability."
-    },
-    {
-      "id": "rename-comparison-flags",
-      "description": "Rename boolean variables assigned from string comparisons to descriptive flag names",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": true,
-      "evaluatedAt": "2026-01-23T17:54:14.000Z",
-      "notes": "Measured with baseline none: 0%. Improves readability by renaming minified variables like 'saA === \"darwin\"' to '$isDarwin'."
-    },
-    {
-      "id": "split-variable-declarations",
-      "description": "Splits multi-declarator variable declarations into separate statements",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": -0.0027651422207961573,
-      "recommended": true,
-      "evaluatedAt": "2026-01-23T05:45:27.981Z",
-      "notes": "Auto-added by evaluation script. Measured with baseline none: -0.28%. Enabled in the recommended preset for readability and to normalize variable declarations even when line diffs increase."
-    },
-    {
-      "id": "rename-promise-executor-parameters",
-      "description": "Renames promise-like executor parameters in `new X(executor)` to resolve/reject when usage is high-confidence",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": true,
-      "evaluatedAt": "2026-01-22T21:39:53.578Z",
-      "notes": "Auto-added by evaluation script."
-    },
-    {
-      "id": "rename-replace-child-parameters",
-      "description": "Renames replaceChild forwarding wrapper parameters to $newChild and $oldChild",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": false,
-      "evaluatedAt": "2026-01-23T17:28:09.184Z",
-      "notes": "Measured with baseline none: 0.00%."
-    },
-    {
-      "id": "expand-special-number-literals",
-      "description": "Expands 1/0 to Infinity, -1/0 (and 1/-0) to -Infinity, and 0/0 to NaN (when not shadowed)",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": true,
-      "evaluatedAt": "2026-01-23T08:17:45.579Z",
-      "notes": "Auto-added by evaluation script."
-    },
-    {
-      "id": "remove-redundant-else",
-      "description": "Removes redundant else blocks after return/throw/break/continue",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": true,
-      "evaluatedAt": "2026-01-23T18:15:00.000Z",
-      "notes": "Added manually; improves readability by reducing nesting."
-    },
-    {
-      "id": "rename-char-code-at",
-      "description": "Renames variables used in charCodeAt calls (str.charCodeAt(index))",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": true,
-      "evaluatedAt": "2026-01-23T18:00:00.000Z",
-      "notes": "Measured with baseline none: 0.00%. Renames variables used in charCodeAt to improve readability."
-    },
-    {
-      "id": "rename-parameters-to-match-properties",
-      "description": "Renames parameters that are assigned to object properties of the same name",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0.00003774938185385768,
-      "recommended": true,
-      "notes": "Added manually based on high-confidence heuristic."
-    },
-    {
-      "id": "rename-charcode-variables",
-      "description": "Renames variables assigned from .charCodeAt() to $charCode or charCode/charCode2/...",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": false,
-      "evaluatedAt": "2026-01-23T17:59:00.000Z",
-      "notes": "Superseded by rename-charcode-variables-v2.",
-      "supersededBy": "rename-charcode-variables-v2"
-    },
-    {
-      "id": "rename-charcode-variables-v2",
-      "description": "Renames variables assigned from .charCodeAt(arg) to $charCodeAt{Arg} based on the argument",
-      "scope": "file",
-      "parallelizable": true,
-      "diffReductionImpact": 0,
-      "recommended": true,
-      "evaluatedAt": "2026-01-23T18:10:00.000Z",
-      "notes": "Derives names from charCodeAt argument for better stability (e.g., $charCodeAtIndex, $charCodeAtIndexPlus1)."
-    }
-  ],
-  "presetStats": {
-    "recommended": {
-      "diffReductionImpact": 0.003690002076215948,
-      "notes": "Measured with baseline none: 0.37%."
-    }
-  }
-}