putout 42.7.0 → 42.7.1

package/ChangeLog

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

package/lib/index.d.ts

@@ -1,8 +1,21 @@
-import {File, Program} from '@putout/babel';
+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} from '@putout/babel';
+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;
@@ -18,12 +31,12 @@ export interface ParseOptions {
 
 type RuleState = 'on' | 'off' | boolean;
 type RuleOptions = Record<string, unknown>;
-
-type RuleTuple =
-    | [RuleState]
-    | [RuleState, RuleOptions]
-    | [RuleState, string, RuleOptions]; // [state, message, options] — кастомный текст сообщения
-
+type RuleTuple = [
+    RuleState,
+] | [
+    RuleState,
+    RuleOptions,
+] | [RuleState, string, RuleOptions];
 type RuleValue = RuleState | RuleTuple;
 
 export type Rules = Record<string, RuleValue>;
@@ -41,6 +54,8 @@ 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>];
 }
@@ -50,7 +65,10 @@ export function print(ast: File, options?: PrintOptions): string;
 export interface Place {
     rule: string;
     message: string;
-    position: {line: number; column: number};
+    position: {
+        line: number;
+        column: number;
+    };
 }
 
 export function transform(ast: File, options?: TransformOptions): Place[];
@@ -58,4 +76,12 @@ export function transformAsync(ast: File, options?: TransformOptions): Promise<P
 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;
+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.7.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",

package/types/operator.ts

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

package/types/plugins.ts

@@ -20,6 +20,7 @@ export interface PutoutPlugin {
 export type Report = () => string;
 
 export type Include = () => string[];
+
 export type Exclude = () => string[] | (() => boolean);
 
 export interface PluginOptions {
@@ -27,12 +28,9 @@ export interface PluginOptions {
 }
 
 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 | '';
+type ReplaceResolver = (vars: Record<string, Node>, path: NodePath) => string | NodePath | '';
 
 export type Replace = () => Record<string, string | ReplaceResolver>;
-