putout 42.6.0 → 42.7.0

package/ChangeLog

@@ -1,3 +1,29 @@
+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:

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.6.0",
+  "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",
@@ -221,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/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>;
+