docs: update examples for blas/base/cscal

.editorconfig

@@ -86,7 +86,6 @@ indent_style = tab
 [*.{f,f.txt}]
 indent_style = space
 indent_size = 2
-insert_final_newline = false
 
 # Set properties for shell files:
 [*.{sh,sh.txt}]

.github/workflows/good_first_issue.yml

@@ -56,7 +56,7 @@ jobs:
           GH_REPO: ${{ github.repository }}
           NUMBER: ${{ github.event.issue.number }}
           BODY: |
-            # :rotating_light: Important: PLEASE READ :rotating_light:
+            # :wave: Important: PLEASE READ :wave:
 
             This issue has been labeled as a **good first issue** and is available for anyone to work on.
 

.github/workflows/labeler.yml

@@ -24,6 +24,7 @@ on:
   pull_request_target:
     types:
       - opened
+      - closed
       - synchronize
       - reopened
       - edited
@@ -64,6 +65,31 @@ jobs:
           configuration-path: .github/labeler.yml
           repo-token: ${{ secrets.CHATBOT_GITHUB_TOKEN }}
 
+      # Add "First-time Contributor" label if PR is from a first-time contributor:
+      - name: 'Add "First-time Contributor" label if PR is from a first-time contributor'
+        if: ${{ github.event.action == 'opened' || github.event.action == 'reopened' }}
+        # Pin action to full-length commit SHA
+        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
+        with:
+          github-token: ${{ secrets.CHATBOT_GITHUB_TOKEN }}
+          script: |
+            const { data: pr } = await github.rest.pulls.get({
+              'owner': context.repo.owner,
+              'repo': context.repo.repo,
+              'pull_number': context.payload.pull_request.number
+            });
+            if ( pr.author_association === 'FIRST_TIME_CONTRIBUTOR' ) {
+              const labels = context.payload.pull_request.labels.map( label => label.name );
+              if ( !labels.includes( 'First-time Contributor' ) ) {
+                await github.rest.issues.addLabels({
+                  'owner': context.repo.owner,
+                  'repo': context.repo.repo,
+                  'issue_number': context.payload.pull_request.number,
+                  'labels': [ 'First-time Contributor' ]
+                });
+              }
+            }
+
       # Add "Needs Review" label when PR is opened and not a draft:
       - name: 'Add "Needs Review" label if PR is opened and not draft'
         if: ${{ github.event.action == 'opened' && github.event.pull_request.draft == false }}
@@ -133,3 +159,37 @@ jobs:
                 console.log( 'Error removing label %s: %s', label, error.message );
               }
             }
+
+      # Remove "First-time Contributor" label from other open PRs of same author if PR is merged:
+      - name: 'Remove "First-time Contributor" label from other open PRs of same author if PR is merged'
+        if: ${{ github.event.action == 'closed' && github.event.pull_request.merged == true }}
+        # Pin action to full length commit SHA
+        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
+        with:
+          github-token: ${{ secrets.CHATBOT_GITHUB_TOKEN }}
+          script: |
+            const prAuthor = context.payload.pull_request.user.login;
+            const { owner, repo } = context.repo;
+
+            // Search for all open PRs from the PR author:
+            const query = `repo:${owner}/${repo} type:pr state:open author:${prAuthor}`;
+            const response = await github.rest.search.issuesAndPullRequests({
+              'q': query,
+              'per_page': 100
+            });
+
+            const pullRequests = response.data.items;
+            for ( const pull of pullRequests ) {
+              if ( pull.user.login === prAuthor ) {
+                try {
+                  await github.rest.issues.removeLabel({
+                    'owner': context.repo.owner,
+                    'repo': context.repo.repo,
+                    'issue_number': pull.number,
+                    'name': 'First-time Contributor'
+                  });
+                } catch ( error ) {
+                  console.log( 'Error removing "First-time Contributor" label from PR #%d: %s', pull.number, error.message );
+                }
+              }
+            }

.github/workflows/labeler_needs_changes.yml

@@ -52,7 +52,6 @@ jobs:
         # Pin action to a known commit SHA for reproducibility:
         uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
         with:
-          github-token: ${{ secrets.CHATBOT_GITHUB_TOKEN }}
           script: |
             await github.rest.issues.addLabels({
               'owner': context.repo.owner,

.github/workflows/lint_changed_files.yml

@@ -72,8 +72,21 @@ jobs:
           node-version: '20' # 'lts/*'
         timeout-minutes: 5
 
+      # Cache dependencies:
+      - name: 'Cache dependencies'
+        # Pin action to full length commit SHA
+        uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
+        id: cache
+        with:
+          path: |
+            ${{ github.workspace }}/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
       # Install dependencies (accounting for possible network failures, etc, when installing node module dependencies):
       - name: 'Install dependencies'
+        if: steps.cache.outputs.cache-hit != 'true'
         run: |
           make install-node-modules || make install-node-modules || make install-node-modules
         timeout-minutes: 15
@@ -120,7 +133,7 @@ jobs:
       - name: 'Lint against EditorConfig'
         if: success() || failure()
         run: |
-          make lint-editorconfig-files FILES="${{ steps.changed-files.outputs.files }}"
+          make lint-editorconfig-files EDITORCONFIG_FORMAT=github-actions FILES="${{ steps.changed-files.outputs.files }}"
 
       # Lint Markdown files:
       - name: 'Lint Markdown files'

.github/workflows/namespace_declarations.yml

@@ -112,6 +112,15 @@ jobs:
 
             -   updates namespace TypeScript declarations
 
+            ## Reviewer Checklist
+
+            - [ ] **Check the scope of the changes** (following [Conventional Commits](https://www.conventionalcommits.org)):
+                - Are these **new APIs**? Then this is a `feat`.
+                - Are these **changes to existing APIs** that could break compatibility? Then this is a `feat!` (i.e., a breaking change).
+                - Are these **only documentation** changes to existing APIs? Then this is `docs`.
+            - [ ] Update the PR title to align with the change type (`feat`, `feat!`, or `docs`).
+            - [ ] Approve the PR once you are confident about the classification and changes made.
+
           commit-message: 'feat: update namespace TypeScript declarations'
           committer: 'stdlib-bot <[email protected]>'
           signoff: true

.github/workflows/run_affected_benchmarks.yml

@@ -35,6 +35,11 @@ on:
       # List paths for which changes should trigger this workflow:
       - 'lib/**/benchmark/**'
 
+  workflow_dispatch:
+    inputs:
+      directories:
+        description: 'List of changed directories for which to run affected benchmarks (space-separated)'
+
 # Global permissions:
 permissions:
   # Allow read-only access to the repository contents:
@@ -78,8 +83,21 @@ jobs:
           node-version: '20' # 'lts/*'
         timeout-minutes: 5
 
+      # Cache dependencies:
+      - name: 'Cache dependencies'
+        # Pin action to full length commit SHA
+        uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
+        id: cache
+        with:
+          path: |
+            ${{ github.workspace }}/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
       # Install dependencies (accounting for possible network failures, etc, when installing node module dependencies):
       - name: 'Install dependencies'
+        if: steps.cache.outputs.cache-hit != 'true'
         run: |
           make install-node-modules || make install-node-modules || make install-node-modules
         timeout-minutes: 15
@@ -90,9 +108,10 @@ jobs:
           make init
         timeout-minutes: 5
 
-      # Get list of changed files:
-      - name: 'Get list of changed files'
-        id: changed-files
+      # Get list of changed directories from PR and push events:
+      - name: 'Get list of changed directories'
+        if: github.event_name != 'workflow_dispatch'
+        id: changed-directories
         continue-on-error: true
         run: |
           if [ -n "${{ github.event.pull_request.number }}" ]; then
@@ -107,24 +126,24 @@ jobs:
               files=$(git diff --diff-filter=AM --name-only ${{ github.event.before }} ${{ github.event.after }})
             fi
           fi
-          # Keep only benchmark files:
-          files=$(echo "$files" | grep -E 'benchmark/' | tr '\n' ' ' | sed 's/ $//')
-          echo "files=${files}" >> $GITHUB_OUTPUT
+          directories=$(for file in $files; do dirname $file; done | uniq | tr '\n' ' ' | sed 's/ $//')
+          echo "directories=${directories}" >> $GITHUB_OUTPUT
 
-      # Run JavaScript benchmarks:
-      - name: 'Run JavaScript benchmarks'
+      # Get list of changed directories from workflow dispatch event:
+      - name: 'Get list of changed directories (from user input)'
+        if: github.event_name == 'workflow_dispatch'
+        id: changed-directories-user-input
         run: |
-          files=$(echo "${{ steps.changed-files.outputs.files }}" | tr ' ' '\n' | grep -E '\.js$' | tr '\n' ' ' | sed 's/ $//')
-          if [ -n "$files" ]; then
-            make benchmark-javascript-files FILES="${files}"
-          fi
-        timeout-minutes: 30
+          echo "directories=${{ github.event.inputs.directories }}" >> $GITHUB_OUTPUT
+        timeout-minutes: 5
 
-      # Run C benchmarks:
-      - name: 'Run C benchmarks'
+      # Run affected benchmarks:
+      - name: 'Run affected benchmarks'
         run: |
-          files=$(echo "${{ steps.changed-files.outputs.files }}" | tr ' ' '\n' | grep -E '\.c$' | sed "s|^|${GITHUB_WORKSPACE}/|" | tr '\n' ' ' | sed 's/ $//')
-          if [ -n "$files" ]; then
-            make benchmark-c-files FILES="${files}"
+          if [ "${{ github.event_name }}" == "workflow_dispatch" ]; then
+            directories="${{ steps.changed-directories-user-input.outputs.directories }}"
+          else
+            directories="${{ steps.changed-directories.outputs.directories }}"
           fi
-        timeout-minutes: 15
+          . "$GITHUB_WORKSPACE/.github/workflows/scripts/run_affected_benchmarks" "$directories"
+        timeout-minutes: 30

.github/workflows/run_affected_examples.yml

@@ -79,8 +79,21 @@ jobs:
           node-version: '20' # 'lts/*'
         timeout-minutes: 5
 
+      # Cache dependencies:
+      - name: 'Cache dependencies'
+        # Pin action to full length commit SHA
+        uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
+        id: cache
+        with:
+          path: |
+            ${{ github.workspace }}/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
       # Install dependencies (accounting for possible network failures, etc, when installing node module dependencies):
       - name: 'Install dependencies'
+        if: steps.cache.outputs.cache-hit != 'true'
         run: |
           make install-node-modules || make install-node-modules || make install-node-modules
         timeout-minutes: 15

.github/workflows/run_affected_tests.yml

@@ -114,8 +114,21 @@ jobs:
           node-version: '20' # 'lts/*'
         timeout-minutes: 5
 
+      # Cache dependencies:
+      - name: 'Cache dependencies'
+        # Pin action to full length commit SHA
+        uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
+        id: cache
+        with:
+          path: |
+            ${{ github.workspace }}/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
       # Install dependencies (accounting for possible network failures, etc, when installing node module dependencies):
       - name: 'Install dependencies'
+        if: steps.cache.outputs.cache-hit != 'true'
         run: |
           make install-node-modules || make install-node-modules || make install-node-modules
         timeout-minutes: 15

.github/workflows/run_tests_coverage.yml

@@ -120,8 +120,21 @@ jobs:
           node-version: 20 # 'lts/*'
         timeout-minutes: 5
 
+      # Cache dependencies:
+      - name: 'Cache dependencies'
+        # Pin action to full length commit SHA
+        uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
+        id: cache
+        with:
+          path: |
+            ${{ github.workspace }}/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
       # Install dependencies (accounting for possible network failures, etc, when installing node module dependencies):
       - name: 'Install dependencies'
+        if: steps.cache.outputs.cache-hit != 'true'
         run: |
           make install-node-modules || make install-node-modules || make install-node-modules
         timeout-minutes: 15