From ea1cf3f1ed2a74ffdaf08d1886729471e6352f4d Mon Sep 17 00:00:00 2001
From: Philipp Burckhardt <pburckhardt@outlook.com>
Date: Mon, 17 Mar 2025 21:51:57 -0400
Subject: [PATCH 1/4] build: add remark plugin to validate expected HTML
 sections

---
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: passed
  - task: lint_javascript_tests
    status: passed
  - 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
---
---
 .../README.md                                 | 176 +++++++++++++++
 .../examples/index.js                         |  83 +++++++
 .../lib/index.js                              |  40 ++++
 .../lib/main.js                               | 192 ++++++++++++++++
 .../package.json                              |  54 +++++
 .../test/fixtures/incomplete_c.md.txt         |  67 ++++++
 .../test/fixtures/invalid_asin.md.txt         | 194 ++++++++++++++++
 .../fixtures/missing_required_root.md.txt     |  35 +++
 .../test/fixtures/valid_asin.md.txt           | 200 +++++++++++++++++
 .../test/fixtures/valid_complete.md.txt       | 130 +++++++++++
 .../test/fixtures/valid_memoize.md.txt        | 212 ++++++++++++++++++
 .../test/test.js                              | 199 ++++++++++++++++
 12 files changed, 1582 insertions(+)
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/README.md
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/examples/index.js
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/index.js
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/main.js
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/package.json
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/incomplete_c.md.txt
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/invalid_asin.md.txt
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/missing_required_root.md.txt
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_asin.md.txt
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_complete.md.txt
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_memoize.md.txt
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/test.js

diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/README.md b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/README.md
new file mode 100644
index 000000000000..6e63d5e92f8f
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/README.md
@@ -0,0 +1,176 @@
+<!--
+
+@license Apache-2.0
+
+Copyright (c) 2025 The Stdlib Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+-->
+
+# remark-lint-expected-html-sections
+
+> [remark][remark] plugin to lint expected HTML sections in README files according to stdlib conventions.
+
+<section class="intro">
+
+This plugin checks for the presence of required HTML sections in README.md files, as defined in stdlib's documentation conventions. It ensures that each README contains the essential sections needed for comprehensive documentation, and that sections with special requirements (such as the C API section) contain their own required subsections.
+
+</section>
+
+<!-- /.intro -->
+
+<section class="usage">
+
+## Usage
+
+```javascript
+var expectedSections = require( '@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections' );
+```
+
+### expectedSections( \[options] )
+
+Validates the presence of expected HTML sections in README files.
+
+```javascript
+var remark = require( 'remark' );
+
+remark().use( expectedSections ).process( '# README', done );
+
+function done( error, file ) {
+    if ( error ) {
+        console.error( error );
+    }
+}
+```
+
+#### options.schema
+
+The plugin can be configured with a custom schema that defines required and optional sections.
+
+```javascript
+var opts = {
+    'schema': {
+        'root': {
+            'required': [ 'usage', 'examples', 'links' ],
+            'optional': [ 'intro', 'notes', 'c', 'references', 'related' ]
+        },
+        'c': {
+            'required': [ 'usage', 'examples' ],
+            'optional': [ 'intro', 'notes' ]
+        }
+    }
+};
+
+remark().use( expectedSections, opts ).process( src, done );
+```
+
+The default schema requires `usage`, `examples`, and `links` at the root level, and if a `c` section exists, it requires `usage` and `examples` subsections.
+
+</section>
+
+<!-- /.usage -->
+
+<section class="notes">
+
+## Notes
+
+-   The plugin detects HTML sections using pattern matching for `<section class="name">` tags.
+-   The plugin builds a hierarchical model of the document structure to validate both root and nested sections.
+-   Missing required sections will generate lint errors with specific details about which sections are missing.
+
+</section>
+
+<!-- /.notes -->
+
+<section class="examples">
+
+## Examples
+
+```javascript
+var remark = require( 'remark' );
+var expectedSections = require( '@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections' );
+
+var lines = [
+    '# Example Package',
+    '',
+    '<section class="intro">',
+    '',
+    '## Introduction',
+    '',
+    'This is an example package.',
+    '',
+    '</section>',
+    '',
+    '<!-- /.intro -->',
+    '',
+    '<section class="examples">',
+    '',
+    '## Examples',
+    '',
+    '```javascript',
+    'var example = require( \'example\' );',
+    'example();',
+    '```',
+    '',
+    '</section>',
+    '',
+    '<!-- /.examples -->',
+    '',
+    '<!-- Missing usage section! -->',
+    '',
+    '<!-- Missing links section! -->'
+];
+
+var source = lines.join( '\n' );
+
+// Define default options:
+var opts = {
+    'schema': {
+        'root': {
+            'required': [ 'usage', 'examples', 'links' ],
+            'optional': [ 'intro', 'notes', 'c', 'references', 'related' ]
+        }
+    }
+};
+
+// Process source with linter:
+remark().use( expectedSections, opts ).process( source, done );
+
+function done( error, file ) {
+    var i;
+    if ( error ) {
+        console.error( error );
+        return;
+    }
+    if ( file.messages.length === 0 ) {
+        console.log( 'No lint errors found.' );
+    } else {
+        for ( i = 0; i < file.messages.length; i++ ) {
+            console.log( '%d. %s', i+1, file.messages[ i ].reason );
+        }
+    }
+}
+```
+
+</section>
+
+<!-- /.examples -->
+
+<section class="links">
+
+[remark]: https://github.com/remarkjs/remark
+
+</section>
+
+<!-- /.links -->
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/examples/index.js b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/examples/index.js
new file mode 100644
index 000000000000..ffb80e1abece
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/examples/index.js
@@ -0,0 +1,83 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+var remark = require( 'remark' );
+var expectedSections = require( './../lib' );
+
+var lines = [
+	'# Example Package',
+	'',
+	'<section class="intro">',
+	'',
+	'## Introduction',
+	'',
+	'This is an example package.',
+	'',
+	'</section>',
+	'',
+	'<!-- /.intro -->',
+	'',
+	'<section class="examples">',
+	'',
+	'## Examples',
+	'',
+	'```javascript',
+	'var example = require( \'example\' );',
+	'example();',
+	'```',
+	'',
+	'</section>',
+	'',
+	'<!-- /.examples -->',
+	'',
+	'<!-- Missing usage section! -->',
+	'',
+	'<!-- Missing links section! -->'
+];
+
+var source = lines.join( '\n' );
+
+// Define default options:
+var opts = {
+	'schema': {
+		'root': {
+			'required': [ 'usage', 'examples', 'links' ],
+			'optional': [ 'intro', 'notes', 'c', 'references', 'related' ]
+		}
+	}
+};
+
+// Process source with linter:
+remark().use( expectedSections, opts ).process( source, done );
+
+function done( error, file ) {
+	var i;
+	if ( error ) {
+		console.error( error );
+		return;
+	}
+	if ( file.messages.length === 0 ) {
+		console.log( 'No lint errors found.' );
+	} else {
+		for ( i = 0; i < file.messages.length; i++ ) {
+			console.log( '%d. %s', i+1, file.messages[ i ].reason );
+		}
+	}
+}
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/index.js b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/index.js
new file mode 100644
index 000000000000..54942d814094
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/index.js
@@ -0,0 +1,40 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2022 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+/**
+* remark lint plugin for validating HTML section hierarchy in README files.
+*
+* @module @stdlib/_tools/remark/plugins/remark-lint-expected-html-sections
+*
+* @example
+* var remark = require( 'remark' );
+* var expectedHtmlSections = require( '@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections' );
+*
+* var linter = remark().use( expectedHtmlSections );
+*/
+
+// MODULES //
+
+var main = require( './main.js' );
+
+
+// EXPORTS //
+
+module.exports = main;
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/main.js b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/main.js
new file mode 100644
index 000000000000..93943e9a0eee
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/main.js
@@ -0,0 +1,192 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var logger = require( 'debug' );
+var rule = require( 'unified-lint-rule' );
+var visit = require( 'unist-util-visit' );
+var keys = require( '@stdlib/utils/keys' );
+
+
+// VARIABLES //
+
+var debug = logger( 'remark-lint-expected-html-sections' );
+var SECTION_START = /<section(?:\s+class="([^"]*)")?>/;
+var DEFAULT_SCHEMA = {
+	'root': {
+		'required': [ 'usage', 'examples', 'links' ],
+		'optional': [ 'intro', 'notes', 'c', 'references', 'related' ]
+	},
+	'c': {
+		'required': [ 'usage', 'examples' ],
+		'optional': [ 'intro', 'notes' ]
+	}
+};
+var expectedHtmlSectionsRule;
+
+
+// MAIN //
+
+/**
+* Validates HTML section hierarchy in README files according to stdlib conventions.
+*
+* @private
+* @param {Node} tree - abstract syntax tree (AST)
+* @param {File} file - virtual file
+* @param {Object} options - options
+* @param {Object} [options.schema] - section schema defining required and optional sections
+* @param {Callback} clbk - callback to invoke upon completion
+* @returns {void}
+*/
+function linter( tree, file, options, clbk ) {
+	var requiredRootSections;
+	var requiredCSections;
+	var sectionStructure;
+	var currentSection;
+	var sectionsFound;
+	var sectionStack;
+	var sectionMatch;
+	var missingRoot;
+	var className;
+	var missingC;
+	var schema;
+	var msg;
+	var i;
+
+	debug( 'Linting file: %s', file.path || '' );
+
+	// Use provided schema or default schema:
+	schema = options.schema || DEFAULT_SCHEMA;
+
+	// Initialize section tracking:
+	sectionStack = [];
+	sectionStructure = [];
+
+	// Keep track of sections at different levels:
+	sectionsFound = {
+		'root': {},
+		'c': {}
+	};
+
+	// Visit all HTML nodes to build section structure:
+	visit( tree, 'html', visitor );
+
+	// Log all sections found for debugging:
+	debug( 'Root sections found: %j', keys( sectionsFound.root ) );
+	if ( sectionsFound.root.c ) {
+		debug( 'C sections found: %j', keys( sectionsFound.c ) );
+	}
+
+	// After visiting all nodes, validate against schema:
+	requiredRootSections = schema.root.required || [];
+
+	// Check for missing required root sections:
+	missingRoot = [];
+	for ( i = 0; i < requiredRootSections.length; i++ ) {
+		if ( !sectionsFound.root[ requiredRootSections[ i ] ] ) {
+			missingRoot.push( requiredRootSections[ i ] );
+		}
+	}
+
+	if ( missingRoot.length > 0 ) {
+		msg = 'Missing required root-level sections: ' + missingRoot.join( ', ' ) + '. Required sections are: ' + requiredRootSections.join(', ') + '.   missing-required-sections';
+		debug( msg );
+		file.message( msg, tree );
+	}
+
+	// If 'c' section exists, check its requirements:
+	if ( sectionsFound.root.c ) {
+		requiredCSections = (schema.c) ? (schema.c.required || []) : [];
+
+		// Check for missing required C sections:
+		missingC = [];
+		for ( i = 0; i < requiredCSections.length; i++ ) {
+			if ( !sectionsFound.c[ requiredCSections[ i ] ] ) {
+				missingC.push( requiredCSections[ i ] );
+			}
+		}
+
+		if ( missingC.length > 0 ) {
+			msg = 'Missing required sections in "c" section: ' + missingC.join(', ') + '. Required C sections are: ' + requiredCSections.join(', ') + '.   missing-required-c-sections';
+			debug( msg );
+			file.message( msg, sectionsFound.root.c.node );
+		}
+	}
+
+	debug( 'Finished linting: %s', file.path || '' );
+	return clbk();
+
+	/**
+	* Callback invoked upon finding a matching node.
+	*
+	* @private
+	* @param {Object} node - AST node
+	* @returns {void}
+	*/
+	function visitor( node ) {
+		// Check if this is a section start tag:
+		sectionMatch = SECTION_START.exec( node.value );
+		if ( sectionMatch ) {
+			className = sectionMatch[1] || '';
+
+			debug( 'Found section with class: %s', className );
+
+			// Create section data object:
+			currentSection = {
+				'node': node,
+				'name': className,
+				'children': [],
+				'parent': null
+			};
+
+			// Add to parent if there is one:
+			if ( sectionStack.length > 0 ) {
+				currentSection.parent = sectionStack[ sectionStack.length - 1 ];
+				currentSection.parent.children.push( currentSection );
+
+				// Record C-level section:
+				if ( currentSection.parent.name === 'c' ) {
+					sectionsFound.c[ className ] = currentSection;
+				}
+			} else {
+				// This is a root section:
+				sectionStructure.push( currentSection );
+				sectionsFound.root[ className ] = currentSection;
+			}
+
+			// Push to stack:
+			sectionStack.push( currentSection );
+		}
+		// Check if this is a section end tag:
+		else if ( /<\/section>/.test( node.value ) ) {
+			if ( sectionStack.length > 0 ) {
+				sectionStack.pop();
+			}
+		}
+	}
+}
+
+expectedHtmlSectionsRule = rule( 'remark-lint:expected-html-sections', linter );
+
+
+// EXPORTS //
+
+module.exports = expectedHtmlSectionsRule;
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/package.json b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/package.json
new file mode 100644
index 000000000000..bac6cb9faa50
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/package.json
@@ -0,0 +1,54 @@
+{
+  "name": "@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections",
+  "version": "0.0.0",
+  "description": "remark lint plugin for validating expected HTML sections in README files according to stdlib conventions.",
+  "license": "Apache-2.0",
+  "author": {
+    "name": "The Stdlib Authors",
+    "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+  },
+  "contributors": [
+    {
+      "name": "The Stdlib Authors",
+      "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+    }
+  ],
+  "main": "./lib",
+  "directories": {
+    "example": "./examples",
+    "lib": "./lib",
+    "test": "./test"
+  },
+  "scripts": {},
+  "homepage": "https://github.com/stdlib-js/stdlib",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/stdlib-js/stdlib.git"
+  },
+  "bugs": {
+    "url": "https://github.com/stdlib-js/stdlib/issues"
+  },
+  "dependencies": {},
+  "devDependencies": {},
+  "engines": {
+    "node": ">=6.0.0",
+    "npm": ">2.7.0"
+  },
+  "keywords": [
+    "stdlib",
+    "tools",
+    "lint",
+    "linter",
+    "markdown",
+    "md",
+    "remark",
+    "remark-plugin",
+    "plugin",
+    "html",
+    "section",
+    "structure",
+    "hierarchy",
+    "expected",
+    "validate"
+  ]
+}
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/incomplete_c.md.txt b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/incomplete_c.md.txt
new file mode 100644
index 000000000000..e3e0e13299fe
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/incomplete_c.md.txt
@@ -0,0 +1,67 @@
+# Example
+
+<section class="intro">
+
+## Introduction
+
+This is an introduction.
+
+</section>
+
+<!-- /.intro -->
+
+<section class="usage">
+
+## Usage
+
+```javascript
+var foo = require( 'foo' );
+```
+
+</section>
+
+<!-- /.usage -->
+
+<section class="examples">
+
+## Examples
+
+```javascript
+var foo = require( 'foo' );
+foo();
+```
+
+</section>
+
+<!-- /.examples -->
+
+<section class="c">
+
+## C APIs
+
+<section class="intro">
+
+### Introduction
+
+This section contains C API documentation.
+
+</section>
+
+<!-- /.intro -->
+
+<!-- Missing usage section inside C! -->
+
+<!-- Missing examples section inside C! -->
+
+</section>
+
+<!-- /.c -->
+
+<section class="links">
+
+[npm-image]: https://img.shields.io/npm/v/example.svg
+[npm-url]: https://npmjs.org/package/example
+
+</section>
+
+<!-- /.links -->
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/invalid_asin.md.txt b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/invalid_asin.md.txt
new file mode 100644
index 000000000000..5f5f6ea628c9
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/invalid_asin.md.txt
@@ -0,0 +1,194 @@
+<!--
+
+@license Apache-2.0
+
+Copyright (c) 2022 The Stdlib Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+-->
+
+# asin
+
+> Compute the [arcsine][arcsine] of a double-precision floating-point number.
+
+<section class="usage">
+
+## Usage
+
+```javascript
+var asin = require( '@stdlib/math/base/special/asin' );
+```
+
+#### asin( x )
+
+Computes the [arcsine][arcsine] of a double-precision floating-point number (in radians).
+
+```javascript
+var v = asin( 0.0 );
+// returns 0.0
+
+v = asin( -3.141592653589793/6.0 );
+// returns ~-0.551
+```
+
+The domain of `x` is restricted to `[-1,1]`. If `|x| > 1`, the function returns `NaN`.
+
+```javascript
+var v = asin( -3.14 );
+// returns NaN
+```
+
+</section>
+
+<!-- /.usage -->
+
+<section class="examples">
+
+## Examples
+
+<!-- eslint no-undef: "error" -->
+
+```javascript
+var linspace = require( '@stdlib/array/base/linspace' );
+var asin = require( '@stdlib/math/base/special/asin' );
+
+var x = linspace( -1.0, 1.0, 100 );
+
+var i;
+for ( i = 0; i < x.length; i++ ) {
+    console.log( asin( x[ i ] ) );
+}
+```
+
+</section>
+
+<!-- /.examples -->
+
+<!-- C interface documentation. -->
+
+* * *
+
+<section class="c">
+
+## C APIs
+
+<!-- Section to include introductory text. Make sure to keep an empty line after the intro `section` element and another before the `/section` close. -->
+
+<section class="intro">
+
+</section>
+
+<!-- /.intro -->
+
+<!-- C usage documentation. -->
+
+### Usage
+
+```c
+#include "stdlib/math/base/special/asin.h"
+```
+
+#### stdlib_base_asin( x )
+
+Computes the [arcsine][arcsine] of a double-precision floating-point number (in radians).
+
+```c
+double out = stdlib_base_asin( 0.0 );
+// returns 0.0
+
+out = stdlib_base_asin( -3.141592653589793/6.0 );
+// returns ~-0.551
+```
+
+The function accepts the following arguments:
+
+-   **x**: `[in] double` input value (in radians).
+
+```c
+double stdlib_base_asin( const double x );
+```
+
+<!-- C API usage notes. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="notes">
+
+</section>
+
+<!-- /.notes -->
+
+<!-- C API usage examples. -->
+
+<section class="examples">
+
+### Examples
+
+```c
+#include "stdlib/math/base/special/asin.h"
+#include <stdio.h>
+
+int main( void ) {
+    const double x[] = { -1.0, -0.78, -0.56, -0.33, -0.11, 0.11, 0.33, 0.56, 0.78, 1.0 };
+
+    double v;
+    int i;
+    for ( i = 0; i < 10; i++ ) {
+        v = stdlib_base_asin( x[ i ] );
+        printf( "asin(%lf) = %lf\n", x[ i ], v );
+    }
+}
+```
+
+</section>
+
+<!-- /.examples -->
+
+</section>
+
+<!-- /.c -->
+
+<!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
+
+<section class="related">
+
+* * *
+
+## See Also
+
+-   <span class="package-name">[`@stdlib/math/base/special/acos`][@stdlib/math/base/special/acos]</span><span class="delimiter">: </span><span class="description">compute the arccosine of a double-precision floating-point number.</span>
+-   <span class="package-name">[`@stdlib/math/base/special/asinh`][@stdlib/math/base/special/asinh]</span><span class="delimiter">: </span><span class="description">compute the hyperbolic arcsine of a double-precision floating-point number.</span>
+-   <span class="package-name">[`@stdlib/math/base/special/atan`][@stdlib/math/base/special/atan]</span><span class="delimiter">: </span><span class="description">compute the arctangent of a double-precision floating-point number.</span>
+
+</section>
+
+<!-- /.related -->
+
+<!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="links">
+
+[arcsine]: https://en.wikipedia.org/wiki/Inverse_trigonometric_functions
+
+<!-- <related-links> -->
+
+[@stdlib/math/base/special/acos]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/acos
+
+[@stdlib/math/base/special/asinh]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/asinh
+
+[@stdlib/math/base/special/atan]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/atan
+
+<!-- </related-links> -->
+
+</section>
+
+<!-- /.links -->
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/missing_required_root.md.txt b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/missing_required_root.md.txt
new file mode 100644
index 000000000000..ad1d31c5a8a6
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/missing_required_root.md.txt
@@ -0,0 +1,35 @@
+# Example
+
+<section class="intro">
+
+## Introduction
+
+This is an introduction.
+
+</section>
+
+<!-- /.intro -->
+
+<!-- Missing usage section! -->
+
+<section class="examples">
+
+## Examples
+
+```javascript
+var foo = require( 'foo' );
+foo();
+```
+
+</section>
+
+<!-- /.examples -->
+
+<section class="links">
+
+[npm-image]: https://img.shields.io/npm/v/example.svg
+[npm-url]: https://npmjs.org/package/example
+
+</section>
+
+<!-- /.links -->
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_asin.md.txt b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_asin.md.txt
new file mode 100644
index 000000000000..357094ff23af
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_asin.md.txt
@@ -0,0 +1,200 @@
+<!--
+
+@license Apache-2.0
+
+Copyright (c) 2022 The Stdlib Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+-->
+
+# asin
+
+> Compute the [arcsine][arcsine] of a double-precision floating-point number.
+
+<section class="usage">
+
+## Usage
+
+```javascript
+var asin = require( '@stdlib/math/base/special/asin' );
+```
+
+#### asin( x )
+
+Computes the [arcsine][arcsine] of a double-precision floating-point number (in radians).
+
+```javascript
+var v = asin( 0.0 );
+// returns 0.0
+
+v = asin( -3.141592653589793/6.0 );
+// returns ~-0.551
+```
+
+The domain of `x` is restricted to `[-1,1]`. If `|x| > 1`, the function returns `NaN`.
+
+```javascript
+var v = asin( -3.14 );
+// returns NaN
+```
+
+</section>
+
+<!-- /.usage -->
+
+<section class="examples">
+
+## Examples
+
+<!-- eslint no-undef: "error" -->
+
+```javascript
+var linspace = require( '@stdlib/array/base/linspace' );
+var asin = require( '@stdlib/math/base/special/asin' );
+
+var x = linspace( -1.0, 1.0, 100 );
+
+var i;
+for ( i = 0; i < x.length; i++ ) {
+    console.log( asin( x[ i ] ) );
+}
+```
+
+</section>
+
+<!-- /.examples -->
+
+<!-- C interface documentation. -->
+
+* * *
+
+<section class="c">
+
+## C APIs
+
+<!-- Section to include introductory text. Make sure to keep an empty line after the intro `section` element and another before the `/section` close. -->
+
+<section class="intro">
+
+</section>
+
+<!-- /.intro -->
+
+<!-- C usage documentation. -->
+
+<section class="usage">
+
+### Usage
+
+```c
+#include "stdlib/math/base/special/asin.h"
+```
+
+#### stdlib_base_asin( x )
+
+Computes the [arcsine][arcsine] of a double-precision floating-point number (in radians).
+
+```c
+double out = stdlib_base_asin( 0.0 );
+// returns 0.0
+
+out = stdlib_base_asin( -3.141592653589793/6.0 );
+// returns ~-0.551
+```
+
+The function accepts the following arguments:
+
+-   **x**: `[in] double` input value (in radians).
+
+```c
+double stdlib_base_asin( const double x );
+```
+
+</section>
+
+<!-- /.usage -->
+
+<!-- C API usage notes. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="notes">
+
+</section>
+
+<!-- /.notes -->
+
+<!-- C API usage examples. -->
+
+<section class="examples">
+
+### Examples
+
+```c
+#include "stdlib/math/base/special/asin.h"
+#include <stdio.h>
+
+int main( void ) {
+    const double x[] = { -1.0, -0.78, -0.56, -0.33, -0.11, 0.11, 0.33, 0.56, 0.78, 1.0 };
+
+    double v;
+    int i;
+    for ( i = 0; i < 10; i++ ) {
+        v = stdlib_base_asin( x[ i ] );
+        printf( "asin(%lf) = %lf\n", x[ i ], v );
+    }
+}
+```
+
+</section>
+
+<!-- /.examples -->
+
+</section>
+
+<!-- /.c -->
+
+<!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
+
+<section class="related">
+
+* * *
+
+## See Also
+
+-   <span class="package-name">[`@stdlib/math/base/special/acos`][@stdlib/math/base/special/acos]</span><span class="delimiter">: </span><span class="description">compute the arccosine of a double-precision floating-point number.</span>
+-   <span class="package-name">[`@stdlib/math/base/special/asinh`][@stdlib/math/base/special/asinh]</span><span class="delimiter">: </span><span class="description">compute the hyperbolic arcsine of a double-precision floating-point number.</span>
+-   <span class="package-name">[`@stdlib/math/base/special/atan`][@stdlib/math/base/special/atan]</span><span class="delimiter">: </span><span class="description">compute the arctangent of a double-precision floating-point number.</span>
+
+</section>
+
+<!-- /.related -->
+
+<!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="links">
+
+[arcsine]: https://en.wikipedia.org/wiki/Inverse_trigonometric_functions
+
+<!-- <related-links> -->
+
+[@stdlib/math/base/special/acos]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/acos
+
+[@stdlib/math/base/special/asinh]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/asinh
+
+[@stdlib/math/base/special/atan]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/atan
+
+<!-- </related-links> -->
+
+</section>
+
+<!-- /.links -->
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_complete.md.txt b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_complete.md.txt
new file mode 100644
index 000000000000..06301206be7a
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_complete.md.txt
@@ -0,0 +1,130 @@
+# Example
+
+<section class="intro">
+
+## Introduction
+
+This is an introduction.
+
+</section>
+
+<!-- /.intro -->
+
+<section class="usage">
+
+## Usage
+
+```javascript
+var foo = require( 'foo' );
+```
+
+</section>
+
+<!-- /.usage -->
+
+<section class="notes">
+
+## Notes
+
+Some notes here.
+
+</section>
+
+<!-- /.notes -->
+
+<section class="examples">
+
+## Examples
+
+```javascript
+var foo = require( 'foo' );
+foo();
+```
+
+</section>
+
+<!-- /.examples -->
+
+<section class="c">
+
+## C APIs
+
+<section class="intro">
+
+### Introduction
+
+This section contains C API documentation.
+
+</section>
+
+<!-- /.intro -->
+
+<section class="usage">
+
+### Usage
+
+```c
+#include "foo.h"
+```
+
+</section>
+
+<!-- /.usage -->
+
+<section class="notes">
+
+### Notes
+
+Some implementation notes...
+
+</section>
+
+<!-- /.notes -->
+
+<section class="examples">
+
+### Examples
+
+```c
+// C example
+#include "foo.h"
+```
+
+</section>
+
+<!-- /.examples -->
+
+</section>
+
+<!-- /.c -->
+
+<section class="references">
+
+## References
+
+* Reference 1
+* Reference 2
+
+</section>
+
+<!-- /.references -->
+
+<section class="related">
+
+## Related
+
+* Related package 1
+* Related package 2
+
+</section>
+
+<!-- /.related -->
+
+<section class="links">
+
+[npm-image]: https://img.shields.io/npm/v/example.svg
+[npm-url]: https://npmjs.org/package/example
+
+</section>
+
+<!-- /.links -->
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_memoize.md.txt b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_memoize.md.txt
new file mode 100644
index 000000000000..6cf2726f3838
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_memoize.md.txt
@@ -0,0 +1,212 @@
+<!--
+
+@license Apache-2.0
+
+Copyright (c) 2018 The Stdlib Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+-->
+
+# memoize
+
+> Memoize a function.
+
+<!-- Section to include introductory text. Make sure to keep an empty line after the intro `section` element and another before the `/section` close. -->
+
+<section class="intro">
+
+</section>
+
+<!-- /.intro -->
+
+<!-- Package usage documentation. -->
+
+<section class="usage">
+
+## Usage
+
+```javascript
+var memoize = require( '@stdlib/utils/memoize' );
+```
+
+#### memoize( fcn\[, hashFunction] )
+
+Memoizes a function.
+
+```javascript
+var randu = require( '@stdlib/random/base/randu' );
+
+function rand( n ) {
+    return n * randu();
+}
+
+var memoized = memoize( rand );
+
+var v1 = memoized( 5 );
+var v2 = memoized( 5 );
+
+var bool = ( v1 === v2 );
+// returns true
+```
+
+By default, the implementation serializes provided arguments as a `string` and stores results using the `string` as an identifier. To use a custom hash function, provide a hash function argument.
+
+```javascript
+function add( obj ) {
+    return obj.x + obj.y + obj.z;
+}
+
+obj = {
+    'x': 3,
+    'y': 4,
+    'z': 5
+};
+
+// Default behavior...
+
+var memoized = memoize( add );
+
+var v1 = memoized( obj );
+// returns 12
+
+var str = obj.toString();
+// returns '[object Object]'
+
+var v2 = memoized.cache[ str ];
+// returns 12
+
+obj.x = 1000;
+
+var v3 = memoized( obj );
+// returns 12
+
+// Custom hash function...
+
+function hashFunction( args ) {
+    return JSON.stringify( args );
+}
+
+memoized = memoize( add, hashFunction );
+
+v1 = memoized( obj );
+// returns 1009
+
+str = hashFunction( [ obj ] );
+// returns '[{"x":1000,"y":4,"z":5}]'
+
+v2 = memoized.cache[ str ];
+// returns 1009
+
+obj.x = 6;
+
+v3 = memoized( obj );
+// returns 15
+```
+
+#### memoized.cache
+
+Results cache. Note that, while the property is **read-only**, cache contents may be modified independently of the memoized function.
+
+```javascript
+function beep( x ) {
+    throw new Error( 'boop' );
+}
+
+var memoized = memoize( beep );
+
+var cache = memoized.cache;
+// returns {}
+
+// Modify the cache:
+cache[ 'bop' ] = 'bip';
+
+var str = memoized( 'bop' );
+// returns 'bip'
+```
+
+</section>
+
+<!-- /.usage -->
+
+<!-- Package usage notes. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="notes">
+
+## Notes
+
+-   The implementation does **not** set the `length` of the returned function. Accordingly, the returned function `length` is **always** `0`.
+-   The evaluation context is **always** `null`.
+
+</section>
+
+<!-- /.notes -->
+
+<!-- Package usage examples. -->
+
+<section class="examples">
+
+## Examples
+
+<!-- eslint no-undef: "error" -->
+
+```javascript
+var randu = require( '@stdlib/random/base/randu' );
+var floor = require( '@stdlib/math/base/special/floor' );
+var memoize = require( '@stdlib/utils/memoize' );
+
+var fcn;
+var n;
+var v;
+var i;
+
+function rand( n ) {
+    return n * randu();
+}
+
+fcn = memoize( rand );
+
+for ( i = 0; i < 100; i++ ) {
+    n = floor( randu() * 5 );
+    v = fcn( n );
+    console.log( 'rand(%d) = %d', n, v );
+}
+```
+
+</section>
+
+<!-- /.examples -->
+
+<!-- Section to include cited references. If references are included, add a horizontal rule *before* the section. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="references">
+
+</section>
+
+<!-- /.references -->
+
+<!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
+
+<section class="related">
+
+</section>
+
+<!-- /.related -->
+
+<!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="links">
+
+</section>
+
+<!-- /.links -->
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/test.js b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/test.js
new file mode 100644
index 000000000000..5c8733d5fd3f
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/test.js
@@ -0,0 +1,199 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var path = require( 'path' );
+var tape = require( 'tape' );
+var remark = require( 'remark' );
+var readFileSync = require( '@stdlib/fs/read-file' ).sync;
+var expectedSections = require( './../lib' );
+
+
+// VARIABLES //
+
+var TEST_FIXTURES = path.join( __dirname, 'fixtures' );
+var DEFAULT_SCHEMA = {
+	'root': {
+		'required': [ 'usage', 'examples', 'links' ],
+		'optional': [ 'intro', 'notes', 'c', 'references', 'related' ]
+	},
+	'c': {
+		'required': [ 'usage', 'examples' ],
+		'optional': [ 'intro', 'notes' ]
+	}
+};
+var CUSTOM_SCHEMA = {
+	'root': {
+		'required': [ 'usage', 'examples', 'links', 'related' ],
+		'optional': [ 'intro', 'notes', 'c', 'references' ]
+	}
+};
+
+
+// FUNCTIONS //
+
+function fixture( name ) {
+	var text = readFileSync( path.join( TEST_FIXTURES, name ), 'utf8' );
+	return text.toString();
+}
+
+function lint( text, options, clbk ) {
+	remark().use( expectedSections, options ).process( text, clbk );
+}
+
+
+// TESTS //
+
+tape( 'main export is a function', function test( t ) {
+	t.ok( true, __filename );
+	t.strictEqual( typeof expectedSections, 'function', 'main export is a function' );
+	t.end();
+});
+
+tape( 'validates valid_complete.md.txt with default schema', function test( t ) {
+	var opts = {
+		'schema': DEFAULT_SCHEMA
+	};
+
+	lint( fixture( 'valid_complete.md.txt' ), opts, done );
+
+	function done( err, file ) {
+		if ( err ) {
+			t.fail( err.message );
+		}
+		t.strictEqual( file.messages.length, 0, 'has no errors for valid fixture with all sections' );
+		t.end();
+	}
+});
+
+tape( 'validates valid_memoize.md.txt', function test( t ) {
+	var opts = {
+		'schema': DEFAULT_SCHEMA
+	};
+
+	lint( fixture( 'valid_memoize.md.txt' ), opts, done );
+
+	function done( err, file ) {
+		if ( err ) {
+			t.fail( err.message );
+		}
+		t.strictEqual( file.messages.length, 0, 'has no errors for memoize README fixture' );
+		t.end();
+	}
+});
+
+tape( 'validates valid_asin.md.txt with C section', function test( t ) {
+	var opts = {
+		'schema': DEFAULT_SCHEMA
+	};
+
+	lint( fixture( 'valid_asin.md.txt' ), opts, done );
+
+	function done( err, file ) {
+		if ( err ) {
+			t.fail( err.message );
+		}
+		t.strictEqual( file.messages.length, 0, 'has no errors for asin README fixture with C section' );
+		t.end();
+	}
+});
+
+tape( 'detects missing C usage section in invalid_asin.md.txt', function test( t ) {
+	var opts = {
+		'schema': DEFAULT_SCHEMA
+	};
+
+	lint( fixture( 'invalid_asin.md.txt' ), opts, done );
+
+	function done( err, file ) {
+		if ( err ) {
+			t.fail( err.message );
+		}
+		t.strictEqual( file.messages.length, 1, 'has one error for invalid asin fixture' );
+		t.strictEqual( file.messages[0].reason.includes('Missing required sections in "c" section: usage'), true, 'error identifies the missing C usage section' );
+		t.end();
+	}
+});
+
+tape( 'reports error for missing required root sections', function test( t ) {
+	var opts = {
+		'schema': DEFAULT_SCHEMA
+	};
+
+	lint( fixture( 'missing_required_root.md.txt' ), opts, function done( err, file ) {
+		if ( err ) {
+			t.fail( err.message );
+		}
+		t.strictEqual( file.messages.length, 1, 'has one error for fixture missing a required root section' );
+		t.strictEqual( file.messages[0].reason.includes('Missing required root-level sections: usage'), true, 'error identifies the missing section' );
+		t.end();
+	});
+});
+
+tape( 'reports error for incomplete C section', function test( t ) {
+	var opts = {
+		'schema': DEFAULT_SCHEMA
+	};
+
+	lint( fixture( 'incomplete_c.md.txt' ), opts, done );
+
+	function done( err, file ) {
+		if ( err ) {
+			t.fail( err.message );
+		}
+		t.strictEqual( file.messages.length, 1, 'has one error for fixture with an incomplete C section' );
+		t.strictEqual( file.messages[0].reason.includes('Missing required sections in "c" section: usage, examples'), true, 'error identifies the missing C sections' );
+		t.end();
+	}
+});
+
+tape( 'validates valid_complete.md.txt with custom schema', function test( t ) {
+	var opts = {
+		'schema': CUSTOM_SCHEMA
+	};
+
+	lint( fixture( 'valid_complete.md.txt' ), opts, done );
+
+	function done( err, file ) {
+		if ( err ) {
+			t.fail( err.message );
+		}
+		t.strictEqual( file.messages.length, 0, 'has no errors for valid fixture with custom schema' );
+		t.end();
+	}
+});
+
+tape( 'reports correct errors with custom schema', function test( t ) {
+	var opts = {
+		'schema': CUSTOM_SCHEMA
+	};
+
+	lint( fixture( 'missing_required_root.md.txt' ), opts, done );
+
+	function done( err, file ) {
+		if ( err ) {
+			t.fail( err.message );
+		}
+		t.strictEqual( file.messages.length, 1, 'has correct number of errors with custom schema' );
+		t.strictEqual( file.messages[0].reason.includes('usage') && file.messages[0].reason.includes('related'), true, 'error identifies both missing sections' );
+		t.end();
+	}
+});

From f913da89906606e2831dd29be96d65a74eb65521 Mon Sep 17 00:00:00 2001
From: Philipp Burckhardt <pburckhardt@outlook.com>
Date: Tue, 18 Mar 2025 08:52:11 -0400
Subject: [PATCH 2/4] docs: add missing require to example code

---
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: 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
---
---
 .../remark/plugins/remark-lint-expected-html-sections/README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/README.md b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/README.md
index 6e63d5e92f8f..3c5903f745e6 100644
--- a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/README.md
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/README.md
@@ -59,6 +59,8 @@ function done( error, file ) {
 The plugin can be configured with a custom schema that defines required and optional sections.
 
 ```javascript
+var remark = require( 'remark' );
+
 var opts = {
     'schema': {
         'root': {

From 859d6086b0f4d59b88fbfa7fa622aae7c6728956 Mon Sep 17 00:00:00 2001
From: Philipp Burckhardt <pburckhardt@outlook.com>
Date: Tue, 18 Mar 2025 09:25:48 -0400
Subject: [PATCH 3/4] build: add options validation

---
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: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: passed
  - 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
---
---
 .../README.md                                 |  34 ++--
 .../lib/attacher.js                           |  90 ++++++++
 .../lib/defaults.json                         |  28 +++
 .../lib/index.js                              |   6 +-
 .../lib/linter.js                             | 184 +++++++++++++++++
 .../lib/main.js                               | 192 ------------------
 .../lib/validate.js                           |  70 +++++++
 .../test/test.js                              |  78 ++-----
 .../test/test.validate.js                     | 125 ++++++++++++
 9 files changed, 541 insertions(+), 266 deletions(-)
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/attacher.js
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/defaults.json
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/linter.js
 delete mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/main.js
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/validate.js
 create mode 100644 lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/test.validate.js

diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/README.md b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/README.md
index 3c5903f745e6..6299fa2d4901 100644
--- a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/README.md
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/README.md
@@ -54,31 +54,35 @@ function done( error, file ) {
 }
 ```
 
-#### options.schema
+The plugin accepts the following `options`:
 
-The plugin can be configured with a custom schema that defines required and optional sections.
+-   **schema**: schema for expected HTML sections.
+
+The default schema requires `usage`, `examples`, and `links` at the root level, and if a `c` section exists, it requires `usage` and `examples` subsections.
+
+To specify a custom schema, set the `schema` option.
 
 ```javascript
 var remark = require( 'remark' );
 
-var opts = {
-    'schema': {
-        'root': {
-            'required': [ 'usage', 'examples', 'links' ],
-            'optional': [ 'intro', 'notes', 'c', 'references', 'related' ]
-        },
-        'c': {
-            'required': [ 'usage', 'examples' ],
-            'optional': [ 'intro', 'notes' ]
-        }
+var customSchema = {
+    'root': {
+        'required': [ 'usage', 'examples', 'links', 'related' ],
+        'optional': [ 'intro', 'notes', 'c', 'references' ]
     }
 };
+var opts = {
+    'schema': customSchema
+};
+remark().use( expectedSections, opts ).process( '# README', done );
 
-remark().use( expectedSections, opts ).process( src, done );
+function done( error, file ) {
+    if ( error ) {
+        console.error( error );
+    }
+}
 ```
 
-The default schema requires `usage`, `examples`, and `links` at the root level, and if a `c` section exists, it requires `usage` and `examples` subsections.
-
 </section>
 
 <!-- /.usage -->
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/attacher.js b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/attacher.js
new file mode 100644
index 000000000000..0c37b96f3f45
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/attacher.js
@@ -0,0 +1,90 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var copy = require( '@stdlib/utils/copy' );
+var defaults = require( './defaults.json' );
+var validate = require( './validate.js' );
+var linter = require( './linter.js' );
+
+
+// MAIN //
+
+/**
+* Attaches a plugin to a remark processor to lint expected HTML sections.
+*
+* @param {Options} [options] - plugin options
+* @param {Object} [options.schema] - schema for expected HTML sections
+* @throws {TypeError} options argument must be an object
+* @throws {TypeError} must provide valid options
+* @returns {Function} transform function
+*
+* @example
+* var remark = require( 'remark' );
+*
+* var str = [
+*     '<section class="usage">',
+*     '',
+*     '## Usage',
+*     '',
+*     '</section>',
+*     '',
+*     '<!-- /.usage -->',
+*     '',
+*     '<section class="examples">',
+*     '',
+*     '## Examples',
+*     '',
+*     '</section>',
+*     '',
+*     '<!-- /.examples -->',
+*     ''
+* ].join( '\n' );
+*
+* remark().use( lint ).process( str, done );
+*
+* function done( error ) {
+*     if ( error ) {
+*         throw error;
+*     }
+* }
+*/
+function attacher( options ) {
+	var opts;
+	var err;
+
+	// Set default options:
+	opts = copy( defaults );
+
+	// NOTE: cannot use `arguments.length` check, as `options` may be explicitly passed as `undefined`
+	if ( options !== void 0 ) {
+		err = validate( opts, options );
+		if ( err ) {
+			throw err;
+		}
+	}
+	return linter( opts );
+}
+
+
+// EXPORTS //
+
+module.exports = attacher;
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/defaults.json b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/defaults.json
new file mode 100644
index 000000000000..25ff7aabaf29
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/defaults.json
@@ -0,0 +1,28 @@
+{
+  "schema": {
+    "root": {
+      "required": [
+        "usage",
+        "examples",
+        "links"
+      ],
+      "optional": [
+        "intro",
+        "notes",
+        "c",
+        "references",
+        "related"
+      ]
+    },
+    "c": {
+      "required": [
+        "usage",
+        "examples"
+      ],
+      "optional": [
+        "intro",
+        "notes"
+      ]
+    }
+  }
+}
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/index.js b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/index.js
index 54942d814094..95c7e880236e 100644
--- a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/index.js
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/index.js
@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2022 The Stdlib Authors.
+* Copyright (c) 2025 The Stdlib Authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -32,9 +32,9 @@
 
 // MODULES //
 
-var main = require( './main.js' );
+var attacher = require( './attacher.js' );
 
 
 // EXPORTS //
 
-module.exports = main;
+module.exports = attacher;
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/linter.js b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/linter.js
new file mode 100644
index 000000000000..5f728119f85f
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/linter.js
@@ -0,0 +1,184 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var logger = require( 'debug' );
+var visit = require( 'unist-util-visit' );
+var keys = require( '@stdlib/utils/keys' );
+
+
+// VARIABLES //
+
+var debug = logger( 'remark-lint-expected-html-sections' );
+var SECTION_START = /<section(?:\s+class="([^"]*)")?>/;
+
+
+// MAIN //
+
+/**
+* Returns a linter function.
+*
+* @private
+* @param {Object} options - linter options
+* @param {Object} [options.schema] - section schema defining required and optional sections
+* @returns {Function} linter function
+*/
+function factory( options ) {
+	return linter;
+
+	/**
+	* Validates HTML section hierarchy in README files according to stdlib conventions.
+	*
+	* @private
+	* @param {Node} tree - abstract syntax tree (AST)
+	* @param {File} file - virtual file
+	* @returns {void}
+	*/
+	function linter( tree, file ) {
+		var requiredRootSections;
+		var requiredCSections;
+		var sectionStructure;
+		var currentSection;
+		var sectionsFound;
+		var sectionStack;
+		var sectionMatch;
+		var missingRoot;
+		var className;
+		var missingC;
+		var schema;
+		var msg;
+		var i;
+
+		debug( 'Linting file: %s', file.path || '' );
+		schema = options.schema;
+
+		// Initialize section tracking:
+		sectionStack = [];
+		sectionStructure = [];
+
+		// Keep track of sections at different levels:
+		sectionsFound = {
+			'root': {},
+			'c': {}
+		};
+
+		// Visit all HTML nodes to build section structure:
+		visit( tree, 'html', visitor );
+
+		// Log all sections found for debugging:
+		debug( 'Root sections found: %j', keys( sectionsFound.root ) );
+		if ( sectionsFound.root.c ) {
+			debug( 'C sections found: %j', keys( sectionsFound.c ) );
+		}
+
+		// After visiting all nodes, validate against schema:
+		requiredRootSections = schema.root.required || [];
+
+		// Check for missing required root sections:
+		missingRoot = [];
+		for ( i = 0; i < requiredRootSections.length; i++ ) {
+			if ( !sectionsFound.root[ requiredRootSections[ i ] ] ) {
+				missingRoot.push( requiredRootSections[ i ] );
+			}
+		}
+
+		if ( missingRoot.length > 0 ) {
+			msg = 'Missing required root-level sections: `' + missingRoot.join( '`, `' ) + '`. Required sections are: `' + requiredRootSections.join('`, `') + '`.   missing-required-sections';
+			debug( msg );
+			file.message( msg, tree );
+		}
+
+		// If 'c' section exists, check its requirements:
+		if ( sectionsFound.root.c ) {
+			requiredCSections = (schema.c) ? (schema.c.required || []) : [];
+
+			// Check for missing required C sections:
+			missingC = [];
+			for ( i = 0; i < requiredCSections.length; i++ ) {
+				if ( !sectionsFound.c[ requiredCSections[ i ] ] ) {
+					missingC.push( requiredCSections[ i ] );
+				}
+			}
+
+			if ( missingC.length > 0 ) {
+				msg = 'Missing required sections in "c" section: `' + missingC.join('`, `') + '`. Required C sections are: `' + requiredCSections.join('`, `') + '`.   missing-required-c-sections';
+				debug( msg );
+				file.message( msg, sectionsFound.root.c.node );
+			}
+		}
+
+		debug( 'Finished linting: %s', file.path || '' );
+
+		/**
+		* Callback invoked upon finding a matching node.
+		*
+		* @private
+		* @param {Object} node - AST node
+		* @returns {void}
+		*/
+		function visitor( node ) {
+			// Check if this is a section start tag:
+			sectionMatch = SECTION_START.exec( node.value );
+			if ( sectionMatch ) {
+				className = sectionMatch[1] || '';
+
+				debug( 'Found section with class: %s', className );
+
+				// Create section data object:
+				currentSection = {
+					'node': node,
+					'name': className,
+					'children': [],
+					'parent': null
+				};
+
+				// Add to parent if there is one:
+				if ( sectionStack.length > 0 ) {
+					currentSection.parent = sectionStack[ sectionStack.length - 1 ];
+					currentSection.parent.children.push( currentSection );
+
+					// Record C-level section:
+					if ( currentSection.parent.name === 'c' ) {
+						sectionsFound.c[ className ] = currentSection;
+					}
+				} else {
+					// This is a root section:
+					sectionStructure.push( currentSection );
+					sectionsFound.root[ className ] = currentSection;
+				}
+
+				// Push to stack:
+				sectionStack.push( currentSection );
+			}
+			// Check if this is a section end tag:
+			else if ( /<\/section>/.test( node.value ) ) {
+				if ( sectionStack.length > 0 ) {
+					sectionStack.pop();
+				}
+			}
+		}
+	}
+}
+
+
+// EXPORTS //
+
+module.exports = factory;
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/main.js b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/main.js
deleted file mode 100644
index 93943e9a0eee..000000000000
--- a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/main.js
+++ /dev/null
@@ -1,192 +0,0 @@
-/**
-* @license Apache-2.0
-*
-* Copyright (c) 2025 The Stdlib Authors.
-*
-* Licensed under the Apache License, Version 2.0 (the "License");
-* you may not use this file except in compliance with the License.
-* You may obtain a copy of the License at
-*
-*    http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing, software
-* distributed under the License is distributed on an "AS IS" BASIS,
-* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-* See the License for the specific language governing permissions and
-* limitations under the License.
-*/
-
-'use strict';
-
-// MODULES //
-
-var logger = require( 'debug' );
-var rule = require( 'unified-lint-rule' );
-var visit = require( 'unist-util-visit' );
-var keys = require( '@stdlib/utils/keys' );
-
-
-// VARIABLES //
-
-var debug = logger( 'remark-lint-expected-html-sections' );
-var SECTION_START = /<section(?:\s+class="([^"]*)")?>/;
-var DEFAULT_SCHEMA = {
-	'root': {
-		'required': [ 'usage', 'examples', 'links' ],
-		'optional': [ 'intro', 'notes', 'c', 'references', 'related' ]
-	},
-	'c': {
-		'required': [ 'usage', 'examples' ],
-		'optional': [ 'intro', 'notes' ]
-	}
-};
-var expectedHtmlSectionsRule;
-
-
-// MAIN //
-
-/**
-* Validates HTML section hierarchy in README files according to stdlib conventions.
-*
-* @private
-* @param {Node} tree - abstract syntax tree (AST)
-* @param {File} file - virtual file
-* @param {Object} options - options
-* @param {Object} [options.schema] - section schema defining required and optional sections
-* @param {Callback} clbk - callback to invoke upon completion
-* @returns {void}
-*/
-function linter( tree, file, options, clbk ) {
-	var requiredRootSections;
-	var requiredCSections;
-	var sectionStructure;
-	var currentSection;
-	var sectionsFound;
-	var sectionStack;
-	var sectionMatch;
-	var missingRoot;
-	var className;
-	var missingC;
-	var schema;
-	var msg;
-	var i;
-
-	debug( 'Linting file: %s', file.path || '' );
-
-	// Use provided schema or default schema:
-	schema = options.schema || DEFAULT_SCHEMA;
-
-	// Initialize section tracking:
-	sectionStack = [];
-	sectionStructure = [];
-
-	// Keep track of sections at different levels:
-	sectionsFound = {
-		'root': {},
-		'c': {}
-	};
-
-	// Visit all HTML nodes to build section structure:
-	visit( tree, 'html', visitor );
-
-	// Log all sections found for debugging:
-	debug( 'Root sections found: %j', keys( sectionsFound.root ) );
-	if ( sectionsFound.root.c ) {
-		debug( 'C sections found: %j', keys( sectionsFound.c ) );
-	}
-
-	// After visiting all nodes, validate against schema:
-	requiredRootSections = schema.root.required || [];
-
-	// Check for missing required root sections:
-	missingRoot = [];
-	for ( i = 0; i < requiredRootSections.length; i++ ) {
-		if ( !sectionsFound.root[ requiredRootSections[ i ] ] ) {
-			missingRoot.push( requiredRootSections[ i ] );
-		}
-	}
-
-	if ( missingRoot.length > 0 ) {
-		msg = 'Missing required root-level sections: ' + missingRoot.join( ', ' ) + '. Required sections are: ' + requiredRootSections.join(', ') + '.   missing-required-sections';
-		debug( msg );
-		file.message( msg, tree );
-	}
-
-	// If 'c' section exists, check its requirements:
-	if ( sectionsFound.root.c ) {
-		requiredCSections = (schema.c) ? (schema.c.required || []) : [];
-
-		// Check for missing required C sections:
-		missingC = [];
-		for ( i = 0; i < requiredCSections.length; i++ ) {
-			if ( !sectionsFound.c[ requiredCSections[ i ] ] ) {
-				missingC.push( requiredCSections[ i ] );
-			}
-		}
-
-		if ( missingC.length > 0 ) {
-			msg = 'Missing required sections in "c" section: ' + missingC.join(', ') + '. Required C sections are: ' + requiredCSections.join(', ') + '.   missing-required-c-sections';
-			debug( msg );
-			file.message( msg, sectionsFound.root.c.node );
-		}
-	}
-
-	debug( 'Finished linting: %s', file.path || '' );
-	return clbk();
-
-	/**
-	* Callback invoked upon finding a matching node.
-	*
-	* @private
-	* @param {Object} node - AST node
-	* @returns {void}
-	*/
-	function visitor( node ) {
-		// Check if this is a section start tag:
-		sectionMatch = SECTION_START.exec( node.value );
-		if ( sectionMatch ) {
-			className = sectionMatch[1] || '';
-
-			debug( 'Found section with class: %s', className );
-
-			// Create section data object:
-			currentSection = {
-				'node': node,
-				'name': className,
-				'children': [],
-				'parent': null
-			};
-
-			// Add to parent if there is one:
-			if ( sectionStack.length > 0 ) {
-				currentSection.parent = sectionStack[ sectionStack.length - 1 ];
-				currentSection.parent.children.push( currentSection );
-
-				// Record C-level section:
-				if ( currentSection.parent.name === 'c' ) {
-					sectionsFound.c[ className ] = currentSection;
-				}
-			} else {
-				// This is a root section:
-				sectionStructure.push( currentSection );
-				sectionsFound.root[ className ] = currentSection;
-			}
-
-			// Push to stack:
-			sectionStack.push( currentSection );
-		}
-		// Check if this is a section end tag:
-		else if ( /<\/section>/.test( node.value ) ) {
-			if ( sectionStack.length > 0 ) {
-				sectionStack.pop();
-			}
-		}
-	}
-}
-
-expectedHtmlSectionsRule = rule( 'remark-lint:expected-html-sections', linter );
-
-
-// EXPORTS //
-
-module.exports = expectedHtmlSectionsRule;
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/validate.js b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/validate.js
new file mode 100644
index 000000000000..a6b650f72c8b
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/lib/validate.js
@@ -0,0 +1,70 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var isObject = require( '@stdlib/assert/is-plain-object' );
+var hasOwnProp = require( '@stdlib/assert/has-own-property' );
+var format = require( '@stdlib/string/format' );
+
+
+// MAIN //
+
+/**
+* Validates function options.
+*
+* @private
+* @param {Object} opts - destination object
+* @param {Options} options - function options
+* @param {Object} [options.schema] - schema for expected HTML sections
+* @returns {(Error|null)} null or an error object
+*
+* @example
+* var opts = {};
+* var options = {
+*     'schema': {
+*         'root': {
+*             'required': [ 'usage', 'examples', 'links' ],
+*             'optional': [ 'intro', 'notes', 'c', 'references', 'related' ]
+*         }
+*     }
+* };
+* var err = validate( opts, options );
+* if ( err ) {
+*     throw err;
+* }
+*/
+function validate( opts, options ) {
+	if ( !isObject( options ) ) {
+		return new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) );
+	}
+	if ( hasOwnProp( options, 'schema' ) ) {
+		if ( !isObject( options.schema ) ) {
+			return new TypeError( format( 'invalid option. `%s` option must be an object. Option: `%s`.', 'schema', options.schema ) );
+		}
+		opts.schema = options.schema;
+	}
+	return null;
+}
+
+
+// EXPORTS //
+
+module.exports = validate;
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/test.js b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/test.js
index 5c8733d5fd3f..8828afa28771 100644
--- a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/test.js
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/test.js
@@ -20,7 +20,7 @@
 
 // MODULES //
 
-var path = require( 'path' );
+var join = require( 'path' ).join;
 var tape = require( 'tape' );
 var remark = require( 'remark' );
 var readFileSync = require( '@stdlib/fs/read-file' ).sync;
@@ -29,32 +29,23 @@ var expectedSections = require( './../lib' );
 
 // VARIABLES //
 
-var TEST_FIXTURES = path.join( __dirname, 'fixtures' );
-var DEFAULT_SCHEMA = {
-	'root': {
-		'required': [ 'usage', 'examples', 'links' ],
-		'optional': [ 'intro', 'notes', 'c', 'references', 'related' ]
-	},
-	'c': {
-		'required': [ 'usage', 'examples' ],
-		'optional': [ 'intro', 'notes' ]
-	}
-};
+var TEST_FIXTURES = join( __dirname, 'fixtures' );
 var CUSTOM_SCHEMA = {
 	'root': {
 		'required': [ 'usage', 'examples', 'links', 'related' ],
 		'optional': [ 'intro', 'notes', 'c', 'references' ]
 	}
 };
+var FIXTURE_VALID_COMPLETE = readFileSync( join( TEST_FIXTURES, 'valid_complete.md.txt' ), 'utf8' ).toString();
+var FIXTURE_VALID_MEMOIZE = readFileSync( join( TEST_FIXTURES, 'valid_memoize.md.txt' ), 'utf8' ).toString();
+var FIXTURE_VALID_ASIN = readFileSync( join( TEST_FIXTURES, 'valid_asin.md.txt' ), 'utf8' ).toString();
+var FIXTURE_INVALID_ASIN = readFileSync( join( TEST_FIXTURES, 'invalid_asin.md.txt' ), 'utf8' ).toString();
+var FIXTURE_MISSING_ROOT = readFileSync( join( TEST_FIXTURES, 'missing_required_root.md.txt' ), 'utf8' ).toString();
+var FIXTURE_INCOMPLETE_C = readFileSync( join( TEST_FIXTURES, 'incomplete_c.md.txt' ), 'utf8' ).toString();
 
 
 // FUNCTIONS //
 
-function fixture( name ) {
-	var text = readFileSync( path.join( TEST_FIXTURES, name ), 'utf8' );
-	return text.toString();
-}
-
 function lint( text, options, clbk ) {
 	remark().use( expectedSections, options ).process( text, clbk );
 }
@@ -69,11 +60,7 @@ tape( 'main export is a function', function test( t ) {
 });
 
 tape( 'validates valid_complete.md.txt with default schema', function test( t ) {
-	var opts = {
-		'schema': DEFAULT_SCHEMA
-	};
-
-	lint( fixture( 'valid_complete.md.txt' ), opts, done );
+	lint( FIXTURE_VALID_COMPLETE, {}, done );
 
 	function done( err, file ) {
 		if ( err ) {
@@ -85,11 +72,7 @@ tape( 'validates valid_complete.md.txt with default schema', function test( t )
 });
 
 tape( 'validates valid_memoize.md.txt', function test( t ) {
-	var opts = {
-		'schema': DEFAULT_SCHEMA
-	};
-
-	lint( fixture( 'valid_memoize.md.txt' ), opts, done );
+	lint( FIXTURE_VALID_MEMOIZE, {}, done );
 
 	function done( err, file ) {
 		if ( err ) {
@@ -101,11 +84,7 @@ tape( 'validates valid_memoize.md.txt', function test( t ) {
 });
 
 tape( 'validates valid_asin.md.txt with C section', function test( t ) {
-	var opts = {
-		'schema': DEFAULT_SCHEMA
-	};
-
-	lint( fixture( 'valid_asin.md.txt' ), opts, done );
+	lint( FIXTURE_VALID_ASIN, {}, done );
 
 	function done( err, file ) {
 		if ( err ) {
@@ -117,60 +96,48 @@ tape( 'validates valid_asin.md.txt with C section', function test( t ) {
 });
 
 tape( 'detects missing C usage section in invalid_asin.md.txt', function test( t ) {
-	var opts = {
-		'schema': DEFAULT_SCHEMA
-	};
-
-	lint( fixture( 'invalid_asin.md.txt' ), opts, done );
+	lint( FIXTURE_INVALID_ASIN, {}, done );
 
 	function done( err, file ) {
 		if ( err ) {
 			t.fail( err.message );
 		}
 		t.strictEqual( file.messages.length, 1, 'has one error for invalid asin fixture' );
-		t.strictEqual( file.messages[0].reason.includes('Missing required sections in "c" section: usage'), true, 'error identifies the missing C usage section' );
+		t.strictEqual( file.messages[0].reason.includes('Missing required sections in "c" section: `usage`'), true, 'error identifies the missing C usage section' );
 		t.end();
 	}
 });
 
 tape( 'reports error for missing required root sections', function test( t ) {
-	var opts = {
-		'schema': DEFAULT_SCHEMA
-	};
+	lint( FIXTURE_MISSING_ROOT, {}, done );
 
-	lint( fixture( 'missing_required_root.md.txt' ), opts, function done( err, file ) {
+	function done( err, file ) {
 		if ( err ) {
 			t.fail( err.message );
 		}
 		t.strictEqual( file.messages.length, 1, 'has one error for fixture missing a required root section' );
-		t.strictEqual( file.messages[0].reason.includes('Missing required root-level sections: usage'), true, 'error identifies the missing section' );
+		t.strictEqual( file.messages[0].reason.includes('Missing required root-level sections: `usage`'), true, 'error identifies the missing section' );
 		t.end();
-	});
+	}
 });
 
 tape( 'reports error for incomplete C section', function test( t ) {
-	var opts = {
-		'schema': DEFAULT_SCHEMA
-	};
-
-	lint( fixture( 'incomplete_c.md.txt' ), opts, done );
+	lint( FIXTURE_INCOMPLETE_C, {}, done );
 
 	function done( err, file ) {
 		if ( err ) {
 			t.fail( err.message );
 		}
 		t.strictEqual( file.messages.length, 1, 'has one error for fixture with an incomplete C section' );
-		t.strictEqual( file.messages[0].reason.includes('Missing required sections in "c" section: usage, examples'), true, 'error identifies the missing C sections' );
+		t.strictEqual( file.messages[0].reason.includes('Missing required sections in "c" section: `usage`, `examples`'), true, 'error identifies the missing C sections' );
 		t.end();
 	}
 });
 
 tape( 'validates valid_complete.md.txt with custom schema', function test( t ) {
-	var opts = {
+	lint( FIXTURE_VALID_COMPLETE, {
 		'schema': CUSTOM_SCHEMA
-	};
-
-	lint( fixture( 'valid_complete.md.txt' ), opts, done );
+	}, done );
 
 	function done( err, file ) {
 		if ( err ) {
@@ -185,8 +152,7 @@ tape( 'reports correct errors with custom schema', function test( t ) {
 	var opts = {
 		'schema': CUSTOM_SCHEMA
 	};
-
-	lint( fixture( 'missing_required_root.md.txt' ), opts, done );
+	lint( FIXTURE_MISSING_ROOT, opts, done );
 
 	function done( err, file ) {
 		if ( err ) {
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/test.validate.js b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/test.validate.js
new file mode 100644
index 000000000000..a9eaa564b28f
--- /dev/null
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/test.validate.js
@@ -0,0 +1,125 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var tape = require( 'tape' );
+var validate = require( './../lib/validate.js' );
+
+
+// TESTS //
+
+tape( 'main export is a function', function test( t ) {
+	t.ok( true, __filename );
+	t.strictEqual( typeof validate, 'function', 'main export is a function' );
+	t.end();
+});
+
+tape( 'the function returns an error if provided an `options` argument which is not an object', function test( t ) {
+	var values;
+	var err;
+	var i;
+
+	values = [
+		'5',
+		5,
+		true,
+		false,
+		void 0,
+		null,
+		NaN,
+		[],
+		function noop() {}
+	];
+
+	for ( i = 0; i < values.length; i++ ) {
+		err = validate( {}, values[ i ] );
+		t.strictEqual( err instanceof TypeError, true, 'returns a type error when provided '+values[i] );
+	}
+	t.end();
+});
+
+tape( 'the function returns an error if provided a `schema` option which is not an object', function test( t ) {
+	var values;
+	var opts;
+	var err;
+	var i;
+
+	values = [
+		'5',
+		5,
+		true,
+		false,
+		void 0,
+		null,
+		NaN,
+		[],
+		function noop() {}
+	];
+
+	for ( i = 0; i < values.length; i++ ) {
+		opts = {
+			'schema': values[ i ]
+		};
+		err = validate( {}, opts );
+		t.strictEqual( err instanceof TypeError, true, 'returns a type error when provided '+values[i] );
+	}
+	t.end();
+});
+
+tape( 'the function returns `null` if all options are valid', function test( t ) {
+	var options;
+	var opts;
+	var err;
+
+	opts = {};
+	options = {
+		'schema': {
+			'root': {
+				'required': [ 'usage', 'examples', 'links' ],
+				'optional': [ 'intro', 'notes', 'c', 'references', 'related' ]
+			}
+		}
+	};
+
+	err = validate( opts, options );
+	t.strictEqual( err, null, 'returns null' );
+	t.deepEqual( opts, options, 'sets options' );
+
+	t.end();
+});
+
+tape( 'the function will ignore unrecognized options', function test( t ) {
+	var options;
+	var opts;
+	var err;
+
+	opts = {};
+	options = {
+		'beep': true,
+		'boop': 'bop'
+	};
+
+	err = validate( opts, options );
+	t.strictEqual( err, null, 'returns null' );
+	t.deepEqual( opts, {}, 'ignores unrecognized options' );
+
+	t.end();
+});

From 69736740fc742dc3803d5882254d75bc101f9c0c Mon Sep 17 00:00:00 2001
From: stdlib-bot <82920195+stdlib-bot@users.noreply.github.com>
Date: Tue, 18 Mar 2025 15:43:47 +0000
Subject: [PATCH 4/4] chore: update copyright years

---
 .../test/fixtures/invalid_asin.md.txt                           | 2 +-
 .../test/fixtures/valid_asin.md.txt                             | 2 +-
 .../test/fixtures/valid_memoize.md.txt                          | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/invalid_asin.md.txt b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/invalid_asin.md.txt
index 5f5f6ea628c9..f18826250dda 100644
--- a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/invalid_asin.md.txt
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/invalid_asin.md.txt
@@ -2,7 +2,7 @@
 
 @license Apache-2.0
 
-Copyright (c) 2022 The Stdlib Authors.
+Copyright (c) 2025 The Stdlib Authors.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_asin.md.txt b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_asin.md.txt
index 357094ff23af..4c73653603f0 100644
--- a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_asin.md.txt
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_asin.md.txt
@@ -2,7 +2,7 @@
 
 @license Apache-2.0
 
-Copyright (c) 2022 The Stdlib Authors.
+Copyright (c) 2025 The Stdlib Authors.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_memoize.md.txt b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_memoize.md.txt
index 6cf2726f3838..93357d7864a0 100644
--- a/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_memoize.md.txt
+++ b/lib/node_modules/@stdlib/_tools/remark/plugins/remark-lint-expected-html-sections/test/fixtures/valid_memoize.md.txt
@@ -2,7 +2,7 @@
 
 @license Apache-2.0
 
-Copyright (c) 2018 The Stdlib Authors.
+Copyright (c) 2025 The Stdlib Authors.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.