@putout/printer 1.45.0 → 1.46.0

package/ChangeLog

@@ -1,3 +1,8 @@
+2023.04.14, v1.46.0
+
+feature:
+- 7fafdd3 @putout/printer: add support of TSInterfaceDeclaration
+
 2023.04.14, v1.45.0
 
 feature:

package/README.md

@@ -7,7 +7,13 @@ Prints [**Babel AST**](https://github.com/coderaiser/estree-to-babel) to readabl
 
 - ☝️ Similar to **Recast**, but simpler and easier in maintenance, since it supports only **Babel**.
 - ☝️ As opinionated as **Prettier**, but has more user-friendly output and works directly with **AST**.
-- ☝️ Like **ESLint** but without any configuration and plugins 🤷‍, also works directly with **Babel AST** only.
+- ☝️ Like **ESLint** but works directly with **Babel AST**.
+- ☝️ Easily extandable with help of [Overrides](h#overrides).
+
+Supports:
+- ✅ **ES2023**;
+- ✅ **JSX**;
+- ✅ **TypeScript**;
 
 ## Install
 
@@ -64,7 +70,27 @@ print(ast, {
 'const {a /* [hello world] */= 5} = b;\n';
 ```
 
-## Maybe
+### `print`
+
+Used in previous example `print` can be used for a couple purposes:
+
+- to print `string`;
+- to print `node` when `object` passed;
+- to print `node` when `string` started with `__`;
+
+```js
+print(ast, {
+    visitors: {
+        AssignmentPattern(path, {print, maybe}) {
+            maybe.print.newline(path.parentPath.isCallExpression());
+            print(' /* [hello world] */= ');
+            print('__right');
+        },
+    },
+});
+```
+
+### `maybe`
 
 When you need some condition use `maybe`. For example, to add newline only when parent node is `CallExpression` you
 can use `maybe.print.newline(condition)`:
@@ -81,6 +107,56 @@ print(ast, {
 });
 ```
 
+### `write`
+
+When are you going to output string you can use low-level function `write`:
+
+```js
+print(ast, {
+    visitors: {
+        BlockStatement(path, {write}) {
+            write('hello');
+        },
+    },
+});
+```
+
+### `indent`
+
+When you need to add indentation use `indent`, for example when you output body,
+you need to increment indentation, and then decrement it back:
+
+```js
+print(ast, {
+    visitors: {
+        BlockStatement(path, {write, indent}) {
+            write('{');
+            indent.inc();
+            indent();
+            write('some;');
+            indent.dec();
+            write('{');
+        },
+    },
+});
+```
+
+### `traverse`
+
+When are you needing to traverse node, you can use `traverse`:
+
+```js
+print(ast, {
+    visitors: {
+        AssignmentExpression(path, {traverse}) {
+            traverse(path.get('left'));
+        },
+    },
+});
+```
+
+This is the same as `print('__left')` but more low-level, and supports only objects.
+
 ## License
 
 MIT

package/lib/tokenize/typescript/index.js

@@ -49,9 +49,32 @@ module.exports = {
         write(`${operator} `);
         print('__typeAnnotation');
     },
+    TSInterfaceDeclaration(path, {print}) {
+        print('interface ');
+        print('__id');
+        print('__body');
+    },
+    TSInterfaceBody(path, {traverse, write, indent}) {
+        write(' {');
+        write.newline();
+        indent.inc();
+        
+        for (const item of path.get('body')) {
+            indent();
+            traverse(item);
+            write(';');
+            write.newline();
+        }
+        
+        indent.dec();
+        write('}');
+    },
     TSUndefinedKeyword(path, {write}) {
         write('undefined');
     },
+    TSBooleanKeyword(path, {write}) {
+        write('boolean');
+    },
     TSUnionType(path, {traverse, write}) {
         const types = path.get('types');
         const n = types.length - 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@putout/printer",
-  "version": "1.45.0",
+  "version": "1.46.0",
   "type": "commonjs",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
   "description": "Easiest possible opinionated Babel AST printer made with ❤️  to use in 🐊Putout",