putout 42.6.0 → 42.7.1

package/ChangeLog

@@ -1,3 +1,37 @@
+2026.06.19, v42.7.1
+
+feature:
+- 50f2d6089 @putout/operate: types
+- 01b034621 putout: types: improve
+- 26232a0f0 @putout/plugin-variables: remove-unused: TSImportEqualsDeclaration
+- acbfed8bf @putout/engine-loader: add additional validate of state
+
+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,87 @@
+import {
+    File,
+    Program,
+    Node,
+} from '@putout/babel';
+import {PutoutPlugin} from '../types/plugins.ts';
+
+export * as operator from '../types/operator.ts';
+
+export declare function parse(source: string): Program;
+export {traverse, types} from '@putout/babel';
+
+export declare function template(source: string, options?: Record<string, unknown>): (...args: unknown[]) => Node;
+export declare namespace template {
+    export function ast(source: string, options?: Record<string, unknown>): Node;
+    export function program(source: string, options?: Record<string, unknown>): (...args: unknown[]) => Node;
+    export function extractExpression(node: Node): Node;
+} export declare function generate(node: Node, options?: Record<string, unknown>, sourceMaps?: Record<string, unknown>): string;
+
+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];
+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 function putoutAsync(source: string, options: Options): Promise<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.1",
   "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/operator.ts

@@ -0,0 +1,2 @@
+export * from '@putout/operate';
+

package/types/plugins.ts

@@ -0,0 +1,36 @@
+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>;