build: update recipes and documentation

---
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: na
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: na
  - 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: kgryte

tools/make/lib/ls/files.mk

@@ -36,12 +36,26 @@ FIND_FILES_CMD ?= find $(find_kernel_prefix) $(ROOT_DIR) $(FIND_FILES_FLAGS)
 FILES ?= $(shell $(FIND_FILES_CMD))
 
 
-# TARGETS #
+# RULES #
 
-# List all files.
+#/
+# Prints a list of files satisfying filter criteria.
 #
-# This target prints a list of all files, excluding the `node_modules`, `build`, `reports`, and hidden directories.
-
+# ## Notes
+#
+# -   This target prints a list of all files, excluding the `node_modules`, `build`, `reports`, and hidden directories.
+#
+# @param {string} [FILES_FILTER] - file path pattern (e.g., `.*/math/base/special/abs/.*`)
+# @param {string} [FILES_PATTERN] - file name pattern (e.g., `*.js`)
+#
+# @example
+# make list-files
+#
+# @example
+# make list-files FILES_FILTER=".*/math/base/special/abs/.*"
+#
+# @example
+# make list-files FILES_FILTER=".*/math/base/special/abs/.*" FILES_PATTERN="*.js"
 list-files:
 	$(QUIET) find $(find_kernel_prefix) $(ROOT_DIR) $(FIND_FILES_FLAGS) $(find_print_list)
 

tools/make/lib/ls/pkgs/lib.mk

@@ -73,10 +73,10 @@ list-lib-pkgs:
 # make list-random-lib-pkgs RANDOM_SELECTION_SIZE=10
 #/
 list-random-lib-pkgs:
-	@if command -v shuf > /dev/null; then \
-		make list-lib-pkgs | shuf -n $(RANDOM_SELECTION_SIZE) ; \
+	$(QUIET) if command -v shuf > /dev/null; then \
+		$(MAKE) list-lib-pkgs | shuf -n $(RANDOM_SELECTION_SIZE) ; \
 	else \
-		make list-lib-pkgs | sort -R | head -n $(RANDOM_SELECTION_SIZE) ; \
+		$(MAKE) list-lib-pkgs | sort -R | head -n $(RANDOM_SELECTION_SIZE) ; \
 	fi
 
 .PHONY: list-random-lib-pkgs