feat: support reading from stdin and clean-up implementation

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: passed
  - task: lint_package_json
    status: passed
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: na
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: passed
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: na
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: Planeshifter

.github/workflows/scripts/lint_package_json_files

@@ -52,12 +52,10 @@ if [ -n "${files}" ]; then
 	printf '%s' "${files}" | "${lint_package_json}" --split=" "
 
 	echo "Validating package names..."
-	for file in ${files}; do
-		if ! node "${validate_package_names}" --pattern "${file}"; then
-			echo "ERROR: Package name validation failed"
-			needs_changes=1
-		fi
-	done
+	if ! printf '%s' "${files}" | "${validate_package_names}" --split=" "; then
+		echo "ERROR: Package name validation failed"
+		needs_changes=1
+	fi
 else
 	echo "No package.json files to lint."
 fi

lib/node_modules/@stdlib/_tools/lint/pkg-json-names/README.md

@@ -20,7 +20,7 @@ limitations under the License.
 
 # Lint
 
-> Lint @stdlib package.json names to ensure they match their directory location.
+> Lint package.json names to ensure they match their directory location.
 
 <section class="usage">
 
@@ -32,7 +32,7 @@ var lint = require( '@stdlib/_tools/lint/pkg-json-names' );
 
 #### lint( \[options,] clbk )
 
-Asynchronously lints @stdlib package.json names to ensure that each package name matches its directory location within the stdlib project structure.
+Asynchronously lints package.json names to ensure that each package name matches its directory location within the project structure.
 
 ```javascript
 lint( onLint );
@@ -41,7 +41,7 @@ function onLint( error, errs ) {
     if ( error ) {
         throw error;
     }
-    if ( errs.length ) {
+    if ( errs && errs.length ) {
         console.error( JSON.stringify( errs ) );
     } else {
         console.log( 'No detected errors.' );
@@ -51,22 +51,22 @@ function onLint( error, errs ) {
 
 The function accepts the following `options`:
 
--   **dir**: root directory from which to search for @stdlib package.json files to lint. May be either an absolute file path or a path relative to the `stdlib/lib/node_modules/` directory. Default: `/path/to/stdlib/lib/node_modules/`.
--   **pattern**: glob pattern for finding @stdlib package.json files. Default: `**/@stdlib/**/package.json`.
+-   **dir**: root directory from which to search for packages. May be either an absolute file path or a path relative to the current working directory. Default: current working directory.
+-   **pattern**: glob pattern for finding package.json files. Default: `**/@stdlib/**/package.json`.
 -   **ignore**: glob pattern(s) to exclude.
 
 Each lint error is represented by an `object` having the following fields:
 
--   **file**: @stdlib package.json file path.
--   **expected**: expected @stdlib package name based on directory location.
+-   **file**: package.json file path.
+-   **expected**: expected package name based on directory location.
 -   **actual**: actual package name found in package.json.
 -   **message**: error message describing the mismatch.
 
 To lint starting from a descendant directory, set the `dir` option.
 
 ```javascript
 var opts = {
-    'dir': './@stdlib/math/base'
+    'dir': '/foo/bar/baz'
 };
 
 lint( opts, onLint );
@@ -75,7 +75,7 @@ function onLint( error, errs ) {
     if ( error ) {
         throw error;
     }
-    if ( errs.length ) {
+    if ( errs && errs.length ) {
         console.error( JSON.stringify( errs ) );
     } else {
         console.log( 'No detected errors.' );
@@ -85,11 +85,11 @@ function onLint( error, errs ) {
 
 #### lint.sync( \[options] )
 
-Synchronously lints @stdlib package.json names to ensure that each package name matches its directory location within the stdlib project structure.
+Synchronously lints package.json names to ensure that each package name matches its directory location within the project structure.
 
 ```javascript
 var errs = lint.sync();
-if ( errs.length ) {
+if ( errs && errs.length ) {
     console.error( JSON.stringify( errs ) );
 } else {
     console.log( 'No detected errors.' );
@@ -107,9 +107,8 @@ The function accepts the same `options` as `lint()` above.
 ## Notes
 
 -   The function only lints packages under the `@stdlib` scope.
--   @stdlib package names must start with `@stdlib/` and match their directory location exactly.
+-   Package names must start with `@stdlib/` and match their directory location exactly.
 -   For example, a package located at `lib/node_modules/@stdlib/math/base/special/abs/` must be named `@stdlib/math/base/special/abs`.
--   The tool validates that the package name corresponds to the actual directory structure within the stdlib project.
 
 </section>
 
@@ -125,7 +124,8 @@ The function accepts the same `options` as `lint()` above.
 var lint = require( '@stdlib/_tools/lint/pkg-json-names' );
 
 var opts = {
-    'dir': './'
+    'dir': './',
+    'pattern': '**/@stdlib/utils/**/package.json'
 };
 
 lint( opts, onLint );
@@ -134,7 +134,7 @@ function onLint( error, errors ) {
     if ( error ) {
         throw error;
     }
-    if ( errors.length ) {
+    if ( errors && errors.length ) {
         console.error( JSON.stringify( errors ) );
     } else {
         console.log( 'No detected errors.' );
@@ -157,14 +157,16 @@ function onLint( error, errors ) {
 ### Usage
 
 ```text
-Usage: stdlib-lint-pkg-json-names [options] [<dir>]
+Usage: lint-pkg-json-names [options] [<dir>]
 
 Options:
 
   -h,   --help                Print this message.
   -V,   --version             Print the package version.
         --pattern pattern     Pattern to match files for linting.
         --ignore pattern      Exclusion glob pattern.
+        --split sep           Separator used to split stdin data. Default: /\\r?\\n/.
+        --format fmt          Output format: 'pretty' or 'ndjson'. Default: 'pretty'.
 ```
 
 </section>
@@ -175,7 +177,28 @@ Options:
 
 ### Notes
 
--   If not provided a `dir` argument, the search directory is the current working directory.
+
+-   If part of a [standard stream][standard-stream] pipeline, results are written to `stdout` as newline-delimited JSON ([NDJSON][ndjson]). Otherwise, results are pretty printed by default.
+
+-   If not provided a `dir` argument, the current working directory is the search directory.
+
+-   To provide multiple exclusion glob patterns, set multiple `--ignore` option arguments.
+
+    ```bash
+    $ lint-pkg-json-names --ignore=node_modules/** --ignore=build/** --ignore=reports/**
+    ```
+
+-   If the split separator is a [regular expression][regexp], ensure that the `split` option is properly **escaped**.
+
+    ```bash
+    # Not escaped...
+    $ <stdout> | lint-pkg-json-names --split /\r?\n/
+
+    # Escaped...
+    $ <stdout> | lint-pkg-json-names --split /\\r?\\n/
+    ```
+
+-   If provided a list of filenames via `stdin`, each filename is resolved relative to the current working directory. To specify an alternative directory, provide a `dir` argument.
 
 </section>
 
@@ -186,7 +209,30 @@ Options:
 ### Examples
 
 ```bash
-$ stdlib-lint-pkg-json-names
+$ lint-pkg-json-names
+
+/path/to/lib/node_modules/@stdlib/math/base/special/abs/package.json
+
+    message: Package name "@stdlib/math/base/special/sin" does not match directory structure (expected: "@stdlib/math/base/special/abs")
+    expected: @stdlib/math/base/special/abs
+    actual: @stdlib/math/base/special/sin
+
+1 errors
+```
+
+To output results as newline-delimited JSON ([NDJSON][ndjson]),
+
+```bash
+$ lint-pkg-json-names --format ndjson
+{"file":"/path/to/package.json","message":"Package name \"@stdlib/math/base/special/sin\" does not match directory structure (expected: \"@stdlib/math/base/special/abs\")","expected":"@stdlib/math/base/special/abs","actual":"@stdlib/math/base/special/sin"}
+...
+```
+
+To use as a part of a [standard stream][standard-stream] pipeline,
+
+```bash
+$ echo -n $'lib/node_modules/@stdlib/math/base/special/abs/package.json' | lint-pkg-json-names
+...
 ```
 
 </section>
@@ -209,6 +255,12 @@ $ stdlib-lint-pkg-json-names
 
 <section class="links">
 
+[ndjson]: http://ndjson.org/
+
+[regexp]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions
+
+[standard-stream]: https://en.wikipedia.org/wiki/Pipeline_%28Unix%29
+
 </section>
 
 <!-- /.links -->