putout 42.7.4 → 42.7.6

package/ChangeLog

@@ -1,3 +1,13 @@
+2026.06.22, v42.7.6
+
+feature:
+- d94d1b5a8 @putout/engine-parser: TS
+
+2026.06.21, v42.7.5
+
+feature:
+- 9f0295ca1 @putout/operator-ignore: TS
+
 2026.06.21, v42.7.4
 
 feature:

package/lib/index.d.ts

@@ -1,34 +1,34 @@
-import {
-    File,
-    Program,
-    Node,
-} from '@putout/babel';
+import {Program, Node} from '@putout/babel';
+import {PrinterOptions, ParseOptions} from '@putout/engine-parser';
 import {PutoutPlugin} from '../types/plugins.ts';
-
+export type * from '../types/plugins.ts';
 export * as operator from '../types/operator.ts';
 
-export declare function parse(source: string): Program;
+export type {
+    PrinterOptions,
+    ParseOptions,
+};
 export {traverse, types} from '@putout/babel';
 
-export declare function template(source: string, options?: Record<string, unknown>): (...args: unknown[]) => Node;
+export function parse(source: string, options?: ParseOptions): Program;
+
+export 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;
+}
+export 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 PrinterConfig =
+    | 'putout'
+    | 'babel'
+    | ['putout', PrinterOptions?]
+    | ['babel', Record<string, unknown>?];
 type RuleState = 'on' | 'off' | boolean;
 type RuleOptions = Record<string, unknown>;
 type RuleTuple = [
@@ -47,7 +47,7 @@ export type TransformOptions = {
     fix?: boolean;
     fixCount?: number;
     parser?: string;
-    printer?: string;
+    printer?: PrinterConfig;
 };
 
 type Options = ParseOptions & TransformOptions;
@@ -56,11 +56,7 @@ 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 function print(ast: Node, options?: PrinterOptions): string;
 
 export interface Place {
     rule: string;
@@ -71,10 +67,10 @@ export interface Place {
     };
 }
 
-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 transform(ast: Node, options?: TransformOptions): Place[];
+export function transformAsync(ast: Node, options?: TransformOptions): Promise<Place[]>;
+export function findPlaces(ast: Node, options?: TransformOptions): Place[];
+export function findPlacesAsync(ast: Node, options?: TransformOptions): Promise<Place[]>;
 
 export function codeframe(args: {
     source: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "putout",
-  "version": "42.7.4",
+  "version": "42.7.6",
   "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

@@ -3,4 +3,5 @@ export * from '@putout/compare';
 export * from '@putout/traverse';
 export * from '@putout/operator-json';
 export * from '@putout/operator-jsx';
+export * from '@putout/operator-ignore';
 

package/types/plugins.ts

@@ -7,15 +7,27 @@ export type Traverse = (helpers: {
     pathStore: (path?: NodePath) => NodePath[];
 }) => Record<string, (path: NodePath) => void>;
 
-export interface PutoutPlugin {
+export type Traverser = {
     report: Report;
-    replace?: Replace;
-    fix?: Fix;
-    include?: Include;
+    traverse: Traverse;
+    fix: Fix;
+};
+
+export type Replacer = {
+    report: Report;
+    replace: Replace;
+    match?: Match;
+};
+
+export type Includer = {
+    report: Report;
+    fix: Fix;
+    include: Include;
     exclude?: Exclude;
     filter?: Filter;
-    traverse?: Traverse;
-}
+};
+
+export type PutoutPlugin = Replacer | Includer | Traverser;
 
 export type Report = () => string;
 
@@ -23,9 +35,9 @@ export type Include = () => string[];
 
 export type Exclude = () => string[] | (() => boolean);
 
-export interface PluginOptions {
+export type PluginOptions = {
     options?: Record<string, unknown>;
-}
+};
 
 export type Filter = (path: NodePath, options: PluginOptions) => boolean;
 
@@ -34,3 +46,7 @@ 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>;
+
+type MatchResolver = (vars: Record<string, Node>, path: NodePath) => boolean;
+
+export type Match = () => Record<string, MatchResolver>;