feature: @putout/plugin-nodejs: declare: buffer: add

Author: coderaiser

packages/plugin-nodejs/README.md

@@ -254,6 +254,7 @@ process.exit();
 
 Add declarations to built-in node.js modules:
 
+- [buffer](https://nodejs.org/dist/latest-v24.x/docs/api/buffer.html);
 - [child_process](https://nodejs.org/dist/latest-v24.x/docs/api/child_process.html);
 - [events](https://nodejs.org/dist/latest-v24.x/docs/api/events.html);
 - [fs](https://nodejs.org/dist/latest-v24.x/docs/api/fs.html);

packages/plugin-nodejs/lib/declare/buffer.spec.js

@@ -0,0 +1,19 @@
+import {createTest} from '@putout/test';
+import montag from 'montag';
+import * as declare from './index.js';
+
+const test = createTest(import.meta.url, {
+    plugins: [
+        ['nodejs/declare', declare],
+    ],
+});
+
+test('putout: plugin: nodejs: declare: buffer: setTimeout', (t) => {
+    t.transformCode('Buffer.from([])', montag`
+        import {Buffer} from 'node:buffer';
+        
+        Buffer.from([]);
+    
+    `);
+    t.end();
+});

packages/plugin-nodejs/lib/declare/index.js

@@ -1,3 +1,4 @@
+import buffer from './modules/buffer.js';
 import child_process from './modules/child_process.js';
 import util from './modules/util.js';
 import url from './modules/url.js';
@@ -13,6 +14,7 @@ import events from './modules/events.js';
 import timers from './modules/timers.js';
 
 export const declare = () => ({
+    ...buffer,
     ...events,
     ...fs,
     ...fsPromises,

packages/plugin-nodejs/lib/declare/modules/buffer.js

@@ -0,0 +1,9 @@
+export default {
+    Blob: `import {Blob} from 'node:buffer'`,
+    Buffer: `import {Buffer} from 'node:buffer'`,
+    File: `import {File} from 'node:buffer'`,
+    isAscii: `import {isAscii} from 'node:buffer'`,
+    isUtf8: `import {isUtf8} from 'node:buffer'`,
+    resolveObjectURL: `import {resolveObjectURL} from 'node:buffer'`,
+    transcode: `import {transcode} from 'node:buffer'`,
+};

packages/plugin-nodejs/scripts/create-declare.js

@@ -9,7 +9,7 @@ if (!name) {
     process.exit(1);
 }
 
-const data = await import(`${name}/promises`);
+const data = await import(String(name));
 const result = {};
 
 for (const key of keys(data)) {
@@ -19,7 +19,7 @@ for (const key of keys(data)) {
     if (key === 'default')
         continue;
 
-    result[key] = `import {${key}} from 'node:${name}/promises'`;
+    result[key] = `import {${key}} from 'node:${name}'`;
 }
 
 const output = `export default ${JSON.stringify(result, null, 4) + '\n'}`;

packages/plugin-nodejs/test/fixture/convert-buffer-to-buffer-alloc-fix.js

@@ -1,3 +1,5 @@
+import {Buffer} from 'node:buffer';
+
 const n = 100;
 const buf = [];
 

packages/putout/lib/loader/loader.mjs

@@ -1,4 +1,5 @@
 import process from 'node:process';
+import {Buffer} from 'node:buffer';
 import {putoutAsync} from '../putout.js';
 import ignores from '../ignores.js';
 import parseOptions from '../parse-options/index.js';

packages/putout/lib/loader/loader.spec.mjs

@@ -1,3 +1,4 @@
+import {Buffer} from 'node:buffer';
 import {test, stub} from 'supertape';
 import {
     load,