@frsource/frs-replace 4.1.0 → 5.0.0

package/bin/cli.mjs

@@ -0,0 +1,213 @@
+#!/usr/bin/env node
+import { resolve } from 'path';
+import yargs from 'yargs/yargs';
+import { hideBin } from 'yargs/helpers';
+import { sync } from '../dist/index.mjs';
+
+(~process.argv.indexOf('--no-stdin')
+  ? Promise.resolve()
+  : (await import('get-stdin')).default()
+).then(async (stdin) => {
+  const isPiped = !!stdin;
+
+  if (isPiped) {
+    process.argv.push('-c');
+    process.argv.push(stdin); // threat piped data as value for --content option
+  }
+
+  const isContentPresent = !!(
+    ~process.argv.indexOf('--content') || ~process.argv.indexOf('-c')
+  );
+  const isHelpPresent = !!(
+    ~process.argv.indexOf('--help') || ~process.argv.indexOf('-h')
+  );
+
+  const argv = await yargs(hideBin(process.argv))
+    .parserConfiguration({
+      'camel-case-expansion': false,
+    })
+    .scriptName('frs-replace')
+    .usage(
+      '$0 <needle> <replacement> [options]',
+      'Replace matching parts of string with replacement string/function',
+      (yargs) =>
+        yargs
+          .positional('needle', {
+            describe:
+              'String which is passed as a first parameter to RegExp constructor',
+            type: 'string',
+            demand: true,
+          })
+          .positional('replacement', {
+            describe:
+              'String or path to replacement function file (see --replace-fn switch for details)',
+            type: 'string',
+            demand: true,
+          })
+          .example(
+            '$0 a b -i foo.js -o foo_replaced.js',
+            'Replaces all "a" occurences with "b" from given foo.js and save result to foo_replaced.js',
+          )
+          .example(
+            '<read file> | $0 a b > <output-file-path>',
+            'Replaces all "a" occurences with "b" from stream and save it to output file',
+          )
+          .example(
+            '<read file> | $0 a b | <next-command>',
+            'Replaces all "a" occurences with "b" from stream and pass it through the stream to next command',
+          )
+          .example(
+            '$0 a b -i foo.js | <next-command>',
+            'Both pipe & options styles can be mixed together, here - getting input from "i" argument and passing output down the stream to next command',
+          )
+          .example(
+            '$0 a b --content abcd -o foo_replaced.js',
+            'Replace all "a" occurences with "b" in given "abcd" and save result (which is "bbcd") to foo_replaced.js',
+          ),
+    )
+
+    .option('f', {
+      alias: 'flags',
+      describe:
+        'RegExp flags used together with `needle` positional (supporting g, i & m)',
+      nargs: 1,
+      default: 'g',
+
+      choices: /** @type {const} */ ([
+        '',
+        'g',
+        'm',
+        'i',
+        'gm',
+        'gi',
+        'mi',
+        'mg',
+        'ig',
+        'im',
+        'gmi',
+        'gim',
+        'mig',
+        'mgi',
+        'igm',
+        'img',
+      ]),
+      coerce: (arg) => arg.trim(),
+    })
+    .option('i', {
+      demandOption: !isContentPresent && !isHelpPresent,
+      alias: 'input',
+      describe:
+        'Path to files or fast-glob pattern pointing to files to read & replace from',
+      array: true,
+      string: true,
+    })
+
+    .option('i-read-opts', {
+      implies: 'i',
+      describe: 'Passed to fs.readFileSync when reading input file',
+      defaultDescription: 'utf8', // will use node's default value
+    })
+
+    .option('i-glob-opts', {
+      describe: 'Passed to fast-glob.sync when resolving glob patterns',
+      implies: 'i',
+    })
+
+    .option('stdin', {
+      describe:
+        'Wait for stdin input (should be set to false when used in non-interactive terminals)',
+      boolean: true,
+      default: true,
+    })
+
+    .option('c', {
+      demandOption: isContentPresent,
+      alias: 'content',
+      describe:
+        'Content to be replaced (takes precedence over stream & file input)',
+      string: true,
+      nargs: 1,
+    })
+
+    .option('s', {
+      alias: 'strategy',
+      describe: `output file generation strategy.
+    \`join\` - join all input files and saves single file using "output" option as it's path,
+    \`preserve-structure\` - when replacing files content copies them over to the directory specified by "output" option.
+    \`flatten\` - same as \`preserve-structure\` but flattens the directory structure`,
+      nargs: 1,
+      choices: /** @type {const} */ (['join', 'flatten', 'preserve-structure']),
+      default: 'join',
+      coerce: (arg) => arg.trim(),
+    })
+
+    .option('o', {
+      alias: 'output',
+      describe:
+        "Output file name/path (replaces the file if it already exists and creates any intermediate directories if they don't already exist) or (when used together with `strategy` = `flatten` or `preserve-structure`) path to the output directory",
+      string: true,
+      nargs: 1,
+    })
+
+    .option('o-write-opts', {
+      describe: "Passed as options argument of write's .sync method",
+      defaultDescription: 'utf8', // will use node's default value
+      implies: 'o',
+    })
+
+    .option('o-join-str', {
+      describe:
+        'String used when joining multiple files (use it together with either `output` or `stdout` option)',
+      default: undefined,
+      defaultDescription: 'newline (\\n)', // will use node's default value
+    })
+
+    .option('stdout', {
+      describe: 'Force sending output on stdout',
+      boolean: true,
+      default: isPiped,
+      defaultDescription: 'true when piped input present, false otherwise',
+    })
+
+    .option('r', {
+      alias: 'replace-fn',
+      describe:
+        'Treat replacement argument as path to file containing replacement function',
+      boolean: true,
+    })
+
+    .help('h')
+    .alias('h', 'help')
+
+    .version('v')
+    .alias('v', 'version')
+
+    .epilog('Brought to you with open-source love by FRSOURCE').argv;
+
+  try {
+    const result = sync({
+      input: argv.i,
+      inputReadOptions: argv['i-read-opts'],
+      inputGlobOptions:
+        /** @type import('fast-glob').Options */ argv['i-glob-opts'],
+      content: argv.c,
+      strategy: argv.s,
+      output: argv.o,
+      outputWriteOptions: argv['o-write-opts'],
+      outputJoinString: argv['o-join-str'],
+      needle: new RegExp(argv.needle, argv.f),
+      replacement: argv.r
+        ? (await import(resolve(argv.replacement))).default
+        : argv.replacement,
+    });
+
+    if (argv.stdout) {
+      process.stdout.write(result[0][1]);
+    }
+
+    return process.exit();
+  } catch (e) /* c8 ignore next */ {
+    process.stderr.write(e.toString());
+    return process.exit(1);
+  }
+});

package/dist/async.d.ts

@@ -0,0 +1,3 @@
+import type { Args, FileResult } from './types.js';
+declare const _default: ({ strategy, needle, replacement, ...args }: Args) => Promise<FileResult[]>;
+export default _default;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export { default as sync } from './sync.js';
+export { default as async } from './async.js';

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import{normalize as t,sep as e,dirname as n,join as r}from"path";import{readFileSync as i,mkdirSync as o,writeFileSync as u,readFile as s,promises as a}from"fs";import l from"fast-glob";function p(t,e){if(null==t)return{};var n={};for(var r in t)if(Object.prototype.hasOwnProperty.call(t,r)){if(e.indexOf(r)>=0)continue;n[r]=t[r]}return n}const c=t=>{throw new Error(`@frsource/frs-replace :: ${t}`)},f=(t,e)=>"string"==typeof t?n=>{const r=t.length;let i,o="",u=0;for(;-1!==(i=n.indexOf(t,u));)o+=n.slice(u,i)+e,u=i+r;return o+n.slice(u,n.length)}:n=>n.replace(t,e),d=["strategy","needle","replacement"],v=(t,e,r)=>{o(n(t),{recursive:!0}),u(t,e,r)},g={join:(t,e)=>{var n;let r=(null==(n=t[0])?void 0:n[1])||"";for(let n=1;n<t.length;++n)r+=e+t[n][1];return[[["",r]]]},flatten:t=>{for(let n=0;n<t.length;++n){const r=t[n][0];t[n][0]=r.substring(r.lastIndexOf(e))}return[t]},"preserve-structure":(...t)=>t},m=(t,e,n)=>{for(let i=0;i<t.length;++i){const o=t[i];o[0]=r(e,o[0]),v(o[0],o[1],n)}return t},w={join:(t,e,n)=>(v(e,t[0][1],n),t[0][0]=e,t),flatten:m,"preserve-structure":m};var O=e=>{var n;let r,{strategy:o="join",needle:u,replacement:s}=e,a=p(e,d);const v=f(u,s);if("content"in a&&void 0!==a.content)r=[["",v(a.content)]];else if("input"in a&&void 0!==a.input){null!=a.inputReadOptions||(a.inputReadOptions="utf8"),r=[];const t=l.sync(a.input,a.inputGlobOptions),e=t.length;for(let n=0;n<e;++n){const e=t[n];r.push([e,v(i(e,a.inputReadOptions).toString())])}}else c("at least one input source must be defined! Use either 'content' or 'input' param.");g[o]||c('unsupported strategy used! Possible values are: "join", "preserve-structure" or "flatten"');const m=null!=(n="outputJoinString"in a?a.outputJoinString:void 0)?n:"\n";return[r]=g[o](r,m),"output"in a&&void 0!==a.output&&(null!=a.outputWriteOptions||(a.outputWriteOptions="utf8"),r=w[o](r,t(a.output),a.outputWriteOptions)),r};const y=["strategy","needle","replacement"],h=async(t,e,r)=>{await a.mkdir(n(t),{recursive:!0}),await a.writeFile(t,e,r)},b={join:async(t,e)=>[await Promise.all(await t).then(t=>{const n=t.length;let r=t[0]&&t[0][1]||"";for(let i=1;i<n;++i)r+=e+t[i][1];return["",r]})],flatten:async t=>await Promise.all((await t).map(async t=>((t=await t)[0]=t[0].substring(t[0].lastIndexOf(e)),t))),"preserve-structure":async t=>await Promise.all(await t)},j=async(t,e,n)=>Promise.all((await t).map(async t=>(t[0]=r(e,t[0]),await h(t[0],t[1],n),t))),P={join:async(t,e,n)=>{const r=(await t)[0];return await h(e,r[1],n),r[0]=e,[r]},flatten:j,"preserve-structure":j};var R=async e=>{var n;let r,{strategy:i="join",needle:o,replacement:u}=e,a=p(e,y);const d=f(o,u);if("content"in a&&void 0!==a.content)r=[["",d(a.content)]];else if("input"in a&&void 0!==a.input){null!=a.inputReadOptions||(a.inputReadOptions="utf8");const t=[],e=l.stream(a.input,a.inputGlobOptions);e.on("error",c),e.on("data",e=>t.push(new Promise((t,n)=>s(e,a.inputReadOptions,(r,i)=>{if(r)return n(r);t([e,d(i.toString())])})))),r=new Promise(n=>e.once("end",()=>n(t))).catch(c)}else c("at least one input source must be defined!");b[i]||c('unsupported strategy used! Possible values are: "join", "preserve-structure" or "flatten"');const v=null!=(n="outputJoinString"in a?a.outputJoinString:void 0)?n:"\n";let g=await b[i](r,v);return"output"in a&&void 0!==a.output&&(null!=a.outputWriteOptions||(a.outputWriteOptions="utf8"),g=await P[i](g,t(a.output),a.outputWriteOptions)),g};export{R as async,O as sync};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/utils.ts","../src/sync.ts","../src/async.ts"],"sourcesContent":["import type { Args } from './types.js';\n\nexport const writeError = (msg: string) => {\n  throw new Error(`@frsource/frs-replace :: ${msg}`);\n};\n\nexport const getReplaceFn = (needle: Args['needle'], replacement: string) =>\n  typeof needle === 'string'\n    ? (content: string) => {\n        const needleLen = needle.length;\n        let result = '';\n        let i;\n        let endIndex = 0;\n\n        while ((i = content.indexOf(needle, endIndex)) !== -1) {\n          result += content.slice(endIndex, i) + replacement;\n          endIndex = i + needleLen;\n        }\n\n        return result + content.slice(endIndex, content.length);\n      }\n    : (content: string) => content.replace(needle, replacement);\n","import { sep, join, normalize, dirname } from 'path';\nimport { readFileSync, writeFileSync, mkdirSync } from 'fs';\nimport fastGlob from 'fast-glob';\nimport { writeError, getReplaceFn } from './utils.js';\nimport type {\n  Strategy,\n  InputStrategyFnSync,\n  OutputStrategyFnSync,\n  Args,\n  FileResult,\n} from './types.js';\n\nconst writeSync = (\n  path: string,\n  data: string,\n  options: Parameters<typeof writeFileSync>[2],\n) => {\n  mkdirSync(dirname(path), { recursive: true });\n  writeFileSync(path, data, options);\n};\n\nconst inputStrategyMap = {\n  join: (results, outputJoinString) => {\n    let result = results[0]?.[1] || '';\n    for (let i = 1; i < results.length; ++i) {\n      result += outputJoinString + results[i][1];\n    }\n    return [[['', result]]];\n  },\n  flatten: (results) => {\n    for (let i = 0; i < results.length; ++i) {\n      const result = results[i][0];\n      results[i][0] = result.substring(result.lastIndexOf(sep));\n    }\n    return [results];\n  },\n  'preserve-structure': (...args) => args,\n} satisfies Record<Strategy, InputStrategyFnSync>;\n\nconst multipleFilesOutputStrategy: OutputStrategyFnSync = (\n  results,\n  output,\n  outputWriteOptions,\n) => {\n  for (let i = 0; i < results.length; ++i) {\n    const result = results[i];\n    result[0] = join(output, result[0]);\n    writeSync(result[0], result[1], outputWriteOptions);\n  }\n  return results;\n};\n\nconst outputStrategyMap = {\n  join: (results, output, outputWriteOptions) => {\n    writeSync(output, results[0][1], outputWriteOptions);\n    results[0][0] = output;\n    return results;\n  },\n  flatten: multipleFilesOutputStrategy,\n  'preserve-structure': multipleFilesOutputStrategy,\n} satisfies Record<Strategy, OutputStrategyFnSync>;\n\nexport default ({ strategy = 'join', needle, replacement, ...args }: Args) => {\n  let results: FileResult[];\n  const replaceFn = getReplaceFn(needle, replacement);\n\n  if ('content' in args && args.content !== undefined) {\n    results = [['', replaceFn(args.content)]];\n  } else if ('input' in args && args.input !== undefined) {\n    args.inputReadOptions ??= 'utf8';\n    results = [];\n\n    const files = fastGlob.sync(args.input, args.inputGlobOptions);\n    const len = files.length;\n    for (let i = 0; i < len; ++i) {\n      const filePath = files[i];\n      results.push([\n        filePath,\n        replaceFn(readFileSync(filePath, args.inputReadOptions).toString()),\n      ]);\n    }\n  } else {\n    writeError(\n      \"at least one input source must be defined! Use either 'content' or 'input' param.\",\n    );\n  }\n\n  if (!inputStrategyMap[strategy])\n    writeError(\n      'unsupported strategy used! Possible values are: \"join\", \"preserve-structure\" or \"flatten\"',\n    );\n\n  const outputJoinString =\n    ('outputJoinString' in args ? args.outputJoinString : undefined) ?? '\\n';\n\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n  [results] = inputStrategyMap[strategy](results!, outputJoinString);\n\n  if ('output' in args && args.output !== undefined) {\n    args.outputWriteOptions ??= 'utf8';\n\n    results = outputStrategyMap[strategy](\n      results,\n      normalize(args.output),\n      args.outputWriteOptions,\n    );\n  }\n\n  return results;\n};\n","import { sep, join, normalize, dirname } from 'path';\nimport { readFile, promises as fs } from 'fs';\nimport fastGlob from 'fast-glob';\nimport { writeError, getReplaceFn } from './utils.js';\nimport type {\n  Strategy,\n  InputStrategyFn,\n  OutputStrategyFn,\n  Args,\n  FileResult,\n} from './types.js';\n\nconst write = async (\n  path: string,\n  data: string,\n  options: Parameters<(typeof fs)['writeFile']>[2],\n) => {\n  await fs.mkdir(dirname(path), { recursive: true });\n  await fs.writeFile(path, data, options);\n};\n\nconst inputStrategyMap = {\n  join: async (results, outputJoinString) => [\n    await Promise.all(await results).then((results) => {\n      const len = results.length;\n      let result = (results[0] && results[0][1]) || '';\n      for (let i = 1; i < len; ++i) {\n        result += outputJoinString + results[i][1];\n      }\n      return ['', result];\n    }),\n  ],\n  flatten: async (results) =>\n    await Promise.all(\n      (await results).map(async (result) => {\n        result = await result;\n        result[0] = result[0].substring(result[0].lastIndexOf(sep));\n        return result;\n      }),\n    ),\n  'preserve-structure': async (results) => await Promise.all(await results),\n} satisfies Record<Strategy, InputStrategyFn>;\n\nconst multipleFilesOutputStrategy: OutputStrategyFn = async (\n  results,\n  output,\n  outputWriteOptions,\n) =>\n  Promise.all(\n    (await results).map(async (result) => {\n      result[0] = join(output, result[0]);\n      await write(result[0], result[1], outputWriteOptions);\n      return result;\n    }),\n  );\n\nconst outputStrategyMap = {\n  join: async (results, output, outputWriteOptions) => {\n    const result = (await results)[0];\n    await write(output, result[1], outputWriteOptions);\n    result[0] = output;\n    return [result];\n  },\n  flatten: multipleFilesOutputStrategy,\n  'preserve-structure': multipleFilesOutputStrategy,\n} satisfies Record<Strategy, OutputStrategyFn>;\n\nexport default async ({\n  strategy = 'join',\n  needle,\n  replacement,\n  ...args\n}: Args) => {\n  let inputData: Parameters<InputStrategyFn>[0];\n  const replaceFn = getReplaceFn(needle, replacement);\n\n  if ('content' in args && args.content !== undefined) {\n    inputData = [['', replaceFn(args.content)]];\n  } else if ('input' in args && args.input !== undefined) {\n    args.inputReadOptions ??= 'utf8';\n    const replacePromises: Promise<FileResult>[] = [];\n\n    const fileStream = fastGlob.stream(args.input, args.inputGlobOptions);\n    fileStream.on('error', writeError);\n    fileStream.on('data', (path) =>\n      replacePromises.push(\n        new Promise((resolve, reject) =>\n          readFile(path, args.inputReadOptions, (error, data) => {\n            /* c8 ignore next */\n            if (error) return reject(error);\n\n            resolve([path, replaceFn(data.toString())]);\n          }),\n        ),\n      ),\n    );\n    inputData = new Promise<typeof replacePromises>((resolve) =>\n      fileStream.once('end', () => resolve(replacePromises)),\n    ).catch(writeError);\n  } else {\n    writeError('at least one input source must be defined!');\n  }\n\n  if (!inputStrategyMap[strategy])\n    writeError(\n      'unsupported strategy used! Possible values are: \"join\", \"preserve-structure\" or \"flatten\"',\n    );\n\n  const outputJoinString =\n    ('outputJoinString' in args ? args.outputJoinString : undefined) ?? '\\n';\n\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n  let results = await inputStrategyMap[strategy](inputData!, outputJoinString);\n\n  if ('output' in args && args.output !== undefined) {\n    args.outputWriteOptions ??= 'utf8';\n\n    results = await outputStrategyMap[strategy](\n      results,\n      normalize(args.output),\n      args.outputWriteOptions,\n    );\n  }\n\n  return results;\n};\n"],"names":["writeError","msg","Error","getReplaceFn","needle","replacement","content","needleLen","length","i","result","endIndex","indexOf","slice","replace","_excluded","writeSync","path","data","options","mkdirSync","dirname","recursive","writeFileSync","inputStrategyMap","join","results","outputJoinString","_results$","flatten","substring","lastIndexOf","sep","preserve-structure","args","multipleFilesOutputStrategy","output","outputWriteOptions","outputStrategyMap","_ref","_ref2","strategy","_objectWithoutPropertiesLoose","replaceFn","undefined","input","_args$inputReadOption","inputReadOptions","files","fastGlob","sync","inputGlobOptions","len","filePath","push","readFileSync","toString","_args$outputWriteOpti","normalize","write","async","fs","mkdir","writeFile","Promise","all","then","map","inputData","replacePromises","fileStream","stream","on","resolve","reject","readFile","error","once","catch"],"mappings":"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"}

package/dist/sync.d.ts

@@ -0,0 +1,3 @@
+import type { Args, FileResult } from './types.js';
+declare const _default: ({ strategy, needle, replacement, ...args }: Args) => FileResult[];
+export default _default;

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+/// <reference types="node" />
+import type { readFileSync, writeFileSync } from 'fs';
+import type { sync as globSync } from 'fast-glob';
+export type Strategy = 'join' | 'flatten' | 'preserve-structure';
+export type CommonArgs = {
+    strategy?: Strategy;
+    needle: string | RegExp;
+    replacement: string;
+};
+export type InputArgs = {
+    input: Parameters<typeof globSync>[0];
+    inputReadOptions?: Parameters<typeof readFileSync>[1];
+    inputGlobOptions?: Parameters<typeof globSync>[1];
+} | {
+    content: string;
+};
+export type OutputArgs = {
+    output?: string;
+    outputWriteOptions?: Parameters<typeof writeFileSync>[2];
+    outputJoinString?: string;
+} | object;
+export type Args = CommonArgs & InputArgs & OutputArgs;
+export type FileResult = [string, string];
+export type InputStrategyFnSync = (results: FileResult[], outputJoinString: string) => [FileResult[]] | [FileResult[], string];
+export type OutputStrategyFnSync = (results: FileResult[], output: string, outputWriteOptions: Parameters<typeof writeFileSync>[2]) => FileResult[];
+export type InputStrategyFn = (results: Promise<Promise<FileResult>[]> | FileResult[], outputJoinString: string) => Promise<FileResult[]> | FileResult[];
+export type OutputStrategyFn = (results: Promise<FileResult[]> | FileResult[], output: string, outputWriteOptions: Parameters<typeof writeFileSync>[2]) => Promise<FileResult[]>;

package/dist/utils.d.ts

@@ -0,0 +1,3 @@
+import type { Args } from './types.js';
+export declare const writeError: (msg: string) => never;
+export declare const getReplaceFn: (needle: Args['needle'], replacement: string) => (content: string) => string;

package/package.json

@@ -1,29 +1,33 @@
 {
   "name": "@frsource/frs-replace",
-  "version": "4.1.0",
+  "version": "5.0.0",
   "description": "Simple wrapper around javascript replace with CLI usage support!",
   "bin": {
-    "frs-replace": "./bin/cli.js"
+    "frs-replace": "./bin/cli.mjs"
   },
-  "main": "index.js",
-  "repository": "https://github.com/FRSource/frs-replace.git",
+  "type": "module",
+  "source": "src/index.ts",
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.mjs"
+    },
+    "./*": "./*.mjs"
+  },
+  "repository": "https://github.com/FRSOURCE/frs-replace.git",
   "author": "Jakub Freisler <FRSgit@users.noreply.github.com>",
-  "license": "Apache-2.0",
+  "license": "MIT",
+  "packageManager": "pnpm@8.15.9",
   "bugs": {
-    "url": "https://github.com/FRSource/frs-replace/issues"
+    "url": "https://github.com/FRSOURCE/frs-replace/issues"
   },
-  "homepage": "https://github.com/FRSource/frs-replace#readme",
+  "homepage": "https://github.com/FRSOURCE/frs-replace#readme",
   "files": [
-    "bin/cli.js",
-    "src/sync.js",
-    "src/async.js",
-    "src/utils.js",
-    "sync.js",
-    "async.js",
-    "index.js",
-    "LICENSE",
-    "package.json",
-    "yarn.lock"
+    "bin/cli.mjs",
+    "dist",
+    "package.json"
   ],
   "keywords": [
     "replace",
@@ -41,34 +45,52 @@
     "javascript"
   ],
   "scripts": {
-    "prerelease": "yarn standard:fix && yarn test",
-    "release": "standard-version",
-    "postrelease": "git push --follow-tags origin master && yarn publish",
-    "pretest": "standard",
-    "test": "yarn test:unit --100",
-    "posttest": "tap --coverage-report=html",
-    "pretest:unit": "yarn standard:fix",
-    "test:unit": "tap ./src/*.test.js ./bin/*.test.js -J",
-    "test:unit:debug": "tap ./bin/cli.spec.test.js -J -R spec",
-    "test:benchmark": "tap ./benchmark/*.benchmark.test.js --no-timeout --no-coverage",
-    "test:benchmark:glob": "yarn test:benchmark --grep=\"/input as glob pattern/\"",
-    "test:benchmark:string": "yarn test:benchmark --grep=\"/input & replacement as strings/\"",
-    "standard:fix": "standard --fix"
+    "start": "pnpm clean && microbundle watch",
+    "build": "pnpm clean && microbundle src/index.ts --target node --compress -f modern",
+    "release": "semantic-release",
+    "release:ci": "pnpm release --yes",
+    "test": "vitest",
+    "coverage": "vitest --coverage",
+    "test:ci": "vitest run --coverage --allowOnly && vitest bench --run --allowOnly && TEST_TYPE=bench vitest run --allowOnly",
+    "eslint": "eslint .",
+    "prettier": "prettier . --check",
+    "lint": "pnpm eslint && pnpm prettier",
+    "fix": "pnpm eslint --fix && prettier . --write",
+    "bench": "vitest bench",
+    "test:bench": "TEST_TYPE=bench vitest",
+    "clean": "rimraf dist"
   },
   "devDependencies": {
-    "perfy": "1.1.5",
-    "replace": "1.2.2",
-    "replace-in-file": "6.3.5",
-    "replace-string": "3.1.0",
-    "standard": "17.0.0",
-    "standard-version": "9.5.0",
-    "tap": "16.3.4",
-    "tmp-promise": "3.0.3"
+    "@frsource/eslint-config": "1.7.0",
+    "@frsource/prettier-config": "1.5.0",
+    "@frsource/semantic-release-config": "^1.35.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^12.0.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^10.0.3",
+    "@semantic-release/npm": "^12.0.0",
+    "@semantic-release/release-notes-generator": "^13.0.0",
+    "@types/node": "20.11.1",
+    "@types/yargs": "^17.0.32",
+    "@vitest/coverage-v8": "1.6.0",
+    "@vitest/ui": "1.6.0",
+    "eslint": "^9.2.0",
+    "execa": "^9.5.2",
+    "globals": "^15.14.0",
+    "globals-vitest": "^1.6.0",
+    "microbundle": "^0.15.1",
+    "prettier": "^3.2.5",
+    "replace-in-file": "8.3.0",
+    "replace-string": "4.0.0",
+    "rimraf": "^5.0.5",
+    "semantic-release": "^23.0.8",
+    "tmp-promise": "3.0.3",
+    "typescript": "^5.4.5",
+    "vitest": "1.6.0"
   },
   "dependencies": {
-    "fast-glob": "^3.1.0",
-    "get-stdin": "^8.0.0",
-    "write": "^2.0.0",
-    "yargs": "^17.0.0"
+    "fast-glob": "3.3.2",
+    "get-stdin": "9.0.0",
+    "yargs": "17.7.2"
   }
 }

package/CHANGELOG.md

@@ -1,186 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
-
-## [4.1.0](https://github.com/FRSource/frs-replace/compare/v4.0.0...v4.1.0) (2023-02-05)
-
-
-### Features
-
-* add stdin flag ([7574b49](https://github.com/FRSource/frs-replace/commit/7574b49274a525432f0353b0ce24c54e1514e580))
-
-## [4.0.0](https://github.com/FRSource/frs-replace/compare/v3.0.3...v4.0.0) (2022-12-07)
-
-
-### ⚠ BREAKING CHANGES
-
-* from now on replatement file path should be relative to projects' root
-
-Signed-off-by: Jakub Freisler <jakub@frsource.org>
-
-### Features
-
-* require replacement method in scope of projects' root ([69fc050](https://github.com/FRSource/frs-replace/commit/69fc05009bf11230fbab73d649b4ce636ebbc8e2))
-
-### [3.0.3](https://github.com/FRSource/frs-replace/compare/v3.0.2...v3.0.3) (2021-04-18)
-
-### [3.0.2](https://github.com/FRSource/frs-replace/compare/v3.0.1...v3.0.2) (2021-04-18)
-
-
-### Bug Fixes
-
-* cli release ([#122](https://github.com/FRSource/frs-replace/issues/122)) ([f813be4](https://github.com/FRSource/frs-replace/commit/f813be403baf49a0c8e8a878e8e4687a73a39832))
-
-### [3.0.1](https://github.com/FRSource/frs-replace/compare/v3.0.0...v3.0.1) (2021-01-02)
-
-### Bug Fixes
-
-* security update: ini ([#110](https://github.com/FRSource/frs-replace/pull/110))
-* updates: standard ([#107](https://github.com/FRSource/frs-replace/pull/107)), tap ([#106](https://github.com/FRSource/frs-replace/pull/106)), yargs ([#108](https://github.com/FRSource/frs-replace/pull/108)), standard-version ([#111](https://github.com/FRSource/frs-replace/pull/111))
-
-## [3.0.0](https://github.com/FRSource/frs-replace/compare/v2.1.2...v3.0.0) (2020-10-27)
-
-
-### ⚠ BREAKING CHANGES
-
-* from this version on Node.js api ALWAYS returns an array of replace result array, where replace result array follows the pattern: `[<replaced/new file path>, <replaced content>]`
-* renamed `regex` option to `needle`
-* renamed `inputJoinString` option to `outputJoinString`
-
-### Features
-
-* different output strategies support ([#100](https://github.com/FRSource/frs-replace/issues/100)) ([d9cabac](https://github.com/FRSource/frs-replace/commit/d9cabac7d220a770637f5ef455e2770b1e28cdd4))
-
-### [2.1.2](https://github.com/FRSource/frs-replace/compare/v2.1.1...v2.1.2) (2020-10-14)
-
-### Bug Fixes
-
-* migration to yargs v16 ([yargs changelog](https://github.com/yargs/yargs/blob/master/CHANGELOG.md#1600-2020-09-09))
-
-### [2.1.1](https://github.com/FRSource/frs-replace/compare/v2.1.0...v2.1.1) (2020-05-16)
-
-
-### Bug Fixes
-
-* cli path for binary command ([2546905](https://github.com/FRSource/frs-replace/commit/254690572e86d31c60aaac5b234fbb6b5d11eabf))
-
-## [2.1.0](https://github.com/FRSource/frs-replace/compare/v2.0.1...v2.1.0) (2020-05-15)
-
-
-### Features
-
-* change npm package name - add it [@frsource](https://github.com/frsource) scope ([0208a90](https://github.com/FRSource/frs-replace/commit/0208a900c88f29ac167e06524ba583ea62eeb457))
-* rename FRS-replace to frs-replace ([#73](https://github.com/FRSource/frs-replace/issues/73)) ([8547685](https://github.com/FRSource/frs-replace/commit/8547685e09e133265ba493b8e5349adf8298b463))
-
-### [2.0.1](https://github.com/FRSource/frs-replace/compare/v2.0.0...v2.0.1) (2019-11-01)
-
-## [2.0.0](https://github.com/FRSource/frs-replace/compare/v1.0.1...v2.0.0) (2019-10-21)
-
-
-### ⚠ BREAKING CHANGES
-
-* **package:** fast-glob does not support backslashes in glob patterns anymore, always use forward-slashes
-
-### Features
-
-* better parallelization ([4d90537](https://github.com/FRSource/frs-replace/commit/4d905375f0550a097d9464b742d13515e1314c94)), closes [#17](https://github.com/FRSource/frs-replace/issues/17) [#10](https://github.com/FRSource/frs-replace/issues/10) [#19](https://github.com/FRSource/frs-replace/issues/19)
-
-
-### Bug Fixes
-
-* **package:** update fast-glob to version 3.1.0 ([#44](https://github.com/FRSource/frs-replace/issues/44)) ([735785d](https://github.com/FRSource/frs-replace/commit/735785dfdc99869096cd4c6a3be60fb8f796d54b))
-* **package:** update write to version 2.0.0 ([#36](https://github.com/FRSource/frs-replace/issues/36)) ([d0b7ffd](https://github.com/FRSource/frs-replace/commit/d0b7ffdbbd668262860e130551e64b54840ac782))
-* **package:** update yargs to version 14.2.0 ([#45](https://github.com/FRSource/frs-replace/issues/45)) ([6df29e4](https://github.com/FRSource/frs-replace/commit/6df29e4e9bda262f9467d85349cd1c61d260c328)), closes [#35](https://github.com/FRSource/frs-replace/issues/35)
-
-## [1.0.1](https://github.com/FRSource/frs-replace/compare/v1.0.0...v1.0.1) (2019-10-18)
-
-
-### Bug Fixes
-
-* **package:** update yargs to version 13.2.2 ([749b721](https://github.com/FRSource/frs-replace/commit/749b72144049d9c900b04dd2b14473938af963d7)), closes [#20](https://github.com/FRSource/frs-replace/issues/20)
-
-
-
-<a name="1.0.0"></a>
-# [1.0.0](https://github.com/FRSource/frs-replace/compare/v0.1.2...v1.0.0) (2018-11-14)
-
-
-### Features
-
-* **input:** add support for globbing matching ([#14](https://github.com/FRSource/frs-replace/issues/14)) ([b289ffe](https://github.com/FRSource/frs-replace/commit/b289ffe)), closes [#3](https://github.com/FRSource/frs-replace/issues/3)
-* **sync:** Sync speed improvements ([#18](https://github.com/FRSource/frs-replace/issues/18)) ([4ff2a1e](https://github.com/FRSource/frs-replace/commit/4ff2a1e)), closes [#17](https://github.com/FRSource/frs-replace/issues/17)
-
-
-### BREAKING CHANGES
-
-* **input:** api options rename: 'inputOptions' to 'inputReadOptions', 'outputOptions' to 'outputWriteOptions'
-* **input:** cli options rename: 'in-opts' to 'i-read-opts', 'out-opts' to 'o-write-opts'
-Add possibility to set input or output options through cli
-Docs - fixes & new example
-Turn off camel-case-expansion to speed up yargs a bit
-
-
-
-<a name="0.1.2"></a>
-## [0.1.2](https://github.com/FRSource/frs-replace/compare/v0.1.1...v0.1.2) (2018-10-19)
-
-
-
-<a name="0.1.1"></a>
-## [0.1.1](https://github.com/FRSource/frs-replace/compare/v0.1.0...v0.1.1) (2018-10-17)
-
-
-
-<a name="0.1.0"></a>
-# [0.1.0](https://github.com/FRSource/frs-replace/compare/v0.0.6...v0.1.0) (2018-10-17)
-
-
-### Features
-
-* **cli:** Input & output options ([06e8363](https://github.com/FRSource/frs-replace/commit/06e8363)), closes [#7](https://github.com/FRSource/frs-replace/issues/7)
-
-
-
-<a name="0.0.6"></a>
-## [0.0.6](https://github.com/FRSource/frs-replace/compare/v0.0.5...v0.0.6) (2018-10-15)
-
-
-### Bug Fixes
-
-* **docs:** positionals table ([7168474](https://github.com/FRSource/frs-replace/commit/7168474)), closes [#6](https://github.com/FRSource/frs-replace/issues/6)
-
-
-
-<a name="0.0.5"></a>
-## [0.0.5](https://github.com/FRSource/frs-replace/compare/v0.0.4...v0.0.5) (2018-10-15)
-
-
-### Bug Fixes
-
-* **docs:** styling & API usage/examples ([cba85dc](https://github.com/FRSource/frs-replace/commit/cba85dc)), closes [#1](https://github.com/FRSource/frs-replace/issues/1)
-* **node:** expose public node API ([c727dff](https://github.com/FRSource/frs-replace/commit/c727dff)), closes [#5](https://github.com/FRSource/frs-replace/issues/5)
-
-
-
-<a name="0.0.4"></a>
-## [0.0.4](https://github.com/FRSource/frs-replace/compare/v0.0.3...v0.0.4) (2018-10-15)
-
-
-
-<a name="0.0.3"></a>
-## [0.0.3](https://github.com/FRSource/frs-replace/compare/v0.0.2...v0.0.3) (2018-10-15)
-
-
-
-<a name="0.0.2"></a>
-## [0.0.2](https://github.com/FRSource/frs-replace/compare/v0.0.1...v0.0.2) (2018-10-15)
-
-
-### Bug Fixes
-
-* **npm:** lowercase package name to meet npm requirements ([06daa6a](https://github.com/FRSource/frs-replace/commit/06daa6a))
-
-
-
-<a name="0.0.1"></a>
-## 0.0.1 (2018-10-15)

package/async.js

@@ -1 +0,0 @@
-module.exports = require('./src/sync')