Release v0.1.0

.editorconfig

@@ -179,3 +179,8 @@ indent_size = 2
 [*.gypi]
 indent_style = space
 indent_size = 2
+
+# Set properties for citation files:
+[*.{cff,cff.txt}]
+indent_style = space
+indent_size = 2

.github/workflows/publish.yml

@@ -21,9 +21,23 @@ name: publish
 
 # Workflow triggers:
 on:
-  # Run workflow when a new tag is pushed to the repository:
-  push:
-    tags: v[0-9]+.[0-9]+.[0-9]+
+  # Allow the workflow to be manually run:
+  workflow_dispatch:
+    # Workflow inputs:
+    inputs:
+      version:
+        description: 'Version Increment'
+        type: choice
+        default: 'none'
+        options:
+          - 'none'
+          - 'major'
+          - 'minor'
+          - 'patch'
+          - 'premajor'
+          - 'preminor'
+          - 'prepatch'
+          - 'prerelease'
 
 # Workflow jobs:
 jobs:
@@ -32,14 +46,15 @@ jobs:
   publish:
 
     # Define display name:
-    name: 'Publish to npm'
+    name: 'Publish package to npm'
 
     # Define the type of virtual host machine on which to run the job:
     runs-on: ubuntu-latest
 
     # Define environment variables:
     env:
       SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
+      NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
 
     # Define the sequence of job steps...
     steps:
@@ -55,6 +70,91 @@ jobs:
           node-version: 16
         timeout-minutes: 5
 
+      # Configure git:
+      - name: 'Configure git'
+        run: |
+          git config --local user.email "noreply@stdlib.io"
+          git config --local user.name "stdlib-bot"
+
+      # Increment package version (if requested):
+      - name: 'Increment package version (if requested)'
+        if: ${{ github.event.inputs.version != 'none' }}
+        run: |
+          # Save NPM_TOKEN to user's .npmrc:
+          echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > ~/.npmrc
+
+          # Increment package version:
+          npm version ${{ github.event.inputs.version }} --no-git-tag-version
+
+          # Define variable for new version:
+          NEW_VERSION=$(node -p "require('./package.json').version")
+
+          # Replace branch in README.md link definitions for badges with the new version:
+          find . -type f -name '*.md' -print0 | xargs -0 sed -Ei "s/branch([=:])[^ ]+/branch\1v${NEW_VERSION}/g"
+
+          # Create a new commit and tag:
+          git add package.json README.md
+          git commit -m "Release v${NEW_VERSION}"
+          git tag -a "v${NEW_VERSION}" -m "Release v${NEW_VERSION}"
+
+          # Push changes to GitHub:
+          SLUG=${{ github.repository }}
+          git push "https://$GITHUB_ACTOR:$GITHUB_TOKEN@github.com/$SLUG.git" --follow-tags
+
+      # Remove CLI:
+      - name: 'Remove CLI'
+        if: ${{ github.ref == 'refs/heads/main' }}
+        run: |
+          # Exit if the package does not have a CLI:
+          if ! grep -q '"bin":' package.json; then
+            exit 0
+          fi
+          rm -rf ./bin/cli
+          rm -f test/test.cli.js
+          rm -f etc/cli_opts.json
+          rm -f docs/usage.txt
+
+          # For all dependencies, check in all *.js files if they are still used; if not, remove them:
+          jq -r '.dependencies | keys[]' ./package.json | while read -r dep; do
+            dep=$(echo "$dep" | xargs)
+            if ! grep -q "$dep" lib/** && ! grep -q -s "$dep" manifest.json && ! grep -q -s "$dep" include.gypi; then
+              jq --indent 2 "del(.dependencies[\"$dep\"])" ./package.json > ./package.json.tmp
+              mv ./package.json.tmp ./package.json
+            fi
+          done
+          jq -r '.devDependencies | keys[]' ./package.json | while read -r dep; do
+            if [[ "$dep" != "@stdlib"* ]]; then
+              continue
+            fi
+            dep=$(echo "$dep" | xargs)
+            if ! grep -q "$dep" lib/** && ! grep -q -s "$dep" manifest.json && ! grep -q -s "$dep" include.gypi; then
+              jq --indent 2 "del(.devDependencies[\"$dep\"])" ./package.json > ./package.json.tmp
+              mv ./package.json.tmp ./package.json
+            fi
+          done
+
+          # Remove CLI section:
+          find . -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/(\* \* \*\n+)?<section class=\"cli\">[\s\S]+?<\!\-\- \/.cli \-\->//"
+
+          # Remove CLI from package.json:
+          jq -r 'del(.bin)' package.json > package.json.tmp
+          mv package.json.tmp package.json
+
+          # Add entry for CLI package to See Also section of README.md:
+          cliPkgName=$(jq -r '.name' package.json)-cli
+          escapedPkg=$(echo "$cliPkgName" | sed -e 's/\//\\\//g')
+          escapedPkg=$(echo "$escapedPkg" | sed -e 's/\@/\\\@/g')
+          find . -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/<section class=\"related\">(?:\n\n\* \* \*\n\n## See Also\n\n)?/<section class=\"related\">\n\n## See Also\n\n-   <span class=\"package-name\">[\`$escapedPkg\`][$escapedPkg]<\/span><span class=\"delimiter\">: <\/span><span class=\"description\">CLI package for use as a command-line utility.<\/span>\n/"
+
+          # Add link definition for CLI package to README.md:
+          find . -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/<section class=\"links\">/<section class=\"links\">\n\n[$escapedPkg]: https:\/\/www.npmjs.com\/package\/$escapedPkg/"
+
+      # Replace GitHub MathJax equations with SVGs:
+      - name: 'Replace GitHub MathJax equations with SVGs'
+        run: |
+          find . -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe 's/```math\n([\s\S]+?)\n```\n\n//g'
+          find . -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe 's/<!-- <div class="equation"(.*)(<\/div>\s*-->)/<div class="equation"$1<\/div>/sg'
+
       # Replace GitHub links to individual packages with npm links:
       - name: 'Replace all GitHub links to individual packages with npm links'
         run: |
@@ -65,14 +165,39 @@ jobs:
         run: |
           find . -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/\`\`\`\n\nAlternatively,[^<]+<\/section>/\`\`\`\n\n<\/section>/"
 
+      # Remove unnecessary files:
+      - name: 'Remove unnecessary files'
+        run: |
+          rm -f docs/repl.txt
+          rm -f docs/types/test.ts
+
       # Replace all stdlib GitHub dependencies with the respective npm packages:
       - name: 'Replace all stdlib GitHub dependencies with the respective npm packages'
         run: |
-          find package.json -type f -print0 | xargs -0 sed -Ei 's/"github:stdlib-js[^"]*"/"^0.0.x"/g'
+          for dep in $(jq -r '.dependencies | keys | .[]' package.json); do
+            if [[ "$dep" != "@stdlib"* ]]; then
+              continue
+            fi
+            # Trim leading and trailing whitespace:
+            dep=$(echo "$dep" | xargs)
+            version="^$(npm view $dep version)"
+            jq -r --arg dep "$dep" --arg version "$version" '.dependencies[$dep] = $version' package.json > package.json.tmp
+            mv package.json.tmp package.json
+          done
+          for dep in $(jq -r '.devDependencies | keys | .[]' package.json); do
+            if [[ "$dep" != "@stdlib"* ]]; then
+              continue
+            fi
+            # Trim leading and trailing whitespace:
+            dep=$(echo "$dep" | xargs)
+            version="^$(npm view $dep version)"
+            jq -r --arg dep "$dep" --arg version "$version" '.devDependencies[$dep] = $version' package.json > package.json.tmp
+            mv package.json.tmp package.json
+          done
 
       # Publish package to npm:
       - name: 'Publish package to npm'
-        uses: JS-DevTools/npm-publish@v1
+        uses: JS-DevTools/npm-publish@v2
         with:
           token: ${{ secrets.NPM_TOKEN }}
           access: public
@@ -84,7 +209,7 @@ jobs:
 
       # Send status to Slack channel if job fails:
       - name: 'Send status to Slack channel in case of failure'
-        uses: act10ns/slack@v1
+        uses: act10ns/slack@v2
         with:
           status: ${{ job.status }}
           steps: ${{ toJson(steps) }}

.github/workflows/test.yml

@@ -32,6 +32,11 @@ on:
   # Run workflow on each push to the main branch:
   push:
 
+  # Run workflow upon completion of `publish` workflow run:
+  workflow_run:
+    workflows: ["publish"]
+    types: [completed]
+
 # Workflow jobs:
 jobs:
 
@@ -84,7 +89,7 @@ jobs:
 
       # Send status to Slack channel if job fails:
       - name: 'Send status to Slack channel in case of failure'
-        uses: act10ns/slack@v1
+        uses: act10ns/slack@v2
         with:
           status: ${{ job.status }}
           steps: ${{ toJson(steps) }}

.github/workflows/test_coverage.yml

@@ -106,7 +106,7 @@ jobs:
 
       # Send Slack notification if job fails:
       - name: 'Send status to Slack channel in case of failure'
-        uses: act10ns/slack@v1
+        uses: act10ns/slack@v2
         with:
           status: ${{ job.status }}
           steps: ${{ toJson(steps) }}

.github/workflows/test_install.yml

@@ -75,7 +75,7 @@ jobs:
 
       # Send Slack notification if job fails:
       - name: 'Send notification to Slack in case of failure'
-        uses: act10ns/slack@v1
+        uses: act10ns/slack@v2
         with:
           status: ${{ job.status }}
           steps: ${{ toJson(steps) }}

.gitignore

@@ -182,3 +182,7 @@ jsconfig.json
 ################
 *.sublime-workspace
 *.sublime-project
+
+# Other editor files #
+######################
+.idea/

CITATION.cff

@@ -0,0 +1,30 @@
+cff-version: 1.2.0
+title: stdlib
+message: >-
+  If you use this software, please cite it using the
+  metadata from this file.
+
+type: software
+
+authors:
+  - name: The Stdlib Authors
+    url: https://github.com/stdlib-js/stdlib/graphs/contributors
+
+repository-code: https://github.com/stdlib-js/stdlib
+url: https://stdlib.io
+
+abstract: |
+  Standard library for JavaScript and Node.js.
+
+keywords:
+  - JavaScript
+  - Node.js
+  - TypeScript
+  - standard library
+  - scientific computing
+  - numerical computing
+  - statistical computing
+
+license: Apache-2.0 AND BSL-1.0
+
+date-released: 2016

CONTRIBUTORS

@@ -3,28 +3,37 @@
 # Contributors listed in alphabetical order.
 
 Ali Salesi <ali_sal1381@yahoo.com>
+Amit Jimiwal <amitjimiwal45@gmail.com>
 Athan Reines <kgryte@gmail.com>
 Brendan Graetz <bguiz@users.noreply.github.com>
 Bruno Fenzl <brunofenzl@gmail.com>
 Christopher Dambamuromo <chridam@gmail.com>
+Dan Rose <danoftheroses@gmail.com>
 Dominik Moritz <domoritz@gmail.com>
+Dorrin Sotoudeh <dorrinsotoudeh123@gmail.com>
 Frank Kovacs <fran70kk@gmail.com>
-James <jdgelok@gmail.com>
+Harshita Kalani <harshitakalani02@gmail.com>
+James Gelok <jdgelok@gmail.com>
 Jithin KS <jithinks112@gmail.com>
 Joey Reed <joeyrreed@gmail.com>
+Jordan Gallivan <115050475+Jordan-Gallivan@users.noreply.github.com>
 Joris Labie <joris.labie1@gmail.com>
 Justin Dennison <justin1dennison@gmail.com>
-Marcus <mfantham@users.noreply.github.com>
+Marcus Fantham <mfantham@users.noreply.github.com>
 Matt Cochrane <matthew.cochrane.eng@gmail.com>
 Milan Raj <rajsite@users.noreply.github.com>
 Momtchil Momtchev <momtchil@momtchev.com>
+Naresh Jagadeesan <naresh.naresh000@gmail.com>
+Nithin Katta <88046362+nithinkatta@users.noreply.github.com>
 Ognjen Jevremović <ognjenjevremovic@users.noreply.github.com>
 Philipp Burckhardt <pburckhardt@outlook.com>
-Pranav <85227306+Pranavchiku@users.noreply.github.com>
+Pranav Goswami <goswami.4@iitj.ac.in>
 Ricky Reusser <rsreusser@gmail.com>
+Roman Stetsyk <25715951+romanstetsyk@users.noreply.github.com>
 Ryan Seal <splrk@users.noreply.github.com>
 Seyyed Parsa Neshaei <spneshaei@users.noreply.github.com>
 Shraddheya Shendre <shendreshraddheya@gmail.com>
 Stephannie Jiménez Gacha <steff456@hotmail.com>
-dorrin-sot <59933477+dorrin-sot@users.noreply.github.com>
-rei2hu <rei2hu@users.noreply.github.com>
+Yernar Yergaziyev <yernar.yergaziyev@erg.kz>
+orimiles5 <97595296+orimiles5@users.noreply.github.com>
+rei2hu <reimu@reimu.ws>

README.md

@@ -18,6 +18,17 @@ limitations under the License.
 
 -->
 
+
+<details>
+  <summary>
+    About stdlib...
+  </summary>
+  <p>We believe in a future in which the web is a preferred environment for numerical computation. To help realize this future, we've built stdlib. stdlib is a standard library, with an emphasis on numerical and scientific computation, written in JavaScript (and C) for execution in browsers and in Node.js.</p>
+  <p>The library is fully decomposable, being architected in such a way that you can swap out and mix and match APIs and functionality to cater to your exact preferences and use cases.</p>
+  <p>When you use stdlib, you can be absolutely certain that you are using the most thorough, rigorous, well-written, studied, documented, tested, measured, and high-quality code out there.</p>
+  <p>To join us in bringing numerical computing to the web, get started by checking us out on <a href="https://github.com/stdlib-js/stdlib">GitHub</a>, and please consider <a href="https://opencollective.com/stdlib">financially supporting stdlib</a>. We greatly appreciate your continued support!</p>
+</details>
+
 # Unary
 
 [![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] <!-- [![dependencies][dependencies-image]][dependencies-url] -->
@@ -270,8 +281,8 @@ Copyright &copy; 2016-2023. The Stdlib [Authors][stdlib-authors].
 [npm-image]: http://img.shields.io/npm/v/@stdlib/strided-napi-unary.svg
 [npm-url]: https://npmjs.org/package/@stdlib/strided-napi-unary
 
-[test-image]: https://github.com/stdlib-js/strided-napi-unary/actions/workflows/test.yml/badge.svg?branch=main
-[test-url]: https://github.com/stdlib-js/strided-napi-unary/actions/workflows/test.yml?query=branch:main
+[test-image]: https://github.com/stdlib-js/strided-napi-unary/actions/workflows/test.yml/badge.svg?branch=v0.1.0
+[test-url]: https://github.com/stdlib-js/strided-napi-unary/actions/workflows/test.yml?query=branch:v0.1.0
 
 [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/strided-napi-unary/main.svg
 [coverage-url]: https://codecov.io/github/stdlib-js/strided-napi-unary?branch=main
@@ -284,7 +295,7 @@ Copyright &copy; 2016-2023. The Stdlib [Authors][stdlib-authors].
 -->
 
 [chat-image]: https://img.shields.io/gitter/room/stdlib-js/stdlib.svg
-[chat-url]: https://gitter.im/stdlib-js/stdlib/
+[chat-url]: https://app.gitter.im/#/room/#stdlib-js_stdlib:gitter.im
 
 [stdlib]: https://github.com/stdlib-js/stdlib
 

branches.md

@@ -38,12 +38,12 @@ C -->|bundle| D[esm];
 C -->|bundle| E[deno];
 C -->|bundle| F[umd];
 
-click A href "https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/strided/napi/unary"
-click B href "https://github.com/stdlib-js/strided-napi-unary/tree/main"
-click C href "https://github.com/stdlib-js/strided-napi-unary/tree/production"
-click D href "https://github.com/stdlib-js/strided-napi-unary/tree/esm"
-click E href "https://github.com/stdlib-js/strided-napi-unary/tree/deno"
-click F href "https://github.com/stdlib-js/strided-napi-unary/tree/umd"
+%% click A href "https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/strided/napi/unary"
+%% click B href "https://github.com/stdlib-js/strided-napi-unary/tree/main"
+%% click C href "https://github.com/stdlib-js/strided-napi-unary/tree/production"
+%% click D href "https://github.com/stdlib-js/strided-napi-unary/tree/esm"
+%% click E href "https://github.com/stdlib-js/strided-napi-unary/tree/deno"
+%% click F href "https://github.com/stdlib-js/strided-napi-unary/tree/umd"
 ```
 
 [stdlib-url]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/strided/napi/unary

dist/index.d.ts

@@ -0,0 +1,3 @@
+/// <reference path="../docs/types/index.d.ts" />
+import headerDir from '../docs/types/index';
+export = headerDir;