v1.0.0

Author: iTonyYo

.gitignore

@@ -0,0 +1,285 @@
+/CVS/*
+**/CVS/*
+.cvsignore
+*/.cvsignore
+
+
+
+*.patch
+*.diff
+
+
+
+*~
+
+# temporary files which can be created if a process still has a handle open of a deleted file
+.fuse_hidden*
+
+# KDE directory preferences
+.directory
+
+# Linux trash folder which might appear on any partition or disk
+.Trash-*
+
+# .nfs files are created when an open file is removed but is still being accessed
+.nfs*
+
+
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+.cache
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+
+
+# Cache files for Sublime Text
+*.tmlanguage.cache
+*.tmPreferences.cache
+*.stTheme.cache
+
+# Workspace files are user-specific
+*.sublime-workspace
+
+# Project files should be checked into the repository, unless a significant
+# proportion of contributors will probably not be using Sublime Text
+# *.sublime-project
+
+# SFTP configuration file
+sftp-config.json
+sftp-config-alt*.json
+
+# Package control specific files
+Package Control.last-run
+Package Control.ca-list
+Package Control.ca-bundle
+Package Control.system-ca-bundle
+Package Control.cache/
+Package Control.ca-certs/
+Package Control.merged-ca-bundle
+Package Control.user-ca-bundle
+oscrypto-ca-bundle.crt
+bh_unicode_properties.cache
+
+# Sublime-github package stores a github token in this file
+# https://packagecontrol.io/packages/sublime-github
+GitHub.sublime-settings
+
+
+
+# Project-level settings
+/.tgitconfig
+
+
+
+# Swap
+[._]*.s[a-v][a-z]
+!*.svg  # comment out if you don't need vector files
+[._]*.sw[a-p]
+[._]s[a-rt-v][a-z]
+[._]ss[a-gi-z]
+[._]sw[a-p]
+
+# Session
+Session.vim
+Sessionx.vim
+
+# Temporary
+.netrwhist
+*~
+# Auto-generated tag files
+tags
+# Persistent undo
+[._]*.un~
+
+
+
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+*.code-workspace
+
+# Local History for Visual Studio Code
+.history/
+
+
+
+# Windows thumbnail cache files
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+
+# Dump file
+*.stackdump
+
+# Folder config file
+[Dd]esktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk
+
+
+
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+© 2021 GitHub, Inc.
+Terms

.npmrc

@@ -0,0 +1,13 @@
+depth=0
+loglevel=notice
+engine-strict=true
+fetch-retries=3
+fetch-retry-mintimeout=5
+save=true
+
+package-lock=true
+
+scope=@iyowei
+@iyowei:registry="https://registry.npmjs.org/"
+
+registry="https://registry.npmmirror.com"

README.md

@@ -0,0 +1,88 @@
+[precinct]: https://github.com/dependents/node-precinct
+
+# jsModuleDependenciesToBeInstalled(specifiers)
+
+> JavaScript 模块（esm, cjs, amd, ts, tsx, jsx）说明符过滤器：需要额外安装的的模块。
+
+依赖（说明符）收集器，见 [Precinct][precinct]。
+
+## 使用
+
+- specifiers {Array} [Precinct][precinct] 收集器收集到的模块说明符集合，默认 **`[]`**；
+- 返回 {Array} 需要额外安装的的模块名称。
+
+```js
+import { readFileSync } from "fs";
+import { log } from "console";
+
+import precinct from "detective-es6";
+import jsModuleDependenciesToBeInstalled from "@iyowei/js-module-dependencies-to-be-installed";
+
+/**
+ * "/Users/iyowei/Development/iyowei/create-esm/cli.js" 片段，
+ *
+ * import { existsSync } from "fs";
+ * import { Listr } from "listr2";
+ * import shell from "shelljs";
+ * import meow from "meow";
+ * import chalk from "chalk";
+ * import { banner, mainHelp, setupHelp, COMMAND_SET, COMMAND_DEFAULTS, getReport } from "./src/messages.js";
+ * import pressAnyKeyToContinue from "./src/pressAnyKeyToContinue.js";
+ * import { updateGlobalConfigurations, getGlobalConfigurations } from "./src/options/global.js";
+ * import makeOptions from "./src/options/make.js";
+ * import prerequisites from "./src/prerequisites.js";
+ */
+const specifiers = precinct(
+  readFileSync("/Users/iyowei/Development/iyowei/create-esm/cli.js", "utf-8")
+);
+
+const read = jsModuleDependenciesToBeInstalled(specifiers);
+console.log("read", read);
+// read: [ 'listr2', 'shelljs', 'meow', 'chalk' ]
+
+const given = jsModuleDependenciesToBeInstalled([
+  "./startup.js",
+  "../config.mjs",
+
+  "file:///opt/nodejs/config.js",
+
+  "/opt/nodejs/config.mjs",
+
+  "fs",
+  "node:fs",
+  "node:fs/promise",
+
+  "some-package",
+
+  "@others/test",
+  "@npmcli/package-json",
+
+  "@npmcli/package-json/promise",
+  "some-package/lib/shuffle.mjs",
+]);
+console.log("given", given);
+// given: given [ 'some-package', '@others/test', '@npmcli/package-json' ]
+```
+
+## 安装
+
+[![Node version](https://img.shields.io/badge/node.js-%3E%3D12.20.0-brightgreen?style=flat&logo=Node.js)](https://nodejs.org/en/download/)
+
+```shell
+# Pnpm
+pnpm add @iyowei/js-module-dependencies-to-be-installed
+
+# yarn
+yarn add @iyowei/js-module-dependencies-to-be-installed
+
+# npm
+npm add @iyowei/js-module-dependencies-to-be-installed
+```
+
+## 设计
+
+ESM, CJS, AMD, TS, TSX, JSX，等等，模块定义很多，对应了不同依赖（说明符）收集器，但说明符规范是一致的，所以将过滤器部分提取出来，方便复用。
+
+## 参与贡献
+
+![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat)