putout 42.5.2 → 42.7.0

package/ChangeLog

@@ -1,3 +1,68 @@
+2026.06.18, v42.7.0
+
+fix:
+- 3b465e12f @putout/plugin-markdown: simplify
+- 4031967e1 @putout/plugin-markdown: npmignore: fixture
+- 7b7fb253b @putout/test: noTransform: extensionFix
+
+feature:
+- 94a3fdcc2 putout: add types
+- 0d04bc6d2 @putotu/plugin-printer: add-missing-arrow-to-type-checker
+- 9b55a8a04 @putout/plugin-convert-throw: drop support of 🐊 < 42
+- 0e85d9564 eslint-plugin-putout: @babel/plugin-syntax-typescript v8.0.0
+- 4cba16d5e eslint-plugin-putout: @babel/core v8.0.0
+- 42dffd472 @putout/plugin-github: set-contents-permissions: exists, not write
+- 44d68381e @putout/plugin-github: set-contents-permissions: report
+- 02596465e @putout/plugin-github: set-contents-permissions
+- 5c08b01a2 @putout/plugin-for-of: for-each: return: exclude (putoutjs/minify#31)
+- 428d81d03 @putout/plugin-markdown: h1-6 -> heading
+- 316a1ec0d @putout/plugin-markdown: remove-trailing-whitespaces-from-heading
+- 8f897c666 @putout/plugin-markdown: remove-dependencies-status-badge
+- 8dd6d4f0d @putout/plugin-putout: convert-traverse-to-super-traverse
+- 95e5435f5 @putout/plugin-putout: declare: superTraverse
+- 1cee4ff4b @putout/traverse: superTraverse
+- 20f556566 @putout/plugin-markdown: split-link-with-title
+- 0e9b89571 @putout/test: noTransform: extensionFix
+
+2026.06.13, v42.6.0
+
+fix:
+- 1abfa724d @putout/plugin-markdown: main
+- e74d08c91 @putout/plugin-github: add-madrun-init: madrun init -> madrun --init
+- 9024f3779 @putout/plugin-github: add-madrun-init
+- 9ae73318b @putout/operator-match-files: operator- > operator-json
+- 4ae6ec3c8 @putout/operator-match-files: magic-print: rm beautify
+- 1daa95f8c @putout/plugin-destructuring: remove-useless-rename: exclude same
+
+feature:
+- 1fb288acf @putout/plugin-markdown: merge-heading-spaces: not string
+- 783c6d962 @putout/plugin-markdown: add
+- e31b4357b putout: @putout/processor-markdown v14.0.0
+- ff08aa120 @putout/plugin-markdown: add
+- 7243a8a1c @putout/plugin-putout: declare: __markdown
+- 1deeb22a4 @putout/processor-markdown: add ability to write 🐊Plugins to transform markdown
+- 3cde73957 @putout/operator-json: __markdown
+- 8cf53a90c @putout/plugin-printer: remove-args: ImportSpecifier: exclude
+- bcd307098 @putout/plugin-github: add-madrun-init
+- da41a1335 @putout/test: extensionFix
+- 47a02bc78 @putout/test: UPDATE_EXTENSION
+- 7ef878fd9 @putout/plugin-destructuring: remove-useless-rename
+- 9891a8bc2 @putout/plugin-filesystem: convert-yaml-to-toml
+- 68e9587ee @putout/plugin-convert-toml-to-yaml
+- 236480ddd @putout/plugin-filesystem: convert-toml-to-json
+- 6489ec337 @putout/plugin-filesystem: convert-json-to-toml
+- 48c2c32a2 @putout/processor-toml: smol-toml -> @decimalturn/toml-patch
+- a5b979703 @putout/plugin-putout: check-replace-code: __toml
+- e0c225e54 @putout/processor-toml: beautify
+- b23243234 @putout/operator-match-files: toml
+- 2dff587da @putout/plugin-declare: wrap: callWith: add
+- 54b1a9b51 @putout/plugin-filesystem: convert-json-to-yaml: add
+- 8f9481e59 @putout/operator-match-files: json to yaml
+- bc2df02c0 @putout/plugin-filesystem: private imports
+- c057a209c @putout/plugin-putout: check-replace-code: __yaml
+- da1ad34bf @putout/plugin-filesystem: convert-yaml-to-json: add
+- 92fbc982d @putout/operator-match-files: add support of yaml
+
 2026.06.05, v42.5.2
 
 feature:

package/lib/index.d.ts

@@ -0,0 +1,61 @@
+import {File, Program} from '@putout/babel';
+import {PutoutPlugin} from '../types/plugins.ts';
+
+export declare function parse(source: string): Program;
+export {traverse} from '@putout/babel';
+
+type PutoutReturn = {
+    code: string;
+    places: Place[];
+};
+
+export interface ParseOptions {
+    parser?: 'babel' | 'acorn' | 'espree' | 'esprima' | 'tenko';
+    printer?: 'putout' | 'babel';
+    isTS?: boolean;
+    isJSX?: boolean;
+}
+
+type RuleState = 'on' | 'off' | boolean;
+type RuleOptions = Record<string, unknown>;
+
+type RuleTuple =
+    | [RuleState]
+    | [RuleState, RuleOptions]
+    | [RuleState, string, RuleOptions]; // [state, message, options] — кастомный текст сообщения
+
+type RuleValue = RuleState | RuleTuple;
+
+export type Rules = Record<string, RuleValue>;
+
+export type TransformOptions = {
+    plugins?: (string | [string, Record<string, unknown>] | [string, PutoutPlugin])[];
+    rules?: Rules;
+    fix?: boolean;
+    fixCount?: number;
+    parser?: string;
+    printer?: string;
+};
+
+type Options = ParseOptions & TransformOptions;
+
+export default function putout(source: string, options: Options): PutoutReturn;
+
+export interface PrintOptions {
+    printer?: 'putout' | 'babel' | [string, Record<string, unknown>];
+}
+
+export function print(ast: File, options?: PrintOptions): string;
+
+export interface Place {
+    rule: string;
+    message: string;
+    position: {line: number; column: number};
+}
+
+export function transform(ast: File, options?: TransformOptions): Place[];
+export function transformAsync(ast: File, options?: TransformOptions): Promise<Place[]>;
+export function findPlaces(ast: File, options?: TransformOptions): Place[];
+export function findPlacesAsync(ast: File, options?: TransformOptions): Promise<Place[]>;
+
+export function codeframe(args: {source: string; error: {message: string; loc?: unknown}; highlightCode?: boolean}): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "putout",
-  "version": "42.5.2",
+  "version": "42.7.0",
   "type": "module",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
   "description": "🐊 Pluggable and configurable code transformer with built-in ESLint, Babel and support of js, jsx, typescript, flow, markdown, yaml and json",
@@ -35,11 +35,10 @@
   "scripts": {
     "wisdom": "madrun wisdom",
     "test": "madrun test",
-    "test:raw": "madrun test:raw",
+    "test:dts": "madrun test:dts",
     "watch:test": "madrun watch:test",
     "scheme": "madrun scheme",
     "lint": "madrun lint",
-    "oldlint": "madrun oldlint",
     "fresh:lint": "madrun fresh:lint",
     "fix:lint": "madrun fix:lint",
     "fix:lint:fresh": "madrun fix:lint:fresh",
@@ -128,6 +127,7 @@
     "@putout/plugin-labels": "^3.0.0",
     "@putout/plugin-logical-expressions": "^8.0.0",
     "@putout/plugin-madrun": "^23.0.0",
+    "@putout/plugin-markdown": "^1.0.0",
     "@putout/plugin-math": "^5.0.0",
     "@putout/plugin-maybe": "^5.0.0",
     "@putout/plugin-merge-duplicate-functions": "^4.0.0",
@@ -183,7 +183,7 @@
     "@putout/processor-ignore": "^7.0.0",
     "@putout/processor-javascript": "^5.0.0",
     "@putout/processor-json": "^10.0.0",
-    "@putout/processor-markdown": "^13.0.0",
+    "@putout/processor-markdown": "^14.0.0",
     "@putout/processor-toml": "^1.0.0",
     "@putout/processor-yaml": "^10.0.0",
     "@putout/traverse": "^16.0.0",
@@ -220,6 +220,7 @@
     "@putout/eslint-flat": "^4.0.0",
     "@putout/plugin-apply-entries": "^3.0.0",
     "@putout/test": "^15.1.0",
+    "check-dts": "^1.0.0",
     "currify": "^4.0.0",
     "eslint": "^10.0.0",
     "eslint-plugin-putout": "^31.0.0",

package/putout.json

@@ -58,6 +58,7 @@
             "esm/shorten-imported-file": "on"
         },
         "*.md": {
+            "markdown": "on",
             "apply-arrow": "off",
             "assignment/convert-to-declaration": "off",
             "conditions/apply-consistent-blocks": "off",
@@ -195,6 +196,7 @@
         "eslint": "off",
         "package-json": "off",
         "madrun": "off",
+        "markdown": "off",
         "webpack": "off",
         "gitignore": "off",
         "npmignore": "off",
@@ -281,6 +283,7 @@
         "coverage",
         "gitignore",
         "npmignore",
+        "markdown",
         "browserlist",
         "regexp",
         "github",

package/types/plugins.ts

@@ -0,0 +1,38 @@
+import {NodePath} from '@putout/babel';
+
+export type Traverse = (helpers: {
+    push: (path: NodePath) => void;
+    store: (key?: string, value?: unknown) => unknown;
+    listStore: (path?: NodePath) => NodePath[];
+    pathStore: (path?: NodePath) => NodePath[];
+}) => Record<string, (path: NodePath) => void>;
+
+export interface PutoutPlugin {
+    report: Report;
+    replace?: Replace;
+    fix?: Fix;
+    include?: Include;
+    exclude?: Exclude;
+    filter?: Filter;
+    traverse?: Traverse;
+}
+
+export type Report = () => string;
+
+export type Include = () => string[];
+export type Exclude = () => string[] | (() => boolean);
+
+export interface PluginOptions {
+    options?: Record<string, unknown>;
+}
+
+export type Filter = (path: NodePath, options: PluginOptions) => boolean;
+export type Fix = (path: NodePath, options: PluginOptions) => void;
+
+type ReplaceResolver = (
+    vars: Record<string, Node>,
+    path: NodePath,
+) => string | NodePath | '';
+
+export type Replace = () => Record<string, string | ReplaceResolver>;
+